platform-types 1.10.704 → 1.10.705

package/dist/cjs/subscription.js

@@ -13,8 +13,9 @@
  *   (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
+ *   checkout grants no trial of its own: it carries over what is left of the
+ *   row's `trialEndsAt` (as `subscription_data.trial_end`) when that is at
+ *   least 48 h + 5 min away, and bills from checkout otherwise. 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/subscription.d.ts

@@ -12,8 +12,9 @@
  *   (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
+ *   checkout grants no trial of its own: it carries over what is left of the
+ *   row's `trialEndsAt` (as `subscription_data.trial_end`) when that is at
+ *   least 48 h + 5 min away, and bills from checkout otherwise. 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
@@ -38,7 +39,9 @@ declare global {
      *   `trialTier` platform global with `trialEndsAt` set `trialDays` days out
      *   (`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.
+     *   covers today). A Stripe checkout carries over the remaining
+     *   `trialEndsAt` when it is at least 48 h + 5 min away, else no trial —
+     *   never a fresh fixed period.
      * - `active` — paid subscription, period current.
      * - `past_due` — payment failed, in the 7-day grace window.
      * - `readonly` — grace elapsed, writes blocked, tenant can still read.
@@ -223,17 +226,22 @@ declare global {
     /**
      * How a billing cycle of a plan can be bought:
      *
-     * - `self`  — self-serve checkout: the cycle has a charged price and the
-     *             plan has a `currency`.
+     * - `self`  — self-serve checkout: the cycle has a charged price, the
+     *             plan has a `currency`, and the plan is active.
      * - `sales` — the plan charges some cycle, but not this one self-serve
-     *             (no price on it, or no `currency`); route to "Contactar ventas".
+     *             (no price on it, no `currency`, or `isActive: false`); route
+     *             to "Contactar ventas". On `GET /subscription/plans` the
+     *             caller's OWN hidden tier reads `self` instead, as checkout
+     *             lets that store renew it.
      * - `none`  — neither cycle is charged (the free tier); nothing to buy.
      */
     type PlanCheckoutMode = 'self' | 'sales' | 'none';
     /**
      * A sellable plan in the catalog, exactly as `GET /subscription/plans` and
      * `GET /public/plans` emit it — both build it with the same catalogue
-     * builder, so the two endpoints return identical plans. The template fields
+     * builder, so the two endpoints return identical plans — except the
+     * caller's own hidden tier's `checkout` on `GET /subscription/plans` (see
+     * {@link PlanCheckoutMode}). The template fields
      * (copy, prices, flags) live in DynamoDB (`PLAN#{tier}` / `SK: PLAN`),
      * administered via `POST /platform/billing/plans` +
      * `PATCH /platform/billing/plans/{tier}`; `features` are code, rendered at
@@ -271,7 +279,9 @@ declare global {
         /**
          * Whether the plan is shown on the pricing page and accepting new
          * subscribers. Pre-launch / sales-led tiers set this `false` without
-         * deleting the row.
+         * deleting the row. `POST /subscription/checkout` refuses a `false`
+         * tier with 400 `PLAN_NOT_PURCHASABLE` unless the store's subscription
+         * is already on it — existing subscribers on it may renew.
          */
         isActive: boolean;
         /**

package/dist/subscription.js

@@ -12,8 +12,9 @@
  *   (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
+ *   checkout grants no trial of its own: it carries over what is left of the
+ *   row's `trialEndsAt` (as `subscription_data.trial_end`) when that is at
+ *   least 48 h + 5 min away, and bills from checkout otherwise. 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.704",
+	"version": "1.10.705",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",