@nivaro/react 0.1.299 → 0.1.301

package/dist/index.d.ts

@@ -413,6 +413,8 @@ export declare function BroadcastView({ className }: {
     className?: string;
 }): JSX.Element;
 
+export declare function buildCopyAs(input: CopyAsInput): CopyAsSnippets;
+
 export declare function buildGroups<T extends QueueGroupingRow>(rows: T[], attribute: string): QueueGroup<T>[];
 
 export declare function BulkActionButtons({ targets, enabledKeys, tone, disabled, onDone }: {
@@ -1010,10 +1012,44 @@ export declare type ComponentOverrides = {
     fallback?: default_2.ComponentType<FieldComponentProps>;
 };
 
+/** The browser's conditions as the filter object the SDK and GraphQL take:
+ *  a dotted path folds into nested objects, an `or` group into `_or`, and
+ *  several conditions AND together. */
+export declare function conditionsToFilter(conditions: string | undefined): Record<string, unknown> | null;
+
 export declare function ConformanceView({ className }: {
     className?: string;
 }): JSX.Element;
 
+/**
+ * "Copy as …" (#654): the request behind a list or a record, as a curl
+ * command, an SDK call and a GraphQL document, each ready to paste. The
+ * token is always the `NIVARO_TOKEN` placeholder, never the viewer's own.
+ */
+export declare function CopyAsButton({ collection, itemId, list, fields, compact, className }: Omit<CopyAsInput, 'origin'> & {
+    /** Icon-only, borderless — for the record header's tool group. */
+    compact?: boolean;
+    className?: string;
+}): JSX.Element;
+
+declare interface CopyAsInput {
+    /** The host the API is served from, no trailing slash. */
+    origin: string;
+    collection: string;
+    /** A record id renders the single-record forms. */
+    itemId?: string | null;
+    list?: ListRequest;
+    /** Plain or dotted field keys the GraphQL selection lists (`id` is always
+     *  first; a key that starts with `__` is a synthetic column and skipped). */
+    fields?: string[];
+}
+
+declare interface CopyAsSnippets {
+    curl: string;
+    sdk: string;
+    graphql: string;
+}
+
 /**
  * `opts.open` is the gate's state AT CONSTRUCTION. A host that starts a
  * hidden tab must pass `false` here rather than calling `setOpen(false)`
@@ -1267,6 +1303,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 +2192,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 +2207,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 +2403,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 +2423,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;
@@ -3123,6 +3295,24 @@ export declare interface LeaderSocketHandle {
 
 export declare function listFieldInterfaces(): string[];
 
+/**
+ * "Copy as …" (#654): the request a list or record view is making, rendered
+ * as a curl command, an SDK call and a GraphQL document. Pure — no client,
+ * no DOM — so the three renderings can be judged against each other.
+ *
+ * The token is never the real one: every rendering names `NIVARO_TOKEN`.
+ */
+declare interface ListRequest {
+    /** The browser's `conditions` JSON (an array of {path, op, value} and
+     *  `{or: [...]}` groups), already serialised. */
+    conditions?: string;
+    search?: string;
+    /** Comma-joined sort, `-` prefix = descending. */
+    sort?: string;
+    limit?: number;
+    page?: number;
+}
+
 declare interface LockHolder {
     locked_by: string;
     locked_by_name: string | null;