Class Coverage Audits

# Get all marks in the portfolio (paginate through all)
curl "https://api.signa.so/v1/owners/own_mycompany/trademarks?status_stage=registered,examining&limit=100" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

interface GapEntry {
  officeCode: string;
  niceClass: number;
  classDescription: string;
  status: "covered" | "pending_only" | "gap";
  marks: Array<{ id: string; mark_text: string; status: string }>;
}

const matrix: GapEntry[] = [];

for (const office of targetOffices) {
  for (const cls of targetClasses) {
    const marks = coverage[office]?.[cls.class] || [];
    const registeredMarks = marks.filter((m) => m.status === "registered");
    const pendingMarks = marks.filter((m) => m.status !== "registered");

    let status: "covered" | "pending_only" | "gap";
    if (registeredMarks.length > 0) {
      status = "covered";
    } else if (pendingMarks.length > 0) {
      status = "pending_only";
    } else {
      status = "gap";
    }

    matrix.push({
      officeCode: office,
      niceClass: cls.class,
      classDescription: cls.description,
      status,
      marks,
    });
  }
}

// Print the matrix
const gaps = matrix.filter((m) => m.status === "gap");
const pendingOnly = matrix.filter((m) => m.status === "pending_only");
const covered = matrix.filter((m) => m.status === "covered");

console.log("\n=== Coverage Audit Results ===");
console.log(`Total cells: ${matrix.length}`);
console.log(`Covered (registered): ${covered.length} (${((covered.length / matrix.length) * 100).toFixed(0)}%)`);
console.log(`Pending only: ${pendingOnly.length}`);
console.log(`GAPS: ${gaps.length}`);

console.log("\n--- GAPS (no coverage) ---");
for (const gap of gaps) {
  console.log(`  ${gap.officeCode} / Class ${gap.niceClass}: ${gap.classDescription}`);
}

# Get class 36 details
curl https://api.signa.so/v1/classifications/36 \
  -H "Authorization: Bearer $SIGNA_API_KEY"

# Search for specific G&S terms in class 36
curl "https://api.signa.so/v1/goods-services?q=payment+processing&class=36&limit=10" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

interface GapPriority {
  jurisdiction: string;
  niceClass: number;
  description: string;
  priority: "critical" | "high" | "medium" | "low";
  reason: string;
}

// Define business priority weights
const officePriority: Record<string, number> = {
  us: 10, eu: 9, gb: 8, ca: 7, de: 6, au: 5, jp: 4, cn: 3,
};

const classPriority: Record<number, number> = {
  9: 10,  // Core product
  42: 10, // Core service
  35: 7,  // Business services
  38: 6,  // Telecom
  36: 5,  // Financial
  41: 3,  // Training
};

const prioritizedGaps: GapPriority[] = gaps.map((gap) => {
  const score =
    (officePriority[gap.officeCode] || 1) *
    (classPriority[gap.niceClass] || 1);

  let priority: "critical" | "high" | "medium" | "low";
  if (score >= 70) priority = "critical";
  else if (score >= 40) priority = "high";
  else if (score >= 20) priority = "medium";
  else priority = "low";

  return {
    jurisdiction: gap.officeCode,
    niceClass: gap.niceClass,
    description: gap.classDescription,
    priority,
    reason: `Score ${score} (jur: ${officePriority[gap.officeCode]}, class: ${classPriority[gap.niceClass]})`,
  };
});

// Sort by priority
const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
prioritizedGaps.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);

console.log("\n=== Prioritized Filing Recommendations ===");
for (const gap of prioritizedGaps) {
  console.log(`  [${gap.priority.toUpperCase()}] ${gap.officeCode} / Class ${gap.niceClass}: ${gap.description}`);
}

# Search for competitor marks in a gap area
curl -X POST https://api.signa.so/v1/trademarks \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "YourBrandName",
    "strategies": ["exact", "phonetic"],
    "filters": {
      "offices": ["jpo"],
      "nice_classes": [35],
      "status_stage": ["registered", "examining"]
    },
    "options": {
      "aggregations": ["office_code", "status_stage"],
      "include_total": true
    },
    "limit": 10
  }'