platform-types 1.10.702 → 1.10.704

package/dist/basket.d.ts

@@ -63,9 +63,9 @@ declare global {
     }
 }
 /**
- * Domain refusals from POST /baskets: legacy replacement, named cart actions,
- * and park/resume. Check GATING_ERROR_CODES separately for middleware and role
- * refusals. GET /baskets and storefront-only refusals are outside this tuple.
+ * Domain refusals from POST /baskets (replacement, named actions and park/resume)
+ * and GET /baskets?mode=review. Check GATING_ERROR_CODES separately for middleware
+ * and role refusals. Other GET modes and storefront-only refusals remain separate.
  *
  * Coupon and promotion reasons are forwarded from evaluateCoupon and
  * evaluatePromotion (stacks/services/coupons.ts and promotions.ts). Checkout's
@@ -74,6 +74,6 @@ declare global {
  * priceHandler.resolveLineStamp. The legacy loose body also reaches the shared
  * foreign-index-key guard; its owned terminalId is validated before that guard.
  */
-export declare const BASKET_ERROR_CODES: readonly ["VALIDATION_FAILED", "FOREIGN_INDEX_KEY_ATTRIBUTE", "CART_TARGET_REQUIRED", "CART_NOT_FOUND", "CART_NOT_PARKED", "CART_ALREADY_PARKED", "TERMINAL_INDEX_UNAVAILABLE", "PRODUCT_NOT_FOUND", "PRODUCT_COST_UNKNOWN", "UNIT_QUANTITY_NOT_WHOLE", "BASKET_VERSION_CONFLICT", "BASKET_LINE_LIMIT", "BASKET_SIZE_LIMIT", "UNKNOWN_LINE", "INVALID_PRICE", "LINE_DISCOUNT_NOT_ALLOWED", "LINE_DISCOUNT_EXCEEDS_MAX", "FX_CONVERSION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_RATE_LIMITED", "COUPON_CURRENCY_MISMATCH", "PROMOTION_NOT_FOUND", "PROMOTION_NOT_ACTIVE", "PROMOTION_NOT_STARTED", "PROMOTION_EXPIRED", "PROMOTION_NOT_CART_APPLICABLE"];
+export declare const BASKET_ERROR_CODES: readonly ["VALIDATION_FAILED", "FOREIGN_INDEX_KEY_ATTRIBUTE", "CART_TARGET_REQUIRED", "CART_NOT_FOUND", "CART_REVIEW_INCOMPLETE", "CART_REVIEW_UNAVAILABLE", "CART_NOT_PARKED", "CART_ALREADY_PARKED", "TERMINAL_INDEX_UNAVAILABLE", "PRODUCT_NOT_FOUND", "PRODUCT_COST_UNKNOWN", "UNIT_QUANTITY_NOT_WHOLE", "BASKET_VERSION_CONFLICT", "BASKET_LINE_LIMIT", "BASKET_SIZE_LIMIT", "UNKNOWN_LINE", "INVALID_PRICE", "LINE_DISCOUNT_NOT_ALLOWED", "LINE_DISCOUNT_EXCEEDS_MAX", "FX_CONVERSION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_RATE_LIMITED", "COUPON_CURRENCY_MISMATCH", "PROMOTION_NOT_FOUND", "PROMOTION_NOT_ACTIVE", "PROMOTION_NOT_STARTED", "PROMOTION_EXPIRED", "PROMOTION_NOT_CART_APPLICABLE"];
 export type BasketErrorCode = (typeof BASKET_ERROR_CODES)[number];
 export {};

package/dist/basket.js

@@ -1,7 +1,7 @@
 /**
- * Domain refusals from POST /baskets: legacy replacement, named cart actions,
- * and park/resume. Check GATING_ERROR_CODES separately for middleware and role
- * refusals. GET /baskets and storefront-only refusals are outside this tuple.
+ * Domain refusals from POST /baskets (replacement, named actions and park/resume)
+ * and GET /baskets?mode=review. Check GATING_ERROR_CODES separately for middleware
+ * and role refusals. Other GET modes and storefront-only refusals remain separate.
  *
  * Coupon and promotion reasons are forwarded from evaluateCoupon and
  * evaluatePromotion (stacks/services/coupons.ts and promotions.ts). Checkout's
@@ -15,6 +15,8 @@ export const BASKET_ERROR_CODES = [
     'FOREIGN_INDEX_KEY_ATTRIBUTE',
     'CART_TARGET_REQUIRED',
     'CART_NOT_FOUND',
+    'CART_REVIEW_INCOMPLETE',
+    'CART_REVIEW_UNAVAILABLE',
     'CART_NOT_PARKED',
     'CART_ALREADY_PARKED',
     'TERMINAL_INDEX_UNAVAILABLE',

package/dist/cart.d.ts

@@ -1,4 +1,24 @@
 declare global {
+    interface OperatorCartReviewRequest {
+        mode: 'review';
+        customerId: string;
+        cartId?: string;
+    }
+    interface OperatorCartReviewCart extends Omit<Cart, 'customer'> {
+        customer?: Partial<Pick<Customer, 'customerId' | 'fullName'>>;
+    }
+    type OperatorCartReviewData = OperatorCartReviewCart | null;
+    /**
+     * Completed discovery returns null; an exact missing cart is a refusal.
+     * Discovery over several customer carts is never ambiguous: it returns the
+     * cart a customer-targeted write resolves (a terminal-less cart before a
+     * till's ticket, newest within each group, a new-partition row before a
+     * legacy one).
+     */
+    interface OperatorCartReviewResponse {
+        message: string;
+        data: OperatorCartReviewData;
+    }
     /**
      * A cart, keyed by its OWN minted id rather than by the customer.
      *

package/dist/cjs/basket.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASKET_ERROR_CODES = void 0;
 /**
- * Domain refusals from POST /baskets: legacy replacement, named cart actions,
- * and park/resume. Check GATING_ERROR_CODES separately for middleware and role
- * refusals. GET /baskets and storefront-only refusals are outside this tuple.
+ * Domain refusals from POST /baskets (replacement, named actions and park/resume)
+ * and GET /baskets?mode=review. Check GATING_ERROR_CODES separately for middleware
+ * and role refusals. Other GET modes and storefront-only refusals remain separate.
  *
  * Coupon and promotion reasons are forwarded from evaluateCoupon and
  * evaluatePromotion (stacks/services/coupons.ts and promotions.ts). Checkout's
@@ -18,6 +18,8 @@ exports.BASKET_ERROR_CODES = [
     'FOREIGN_INDEX_KEY_ATTRIBUTE',
     'CART_TARGET_REQUIRED',
     'CART_NOT_FOUND',
+    'CART_REVIEW_INCOMPLETE',
+    'CART_REVIEW_UNAVAILABLE',
     'CART_NOT_PARKED',
     'CART_ALREADY_PARKED',
     'TERMINAL_INDEX_UNAVAILABLE',

package/dist/cjs/subscription.js

@@ -10,9 +10,11 @@
  * - Tier names are the 4 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0):
  *   BÁSICO, EMPRENDEDOR, PROFESIONAL, AVANZADO. A new store starts trialing on
  *   the `trialTier` platform global, with `trialEndsAt` set `trialDays` days out
- *   (see `PlanCatalogue.trial`); that date is not yet enforced for a store
- *   without a payment provider. A Stripe checkout adds its own fixed 30-day
- *   trial, which does not follow those globals (ADR-0010). Courtesy
+ *   (see `PlanCatalogue.trial`). A trial with no payment method drops to
+ *   `basico` (`active`, free-tier limits, no lock-out) on the first nightly
+ *   sweep after that date, unless a courtesy gift covers today. A Stripe
+ *   checkout adds its own fixed 30-day trial, which does not follow those
+ *   globals (ADR-0010) and is ended by Stripe's events. Courtesy
  *   gifts (formerly the Founders cohort) are now a one-off ops action via
  *   `gift-subscription` that sets `freeUntil` on the SUBSCRIPTION row.
  * - `freeUntil` lives on every Subscription independent of status. It is the

package/dist/store.d.ts

@@ -829,10 +829,16 @@ declare global {
              * writes `planTier: 'basico'` on a delinquent store at day 14. A security
              * posture does not lapse because an invoice did.
              *
-             * Verified rather than assumed: `graceSweep` writes only `status`,
-             * `planTier`, `canceledFromTier`, `canceledAt` and `updatedAt`, and writes
-             * them to the SUBSCRIPTION row — it touches neither `totp` nor store
-             * config. So an obligation kept here survives the downgrade **by
+             * Verified rather than assumed: on the SUBSCRIPTION row `graceSweep`
+             * writes `status`, `planTier`, `pastDueSince`, `canceledFromTier`,
+             * `canceledAt`, `trialEndingNotifiedAt` and `updatedAt`, SETs
+             * `trialEndedFromTier` and REMOVEs `trialEndsAt` on a trial expiry, and
+             * REMOVEs `pastDueSince` and `trialEndedFromTier` on a cancel. Its other
+             * writes are its checkpoint row, ERROR rows and the shop-grace reconcile,
+             * which SETs only the STORE row's `ecommerce.deactivatesAt` and
+             * `updatedAt` (plus its own grace rows and custom-domain rows'
+             * `deactivatesAt`) — none of them touches `totp` or anything under
+             * `config`. So an obligation kept here survives the downgrade **by
              * construction**, with no special case for anyone to remember and nothing
              * to re-check when the sweep changes.
              *

package/dist/subscription.d.ts

@@ -9,9 +9,11 @@
  * - Tier names are the 4 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0):
  *   BÁSICO, EMPRENDEDOR, PROFESIONAL, AVANZADO. A new store starts trialing on
  *   the `trialTier` platform global, with `trialEndsAt` set `trialDays` days out
- *   (see `PlanCatalogue.trial`); that date is not yet enforced for a store
- *   without a payment provider. A Stripe checkout adds its own fixed 30-day
- *   trial, which does not follow those globals (ADR-0010). Courtesy
+ *   (see `PlanCatalogue.trial`). A trial with no payment method drops to
+ *   `basico` (`active`, free-tier limits, no lock-out) on the first nightly
+ *   sweep after that date, unless a courtesy gift covers today. A Stripe
+ *   checkout adds its own fixed 30-day trial, which does not follow those
+ *   globals (ADR-0010) and is ended by Stripe's events. Courtesy
  *   gifts (formerly the Founders cohort) are now a one-off ops action via
  *   `gift-subscription` that sets `freeUntil` on the SUBSCRIPTION row.
  * - `freeUntil` lives on every Subscription independent of status. It is the
@@ -34,8 +36,9 @@ declare global {
      *
      * - `trialing` — a trial on a paid tier: a new store trials on the
      *   `trialTier` platform global with `trialEndsAt` set `trialDays` days out
-     *   (`PlanCatalogue.trial`) — a date not yet enforced for a store without a
-     *   payment provider — and a Stripe checkout adds its own fixed 30-day trial.
+     *   (`PlanCatalogue.trial`) — once that date passes with no payment method the
+     *   nightly sweep drops the row to `basico`/`active` (unless a courtesy gift
+     *   covers today) — and a Stripe checkout adds its own fixed 30-day trial.
      * - `active` — paid subscription, period current.
      * - `past_due` — payment failed, in the 7-day grace window.
      * - `readonly` — grace elapsed, writes blocked, tenant can still read.
@@ -336,8 +339,10 @@ declare global {
         groups: PlanFeatureGroup[];
         /**
          * What a store registered now starts on: `tier` — a paid tier — in status
-         * `trialing`, with `trialEndsAt` set `days` days out. That date is not yet
-         * enforced for a store without a payment provider. Resolved from the platform globals
+         * `trialing`, with `trialEndsAt` set `days` days out. A store that has
+         * attached no payment method by then drops to `basico` (`active`, free-tier
+         * limits) on the first nightly sweep after that date, unless a courtesy gift
+         * covers today. Resolved from the platform globals
          * `trialTier` / `trialDays` — `profesional` / `30` when unset or invalid —
          * so it is always present.
          */
@@ -502,6 +507,16 @@ declare global {
          * field existed — forward-only, readers fall back to generic copy.
          */
         canceledFromTier?: PlanTier | null;
+        /**
+         * The paid tier a trial ran on when it lapsed with no payment method —
+         * set only by the grace sweep when it moves a provider-less `trialing`
+         * row (no provider, no provider subscription or customer id) whose
+         * `trialEndsAt` has passed to `basico`/`active`. Cleared (`null`) when
+         * the store re-subscribes to a paid tier or is canceled — a cancel
+         * records its own lost plan in `canceledFromTier`. `null` when absent —
+         * every row that never expired that way, or has moved on since.
+         */
+        trialEndedFromTier?: PlanTier | null;
         entitlements: SubscriptionEntitlementEntry[];
         usage: SubscriptionUsageEntry[];
     }
@@ -608,6 +623,8 @@ declare global {
          * it together with `provider`.
          */
         mode?: 'preapproval' | 'manual';
+        /** The paid tier an expired trial dropped from; `null` when a write cleared it. */
+        trialEndedFromTier?: PlanTier | null;
     };
     /**
      * One audit row for a MANAGER out-of-band subscription change, as returned by
@@ -616,6 +633,13 @@ declare global {
      * `AUDIT#SUBSCRIPTION#{storeId}` partition. `before`/`after` carry the
      * subscription fields an operator can change.
      *
+     * The partition also carries SYSTEM-written `subscription.trial_expired`
+     * rows from the grace sweep: `actor` is empty (`userId: ''`,
+     * `fullName: ''`), `before` holds the trial's `status`/`planTier`/
+     * `trialEndsAt`, and `after` holds `status: 'active'`,
+     * `planTier: 'basico'`, `trialEndsAt: null` and `trialEndedFromTier`
+     * (the trial's tier).
+     *
      * ⚠️ The same partition also carries entitlement-override and advancedPricing
      * rows whose `before`/`after` hold different keys, so consumers must read
      * each side structurally rather than trusting every field to be present.

package/dist/subscription.js

@@ -9,9 +9,11 @@
  * - Tier names are the 4 locked Spanish tiers (per SUBSCRIPTION_TIERS_BEST_PRACTICES §0):
  *   BÁSICO, EMPRENDEDOR, PROFESIONAL, AVANZADO. A new store starts trialing on
  *   the `trialTier` platform global, with `trialEndsAt` set `trialDays` days out
- *   (see `PlanCatalogue.trial`); that date is not yet enforced for a store
- *   without a payment provider. A Stripe checkout adds its own fixed 30-day
- *   trial, which does not follow those globals (ADR-0010). Courtesy
+ *   (see `PlanCatalogue.trial`). A trial with no payment method drops to
+ *   `basico` (`active`, free-tier limits, no lock-out) on the first nightly
+ *   sweep after that date, unless a courtesy gift covers today. A Stripe
+ *   checkout adds its own fixed 30-day trial, which does not follow those
+ *   globals (ADR-0010) and is ended by Stripe's events. Courtesy
  *   gifts (formerly the Founders cohort) are now a one-off ops action via
  *   `gift-subscription` that sets `freeUntil` on the SUBSCRIPTION row.
  * - `freeUntil` lives on every Subscription independent of status. It is the

package/package.json

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