@nivaro/react 0.2.12 → 0.2.14

package/dist/index.d.ts

@@ -300,6 +300,19 @@ export declare interface ApiVersionInfo {
 
 export declare function applyValidationRule(rule: FormValidationRule_2, value: unknown, label: string, record?: Record<string, unknown>): string | null;
 
+/**
+ * "As it was" (#1385): the record as it stood when the notification was sent
+ * beside the record now — two columns, the fields that moved since marked
+ * with an amber dot and listed first. Scalar + link fields only; the server
+ * narrows both sides to what the viewer may read NOW. Needs `<NivaroProvider>`.
+ */
+export declare function AsItWasSheet({ notificationId, title, onClose }: {
+    notificationId: number | null;
+    /** The notification's subject — the sheet's eyebrow. */
+    title?: string | null;
+    onClose: () => void;
+}): JSX.Element;
+
 /**
  * "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
@@ -1433,6 +1446,10 @@ export declare interface DataTableProps<T = Record<string, unknown>> {
 
 export declare function DateField({ field, value, onChange, error, disabled, readOnly, inputId, errorId }: FieldComponentProps): JSX.Element;
 
+export declare function DbTuningView({ onNotice }: {
+    onNotice?: Notice;
+}): JSX.Element;
+
 /** Decoder for `?prefill=` (base64 → JSON), tolerant of '+' arriving as ' '. */
 export declare function decodePrefill(raw: string | null | undefined): Record<string, unknown> | null;
 
@@ -3950,6 +3967,8 @@ export declare function NivaroProvider({ client, children }: {
  */
 export declare function normalizeFieldType(rawType: string, iface: string | null, relation: FormFieldDescriptor['relation']): FormFieldType;
 
+declare type Notice = (message: string, tone?: 'error' | 'success') => void;
+
 export declare function NotificationActions({ actions, notificationId, onDone, onError, size, className }: NotificationActionsProps): JSX.Element | null;
 
 /** An inline action the server says is safe to fire from a click. */
@@ -4048,6 +4067,33 @@ export declare interface NotificationBellProps {
     tabBadge?: boolean;
 }
 
+/**
+ * Record bundles (#1256): the server's `bundle=record` grouping of a page —
+ * every row that names the same record folded into one entry. The rows ride
+ * along so the expand list needs no second request.
+ */
+export declare interface NotificationBundle<R = unknown> {
+    collection: string;
+    item: string;
+    /** The record's headline — friendly id, display label, or (deleted) its
+     *  trash snapshot's label. Only a client-side fold shows a raw id. */
+    label: string;
+    /** The record no longer exists: no Open, a "deleted" chip. */
+    deleted?: boolean;
+    /** "Region" — the collection's singular name for a chip beside the label. */
+    collection_label?: string | null;
+    count: number;
+    unread: number;
+    lane: NotificationLane;
+    categories: string[];
+    newest: string | null;
+    /** The server's URL for the recipient's app — the fallback when the host
+     *  has no record route. */
+    url: string | null;
+    ids: number[];
+    rows: R[];
+}
+
 export declare function NotificationCenterView({ routes, onNavigate, app, mailLogUrl, subscriptionsPath, onNotice, onError, className }: NotificationCenterViewProps): JSX.Element;
 
 export declare interface NotificationCenterViewProps {
@@ -5336,7 +5382,7 @@ export declare interface QueueRealtimeAdapter {
     subscribe: (collections: string[], onUpdate: () => void) => () => void;
 }
 
-export declare function QueueWorklist({ queueId, realtime, renderError, hideCreateActions }: QueueWorklistProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | JSX.Element | null;
+export declare function QueueWorklist({ queueId, realtime, renderError, hideCreateActions, onAsk }: QueueWorklistProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | ReactPortal | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | JSX.Element | null;
 
 export declare interface QueueWorklistProps {
     queueId: string;
@@ -5347,6 +5393,13 @@ export declare interface QueueWorklistProps {
      *  everywhere; a list hides them only when every collection the queue can
      *  create in is on it (the header covers those, not the rest). */
     hideCreateActions?: boolean | string[];
+    /** Hosts with an Ask AI page pass this: the toolbar gains "Ask about this
+     *  queue" (#1276), which hands the queue over so the host can open Ask AI
+     *  with the question seeded. Absent = no button. */
+    onAsk?: (queue: {
+        id: string;
+        name: string;
+    }) => void;
 }
 
 export declare function QueueWorkloadView({ queueId }: {
@@ -6710,6 +6763,97 @@ export declare function translateScopeValues(client: {
     target_collection: string;
 }, ids: Array<string | number>, valueField?: string): Promise<Array<string | number>>;
 
+/**
+ * Database tuning (#996): what the nightly observer proposed, the proof behind each proposal,
+ * and the one-click Apply / Roll back / Dismiss / Re-prove. Propose-only — nothing changes until
+ * an administrator clicks; the request carries the proposal id, never a statement.
+ */
+declare type TuningKind = 'index_create' | 'index_drop' | 'proc_rewrite' | 'rollup_store' | 'query_cache';
+
+declare interface TuningProof {
+    passed: boolean;
+    method: string;
+    before: Record<string, number | string | null>;
+    after: Record<string, number | string | null>;
+    detail: string;
+    rows_diff?: Array<{
+        set: number;
+        added: string[];
+        removed: string[];
+    }>;
+    watch?: Array<{
+        at: string;
+        value: number | null;
+    }>;
+}
+
+/** Mirror of the API's ProposalRow. */
+export declare interface TuningProposal {
+    id: string;
+    kind: TuningKind;
+    target: string;
+    fingerprint: string;
+    status: TuningStatus;
+    title: string;
+    evidence: Record<string, unknown>;
+    proof: TuningProof | null;
+    estimate_ms_per_day: number;
+    risk: 'reversible' | 'review';
+    replicated: boolean;
+    dialect_note: string | null;
+    apply: Record<string, unknown>;
+    undo: Record<string, unknown>;
+    applied_at: string | null;
+    applied_by: string | null;
+    watch_until: string | null;
+    watch_baseline: {
+        before: Record<string, number | null>;
+        after: Record<string, number | null>;
+    } | null;
+    rolled_back_at: string | null;
+    rollback_reason: string | null;
+    dismissed_at: string | null;
+    dismissed_by: string | null;
+    dismiss_note: string | null;
+    first_seen: string;
+    last_seen: string;
+    run_id: number | null;
+}
+
+declare interface TuningSettings {
+    enabled: boolean;
+    ai_rewrites: boolean;
+    min_estimate_ms_per_day: number;
+    watch_days: number;
+    regression_pct: number;
+    proc_timeout_minutes: number;
+    ai_daily_budget_usd: number;
+}
+
+declare type TuningStatus = 'proposed' | 'rejected_by_proof' | 'stale' | 'applying' | 'watching' | 'applied' | 'rolled_back' | 'dismissed' | 'failed';
+
+/** GET /db-tuning. */
+export declare interface TuningSummary {
+    settings: TuningSettings;
+    by_status: Record<string, number>;
+    by_kind: Record<string, number>;
+    open_estimate_ms_per_day: number;
+    applied_30d: number;
+    last_run: {
+        id: number;
+        started_at: string;
+        status: string;
+        outcome: string | null;
+        error: string | null;
+    } | null;
+    is_running: boolean;
+    observers: Array<{
+        id: string;
+        owner: string;
+        kind: string;
+    }>;
+}
+
 /** What is unsaved right now — the leave-page prompt, the changes tray and
  *  the host's own dirty indicator all read this one breakdown. */
 declare interface UnsavedSummary {