@shipstatic/ship 3.4.0-beta.4 → 3.4.0-beta.6

package/dist/index.d.cts

@@ -942,12 +942,10 @@ interface Account {
      * from where the account stands. It excludes the plan and cadence the
      * account already holds and the one move the door refuses, a dearer tier
      * at a shorter interval (an immediate move would mint a proration credit,
-     * a deferred one would make a customer asking for more wait a year). A
-     * cheaper tier the account does not yet fit is listed with what stands in
-     * the way ({@link PlanDestination.excess}). The rule's owner is the
-     * platform's plan table; a console feeds these rows into its own move
-     * model instead of restating it. Additive: absent on responses that
-     * predate it, and a client then derives as it did.
+     * a deferred one would make a customer asking for more wait a year). The
+     * rule's owner is the platform's plan table; a console feeds these
+     * intervals into its own move model instead of restating it. Additive:
+     * absent on responses that predate it, and a client then derives as it did.
      */
     readonly destinations?: PlanDestination[];
 }
@@ -959,15 +957,6 @@ interface Account {
 interface PlanDestination {
     readonly plan: AccountPlanType;
     readonly intervals: BillingInterval[];
-    /**
-     * What the account holds beyond what this plan allows: per kind, how many
-     * to remove. Present only on a cheaper tier the account does not fit, and
-     * then never empty. A move down a tier pauses nothing, so the change door
-     * refuses it until the account fits: the owner removes the excess, and the
-     * field is gone from the next read. Which kinds count is the platform's to
-     * decide; a client renders the keys it is given.
-     */
-    readonly excess?: Partial<Caps>;
 }
 /**
  * Acknowledgement of `DELETE /account` (202). Termination is asynchronous —
@@ -2497,10 +2486,10 @@ interface PlansResponse {
  * Schedule that applies the change at period end. The answer says which
  * happened ({@link PlanChangeResponse}).
  *
- * A move down a tier is refused while the account holds more than the
- * destination allows (400, `details.excess` in {@link PlanDestination.excess}'s
- * shape): nothing is paused for a change the owner chose, so the account fits
- * first.
+ * A move down a tier is booked only by an account that fits it: while the
+ * account holds more members or domains than the destination allows, the
+ * door refuses (400) with a sentence naming what to remove, and the same
+ * counts in `details.excess`, keyed like {@link Caps}.
  */
 interface PlanChangeRequest {
     readonly plan: AccountPlanType;

package/dist/index.d.ts

@@ -942,12 +942,10 @@ interface Account {
      * from where the account stands. It excludes the plan and cadence the
      * account already holds and the one move the door refuses, a dearer tier
      * at a shorter interval (an immediate move would mint a proration credit,
-     * a deferred one would make a customer asking for more wait a year). A
-     * cheaper tier the account does not yet fit is listed with what stands in
-     * the way ({@link PlanDestination.excess}). The rule's owner is the
-     * platform's plan table; a console feeds these rows into its own move
-     * model instead of restating it. Additive: absent on responses that
-     * predate it, and a client then derives as it did.
+     * a deferred one would make a customer asking for more wait a year). The
+     * rule's owner is the platform's plan table; a console feeds these
+     * intervals into its own move model instead of restating it. Additive:
+     * absent on responses that predate it, and a client then derives as it did.
      */
     readonly destinations?: PlanDestination[];
 }
@@ -959,15 +957,6 @@ interface Account {
 interface PlanDestination {
     readonly plan: AccountPlanType;
     readonly intervals: BillingInterval[];
-    /**
-     * What the account holds beyond what this plan allows: per kind, how many
-     * to remove. Present only on a cheaper tier the account does not fit, and
-     * then never empty. A move down a tier pauses nothing, so the change door
-     * refuses it until the account fits: the owner removes the excess, and the
-     * field is gone from the next read. Which kinds count is the platform's to
-     * decide; a client renders the keys it is given.
-     */
-    readonly excess?: Partial<Caps>;
 }
 /**
  * Acknowledgement of `DELETE /account` (202). Termination is asynchronous —
@@ -2497,10 +2486,10 @@ interface PlansResponse {
  * Schedule that applies the change at period end. The answer says which
  * happened ({@link PlanChangeResponse}).
  *
- * A move down a tier is refused while the account holds more than the
- * destination allows (400, `details.excess` in {@link PlanDestination.excess}'s
- * shape): nothing is paused for a change the owner chose, so the account fits
- * first.
+ * A move down a tier is booked only by an account that fits it: while the
+ * account holds more members or domains than the destination allows, the
+ * door refuses (400) with a sentence naming what to remove, and the same
+ * counts in `details.excess`, keyed like {@link Caps}.
  */
 interface PlanChangeRequest {
     readonly plan: AccountPlanType;