platform-types 1.10.843 → 1.10.845

package/dist/customer.d.ts

@@ -626,6 +626,22 @@ declare global {
         marketing?: CustomerMarketing;
         /** Transactional WhatsApp consent for this store — see `CustomerWhatsappNotices`. Server-written. */
         whatsappNotices?: CustomerWhatsappNotices;
+        /**
+         * DERIVED, never stored: `isWhatsappNoticesOptedIn(whatsappNotices)`. Served
+         * on the composed customer list and search rows (the ungated read the
+         * intake picker uses) and on the operator `customers` frame whenever that
+         * frame carries the consent — so a cashier without the `customers`
+         * capability can see the state without the full row.
+         */
+        whatsappOptedIn?: boolean;
+        /**
+         * DERIVED, never stored: the latest withdrawal's `ts`, present only while
+         * the customer is opted out (`whatsappNotices.optOut`). ⚠️ A re-grant
+         * removes the withdrawal, so the next frame OMITS this key; a merging
+         * cache must read it as meaningful only while `whatsappOptedIn` is
+         * `false`, never keep it beside `true`.
+         */
+        whatsappOptedOutAt?: number;
         /** Optional notification mail only; transactional mail cannot be disabled. */
         notificationPreferences?: CustomerNotificationPreferences;
         minBuy?: number;

package/dist/maintenance.d.ts

@@ -16,14 +16,14 @@ declare global {
         endsAt?: number;
     }
     /**
-     * A channel a maintenance broadcast can actually leave the platform on.
+     * A channel a maintenance broadcast can leave the platform on.
      *
-     * ⚠️ `'whatsapp'` is deliberately ABSENT: the platform has no WhatsApp send
-     * path, so declaring it would let a caller ask for a send this service cannot
-     * make and would have to refuse at runtime. Adding the member later is purely
-     * additive for every consumer.
+     * `'whatsapp'` is the platform's own WhatsApp number (a Meta-approved utility
+     * template). A stage with no sender configured for a channel refuses a
+     * broadcast naming it — `422 BROADCAST_CHANNEL_NOT_CONFIGURED`, before any
+     * claim or send — rather than counting messages nothing would deliver.
      */
-    type MaintenanceBroadcastChannel = 'email' | 'sms';
+    type MaintenanceBroadcastChannel = 'email' | 'sms' | 'whatsapp';
     /**
      * Per-user, per-channel opt-in for outbound platform broadcasts.
      *
@@ -36,9 +36,9 @@ declare global {
      *
      * Absent key means the channel's DEFAULT applies, never `false`:
      * `email` defaults ON for a user holding an admin-capable role and OFF for
-     * everyone else, and `sms` defaults OFF for everyone. So no row needs
-     * backfilling, and a store that has never opened the preference screen still
-     * reaches its admins by email and nobody by SMS.
+     * everyone else, and `sms` and `whatsapp` default OFF for everyone. So no row
+     * needs backfilling, and a store that has never opened the preference screen
+     * still reaches its admins by email and nobody on a handset.
      */
     type UserBroadcastChannels = Partial<Record<MaintenanceBroadcastChannel, boolean>>;
     /** `POST /platform/operations { mode: 'maintenance-broadcast' }`. */
@@ -76,8 +76,8 @@ declare global {
      *
      * ⚠️ It is still `queued`, NOT `delivered`, and the two diverge for reasons
      * that live past the queue: a bounced or complained address is dropped by
-     * `sendEmail`'s suppression check, and the SMS gateway can reject a send the
-     * consumer already accepted. Demo tenants are the one such filter pulled
+     * `sendEmail`'s suppression check, and the SMS or WhatsApp provider can
+     * reject a send the consumer already accepted. Demo tenants are the one such filter pulled
      * FORWARD of the queue — they are excluded from enumeration entirely — so
      * that a fleet-wide count is not inflated by tenants whose every message the
      * transports would silently discard.

package/dist/order.d.ts

@@ -2323,6 +2323,14 @@ declare global {
          * on a {@link Order.creditOverride} sent with it.
          */
         onAccount?: boolean;
+        /**
+         * The cashier recorded the customer's transactional WhatsApp consent at
+         * intake (a back-office grant, stamped on the order's customer after the
+         * create commits; best-effort, never changes the answer). `true` only —
+         * `false` is refused 400; a withdrawal stays on `POST /customers`. Create
+         * leg only (an update ignores it); a directive, never stored on the order.
+         */
+        whatsappOptIn?: true;
         /**
          * Tender legs to ring against this order, as RAW input — NOT the persisted
          * `Order.tenders`, which is why `Partial<Order>` is narrowed with `Omit`

package/dist/userActivity.d.ts

@@ -991,8 +991,8 @@ declare global {
         reason?: string;
     }
     /**
-     * A maintenance announcement that actually LEFT the platform — email and/or
-     * SMS, per {@link MaintenanceBroadcastChannel}.
+     * A maintenance announcement that actually LEFT the platform — email, SMS
+     * and/or WhatsApp, per {@link MaintenanceBroadcastChannel}.
      *
      * ⚠️ Sibling of `PlatformMaintenanceToggledEvent`, never a replacement for
      * it. The toggle changes what the product does; this records that people

package/package.json

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