@moonbase.sh/storefront-api 3.10.0 → 3.11.0

package/dist/index.cjs

@@ -1295,7 +1295,7 @@ var ProductEndpoints = class {
 var import_zod15 = require("zod");
 
 // package.json
-var version = "3.10.0";
+var version = "3.11.0";
 
 // src/utils/client.ts
 function buildClientHeader(sdk) {
@@ -1451,6 +1451,10 @@ var MoonbaseApi = class {
 var schemas_exports8 = {};
 __export(schemas_exports8, {
   milestoneProgressSchema: () => milestoneProgressSchema,
+  pendingPlanChangeSchema: () => pendingPlanChangeSchema,
+  pricingOptionSchema: () => pricingOptionSchema,
+  subscriptionPlanOptionSchema: () => subscriptionPlanOptionSchema,
+  subscriptionPlanOptionsSchema: () => subscriptionPlanOptionsSchema,
   subscriptionSchema: () => subscriptionSchema
 });
 var import_zod14 = require("zod");
@@ -1660,6 +1664,33 @@ var milestoneProgressSchema = import_zod14.z.object({
   toNormalizedCycleNumber: import_zod14.z.number(),
   events: import_zod14.z.record(import_zod14.z.coerce.number(), milestoneProgressEventSchema.array())
 });
+var pricingOptionSchema = import_zod14.z.object({
+  id: import_zod14.z.string(),
+  name: import_zod14.z.string(),
+  cycleLength: import_zod14.z.nativeEnum(CycleLength)
+});
+var pendingPlanChangeSchema = import_zod14.z.object({
+  option: pricingOptionSchema,
+  // The renewal that starts the new plan and charges `nextTotal`.
+  takesEffectAt: import_zod14.z.coerce.date(),
+  nextTotal: orderTotalSchema,
+  // Whether everything the subscription gets off now (discount, offer, coupons) still applies on the new plan.
+  keepsDiscount: import_zod14.z.boolean(),
+  scheduledAt: import_zod14.z.coerce.date()
+});
+var subscriptionPlanOptionSchema = import_zod14.z.object({
+  option: pricingOptionSchema,
+  // What the next renewal charges on this plan. For the plan it is on, its normal renewal.
+  nextTotal: orderTotalSchema,
+  takesEffectAt: import_zod14.z.coerce.date(),
+  keepsDiscount: import_zod14.z.boolean(),
+  current: import_zod14.z.boolean(),
+  scheduled: import_zod14.z.boolean()
+});
+var subscriptionPlanOptionsSchema = import_zod14.z.object({
+  unavailable: import_zod14.z.string().nullish(),
+  plans: subscriptionPlanOptionSchema.array()
+});
 var subscriptionSchema = import_zod14.z.object({
   id: import_zod14.z.string(),
   status: import_zod14.z.nativeEnum(SubscriptionStatus),
@@ -1674,6 +1705,10 @@ var subscriptionSchema = import_zod14.z.object({
   paymentMethod: import_zod14.z.string().optional(),
   milestoneProgress: milestoneProgressSchema.nullish(),
   embeddedUpdatePaymentUrl: import_zod14.z.string().optional(),
+  // Older backends send neither, and one this version can't read is dropped rather than failing
+  // the whole subscription.
+  pricingOption: pricingOptionSchema.nullish().catch(void 0),
+  pendingChange: pendingPlanChangeSchema.nullish().catch(void 0),
   content: import_zod14.z.discriminatedUnion("type", [
     import_zod14.z.object({
       type: import_zod14.z.literal("Product"),
@@ -1717,6 +1752,38 @@ var SubscriptionEndpoints = class {
     });
     return response.data;
   }
+  /**
+   * The plans the subscription can switch to when its current period ends, each with what the
+   * next renewal would charge on it. The plan it is on comes first. When it can't switch,
+   * `unavailable` says why, ready to show to the customer.
+   */
+  async getPlanOptions(subscriptionId) {
+    const response = await this.api.authenticatedFetch(`/api/customer/inventory/subscriptions/${subscriptionId}/plan-options`, subscriptionPlanOptionsSchema);
+    return response.data;
+  }
+  /**
+   * Switches the subscription to another plan when its current period ends. Nothing is charged
+   * now: the next renewal charges the new plan and starts its cycle. Until then the customer can
+   * switch again, and passing the plan it is on keeps that plan. Returns the updated subscription,
+   * with the switch in `pendingChange`.
+   */
+  async changePlan(subscriptionId, variationId) {
+    const response = await this.api.authenticatedFetch(`/api/customer/inventory/subscriptions/${subscriptionId}/plan-change`, subscriptionSchema, {
+      method: "POST",
+      body: { variationId }
+    });
+    return response.data;
+  }
+  /**
+   * Keeps the subscription on its current plan, dropping a switch scheduled with `changePlan`.
+   * Returns the updated subscription.
+   */
+  async cancelPlanChange(subscriptionId) {
+    const response = await this.api.authenticatedFetch(`/api/customer/inventory/subscriptions/${subscriptionId}/plan-change`, subscriptionSchema, {
+      method: "DELETE"
+    });
+    return response.data;
+  }
   async renew(subscriptionId, returnUrl, embedded) {
     const response = await this.api.authenticatedFetch(`/api/customer/inventory/subscriptions/${subscriptionId}/renew?redirect=false&return=${returnUrl}&embedded=${embedded ? "true" : "false"}`, import_zod15.z.object({
       location: import_zod15.z.string()