platform-types 1.10.717 → 1.10.718

package/dist/cash.d.ts

@@ -468,7 +468,11 @@ declare global {
 }
 /**
  * Refusals from the cash-shift surface — `stacks/lambdas/shifts/*.ts`
- * (`_get`, `_post`, `_patchClose`, `_postMovement`, `_patchReconcile`).
+ * (`_get`, `_post`, `_patchClose`, `_postMovement`, `_patchReconcile`) — plus
+ * the shared drawer write's own `CASH_DRAWER_BUSY`, which `POST /cash`,
+ * `POST`/`DELETE /account` and a cash return answer. A tender or seña does
+ * not: a tender's drawer collision is `SHIFT_NOT_OPEN` or `422 CURRENCY_MISMATCH`,
+ * a seña's `SHIFT_NOT_OPEN` or `409 DEPOSIT_CURRENCY_MISMATCH`.
  *
  * - `INVALID_SHIFT_ID` · 400 · `SHIFT_NOT_FOUND` · 404
  * - `SHIFT_ALREADY_OPEN` · 409 — one open shift per cashier.
@@ -489,15 +493,24 @@ declare global {
  * - `SHIFT_EVENTS_TRUNCATED` · 503 — the event log could not be read in full, so
  *   the totals behind a close or a reconcile would be computed from a partial
  *   ledger.
+ * - `CASH_DRAWER_BUSY` · 409 — emitted by the shared drawer write
+ *   (`drawerWriteRefusal`, `stacks/services/shifts.ts`), not by a `/shifts`
+ *   route: `POST /account` and `POST /cash` answer it when their transaction is
+ *   cancelled by a pure conflict on any item it writes (most often the drawer
+ *   row), as do `DELETE /account` and `POST /orders { mode: 'return' }` on a
+ *   cash leg. Nothing was written; retry the same request.
  * - `SELF_APPROVAL_FORBIDDEN` · 403 — segregation of duties: the cashier who
  *   closed a shift cannot reconcile it.
  * - `INVALID_DENOMINATION` · 400 · `INVALID_CURSOR` · 400
+ * - `WAREHOUSE_NOT_FOUND` · 404 — `GET /shifts?warehouseId=` naming a depósito
+ *   the store does not have (`resolveReportWarehouseFilter`).
  * - `ROLE_FORBIDDEN` · 403 · `VALIDATION_FAILED` · 400
  *
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
- * as well.
+ * as well, and `TERMINAL_ELEVATION_ERROR_CODES` for a money-out movement's PIN
+ * elevation.
  */
-export declare const SHIFT_ERROR_CODES: readonly ["INVALID_SHIFT_ID", "SHIFT_NOT_FOUND", "SHIFT_ALREADY_OPEN", "SHIFT_NOT_OPEN", "SHIFT_NOT_CLOSED", "SHIFT_OWNER_MISMATCH", "CURRENCY_MISMATCH", "BUCKET_COUNTS_INVALID", "BUCKET_REVIEW_INVALID", "BUCKET_COUNT_MISSING", "SHIFT_CHANGED", "SHIFT_EVENTS_TRUNCATED", "SELF_APPROVAL_FORBIDDEN", "INVALID_DENOMINATION", "INVALID_CURSOR", "ROLE_FORBIDDEN", "VALIDATION_FAILED"];
+export declare const SHIFT_ERROR_CODES: readonly ["INVALID_SHIFT_ID", "SHIFT_NOT_FOUND", "SHIFT_ALREADY_OPEN", "SHIFT_NOT_OPEN", "SHIFT_NOT_CLOSED", "SHIFT_OWNER_MISMATCH", "CURRENCY_MISMATCH", "BUCKET_COUNTS_INVALID", "BUCKET_REVIEW_INVALID", "BUCKET_COUNT_MISSING", "SHIFT_CHANGED", "SHIFT_EVENTS_TRUNCATED", "CASH_DRAWER_BUSY", "SELF_APPROVAL_FORBIDDEN", "INVALID_DENOMINATION", "INVALID_CURSOR", "WAREHOUSE_NOT_FOUND", "ROLE_FORBIDDEN", "VALIDATION_FAILED"];
 export type ShiftErrorCode = (typeof SHIFT_ERROR_CODES)[number];
 /**
  * Where a {@link ShiftMethodTotal}'s `label` came from.

package/dist/cash.js

@@ -1,6 +1,10 @@
 /**
  * Refusals from the cash-shift surface — `stacks/lambdas/shifts/*.ts`
- * (`_get`, `_post`, `_patchClose`, `_postMovement`, `_patchReconcile`).
+ * (`_get`, `_post`, `_patchClose`, `_postMovement`, `_patchReconcile`) — plus
+ * the shared drawer write's own `CASH_DRAWER_BUSY`, which `POST /cash`,
+ * `POST`/`DELETE /account` and a cash return answer. A tender or seña does
+ * not: a tender's drawer collision is `SHIFT_NOT_OPEN` or `422 CURRENCY_MISMATCH`,
+ * a seña's `SHIFT_NOT_OPEN` or `409 DEPOSIT_CURRENCY_MISMATCH`.
  *
  * - `INVALID_SHIFT_ID` · 400 · `SHIFT_NOT_FOUND` · 404
  * - `SHIFT_ALREADY_OPEN` · 409 — one open shift per cashier.
@@ -21,13 +25,22 @@
  * - `SHIFT_EVENTS_TRUNCATED` · 503 — the event log could not be read in full, so
  *   the totals behind a close or a reconcile would be computed from a partial
  *   ledger.
+ * - `CASH_DRAWER_BUSY` · 409 — emitted by the shared drawer write
+ *   (`drawerWriteRefusal`, `stacks/services/shifts.ts`), not by a `/shifts`
+ *   route: `POST /account` and `POST /cash` answer it when their transaction is
+ *   cancelled by a pure conflict on any item it writes (most often the drawer
+ *   row), as do `DELETE /account` and `POST /orders { mode: 'return' }` on a
+ *   cash leg. Nothing was written; retry the same request.
  * - `SELF_APPROVAL_FORBIDDEN` · 403 — segregation of duties: the cashier who
  *   closed a shift cannot reconcile it.
  * - `INVALID_DENOMINATION` · 400 · `INVALID_CURSOR` · 400
+ * - `WAREHOUSE_NOT_FOUND` · 404 — `GET /shifts?warehouseId=` naming a depósito
+ *   the store does not have (`resolveReportWarehouseFilter`).
  * - `ROLE_FORBIDDEN` · 403 · `VALIDATION_FAILED` · 400
  *
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
- * as well.
+ * as well, and `TERMINAL_ELEVATION_ERROR_CODES` for a money-out movement's PIN
+ * elevation.
  */
 export const SHIFT_ERROR_CODES = [
     'INVALID_SHIFT_ID',
@@ -42,9 +55,11 @@ export const SHIFT_ERROR_CODES = [
     'BUCKET_COUNT_MISSING',
     'SHIFT_CHANGED',
     'SHIFT_EVENTS_TRUNCATED',
+    'CASH_DRAWER_BUSY',
     'SELF_APPROVAL_FORBIDDEN',
     'INVALID_DENOMINATION',
     'INVALID_CURSOR',
+    'WAREHOUSE_NOT_FOUND',
     'ROLE_FORBIDDEN',
     'VALIDATION_FAILED',
 ];

package/dist/cjs/cash.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.METHOD_LABEL_SOURCES = exports.SHIFT_ERROR_CODES = void 0;
 /**
  * Refusals from the cash-shift surface — `stacks/lambdas/shifts/*.ts`
- * (`_get`, `_post`, `_patchClose`, `_postMovement`, `_patchReconcile`).
+ * (`_get`, `_post`, `_patchClose`, `_postMovement`, `_patchReconcile`) — plus
+ * the shared drawer write's own `CASH_DRAWER_BUSY`, which `POST /cash`,
+ * `POST`/`DELETE /account` and a cash return answer. A tender or seña does
+ * not: a tender's drawer collision is `SHIFT_NOT_OPEN` or `422 CURRENCY_MISMATCH`,
+ * a seña's `SHIFT_NOT_OPEN` or `409 DEPOSIT_CURRENCY_MISMATCH`.
  *
  * - `INVALID_SHIFT_ID` · 400 · `SHIFT_NOT_FOUND` · 404
  * - `SHIFT_ALREADY_OPEN` · 409 — one open shift per cashier.
@@ -24,13 +28,22 @@ exports.METHOD_LABEL_SOURCES = exports.SHIFT_ERROR_CODES = void 0;
  * - `SHIFT_EVENTS_TRUNCATED` · 503 — the event log could not be read in full, so
  *   the totals behind a close or a reconcile would be computed from a partial
  *   ledger.
+ * - `CASH_DRAWER_BUSY` · 409 — emitted by the shared drawer write
+ *   (`drawerWriteRefusal`, `stacks/services/shifts.ts`), not by a `/shifts`
+ *   route: `POST /account` and `POST /cash` answer it when their transaction is
+ *   cancelled by a pure conflict on any item it writes (most often the drawer
+ *   row), as do `DELETE /account` and `POST /orders { mode: 'return' }` on a
+ *   cash leg. Nothing was written; retry the same request.
  * - `SELF_APPROVAL_FORBIDDEN` · 403 — segregation of duties: the cashier who
  *   closed a shift cannot reconcile it.
  * - `INVALID_DENOMINATION` · 400 · `INVALID_CURSOR` · 400
+ * - `WAREHOUSE_NOT_FOUND` · 404 — `GET /shifts?warehouseId=` naming a depósito
+ *   the store does not have (`resolveReportWarehouseFilter`).
  * - `ROLE_FORBIDDEN` · 403 · `VALIDATION_FAILED` · 400
  *
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
- * as well.
+ * as well, and `TERMINAL_ELEVATION_ERROR_CODES` for a money-out movement's PIN
+ * elevation.
  */
 exports.SHIFT_ERROR_CODES = [
     'INVALID_SHIFT_ID',
@@ -45,9 +58,11 @@ exports.SHIFT_ERROR_CODES = [
     'BUCKET_COUNT_MISSING',
     'SHIFT_CHANGED',
     'SHIFT_EVENTS_TRUNCATED',
+    'CASH_DRAWER_BUSY',
     'SELF_APPROVAL_FORBIDDEN',
     'INVALID_DENOMINATION',
     'INVALID_CURSOR',
+    'WAREHOUSE_NOT_FOUND',
     'ROLE_FORBIDDEN',
     'VALIDATION_FAILED',
 ];

package/dist/order.d.ts

@@ -1867,6 +1867,39 @@ declare global {
          */
         cancellation?: OrderCancellability;
     }
+    /**
+     * `POST /orders { mode: 'tender' }` — ring one or more tender legs against an
+     * EXISTING order (the append counterpart of the create leg's
+     * {@link CreateOrderRequest.tenders}). Any operator but PRINTER or ACCOUNTANT
+     * (`403 ROLE_FORBIDDEN`).
+     *
+     * `shiftId` attributes the legs to a drawer. An EXPLICIT value must be the
+     * caller's own OPEN shift — anything else is `409 SHIFT_NOT_AVAILABLE`, never
+     * a silent drop. OMITTED resolves the caller's own open drawer; with none, a
+     * cash leg lands on the store's default drawer. At commit the drawer is
+     * re-asserted: one that closed mid-request is `409 SHIFT_NOT_OPEN`, one that
+     * did not declare the order's currency `422 CURRENCY_MISMATCH`.
+     *
+     * The opt-in `Idempotency-Key` and the lost-reply recovery through
+     * `mode: 'collection-attempt'` follow the money-write rule documented on
+     * {@link ORDER_ERROR_CODES} (and {@link OrderCollectionAttemptLookupRequest});
+     * it is not restated here. Every refusal specific to this mode is in that
+     * tuple; a body the schema rejects is `400 VALIDATION_FAILED`, and the
+     * cross-cutting refusals (`ROLE_FORBIDDEN`, `IMPERSONATION_READONLY`, …) are
+     * in `GATING_ERROR_CODES`.
+     *
+     * Tied to its validator (`tenderModeSchema`, `stacks/lambdas/orders/_tender.ts`)
+     * by `AssertOrderTenderRequestMatchesSchema` — `mode` is the router's key.
+     */
+    interface OrderTenderRequest {
+        mode: 'tender';
+        /** `ORD` followed by 6–10 digits. */
+        orderId: string;
+        /** RAW legs — see {@link TenderLegInput}. */
+        tenders: TenderLegInput[];
+        /** 1–100 chars; the caller's own OPEN shift. Omit to use the caller's open drawer. */
+        shiftId?: string;
+    }
     /**
      * `POST /orders { mode: 'deposit' }` — record a SEÑA (a sales deposit) on an
      * existing, undelivered order, as one {@link OrderTender} leg carrying
@@ -1925,7 +1958,7 @@ declare global {
         change?: number;
         /** Required, never defaulted. `true` needs an authorized factura on the order first. */
         freezesPrice: boolean;
-        /** Same semantics as `mode: 'tender'`'s. */
+        /** Same semantics as {@link OrderTenderRequest.shiftId}. */
         shiftId?: string;
     }
     /**

package/package.json

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