@shipstatic/ship 2.6.0-beta.3 → 2.6.0-beta.5

package/THIRD-PARTY-LICENSES.md

@@ -5,7 +5,7 @@ Their copyright notices travel with that copy, and are reproduced here in
 full. This file is GENERATED from the build's own metafile — edit the
 bundle, not this list.
 
-## @shipstatic/types 2.17.0-beta.1
+## @shipstatic/types 2.17.0-beta.3
 
 License: MIT
 

package/dist/browser.d.ts

@@ -669,6 +669,16 @@ interface Account {
      * `DELETE /billing/change` releases it.
      */
     readonly scheduled: ScheduledChange | null;
+    /**
+     * When the Subscription is set to END — Stripe's `cancel_at`, mirrored
+     * (Unix seconds) — or `null` while it renews. Set by a cancellation in the
+     * Customer Portal; the Portal is also where it is resumed. The console
+     * needs it to ACT: no "cancel" offered to an account already cancelling,
+     * and no plan change offered until it is resumed (the API refuses one).
+     * Mirrored on the rule that survives: what the console must act on is
+     * mirrored, what it would merely display is not.
+     */
+    readonly cancelAt: number | null;
 }
 /**
  * Account as returned by `GET /account` — the entity plus how the request
@@ -1885,19 +1895,26 @@ interface ScheduledChange {
     readonly at: number;
 }
 /**
- * The answer of `POST /billing/change` — exactly one field is set.
+ * The answer of `POST /billing/change` — exactly one field is set, and the
+ * UNION is what holds that: an answer carrying both, or neither, does not
+ * compile, so "which door was taken" is structural rather than prose.
  *
  * `url` means GO: a Stripe page (Checkout, or the Portal's confirmation page)
  * finishes the change and the browser must be redirected to it. `scheduled`
  * means DONE: the downgrade is booked for period end, nothing to visit, and
  * the account's `scheduled` field now carries it.
  */
-interface PlanChangeResponse {
-    /** Absolute URL to redirect the browser to. Single use, short-lived. */
-    readonly url?: string;
-    /** The pending change, when the platform scheduled it instead. */
-    readonly scheduled?: ScheduledChange;
+type PlanChangeResponse = 
+/** GO: a Stripe page finishes the change. Absolute URL, single use, short-lived. */
+{
+    readonly url: string;
+    readonly scheduled?: never;
 }
+/** DONE: the downgrade is booked for period end; nothing to visit. */
+ | {
+    readonly url?: never;
+    readonly scheduled: ScheduledChange;
+};
 /**
  * The answer of `POST /billing/portal` — Stripe's `BillingPortal.Session`,
  * projected to the one field a client needs. The Portal home: cards,