@paygentic/sdk 0.9.13 → 0.9.15

package/src/models/editsubscriptionintervalsresponse.ts

@@ -0,0 +1,96 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  SubscriptionInterval,
+  SubscriptionInterval$inboundSchema,
+} from "./subscriptioninterval.js";
+import {
+  SubscriptionIntervalChange,
+  SubscriptionIntervalChange$inboundSchema,
+} from "./subscriptionintervalchange.js";
+
+export type EditSubscriptionIntervalsResponseLineItems = {
+  /**
+   * Number of distinct prices that gained a line item as this timeline edit was re-derived into billing.
+   */
+  created: number;
+  /**
+   * Number of distinct prices whose future/uninvoiced line items were removed as this timeline edit was re-derived into billing.
+   */
+  removed: number;
+  /**
+   * True when the timeline edit was saved but the line-item re-derive failed. The edit is not rolled back, and the re-derive is retried automatically. Resubmitting the same request retries it sooner.
+   */
+  syncFailed?: boolean | undefined;
+};
+
+export type EditSubscriptionIntervalsResponse = {
+  /**
+   * The timeline's effective price intervals after applying the op set, ordered by start date.
+   */
+  intervals: Array<SubscriptionInterval>;
+  /**
+   * True when the op set resolved to no change and nothing was written.
+   */
+  unchanged: boolean;
+  lineItems: EditSubscriptionIntervalsResponseLineItems;
+  /**
+   * The record this edit wrote. Null when the edit changed nothing.
+   */
+  intervalChange: SubscriptionIntervalChange | null;
+};
+
+/** @internal */
+export const EditSubscriptionIntervalsResponseLineItems$inboundSchema:
+  z.ZodType<EditSubscriptionIntervalsResponseLineItems, z.ZodTypeDef, unknown> =
+    z.object({
+      created: z.number().int(),
+      removed: z.number().int(),
+      syncFailed: z.boolean().optional(),
+    });
+
+export function editSubscriptionIntervalsResponseLineItemsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  EditSubscriptionIntervalsResponseLineItems,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      EditSubscriptionIntervalsResponseLineItems$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'EditSubscriptionIntervalsResponseLineItems' from JSON`,
+  );
+}
+
+/** @internal */
+export const EditSubscriptionIntervalsResponse$inboundSchema: z.ZodType<
+  EditSubscriptionIntervalsResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  intervals: z.array(SubscriptionInterval$inboundSchema),
+  unchanged: z.boolean(),
+  lineItems: z.lazy(() =>
+    EditSubscriptionIntervalsResponseLineItems$inboundSchema
+  ),
+  intervalChange: z.nullable(SubscriptionIntervalChange$inboundSchema),
+});
+
+export function editSubscriptionIntervalsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<EditSubscriptionIntervalsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EditSubscriptionIntervalsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EditSubscriptionIntervalsResponse' from JSON`,
+  );
+}

package/src/models/index.ts

@@ -9,6 +9,7 @@ export * from "./billablemetric.js";
 export * from "./billingschedule.js";
 export * from "./booleanentitlementdetail.js";
 export * from "./booleanentitlementlistitem.js";
+export * from "./changereason.js";
 export * from "./cost.js";
 export * from "./costreportgroup.js";
 export * from "./costreportresponse.js";
@@ -30,6 +31,8 @@ export * from "./createusagediscountadjustment.js";
 export * from "./currencybreakdownentry.js";
 export * from "./customer.js";
 export * from "./customerpaymentsession.js";
+export * from "./editsubscriptionintervalsrequestunion.js";
+export * from "./editsubscriptionintervalsresponse.js";
 export * from "./entitlementdetail.js";
 export * from "./entitlementlistitem.js";
 export * from "./entitlementstatus.js";
@@ -42,6 +45,7 @@ export * from "./fee.js";
 export * from "./grant.js";
 export * from "./groupinvoicesummary.js";
 export * from "./grouptrendentry.js";
+export * from "./intervalchangemetadata.js";
 export * from "./invoice.js";
 export * from "./invoicecategorysummary.js";
 export * from "./invoicelineitem.js";
@@ -93,7 +97,6 @@ export * from "./pricetax.js";
 export * from "./product.js";
 export * from "./profitabilityrow.js";
 export * from "./profitabilitysummaryresponse.js";
-export * from "./profitabilitytrend.js";
 export * from "./purchasegrantrequest.js";
 export * from "./purchasegrantresponse.js";
 export * from "./ratetype.js";
@@ -117,9 +120,19 @@ export * from "./staticentitlementlistitem.js";
 export * from "./subscription.js";
 export * from "./subscriptionadjustment.js";
 export * from "./subscriptionadjustmentsresponse.js";
+export * from "./subscriptioninterval.js";
+export * from "./subscriptionintervaladdop.js";
+export * from "./subscriptionintervalchange.js";
+export * from "./subscriptionintervalchangecopy.js";
+export * from "./subscriptionintervalchangeentry.js";
+export * from "./subscriptionintervalchangesresponse.js";
+export * from "./subscriptionintervaleditop.js";
+export * from "./subscriptionintervalremoveop.js";
+export * from "./subscriptionintervalsresponse.js";
 export * from "./subscriptionmetadata.js";
 export * from "./subscriptionportal.js";
 export * from "./subscriptionreconciliation.js";
+export * from "./subscriptionversionpolicy.js";
 export * from "./testclock.js";
 export * from "./transitionplanversionrequest.js";
 export * from "./updateapprovalrequest.js";

package/src/models/intervalchangemetadata.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type IntervalChangeMetadata = string | number | boolean;
+
+/** @internal */
+export const IntervalChangeMetadata$inboundSchema: z.ZodType<
+  IntervalChangeMetadata,
+  z.ZodTypeDef,
+  unknown
+> = z.union([z.string(), z.number(), z.boolean()]);
+/** @internal */
+export type IntervalChangeMetadata$Outbound = string | number | boolean;
+
+/** @internal */
+export const IntervalChangeMetadata$outboundSchema: z.ZodType<
+  IntervalChangeMetadata$Outbound,
+  z.ZodTypeDef,
+  IntervalChangeMetadata
+> = z.union([z.string(), z.number(), z.boolean()]);
+
+export function intervalChangeMetadataToJSON(
+  intervalChangeMetadata: IntervalChangeMetadata,
+): string {
+  return JSON.stringify(
+    IntervalChangeMetadata$outboundSchema.parse(intervalChangeMetadata),
+  );
+}
+export function intervalChangeMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<IntervalChangeMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IntervalChangeMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IntervalChangeMetadata' from JSON`,
+  );
+}

package/src/models/invoice.ts

@@ -210,6 +210,10 @@ export type Invoice = {
    * When the invoice was paid (null if not yet paid)
    */
   paidAt?: Date | null | undefined;
+  /**
+   * When the invoice was issued, in the subscription's effective time (test-clock time on a test clock). Revenue and profitability windows count the invoice by this instant. Null until the invoice is issued.
+   */
+  issuedAt?: Date | null | undefined;
   /**
    * Payment due date snapshotted at invoice-create time as the issue date + subscription.paymentTermDays, anchored to midnight UTC. Null only for invoices created before this feature shipped (no backfill).
    */
@@ -381,6 +385,9 @@ export const Invoice$inboundSchema: z.ZodType<Invoice, z.ZodTypeDef, unknown> =
     paidAt: z.nullable(
       z.string().datetime({ offset: true }).transform(v => new Date(v)),
     ).optional(),
+    issuedAt: z.nullable(
+      z.string().datetime({ offset: true }).transform(v => new Date(v)),
+    ).optional(),
     dueAt: z.nullable(
       z.string().datetime({ offset: true }).transform(v => new Date(v)),
     ).optional(),

package/src/models/operations/createsubscription.ts

@@ -117,10 +117,26 @@ export type CreateSubscriptionRequest = {
    * Number of minutes until the payment session expires. Defaults to 240 minutes (4 hours) if not provided.
    */
   sessionExpiryMinutes?: number | undefined;
+  /**
+   * How the subscription follows new versions of its plan. `floating` follows the plan's default version: when the default changes, the subscription bills from the new default from its next billing period. `pinned` keeps the plan version that the subscription holds. A subscription created without a value is `floating`. A change to this value does not change a billing period that has already started.
+   */
+  versionPolicy?: models.SubscriptionVersionPolicy | undefined;
   /**
    * Free-form merchant metadata to attach to the subscription. Values must be strings, numbers, or booleans.
    */
   metadata?: { [k: string]: models.SubscriptionMetadata } | undefined;
+  /**
+   * Why a change was made. `correction` fixes data to match what was agreed; `migration` moves a contract from another system; `commercial` is a real change to the deal. Defaults to `unspecified`.
+   */
+  changeReason?: models.ChangeReason | undefined;
+  /**
+   * A free-text note on why these intervals are changing.
+   */
+  changeDescription?: string | undefined;
+  /**
+   * Your own key-value data about the change, such as a CRM deal ID.
+   */
+  changeMetadata?: { [k: string]: models.IntervalChangeMetadata } | undefined;
 };
 
 /** @internal */
@@ -215,7 +231,13 @@ export type CreateSubscriptionRequest$Outbound = {
   renewalReminderDays?: number | null | undefined;
   paymentTermDays?: number | undefined;
   sessionExpiryMinutes?: number | undefined;
+  versionPolicy?: string | undefined;
   metadata?: { [k: string]: models.SubscriptionMetadata$Outbound } | undefined;
+  changeReason?: string | undefined;
+  changeDescription?: string | undefined;
+  changeMetadata?:
+    | { [k: string]: models.IntervalChangeMetadata$Outbound }
+    | undefined;
 };
 
 /** @internal */
@@ -240,7 +262,12 @@ export const CreateSubscriptionRequest$outboundSchema: z.ZodType<
   renewalReminderDays: z.nullable(z.number().int()).optional(),
   paymentTermDays: z.number().int().optional(),
   sessionExpiryMinutes: z.number().optional(),
+  versionPolicy: models.SubscriptionVersionPolicy$outboundSchema.optional(),
   metadata: z.record(models.SubscriptionMetadata$outboundSchema).optional(),
+  changeReason: models.ChangeReason$outboundSchema.optional(),
+  changeDescription: z.string().optional(),
+  changeMetadata: z.record(models.IntervalChangeMetadata$outboundSchema)
+    .optional(),
 });
 
 export function createSubscriptionRequestToJSON(

package/src/models/operations/editsubscriptionintervals.ts

@@ -0,0 +1,48 @@
+/*
+ * 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 EditSubscriptionIntervalsRequest = {
+  /**
+   * The subscription ID
+   */
+  id: string;
+  editSubscriptionIntervalsRequest:
+    models.EditSubscriptionIntervalsRequestUnion;
+};
+
+/** @internal */
+export type EditSubscriptionIntervalsRequest$Outbound = {
+  id: string;
+  EditSubscriptionIntervalsRequest:
+    models.EditSubscriptionIntervalsRequestUnion$Outbound;
+};
+
+/** @internal */
+export const EditSubscriptionIntervalsRequest$outboundSchema: z.ZodType<
+  EditSubscriptionIntervalsRequest$Outbound,
+  z.ZodTypeDef,
+  EditSubscriptionIntervalsRequest
+> = z.object({
+  id: z.string(),
+  editSubscriptionIntervalsRequest:
+    models.EditSubscriptionIntervalsRequestUnion$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    editSubscriptionIntervalsRequest: "EditSubscriptionIntervalsRequest",
+  });
+});
+
+export function editSubscriptionIntervalsRequestToJSON(
+  editSubscriptionIntervalsRequest: EditSubscriptionIntervalsRequest,
+): string {
+  return JSON.stringify(
+    EditSubscriptionIntervalsRequest$outboundSchema.parse(
+      editSubscriptionIntervalsRequest,
+    ),
+  );
+}

package/src/models/operations/getcostreport.ts

@@ -81,6 +81,10 @@ export type GetCostReportRequest = {
    * When true, include prior-period comparison data in each group.
    */
   comparePriorPeriod?: boolean | undefined;
+  /**
+   * When true, leave out groups with neither cost nor usage in the period. They are dropped before ranking, so they take no top-N slot, do not appear in the 'Other' bucket and are not counted in `pagination.total`. `emptyGroupCount` says how many were left out.
+   */
+  excludeEmpty?: boolean | undefined;
   /**
    * Time window granularity for the time-series breakdown.
    */
@@ -132,6 +136,7 @@ export type GetCostReportRequest$Outbound = {
   filterGroupBy?: string | undefined;
   topN: number;
   comparePriorPeriod: boolean;
+  excludeEmpty: boolean;
   windowSize?: string | undefined;
   sort: string;
   sortDir: string;
@@ -155,6 +160,7 @@ export const GetCostReportRequest$outboundSchema: z.ZodType<
   filterGroupBy: z.string().optional(),
   topN: z.number().int().default(9),
   comparePriorPeriod: z.boolean().default(false),
+  excludeEmpty: z.boolean().default(false),
   windowSize: GetCostReportWindowSize$outboundSchema.optional(),
   sort: Sort$outboundSchema.default("totalCost"),
   sortDir: SortDir$outboundSchema.default("desc"),

package/src/models/operations/getprofitability.ts

@@ -3,22 +3,6 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../../types/enums.js";
-
-/**
- * Time bucket granularity for the per-customer revenue trend. When omitted, the server picks a reasonable bucket from the window length.
- */
-export const GetProfitabilityBucketWidth = {
-  Hour: "hour",
-  Day: "day",
-  Week: "week",
-} as const;
-/**
- * Time bucket granularity for the per-customer revenue trend. When omitted, the server picks a reasonable bucket from the window length.
- */
-export type GetProfitabilityBucketWidth = ClosedEnum<
-  typeof GetProfitabilityBucketWidth
->;
 
 export type GetProfitabilityRequest = {
   /**
@@ -42,16 +26,15 @@ export type GetProfitabilityRequest = {
    */
   currency?: string | undefined;
   /**
-   * Time bucket granularity for the per-customer revenue trend. When omitted, the server picks a reasonable bucket from the window length.
+   * When true, leave customers with neither revenue nor cost in the period out of `rows`. They are dropped before ranking, so they take no top-N slot and are not folded into the 'Other' row. `emptyCustomerCount` says how many there are either way.
    */
-  bucketWidth?: GetProfitabilityBucketWidth | undefined;
+  excludeEmpty?: boolean | undefined;
+  /**
+   * When true, also return in `emptyCustomers` the customers counted in `emptyCustomerCount` that `rows` does not carry, so a caller can show the complete customer list.
+   */
+  includeEmpty?: boolean | undefined;
 };
 
-/** @internal */
-export const GetProfitabilityBucketWidth$outboundSchema: z.ZodNativeEnum<
-  typeof GetProfitabilityBucketWidth
-> = z.nativeEnum(GetProfitabilityBucketWidth);
-
 /** @internal */
 export type GetProfitabilityRequest$Outbound = {
   merchantId: string;
@@ -59,7 +42,8 @@ export type GetProfitabilityRequest$Outbound = {
   to: string;
   topN: number;
   currency?: string | undefined;
-  bucketWidth: string;
+  excludeEmpty: boolean;
+  includeEmpty: boolean;
 };
 
 /** @internal */
@@ -73,7 +57,8 @@ export const GetProfitabilityRequest$outboundSchema: z.ZodType<
   to: z.date().transform(v => v.toISOString()),
   topN: z.number().int().default(10),
   currency: z.string().optional(),
-  bucketWidth: GetProfitabilityBucketWidth$outboundSchema.default("day"),
+  excludeEmpty: z.boolean().default(false),
+  includeEmpty: z.boolean().default(false),
 });
 
 export function getProfitabilityRequestToJSON(

package/src/models/operations/getrevenue.ts

@@ -31,6 +31,18 @@ export const GroupBy = {
  */
 export type GroupBy = ClosedEnum<typeof GroupBy>;
 
+/**
+ * Which date places revenue inside the window. 'issued' (default) counts whole invoices by their issue date, the basis revenue is recognised on. 'billingPeriod' counts invoice lines by the start of the period each line bills, so a window covering one billing period returns that period's charges, whichever invoices carry them: this month's advance fee and this month's arrears usage. Paid, outstanding and written-off follow each line's invoice; a refund splits across its invoice's lines by subtotal; payments not tied to an invoice are excluded because they bill no period.
+ */
+export const PeriodBasis = {
+  Issued: "issued",
+  BillingPeriod: "billingPeriod",
+} as const;
+/**
+ * Which date places revenue inside the window. 'issued' (default) counts whole invoices by their issue date, the basis revenue is recognised on. 'billingPeriod' counts invoice lines by the start of the period each line bills, so a window covering one billing period returns that period's charges, whichever invoices carry them: this month's advance fee and this month's arrears usage. Paid, outstanding and written-off follow each line's invoice; a refund splits across its invoice's lines by subtotal; payments not tied to an invoice are excluded because they bill no period.
+ */
+export type PeriodBasis = ClosedEnum<typeof PeriodBasis>;
+
 export type GetRevenueRequest = {
   /**
    * Start of the time range (ISO 8601 format)
@@ -64,6 +76,10 @@ export type GetRevenueRequest = {
    * Group invoice data by dimension. Allowed values: 'plan' (max 5 groups, top 4 + 'other' when exceeding), 'customer' (max 25 groups, top 24 + 'other' when exceeding, sorted by revenue descending), 'currency' (one entry per currency, primary currency first then alphabetical). Note: groupBy values are mutually exclusive — combining them returns a 400 error. When groupBy=currency is active, top-level netRevenue, invoices, and payments fields are omitted; currencyBreakdown is the sole data source.
    */
   groupBy?: GroupBy | undefined;
+  /**
+   * Which date places revenue inside the window. 'issued' (default) counts whole invoices by their issue date, the basis revenue is recognised on. 'billingPeriod' counts invoice lines by the start of the period each line bills, so a window covering one billing period returns that period's charges, whichever invoices carry them: this month's advance fee and this month's arrears usage. Paid, outstanding and written-off follow each line's invoice; a refund splits across its invoice's lines by subtotal; payments not tied to an invoice are excluded because they bill no period.
+   */
+  periodBasis?: PeriodBasis | undefined;
 };
 
 /** @internal */
@@ -75,6 +91,10 @@ export const GetRevenueBucketWidth$outboundSchema: z.ZodNativeEnum<
 export const GroupBy$outboundSchema: z.ZodNativeEnum<typeof GroupBy> = z
   .nativeEnum(GroupBy);
 
+/** @internal */
+export const PeriodBasis$outboundSchema: z.ZodNativeEnum<typeof PeriodBasis> = z
+  .nativeEnum(PeriodBasis);
+
 /** @internal */
 export type GetRevenueRequest$Outbound = {
   startTime: string;
@@ -85,6 +105,7 @@ export type GetRevenueRequest$Outbound = {
   subscriptionIds?: Array<string> | undefined;
   currency?: string | undefined;
   groupBy?: string | undefined;
+  periodBasis: string;
 };
 
 /** @internal */
@@ -101,6 +122,7 @@ export const GetRevenueRequest$outboundSchema: z.ZodType<
   subscriptionIds: z.array(z.string()).optional(),
   currency: z.string().optional(),
   groupBy: GroupBy$outboundSchema.optional(),
+  periodBasis: PeriodBasis$outboundSchema.default("issued"),
 });
 
 export function getRevenueRequestToJSON(

package/src/models/operations/getsubscriptionintervals.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type GetSubscriptionIntervalsRequest = {
+  /**
+   * The subscription ID
+   */
+  id: string;
+};
+
+/** @internal */
+export type GetSubscriptionIntervalsRequest$Outbound = {
+  id: string;
+};
+
+/** @internal */
+export const GetSubscriptionIntervalsRequest$outboundSchema: z.ZodType<
+  GetSubscriptionIntervalsRequest$Outbound,
+  z.ZodTypeDef,
+  GetSubscriptionIntervalsRequest
+> = z.object({
+  id: z.string(),
+});
+
+export function getSubscriptionIntervalsRequestToJSON(
+  getSubscriptionIntervalsRequest: GetSubscriptionIntervalsRequest,
+): string {
+  return JSON.stringify(
+    GetSubscriptionIntervalsRequest$outboundSchema.parse(
+      getSubscriptionIntervalsRequest,
+    ),
+  );
+}

package/src/models/operations/index.ts

@@ -41,6 +41,7 @@ export * from "./deletesubscriptionadjustment.js";
 export * from "./deletetestclock.js";
 export * from "./disconnectmerchantintegration.js";
 export * from "./downloadinvoicepdf.js";
+export * from "./editsubscriptionintervals.js";
 export * from "./generateportallink.js";
 export * from "./generatescheduleinvoices.js";
 export * from "./getapproval.js";
@@ -71,6 +72,7 @@ export * from "./getrevenue.js";
 export * from "./getsource.js";
 export * from "./getsourcerule.js";
 export * from "./getsubscription.js";
+export * from "./getsubscriptionintervals.js";
 export * from "./gettestclock.js";
 export * from "./getuser.js";
 export * from "./ingestevent.js";
@@ -87,6 +89,7 @@ export * from "./listentitlements.js";
 export * from "./listexternalreferences.js";
 export * from "./listfeatures.js";
 export * from "./listfees.js";
+export * from "./listintervalchanges.js";
 export * from "./listinvoicerefunds.js";
 export * from "./listinvoices.js";
 export * from "./listitems.js";
@@ -106,6 +109,7 @@ export * from "./listsourceevents.js";
 export * from "./listsourcerules.js";
 export * from "./listsources.js";
 export * from "./listsubscriptionadjustments.js";
+export * from "./listsubscriptionintervalchanges.js";
 export * from "./listsubscriptions.js";
 export * from "./listtestclocks.js";
 export * from "./mintplanversion.js";

package/src/models/operations/listintervalchanges.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import * as models from "../index.js";
+
+export type ListIntervalChangesRequest = {
+  /**
+   * Number of interval changes to return
+   */
+  limit?: string | undefined;
+  /**
+   * Number of interval changes to skip
+   */
+  offset?: string | undefined;
+  /**
+   * Only return changes recorded at or after this time
+   */
+  from?: Date | undefined;
+  /**
+   * Only return changes recorded before this time
+   */
+  to?: Date | undefined;
+  /**
+   * Only return changes with this reason.
+   */
+  changeReason?: models.ChangeReason | undefined;
+};
+
+/** @internal */
+export type ListIntervalChangesRequest$Outbound = {
+  limit: string;
+  offset: string;
+  from?: string | undefined;
+  to?: string | undefined;
+  changeReason?: string | undefined;
+};
+
+/** @internal */
+export const ListIntervalChangesRequest$outboundSchema: z.ZodType<
+  ListIntervalChangesRequest$Outbound,
+  z.ZodTypeDef,
+  ListIntervalChangesRequest
+> = z.object({
+  limit: z.string().default("10"),
+  offset: z.string().default("0"),
+  from: z.date().transform(v => v.toISOString()).optional(),
+  to: z.date().transform(v => v.toISOString()).optional(),
+  changeReason: models.ChangeReason$outboundSchema.optional(),
+});
+
+export function listIntervalChangesRequestToJSON(
+  listIntervalChangesRequest: ListIntervalChangesRequest,
+): string {
+  return JSON.stringify(
+    ListIntervalChangesRequest$outboundSchema.parse(listIntervalChangesRequest),
+  );
+}

package/src/models/operations/listsubscriptionintervalchanges.ts

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type ListSubscriptionIntervalChangesRequest = {
+  /**
+   * The subscription ID
+   */
+  id: string;
+  /**
+   * Number of interval changes to return
+   */
+  limit?: string | undefined;
+  /**
+   * Number of interval changes to skip
+   */
+  offset?: string | undefined;
+};
+
+/** @internal */
+export type ListSubscriptionIntervalChangesRequest$Outbound = {
+  id: string;
+  limit: string;
+  offset: string;
+};
+
+/** @internal */
+export const ListSubscriptionIntervalChangesRequest$outboundSchema: z.ZodType<
+  ListSubscriptionIntervalChangesRequest$Outbound,
+  z.ZodTypeDef,
+  ListSubscriptionIntervalChangesRequest
+> = z.object({
+  id: z.string(),
+  limit: z.string().default("10"),
+  offset: z.string().default("0"),
+});
+
+export function listSubscriptionIntervalChangesRequestToJSON(
+  listSubscriptionIntervalChangesRequest:
+    ListSubscriptionIntervalChangesRequest,
+): string {
+  return JSON.stringify(
+    ListSubscriptionIntervalChangesRequest$outboundSchema.parse(
+      listSubscriptionIntervalChangesRequest,
+    ),
+  );
+}

package/src/models/operations/terminatesubscription.ts

@@ -4,12 +4,17 @@
 
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
+import * as models from "../index.js";
 
 export type TerminateSubscriptionRequestBody = {
   /**
    * Cancellation explanation text. Sample values: 'Customer requested cancellation', 'Payment failure', 'Service migration', 'Contract expiration'
    */
   reason: string;
+  /**
+   * Why a change was made. `correction` fixes data to match what was agreed; `migration` moves a contract from another system; `commercial` is a real change to the deal. Defaults to `unspecified`.
+   */
+  changeReason?: models.ChangeReason | undefined;
 };
 
 export type TerminateSubscriptionRequest = {
@@ -23,6 +28,7 @@ export type TerminateSubscriptionRequest = {
 /** @internal */
 export type TerminateSubscriptionRequestBody$Outbound = {
   reason: string;
+  changeReason?: string | undefined;
 };
 
 /** @internal */
@@ -32,6 +38,7 @@ export const TerminateSubscriptionRequestBody$outboundSchema: z.ZodType<
   TerminateSubscriptionRequestBody
 > = z.object({
   reason: z.string(),
+  changeReason: models.ChangeReason$outboundSchema.optional(),
 });
 
 export function terminateSubscriptionRequestBodyToJSON(