platform-types 1.10.706 → 1.10.708

package/dist/platform.d.ts

@@ -845,63 +845,22 @@ export interface TenantBillingRollupRow {
     historyError?: TenantBillingHistoryError;
 }
 /**
- * Why a plan's marketing copy disagrees with the entitlements actually backing
- * that tier. Advisory only — `PATCH /platform/billing/plans/{tier}` reports
- * these and still applies the write. It never blocks: plan copy is hand-tuned
- * between pricing decisions, so a mismatch is routinely the intended
- * intermediate state rather than an error. The entitlements themselves come
- * from the code matrix; that route refuses `features`.
- *
- * - `NUMERIC_MISMATCH` — a bullet advertises a number that differs from the
- *   numeric entitlement it maps to.
- * - `UNLIMITED_ADVERTISED_AS_CAPPED` — the entitlement is `-1` (unlimited) but
- *   the copy advertises a finite cap. Reported separately because the equality
- *   compare would otherwise render it as a nonsense mismatch against `-1`.
- * - `UNBACKED_CAPABILITY` — the copy names a capability the tier does not have
- *   `status: 'live'` and `enabled: true` for.
- * - `MISSING_FEATURE_ROW` — a bullet states a LIMIT for an entitlement the tier
- *   has no row for at all. Distinct from `UNBACKED_CAPABILITY` on purpose: that
- *   one means "the row exists but is not live/enabled in the matrix", whereas
- *   this one means the supplied catalogue lacks the backing row — a template
- *   PATCH cannot add it; the repair is the copy or a matrix change. Collapsing
- *   them (as the API briefly did) hides the more severe of the two behind the
- *   more common one.
+ * @deprecated Nothing produces one any more. The copy↔entitlement consistency
+ * check went with the free-text plan copy it checked, so the `warnings` array
+ * on the `POST` / `PATCH /platform/billing/plans` replies is ALWAYS empty. The
+ * type stays only so a consumer still naming it compiles; it will be removed
+ * together with that array.
  */
 export type CatalogWarningCode = 'NUMERIC_MISMATCH' | 'UNLIMITED_ADVERTISED_AS_CAPPED' | 'UNBACKED_CAPABILITY' | 'MISSING_FEATURE_ROW';
 /**
- * One disagreement between a plan's copy and its entitlements, or between the
- * declared feature catalog and a tier's stored rows.
- *
- * ⚠️ Absence of a warning is NOT a claim that the copy is correct. The matcher
- * pairs a bullet to a feature only on a single unambiguous keyword; a bullet
- * matching two keywords or none is skipped rather than guessed, so it
- * deliberately understates. Reading an empty array as "this tier's copy is
- * verified" inverts that design.
- *
- * ⚠️ That understatement had a second, larger hole: every check used to be
- * COPY-DRIVEN, so a declared feature key that no bullet happened to mention
- * could be missing its row on every tier and warn nothing. That is not
- * hypothetical — `storefront` was absent from all four production tiers, had no
- * marketing bullet, and therefore produced an empty `warnings` array while the
- * feature was locked for every tenant. `source: 'catalog'` exists so a check can
- * be driven by the declared key set instead of by what the copy happens to name.
+ * @deprecated See {@link CatalogWarningCode} — no writer emits one; the
+ * `warnings` array that carried it is always empty.
  */
 export interface CatalogWarning {
     code: CatalogWarningCode;
-    /**
-     * What produced it — one of the `bullets`, the `description`, or `'catalog'`
-     * for a check driven by the declared feature key set rather than by copy.
-     */
     source: 'bullets' | 'description' | 'catalog';
-    /**
-     * The offending bullet, or the description, verbatim. For `source:
-     * 'catalog'` there is no copy to quote — it carries the tier that was
-     * examined, which is the equivalent "what was checked" value.
-     */
     text: string;
-    /** The entitlement the copy was checked against. */
     featureKey: FeatureKey;
-    /** Human-readable, already safe to render as-is. */
     message: string;
 }
 /**

package/dist/subscription.d.ts

@@ -314,11 +314,11 @@ declare global {
          */
         features: PlanFeature[];
         /**
-         * Marketing-curated short bullets for the pricing card. Display order =
-         * array order; up to 6 entries, 80 chars each. Always present — empty array
-         * when unset (FE synthesizes a list from `features[]`). Lets marketing tweak
-         * copy via `PATCH /platform/billing/plans/{tier}` without a redeploy;
-         * replaces the FE-only `BULLET_LIST_BY_TIER`.
+         * @deprecated ALWAYS `[]`. The free-text card copy was retired: a plan
+         * card renders {@link Plan.highlights} instead, and no write accepts
+         * `bullets` any more (`POST`/`PATCH /platform/billing/plans` answer 400
+         * `VALIDATION_FAILED`). A value an old row still stores is ignored, never
+         * echoed. The key will be removed once the app's copy editor is gone.
          */
         bullets: string[];
         /**
@@ -472,7 +472,7 @@ declare global {
         remaining: number | null;
     }
     /**
-     * Full subscription snapshot. Three producers emit it:
+     * Full subscription snapshot. Four producers emit it:
      *
      * - `GET /subscription` — the full `usage[]`, including the row-counted
      *   `webhooks` / `maxWarehouses` meters. The two are present together or
@@ -481,7 +481,12 @@ declare global {
      * - the `GET /store` subscription embed — WITHOUT those two meters (monthly
      *   and lifetime only) and without `provider`;
      * - the reply of the MANAGER `PUT /platform/stores/{storeId}/subscription` —
-     *   built by the same assembly as `GET /subscription`, meters included.
+     *   built by the same assembly as `GET /subscription`, meters included, read
+     *   strongly consistent after the write;
+     * - the `data` of a `POST /subscription/cancel` that ended a trial with no
+     *   payment method — the same assembly again, read after the write; `data` is
+     *   absent from that 200 only when the read itself failed after the trial had
+     *   already ended. A cancel that reached a provider answers no `data`.
      *
      * The WebSocket only nudges a refetch on subscription/entitlement changes; it
      * never carries this payload.
@@ -500,6 +505,27 @@ declare global {
          * (`externalCustomerId`/`externalSubscriptionId`) are never exposed.
          */
         provider?: SubscriptionProvider;
+        /**
+         * Whether the row holds a live provider subscription that `POST /subscription/cancel`
+         * can act on: a provider subscription id of its rail's kind (Stripe `sub_…`; a
+         * MercadoPago PreApproval id or manual-mode anchor) on a row that is not `canceled`.
+         * Unlike `provider`, never a fallback. Carried by every producer, the `GET /store`
+         * embed included.
+         *
+         * `true` does not promise the portal or a payment-method update — those also depend
+         * on the rail: MercadoPago has no hosted portal (`501 BILLING_NOT_CONFIGURED`), a
+         * manual-mode anchor has no payment method to update (`501`), and a Stripe portal
+         * needs the `cus_` Customer (a MANAGER-set `sub_` row without one is `404`).
+         *
+         * When `false`, those three routes answer `404 NO_SUBSCRIPTION` without calling a
+         * provider — no row, a `cus_`-only Stripe checkout, a canceled row, an id from the
+         * other rail, and any provider-less row — with exactly two cancel exceptions, both
+         * on a provider-less row (no `provider`, provider subscription or customer id):
+         * a `trialing` row that is not the platform store, has a `trialEndsAt` and is not
+         * covered by a courtesy gift (`freeUntil`) has its trial ended (200); and a row no
+         * longer `trialing` that carries `trialEndedFromTier` answers 200 with no write.
+         */
+        hasProviderSubscription: boolean;
         billingCycle: BillingCycle | null;
         currentPeriodStart: number | null;
         currentPeriodEnd: number | null;
@@ -518,13 +544,15 @@ declare global {
          */
         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.
+         * The paid tier a trial ran on when it ended with no payment method —
+         * set only when a provider-less `trialing` row (no provider, no provider
+         * subscription or customer id) moves to `basico`/`active`: by the grace
+         * sweep once its `trialEndsAt` has passed, or by `POST /subscription/cancel`
+         * ending it early (that cancel sets this, never `canceledFromTier`).
+         * Cleared (`null`) when the store re-subscribes to a paid tier or a provider
+         * subscription is canceled — that cancel records its own lost plan in
+         * `canceledFromTier`. `null` when absent — every row that never ended a
+         * trial that way, or has moved on since.
          */
         trialEndedFromTier?: PlanTier | null;
         entitlements: SubscriptionEntitlementEntry[];
@@ -633,7 +661,11 @@ declare global {
          * it together with `provider`.
          */
         mode?: 'preapproval' | 'manual';
-        /** The paid tier an expired trial dropped from; `null` when a write cleared it. */
+        /**
+         * The paid tier a trial with no payment method dropped from — one that expired
+         * (the grace sweep) or one the tenant ended through `POST /subscription/cancel`;
+         * `null` when a write cleared it.
+         */
         trialEndedFromTier?: PlanTier | null;
     };
     /**
@@ -648,7 +680,9 @@ declare global {
      * `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 trial's tier). `subscription.trial_canceled` rows have the same
+     * `before`/`after` and name the tenant user who ended the trial through
+     * `POST /subscription/cancel` as `actor`.
      *
      * ⚠️ The same partition also carries entitlement-override and advancedPricing
      * rows whose `before`/`after` hold different keys, so consumers must read

package/package.json

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