@nivaro/react 0.2.6 → 0.2.8

package/dist/index.d.ts

@@ -17,6 +17,7 @@ import { ReactPortal } from 'react';
 import { ReportDateRange } from '@nivaro/sdk';
 import { ReportEntityFilter } from '@nivaro/sdk';
 import { ReportQueryWidgetConfig } from '@nivaro/sdk';
+import { ReportWidget } from '@nivaro/sdk';
 import { UseMutationResult } from '@tanstack/react-query';
 import { UseQueryResult } from '@tanstack/react-query';
 import { UserScopesInfo } from '@nivaro/sdk';
@@ -500,7 +501,7 @@ export declare function BulkActionButtons({ targets, enabledKeys, tone, disabled
     onDone?: (result: BulkRunResult & {
         action: AvailableBulkAction;
     }) => void;
-}): JSX.Element | null;
+}): JSX.Element;
 
 declare interface BulkRunResult {
     succeeded: number;
@@ -515,6 +516,8 @@ declare interface BulkRunResult {
 declare interface BulkTarget {
     collection: string;
     id: string | number;
+    /** Optional display label — names the row in per-row result lists. */
+    label?: string | null;
 }
 
 /**
@@ -531,6 +534,15 @@ export declare function CacheStamp({ envelope, onRefresh, refreshing, className
     className?: string;
 }): JSX.Element | null;
 
+export declare function CallerChangesSection({ caller, hours }: {
+    /** `k<api key id>` or `u<user id>`. */
+    caller: {
+        key: string;
+        label: string;
+    };
+    hours: number;
+}): JSX.Element;
+
 export declare function canOpenCatalogItem(collection: string | null | undefined): boolean;
 
 export declare function canOpenChatRoom(): boolean;
@@ -539,6 +551,8 @@ export declare function canOpenDm(): boolean;
 
 export declare function canPreviewFile(type: string | null | undefined): boolean;
 
+export declare function canViewAs(): boolean;
+
 /**
  * Grab the replay link for an error being reported right now. Resolves null
  * when no recorder is active (both settings off, recording failed, or the
@@ -888,7 +902,7 @@ export declare function ChatRoomList({ rooms, onOpen, onNewGroup, archivedView,
     loading?: boolean;
 }): JSX.Element;
 
-export declare function ChatRoomView({ room, label, onBack, onOpenSettings, renderMessageBody, initialUnread, anchor: anchorProp }: {
+export declare function ChatRoomView({ room, label: labelProp, onBack, onOpenSettings, renderMessageBody, initialUnread, anchor: anchorProp }: {
     room: string;
     label: string;
     onBack: () => void;
@@ -1049,7 +1063,7 @@ export declare interface CollectionBrowserColumn {
     filterable?: boolean;
 }
 
-export declare function CollectionBrowserView({ collection, quickFilters, initialColumns, initialSort, pageSize, initialSearch, initialFilters, initialConditions, onOpenItem, showCreate, className }: CollectionBrowserViewProps): React_2.JSX.Element;
+export declare function CollectionBrowserView({ collection, quickFilters, initialColumns, initialSort, pageSize, initialSearch, initialFilters, initialConditions, onOpenItem, initialAiPrompt, extraViews, showCreate, className }: CollectionBrowserViewProps): React_2.JSX.Element;
 
 export declare interface CollectionBrowserViewProps {
     collection: string;
@@ -1077,6 +1091,17 @@ export declare interface CollectionBrowserViewProps {
     }>;
     /** Override row-open behavior; defaults to NavigationContext itemUrl. */
     onOpenItem?: (id: string | number) => void;
+    /** Ask the table this question once on open (e.g. a command-palette
+     *  hand-off, `?ai=` on the host route). */
+    initialAiPrompt?: string;
+    /** Host-supplied display modes beside the table (e.g. a spreadsheet or
+     *  calendar the host app owns). Each renders instead of the table. */
+    extraViews?: Array<{
+        key: string;
+        label: string;
+        icon?: React_2.ReactNode;
+        render: () => React_2.ReactNode;
+    }>;
     showCreate?: boolean;
     className?: string;
 }
@@ -2080,6 +2105,16 @@ export declare function fiscalQuarterOf(d: Date, startMonth?: number): number;
 
 export declare function fiscalYearOf(d: Date, startMonth?: number): number;
 
+/** Bring a field or a child row of the open record into view (ItemEditForm
+ *  listens for 'nvr:record-focus'). */
+export declare function focusRecordTarget(target: {
+    collection: string;
+    item: string;
+    field?: string;
+    childCollection?: string;
+    rowId?: string;
+}): void;
+
 /** The window event a host's socket layer dispatches on `client:force-refresh`. */
 export declare const FORCE_RELOAD_EVENT = "nvr:force-refresh";
 
@@ -2465,7 +2500,7 @@ export declare interface ImportDefinition {
     description: string | null;
     staging_table: string | null;
     procedure: string | null;
-    loader: 'bulk' | 'insert' | null;
+    loader: 'bulk' | 'bulk_only' | 'insert' | null;
     file_types: string | null;
     is_active: boolean;
     sort: number;
@@ -2483,6 +2518,13 @@ export declare interface ImportDefinition {
     /** JSON array of flow ids run in order after a successful run (migration 294). */
     post_run_flows?: string | null;
     receipt?: string | null;
+    /** #802 — runs sharing a group never overlap; null = the staging table. */
+    lock_group?: string | null;
+    /** #719 — JSON string[] of collections the procedure writes (rollups recomputed). */
+    recalc_rollups?: string | null;
+    /** #846 — days after the last completed run the staging table is emptied; opt-in, null/0 = keep. */
+    staging_purge_days?: number | null;
+    staging_purged_at?: string | null;
 }
 
 declare interface ImportDryRun {
@@ -2585,6 +2627,8 @@ export declare interface ImportJob {
     started_at: string | null;
     completed_at: string | null;
     rolled_back_at?: string | null;
+    /** #748 — rows were written through the items service. */
+    through_items?: boolean;
 }
 
 export declare type ImportJobStatus = 'pending' | 'processing' | 'complete' | 'failed';
@@ -2652,7 +2696,7 @@ export declare interface ImportRun {
     procedure: string | null;
     /** null / 'proc' = stored procedure, 'service', or a registered processor key. */
     processor?: string | null;
-    loader: 'bulk' | 'insert' | null;
+    loader: 'bulk' | 'bulk_only' | 'insert' | null;
     definition_active: boolean | null;
     file_name: string | null;
     file_size: string | number | null;
@@ -2767,6 +2811,20 @@ export declare function InboundCallersView({ hours: initialHours }: {
     hours?: number;
 }): JSX.Element;
 
+/**
+ * A trigger (any inline element) that opens the request behind an inbound
+ * write. The event-path sheet opens AFTER the popover closes, so a sheet
+ * never mounts inside a popover.
+ */
+export declare function InboundRequestPopover({ activityId, callerName, collection, itemId, children, align }: {
+    activityId: number;
+    callerName: string;
+    collection: string;
+    itemId: string;
+    children: ReactNode;
+    align?: 'start' | 'center' | 'end';
+}): JSX.Element;
+
 /**
  * Inbound: health first — the host's own live queue (an ingest backlog, say), then whether
  * scheduled imports are arriving on time — and investigation last, since who
@@ -2994,6 +3052,16 @@ export declare interface IntegrationPartnerCard {
         missing: number;
         overdue: number;
     };
+    /** #612 — health-probe uptime over 24h; null when the API is not probed. */
+    uptime24?: {
+        pct: number | null;
+        probes: number;
+        buckets: Array<{
+            at: string;
+            ok: number;
+            failed: number;
+        }>;
+    } | null;
 }
 
 export declare interface IntegrationPartnerDetail {
@@ -3046,6 +3114,29 @@ export declare type IntegrationPathDetail = {
     from?: string | null;
     to?: string | null;
     comment?: string | null;
+} | {
+    type: 'notify';
+    recipient: string;
+    /** Admins only; null for everyone else. */
+    subject: string | null;
+    category?: string | null;
+    lane?: string | null;
+    channels: Array<{
+        channel: string;
+        status: string;
+        reason?: string | null;
+    }>;
+} | {
+    type: 'mail';
+    status: string;
+    /** Admins only; null for everyone else. */
+    subject: string | null;
+    template?: string | null;
+    /** Addresses — admins only; null for everyone else. */
+    to?: string | null;
+    recipients: number;
+    mail_log_id: number;
+    error?: string | null;
 };
 
 /** One step of an event's path, with the steps it set off under it. */
@@ -3077,11 +3168,11 @@ export declare interface IntegrationPathNode {
     members?: IntegrationPathNode[];
 }
 
-/** The filter-pill set the collection browser offers (its own conditions[]
- *  round trip to `/items/:collection` — the queue has no equivalent server
- *  path, so it gets the column but not the filter). Values are the same
- *  bucket names `applyIntegrationsFilter` (api/src/services/items.ts) reads,
- *  so a picked value needs no translation before it rides a condition. */
+/** The filter set the collection browser (a `$integrations` condition to
+ *  `/items/:collection`) and the queue (`filters.integrations`, #630 —
+ *  services/queue-integrations.ts) both offer. Values are the bucket names
+ *  `applyIntegrationsFilter` (api/src/services/items.ts) reads, so a picked
+ *  value needs no translation on either surface. */
 export declare const INTEGRATIONS_FILTER_OPTIONS: {
     value: string;
     label: string;
@@ -3179,26 +3270,6 @@ export declare interface IntegrationSignalView {
     shown: number;
 }
 
-export declare function IntegrationStatusBanner({ collection, itemId }: IntegrationStatusBannerProps): JSX.Element | null;
-
-/**
- * One line per partner on the record: were they told, when, and if not, why
- * not. Sits above `ErpFailureBanner`, which keeps the payload/response view
- * and the retry mutation — this answers a different question ("was the
- * partner told, and when") and does not replace it.
- *
- * Renders nothing when the record has no obligations, so a collection with
- * no integrations pays one cached request and shows no chrome.
- *
- * `roleForTone` is imported from `IntegrationObligationsView` (the board)
- * rather than duplicated here, so the board and this banner can never
- * disagree about what "overdue" looks like.
- */
-export declare interface IntegrationStatusBannerProps {
-    collection: string;
-    itemId: string | number;
-}
-
 /** Whether this browser pinned the chat panel open — hosts read it for their
  *  initial open state, so a pinned panel is still there after a reload. */
 export declare function isChatPanelPinned(): boolean;
@@ -4258,6 +4329,16 @@ export declare function OpsTasksView({ onNotice }: {
     onNotice?: (message: string) => void;
 }): JSX.Element;
 
+/** #615 — the Integrations dialog's "What goes out next" block. */
+export declare function OutboundPreviewSection({ collection, itemId, onShowRequest, onJump }: {
+    collection: string;
+    itemId: string;
+    /** Open the request log row a comparison was made against. */
+    onShowRequest?: (submissionId: number) => void;
+    /** A readiness issue jumps to a line — the hosting dialog closes first. */
+    onJump?: () => void;
+}): JSX.Element | null;
+
 /**
  * Lets a host put transient overlay state — a drill-down sheet and how deep it
  * is — into browser history, so Back closes the sheet instead of abandoning the
@@ -4407,6 +4488,11 @@ declare interface PartnerContract {
     detail: string | null;
 }
 
+export declare function PartnerDependenciesPanel({ callerKey, label }: {
+    callerKey: string;
+    label: string;
+}): JSX.Element;
+
 export declare function PartnerDetail({ apiId, onClose, initialTab }: PartnerDetailProps): JSX.Element;
 
 export declare interface PartnerDetailProps {
@@ -4423,7 +4509,7 @@ export declare interface PartnersViewProps {
     onOpenChange?: (id: number | null) => void;
 }
 
-declare type PathStepKind = 'request' | 'cron' | 'import' | 'feed' | 'write' | 'transition' | 'flow' | 'push' | 'attempt' | 'partner_call' | 'group';
+declare type PathStepKind = 'request' | 'cron' | 'import' | 'feed' | 'write' | 'transition' | 'flow' | 'push' | 'attempt' | 'partner_call' | 'notify' | 'mail' | 'group';
 
 declare interface PendingTask {
     title: string;
@@ -4437,6 +4523,38 @@ declare interface PendingTask {
     priority?: string;
 }
 
+/**
+ * The same, minus machine identities (bots, integrations, service accounts,
+ * placeholders — `account_kind` set). A person picking a contact or an
+ * assignee should only ever be offered people; admins keep the machine
+ * accounts because they occasionally configure one on purpose.
+ */
+export declare const PEOPLE_USER_OPTION_FILTER: {
+    _and: ({
+        is_redacted: {
+            _eq: boolean;
+        };
+        _or?: undefined;
+    } | {
+        _or: ({
+            status: {
+                _neq: string;
+                _null?: undefined;
+            };
+        } | {
+            status: {
+                _null: boolean;
+                _neq?: undefined;
+            };
+        })[];
+        is_redacted?: undefined;
+    } | {
+        account_kind: {
+            _null: boolean;
+        };
+    })[];
+};
+
 /**
  * The identity band at the top of someone's page: who they are, whether
  * they are reachable right now, and the three ways to reach them. Admin-only
@@ -4530,6 +4648,12 @@ export declare interface PersonProfileData {
         values: string[];
     }>;
     open_tasks: number;
+    /** When they are usually around (UTC hours, 10th–90th percentile of their actions). */
+    typical_hours_utc?: {
+        start: number;
+        end: number;
+        samples: number;
+    } | null;
     admin: {
         account_kind: string | null;
         city: string | null;
@@ -4667,6 +4791,33 @@ export declare function PipelineTransitionButtons({ collection, item, onBeforeTr
     wrap?: boolean;
 }): JSX.Element | null;
 
+export declare interface PlanGridHost {
+    renderRowHistory?: (args: PlanGridRowHistoryArgs) => ReactNode | null;
+}
+
+export declare const PlanGridHostContext: Context<PlanGridHost | null>;
+
+/**
+ * What a host may put in place of a plan grid's generic parts (#842). Core
+ * stays domain-free: a host that has a richer history for a collection (a
+ * forecast history with restores and accuracy) renders it here; returning
+ * null keeps the generic row-history sheet.
+ */
+export declare interface PlanGridRowHistoryArgs {
+    /** The plan rows' collection ("forecasts"). */
+    collection: string;
+    /** The record the grid belongs to. */
+    parentId: string;
+    /** The saved row, when there is one. */
+    rowId: string | null;
+    /** The row's key value ("2026"). */
+    key: string;
+    /** The row's category id when the key is split by category, else null. */
+    category: string | null;
+    categoryLabel: (id: string | number) => string;
+    onClose: () => void;
+}
+
 /** Play the configured notification sound. No-op for 'off'/unknown/unavailable audio. */
 export declare function playNotificationSound(kind: NotificationSound | string | null | undefined): void;
 
@@ -4760,6 +4911,24 @@ declare type ProposalPollAnswer = {
     json: any;
 };
 
+/**
+ * "Ready" / "2 lines missing Sales order" beside a button that sends
+ * something to a partner. Give it a transition id (the pipeline pre-flight)
+ * or an item action id (the extension's own pre-flight).
+ */
+export declare function PushReadinessChip({ collection, itemId, transitionId, itemActionId, label, compact, onJump }: {
+    collection: string;
+    itemId: string;
+    transitionId?: string;
+    itemActionId?: string;
+    /** What the button does — "Submit to Warehouse". */
+    label: string;
+    /** Header use: a dot + a short word; the popover says the rest. */
+    compact?: boolean;
+    /** Called before a jump — a hosting dialog closes so the line shows. */
+    onJump?: () => void;
+}): JSX.Element | null;
+
 export declare function QualityRulesView({ className }: {
     className?: string;
 }): JSX.Element;
@@ -5325,6 +5494,48 @@ export declare function RecordDrilldownSheet({ collection, itemId, layoutId, roo
     onClose: () => void;
 }): JSX.Element;
 
+export declare function RecordGraphExplorer({ collection, itemId, className }: {
+    collection: string;
+    itemId: string;
+    className?: string;
+}): JSX.Element;
+
+export declare interface RecordGraphGroup {
+    key: string;
+    direction: 'out' | 'in' | 'm2m';
+    field: string;
+    label: string;
+    collection: string;
+    collection_label: string;
+    total: number;
+    items: RecordGraphNode[];
+}
+
+/**
+ * Relationship explorer (#998). A record's neighbourhood drawn as a tree that
+ * grows one hop at a time: the record, the relations it takes part in
+ * (grouped — "Purchase orders · 3"), and the records behind each group. Any
+ * record node expands the same way, so a workflow → its PO → the PO's
+ * invoices is three clicks. Clicking a record opens it in the drill sheet
+ * (or navigates when the host has none).
+ *
+ * Every hop is read as the viewer by GET /record-graph/:collection/:id, so
+ * the picture never shows a record the viewer could not open themselves.
+ */
+export declare interface RecordGraphNode {
+    collection: string;
+    id: string;
+    label: string;
+}
+
+/** Right sheet hosting the explorer — hosts mount it beside the record form. */
+export declare function RecordGraphSheet({ collection, itemId, open, onOpenChange }: {
+    collection: string;
+    itemId: string;
+    open: boolean;
+    onOpenChange: (v: boolean) => void;
+}): JSX.Element;
+
 export declare function RecordGridEditor({ config }: {
     config: RecordGridEditorConfig;
 }): JSX.Element;
@@ -5488,6 +5699,9 @@ export declare function registerLayoutSlot(plugin: LayoutSlotPlugin): void;
 
 export declare function registerRoomOpener(fn: RoomOpener): () => void;
 
+/** Register the host's opener. Returns an unregister function. */
+export declare function registerViewAsOpener(fn: ViewAsOpener): () => void;
+
 export declare function RelatedRecordsPanel({ collection, itemId, title, defaultExpanded }: {
     collection: string;
     itemId: string;
@@ -5603,6 +5817,20 @@ export declare interface ReportViewProps {
     emptyState?: React.ReactNode;
 }
 
+/**
+ * One saved report widget on its own, outside its report's grid — how a host
+ * places a report widget on a dashboard canvas (#1044). The widget is drawn at
+ * column 0 of an absent grid, so its report-grid placement does nothing and
+ * the card fills whatever cell holds it. Drill-through goes to the host's
+ * DrilldownContext when there is one.
+ */
+export declare function ReportWidgetCard({ reportId, widget, dateRange, entityFilters }: {
+    reportId: string;
+    widget: ReportWidget;
+    dateRange?: ReportDateRange | null;
+    entityFilters?: ReportEntityFilter[];
+}): JSX.Element;
+
 export declare function resolveCollectionIcon(iconName: string | null | undefined): React.ElementType | null;
 
 export declare function resolveNotificationTarget(collection: string | null | undefined, item: string | null | undefined, routes: NotificationRouteMap): NotificationTarget;
@@ -6871,6 +7099,8 @@ export declare function usePeerReadAt(room: string | null): string | null;
 
 export declare function usePersonProfile(userId: string | null | undefined): UseQueryResult<NoInfer<PersonProfileData | null>, Error>;
 
+export declare function usePlanGridHost(): PlanGridHost | null;
+
 /**
  * The quick picker BEFORE a record exists — the "+ New" menus open it, and on
  * Create the host navigates to the new-record page with the picks in
@@ -6964,6 +7194,33 @@ export declare function useRoomMembership(): {
 
 export declare function useRoomPins(room: string | null): NoInfer<PinnedMessage[]>;
 
+/** The user-picker option filter for this viewer (#732). */
+export declare function userOptionFilter(isAdmin: boolean): {
+    _and: ({
+        is_redacted: {
+            _eq: boolean;
+        };
+        _or?: undefined;
+    } | {
+        _or: ({
+            status: {
+                _neq: string;
+                _null?: undefined;
+            };
+        } | {
+            status: {
+                _null: boolean;
+                _neq?: undefined;
+            };
+        })[];
+        is_redacted?: undefined;
+    } | {
+        account_kind: {
+            _null: boolean;
+        };
+    })[];
+};
+
 /** Stacked avatar cluster (+N) with a hover/pinnable portal roster whose rows
  *  are UserChips — the single user-display primitive for owners/user lists.
  *  Reused by the item-header Owners chip and the collection browser. */
@@ -7070,6 +7327,23 @@ declare interface ValidationResult {
     unknownTokens: string[];
 }
 
+export declare function viewAs(person: {
+    id: string;
+    name: string;
+}): void | Promise<void>;
+
+/**
+ * "View as" registry (#640). A profile page offers "View as <person>" only
+ * while the host app has said how it opens itself as someone else — the
+ * admin opens a new tab on a per-tab masquerade token; a host without the
+ * idea never registers and the button never shows. Same shape as the chat
+ * DM opener registry.
+ */
+declare type ViewAsOpener = (person: {
+    id: string;
+    name: string;
+}) => void | Promise<void>;
+
 export declare function WidgetSlot({ widgetId, inputBindings, itemDraft, itemCollection, ready, label, defaultExpanded, frameless, apiBase: apiBaseProp, compact, strip, onClientAction, onWidgetType, onContentChange }: WidgetSlotProps): JSX.Element | null;
 
 declare interface WidgetSlotProps {