@declarion/react 0.12.4 → 0.15.0

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

@@ -68,6 +68,13 @@ export declare class ApiError extends Error {
  */
 export declare const CURSOR_SEMANTICS_MISMATCH = "cursor_semantics_mismatch";
 export declare const CURSOR_LOCALE_CHANGED = "cursor_locale_changed";
+/**
+ * A cross-store (Postgres-hot / ClickHouse-cold) archive cursor that the server
+ * could not decode for this read - a malformed token, a tenant/entity mismatch,
+ * or a retired bespoke-archive cursor minted before the native-cursor release.
+ * Same recovery contract as the other two: drop `after`, refetch window 1.
+ */
+export declare const ARCHIVE_CURSOR_INVALID = "archive_cursor_invalid";
 /** True if the error is a recoverable cursor-stale signal that warrants
  *  refetching page 1 instead of surfacing to the user. */
 export declare function isCursorStaleError(err: unknown): boolean;
@@ -271,6 +278,13 @@ export interface V2Meta {
     limit: number;
     has_more: boolean;
     cursor?: string;
+    /** How `total` was produced: "exact" or "estimated". Absent when no count
+     *  was requested. A cross-store cursor total is always "estimated". */
+    count_mode?: string;
+    /** True when a count WAS requested but abandoned because the cold-tier count
+     *  would exceed the interactive scan bound (BC4b). The data window still
+     *  loaded; render NO total ("~N") - distinct from a real `total: 0`. */
+    count_unknown?: boolean;
 }
 /**
  * Refs map: keyed by entity code (or $-prefixed virtual entity code),
@@ -316,6 +330,16 @@ export interface V2ListParams {
     limit?: number;
     after?: string;
     include_deleted?: boolean;
+    /** Request the (estimated) total alongside the window (`?count=with`). The
+     *  cursor UI sends this on the FIRST window only; later windows omit it. */
+    count?: boolean;
+    /** Screen code, so the server applies that screen's `fixed_filters` (a
+     *  cursor list of a `fixed_filters` view, e.g. the audit auth-log, needs
+     *  the same server-side prefilter the offset list gets). */
+    screen?: string;
+    /** Return display-bounded (truncated) values for list cells, matching the
+     *  offset list's `preview: true`. */
+    preview?: boolean;
 }
 /** Per-field resolved display unit codes. */
 export type Units = Record<string, string>;

package/dist-lib/types/schema.d.ts

@@ -363,6 +363,16 @@ export interface Entity {
      * docs/plans/2026-05-18-declarative-row-count.md.
      */
     count?: "exact" | "estimated";
+    /**
+     * Computed (server-side, never author-set) pagination mode the generated
+     * admin list MUST use: "offset" (numbered pages) or "cursor" (keyset /
+     * infinite scroll). "cursor" iff the entity declares `persistence.archive`
+     * AND the deployment has ClickHouse wired at boot - a cross-store hot+cold
+     * read cannot offset-paginate. Absent means "offset" (every plain Postgres /
+     * ClickHouse-only / ClickHouse-disabled-archive entity). The SDK branches the
+     * list UI on this. See docs/plans/2026-06-20-cross-store-list-cursor-pagination.md.
+     */
+    list_pagination?: "offset" | "cursor";
 }
 export interface ExportConfig {
     enabled?: boolean;

package/dist-lib/{value-CrpaObP_.js → value-YOCedRQq.js}

@@ -11,7 +11,7 @@ var c = class extends Error {
 	}
 }, l = "cursor_semantics_mismatch", u = "cursor_locale_changed";
 function d(e) {
-	return e instanceof c && (e.code === "cursor_semantics_mismatch" || e.code === "cursor_locale_changed");
+	return e instanceof c && (e.code === "cursor_semantics_mismatch" || e.code === "cursor_locale_changed" || e.code === "archive_cursor_invalid");
 }
 //#endregion
 //#region src/api/auth-redirect.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.12.4",
+  "version": "0.15.0",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",