sinfactura-types 1.8.1 → 1.8.3

package/dist/api.d.ts

@@ -5,7 +5,38 @@ declare global {
         message: string | null;
         data: T;
         ConsumedCapacity?: Record<string, string | number>;
-        LastEvaluatedKey?: Record<string, string>;
+        /**
+         * Either a DynamoDB key object or an opaque, already-encoded cursor string,
+         * depending on the endpoint (api#1983):
+         *
+         * - **Key object** — a handler surfacing a raw page cursor from its own
+         *   `Query` (`GET /products`, `/customers`, `/invoices`, `/users`,
+         *   `/notifications`, `/logs`, the platform MP log endpoints). Key attributes
+         *   are `S` or `N`, so a value can be a NUMBER whenever the query rides a
+         *   GSI with a numeric sort key: `GET /invoices`' date branch (`PK-dated`)
+         *   yields `{ PK, SK, dated }` with a numeric `dated`, and `GET /products`'
+         *   list branch (`PK-updatedAt`) likewise. Previously typed
+         *   `Record<string, string>`, which those endpoints never actually matched.
+         * - **Opaque string** — a base64url cursor the caller round-trips back
+         *   unparsed as `?startKey=`. `GET /suppliers?mode=invoices` and
+         *   `mode=invoiceFiles` emit this: their cursor is derived from the last
+         *   RETURNED row, never from a raw `LastEvaluatedKey`, which can skip rows.
+         *
+         * Consumers must not assume this is enumerable — treat the string form as
+         * opaque and pass it straight back.
+         */
+        LastEvaluatedKey?: string | Record<string, string | number>;
+        /**
+         * Set by endpoints whose result was capped before the query was exhausted,
+         * i.e. rows are genuinely missing (api#1983). Emitted today by
+         * `GET /reports?mode=sales` and `mode=supplier-invoices`.
+         *
+         * Distinct from `LastEvaluatedKey`: an endpoint can be truncated with NO
+         * cursor to continue from, so `truncated: true` is not "fetch the next page",
+         * it is "this answer is incomplete". Fiscal exports never set it — they fail
+         * the request instead, because a short fiscal file must not be returned at all.
+         */
+        truncated?: boolean;
     }
 }
 export {};

package/dist/invoice.d.ts

@@ -363,6 +363,13 @@ declare global {
         effectiveFrom: string;
         acceptanceWindowDays: number;
         acceptanceWindowValidThrough?: string;
+        /**
+         * api#1754 — epoch-ms last-write trace, set by the api on every threshold
+         * write and echoed on GET /config + the POST response (api PLATFORM_API.md
+         * section 20). OPTIONAL by design: a row written before the field carries
+         * none, so a reader must not treat its absence as "never updated".
+         */
+        updatedAt?: number;
     }
 }
 export {};

package/dist/store.d.ts

@@ -109,6 +109,14 @@ declare global {
              * default — does NOT reinterpret existing Account rows.
              */
             defaultAccountCurrency?: string;
+            /**
+             * api#1768 / ADR-0004 section 5 — tenant opt-out from AI product
+             * enrichment. Absent is the (common) "tenant never touched the toggle"
+             * default and does NOT block; only an explicit `true` blocks. The api
+             * gate is fail-CLOSED on a read failure, but open on a missing field —
+             * do not conflate the two.
+             */
+            aiOptOut?: boolean;
             /**
              * api#1740 — per-category × per-channel notification/feedback defaults.
              * Store-level baseline the app layers per-device overrides on top of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinfactura-types",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "main": "dist/index.js",
   "type": "module",
   "types": "./dist/index.d.ts",