platform-types 1.10.835 → 1.10.836

package/dist/cjs/store.js

@@ -112,7 +112,7 @@ exports.STORE_MODULE_ERROR_CODES = [
  * Role refusals, `403` — a plain USER writing a privileged section. Each is
  * judged before any other check on that section:
  * - `STORE_CONFIG_FORBIDDEN` — any privileged `config` leaf (`modules`,
- *   `stock`, `priceDecimals`, `changePrice`, `mandatory2fa`, …).
+ *   `stock`, `priceDecimals`, `changePrice`, `mandatory2fa`, `autoPrint`, …).
  * - `STORE_ECOMMERCE_FORBIDDEN` — any `ecommerce` block.
  * - `STORE_FISCAL_FIELD_FORBIDDEN` — a fiscal field of the store.
  * - `STORE_JURISDICTION_FORBIDDEN` — `jurisdiction`.

package/dist/print.d.ts

@@ -560,8 +560,26 @@ declare global {
          * sorted and joined by `+`; an agent `ACK_FAILED` can classify to `PRINTER_PAUSED` /
          * `NO_PRINTER_ASSIGNED` / `PRINTER_NOT_FOUND`. Unrecognised agent
          * text stays in `detail` only, so absence of a code does NOT mean success.
+         *
+         * An automatic job (`Store.config.autoPrint`) adds three BE-side codes on
+         * `error`: `PRINT_QUEUE_EXPIRED` — it was held for want of a connected
+         * agent and its `heldUntil` passed — `AUTO_PRINT_SOURCE_GONE` — the
+         * order or invoice it was printing no longer exists when it was replayed —
+         * and `AUTO_PRINT_NO_LONGER_ELIGIBLE` — at replay it no longer passed the
+         * checks it was minted under (the store's switch for its event is off, the
+         * order was cancelled or its ready / delivered mark cleared, the factura is
+         * a credit note), so it was never sent.
+         * A HELD job is `queued` with `NO_PRINTER_CONNECTED` and `heldUntil`.
          */
         errorCode?: string;
+        /**
+         * ms epoch until which an automatic job with no connected agent is HELD —
+         * present only while the summary is `queued` waiting for an agent. The
+         * job is replayed when an agent of the store registers its printers, and
+         * ends `error` / `PRINT_QUEUE_EXPIRED` once this passes. Every later
+         * transition removes it. A manual print is never held.
+         */
+        heldUntil?: number;
     }
     /**
      * `data` payload of the server → agent `printers_active` WSS frame,

package/dist/store.d.ts

@@ -87,6 +87,28 @@ declare global {
         /** MercadoLibre orders. */
         mercadolibre?: string;
     }
+    /**
+     * The automatic-print switches — see `Store.config.autoPrint`. Every switch is
+     * OFF unless it is `true`: an absent leaf, an absent key and `false` all mean
+     * "do not print this automatically".
+     */
+    interface StoreAutoPrintConfig {
+        /** A factura authorised by ARCA (CAE, CAEA stamp, or the pending drain settling it). Credit notes never. */
+        invoiceAuthorized?: boolean;
+        /** A new order, per sales channel. A `service` channel order has no switch. */
+        orderCreated?: {
+            /** `POST /orders` on the App, including a presupuesto conversion. */
+            counter?: boolean;
+            /** The public storefront checkout. */
+            storefront?: boolean;
+            /** An order imported from MercadoLibre. */
+            meli?: boolean;
+        };
+        /** An order marked ready (its `readyAt` moving from unset to set). */
+        orderReady?: boolean;
+        /** The shipping tag, when an order with a delivery address is marked delivered. */
+        deliveryTag?: boolean;
+    }
     /**
      * One store-wide module a store can switch off for every user — the
      * catalogue is the shared `domain/STORE_MODULES.md`. Enumerable at runtime as
@@ -1135,6 +1157,24 @@ declare global {
              * whatever this holds.
              */
             channelWarehouses?: StoreChannelWarehouses;
+            /**
+             * Automatic printing — which events print a document with no operator
+             * pressing «Imprimir». Written through `PATCH /store` `config` at the
+             * PRIVILEGED tier (ADMIN/SUPERVISOR/MANAGER; a plain USER is refused
+             * `STORE_CONFIG_FORBIDDEN`). No plan gate.
+             *
+             * ⚠️ The merge REPLACES the whole leaf, like every other `config` leaf: a
+             * body carrying `autoPrint: { orderReady: true }` switches every other
+             * event off. Send the full leaf.
+             *
+             * An automatic job fans out exactly as «Imprimir» does (the store's print
+             * rules decide). When no print agent is connected it is HELD as `queued`
+             * with `heldUntil` on its `PrintJobSummary`, replayed when an agent of the
+             * store registers, and ended `error` / `PRINT_QUEUE_EXPIRED` at the end
+             * of the store's Buenos Aires day or 12 h after the event, whichever is
+             * first. Absent means nothing prints automatically.
+             */
+            autoPrint?: StoreAutoPrintConfig;
             /**
              * Store-wide module switches — see `StoreModules`. Written through
              * `PATCH /store` `config` at the PRIVILEGED tier (ADMIN/SUPERVISOR/MANAGER;
@@ -2592,7 +2632,7 @@ export type StoreModuleRefusalBody = {
  * Role refusals, `403` — a plain USER writing a privileged section. Each is
  * judged before any other check on that section:
  * - `STORE_CONFIG_FORBIDDEN` — any privileged `config` leaf (`modules`,
- *   `stock`, `priceDecimals`, `changePrice`, `mandatory2fa`, …).
+ *   `stock`, `priceDecimals`, `changePrice`, `mandatory2fa`, `autoPrint`, …).
  * - `STORE_ECOMMERCE_FORBIDDEN` — any `ecommerce` block.
  * - `STORE_FISCAL_FIELD_FORBIDDEN` — a fiscal field of the store.
  * - `STORE_JURISDICTION_FORBIDDEN` — `jurisdiction`.

package/dist/store.js

@@ -107,7 +107,7 @@ export const STORE_MODULE_ERROR_CODES = [
  * Role refusals, `403` — a plain USER writing a privileged section. Each is
  * judged before any other check on that section:
  * - `STORE_CONFIG_FORBIDDEN` — any privileged `config` leaf (`modules`,
- *   `stock`, `priceDecimals`, `changePrice`, `mandatory2fa`, …).
+ *   `stock`, `priceDecimals`, `changePrice`, `mandatory2fa`, `autoPrint`, …).
  * - `STORE_ECOMMERCE_FORBIDDEN` — any `ecommerce` block.
  * - `STORE_FISCAL_FIELD_FORBIDDEN` — a fiscal field of the store.
  * - `STORE_JURISDICTION_FORBIDDEN` — `jurisdiction`.

package/package.json

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