@nivaro/extension-kit 0.1.1

package/dist/registrations.d.ts

@@ -0,0 +1,470 @@
+import type { FastifyRequest } from 'fastify';
+import type { Knex } from 'knex';
+import type { ExtensionUser } from './user.js';
+export type BulkActionAccess = {
+    mode: 'everyone' | 'admin' | 'roles';
+    role_ids?: string[];
+};
+export interface BulkActionContext {
+    collection: string;
+    ids: (string | number)[];
+    payload?: Record<string, unknown>;
+    reason?: string | null;
+    userId?: string;
+}
+/** A bulk action shown in the collection browser / queue selection bar. */
+export interface BulkActionDef {
+    id: string;
+    label: string;
+    /** Optional icon name from lucide (informational — the admin renders it). */
+    icon?: string;
+    /** If provided, only shown for these collections. Omit for all. */
+    collections?: string[];
+    /** 'danger' renders red (destructive). */
+    variant?: 'default' | 'danger';
+    /** Defaults to everyone (with update permission on the collection). */
+    access?: BulkActionAccess;
+    /** The bar prompts for a reason and passes it as ctx.reason. */
+    require_reason?: boolean;
+    /** Confirm text shown before running. */
+    confirm?: string;
+    /** Called by the API route. Return a message shown in the admin toast. */
+    execute(ctx: BulkActionContext): Promise<{
+        message: string;
+    }>;
+}
+export interface ItemActionContext {
+    collection: string;
+    itemId: string | number;
+    payload?: Record<string, unknown>;
+    userId?: string;
+}
+/** A contextual button in the record form's toolbar. */
+export interface ItemActionDef {
+    id: string;
+    label: string;
+    icon?: string;
+    /** Only shown for these collections. Omit for all. */
+    collections?: string[];
+    /** Hint for the admin: 'default' | 'destructive' | 'outline' */
+    variant?: 'default' | 'destructive' | 'outline';
+    /** When present, clients show a confirmation dialog before executing. */
+    confirm?: {
+        title?: string;
+        body?: string;
+        confirm_label?: string;
+        input?: {
+            label: string;
+            placeholder?: string;
+            required?: boolean;
+        };
+    };
+    execute(ctx: ItemActionContext): Promise<{
+        message: string;
+        data?: unknown;
+    }>;
+    /** The action CREATES AN ADDENDUM: core enforces the addendum-create gates
+     *  (collection toggle, role allow-list, pipeline-state allow-list) — the
+     *  button hides when the caller could not create one, and execute 403s with
+     *  the gate's reason. Declared, not implemented. */
+    requires_addendum_create?: boolean;
+    /** Per-record applicability; the client hides inapplicable buttons. Errors
+     *  count as applicable — a broken check must not hide a working action. */
+    applicable?(ctx: {
+        collection: string;
+        itemId: string | number;
+    }): Promise<boolean>;
+}
+export interface DashboardWidgetDef {
+    type: string;
+    label: string;
+    icon?: string;
+    /** JSON schema for the widget's configuration options. */
+    configSchema?: Record<string, unknown>;
+    description?: string;
+}
+export interface CollectionViewDef {
+    id: string;
+    label: string;
+    icon?: string;
+    /** URL of the extension's UI bundle that renders this view. */
+    bundleUrl?: string;
+    /** Optional field mappings to configure the view (e.g. titleField, dateField). */
+    fieldMappings?: Array<{
+        key: string;
+        label: string;
+        required?: boolean;
+    }>;
+    /** Which collections this view supports. Omit for all. */
+    collections?: string[];
+}
+export interface FieldTypeDef {
+    type: string;
+    label: string;
+    /** Which built-in interface the admin field editor falls back to. */
+    interface?: 'text' | 'textarea' | 'number' | 'boolean' | 'date' | 'json';
+    /** JSON schema for validation. Applied server-side on create/update. */
+    validationSchema?: Record<string, unknown>;
+    /** Transform the raw value before storing. */
+    serialize?(value: unknown): unknown;
+    /** Transform the stored value before returning to clients. */
+    deserialize?(value: unknown): unknown;
+}
+export interface ValidatorDef {
+    /** Operator name used in validation_rules JSON, e.g. 'phone', 'iban', 'luhn'. */
+    operator: string;
+    label: string;
+    /** Returns null on pass, or an error message string on fail. */
+    validate(value: unknown, options?: unknown): string | null;
+}
+export interface StorageFileMeta {
+    filename: string;
+    mimetype: string;
+    size: number;
+}
+export interface StorageAdapter {
+    /** Store a file. `stream` is a readable stream of the file contents. */
+    put(key: string, stream: NodeJS.ReadableStream, meta: StorageFileMeta): Promise<void>;
+    /** Return a readable stream for the file. */
+    get(key: string): Promise<NodeJS.ReadableStream>;
+    /** Delete a file. Must not throw if the key does not exist. */
+    delete(key: string): Promise<void>;
+    /** Return a public or pre-signed URL, or null if serving via proxy. */
+    url(key: string): Promise<string | null>;
+}
+export interface ParsedRow {
+    [column: string]: string;
+}
+export interface ImportParserDef {
+    /** MIME type(s) this parser handles. */
+    mimeTypes: string[];
+    /** File extension(s), e.g. ['xlsx', 'xls']. */
+    extensions: string[];
+    label: string;
+    /** Parse raw file content (Buffer or string) into column-named rows. */
+    parse(content: Buffer | string): Promise<ParsedRow[]> | ParsedRow[];
+}
+export interface RelatedNoteEntry {
+    /** Stable id within the provider, e.g. the source row id. */
+    id: string | number;
+    /** Badge text, e.g. the integration's name. */
+    label: string;
+    text: string;
+    /** A user id when a person wrote it; null for machine events. */
+    user?: string | null;
+    created_at: string | Date;
+    /** Secondary context line ("Order 12345"). */
+    context?: string | null;
+    /** Optional record the entry belongs to (renders a jump link). */
+    link?: {
+        collection: string;
+        item_id: string;
+    };
+    /** The provider can re-apply this event — the thread shows a Replay action. */
+    replayable?: boolean;
+    /** Machine status of the event, for the feed's filter. */
+    status?: 'ok' | 'error' | 'info' | null;
+}
+export interface RelatedNoteFeedEntry extends RelatedNoteEntry {
+    collection: string;
+    item_id: string;
+    /** Friendly record label when the provider knows one. */
+    item_label?: string | null;
+}
+/** Read-only entries for a record's Notes thread and the Events feed. */
+export interface RelatedNoteProvider {
+    /** Unique provider id — conventionally `<extension>:<what>`. */
+    id: string;
+    /** The business collection whose threads this provider feeds. */
+    collection: string;
+    /** Human name for the feed's integration filter. */
+    label?: string;
+    load(item: string): Promise<RelatedNoteEntry[]>;
+    /** Newest entries ACROSS records (a feed page, not a thread). */
+    list?(opts: {
+        limit: number;
+        status?: 'ok' | 'error' | 'info' | null;
+        /** Older-than cursor (ISO) — a provider MAY honour it. */
+        before?: string | null;
+    }): Promise<RelatedNoteFeedEntry[]>;
+    /** One entry by id, however old. Null when it does not exist. */
+    get?(entryId: string): Promise<RelatedNoteFeedEntry | null>;
+    /** Re-fetch / re-apply one event from its stored form. */
+    replay?(entryId: string, opts: {
+        userId: string | null;
+    }): Promise<{
+        detail: string;
+    }>;
+}
+/** Comment strings an extension's machinery writes, so the Notes thread
+ *  drops them and row history renders them as provenance. */
+export interface MachineMarkerSet {
+    /** Whole-comment matches, case-insensitive ("legacy-import"). */
+    exact?: string[];
+    /** Prefix matches, case-insensitive ("forecast-import:"). */
+    prefixes?: string[];
+}
+export type ReadinessStatus = 'pass' | 'warn' | 'fail' | 'skip';
+export interface ReadinessResult {
+    status: ReadinessStatus;
+    /** One-sentence current state, shown under the check. */
+    detail?: string;
+    /** Concrete blockers to resolve, listed as bullet lines. */
+    blockers?: string[];
+}
+/** A scored check on the go-live readiness scorecard. */
+export interface ReadinessCheck {
+    id: string;
+    label: string;
+    description?: string;
+    /** Grouping header on the scorecard (e.g. 'Data', 'Integrations'). */
+    group?: string;
+    run: () => Promise<ReadinessResult>;
+    /** Optional automatic fix. Runs as a BACKGROUND job with server-held
+     *  progress, so the admin can navigate away and come back. */
+    remediation?: {
+        label: string;
+        run: () => Promise<{
+            detail: string;
+        }>;
+    };
+}
+export interface IntegrityFinding {
+    item_id: string;
+    message: string;
+}
+export interface IntegrityFixArgs {
+    id: string;
+    message: string | null;
+    user: ExtensionUser;
+    req?: FastifyRequest;
+}
+/** A Data Integrity check the conformance sweep, the record banner and the
+ *  Fix button run alongside the built-in rules. */
+export interface IntegrityCheck {
+    /** Rule key on the findings ('forecast-missing'); kebab-case, unique. */
+    id: string;
+    collection: string;
+    /** Human rule label for the Data Integrity facets. */
+    label: string;
+    /** The field the finding anchors to on the form (a grid alias or column). */
+    field: string;
+    run(ids: string[]): Promise<IntegrityFinding[]>;
+    /** Optional one-click fix; `fix_label` is the proposal's button text. */
+    fix_label?: string;
+    fix?(args: IntegrityFixArgs): Promise<{
+        fixed: boolean;
+        detail?: string;
+    }>;
+}
+export interface BriefLine {
+    label: string;
+    text: string;
+    tone?: 'ok' | 'warn' | 'danger' | 'neutral';
+}
+/** One short line on the transition confirm's approval brief. */
+export type BriefLineProvider = (args: {
+    collection: string;
+    item: string;
+}) => Promise<BriefLine | null>;
+export type LinkKind = 'record' | 'queue' | 'report' | 'alerts' | 'chat' | 'tasks' | 'approvals' | 'access_requests' | 'notifications' | 'my_work' | 'home' | 'profile' | 'issues' | 'imports' | 'dashboard' | 'integrations';
+/** The headless frontend's base URL + route map, so email links land there. */
+export interface LinkRegistration {
+    /** Portal origin, no trailing slash. */
+    base: string;
+    /** Route templates per kind: '/records/{collection}/{id}'. Missing kinds
+     *  fall back to the admin route. */
+    routes: Partial<Record<LinkKind, string>>;
+}
+export interface CallOptions {
+    method?: string;
+    path?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    timeoutMs?: number;
+    /** Pre-defined endpoint name or id. Sets method/path/body/query/headers
+     *  defaults; caller options override. */
+    endpoint?: string | number;
+    /** Logging context — omit to skip logging. */
+    _log?: {
+        triggeredBy?: string;
+        userId?: string;
+    };
+}
+export interface CallResult {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+    /** Answered by this instance's mock rules, no network call was made. */
+    mock?: boolean;
+}
+/** Core tables whose rows carry an integration event chain. */
+export type ChainTable = 'nivaro_activity' | 'nivaro_api_logs' | 'nivaro_erp_submissions' | 'nivaro_erp_submission_attempts' | 'nivaro_external_api_logs' | 'nivaro_workflow_history' | 'nivaro_flow_runs';
+export type EventDirection = 'in' | 'out' | 'poll';
+export interface EventEntry {
+    id: string;
+    source: string;
+    direction: EventDirection;
+    label: string;
+    text: string;
+    context?: string | null;
+    created_at: string;
+    status?: 'ok' | 'error' | 'info' | null;
+    user?: string | null;
+    collection: string | null;
+    item_id: string | null;
+    item_label?: string | null;
+    record_count?: number;
+    partner?: string | null;
+    caller?: string | null;
+    chain_id?: string | null;
+    replayable?: boolean;
+}
+export interface EventListOpts {
+    limit: number;
+    status?: 'ok' | 'error' | 'info' | null;
+    before?: string | null;
+    partner?: string | null;
+    caller?: string | null;
+    includePeople?: boolean;
+    /** Record search: restrict to these chains. */
+    chainIds?: string[] | null;
+    record?: {
+        collection: string;
+        item: string;
+    } | null;
+}
+/** An event source on the Integrations console's Events feed. */
+export interface EventSourceDef {
+    id: string;
+    label: string;
+    direction: EventDirection;
+    list(opts: EventListOpts): Promise<EventEntry[]>;
+    get?(id: string): Promise<EventEntry | null>;
+}
+/** A tool the AI chat bot may call. Handlers run with the ASKING user — the
+ *  extension owns its permission posture. */
+export interface BotToolDef {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+    handler: (asker: ExtensionUser, input: Record<string, unknown>) => Promise<unknown>;
+}
+export interface OpsTaskRunContext {
+    /** A line of output the console shows as the task runs. */
+    log(line: string): void;
+    /** Rows done so far, for a progress bar. */
+    progress(done: number, total?: number): void;
+    /** True once an admin asked the run to stop; check it between chunks. */
+    cancelled(): boolean;
+    /** Who started the run (null for a cron). */
+    userId: string | null;
+    /** True on a dry run — the task must write nothing. */
+    dryRun: boolean;
+}
+export interface OpsTaskOutcome {
+    /** One line the run list shows ('312 rows would move', '0 duplicates'). */
+    summary: string;
+    /** Counts the console renders as tiles. */
+    counts?: Record<string, number>;
+    /** Tables the run created and left behind (backups), by name. */
+    backup_tables?: string[];
+    /** What still needs a person after this run. */
+    follow_up?: string | null;
+}
+/**
+ * A repair, backfill or migration an extension owns, run from the admin
+ * console: dry run by default, one run at a time per task, every run a
+ * job-runs row with its output kept. Registered with `ctx.tasks.register`.
+ */
+export interface OpsTaskDef {
+    /** `<extension>:<name>` — unique, kebab-case name. */
+    key: string;
+    label: string;
+    /** What it fixes or produces, in a sentence or two. */
+    description: string;
+    /** Console grouping ('Data repairs', 'Backfills'). */
+    group?: string;
+    /** What a real run leaves behind (a backup table, rows to review). */
+    leaves_behind?: string | null;
+    /** What to do after a real run ('re-run the rollup backfill'). */
+    follow_up?: string | null;
+    /** A shell command that does the same thing, for a host where the task
+     *  cannot run (a built image without its script sources). */
+    cli?: string | null;
+    /** Whether the task can run on THIS host, and why not. Default: yes. */
+    available?(): {
+        ok: boolean;
+        reason?: string;
+    } | Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    /** The dry run: report what a real run would do, write nothing. Absent =
+     *  the console offers only the real run. */
+    dryRun?(ctx: OpsTaskRunContext): Promise<OpsTaskOutcome>;
+    /** The real run. */
+    execute(ctx: OpsTaskRunContext): Promise<OpsTaskOutcome>;
+}
+/**
+ * Rows of a configuration collection an extension owns the definition of,
+ * checked in beside its code. A seed is never applied at boot: it is
+ * registered as an operational task (`seed:<key>`) whose dry run is the
+ * drift report — every row where the database differs from the file, and
+ * who changed it — and whose real run applies the file.
+ */
+export interface ConfigSeedDef {
+    /** `<extension>:<name>`. */
+    key: string;
+    label?: string;
+    description?: string;
+    /** The collection the rows belong to (never a `nivaro_*` system table). */
+    collection: string;
+    /** Columns that identify a row across databases — never `id`. */
+    match_by: string[];
+    /** The rows, inline… */
+    rows?: Array<Record<string, unknown>>;
+    /** …or a JSON file holding an array of rows (absolute path). */
+    file?: string;
+    /**
+     * `fill-only`: create rows the database lacks and fill columns that are
+     * empty there; a value someone set stays. `authoritative`: the file wins —
+     * differing columns are written back to the seed's values.
+     */
+    mode: 'fill-only' | 'authoritative';
+    /** Columns the file carries that must never be written (ids, audit stamps). */
+    ignore?: string[];
+}
+export interface SchemaCheckResult {
+    ok: boolean;
+    /** What is missing or different, when not ok. */
+    detail?: string;
+}
+/**
+ * A versioned schema or registry change an extension owns — a table it
+ * keeps, a column it adds to a business table, a registry row — declared
+ * with `ctx.schema.step(id, {...})` inside `register()` and run at load,
+ * under the migration lock, in declaration order. A step that ran once is
+ * recorded in `nivaro_extension_schema_steps` with the schema diff it
+ * produced and never runs again on that database; `check` reports drift.
+ */
+export interface SchemaStepDef {
+    /** Unique within the extension; kebab-case. */
+    id: string;
+    /** What the step builds, in a sentence. */
+    description: string;
+    /**
+     * The change. It runs inside a transaction that holds the migration
+     * lock; `db` is that transaction. Guard it (hasTable / hasColumn) anyway —
+     * a database built by hand may already carry the object.
+     */
+    up(db: Knex): Promise<void>;
+    /**
+     * Does the database still carry what the step built? Run after the step
+     * (or on every readiness read) — cheap reads only. `false` or `{ok: false}`
+     * reports drift; absent = never checked.
+     */
+    check?(db: Knex): Promise<SchemaCheckResult | boolean>;
+}
+//# sourceMappingURL=registrations.d.ts.map

package/dist/registrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrations.d.ts","sourceRoot":"","sources":["../src/registrations.ts"],"names":[],"mappings":"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"}

package/dist/registrations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registrations.js.map

package/dist/registrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrations.js","sourceRoot":"","sources":["../src/registrations.ts"],"names":[],"mappings":""}

package/dist/requester-columns.d.ts

@@ -0,0 +1,26 @@
+import type { Knex } from 'knex';
+/**
+ * `requested_by` / `requested_via` on the ERP submission tables ("who started
+ * each push", migration 350). A missing column does not just drop the two
+ * fields: an INSERT or SELECT naming an unknown column fails WHOLESALE, so a
+ * writer that names one anyway loses the whole submission row it was trying
+ * to record. Every insert or select that might name them goes through here.
+ */
+export type RequesterTable = 'nivaro_erp_submissions' | 'nivaro_erp_submission_attempts';
+export declare const REQUESTER_COLUMNS: readonly ["requested_by", "requested_via"];
+/** `{requested_by, requested_via}` for an INSERT into `table` on this
+ *  database, or `{}` before migration 350 has reached it — spread this into
+ *  the insert payload, never write the two column names directly. */
+export declare function requesterInsertFields(db: Knex, table: RequesterTable | (string & {}), requestedBy: string | null | undefined, requestedVia: string | null | undefined, opts?: {
+    scope?: string;
+}): Promise<{
+    requested_by?: string | null;
+    requested_via?: string | null;
+}>;
+/** The extra column names a SELECT against `table` may safely name —
+ *  `['requested_by', 'requested_via']` once migration 350 has reached it,
+ *  else `[]`. */
+export declare function requesterSelectColumns(db: Knex, table: RequesterTable | (string & {}), opts?: {
+    scope?: string;
+}): Promise<string[]>;
+//# sourceMappingURL=requester-columns.d.ts.map

package/dist/requester-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requester-columns.d.ts","sourceRoot":"","sources":["../src/requester-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAGhC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,wBAAwB,GAAG,gCAAgC,CAAA;AAExF,eAAO,MAAM,iBAAiB,4CAA6C,CAAA;AAE3E;;qEAEqE;AACrE,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,IAAI,EACR,KAAK,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAG1E;AAED;;iBAEiB;AACjB,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,IAAI,EACR,KAAK,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EACrC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB"}

package/dist/requester-columns.js

@@ -0,0 +1,17 @@
+import { hasColumn } from './column-probe.js';
+export const REQUESTER_COLUMNS = ['requested_by', 'requested_via'];
+/** `{requested_by, requested_via}` for an INSERT into `table` on this
+ *  database, or `{}` before migration 350 has reached it — spread this into
+ *  the insert payload, never write the two column names directly. */
+export async function requesterInsertFields(db, table, requestedBy, requestedVia, opts = {}) {
+    if (!(await hasColumn(db, table, 'requested_by', opts)))
+        return {};
+    return { requested_by: requestedBy ?? null, requested_via: requestedVia ?? null };
+}
+/** The extra column names a SELECT against `table` may safely name —
+ *  `['requested_by', 'requested_via']` once migration 350 has reached it,
+ *  else `[]`. */
+export async function requesterSelectColumns(db, table, opts = {}) {
+    return (await hasColumn(db, table, 'requested_by', opts)) ? [...REQUESTER_COLUMNS] : [];
+}
+//# sourceMappingURL=requester-columns.js.map

package/dist/requester-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requester-columns.js","sourceRoot":"","sources":["../src/requester-columns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAW7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,cAAc,EAAE,eAAe,CAAU,CAAA;AAE3E;;qEAEqE;AACrE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,EAAQ,EACR,KAAqC,EACrC,WAAsC,EACtC,YAAuC,EACvC,OAA2B,EAAE;IAE7B,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAClE,OAAO,EAAE,YAAY,EAAE,WAAW,IAAI,IAAI,EAAE,aAAa,EAAE,YAAY,IAAI,IAAI,EAAE,CAAA;AACnF,CAAC;AAED;;iBAEiB;AACjB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAQ,EACR,KAAqC,EACrC,OAA2B,EAAE;IAE7B,OAAO,CAAC,MAAM,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACzF,CAAC"}

package/dist/signals.d.ts

@@ -0,0 +1,77 @@
+export interface SignalThreshold {
+    key: string;
+    label: string;
+    default: number;
+    unit: string;
+    min?: number;
+    max?: number;
+}
+export interface SignalAction {
+    kind: 'retry_submission' | 'resend' | 'open' | 'explain' | 'extension';
+    label: string;
+    /** Extension action id (kind 'extension'), submission id (retry), etc. */
+    id?: string;
+    payload?: Record<string, unknown>;
+}
+/** A typed "Details" reference on a signal row — see `SignalRow.drill`. */
+export interface SignalDrill {
+    kind: 'submission' | 'import_run';
+    id: string;
+}
+export interface SignalRow {
+    /** Stable identity of the problem instance — NEVER a message or timestamp. */
+    key: string;
+    group?: string;
+    group_label?: string;
+    title: string;
+    detail?: string;
+    since?: string;
+    /** Identity of THIS occurrence of the problem (a run id, a submission
+     *  attempt, an obligation id). `key` names the PROBLEM and stays the same
+     *  across every failure; a Dismiss hides the row until `occurrence` next
+     *  changes. Unset falls back to `since`, then a masked hash of the row. */
+    occurrence?: string;
+    api?: string;
+    record?: {
+        collection: string;
+        id: string;
+        label?: string;
+    };
+    actions: SignalAction[];
+    /** What the console can open in place under this row. */
+    drill?: SignalDrill;
+}
+export interface SignalEvalContext {
+    thresholds: Record<string, number>;
+    /** A Date `n` business days before now (core SLA schedule: days + holidays). */
+    businessDaysAgo(n: number): Promise<Date>;
+}
+/** One kind of problem on the Integrations console's Firefight list,
+ *  evaluated every five minutes. */
+export interface IntegrationSignal {
+    id: string;
+    label: string;
+    description: string;
+    tab: string;
+    severity: 'critical' | 'warn';
+    thresholds: SignalThreshold[];
+    evaluate(ctx: SignalEvalContext): Promise<{
+        count: number;
+        rows: SignalRow[];
+    }>;
+}
+/** An action a signal row may offer (kind 'extension', id = def.id). */
+export interface SignalActionHandler {
+    id: string;
+    label: string;
+    run(args: {
+        rows: SignalRow[];
+        userId: string | null;
+        authHeaders: Record<string, string>;
+    }): Promise<Array<{
+        key: string;
+        ok: boolean;
+        message: string;
+    }>>;
+}
+//# sourceMappingURL=signals.d.ts.map

package/dist/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../src/signals.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,kBAAkB,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAA;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,GAAG,YAAY,CAAA;IACjC,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;+EAG2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3D,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,yDAAyD;IACzD,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,gFAAgF;IAChF,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED;oCACoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAA;IAC7B,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC,CAAA;CAChF;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,IAAI,EAAE;QACR,IAAI,EAAE,SAAS,EAAE,CAAA;QACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACpC,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAClE"}

package/dist/signals.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signals.js.map

package/dist/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../src/signals.ts"],"names":[],"mappings":""}