@flexprice/mcp-server 2.1.20 → 2.1.25

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

@@ -0,0 +1,51 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsExecuteSubscriptionPlanChangeV2 } from "../../funcs/subscriptionsExecuteSubscriptionPlanChangeV2.js";
+import { ExecuteSubscriptionPlanChangeV2Request$zodSchema } from "../../models/executesubscriptionplanchangev2op.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ExecuteSubscriptionPlanChangeV2Request$zodSchema,
+};
+
+export const tool$subscriptionsExecuteSubscriptionPlanChangeV2: ToolDefinition<
+  typeof args
+> = {
+  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_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": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await subscriptionsExecuteSubscriptionPlanChangeV2(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

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

@@ -16,7 +16,7 @@ export const tool$subscriptionsPreviewSubscriptionModify: ToolDefinition<
   name: "preview-subscription-modify",
   description: `Preview subscription modification
 
-Preview the impact of a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, or tax) without committing changes.`,
+Preview the impact of a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, tax, or addon add/remove) without committing changes.`,
   scopes: ["read"],
   annotations: {
     "title": "",

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

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsPreviewSubscriptionPlanChangeV2 } from "../../funcs/subscriptionsPreviewSubscriptionPlanChangeV2.js";
+import { PreviewSubscriptionPlanChangeV2Request$zodSchema } from "../../models/previewsubscriptionplanchangev2op.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: PreviewSubscriptionPlanChangeV2Request$zodSchema,
+};
+
+export const tool$subscriptionsPreviewSubscriptionPlanChangeV2: ToolDefinition<
+  typeof args
+> = {
+  name: "preview-subscription-plan-change-v2",
+  description: `Preview a plan change (v2, swap in place)
+
+Preview a subscription plan change without writing. Swap-in-place: subscription id, billing anchor and period bounds are preserved.`,
+  scopes: ["read"],
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await subscriptionsPreviewSubscriptionPlanChangeV2(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

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

@@ -16,6 +16,7 @@ export const tool$subscriptionsRemoveSubscriptionAddon: ToolDefinition<
   name: "remove-subscription-addon",
   description: `Remove addon from subscription
 
+Deprecated: use POST /subscriptions/{id}/modify/execute with type "addon" and action "remove", which also supports previewing the proration credit first.
 Use when removing an add-on from a subscription (e.g. downgrade or opt-out).`,
   scopes: ["delete"],
   annotations: {

package/src/mcp-server/tools.ts

@@ -343,6 +343,8 @@ export function registerDynamicTools(
       if (def.args) {
         const jsonSchema = z.toJSONSchema(z.object(def.args), {
           target: "draft-2020-12",
+          io: "input",
+          unrepresentable: "any",
         });
         schemaText += JSON.stringify(jsonSchema, null, 2);
       } else {

package/src/models/addaddonparams.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { AddAddonRef, AddAddonRef$zodSchema } from "./addaddonref.js";
+
+export type AddAddonParams = {
+  addons?: Array<AddAddonRef> | undefined;
+  subscription_id?: string | undefined;
+};
+
+export const AddAddonParams$zodSchema: z.ZodType<AddAddonParams> = z.object({
+  addons: z.array(AddAddonRef$zodSchema).optional(),
+  subscription_id: z.string().optional(),
+});

package/src/models/addaddonref.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { AddonCadence, AddonCadence$zodSchema } from "./addoncadence.js";
+import {
+  ProrationBehavior,
+  ProrationBehavior$zodSchema,
+} from "./prorationbehavior.js";
+
+export type AddAddonRef = {
+  addon_id?: string | undefined;
+  association_id?: string | undefined;
+  cadence?: AddonCadence | undefined;
+  proration_behavior?: ProrationBehavior | undefined;
+  start_date?: string | undefined;
+};
+
+export const AddAddonRef$zodSchema: z.ZodType<AddAddonRef> = z.object({
+  addon_id: z.string().optional(),
+  association_id: z.string().optional(),
+  cadence: AddonCadence$zodSchema.optional(),
+  proration_behavior: ProrationBehavior$zodSchema.optional(),
+  start_date: z.iso.datetime({ offset: true }).optional(),
+});

package/src/models/addaddonrequest.ts

@@ -4,10 +4,15 @@
 
 import * as z from "zod";
 import { AddonCadence, AddonCadence$zodSchema } from "./addoncadence.js";
+import { CheckoutParams, CheckoutParams$zodSchema } from "./checkoutparams.js";
 import {
   LineItemCommitmentConfig,
   LineItemCommitmentConfig$zodSchema,
 } from "./lineitemcommitmentconfig.js";
+import {
+  OverrideLineItemRequest,
+  OverrideLineItemRequest$zodSchema,
+} from "./overridelineitemrequest.js";
 import {
   ProrationBehavior,
   ProrationBehavior$zodSchema,
@@ -16,8 +21,10 @@ import {
 export type AddAddonRequest = {
   addon_id: string;
   cadence?: AddonCadence | undefined;
+  checkout?: CheckoutParams | undefined;
   line_item_commitments?: { [k: string]: LineItemCommitmentConfig } | undefined;
   metadata?: { [k: string]: any } | undefined;
+  override_line_items?: Array<OverrideLineItemRequest> | undefined;
   proration_behavior?: ProrationBehavior | undefined;
   start_date?: string | undefined;
   subscription_id: string;
@@ -26,6 +33,7 @@ export type AddAddonRequest = {
 export const AddAddonRequest$zodSchema: z.ZodType<AddAddonRequest> = z.object({
   addon_id: z.string(),
   cadence: AddonCadence$zodSchema.optional(),
+  checkout: CheckoutParams$zodSchema.optional(),
   line_item_commitments: z.record(
     z.string(),
     LineItemCommitmentConfig$zodSchema,
@@ -33,6 +41,10 @@ export const AddAddonRequest$zodSchema: z.ZodType<AddAddonRequest> = z.object({
     "LineItemCommitments allows setting commitment configuration per addon line item (keyed by price_id)",
   ),
   metadata: z.record(z.string(), z.any()).optional(),
+  override_line_items: z.array(OverrideLineItemRequest$zodSchema).optional()
+    .describe(
+      "OverrideLineItems allows overriding price/quantity/billing model for specific addon prices",
+    ),
   proration_behavior: ProrationBehavior$zodSchema.optional(),
   start_date: z.iso.datetime({ offset: true }).optional(),
   subscription_id: z.string(),

package/src/models/addaddontosubscriptionrequest.ts

@@ -8,6 +8,10 @@ import {
   LineItemCommitmentConfig,
   LineItemCommitmentConfig$zodSchema,
 } from "./lineitemcommitmentconfig.js";
+import {
+  OverrideLineItemRequest,
+  OverrideLineItemRequest$zodSchema,
+} from "./overridelineitemrequest.js";
 import {
   ProrationBehavior,
   ProrationBehavior$zodSchema,
@@ -18,6 +22,7 @@ export type AddAddonToSubscriptionRequest = {
   cadence?: AddonCadence | undefined;
   line_item_commitments?: { [k: string]: LineItemCommitmentConfig } | undefined;
   metadata?: { [k: string]: any } | undefined;
+  override_line_items?: Array<OverrideLineItemRequest> | undefined;
   proration_behavior?: ProrationBehavior | undefined;
   start_date?: string | undefined;
 };
@@ -34,6 +39,10 @@ export const AddAddonToSubscriptionRequest$zodSchema: z.ZodType<
     "LineItemCommitments allows setting commitment configuration per addon line item (keyed by price_id)",
   ),
   metadata: z.record(z.string(), z.any()).optional(),
+  override_line_items: z.array(OverrideLineItemRequest$zodSchema).optional()
+    .describe(
+      "OverrideLineItems allows overriding price/quantity/billing model for specific addon prices",
+    ),
   proration_behavior: ProrationBehavior$zodSchema.optional(),
   start_date: z.iso.datetime({ offset: true }).optional(),
 });

package/src/models/addaddontosubscriptionresponse.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  AddonAssociationEntityType,
+  AddonAssociationEntityType$zodSchema,
+} from "./addonassociationentitytype.js";
+import { AddonStatus, AddonStatus$zodSchema } from "./addonstatus.js";
+import {
+  CheckoutSessionResponse,
+  CheckoutSessionResponse$zodSchema,
+} from "./checkoutsessionresponse.js";
+import {
+  InvoiceResponse,
+  InvoiceResponse$zodSchema,
+} from "./invoiceresponse.js";
+import { Status, Status$zodSchema } from "./status.js";
+
+export type AddAddonToSubscriptionResponse = {
+  addon_id?: string | undefined;
+  addon_status?: AddonStatus | undefined;
+  cancellation_reason?: string | undefined;
+  cancelled_at?: string | undefined;
+  checkout_session?: CheckoutSessionResponse | undefined;
+  created_at?: string | undefined;
+  created_by?: string | undefined;
+  end_date?: string | undefined;
+  entity_id?: string | undefined;
+  entity_type?: AddonAssociationEntityType | undefined;
+  environment_id?: string | undefined;
+  id?: string | undefined;
+  invoice?: InvoiceResponse | undefined;
+  metadata?: { [k: string]: any } | undefined;
+  start_date?: string | undefined;
+  status?: Status | undefined;
+  tenant_id?: string | undefined;
+  updated_at?: string | undefined;
+  updated_by?: string | undefined;
+};
+
+export const AddAddonToSubscriptionResponse$zodSchema: z.ZodType<
+  AddAddonToSubscriptionResponse
+> = z.object({
+  addon_id: z.string().optional(),
+  addon_status: AddonStatus$zodSchema.optional(),
+  cancellation_reason: z.string().optional(),
+  cancelled_at: z.iso.datetime({ offset: true }).optional(),
+  checkout_session: CheckoutSessionResponse$zodSchema.optional(),
+  created_at: z.iso.datetime({ offset: true }).optional(),
+  created_by: z.string().optional(),
+  end_date: z.iso.datetime({ offset: true }).optional(),
+  entity_id: z.string().optional(),
+  entity_type: AddonAssociationEntityType$zodSchema.optional(),
+  environment_id: z.string().optional(),
+  id: z.string().optional(),
+  invoice: InvoiceResponse$zodSchema.optional(),
+  metadata: z.record(z.string(), z.any()).optional(),
+  start_date: z.iso.datetime({ offset: true }).optional(),
+  status: Status$zodSchema.optional(),
+  tenant_id: z.string().optional(),
+  updated_at: z.iso.datetime({ offset: true }).optional(),
+  updated_by: z.string().optional(),
+});

package/src/models/addonresponse.ts

@@ -3,6 +3,10 @@
  */
 
 import * as z from "zod";
+import {
+  CreditGrantResponse,
+  CreditGrantResponse$zodSchema,
+} from "./creditgrantresponse.js";
 import {
   EntitlementResponse,
   EntitlementResponse$zodSchema,
@@ -13,6 +17,7 @@ import { Status, Status$zodSchema } from "./status.js";
 export type AddonResponse = {
   created_at?: string | undefined;
   created_by?: string | undefined;
+  credit_grants?: Array<CreditGrantResponse> | undefined;
   description?: string | undefined;
   entitlements?: Array<EntitlementResponse> | undefined;
   environment_id?: string | undefined;
@@ -30,6 +35,7 @@ export type AddonResponse = {
 export const AddonResponse$zodSchema: z.ZodType<AddonResponse> = z.object({
   created_at: z.iso.datetime({ offset: true }).optional(),
   created_by: z.string().optional(),
+  credit_grants: z.array(CreditGrantResponse$zodSchema).optional(),
   description: z.string().optional(),
   entitlements: z.array(z.lazy(() => EntitlementResponse$zodSchema)).optional(),
   environment_id: z.string().optional(),

package/src/models/addsubscriptionaddonop.ts

@@ -4,18 +4,18 @@
 
 import * as z from "zod";
 import {
-  AddonAssociationResponse,
-  AddonAssociationResponse$zodSchema,
-} from "./addonassociationresponse.js";
+  AddAddonToSubscriptionResponse,
+  AddAddonToSubscriptionResponse$zodSchema,
+} from "./addaddontosubscriptionresponse.js";
 import { ErrorResponse, ErrorResponse$zodSchema } from "./errorresponse.js";
 
 export type AddSubscriptionAddonResponse =
-  | AddonAssociationResponse
+  | AddAddonToSubscriptionResponse
   | ErrorResponse;
 
 export const AddSubscriptionAddonResponse$zodSchema: z.ZodType<
   AddSubscriptionAddonResponse
 > = z.union([
-  AddonAssociationResponse$zodSchema,
+  AddAddonToSubscriptionResponse$zodSchema,
   ErrorResponse$zodSchema,
 ]);

package/src/models/aggregatedentitlement.ts

@@ -3,12 +3,27 @@
  */
 
 import * as z from "zod";
+import {
+  AggregatedEntitlementBucket,
+  AggregatedEntitlementBucket$zodSchema,
+} from "./aggregatedentitlementbucket.js";
+import {
+  EntitlementAggregationMode,
+  EntitlementAggregationMode$zodSchema,
+} from "./entitlementaggregationmode.js";
 import {
   EntitlementUsageResetPeriod,
   EntitlementUsageResetPeriod$zodSchema,
 } from "./entitlementusageresetperiod.js";
 
+export type ConfigValue = {};
+
+export const ConfigValue$zodSchema: z.ZodType<ConfigValue> = z.object({});
+
 export type AggregatedEntitlement = {
+  aggregation_mode?: EntitlementAggregationMode | undefined;
+  buckets?: Array<AggregatedEntitlementBucket> | undefined;
+  config_values?: Array<{ [k: string]: ConfigValue }> | undefined;
   is_enabled?: boolean | undefined;
   is_soft_limit?: boolean | undefined;
   static_values?: Array<string> | undefined;
@@ -18,11 +33,14 @@ export type AggregatedEntitlement = {
 
 export const AggregatedEntitlement$zodSchema: z.ZodType<AggregatedEntitlement> =
   z.object({
+    aggregation_mode: EntitlementAggregationMode$zodSchema.optional(),
+    buckets: z.array(AggregatedEntitlementBucket$zodSchema).optional(),
+    config_values: z.array(
+      z.record(z.string(), z.lazy(() => ConfigValue$zodSchema)),
+    ).optional(),
     is_enabled: z.boolean().optional(),
     is_soft_limit: z.boolean().optional(),
-    static_values: z.array(z.string()).optional().describe(
-      "For static/SLA features",
-    ),
+    static_values: z.array(z.string()).optional(),
     usage_limit: z.int().optional(),
     usage_reset_period: EntitlementUsageResetPeriod$zodSchema.optional(),
   });

package/src/models/aggregatedentitlementbucket.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  EntitlementGrantDurationUnit,
+  EntitlementGrantDurationUnit$zodSchema,
+} from "./entitlementgrantdurationunit.js";
+import {
+  EntitlementGrantMeasure,
+  EntitlementGrantMeasure$zodSchema,
+} from "./entitlementgrantmeasure.js";
+
+export type AggregatedEntitlementBucket = {
+  entitlement_id?: string | undefined;
+  grant_duration_unit?: EntitlementGrantDurationUnit | undefined;
+  grant_duration_value?: number | undefined;
+  grant_measure?: EntitlementGrantMeasure | undefined;
+  grant_quota?: string | undefined;
+  source_entity_id?: string | undefined;
+  usage_limit?: number | undefined;
+};
+
+export const AggregatedEntitlementBucket$zodSchema: z.ZodType<
+  AggregatedEntitlementBucket
+> = z.object({
+  entitlement_id: z.string().optional(),
+  grant_duration_unit: EntitlementGrantDurationUnit$zodSchema.optional(),
+  grant_duration_value: z.int().optional(),
+  grant_measure: EntitlementGrantMeasure$zodSchema.optional(),
+  grant_quota: z.string().optional(),
+  source_entity_id: z.string().optional(),
+  usage_limit: z.int().optional(),
+});

package/src/models/alertthreshold.ts

@@ -7,10 +7,10 @@ import { AlertCondition, AlertCondition$zodSchema } from "./alertcondition.js";
 
 export type AlertThreshold = {
   condition?: AlertCondition | undefined;
-  threshold?: number | undefined;
+  threshold?: string | undefined;
 };
 
 export const AlertThreshold$zodSchema: z.ZodType<AlertThreshold> = z.object({
   condition: AlertCondition$zodSchema.optional(),
-  threshold: z.number().optional(),
+  threshold: z.string().optional(),
 });

package/src/models/autotopup.ts

@@ -3,9 +3,22 @@
  */
 
 import * as z from "zod";
+import { DurationUnit, DurationUnit$zodSchema } from "./durationunit.js";
+
+export type AutoTopupDuration = {
+  unit?: DurationUnit | undefined;
+  value?: number | undefined;
+};
+
+export const AutoTopupDuration$zodSchema: z.ZodType<AutoTopupDuration> = z
+  .object({
+    unit: DurationUnit$zodSchema.optional(),
+    value: z.int().optional(),
+  });
 
 export type AutoTopup = {
   amount?: number | undefined;
+  cooldown?: AutoTopupDuration | undefined;
   enabled?: boolean | undefined;
   invoicing?: boolean | undefined;
   threshold?: number | undefined;
@@ -13,6 +26,7 @@ export type AutoTopup = {
 
 export const AutoTopup$zodSchema: z.ZodType<AutoTopup> = z.object({
   amount: z.number().optional(),
+  cooldown: z.lazy(() => AutoTopupDuration$zodSchema).optional(),
   enabled: z.boolean().optional(),
   invoicing: z.boolean().optional(),
   threshold: z.number().optional(),

package/src/models/checkoutaction.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const CheckoutAction = {
+  CreateSubscription: "create_subscription",
+  ModifySubscription: "modify_subscription",
+  WalletTopup: "wallet_topup",
+  AddAddon: "add_addon",
+} as const;
+export type CheckoutAction = ClosedEnum<typeof CheckoutAction>;
+
+export const CheckoutAction$zodSchema = z.enum([
+  "create_subscription",
+  "modify_subscription",
+  "wallet_topup",
+  "add_addon",
+]);

package/src/models/checkoutjsonbcheckoutconfiguration.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { AddAddonParams, AddAddonParams$zodSchema } from "./addaddonparams.js";
+import {
+  CreateSubscriptionParams,
+  CreateSubscriptionParams$zodSchema,
+} from "./createsubscriptionparams.js";
+import {
+  ModifySubscriptionParams,
+  ModifySubscriptionParams$zodSchema,
+} from "./modifysubscriptionparams.js";
+import {
+  WalletTopupParams,
+  WalletTopupParams$zodSchema,
+} from "./wallettopupparams.js";
+
+export type CheckoutJSONBCheckoutConfiguration = {
+  add_addon_params?: AddAddonParams | undefined;
+  create_subscription_params?: CreateSubscriptionParams | undefined;
+  modify_subscription_params?: ModifySubscriptionParams | undefined;
+  wallet_topup_params?: WalletTopupParams | undefined;
+};
+
+export const CheckoutJSONBCheckoutConfiguration$zodSchema: z.ZodType<
+  CheckoutJSONBCheckoutConfiguration
+> = z.object({
+  add_addon_params: AddAddonParams$zodSchema.optional(),
+  create_subscription_params: CreateSubscriptionParams$zodSchema.optional(),
+  modify_subscription_params: ModifySubscriptionParams$zodSchema.optional(),
+  wallet_topup_params: WalletTopupParams$zodSchema.optional(),
+});

package/src/models/checkoutjsonbcheckoutpaymentproviderconfig.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CollectionMethod,
+  CollectionMethod$zodSchema,
+} from "./collectionmethod.js";
+import {
+  PaymentMethodType,
+  PaymentMethodType$zodSchema,
+} from "./paymentmethodtype.js";
+
+export type CheckoutJSONBCheckoutPaymentProviderConfig = {
+  collection_method?: CollectionMethod | undefined;
+  max_mandate_limit?: string | undefined;
+  payment_method?: PaymentMethodType | undefined;
+};
+
+export const CheckoutJSONBCheckoutPaymentProviderConfig$zodSchema: z.ZodType<
+  CheckoutJSONBCheckoutPaymentProviderConfig
+> = z.object({
+  collection_method: CollectionMethod$zodSchema.optional(),
+  max_mandate_limit: z.string().optional(),
+  payment_method: PaymentMethodType$zodSchema.optional(),
+});

package/src/models/checkoutjsonbcheckoutproviderresult.ts

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { PaymentAction, PaymentAction$zodSchema } from "./paymentaction.js";
+
+export type CheckoutJSONBCheckoutProviderResult = {
+  expires_at?: string | undefined;
+  next_action?: PaymentAction | undefined;
+  provider_metadata?: { [k: string]: string } | undefined;
+  provider_payment_intent_id?: string | undefined;
+  provider_session_id?: string | undefined;
+};
+
+export const CheckoutJSONBCheckoutProviderResult$zodSchema: z.ZodType<
+  CheckoutJSONBCheckoutProviderResult
+> = z.object({
+  expires_at: z.iso.datetime({ offset: true }).optional().describe(
+    "ExpiresAt is the provider URL expiry. When set and earlier than the session expiry,\nexecuteCheckoutAction tightens the session expiry to match.",
+  ),
+  next_action: PaymentAction$zodSchema.optional(),
+  provider_metadata: z.record(z.string(), z.string()).optional().describe(
+    "ProviderMetadata holds provider-specific data not needed for business logic.",
+  ),
+  provider_payment_intent_id: z.string().optional().describe(
+    "ProviderPaymentIntentID is the provider-side charge/intent ID.\nStripe returns this at link creation (pi_xxx); others populate it from the webhook payload.",
+  ),
+  provider_session_id: z.string().optional().describe(
+    "ProviderSessionID is stored in EntityIntegrationMapping at link creation.\n  Stripe:   Checkout Session ID  (cs_xxx)\n  Razorpay: Payment Link ID      (plink_xxx)\n  Nomod:    Payment Link ID      (NOTE: webhook uses Charge ID; look up by PaymentLinkID field)\n  Moyasar:  Payment ID",
+  ),
+});

package/src/models/checkoutjsonbcheckoutresult.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CreateSubscriptionResult,
+  CreateSubscriptionResult$zodSchema,
+} from "./createsubscriptionresult.js";
+
+export type CheckoutJSONBCheckoutResult = {
+  create_subscription_result?: CreateSubscriptionResult | undefined;
+};
+
+export const CheckoutJSONBCheckoutResult$zodSchema: z.ZodType<
+  CheckoutJSONBCheckoutResult
+> = z.object({
+  create_subscription_result: CreateSubscriptionResult$zodSchema.optional(),
+});

package/src/models/checkoutparams.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  CheckoutPaymentProvider,
+  CheckoutPaymentProvider$zodSchema,
+} from "./checkoutpaymentprovider.js";
+import {
+  CheckoutPaymentProviderConfig,
+  CheckoutPaymentProviderConfig$zodSchema,
+} from "./checkoutpaymentproviderconfig.js";
+
+export type CheckoutParams = {
+  cancel_url?: string | undefined;
+  failure_url?: string | undefined;
+  idempotency_key?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  payment_provider: CheckoutPaymentProvider;
+  payment_provider_config?: CheckoutPaymentProviderConfig | undefined;
+  success_url?: string | undefined;
+};
+
+export const CheckoutParams$zodSchema: z.ZodType<CheckoutParams> = z.object({
+  cancel_url: z.string().optional(),
+  failure_url: z.string().optional(),
+  idempotency_key: z.string().optional(),
+  metadata: z.record(z.string(), z.string()).optional(),
+  payment_provider: CheckoutPaymentProvider$zodSchema,
+  payment_provider_config: CheckoutPaymentProviderConfig$zodSchema.optional(),
+  success_url: z.string().optional(),
+});