@nivaro/react 0.1.282 → 0.1.283

package/dist/index.d.ts

@@ -346,6 +346,20 @@ declare interface AvailableBulkAction {
     guard?: GuardRule[] | null;
 }
 
+export declare interface BannerLine {
+    api: string;
+    tone: 'danger' | 'warning' | 'neutral' | 'positive';
+    text: string;
+    obligation_id: number;
+    outcome: string;
+}
+
+/** Newest obligation per partner, in the words the record's reader needs:
+ *  when they were told, or when they should have been and why not. Pure —
+ *  no fetch, so it's unit-testable without a DOM and reusable by the record
+ *  banner AND anywhere else that ends up wanting the same sentence. */
+export declare function bannerLines(rows: Row[], now?: Date): BannerLine[];
+
 export declare function BaseMap({ pins, bubbles, statusLine, onPinClick, onBubbleClick, minHeight, focus }: {
     pins: BaseMapPin[];
     bubbles?: BaseMapBubble[];
@@ -1229,6 +1243,17 @@ export declare function dmPeer(room: string, self: string): string | null;
 
 export declare function dmRoom(a: string, b: string): string;
 
+/** 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. */
+export declare function dotsForRecord(rows: Array<{
+    api: string;
+    outcome: string;
+}>): Array<{
+    api: string;
+    tone: 'positive' | 'warning' | 'danger' | 'neutral';
+}>;
+
 declare type DrawerRelationConfig = string | {
     field: string;
     hint?: {
@@ -2262,6 +2287,55 @@ declare interface InputBinding {
     binding_value: string;
 }
 
+export declare function IntegrationDots({ rows, className }: IntegrationDotsProps): JSX.Element;
+
+export declare interface IntegrationDotsProps {
+    rows: Array<{
+        api: string;
+        outcome: string;
+    }> | undefined;
+    className?: string;
+}
+
+export declare function IntegrationObligationsView({ api, className }: IntegrationObligationsViewProps): JSX.Element;
+
+export declare interface IntegrationObligationsViewProps {
+    /** Pre-select and scope the board to one partner's tiles. Absent (the
+     *  admin Integration Health page's usage) shows every registered API. */
+    api?: string;
+    className?: string;
+}
+
+/** 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. */
+export declare const INTEGRATIONS_FILTER_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+
+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;
+}
+
 export declare function ItemActionButtons({ collection, itemId }: {
     collection: string;
     itemId: string;
@@ -3177,6 +3251,23 @@ declare interface O2MFieldInfo {
     parentId: string;
 }
 
+/**
+ * Pure filter-state helpers for the integration obligations board
+ * (`IntegrationObligationsView`). Kept separate from the component so the
+ * query-param and tone rules are unit-testable without a DOM.
+ */
+export declare interface ObligationFilterState {
+    api: string | null;
+    kind: string | null;
+    outcome: string[];
+    ageHours: number | null;
+}
+
+/** Unset filters are omitted entirely — an empty string would narrow the
+ *  query to rows whose column is empty, which is never what a cleared filter
+ *  means. */
+export declare function obligationQueryParams(s: ObligationFilterState): Record<string, string>;
+
 /**
  * Offline banner (#348): connectivity loss shows an honest "offline — changes
  * paused" strip and clears itself when the connection returns. Uses the
@@ -4438,6 +4529,21 @@ export declare interface RoomInfo {
  */
 declare type RoomOpener = (room: string, label?: string) => void;
 
+declare interface Row {
+    id: number;
+    api: string;
+    kind: string;
+    outcome: string;
+    reason: string | null;
+    due_at: string;
+    resolved_at: string | null;
+    /** 'transition' | 'hook' | 'flow' | 'cron' | 'reconcile' | 'manual' —
+     *  kept as a bare string rather than importing the server's
+     *  ObligationTrigger union into this client lib for one comparison, so a
+     *  new trigger kind added server-side never breaks this file's build. */
+    trigger?: string;
+}
+
 export declare const ROW_HIGHLIGHT_TINTS: Record<string, {
     row: string;
     text: string;
@@ -4864,6 +4970,13 @@ export declare function titleCase(str: string): string;
 
 export declare type TokenResolver = (path: string) => unknown;
 
+/** Which of the four alert tones an outcome reads as — overdue/failed/missing
+ *  are the record still does NOT have what it should (danger); pending and
+ *  skipped are in flight or a deliberate no with a reason (warning, worth a
+ *  look, not an alarm); sent is the good outcome (positive); anything else
+ *  (superseded) is informational (neutral). */
+export declare function toneForOutcome(outcome: string): 'danger' | 'warning' | 'neutral' | 'positive';
+
 /** Install the listeners. Safe to call more than once. */
 export declare function trackActivity(): void;