Policy Form Structure and Source Tree Organization

type DocumentSourceNodeKind =
  | "document"    // Root of the tree
  | "page_group"  // Logical grouping of pages
  | "page"        // Individual PDF page
  | "form"        // Named policy form
  | "endorsement" // Endorsement form
  | "section"     // Labeled section within a form
  | "schedule"    // Schedule table or list
  | "clause"      // Individual clause or condition
  | "table"       // Tabular structure
  | "table_row"   // Row within a table
  | "table_cell"  // Cell within a table row
  | "text";       // Freeform text block

interface FormReference {
  formNumber: string;
  editionDate?: string;
  title?: string;
  formType: "coverage" | "endorsement" | "declarations" | "application" | "notice" | "other";
}

interface OperationalCoverageLine {
  name: string;
  coverageCode?: string;
  limit?: string;
  deductible?: string;
  premium?: string;
  retroactiveDate?: string;
  formNumber?: string;
  sectionRef?: string;
  endorsementNumber?: string;
  limits: OperationalCoverageTerm[];  // each-claim, aggregate, retention, etc.
  sourceNodeIds: string[];            // IDs of source tree nodes that support this line
  sourceSpanIds: string[];            // IDs of raw source spans for PDF highlights
}

import type { DocumentSourceNode } from "@claritylabs/cl-sdk";

const result = await extractor.extract(pdfBase64, "doc-123", { sourceSpans });

// The source tree is a flat array — nodes relate via parentId, not nested children.
const endorsements = (result.sourceTree ?? []).filter(
  (node: DocumentSourceNode) => node.kind === "endorsement"
);

for (const node of endorsements) {
  console.log(node.id, node.title);
}