platform-types 1.10.801 → 1.10.802

package/dist/literals.d.ts

@@ -10,6 +10,13 @@ declare global {
     interface ResolvedStorefrontLiterals {
         values: Record<string, string>;
         provenance: Record<string, 'default' | 'GLOBAL' | 'WEB' | `WEB#${string}`>;
+        /**
+         * The compiled storefront default of each key, before any layer is applied: what a
+         * revert restores, and the text whose `{tokens}` an override must keep. No stored
+         * layer changes it. A key the catalog generator excludes has no entry, so a missing
+         * entry means "default unknown"; the six blanked payment keys are `''`.
+         */
+        defaults: Record<string, string>;
     }
     /**
      * One scope's literals, unmerged.

package/dist/platform.d.ts

@@ -227,9 +227,72 @@ export interface PlatformLiteralsBody extends PlatformOperatorReason {
     literals: Record<string, string | null>;
     /**
      * Must equal the store id inside a per-tenant scope; absent or wrong there is
-     * `400 CONFIRMATION_MISMATCH`. Ignored on a global scope, which names no tenant.
+     * `400 CONFIRMATION_MISMATCH`. Ignored on a global scope, which names no tenant,
+     * and ignored on a dry run.
      */
     confirm?: string;
+    /**
+     * `true` judges each key on its own and writes nothing: no row, no activity
+     * row, no audit row. The answer is `PlatformLiteralsDryRunResult`. A bad
+     * scope, an empty map or a bad reason is still a request-level 400. The
+     * legacy `WEB#` write conflicts happen only at commit and are not predicted.
+     */
+    dryRun?: boolean;
+}
+/** Why a dry run says one key would be refused. */
+export type PlatformLiteralDryRunError = 'RESERVED_KEY' | 'INVALID_KEY' | 'VALUE_TOO_LONG' | 'LITERAL_KEY_NOT_ALLOWED';
+/**
+ * One key of a dry run: what the write would do (`set` a new value, `remove` a
+ * stored one, or leave it `unchanged`), or the code that would refuse it.
+ */
+export type PlatformLiteralDryRunKeyResult = {
+    key: string;
+    verdict: 'set' | 'remove' | 'unchanged';
+} | {
+    key: string;
+    error: PlatformLiteralDryRunError;
+};
+/** `POST /platform/literals { dryRun: true }` → `200 { message, data }`, one result per body key. */
+export interface PlatformLiteralsDryRunResult {
+    results: PlatformLiteralDryRunKeyResult[];
+}
+/**
+ * One change on `GET /platform/literals/{scope}/{key}/history`. `before` and
+ * `after` are the stored values on each side of the change, `''` for a key the
+ * scope does not hold. `actorStoreId` is the acting manager's own store, since
+ * `actorId` is numbered per store. `actorName` is absent when the actor's
+ * activity row can no longer be read; `reason` is absent when none was sent.
+ */
+export interface PlatformLiteralHistoryEntry {
+    at: string;
+    actorId: string;
+    actorStoreId?: string;
+    actorName?: string;
+    before: string;
+    after: string;
+    reason?: string;
+}
+/** `GET /platform/literals/{scope}/{key}/history`: newest first; send `cursor` back as `?cursor=`. */
+export interface PlatformLiteralHistoryResponse {
+    data: PlatformLiteralHistoryEntry[];
+    cursor?: string;
+}
+/** One store's own value for a key, on its `APP#{storeId}` or `WEB#{storeId}` row. */
+export interface PlatformLiteralOverride {
+    storeId: string;
+    /** Absent when the store row has no name, or can no longer be read. */
+    storeName?: string;
+    scope: `APP#${string}` | `WEB#${string}`;
+    value: string;
+}
+/**
+ * `GET /platform/literals/overrides?key=K`. `truncated` is `true` when the read
+ * stopped at its bound before reaching every tenant row, so the list may be
+ * incomplete.
+ */
+export interface PlatformLiteralOverridesResponse {
+    data: PlatformLiteralOverride[];
+    truncated?: true;
 }
 /** `POST /platform/operations { mode: 'mp-recover-payment' }`. */
 /** Tracked non-money refresh returned inside the standard response data envelope. */

package/dist/userActivity.d.ts

@@ -1027,6 +1027,7 @@ declare global {
         key: string;
         before: string;
         after: string;
+        reason?: string;
     }
     interface SupportTicketCreatedEvent extends UserActivityEventBase {
         event: 'Support Ticket Created';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.801",
+	"version": "1.10.802",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",