platform-types 1.10.770 → 1.10.772

package/dist/cjs/socket.js

@@ -521,6 +521,16 @@ exports.SOCKET_ACTIONS = [
      * customer broadcast. Sent once per committed state move of the attempt.
      */
     'orderPaymentAttempt',
+    /**
+     * A storefront order's delivery was created or moved. `data` is
+     * `OrderDeliveryFrameData` (`delivery.ts`) — the order id and the minimised
+     * `OrderDeliveryView`, exactly what the shopper's own order read answers.
+     * Never the courier, a GPS fix, a proof asset, a note or a failure reason.
+     *
+     * ⚠️ To the order's OWN customer only (`wsPostCustomer`), never a store-wide
+     * customer broadcast; the operator frame for the same write is `deliveries`.
+     */
+    'orderDelivery',
     /**
      * A storefront payment attempt an operator acts on changed: it entered
      * `resolution`, took a further NEW approval while in it, or an operator

package/dist/cjs/store.js

@@ -135,6 +135,9 @@ exports.STORE_MODULE_ERROR_CODES = [
  *   `config.defaultProductCurrency` to a non-oficial USD variant.
  * - `PRICE_LIST_NOT_FOUND` — an `ecommerce` save names a
  *   `newCustomerPriceList` that does not exist (`store/_ecommercePatch.ts`).
+ *   `POST /store` answers it too, for a method row's `availability.priceLists`
+ *   entry naming no list of the store, with `data: { field, value }` where
+ *   `field` is `<catalog>[<row>].availability.priceLists[<entry>]`.
  *
  * Maintenance mode (`{ mode: 'maintenance', level }`, `store/_patchMaintenance.ts`):
  * - `FORBIDDEN` (403) — the caller is neither an ADMIN nor a MANAGER.

package/dist/cjs/storefrontWebLiteralKeys.js

@@ -461,6 +461,8 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'COMMON_CANCEL',
     'COMMON_CLOSE',
     'COMMON_CONFIRM',
+    'COMMON_DATE_RANGE_INVERTED',
+    'COMMON_DATE_RANGE_MALFORMED',
     'COMMON_DISMISS_NOTICE',
     'COMMON_DOWNLOAD',
     'COMMON_EXPORT_CSV',
@@ -667,7 +669,10 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'HOME_HERO_CTA',
     'HOME_HERO_TITLE',
     'HOME_METRICS_BALANCE',
-    'HOME_METRICS_BALANCE_LABEL',
+    'HOME_METRICS_BALANCE_CREDIT',
+    'HOME_METRICS_BALANCE_OWED',
+    'HOME_METRICS_BALANCE_SETTLED',
+    'HOME_METRICS_BALANCE_UNAVAILABLE',
     'HOME_METRICS_BASKET',
     'HOME_METRICS_BASKET_LABEL',
     'HOME_METRICS_CURRENCY',
@@ -719,6 +724,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'INVOICES_COLUMN_TOTAL',
     'INVOICES_COLUMN_TYPE',
     'INVOICES_DATE_FROM',
+    'INVOICES_DATE_UNTIL_LABEL',
     'INVOICES_DOWNLOAD_ERROR',
     'INVOICES_DOWNLOAD_PDF_ARIA',
     'INVOICES_DOWNLOAD_PDF_TOOLTIP',
@@ -867,11 +873,13 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'ORDERS_COLUMN_STATUS',
     'ORDERS_COLUMN_TOTAL',
     'ORDERS_DATE_FROM_LABEL',
+    'ORDERS_DATE_UNTIL_LABEL',
     'ORDERS_EMPTY',
     'ORDERS_EMPTY_ACTION',
     'ORDERS_ERR_LOAD',
     'ORDERS_FILTERED_CLEAR',
     'ORDERS_FILTERED_EMPTY',
+    'ORDERS_PENDING_ALWAYS_LISTED',
     'ORDERS_REPEAT_ARIA',
     'ORDERS_SEARCH_LABEL',
     'ORDERS_STATUS_CANCELLED_TOOLTIP',
@@ -1011,8 +1019,14 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PAYMENTS_COLUMN_MOVEMENT',
     'PAYMENTS_COLUMN_PAYMENT',
     'PAYMENTS_DATE_FROM_LABEL',
+    'PAYMENTS_DATE_UNTIL_LABEL',
     'PAYMENTS_EXPORT_FILENAME',
     'PAYMENTS_LEDGER_UNAVAILABLE',
+    'PAYMENTS_PDF_DOWNLOAD',
+    'PAYMENTS_PDF_ERROR',
+    'PAYMENTS_PDF_FILENAME',
+    'PAYMENTS_PDF_TOO_LONG',
+    'PAYMENTS_PDF_UNAVAILABLE',
     'PAYMENTS_STATEMENT_ERROR',
     'PAYMENTS_STATEMENT_PARTIAL',
     'PAYMENTS_SUBTITLE',

package/dist/delivery.d.ts

@@ -50,6 +50,45 @@ declare global {
         createdAt: number;
         updatedAt?: number;
     }
+    /**
+     * Where the shopper's own order's delivery stands — the MINIMISED projection the
+     * storefront shows on its order read (`StorefrontOrderView.delivery`) and the
+     * `orderDelivery` frame. An ALLOW-LIST, built from the delivery records
+     * operators keep: never the courier (name, contact, vehicle), a GPS fix, a proof
+     * asset, a note, a failure reason or the event log.
+     *
+     * Two arms, told apart by `kind`:
+     * - `'tracked'` — a delivery exists: `status` is the NEWEST event's type (never
+     *   the cached header), `updatedAt` the ms epoch of the last change,
+     *   `estimatedArrivalAt` the operator's estimate when one was given. `'failed'`
+     *   carries no reason.
+     * - `'scheduled'` — no delivery yet: `nextDeliveryDate`, the next day
+     *   (`YYYY-MM-DD` in `America/Buenos_Aires`, today included) on which one of
+     *   the customer's enabled zones delivers, within the coming week. Only on an
+     *   open order that is not a pickup and has no shipment; absent when no zone
+     *   delivers. ⚠️ A delivery created before the order → delivery pointer existed
+     *   is not found, so such an order can show `'scheduled'` while it is on its
+     *   way — a transient residue of the launch that ends as those orders close.
+     */
+    type OrderDeliveryView = {
+        kind: 'tracked';
+        status: DeliveryStatus;
+        updatedAt: number;
+        estimatedArrivalAt?: number;
+    } | {
+        kind: 'scheduled';
+        nextDeliveryDate: string;
+    };
+    /**
+     * `data` of an `orderDelivery` socket frame, sent to the order's own customer
+     * only when a delivery is created or an event is appended to it.
+     */
+    interface OrderDeliveryFrameData {
+        orderId: string;
+        delivery: Extract<OrderDeliveryView, {
+            kind: 'tracked';
+        }>;
+    }
     /**
      * Proof captured at the door. Stored in S3 under a SERVER-DERIVED key and
      * read back through a short-lived presigned GET — the client never chooses

package/dist/paymentAttempt.d.ts

@@ -107,11 +107,13 @@ declare global {
     }
     /**
      * The shopper's own order read: the order plus its payment attempt, when it
-     * has one. `paymentAttempt` is attached on read and is never stored on the
-     * order.
+     * has one, and where its delivery stands (`OrderDeliveryView`, `delivery.ts`),
+     * when there is anything to show. Both are attached on read and never stored
+     * on the order.
      */
     type StorefrontOrderView = Order & {
         paymentAttempt?: OrderPaymentAttemptView;
+        delivery?: OrderDeliveryView;
     };
     /**
      * `data` of an `orderPaymentAttempt` socket frame, sent to the order's own

package/dist/socket.d.ts

@@ -26,7 +26,7 @@
  * A client must ignore actions it does not own rather than assume it
  * receives all of them.
  */
-export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "paymentAttemptChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems"];
+export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "orderDelivery", "paymentAttemptChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**

package/dist/socket.js

@@ -518,6 +518,16 @@ export const SOCKET_ACTIONS = [
      * customer broadcast. Sent once per committed state move of the attempt.
      */
     'orderPaymentAttempt',
+    /**
+     * A storefront order's delivery was created or moved. `data` is
+     * `OrderDeliveryFrameData` (`delivery.ts`) — the order id and the minimised
+     * `OrderDeliveryView`, exactly what the shopper's own order read answers.
+     * Never the courier, a GPS fix, a proof asset, a note or a failure reason.
+     *
+     * ⚠️ To the order's OWN customer only (`wsPostCustomer`), never a store-wide
+     * customer broadcast; the operator frame for the same write is `deliveries`.
+     */
+    'orderDelivery',
     /**
      * A storefront payment attempt an operator acts on changed: it entered
      * `resolution`, took a further NEW approval while in it, or an operator

package/dist/store.d.ts

@@ -1774,6 +1774,30 @@ declare global {
          * there too.
          */
         storefront?: StorefrontMethodKind;
+        /**
+         * Which storefront callers may use this row: the audience rule a published
+         * design item carries, matched the same way (`guest`, `customer`,
+         * `retail`, `wholesale`, or the caller's effective price list in
+         * `priceLists`). ABSENT means every storefront caller. Accepted on
+         * `deliveryMethods` and `paymentMethods` rows by `POST /store`; a
+         * `priceLists` entry naming no list of the store is
+         * `400 PRICE_LIST_NOT_FOUND`.
+         *
+         * ⚠️ OPERATOR-ONLY. Never on a public projection: web `GET /store` drops
+         * the rows a caller may not use and strips the rule from the rest, and the
+         * customer STORE frame omits both catalogs while any row carries one. Web
+         * `POST /orders` refuses a row the caller may not use with the same
+         * `PAYMENT_METHOD_NOT_FOUND` / `DELIVERY_METHOD_NOT_FOUND` an unknown id
+         * gets. Operator routes (POS, pre-orders, app order creation, tenders)
+         * ignore it.
+         *
+         * A stored rule the write could not have produced (an unknown audience, an
+         * undeclared key, a non-positive list) fails CLOSED for shoppers: hidden on
+         * `GET /store`, refused at checkout, and both catalogs left off the frame.
+         * Operator reads omit it, and `POST /store` keeps it when an existing row
+         * is sent back without `availability`; sending a valid rule replaces it.
+         */
+        availability?: StorefrontDesignVisibility;
     }
     interface FiscalCondition {
         CbteTipo: {
@@ -2370,6 +2394,9 @@ export type StoreModuleRefusalBody = {
  *   `config.defaultProductCurrency` to a non-oficial USD variant.
  * - `PRICE_LIST_NOT_FOUND` — an `ecommerce` save names a
  *   `newCustomerPriceList` that does not exist (`store/_ecommercePatch.ts`).
+ *   `POST /store` answers it too, for a method row's `availability.priceLists`
+ *   entry naming no list of the store, with `data: { field, value }` where
+ *   `field` is `<catalog>[<row>].availability.priceLists[<entry>]`.
  *
  * Maintenance mode (`{ mode: 'maintenance', level }`, `store/_patchMaintenance.ts`):
  * - `FORBIDDEN` (403) — the caller is neither an ADMIN nor a MANAGER.

package/dist/store.js

@@ -130,6 +130,9 @@ export const STORE_MODULE_ERROR_CODES = [
  *   `config.defaultProductCurrency` to a non-oficial USD variant.
  * - `PRICE_LIST_NOT_FOUND` — an `ecommerce` save names a
  *   `newCustomerPriceList` that does not exist (`store/_ecommercePatch.ts`).
+ *   `POST /store` answers it too, for a method row's `availability.priceLists`
+ *   entry naming no list of the store, with `data: { field, value }` where
+ *   `field` is `<catalog>[<row>].availability.priceLists[<entry>]`.
  *
  * Maintenance mode (`{ mode: 'maintenance', level }`, `store/_patchMaintenance.ts`):
  * - `FORBIDDEN` (403) — the caller is neither an ADMIN nor a MANAGER.

package/dist/storefrontWebLiteralKeys.js

@@ -458,6 +458,8 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'COMMON_CANCEL',
     'COMMON_CLOSE',
     'COMMON_CONFIRM',
+    'COMMON_DATE_RANGE_INVERTED',
+    'COMMON_DATE_RANGE_MALFORMED',
     'COMMON_DISMISS_NOTICE',
     'COMMON_DOWNLOAD',
     'COMMON_EXPORT_CSV',
@@ -664,7 +666,10 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'HOME_HERO_CTA',
     'HOME_HERO_TITLE',
     'HOME_METRICS_BALANCE',
-    'HOME_METRICS_BALANCE_LABEL',
+    'HOME_METRICS_BALANCE_CREDIT',
+    'HOME_METRICS_BALANCE_OWED',
+    'HOME_METRICS_BALANCE_SETTLED',
+    'HOME_METRICS_BALANCE_UNAVAILABLE',
     'HOME_METRICS_BASKET',
     'HOME_METRICS_BASKET_LABEL',
     'HOME_METRICS_CURRENCY',
@@ -716,6 +721,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'INVOICES_COLUMN_TOTAL',
     'INVOICES_COLUMN_TYPE',
     'INVOICES_DATE_FROM',
+    'INVOICES_DATE_UNTIL_LABEL',
     'INVOICES_DOWNLOAD_ERROR',
     'INVOICES_DOWNLOAD_PDF_ARIA',
     'INVOICES_DOWNLOAD_PDF_TOOLTIP',
@@ -864,11 +870,13 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'ORDERS_COLUMN_STATUS',
     'ORDERS_COLUMN_TOTAL',
     'ORDERS_DATE_FROM_LABEL',
+    'ORDERS_DATE_UNTIL_LABEL',
     'ORDERS_EMPTY',
     'ORDERS_EMPTY_ACTION',
     'ORDERS_ERR_LOAD',
     'ORDERS_FILTERED_CLEAR',
     'ORDERS_FILTERED_EMPTY',
+    'ORDERS_PENDING_ALWAYS_LISTED',
     'ORDERS_REPEAT_ARIA',
     'ORDERS_SEARCH_LABEL',
     'ORDERS_STATUS_CANCELLED_TOOLTIP',
@@ -1008,8 +1016,14 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PAYMENTS_COLUMN_MOVEMENT',
     'PAYMENTS_COLUMN_PAYMENT',
     'PAYMENTS_DATE_FROM_LABEL',
+    'PAYMENTS_DATE_UNTIL_LABEL',
     'PAYMENTS_EXPORT_FILENAME',
     'PAYMENTS_LEDGER_UNAVAILABLE',
+    'PAYMENTS_PDF_DOWNLOAD',
+    'PAYMENTS_PDF_ERROR',
+    'PAYMENTS_PDF_FILENAME',
+    'PAYMENTS_PDF_TOO_LONG',
+    'PAYMENTS_PDF_UNAVAILABLE',
     'PAYMENTS_STATEMENT_ERROR',
     'PAYMENTS_STATEMENT_PARTIAL',
     'PAYMENTS_SUBTITLE',

package/package.json

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