@nivaro/react 0.1.300 → 0.1.302

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)`
@@ -3259,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;
@@ -3887,6 +3941,70 @@ export declare function openChatRoom(room: string, label?: string): void;
 
 export declare function openDmWith(userId: string, displayName?: string): void;
 
+/**
+ * Operational tasks (#827): every repair / backfill / migration core or an
+ * extension registered, run from the console — dry run by default, one run
+ * at a time per task, output tail while it runs, last runs underneath.
+ */
+export declare interface OpsTaskRow {
+    key: string;
+    owner: string;
+    label: string;
+    description: string;
+    group: string | null;
+    leaves_behind: string | null;
+    follow_up: string | null;
+    cli: string | null;
+    has_dry_run: boolean;
+    available: boolean;
+    unavailable_reason: string | null;
+    running: {
+        id: number;
+        mode: 'dry' | 'execute';
+        started_at: string;
+        progress: {
+            done: number;
+            total: number | null;
+        } | null;
+    } | null;
+    runs: Array<{
+        id: number;
+        label: string | null;
+        status: string;
+        started_at: string;
+        finished_at: string | null;
+        duration_ms: number | null;
+        outcome: string | null;
+        error: string | null;
+        by: string | null;
+    }>;
+}
+
+export declare interface OpsTaskRun {
+    id: number;
+    key: string;
+    mode: 'dry' | 'execute';
+    status: 'running' | 'completed' | 'error' | 'cancelled';
+    started_at: string;
+    finished_at: string | null;
+    progress: {
+        done: number;
+        total: number | null;
+    } | null;
+    outcome: {
+        summary: string;
+        counts?: Record<string, number>;
+        backup_tables?: string[];
+        follow_up?: string | null;
+    } | null;
+    error: string | null;
+    output: string[];
+}
+
+export declare function OpsTasksView({ onNotice }: {
+    onNotice?: (message: string) => void;
+}): JSX.Element;
+
 /**
  * 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