@declarion/react 0.48.2 → 0.49.0

package/dist-lib/api/batch.d.ts

@@ -1,13 +1,16 @@
+import type { ApiErrorBody } from "../types/api";
 export interface BatchOp {
     action: string;
     params?: Record<string, unknown> | null;
 }
 export interface BatchOpResult {
     index: number;
+    /** The dispatched action, so an entry says WHICH op it describes. */
+    action?: string;
     ok: boolean;
     result?: unknown;
-    error?: string;
-    error_code?: string;
+    /** The failure, in the one shape every carrier sends. */
+    error?: ApiErrorBody;
 }
 export interface BatchResponse {
     results: BatchOpResult[];

package/dist-lib/api/data.d.ts

@@ -1,4 +1,4 @@
-import type { ListParams, ListResponse, DataResponse } from "../types/api";
+import type { ApiErrorBody, ListParams, ListResponse, DataResponse } from "../types/api";
 import type { PkValues } from "../types/schema";
 import type { ExportRequest } from "../components/pages/exportRequest";
 export declare function listEntities(entity: string, params?: ListParams, options?: {
@@ -41,12 +41,43 @@ export interface ActionExecuteResponse {
     errors?: ActionItemError[];
     /** Per-item skips (batch_mode: each responses where conditions filtered rows). */
     skipped?: ActionItemSkip[];
+    /**
+     * The action's declared synchronous chain, when it has one. ABSENT means the
+     * action declares no such step - never that a step passed. A failed step does
+     * not change the action's own status: it committed, and an event is free to
+     * fail without undoing a committed write. So "saved" and "saved, and the work
+     * behind it did not run" are the same status and different reports.
+     */
+    events?: EventsReport;
 }
+/** What the platform says the action's synchronous chain did. */
+export interface EventsReport {
+    failed_count?: number;
+    timed_out_count?: number;
+    job_ids?: string[];
+    /** In the handler's DECLARED step order, at every depth. */
+    failures?: EventFailure[];
+    /** What the response bounds dropped. Non-zero means there were more. */
+    failures_omitted?: number;
+}
+/** One declared step that did not do its work. */
+export interface EventFailure {
+    step: number;
+    handler: string;
+    /** The id a per-object step died on. */
+    object?: string;
+    /** How many objects after it were never reached. */
+    not_attempted?: number;
+    error?: ApiErrorBody;
+    /** This step's OWN chain, when it declared one. */
+    events?: EventsReport;
+}
+/** Whether anything in this chain, at any depth, did not happen. */
+export declare function eventsFailed(events: EventsReport | undefined): boolean;
 export interface ActionItemError {
     id: string;
-    error: string;
-    /** Sidecar DeclarionCode when available (e.g. VALIDATION_ERROR), else "". */
-    code?: string;
+    /** The failure, in the one shape every carrier sends. */
+    error: ApiErrorBody;
 }
 export interface ActionItemSkip {
     id: string;

package/dist-lib/api/entities.d.ts

@@ -40,9 +40,9 @@ export declare class EntityClient<T extends Record<string, unknown> = Record<str
     /** List records with cursor-based pagination, field selection, and expansion.
      *
      * Recovery on cursor-stale signals: when the server returns
-     * `cursor_semantics_mismatch` (sort grammar version bump),
-     * `cursor_locale_changed` (active locale switched mid-pagination), or
-     * `archive_cursor_invalid` (an undecodable cross-store archive cursor), the
+     * `cursor.semantics_mismatch` (sort grammar version bump),
+     * `cursor.locale_changed` (active locale switched mid-pagination), or
+     * `cursor.archive_invalid` (an undecodable cross-store archive cursor), the
      * `after` token is dropped and the request is retried once from the top.
      *
      * CRITICAL for accumulating callers (infinite scroll): the returned