@paygentic/sdk 0.8.5 → 0.8.7

package/src/models/operations/createfee.ts

@@ -20,7 +20,11 @@ export type CreateFeeRequest = {
   /**
    * Unique identifier for a product
    */
-  productId: string;
+  productId?: string | undefined;
+  /**
+   * Unique identifier for an item
+   */
+  itemId?: string | undefined;
 };
 
 /** @internal */
@@ -28,7 +32,8 @@ export type CreateFeeRequest$Outbound = {
   name: string;
   description: string;
   merchantId: string;
-  productId: string;
+  productId?: string | undefined;
+  itemId?: string | undefined;
 };
 
 /** @internal */
@@ -40,7 +45,8 @@ export const CreateFeeRequest$outboundSchema: z.ZodType<
   name: z.string(),
   description: z.string(),
   merchantId: z.string(),
-  productId: z.string(),
+  productId: z.string().optional(),
+  itemId: z.string().optional(),
 });
 
 export function createFeeRequestToJSON(

package/src/models/operations/createitem.ts

@@ -10,6 +10,10 @@ export type CreateItemRequest = {
    * Canonical sellable name for the Item
    */
   name: string;
+  /**
+   * Unique identifier for a product
+   */
+  catalogId?: string | undefined;
   /**
    * Optional key-value metadata
    */
@@ -20,6 +24,7 @@ export type CreateItemRequest = {
 export type CreateItemRequest$Outbound = {
   merchantId: string;
   name: string;
+  catalogId?: string | undefined;
   metadata?: { [k: string]: any } | undefined;
 };
 
@@ -31,6 +36,7 @@ export const CreateItemRequest$outboundSchema: z.ZodType<
 > = z.object({
   merchantId: z.string(),
   name: z.string(),
+  catalogId: z.string().optional(),
   metadata: z.record(z.any()).optional(),
 });
 

package/src/models/operations/createplan.ts

@@ -130,6 +130,10 @@ export type CreatePlanRequest = {
    * Credit-pool funding declarations for this plan. Each entry funds a distinct pricing unit's credit pool when a subscription to this plan activates: the allocated amount is minted as a credit grant on the customer's pool for that pricing unit, once at activation, or on a recurring basis only when that allocation explicitly sets recurrencePeriod. A plan may declare zero or more allocations; no two allocations on the same plan may target the same pricingUnitId.
    */
   creditAllocations?: Array<models.PlanCreditAllocation> | undefined;
+  /**
+   * Governs price identity when a price on this plan's default version is replaced. When true (default), replacing a price at make-default keeps the original price id live (its value changes) and the superseded value is preserved under a new id. When false, the replacement price's id goes live instead and the superseded value stays under the original id.
+   */
+  stablePriceIds?: boolean | undefined;
 };
 
 /** @internal */
@@ -171,6 +175,7 @@ export type CreatePlanRequest$Outbound = {
   billingVersion: number;
   billingAnchor?: string | null | undefined;
   creditAllocations?: Array<models.PlanCreditAllocation$Outbound> | undefined;
+  stablePriceIds: boolean;
 };
 
 /** @internal */
@@ -198,6 +203,7 @@ export const CreatePlanRequest$outboundSchema: z.ZodType<
     .optional(),
   creditAllocations: z.array(models.PlanCreditAllocation$outboundSchema)
     .optional(),
+  stablePriceIds: z.boolean().default(true),
 });
 
 export function createPlanRequestToJSON(

package/src/models/operations/createsubscription.ts

@@ -78,11 +78,15 @@ export type CreateSubscriptionRequest = {
    */
   planId: string;
   /**
-   * @deprecated Use minimumAccountBalance instead. Required initial wallet deposit amount. Sample values: '200.00' requires $200 prepaid balance for metered LLM usage, '1000.00' requires $1000 prepaid credits for data processing services, '50.00' requires $50 minimum for API call consumption
+   * Deprecated. This field is ignored and has no effect.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   prefundAmount?: string | undefined;
   /**
-   * Minimum wallet balance requirement in decimal dollars (e.g., '100.00'). Can be set to '0' to disable. The system will calculate the difference between this minimum and the customer's current balance, charging only what's needed to reach the minimum. If the customer already has sufficient balance, no charge is made. Note: If the calculated charge amount is below payment processor minimums (typically $1.00), it will be automatically adjusted upward to meet the minimum requirement. Sample values: '200.00' requires minimum $200 balance for metered LLM usage, '1000.00' requires minimum $1000 balance for data processing services
+   * Deprecated. This field is ignored and has no effect.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   minimumAccountBalance?: string | undefined;
   /**

package/src/models/operations/getinvoice.ts

@@ -10,7 +10,7 @@ export type GetInvoiceRequest = {
    */
   id: string;
   /**
-   * Comma-separated list of fields to expand. Currently supports: lineItems
+   * Comma-separated list of fields to expand. Supports: lineItems, items. `items` resolves each returned line's item and its external accounting codes into an `items` collection inside the lineItems block; because those ids come from the lines, requesting `items` also expands `lineItems` on its default paging.
    */
   expand?: string | undefined;
   /**
@@ -18,9 +18,13 @@ export type GetInvoiceRequest = {
    */
   lineItemsLimit?: number | undefined;
   /**
-   * Pagination token for line items when expand=lineItems
+   * Opaque pagination token for line items when expand=lineItems, taken from a previous response's nextPageToken. Do not construct or parse this value.
    */
   lineItemsPageToken?: string | undefined;
+  /**
+   * Narrows which external references are returned per item when expand=items. Matched exactly against the provider stored on the reference (e.g. accountsiq); there is no allowlist of known providers, but the value must satisfy the same format every stored provider does, so a malformed one is rejected rather than answered with an empty result that reads as "nothing is mapped". It never removes lines or items: an item with no reference for this provider comes back with an empty list, so unmapped SKUs stay visible. Ignored when the items expansion is not requested.
+   */
+  provider?: string | undefined;
 };
 
 /** @internal */
@@ -29,6 +33,7 @@ export type GetInvoiceRequest$Outbound = {
   expand?: string | undefined;
   lineItemsLimit: number;
   lineItemsPageToken?: string | undefined;
+  provider?: string | undefined;
 };
 
 /** @internal */
@@ -41,6 +46,7 @@ export const GetInvoiceRequest$outboundSchema: z.ZodType<
   expand: z.string().optional(),
   lineItemsLimit: z.number().int().default(100),
   lineItemsPageToken: z.string().optional(),
+  provider: z.string().optional(),
 });
 
 export function getInvoiceRequestToJSON(

package/src/models/operations/getinvoicelineitems.ts

@@ -14,9 +14,17 @@ export type GetInvoiceLineItemsRequest = {
    */
   limit?: number | undefined;
   /**
-   * Token for pagination to fetch the next page of results
+   * Opaque pagination token to fetch the next page of results, taken from a previous response's nextPageToken. Do not construct or parse this value.
    */
   pageToken?: string | undefined;
+  /**
+   * Comma-separated list of fields to expand. Supports: items — resolves each returned line's item and that item's external accounting codes into an `items` collection, so a line can be translated to a GL/SKU code without a second call.
+   */
+  expand?: string | undefined;
+  /**
+   * Narrows which external references are returned per item when expand=items. Matched exactly against the provider stored on the reference (e.g. accountsiq); there is no allowlist of known providers, but the value must satisfy the same format every stored provider does, so a malformed one is rejected rather than answered with an empty result that reads as "nothing is mapped". It never removes lines or items: an item with no reference for this provider comes back with an empty list, so unmapped SKUs stay visible. Ignored when the items expansion is not requested.
+   */
+  provider?: string | undefined;
 };
 
 /** @internal */
@@ -24,6 +32,8 @@ export type GetInvoiceLineItemsRequest$Outbound = {
   id: string;
   limit: number;
   pageToken?: string | undefined;
+  expand?: string | undefined;
+  provider?: string | undefined;
 };
 
 /** @internal */
@@ -35,6 +45,8 @@ export const GetInvoiceLineItemsRequest$outboundSchema: z.ZodType<
   id: z.string(),
   limit: z.number().int().default(100),
   pageToken: z.string().optional(),
+  expand: z.string().optional(),
+  provider: z.string().optional(),
 });
 
 export function getInvoiceLineItemsRequestToJSON(

package/src/models/operations/getplanversion.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type GetPlanVersionRequest = {
+  id: string;
+  /**
+   * The version number within the plan (1-based).
+   */
+  versionNumber: number;
+};
+
+/** @internal */
+export type GetPlanVersionRequest$Outbound = {
+  id: string;
+  versionNumber: number;
+};
+
+/** @internal */
+export const GetPlanVersionRequest$outboundSchema: z.ZodType<
+  GetPlanVersionRequest$Outbound,
+  z.ZodTypeDef,
+  GetPlanVersionRequest
+> = z.object({
+  id: z.string(),
+  versionNumber: z.number().int(),
+});
+
+export function getPlanVersionRequestToJSON(
+  getPlanVersionRequest: GetPlanVersionRequest,
+): string {
+  return JSON.stringify(
+    GetPlanVersionRequest$outboundSchema.parse(getPlanVersionRequest),
+  );
+}

package/src/models/operations/index.ts

@@ -61,6 +61,7 @@ export * from "./getmerchantintegration.js";
 export * from "./getorder.js";
 export * from "./getpayment.js";
 export * from "./getplan.js";
+export * from "./getplanversion.js";
 export * from "./getprice.js";
 export * from "./getproduct.js";
 export * from "./getprofitability.js";
@@ -104,11 +105,13 @@ export * from "./listsourcerules.js";
 export * from "./listsources.js";
 export * from "./listsubscriptions.js";
 export * from "./listtestclocks.js";
+export * from "./mintplanversion.js";
 export * from "./purchaseentitlementgrant.js";
 export * from "./reconcilesubscriptionfeatures.js";
 export * from "./rejectsourceevent.js";
 export * from "./replacescheduleintervals.js";
 export * from "./terminatesubscription.js";
+export * from "./transitionplanversion.js";
 export * from "./updateapproval.js";
 export * from "./updatebillablemetric.js";
 export * from "./updatebillingschedule.js";

package/src/models/operations/listitems.ts

@@ -13,6 +13,10 @@ export type ListItemsRequest = {
    * Filter items by merchant organization id
    */
   merchantId?: string | undefined;
+  /**
+   * Filter items by the product they are filed under
+   */
+  catalogId?: string | undefined;
   /**
    * Provider whose external code to resolve (e.g. `salesforce`, `netsuite`). Must be supplied together with `externalId`.
    */
@@ -29,6 +33,10 @@ export type ListItemsRequest = {
    * Zero-based offset for pagination. In resolution mode this paginates the de-duplicated resolved Item set.
    */
   offset?: number | undefined;
+  /**
+   * Include archived items in the results. By default, archived items are omitted. This is ignored when resolving by `provider` and `externalId`, which always returns the matching item regardless of archived status.
+   */
+  includeArchived?: boolean | undefined;
 };
 
 /**
@@ -45,10 +53,12 @@ export type ListItemsResponse = {
 /** @internal */
 export type ListItemsRequest$Outbound = {
   merchantId?: string | undefined;
+  catalogId?: string | undefined;
   provider?: string | undefined;
   externalId?: string | undefined;
   limit: number;
   offset: number;
+  includeArchived: boolean;
 };
 
 /** @internal */
@@ -58,10 +68,12 @@ export const ListItemsRequest$outboundSchema: z.ZodType<
   ListItemsRequest
 > = z.object({
   merchantId: z.string().optional(),
+  catalogId: z.string().optional(),
   provider: z.string().optional(),
   externalId: z.string().optional(),
   limit: z.number().int().default(50),
   offset: z.number().int().default(0),
+  includeArchived: z.boolean().default(false),
 });
 
 export function listItemsRequestToJSON(

package/src/models/operations/listlineitems.ts

@@ -30,6 +30,14 @@ export type ListLineItemsRequest = {
    * Filter by invoice ID. When provided without subscriptionId, returns all line items for that invoice. At least one of subscriptionId or invoiceId must be provided.
    */
   invoiceId?: string | undefined;
+  /**
+   * Comma-separated list of fields to expand. Supports: items — resolves each returned line's item and that item's external accounting codes into an `items` collection, so a line can be translated to a GL/SKU code without a second call.
+   */
+  expand?: string | undefined;
+  /**
+   * Narrows which external references are returned per item when expand=items. Matched exactly against the provider stored on the reference (e.g. accountsiq); there is no allowlist of known providers, but the value must satisfy the same format every stored provider does, so a malformed one is rejected rather than answered with an empty result that reads as "nothing is mapped". It never removes lines or items: an item with no reference for this provider comes back with an empty list, so unmapped SKUs stay visible. Ignored when the items expansion is not requested.
+   */
+  provider?: string | undefined;
   /**
    * Maximum number of line items to return
    */
@@ -50,6 +58,8 @@ export type ListLineItemsRequest$Outbound = {
   subscriptionId?: string | undefined;
   status?: string | undefined;
   invoiceId?: string | undefined;
+  expand?: string | undefined;
+  provider?: string | undefined;
   limit: number;
   offset: number;
 };
@@ -63,6 +73,8 @@ export const ListLineItemsRequest$outboundSchema: z.ZodType<
   subscriptionId: z.string().optional(),
   status: ListLineItemsStatus$outboundSchema.optional(),
   invoiceId: z.string().optional(),
+  expand: z.string().optional(),
+  provider: z.string().optional(),
   limit: z.number().int().default(100),
   offset: z.number().int().default(0),
 });

package/src/models/operations/mintplanversion.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as models from "../index.js";
+
+export type MintPlanVersionRequest = {
+  id: string;
+  mintPlanVersionRequest: models.MintPlanVersionRequest;
+};
+
+/** @internal */
+export type MintPlanVersionRequest$Outbound = {
+  id: string;
+  MintPlanVersionRequest: models.MintPlanVersionRequest$Outbound;
+};
+
+/** @internal */
+export const MintPlanVersionRequest$outboundSchema: z.ZodType<
+  MintPlanVersionRequest$Outbound,
+  z.ZodTypeDef,
+  MintPlanVersionRequest
+> = z.object({
+  id: z.string(),
+  mintPlanVersionRequest: models.MintPlanVersionRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    mintPlanVersionRequest: "MintPlanVersionRequest",
+  });
+});
+
+export function mintPlanVersionRequestToJSON(
+  mintPlanVersionRequest: MintPlanVersionRequest,
+): string {
+  return JSON.stringify(
+    MintPlanVersionRequest$outboundSchema.parse(mintPlanVersionRequest),
+  );
+}

package/src/models/operations/transitionplanversion.ts

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as models from "../index.js";
+
+export type TransitionPlanVersionRequest = {
+  id: string;
+  /**
+   * The version number within the plan (1-based).
+   */
+  versionNumber: number;
+  transitionPlanVersionRequest: models.TransitionPlanVersionRequest;
+};
+
+/** @internal */
+export type TransitionPlanVersionRequest$Outbound = {
+  id: string;
+  versionNumber: number;
+  TransitionPlanVersionRequest: models.TransitionPlanVersionRequest$Outbound;
+};
+
+/** @internal */
+export const TransitionPlanVersionRequest$outboundSchema: z.ZodType<
+  TransitionPlanVersionRequest$Outbound,
+  z.ZodTypeDef,
+  TransitionPlanVersionRequest
+> = z.object({
+  id: z.string(),
+  versionNumber: z.number().int(),
+  transitionPlanVersionRequest:
+    models.TransitionPlanVersionRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    transitionPlanVersionRequest: "TransitionPlanVersionRequest",
+  });
+});
+
+export function transitionPlanVersionRequestToJSON(
+  transitionPlanVersionRequest: TransitionPlanVersionRequest,
+): string {
+  return JSON.stringify(
+    TransitionPlanVersionRequest$outboundSchema.parse(
+      transitionPlanVersionRequest,
+    ),
+  );
+}

package/src/models/operations/updatebillablemetric.ts

@@ -18,6 +18,10 @@ export type UpdateBillableMetricRequestBody = {
    * Updated measurement unit. Common examples: 'tokens', 'GB', 'requests', 'items', 'hours'
    */
   unit?: string | undefined;
+  /**
+   * Optional item tag, used to map this metric's invoice lines to an external accounting/tax identity. Send a new id to re-tag — `productId` is re-derived from that item's catalog, and an archived item is rejected. Send `null` to untag.
+   */
+  itemId?: string | null | undefined;
   /**
    * CloudEvents type for meter routing.
    */
@@ -46,6 +50,7 @@ export type UpdateBillableMetricRequestBody$Outbound = {
   description?: string | undefined;
   name?: string | undefined;
   unit?: string | undefined;
+  itemId?: string | null | undefined;
   eventType?: string | null | undefined;
   valueProperty?: string | null | undefined;
   groupBy?: { [k: string]: string } | null | undefined;
@@ -61,6 +66,7 @@ export const UpdateBillableMetricRequestBody$outboundSchema: z.ZodType<
   description: z.string().optional(),
   name: z.string().optional(),
   unit: z.string().optional(),
+  itemId: z.nullable(z.string()).optional(),
   eventType: z.nullable(z.string()).optional(),
   valueProperty: z.nullable(z.string()).optional(),
   groupBy: z.nullable(z.record(z.string())).optional(),

package/src/models/operations/updatefee.ts

@@ -14,6 +14,10 @@ export type UpdateFeeRequestBody = {
    * Updated label for the fee.
    */
   name?: string | undefined;
+  /**
+   * Optional item tag, used to map this fee's invoice lines to an external accounting/tax identity. Send a new id to re-tag — `productId` is re-derived from that item's catalog, and an archived item is rejected. Send `null` to untag.
+   */
+  itemId?: string | null | undefined;
 };
 
 export type UpdateFeeRequest = {
@@ -28,6 +32,7 @@ export type UpdateFeeRequest = {
 export type UpdateFeeRequestBody$Outbound = {
   description?: string | undefined;
   name?: string | undefined;
+  itemId?: string | null | undefined;
 };
 
 /** @internal */
@@ -38,6 +43,7 @@ export const UpdateFeeRequestBody$outboundSchema: z.ZodType<
 > = z.object({
   description: z.string().optional(),
   name: z.string().optional(),
+  itemId: z.nullable(z.string()).optional(),
 });
 
 export function updateFeeRequestBodyToJSON(

package/src/models/operations/updateitem.ts

@@ -7,6 +7,14 @@ import { remap as remap$ } from "../../lib/primitives.js";
 
 export type UpdateItemRequestBody = {
   name?: string | undefined;
+  /**
+   * The product this item belongs to.
+   */
+  catalogId?: string | null | undefined;
+  /**
+   * Set to true to retire this item from your catalog, or false to restore it. Archived items remain readable and continue to resolve on historical invoices.
+   */
+  archived?: boolean | undefined;
   metadata?: { [k: string]: any } | undefined;
 };
 
@@ -21,6 +29,8 @@ export type UpdateItemRequest = {
 /** @internal */
 export type UpdateItemRequestBody$Outbound = {
   name?: string | undefined;
+  catalogId?: string | null | undefined;
+  archived?: boolean | undefined;
   metadata?: { [k: string]: any } | undefined;
 };
 
@@ -31,6 +41,8 @@ export const UpdateItemRequestBody$outboundSchema: z.ZodType<
   UpdateItemRequestBody
 > = z.object({
   name: z.string().optional(),
+  catalogId: z.nullable(z.string()).optional(),
+  archived: z.boolean().optional(),
   metadata: z.record(z.any()).optional(),
 });
 

package/src/models/operations/updateplan.ts

@@ -103,6 +103,10 @@ export type UpdatePlanRequestBody = {
    * Credit-pool funding declarations for this plan. Each entry funds a distinct pricing unit's credit pool when a subscription to this plan activates: the allocated amount is minted as a credit grant on the customer's pool for that pricing unit, once at activation, or on a recurring basis only when that allocation explicitly sets recurrencePeriod. A plan may declare zero or more allocations; no two allocations on the same plan may target the same pricingUnitId.
    */
   creditAllocations?: Array<models.PlanCreditAllocation> | undefined;
+  /**
+   * Governs price identity when a price is replaced by minting a new plan version and making it default. When true (default), replacing a price at make-default keeps the original price id live (its value changes) and the superseded value is preserved under a new id. When false, the replacement price's id goes live instead and the superseded value stays under the original id. Has no effect on this request's own prices field: prices carried over keep their ids, but swapping one price for another there moves the plan to the new price's id rather than keeping the original live.
+   */
+  stablePriceIds?: boolean | undefined;
 };
 
 export type UpdatePlanRequest = {
@@ -143,6 +147,7 @@ export type UpdatePlanRequestBody$Outbound = {
   renewalReminderDays?: number | undefined;
   billingAnchor?: string | null | undefined;
   creditAllocations?: Array<models.PlanCreditAllocation$Outbound> | undefined;
+  stablePriceIds?: boolean | undefined;
 };
 
 /** @internal */
@@ -166,6 +171,7 @@ export const UpdatePlanRequestBody$outboundSchema: z.ZodType<
     .optional(),
   creditAllocations: z.array(models.PlanCreditAllocation$outboundSchema)
     .optional(),
+  stablePriceIds: z.boolean().optional(),
 });
 
 export function updatePlanRequestBodyToJSON(

package/src/models/operations/updatesubscription.ts

@@ -38,7 +38,9 @@ export type UpdateSubscriptionRequestBody = {
    */
   taxExempt?: boolean | undefined;
   /**
-   * Minimum wallet balance requirement in decimal dollars (e.g., '100.00'). Can be set to '0' to disable. Maximum allowed is $5,000. Contact support for higher limits. Note: If the calculated charge amount at renewal is below payment processor minimums (typically $1.00), it will be automatically adjusted upward to meet the minimum requirement. Changes apply at next renewal.
+   * Deprecated. This field is ignored and has no effect.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   minimumAccountBalance?: string | undefined;
   /**

package/src/models/plan.ts

@@ -122,6 +122,10 @@ export type Plan = {
    * Unique identifier for a plan version
    */
   defaultVersionId?: string | undefined;
+  /**
+   * Governs price identity when a price on this plan's default version is replaced. When true (default), replacing a price at make-default keeps the original price id live (its value changes) and the superseded value is preserved under a new id. When false, the replacement price's id goes live instead and the superseded value stays under the original id.
+   */
+  stablePriceIds: boolean;
 };
 
 /** @internal */
@@ -197,6 +201,7 @@ export const Plan$inboundSchema: z.ZodType<Plan, z.ZodTypeDef, unknown> = z
     ).optional(),
     creditAllocations: z.array(PlanCreditAllocation$inboundSchema).optional(),
     defaultVersionId: z.string().optional(),
+    stablePriceIds: z.boolean().default(true),
   });
 
 export function planFromJSON(

package/src/models/planversion.ts

@@ -0,0 +1,113 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  PlanVersionPriceSlot,
+  PlanVersionPriceSlot$inboundSchema,
+} from "./planversionpriceslot.js";
+
+export const PlanVersionObject = {
+  PlanVersion: "plan_version",
+} as const;
+export type PlanVersionObject = ClosedEnum<typeof PlanVersionObject>;
+
+/**
+ * Lifecycle status of the version.
+ */
+export const PlanVersionStatus = {
+  Draft: "draft",
+  Published: "published",
+  Archived: "archived",
+} as const;
+/**
+ * Lifecycle status of the version.
+ */
+export type PlanVersionStatus = ClosedEnum<typeof PlanVersionStatus>;
+
+/**
+ * A single plan version, including its price slots. Extends the list summary with the version's prices for draft review.
+ */
+export type PlanVersion = {
+  /**
+   * Unique identifier for a plan version
+   */
+  id: string;
+  object: PlanVersionObject;
+  /**
+   * Monotonic version number within the plan, starting at 1.
+   */
+  versionNumber: number;
+  /**
+   * Lifecycle status of the version.
+   */
+  status: PlanVersionStatus;
+  /**
+   * When this version was published. Absent for draft versions.
+   */
+  publishedAt?: Date | undefined;
+  /**
+   * Whether this version is the plan's current default (live) version.
+   */
+  isDefault: boolean;
+  /**
+   * Number of committed-status subscriptions pinned to this version at creation time. Not a live-billing cohort.
+   */
+  subscriptionCount: number;
+  /**
+   * Unique identifier for a plan version
+   */
+  basedOnVersionId?: string | undefined;
+  /**
+   * When this version was last modified. Optimistic-concurrency token: read this value and echo it back as an `If-Match` header on a draft-price-mutation request to reject the write (412) if the draft changed since this read.
+   */
+  updatedAt: Date;
+  /**
+   * The price slots that make up this version.
+   */
+  prices: Array<PlanVersionPriceSlot>;
+};
+
+/** @internal */
+export const PlanVersionObject$inboundSchema: z.ZodNativeEnum<
+  typeof PlanVersionObject
+> = z.nativeEnum(PlanVersionObject);
+
+/** @internal */
+export const PlanVersionStatus$inboundSchema: z.ZodNativeEnum<
+  typeof PlanVersionStatus
+> = z.nativeEnum(PlanVersionStatus);
+
+/** @internal */
+export const PlanVersion$inboundSchema: z.ZodType<
+  PlanVersion,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  object: PlanVersionObject$inboundSchema,
+  versionNumber: z.number().int(),
+  status: PlanVersionStatus$inboundSchema,
+  publishedAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  isDefault: z.boolean(),
+  subscriptionCount: z.number().int(),
+  basedOnVersionId: z.string().optional(),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  prices: z.array(PlanVersionPriceSlot$inboundSchema),
+});
+
+export function planVersionFromJSON(
+  jsonString: string,
+): SafeParseResult<PlanVersion, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PlanVersion$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PlanVersion' from JSON`,
+  );
+}