platform-types 1.10.672 → 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/attributes.d.ts

@@ -1,7 +1,7 @@
 /**
  * The five value types an attribute definition can declare. Fixed once the
  * definition exists. A runtime value, so import it:
- * `import { ATTRIBUTE_TYPES } from 'sinfactura-types'`.
+ * `import { ATTRIBUTE_TYPES } from 'platform-types'`.
  */
 export declare const ATTRIBUTE_TYPES: readonly ["text", "number", "select", "multiselect", "boolean"];
 /**

package/dist/attributes.js

@@ -1,7 +1,7 @@
 /**
  * The five value types an attribute definition can declare. Fixed once the
  * definition exists. A runtime value, so import it:
- * `import { ATTRIBUTE_TYPES } from 'sinfactura-types'`.
+ * `import { ATTRIBUTE_TYPES } from 'platform-types'`.
  */
 export const ATTRIBUTE_TYPES = [
     'text',

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/dist/categories.d.ts

@@ -1,7 +1,7 @@
 /**
  * The deepest a category tree may go, counted in breadcrumb SEGMENTS: a root is
  * depth 1, so a four-level tree has depth 4 at its leaves. A runtime value, so
- * import it: `import { CATEGORY_MAX_DEPTH } from 'sinfactura-types'`.
+ * import it: `import { CATEGORY_MAX_DEPTH } from 'platform-types'`.
  */
 export declare const CATEGORY_MAX_DEPTH = 4;
 declare global {

package/dist/categories.js

@@ -1,6 +1,6 @@
 /**
  * The deepest a category tree may go, counted in breadcrumb SEGMENTS: a root is
  * depth 1, so a four-level tree has depth 4 at its leaves. A runtime value, so
- * import it: `import { CATEGORY_MAX_DEPTH } from 'sinfactura-types'`.
+ * import it: `import { CATEGORY_MAX_DEPTH } from 'platform-types'`.
  */
 export const CATEGORY_MAX_DEPTH = 4;

package/dist/cjs/attributes.js

@@ -4,7 +4,7 @@ exports.ATTRIBUTE_OPTIONS_MAX = exports.ATTRIBUTE_TEXT_VALUE_MAX = exports.MAX_P
 /**
  * The five value types an attribute definition can declare. Fixed once the
  * definition exists. A runtime value, so import it:
- * `import { ATTRIBUTE_TYPES } from 'sinfactura-types'`.
+ * `import { ATTRIBUTE_TYPES } from 'platform-types'`.
  */
 exports.ATTRIBUTE_TYPES = [
     'text',

package/dist/cjs/categories.js

@@ -4,6 +4,6 @@ exports.CATEGORY_MAX_DEPTH = void 0;
 /**
  * The deepest a category tree may go, counted in breadcrumb SEGMENTS: a root is
  * depth 1, so a four-level tree has depth 4 at its leaves. A runtime value, so
- * import it: `import { CATEGORY_MAX_DEPTH } from 'sinfactura-types'`.
+ * import it: `import { CATEGORY_MAX_DEPTH } from 'platform-types'`.
  */
 exports.CATEGORY_MAX_DEPTH = 4;

package/dist/cjs/order.js

@@ -9,7 +9,7 @@ exports.ORDER_ERROR_CODES = exports.orderFulfilmentProgress = exports.isTerminal
  * it:
  *
  * ```ts
- * import { ORDER_FULFILMENT_TRANSITIONS, ORDER_FULFILMENT_STATUSES } from 'sinfactura-types';
+ * import { ORDER_FULFILMENT_TRANSITIONS, ORDER_FULFILMENT_STATUSES } from 'platform-types';
  * ```
  *
  * Both tables are `Record<Status, …>` over the whole union, so adding a status

package/dist/cjs/print.js

@@ -12,7 +12,7 @@ exports.LABEL_TEMPLATE_IDS = void 0;
  * That means it is IMPORTED, not ambient:
  *
  * ```ts
- * import { LABEL_TEMPLATE_IDS, type LabelTemplateId } from 'sinfactura-types';
+ * import { LABEL_TEMPLATE_IDS, type LabelTemplateId } from 'platform-types';
  * ```
  *
  * Order is the operator-facing display order and is load-bearing for neither

package/dist/cjs/roles.js

@@ -10,7 +10,7 @@ exports.PRINT_AGENT_ROLE = exports.USER_ROLES = void 0;
  * so import them:
  *
  * ```ts
- * import { USER_ROLES, type UserRole } from 'sinfactura-types';
+ * import { USER_ROLES, type UserRole } from 'platform-types';
  * ```
  *
  * ⚠️ **`User.roles` is a delimited STRING, not one of these.** The wire shape

package/dist/cjs/socket.js

@@ -8,7 +8,7 @@
  * import them:
  *
  * ```ts
- * import { SOCKET_ACTIONS, type SocketAction } from 'sinfactura-types';
+ * import { SOCKET_ACTIONS, type SocketAction } from 'platform-types';
  * ```
  *
  * Producers/consumers: `api` (`stacks/wss/lambdas/socket/default.ts` +

package/dist/order.js

@@ -6,7 +6,7 @@
  * it:
  *
  * ```ts
- * import { ORDER_FULFILMENT_TRANSITIONS, ORDER_FULFILMENT_STATUSES } from 'sinfactura-types';
+ * import { ORDER_FULFILMENT_TRANSITIONS, ORDER_FULFILMENT_STATUSES } from 'platform-types';
  * ```
  *
  * Both tables are `Record<Status, …>` over the whole union, so adding a status

package/dist/print.d.ts

@@ -9,7 +9,7 @@
  * That means it is IMPORTED, not ambient:
  *
  * ```ts
- * import { LABEL_TEMPLATE_IDS, type LabelTemplateId } from 'sinfactura-types';
+ * import { LABEL_TEMPLATE_IDS, type LabelTemplateId } from 'platform-types';
  * ```
  *
  * Order is the operator-facing display order and is load-bearing for neither

package/dist/print.js

@@ -9,7 +9,7 @@
  * That means it is IMPORTED, not ambient:
  *
  * ```ts
- * import { LABEL_TEMPLATE_IDS, type LabelTemplateId } from 'sinfactura-types';
+ * import { LABEL_TEMPLATE_IDS, type LabelTemplateId } from 'platform-types';
  * ```
  *
  * Order is the operator-facing display order and is load-bearing for neither

package/dist/roles.d.ts

@@ -7,7 +7,7 @@
  * so import them:
  *
  * ```ts
- * import { USER_ROLES, type UserRole } from 'sinfactura-types';
+ * import { USER_ROLES, type UserRole } from 'platform-types';
  * ```
  *
  * ⚠️ **`User.roles` is a delimited STRING, not one of these.** The wire shape

package/dist/roles.js

@@ -7,7 +7,7 @@
  * so import them:
  *
  * ```ts
- * import { USER_ROLES, type UserRole } from 'sinfactura-types';
+ * import { USER_ROLES, type UserRole } from 'platform-types';
  * ```
  *
  * ⚠️ **`User.roles` is a delimited STRING, not one of these.** The wire shape

package/dist/sentry.d.ts

@@ -19,7 +19,7 @@
  * value-level RTK endpoint, so a named import is what the consumer wants.
  *
  * ```ts
- * import type { SentryIssue, SentryIssuesQuery } from 'sinfactura-types';
+ * import type { SentryIssue, SentryIssuesQuery } from 'platform-types';
  * ```
  */
 export interface SentryIssue {

package/dist/socket.d.ts

@@ -7,7 +7,7 @@
  * import them:
  *
  * ```ts
- * import { SOCKET_ACTIONS, type SocketAction } from 'sinfactura-types';
+ * import { SOCKET_ACTIONS, type SocketAction } from 'platform-types';
  * ```
  *
  * Producers/consumers: `api` (`stacks/wss/lambdas/socket/default.ts` +

package/dist/socket.js

@@ -7,7 +7,7 @@
  * import them:
  *
  * ```ts
- * import { SOCKET_ACTIONS, type SocketAction } from 'sinfactura-types';
+ * import { SOCKET_ACTIONS, type SocketAction } from 'platform-types';
  * ```
  *
  * Producers/consumers: `api` (`stacks/wss/lambdas/socket/default.ts` +

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "platform-types",
-	"version": "1.10.672",
-	"description": "Shared wire and entity contracts for the SINFACTURA platform.",
+	"version": "1.10.674",
+	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -17,7 +17,7 @@
 	],
 	"license": "MIT",
 	"author": "Moises Samuel Maison Maison",
-	"homepage": "https://sinfactura.com",
+	"homepage": "https://github.com/trastienda/api/tree/main/contracts",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/trastienda/api",