@flexprice/mcp-server 2.1.24 → 2.1.25

package/manifest.json

@@ -48,7 +48,7 @@
       "sensitive": true
     }
   },
-  "version": "2.1.24",
+  "version": "2.1.25",
   "tools": [
     {
       "name": "update-customer",
@@ -300,7 +300,7 @@
     },
     {
       "name": "execute-subscription-plan-change-v2",
-      "description": "Execute a plan change (v2, swap in place)\n\nChange a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction."
+      "description": "Execute a plan change (v2, swap in place)\n\nChange a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction.\n\nchange_at controls timing. Omitted or 'immediate' applies the change now. 'end_of_period' records a pending schedule that executes at the subscription's current period end: the response returns is_scheduled, schedule_id and scheduled_at instead of a completed change, and nothing is swapped or billed until the boundary.\n\nscheduled_at is resolved from the subscription's current period end at request time. If that period end is already in the past (a backdated start date, a resumed pause, or worker downtime can all leave a subscription behind), the change is due immediately and fires on the next billing scan rather than a period away — inspect scheduled_at to see this.\n\nOnly one plan change may be pending per subscription; request a second one and this returns 400. Cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules."
     },
     {
       "name": "preview-subscription-plan-change-v2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexprice/mcp-server",
-  "version": "2.1.24",
+  "version": "2.1.25",
   "author": "flexprice",
   "type": "module",
   "sideEffects": false,

package/src/funcs/subscriptionsExecuteSubscriptionPlanChangeV2.ts

@@ -30,6 +30,12 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Change a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction.
+ *
+ * change_at controls timing. Omitted or 'immediate' applies the change now. 'end_of_period' records a pending schedule that executes at the subscription's current period end: the response returns is_scheduled, schedule_id and scheduled_at instead of a completed change, and nothing is swapped or billed until the boundary.
+ *
+ * scheduled_at is resolved from the subscription's current period end at request time. If that period end is already in the past (a backdated start date, a resumed pause, or worker downtime can all leave a subscription behind), the change is due immediately and fires on the next billing scan rather than a period away — inspect scheduled_at to see this.
+ *
+ * Only one plan change may be pending per subscription; request a second one and this returns 400. Cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules.
  */
 export function subscriptionsExecuteSubscriptionPlanChangeV2(
   client$: FlexpriceCore,

package/src/lib/config.ts

@@ -69,8 +69,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0",
-  sdkVersion: "2.1.24",
+  sdkVersion: "2.1.25",
   genVersion: "2.931.0",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 2.1.24 2.931.0 1.0 @flexprice/mcp-server",
+    "speakeasy-sdk/mcp-typescript 2.1.25 2.931.0 1.0 @flexprice/mcp-server",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -21,7 +21,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "2.1.24",
+    currentVersion: "2.1.25",
   },
 });
 

package/src/mcp-server/server.ts

@@ -105,7 +105,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Flexprice",
-    version: "2.1.24",
+    version: "2.1.25",
   });
 
   const getClient = deps.getSDK || (() =>

package/src/mcp-server/tools/subscriptionsExecuteSubscriptionPlanChangeV2.ts

@@ -16,7 +16,13 @@ export const tool$subscriptionsExecuteSubscriptionPlanChangeV2: ToolDefinition<
   name: "execute-subscription-plan-change-v2",
   description: `Execute a plan change (v2, swap in place)
 
-Change a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction.`,
+Change a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction.
+
+change_at controls timing. Omitted or 'immediate' applies the change now. 'end_of_period' records a pending schedule that executes at the subscription's current period end: the response returns is_scheduled, schedule_id and scheduled_at instead of a completed change, and nothing is swapped or billed until the boundary.
+
+scheduled_at is resolved from the subscription's current period end at request time. If that period end is already in the past (a backdated start date, a resumed pause, or worker downtime can all leave a subscription behind), the change is due immediately and fires on the next billing scan rather than a period away — inspect scheduled_at to see this.
+
+Only one plan change may be pending per subscription; request a second one and this returns 400. Cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules.`,
   scopes: ["write"],
   annotations: {
     "title": "",

package/src/models/entitlementgrantallocationbehavior.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const EntitlementGrantAllocationBehavior = {
+  FirstUsage: "first_usage",
+  UnitStart: "unit_start",
+} as const;
+export type EntitlementGrantAllocationBehavior = ClosedEnum<
+  typeof EntitlementGrantAllocationBehavior
+>;
+
+export const EntitlementGrantAllocationBehavior$zodSchema = z.enum([
+  "first_usage",
+  "unit_start",
+]);

package/src/models/entitlementgrantdurationunit.ts

@@ -9,6 +9,7 @@ export const EntitlementGrantDurationUnit = {
   Hour: "hour",
   Day: "day",
   Week: "week",
+  SubscriptionPeriod: "subscription_period",
 } as const;
 export type EntitlementGrantDurationUnit = ClosedEnum<
   typeof EntitlementGrantDurationUnit
@@ -18,4 +19,5 @@ export const EntitlementGrantDurationUnit$zodSchema = z.enum([
   "hour",
   "day",
   "week",
+  "subscription_period",
 ]);

package/src/models/entitlementresponse.ts

@@ -12,6 +12,10 @@ import {
   EntitlementEntityType,
   EntitlementEntityType$zodSchema,
 } from "./entitlemententitytype.js";
+import {
+  EntitlementGrantAllocationBehavior,
+  EntitlementGrantAllocationBehavior$zodSchema,
+} from "./entitlementgrantallocationbehavior.js";
 import {
   EntitlementGrantDurationUnit,
   EntitlementGrantDurationUnit$zodSchema,
@@ -46,6 +50,7 @@ export type EntitlementResponse = {
   feature?: FeatureResponse | undefined;
   feature_id?: string | undefined;
   feature_type?: FeatureType | undefined;
+  grant_allocation_behavior?: EntitlementGrantAllocationBehavior | undefined;
   grant_duration_unit?: EntitlementGrantDurationUnit | undefined;
   grant_duration_value?: number | undefined;
   grant_measure?: EntitlementGrantMeasure | undefined;
@@ -81,6 +86,8 @@ export const EntitlementResponse$zodSchema: z.ZodType<EntitlementResponse> = z
     feature: FeatureResponse$zodSchema.optional(),
     feature_id: z.string().optional(),
     feature_type: FeatureType$zodSchema.optional(),
+    grant_allocation_behavior: EntitlementGrantAllocationBehavior$zodSchema
+      .optional(),
     grant_duration_unit: EntitlementGrantDurationUnit$zodSchema.optional(),
     grant_duration_value: z.int().optional(),
     grant_measure: EntitlementGrantMeasure$zodSchema.optional(),

package/src/models/integrationentitytype.ts

@@ -17,6 +17,7 @@ export const IntegrationEntityType = {
   ItemPrice: "item_price",
   Price: "price",
   InvoiceLineItem: "invoice_line_item",
+  SubscriptionLineItem: "subscription_line_item",
 } as const;
 export type IntegrationEntityType = ClosedEnum<typeof IntegrationEntityType>;
 
@@ -32,4 +33,5 @@ export const IntegrationEntityType$zodSchema = z.enum([
   "item_price",
   "price",
   "invoice_line_item",
+  "subscription_line_item",
 ]);

package/src/models/subscriptionchangev2request.ts

@@ -7,12 +7,14 @@ import {
   ProrationBehavior,
   ProrationBehavior$zodSchema,
 } from "./prorationbehavior.js";
+import { ScheduleType, ScheduleType$zodSchema } from "./scheduletype.js";
 import {
   SubscriptionChangeEntityPolicies,
   SubscriptionChangeEntityPolicies$zodSchema,
 } from "./subscriptionchangeentitypolicies.js";
 
 export type SubscriptionChangeV2Request = {
+  change_at?: ScheduleType | undefined;
   entity_policies?: SubscriptionChangeEntityPolicies | undefined;
   idempotency_key?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
@@ -23,6 +25,7 @@ export type SubscriptionChangeV2Request = {
 export const SubscriptionChangeV2Request$zodSchema: z.ZodType<
   SubscriptionChangeV2Request
 > = z.object({
+  change_at: ScheduleType$zodSchema.optional(),
   entity_policies: SubscriptionChangeEntityPolicies$zodSchema.optional(),
   idempotency_key: z.string().optional(),
   metadata: z.record(z.string(), z.string()).optional(),

package/src/models/subscriptionchangev2response.ts

@@ -27,7 +27,10 @@ export type SubscriptionChangeV2Response = {
   effective_at?: string | undefined;
   entity_changes?: Array<EntityChangeResult> | undefined;
   from_plan?: PlanSummary | undefined;
+  is_scheduled?: boolean | undefined;
   metadata?: { [k: string]: string } | undefined;
+  schedule_id?: string | undefined;
+  scheduled_at?: string | undefined;
   subscription?: SubscriptionResponse | undefined;
   to_plan?: PlanSummary | undefined;
   warnings?: Array<string> | undefined;
@@ -41,7 +44,12 @@ export const SubscriptionChangeV2Response$zodSchema: z.ZodType<
   effective_at: z.iso.datetime({ offset: true }).optional(),
   entity_changes: z.array(EntityChangeResult$zodSchema).optional(),
   from_plan: PlanSummary$zodSchema.optional(),
+  is_scheduled: z.boolean().optional().describe(
+    "IsScheduled is true when the change was deferred to the period end instead\nof being applied immediately.",
+  ),
   metadata: z.record(z.string(), z.string()).optional(),
+  schedule_id: z.string().optional(),
+  scheduled_at: z.iso.datetime({ offset: true }).optional(),
   subscription: SubscriptionResponse$zodSchema.optional(),
   to_plan: PlanSummary$zodSchema.optional(),
   warnings: z.array(z.string()).optional(),

package/src/tool-names.ts

@@ -250,7 +250,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "execute-subscription-plan-change-v2",
-    "description": "Execute a plan change (v2, swap in place)\n\nChange a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction."
+    "description": "Execute a plan change (v2, swap in place)\n\nChange a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction.\n\nchange_at controls timing. Omitted or 'immediate' applies the change now. 'end_of_period' records a pending schedule that executes at the subscription's current period end: the response returns is_scheduled, schedule_id and scheduled_at instead of a completed change, and nothing is swapped or billed until the boundary.\n\nscheduled_at is resolved from the subscription's current period end at request time. If that period end is already in the past (a backdated start date, a resumed pause, or worker downtime can all leave a subscription behind), the change is due immediately and fires on the next billing scan rather than a period away — inspect scheduled_at to see this.\n\nOnly one plan change may be pending per subscription; request a second one and this returns 400. Cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules."
   },
   {
     "name": "preview-subscription-plan-change-v2",