@nivaro/react 0.1.299 → 0.1.300

package/dist/index.d.ts

@@ -1267,6 +1267,88 @@ export declare function dmPeer(room: string, self: string): string | null;
 
 export declare function dmRoom(a: string, b: string): string;
 
+declare type DocumentApplySelection = {
+    values: Record<string, unknown>;
+    lines_by_alias: Record<string, Array<{
+        values: Record<string, unknown>;
+    }>>;
+    m2m: Record<string, Array<string | number>>;
+    file_id: string | null;
+    summary: string;
+    document_name: string;
+};
+
+export declare function DocumentAutofillButton({ collection, onApply, className }: {
+    collection: string;
+    onApply: (selection: DocumentApplySelection, proposal: DocumentProposal) => void | Promise<void>;
+    className?: string;
+}): JSX.Element | null;
+
+/**
+ * "Fill from a document" — a person drops a statement of work, a quote, a
+ * spreadsheet on a NEW record and reviews what the model read out of it
+ * before any of it lands in the form. Server contract: POST /ai/extract-record
+ * returns a DocumentProposal (values + confidence + the sentence each came
+ * from); this dialog is the review. Nothing is written until Apply, and Apply
+ * only stages — the record still needs Create.
+ */
+declare type DocumentProposal = {
+    collection: string;
+    summary: string;
+    fields: Array<{
+        field: string;
+        label: string;
+        value: unknown;
+        display: string | null;
+        confidence: number;
+        source: string | null;
+    }>;
+    children: Array<{
+        alias: string;
+        label: string;
+        collection: string;
+        lines: Array<{
+            values: Record<string, unknown>;
+            display: Record<string, string>;
+            confidence: number;
+            source: string | null;
+        }>;
+    }>;
+    m2m: Array<{
+        alias: string;
+        label: string;
+        items: Array<{
+            id: string | number;
+            label: string;
+            confidence: number;
+        }>;
+    }>;
+    asks: Array<{
+        field: string;
+        label: string;
+        reason: string;
+    }>;
+    warnings: string[];
+    prefill: {
+        values: Record<string, unknown>;
+        lines_by_alias: Record<string, Array<{
+            values: Record<string, unknown>;
+        }>>;
+        m2m: Record<string, Array<string | number>>;
+        file_id: string | null;
+        attach_alias: string | null;
+    };
+    document: {
+        name: string;
+        method: string;
+        pages: number | null;
+        truncated: boolean;
+        chars: number;
+    };
+    model: string;
+    rounds: number;
+};
+
 /** One dot per partner, worst outcome winning — a red dot must never be
  *  hidden behind a green one from the same partner. Superseded rows are
  *  never a partner's CURRENT state, so they never contribute a dot at all. */
@@ -2074,7 +2156,7 @@ export declare function idleState(): {
     last_active: string;
 };
 
-export declare function ImportConsole({ realtime, defaultTab, initialJobId, onJobOpen }: ImportConsoleProps): JSX.Element;
+export declare function ImportConsole({ realtime, defaultTab, initialJobId, onJobOpen, initialRunId, onRunOpen }: ImportConsoleProps): JSX.Element;
 
 export declare interface ImportConsoleProps {
     /**
@@ -2089,6 +2171,10 @@ export declare interface ImportConsoleProps {
     /** Fires when a collection-import job's detail opens or closes, so a host
      *  can keep its own URL in step. */
     onJobOpen?: (id: string | null) => void;
+    /** Deep link into a staged run's detail (admin /imports?run=9801). */
+    initialRunId?: number | null;
+    /** Fires when a staged run's detail opens or closes. */
+    onRunOpen?: (id: number | null) => void;
 }
 
 export declare type ImportConsoleTab = 'runs' | 'collection' | 'definitions';
@@ -2281,9 +2367,17 @@ export declare interface ImportRun {
     created_at: string | null;
     updated_at: string | null;
     legacy_id: number | null;
+    /** What executed: 'procedure:<name>', 'service', 'load' or a processor key.
+     *  Null on runs from before it was recorded. */
+    ran_via?: string | null;
+    reverted_at?: string | null;
+    /** Detail route only. */
+    report?: ImportRunReport | null;
     definition_label: string | null;
     staging_table: string | null;
     procedure: string | null;
+    /** null / 'proc' = stored procedure, 'service', or a registered processor key. */
+    processor?: string | null;
     loader: 'bulk' | 'insert' | null;
     definition_active: boolean | null;
     file_name: string | null;
@@ -2293,9 +2387,51 @@ export declare interface ImportRun {
     created_by_email: string | null;
 }
 
+declare interface ImportRunPhase {
+    key: string;
+    label: string;
+    ms: number;
+    count?: number;
+    failed?: number;
+}
+
+/** What a run did — counts, timings, values in the file that matched nothing. */
+declare interface ImportRunReport {
+    counts: {
+        created: number;
+        updated: number;
+        unchanged: number;
+        skipped: number;
+        failed: number;
+        other?: Array<{
+            label: string;
+            count: number;
+        }>;
+    };
+    skipped: Record<string, number>;
+    phases: ImportRunPhase[];
+    unmatched: ImportRunUnmatched[];
+    notes: string[];
+    collections?: Record<string, {
+        created: number;
+        updated: number;
+    }>;
+    items_stored?: number;
+    items_truncated?: boolean;
+}
+
 /** Shared types for the Import Console (`/api/staged-imports`). */
 export declare type ImportRunStatus = 'queued' | 'running' | 'completed' | 'error' | 'canceled';
 
+declare interface ImportRunUnmatched {
+    column: string;
+    label: string;
+    values: string[];
+    distinct: number;
+    rows: number;
+    effect: string;
+}
+
 /** The chip a definitions list shows beside each import. */
 export declare function ImportStalenessChip({ importKey }: {
     importKey: string;