platform-types 1.10.754 → 1.10.756

package/dist/cjs/customer.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CUSTOMER_ACQUISITION_CHANNELS = exports.CUSTOMER_LIFECYCLE_STAGES = exports.CUSTOMER_KINDS = void 0;
+exports.CUSTOMER_DISCOUNT_MAX = exports.CUSTOMER_ACQUISITION_CHANNELS = exports.CUSTOMER_LIFECYCLE_STAGES = exports.CUSTOMER_KINDS = void 0;
 exports.CUSTOMER_KINDS = ['person', 'company'];
 exports.CUSTOMER_LIFECYCLE_STAGES = ['lead', 'active', 'inactive'];
 exports.CUSTOMER_ACQUISITION_CHANNELS = ['storefront', 'pos', 'marketplace', 'import', 'manual'];
+/**
+ * The highest standing `Customer.discount` (percent) a write may SET. A higher
+ * value is refused `400 CUSTOMER_DISCOUNT_OVER_MAX` by `POST /customers` and the
+ * customer import. A stored legacy value above it is kept: a write that leaves
+ * `discount` unchanged (or omits it) still saves.
+ */
+exports.CUSTOMER_DISCOUNT_MAX = 50;

package/dist/cjs/notification.js

@@ -5,7 +5,8 @@ exports.NotificationTypeEnum = void 0;
 // Indexed producers resolve candidates through `getNotificationSubscribers`:
 // legacy opt-ins and explicit channel maps remain source data on USER rows.
 // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
-// ML_CONNECTION_BROKEN / MENTION do not select a producer subscriber audience;
+// ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL do not select a
+// producer subscriber audience;
 // the consumer still reads the live USER row for each delivery channel.
 // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
 // Exported as a real enum consumed by api and app; adding an indexed type
@@ -157,4 +158,20 @@ var NotificationTypeEnum;
      * click-through targets.
      */
     NotificationTypeEnum["EXPIRY_ALERT"] = "EXPIRY_ALERT";
+    /**
+     * A shopper registered on the storefront while the store's
+     * `ecommerce.config.registrationMode` is `'approval'`, and the account waits
+     * for an operator to approve or reject it. Names the registrant by name only.
+     *
+     * ⚠️ Additive, on the same grounds as `ABANDONED_CART`. The producer fans out
+     * to every non-disabled ADMIN-tier user with no legacy opt-in scan, as for
+     * `ML_SELLER_SWITCHED` (a new key is seeded nowhere). The consumer enforces
+     * explicit type/channel preferences, default-on when absent. No backfill or
+     * consumer migration is owed.
+     *
+     * ⚠️ Carries `pendingCustomerRef` and NEVER a top-level `customerId` (an
+     * audience — the operator bell would reach the pending registrant's own
+     * storefront socket), and never the registrant's email address.
+     */
+    NotificationTypeEnum["CUSTOMER_PENDING_APPROVAL"] = "CUSTOMER_PENDING_APPROVAL";
 })(NotificationTypeEnum || (exports.NotificationTypeEnum = NotificationTypeEnum = {}));

package/dist/customer.d.ts

@@ -1,6 +1,13 @@
 export declare const CUSTOMER_KINDS: readonly ["person", "company"];
 export declare const CUSTOMER_LIFECYCLE_STAGES: readonly ["lead", "active", "inactive"];
 export declare const CUSTOMER_ACQUISITION_CHANNELS: readonly ["storefront", "pos", "marketplace", "import", "manual"];
+/**
+ * The highest standing `Customer.discount` (percent) a write may SET. A higher
+ * value is refused `400 CUSTOMER_DISCOUNT_OVER_MAX` by `POST /customers` and the
+ * customer import. A stored legacy value above it is kept: a write that leaves
+ * `discount` unchanged (or omits it) still saves.
+ */
+export declare const CUSTOMER_DISCOUNT_MAX = 50;
 declare global {
     /** Exact identity matches within the token's store; no stored identity fields are returned. */
     interface CustomerDuplicateCandidate {
@@ -285,6 +292,11 @@ declare global {
          * that reason whatever this says.
          */
         accessState?: 'pending' | 'rejected';
+        /**
+         * Standing discount percent, pre-filled on every pre-order for this customer.
+         * Writes cap it at `CUSTOMER_DISCOUNT_MAX` (50); rows written before the cap
+         * may hold up to 100 and are never rewritten.
+         */
         discount: number;
         /** Absent after erasure or the final merge flip; registration still requires an address. */
         email?: string;

package/dist/customer.js

@@ -1,3 +1,10 @@
 export const CUSTOMER_KINDS = ['person', 'company'];
 export const CUSTOMER_LIFECYCLE_STAGES = ['lead', 'active', 'inactive'];
 export const CUSTOMER_ACQUISITION_CHANNELS = ['storefront', 'pos', 'marketplace', 'import', 'manual'];
+/**
+ * The highest standing `Customer.discount` (percent) a write may SET. A higher
+ * value is refused `400 CUSTOMER_DISCOUNT_OVER_MAX` by `POST /customers` and the
+ * customer import. A stored legacy value above it is kept: a write that leaves
+ * `discount` unchanged (or omits it) still saves.
+ */
+export const CUSTOMER_DISCOUNT_MAX = 50;

package/dist/notification.d.ts

@@ -136,7 +136,23 @@ export declare enum NotificationTypeEnum {
      * on a store until a user turns it on. Carries `productId` and `lotId` as its
      * click-through targets.
      */
-    EXPIRY_ALERT = "EXPIRY_ALERT"
+    EXPIRY_ALERT = "EXPIRY_ALERT",
+    /**
+     * A shopper registered on the storefront while the store's
+     * `ecommerce.config.registrationMode` is `'approval'`, and the account waits
+     * for an operator to approve or reject it. Names the registrant by name only.
+     *
+     * ⚠️ Additive, on the same grounds as `ABANDONED_CART`. The producer fans out
+     * to every non-disabled ADMIN-tier user with no legacy opt-in scan, as for
+     * `ML_SELLER_SWITCHED` (a new key is seeded nowhere). The consumer enforces
+     * explicit type/channel preferences, default-on when absent. No backfill or
+     * consumer migration is owed.
+     *
+     * ⚠️ Carries `pendingCustomerRef` and NEVER a top-level `customerId` (an
+     * audience — the operator bell would reach the pending registrant's own
+     * storefront socket), and never the registrant's email address.
+     */
+    CUSTOMER_PENDING_APPROVAL = "CUSTOMER_PENDING_APPROVAL"
 }
 declare global {
     type CustomerNotificationPreferences = Partial<Record<'reminder-scheduled' | 'appointment-reminder', {
@@ -183,6 +199,17 @@ declare global {
          */
         cartId?: string;
     }
+    /**
+     * Which registration a `CUSTOMER_PENDING_APPROVAL` operator bell is about. A
+     * POINTER, never an audience — the same reason as {@link AbandonedCartRef}:
+     * the top-level `customerId` would deliver the bell to the registrant.
+     * Operator surfaces only.
+     */
+    interface PendingCustomerRef {
+        customerId: string;
+        /** The row's `emailVerified` at registration — `false` when the address is still unproven. */
+        emailVerified: boolean;
+    }
     interface NotificationInterface {
         storeId: string;
         notificationId: string;
@@ -224,6 +251,11 @@ declare global {
          * on bells written before it existed.
          */
         cartRef?: AbandonedCartRef;
+        /**
+         * `CUSTOMER_PENDING_APPROVAL` only: which pending registration to open. A
+         * POINTER, not an audience — see {@link PendingCustomerRef}.
+         */
+        pendingCustomerRef?: PendingCustomerRef;
         /** `MENTION` only: the colleague who wrote the mention (a snapshot). */
         actor?: NotificationActor;
         userId?: string;

package/dist/notification.js

@@ -2,7 +2,8 @@
 // Indexed producers resolve candidates through `getNotificationSubscribers`:
 // legacy opt-ins and explicit channel maps remain source data on USER rows.
 // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
-// ML_CONNECTION_BROKEN / MENTION do not select a producer subscriber audience;
+// ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL do not select a
+// producer subscriber audience;
 // the consumer still reads the live USER row for each delivery channel.
 // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
 // Exported as a real enum consumed by api and app; adding an indexed type
@@ -154,4 +155,20 @@ export var NotificationTypeEnum;
      * click-through targets.
      */
     NotificationTypeEnum["EXPIRY_ALERT"] = "EXPIRY_ALERT";
+    /**
+     * A shopper registered on the storefront while the store's
+     * `ecommerce.config.registrationMode` is `'approval'`, and the account waits
+     * for an operator to approve or reject it. Names the registrant by name only.
+     *
+     * ⚠️ Additive, on the same grounds as `ABANDONED_CART`. The producer fans out
+     * to every non-disabled ADMIN-tier user with no legacy opt-in scan, as for
+     * `ML_SELLER_SWITCHED` (a new key is seeded nowhere). The consumer enforces
+     * explicit type/channel preferences, default-on when absent. No backfill or
+     * consumer migration is owed.
+     *
+     * ⚠️ Carries `pendingCustomerRef` and NEVER a top-level `customerId` (an
+     * audience — the operator bell would reach the pending registrant's own
+     * storefront socket), and never the registrant's email address.
+     */
+    NotificationTypeEnum["CUSTOMER_PENDING_APPROVAL"] = "CUSTOMER_PENDING_APPROVAL";
 })(NotificationTypeEnum || (NotificationTypeEnum = {}));

package/package.json

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