@declarion/react 0.4.1 → 0.4.2

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

@@ -49,6 +49,28 @@ export declare class ApiError extends Error {
     raw?: unknown;
     constructor(status: number, message: string, code: string, index?: number, raw?: unknown);
 }
+/**
+ * Stable error codes for cursor-based list pagination. The server returns
+ * these on ValidationError{Field:"after"} when an `after` token cannot be
+ * resumed under current request conditions:
+ *
+ * - CURSOR_SEMANTICS_MISMATCH: the cursor was minted under different sort
+ *   semantics (multi-column ordering, NULL placement). Server bumped its
+ *   cursor format version since the cursor was issued.
+ * - CURSOR_LOCALE_CHANGED: the cursor was minted under one active locale
+ *   and the request now carries a different one. Issued so multilang sort
+ *   cannot silently re-order mid-pagination.
+ *
+ * UX contract for both: clear the `after` token and refetch page 1 under
+ * the current conditions. EntityClient.list does this transparently;
+ * direct apiFetch callers can recognise these codes to drive their own
+ * retry logic.
+ */
+export declare const CURSOR_SEMANTICS_MISMATCH = "cursor_semantics_mismatch";
+export declare const CURSOR_LOCALE_CHANGED = "cursor_locale_changed";
+/** 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;
 export type TenantEnv = "production" | "staging" | "dev" | string;
 export interface Tenant {
     id: string;