Renewal Management

# Get all deadline rules for the US
curl "https://api.signa.so/v1/deadline-rules?jurisdiction=US" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

# Get rules for multiple jurisdictions in one call
curl "https://api.signa.so/v1/deadline-rules?jurisdiction=US,EU,GB,DE,CA" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

import Signa from "@signa-so/sdk";

const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

const rules = await signa.references.deadlineRules({
  jurisdiction: ["US", "EU", "GB", "DE", "CA"],
});

for (const rule of rules.data) {
  console.log(
    `[${rule.jurisdiction_code}] ${rule.name} (${rule.type}) ` +
      `due year ${rule.due_year}, grace period ${rule.grace_period_months}mo`,
  );
}

const clientMarkIds: string[] = [
  /* your tm_... ids */
];
const horizon = "2027-09-24";

const batch = await signa.trademarks.batch({ ids: clientMarkIds });
if (batch.not_found.length > 0) {
  console.warn("Not found:", batch.not_found);
}

// Triage against your own clock. `today` is an ISO date (YYYY-MM-DD), so
// the comparisons are plain string compares on ISO dates.
const today = new Date().toISOString().slice(0, 10);

function urgency(d: { due_date: string; grace_expiry_date: string | null }) {
  if (d.due_date < today) {
    return d.grace_expiry_date && d.grace_expiry_date >= today ? "in_grace" : "missed";
  }
  const days = Math.round(
    (Date.parse(`${d.due_date}T00:00:00Z`) - Date.parse(`${today}T00:00:00Z`)) / 86_400_000,
  );
  if (days <= 30) return "critical";
  if (days <= 180) return "upcoming";
  return "routine";
}

const deadlines = batch.data
  .flatMap((tm) =>
    tm.derived.deadlines.items.map((d) => ({
      trademark_id: tm.id,
      mark_text: tm.mark_text,
      office_code: tm.office_code,
      ...d,
      urgency: urgency(d),
    })),
  )
  .filter((d) => d.due_date <= horizon)
  .sort((a, b) => a.due_date.localeCompare(b.due_date));

console.log(`Total deadlines before ${horizon}: ${deadlines.length}`);

const byUrgency: Record<string, number> = {};
for (const d of deadlines) {
  byUrgency[d.urgency] = (byUrgency[d.urgency] || 0) + 1;
}
console.log("By urgency:", byUrgency);

const byUrgencyList: Record<string, typeof deadlines> = {
  missed: [],
  in_grace: [],
  critical: [],
  upcoming: [],
  routine: [],
};

for (const d of deadlines) {
  (byUrgencyList[d.urgency] ??= []).push(d);
}

console.log(`MISSED (past grace): ${byUrgencyList.missed.length}`);
console.log(`IN GRACE PERIOD: ${byUrgencyList.in_grace.length}`);
console.log(`CRITICAL (due soon): ${byUrgencyList.critical.length}`);
console.log(`UPCOMING: ${byUrgencyList.upcoming.length}`);
console.log(`ROUTINE: ${byUrgencyList.routine.length}`);

# Get full detail including all computed deadlines
curl https://api.signa.so/v1/trademarks/tm_abc001 \
  -H "Authorization: Bearer $SIGNA_API_KEY"

// Filter US deadlines by type
const usDeadlines = deadlines.filter((d) => d.jurisdiction_code === "US");

const section8 = usDeadlines.filter((d) => d.type === "declaration_of_use");
const section15 = usDeadlines.filter((d) => d.type === "declaration_of_incontestability");
const combined89 = usDeadlines.filter((d) => d.type === "combined_renewal_and_use");
const renewals = usDeadlines.filter((d) => d.type === "renewal");

console.log(`\nUS Deadlines breakdown:`);
console.log(`  Section 8 (Declaration of Use): ${section8.length}`);
console.log(`  Section 15 (Incontestability): ${section15.length}`);
console.log(`  Combined 8+9 (Renewal + Use): ${combined89.length}`);
console.log(`  Simple renewals: ${renewals.length}`);

// For each Section 8, get the full trademark to check filing bases
for (const d of section8.slice(0, 3)) {
  const tm = await signa.trademarks.retrieve(d.trademark_id);
  console.log(`\n  ${tm.mark_text} (${tm.application_number})`);
  console.log(`  Section 8 due: ${d.due_date} (grace: ${d.grace_expiry_date})`);
  console.log(`  Filing bases: ${tm.filing_bases.map((b) => b.basis_type).join(", ")}`);
  console.log(`  Classes: ${tm.classifications.map((c) => c.nice_class).join(", ")}`);
}