platform-types 1.10.846 → 1.10.848

package/dist/cjs/messaging.js

@@ -8,7 +8,7 @@
  * modification, or distribution is strictly prohibited.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MESSAGE_DELIVERY_STAMPS = exports.MESSAGE_LEDGER_KINDS = exports.MESSAGE_CREDITS_PER_CHANNEL = exports.MESSAGE_ALLOWANCE_UNLIMITED = exports.SMS_FALLBACK_CREDITS = exports.WHATSAPP_MESSAGE_CREDITS = exports.MESSAGE_LEDGER_OPERATOR_ONLY_FIELDS = void 0;
+exports.STORE_MESSAGE_SKIP_REASONS = exports.STORE_MESSAGE_STATUSES = exports.MESSAGE_DELIVERY_STAMPS = exports.MESSAGE_LEDGER_KINDS = exports.MESSAGE_CREDITS_PER_CHANNEL = exports.MESSAGE_ALLOWANCE_UNLIMITED = exports.SMS_FALLBACK_CREDITS = exports.WHATSAPP_MESSAGE_CREDITS = exports.MESSAGE_LEDGER_OPERATOR_ONLY_FIELDS = void 0;
 /**
  * Fields a store's own ledger read drops from an `adjustment` entry: it is a
  * platform operator act, and its `actor`, `reason` and `refId` (the
@@ -47,3 +47,21 @@ exports.MESSAGE_DELIVERY_STAMPS = [
     'read',
     'failed',
 ];
+exports.STORE_MESSAGE_STATUSES = [
+    'queued',
+    'sending',
+    'sent',
+    'delivered',
+    'read',
+    'failed',
+    'undelivered',
+    'skipped',
+];
+exports.STORE_MESSAGE_SKIP_REASONS = [
+    'switched-off',
+    'no-consent',
+    'no-phone',
+    'no-credits',
+    'not-configured',
+    'messaging-disabled',
+];

package/dist/cjs/socket.js

@@ -316,15 +316,13 @@ exports.SOCKET_ACTIONS = [
     'loyalty',
     'orders',
     /**
-     * BE → all store users, plus the payload's own customer, on every
-     * presupuesto write: create, revise (a new version), a status transition
-     * (send/approve/reject/expire), and conversion to an order. Carries the
-     * full `Presupuesto` row, mirroring how `'orders'` carries the order —
-     * INCLUDING `items[].cost`, since `dynamoUpdate`'s default
-     * `'operator-and-customer'` audience is the same one `'orders'` uses and
-     * `scrubForCustomer`/`stripBasketCost` already strip `items[].cost`
-     * structurally (by shape, not by `action` name) before the customer's copy
-     * goes out.
+     * BE → the store's OPERATOR sockets only, on every presupuesto write:
+     * create, revise (both rows), a status transition (send/approve/reject/
+     * expire), and conversion to an order. Carries the full `Presupuesto` row,
+     * `items[].cost` included. ⚠️ Never the row's customer: drafts, the staff
+     * `approval.approvedBy` and the operator's `rejection.reason` must not reach
+     * a storefront socket — a customer-facing quote view owes its own
+     * allow-listed copy.
      *
      * ⚠️ Never a fiscal frame — a `Presupuesto` is never sent to ARCA and never
      * carries an `Invoice`. See the contract's own doc comment

package/dist/customer.d.ts

@@ -102,10 +102,11 @@ declare global {
      * `back-office` (staff, `POST /customers`), `storefront-post-purchase` (the
      * one-tap offer after an order is placed — the signed-in banner through web
      * `POST /user` with `whatsappOptInOrigin: 'post-purchase'`, or a guest's
-     * `POST /orders/status/whatsapp-opt-in`) and `storefront-profile` (the
-     * shopper's own profile toggle, web `POST /user`).
+     * `POST /orders/status/whatsapp-opt-in`), `storefront-profile` (the
+     * shopper's own profile toggle, web `POST /user`) and `whatsapp-reply` (a
+     * withdrawal only: the customer answered «BAJA» to a store notice).
      */
-    type WhatsappNoticeSource = 'back-office' | 'storefront-post-purchase' | 'storefront-profile';
+    type WhatsappNoticeSource = 'back-office' | 'storefront-post-purchase' | 'storefront-profile' | 'whatsapp-reply';
     /**
      * Provenance of one transactional WhatsApp grant or withdrawal.
      * Server-written only. Carries NO phone number and NO IP, unlike

package/dist/messaging.d.ts

@@ -144,6 +144,65 @@ declare global {
          */
         adjustmentId: string;
     }
+    /**
+     * Where one store-paid customer notice stands (`MSG#{storeId}` row):
+     * - `queued` — decided to send, credits reserved, handed to the sender.
+     * - `sending` — the sender claimed it; the provider call is in flight, or
+     *   its outcome is unknown (the provider may have accepted it — it is never
+     *   sent again).
+     * - `sent` — the provider accepted it.
+     * - `delivered` / `read` — reported by the provider.
+     * - `failed` — the provider refused it or reported it failed; its credits
+     *   were refunded.
+     * - `undelivered` — the provider reported it could not be delivered; its
+     *   credits were refunded.
+     * - `skipped` — never sent, see `StoreMessageSkipReason`.
+     */
+    type StoreMessageStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'read' | 'failed' | 'undelivered' | 'skipped';
+    /**
+     * Why a notice was not sent:
+     * - `switched-off` — the store's switch for this notice is off.
+     * - `no-consent` — the customer has not opted in to WhatsApp notices (or
+     *   the order has no live customer).
+     * - `no-phone` — no usable number (see `MessageNoticeListItem`).
+     * - `no-credits` — the store's credits could not cover it.
+     * - `not-configured` — the platform has no approved template for it yet.
+     * - `messaging-disabled` — the `tenantMessagingEnabled` platform global is
+     *   off. Decided, never stored: no notice row is written for it.
+     */
+    type StoreMessageSkipReason = 'switched-off' | 'no-consent' | 'no-phone' | 'no-credits' | 'not-configured' | 'messaging-disabled';
+    /**
+     * One customer notice of an order or a service order — `Order.messageNotices`
+     * (operator point read) and `ServiceOrder.messageNotices`. Operator-only: no
+     * storefront read or customer socket carries it. Oldest first.
+     */
+    interface MessageNoticeListItem {
+        /** Stable per notice occurrence; a frame replaces the item with the same id. */
+        noticeId: string;
+        notice: StoreMessageNotice;
+        /** What happened to the order: `ready`, `delivered`, `status:<to>`, `quote-sent`, `hold-set`, `hold-cleared`. */
+        event: string;
+        /** The channel it went out (or would have gone out) on. Absent on a skipped notice. */
+        channel?: MessageCreditChannel;
+        status: StoreMessageStatus;
+        /** Present exactly when `status` is `skipped`. */
+        skipReason?: StoreMessageSkipReason;
+        /** `true` once the WhatsApp leg failed and the SMS fallback took over. */
+        fellBackToSms?: boolean;
+        /** When the notice was decided. */
+        ts: number;
+        updatedAt: number;
+    }
+    /**
+     * The `orders` / `services` frame the notice pipeline sends (operator audience
+     * only) whenever a notice of that entity moves: the entity's id and its WHOLE
+     * current list, never a delta — merge it onto the cached row.
+     */
+    interface MessageNoticesFrameData {
+        orderId?: string;
+        serviceOrderId?: string;
+        messageNotices: MessageNoticeListItem[];
+    }
     interface MessageCreditAdjustmentResult {
         storeId: string;
         /** The `adjustment` ledger entry. */
@@ -178,3 +237,5 @@ export declare const MESSAGE_CREDITS_PER_CHANNEL: {
 };
 export declare const MESSAGE_LEDGER_KINDS: readonly ["debit", "refund", "allowance-grant", "purchase", "adjustment"];
 export declare const MESSAGE_DELIVERY_STAMPS: readonly ["delivered", "read", "failed"];
+export declare const STORE_MESSAGE_STATUSES: readonly ["queued", "sending", "sent", "delivered", "read", "failed", "undelivered", "skipped"];
+export declare const STORE_MESSAGE_SKIP_REASONS: readonly ["switched-off", "no-consent", "no-phone", "no-credits", "not-configured", "messaging-disabled"];

package/dist/messaging.js

@@ -44,3 +44,21 @@ export const MESSAGE_DELIVERY_STAMPS = [
     'read',
     'failed',
 ];
+export const STORE_MESSAGE_STATUSES = [
+    'queued',
+    'sending',
+    'sent',
+    'delivered',
+    'read',
+    'failed',
+    'undelivered',
+    'skipped',
+];
+export const STORE_MESSAGE_SKIP_REASONS = [
+    'switched-off',
+    'no-consent',
+    'no-phone',
+    'no-credits',
+    'not-configured',
+    'messaging-disabled',
+];

package/dist/order.d.ts

@@ -443,7 +443,10 @@ declare global {
         tracking?: OrderShipmentTracking;
         /** ≤ 500 chars, operator-only. */
         note?: string;
-        /** SMS the customer when THIS shipment completes the order. */
+        /**
+         * Accepted and IGNORED: a completing shipment owes the store's `orderShipped`
+         * notice, which the store's settings decide (`docs/NOTIFICATIONS.md` § Store notices).
+         */
         sendSms?: boolean;
     }
     /**
@@ -2025,6 +2028,14 @@ declare global {
          * on a list branch, the storefront read or any socket frame.
          */
         cancellation?: OrderCancellability;
+        /**
+         * The order's store-paid customer notices (WhatsApp / SMS), oldest first,
+         * read from the `MSG#` partition — never stored on the ORDER row, and a
+         * body echoing it is stripped. Present only while the
+         * `tenantMessagingEnabled` platform global is on. Kept live by the
+         * operator `orders` frame `MessageNoticesFrameData`.
+         */
+        messageNotices?: MessageNoticeListItem[];
     }
     /**
      * `POST /orders { mode: 'tender' }` — ring one or more tender legs against an
@@ -2419,7 +2430,10 @@ declare global {
          * stored. Required alongside {@link lines}, which is refused without it.
          */
         counterSale?: boolean;
-        /** Send the order's SMS notification. Directive only, never stored. */
+        /**
+         * Accepted and IGNORED, never stored: the store's `orderReady` notice is
+         * decided by the store's settings (`docs/NOTIFICATIONS.md` § Store notices).
+         */
         sendSms?: boolean;
         /** Persist `deliveryAddress` as the customer's default. Directive only, never stored. */
         saveAsDefault?: boolean;

package/dist/presupuesto.d.ts

@@ -53,7 +53,10 @@ declare global {
     /** Recorded once `status` moves to `approved`. */
     interface PresupuestoApproval {
         approvedAt: number;
-        /** userId of the operator who recorded it, or the customerId who self-served. */
+        /**
+         * userId of the operator who recorded it. A customer self-approval would
+         * record the customerId here, but no writer offers one yet.
+         */
         approvedBy: string;
     }
     /** Recorded once `status` moves to `rejected`. */

package/dist/serviceOrder.d.ts

@@ -918,6 +918,13 @@ declare global {
          * write response over a previously-read derivation.
          */
         slaStatus?: ServiceSlaStatus;
+        /**
+         * The ticket's store-paid customer notices (WhatsApp / SMS), oldest first —
+         * the point read only, read from the `MSG#` partition and never persisted.
+         * Present only while the `tenantMessagingEnabled` platform global is on.
+         * Kept live by the operator `services` frame `MessageNoticesFrameData`.
+         */
+        messageNotices?: MessageNoticeListItem[];
         technicianId?: string;
         /** Unix ms the order was assigned. */
         assignedAt?: number;

package/dist/socket.js

@@ -313,15 +313,13 @@ export const SOCKET_ACTIONS = [
     'loyalty',
     'orders',
     /**
-     * BE → all store users, plus the payload's own customer, on every
-     * presupuesto write: create, revise (a new version), a status transition
-     * (send/approve/reject/expire), and conversion to an order. Carries the
-     * full `Presupuesto` row, mirroring how `'orders'` carries the order —
-     * INCLUDING `items[].cost`, since `dynamoUpdate`'s default
-     * `'operator-and-customer'` audience is the same one `'orders'` uses and
-     * `scrubForCustomer`/`stripBasketCost` already strip `items[].cost`
-     * structurally (by shape, not by `action` name) before the customer's copy
-     * goes out.
+     * BE → the store's OPERATOR sockets only, on every presupuesto write:
+     * create, revise (both rows), a status transition (send/approve/reject/
+     * expire), and conversion to an order. Carries the full `Presupuesto` row,
+     * `items[].cost` included. ⚠️ Never the row's customer: drafts, the staff
+     * `approval.approvedBy` and the operator's `rejection.reason` must not reach
+     * a storefront socket — a customer-facing quote view owes its own
+     * allow-listed copy.
      *
      * ⚠️ Never a fiscal frame — a `Presupuesto` is never sent to ARCA and never
      * carries an `Invoice`. See the contract's own doc comment

package/package.json

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