platform-types 1.10.673 → 1.10.674

package/dist/account.d.ts

@@ -188,14 +188,15 @@ declare global {
      * `POST /account` — a new customer-ledger movement. Mirrors the request side of
      * the insert schema in `stacks/lambdas/account/_post.ts`; the schema strips
      * unknown keys, so the root `elevationToken` is read off the raw body. A body
-     * carrying a non-empty `accountId` is a metadata-only edit instead, and
+     * carrying a non-empty `accountId` is {@link AccountMetadataEditRequest}, and
      * `mode: 'reproject-balance'` is {@link CustomerBalanceReprojectRequest} —
      * neither is this shape.
      *
      * From a PIN operator session, a `debit` that moves cash (`source: 'cash'`,
      * else an EFECTIVO `subject`) is the `'account.cash-debit'` elevated action:
      * mint it with no `subjectId` (see {@link TerminalElevationRequest.subjectId})
-     * and attach the token here.
+     * and attach the token here. The approval binds the raw body minus the token,
+     * which is why the keys marked accepted and IGNORED below are declared at all.
      *
      * Held to its schema by `AssertAccountPostRequestMatchesSchema`.
      */
@@ -219,6 +220,44 @@ declare global {
         source?: Account['source'];
         /** A `Store.paymentMethods` id, frozen on the row. */
         method?: number;
+        /** Accepted and IGNORED, whatever its type: the server mints its own write clock. */
+        createdAt?: number;
+        /** Accepted and IGNORED, whatever its type: the server derives it from its own `createdAt`. */
+        dated?: number;
+    }
+    /**
+     * `POST /account` with a non-empty `accountId` — a metadata-only edit of that
+     * movement. Mirrors `accountUpdateSchema` (`stacks/lambdas/account/_post.ts`):
+     * only `subject` and `details` are written. No money moves, so there is no
+     * FX conversion, balance delta, cash mirror or elevation. An `accountId`
+     * naming no movement — or a `BALANCE-` checkpoint — is refused
+     * `404 ACCOUNT_MOVEMENT_NOT_FOUND`, with nothing written.
+     *
+     * Not {@link AccountPostRequest}: the presence of `accountId` is what routes
+     * a body here, so the insert shape never carries one.
+     *
+     * Held to its schema by `AssertAccountMetadataEditRequestMatchesSchema`.
+     */
+    interface AccountMetadataEditRequest {
+        /** The movement's `SK`. Any non-empty string: two id formats coexist. */
+        accountId: string;
+        subject?: string;
+        details?: string;
+        /**
+         * Accepted and IGNORED, never written: the stored row's `customerId` is the
+         * composite `${customerId}#${createdAt}`, so a bare id would corrupt it.
+         */
+        customerId?: string;
+        /** Echoed by an edit form. Accepted and IGNORED, whatever its type, never written. */
+        fullName?: AccountPostRequest['fullName'];
+        /** Echoed by an edit form. Accepted and IGNORED, whatever its type, never written. */
+        type?: AccountPostRequest['type'];
+        /** Echoed by an edit form. Accepted and IGNORED, whatever its type: no money moves. */
+        amount?: AccountPostRequest['amount'];
+        /** Echoed by an edit form. Accepted and IGNORED, whatever its type: no money moves. */
+        currency?: AccountPostRequest['currency'];
+        /** Echoed by an edit form. Accepted and IGNORED, whatever its type: no money moves. */
+        currencyValueOverride?: AccountPostRequest['currencyValueOverride'];
     }
     /**
      * The STORED carried-forward checkpoint row, at `PK: ACCOUNT#{storeId}` /

package/dist/cash.d.ts

@@ -70,7 +70,9 @@ declare global {
      * From a PIN operator session, an insert with `outcome > 0`, or an edit that
      * changes `outcome` to another value above zero, is the `'cash.withdrawal'`
      * elevated action: mint it with no `subjectId` (see
-     * {@link TerminalElevationRequest.subjectId}) and attach the token here.
+     * {@link TerminalElevationRequest.subjectId}) and attach the token here. The
+     * approval binds the raw body minus the token, which is why `createdAt` is
+     * declared at all.
      *
      * Held to its schema by `AssertCashPostRequestMatchesSchema`.
      */
@@ -87,6 +89,11 @@ declare global {
         dated?: number;
         /** A platform catalog id (`ars`, `usd-oficial`, …) or an ISO code (`ARS`, `USD`, …). */
         currency?: string;
+        /**
+         * Accepted and IGNORED, whatever its type: an insert mints its own (the row's
+         * `SK`), and an edit keeps the stored one.
+         */
+        createdAt?: number;
     }
     type CashShiftStatus = 'OPEN' | 'CLOSED' | 'RECONCILED' | 'REJECTED';
     /**

package/package.json

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