@paygentic/sdk 0.7.20 → 0.8.1

package/src/funcs/subscriptionsReconcileSubscriptionFeatures.ts

@@ -0,0 +1,184 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { PaygenticCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { PaygenticError } from "../models/errors/paygenticerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Reconcile Features
+ *
+ * @remarks
+ * Creates a reconciliation that converges a subscription's feature entitlements to its current plan. Provisions a missing entitlement (and, for metered features, its initial grant) for every plan feature the subscription does not already have; cancels the entitlement and voids the grants of any feature no longer on the plan; then synchronizes the corresponding prices' billing. An already-present feature is left unchanged. Restricted to active subscriptions billed on their plan's line-item schedule.
+ */
+export function subscriptionsReconcileSubscriptionFeatures(
+  client: PaygenticCore,
+  request: operations.ReconcileSubscriptionFeaturesRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.SubscriptionReconciliation,
+    | errors.BadRequest
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: PaygenticCore,
+  request: operations.ReconcileSubscriptionFeaturesRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.SubscriptionReconciliation,
+      | errors.BadRequest
+      | errors.ErrorT
+      | PaygenticError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.ReconcileSubscriptionFeaturesRequest$outboundSchema.parse(
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.RequestBody, { explode: true });
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/v0/subscriptions/{id}/reconciliations")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "reconcileSubscriptionFeatures",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["400", "401", "403", "404", "4XX", "500", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    models.SubscriptionReconciliation,
+    | errors.BadRequest
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json([200, 201], models.SubscriptionReconciliation$inboundSchema),
+    M.jsonErr(400, errors.BadRequest$inboundSchema),
+    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema),
+    M.jsonErr(500, errors.ErrorT$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.7.20",
+  sdkVersion: "0.8.1",
   genVersion: "2.879.13",
-  userAgent: "speakeasy-sdk/typescript 0.7.20 2.879.13 0.1.0 @paygentic/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.8.1 2.879.13 0.1.0 @paygentic/sdk",
 } as const;

package/src/models/index.ts

@@ -65,9 +65,12 @@ export * from "./paymentmethod.js";
 export * from "./paymentsession.js";
 export * from "./paymentsummary.js";
 export * from "./plan.js";
+export * from "./plancreditallocation.js";
 export * from "./price.js";
 export * from "./pricefeature.js";
 export * from "./pricefeatureinput.js";
+export * from "./pricemodel.js";
+export * from "./pricemodelinput.js";
 export * from "./pricepropertiesunion.js";
 export * from "./product.js";
 export * from "./profitabilityrow.js";
@@ -75,6 +78,10 @@ export * from "./profitabilitysummaryresponse.js";
 export * from "./profitabilitytrend.js";
 export * from "./purchasegrantrequest.js";
 export * from "./purchasegrantresponse.js";
+export * from "./reconciledfeatureadded.js";
+export * from "./reconciledfeaturefailed.js";
+export * from "./reconciledfeatureremoved.js";
+export * from "./reconciledfeatureskipped.js";
 export * from "./replacescheduleintervalsrequest.js";
 export * from "./revenuesummaryresponse.js";
 export * from "./revenuetrendbucket.js";
@@ -94,6 +101,7 @@ export * from "./staticentitlementlistitem.js";
 export * from "./subscription.js";
 export * from "./subscriptionmetadata.js";
 export * from "./subscriptionportal.js";
+export * from "./subscriptionreconciliation.js";
 export * from "./testclock.js";
 export * from "./updateapprovalrequest.js";
 export * from "./updatebillingschedulerequest.js";

package/src/models/invoice.ts

@@ -26,7 +26,7 @@ export type InvoiceObject = ClosedEnum<typeof InvoiceObject>;
 /**
  * Line items (only present if expand=lineItems query parameter is provided)
  */
-export type LineItems = {
+export type InvoiceLineItems = {
   /**
    * The invoice ID
    */
@@ -156,7 +156,7 @@ export type Invoice = {
   /**
    * Line items (only present if expand=lineItems query parameter is provided)
    */
-  lineItems?: LineItems | null | undefined;
+  lineItems?: InvoiceLineItems | null | undefined;
   /**
    * The merchant organization ID
    */
@@ -245,8 +245,8 @@ export const InvoiceObject$inboundSchema: z.ZodNativeEnum<
 > = z.nativeEnum(InvoiceObject);
 
 /** @internal */
-export const LineItems$inboundSchema: z.ZodType<
-  LineItems,
+export const InvoiceLineItems$inboundSchema: z.ZodType<
+  InvoiceLineItems,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -256,13 +256,13 @@ export const LineItems$inboundSchema: z.ZodType<
   totalCount: z.number().int(),
 });
 
-export function lineItemsFromJSON(
+export function invoiceLineItemsFromJSON(
   jsonString: string,
-): SafeParseResult<LineItems, SDKValidationError> {
+): SafeParseResult<InvoiceLineItems, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => LineItems$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'LineItems' from JSON`,
+    (x) => InvoiceLineItems$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InvoiceLineItems' from JSON`,
   );
 }
 
@@ -317,7 +317,8 @@ export const Invoice$inboundSchema: z.ZodType<Invoice, z.ZodTypeDef, unknown> =
     grandTotal: z.string(),
     invoiceNumber: z.nullable(z.string()).optional(),
     itemCount: z.number().int(),
-    lineItems: z.nullable(z.lazy(() => LineItems$inboundSchema)).optional(),
+    lineItems: z.nullable(z.lazy(() => InvoiceLineItems$inboundSchema))
+      .optional(),
     merchantId: z.string(),
     metadata: z.record(z.any()).optional(),
     nextActionAt: z.nullable(

package/src/models/meteredentitlementdetail.ts

@@ -78,23 +78,27 @@ export type MeteredEntitlementDetail = {
    */
   isSoftLimit: boolean;
   /**
-   * Remaining grant balance for the current period.
+   * Remaining balance for the current period. When `pricingUnitId` is set, this is expressed in that pricing unit's credits (a balance shared across every feature drawing the same unit); otherwise it is in the feature's native metered units.
    */
   balance: number;
   /**
-   * Total usage consumed in the current billing period.
+   * Total usage consumed in the current billing period, in the same unit as `balance` (credits when `pricingUnitId` is set, otherwise native metered units). When `pricingUnitId` is set, this is the shared-pool aggregate across every feature drawing the same unit, not usage specific to this feature.
    */
   usageInPeriod: number;
   /**
-   * Amount of usage exceeding the granted balance.
+   * Amount of usage exceeding the balance, in the same unit as `balance` (credits when `pricingUnitId` is set, otherwise native metered units).
    */
   overage: number;
   /**
-   * Start of the current usage period. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead describes the pre-activation `[subscription start, activation)` window and may be `null` when there is no associated subscription.
+   * The pricing unit this feature is denominated in when it draws a credit pool. When set, `balance`/`usageInPeriod`/`overage` are in that unit's credits and reflect a balance shared across all features on the same unit. `null` for currency-denominated features (native metered units).
+   */
+  pricingUnitId: string | null;
+  /**
+   * Start of the current usage period. These bounds describe this entitlement's own usage window (not the shared pool's), even for a pool-backed feature (`pricingUnitId` set) whose `balance` and `usageInPeriod` are shared-pool aggregates. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead describes the pre-activation `[subscription start, activation)` window and may be `null` when there is no associated subscription.
    */
   currentPeriodStart: Date | null;
   /**
-   * End of the current usage period. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead holds `activeFrom` — the end of the pre-activation `[subscription start, activation)` window.
+   * End of the current usage period. These bounds describe this entitlement's own usage window (not the shared pool's), even for a pool-backed feature (`pricingUnitId` set) whose `balance` and `usageInPeriod` are shared-pool aggregates. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead holds `activeFrom` — the end of the pre-activation `[subscription start, activation)` window.
    */
   currentPeriodEnd: Date | null;
 };
@@ -130,6 +134,7 @@ export const MeteredEntitlementDetail$inboundSchema: z.ZodType<
   balance: z.number(),
   usageInPeriod: z.number(),
   overage: z.number(),
+  pricingUnitId: z.nullable(z.string()),
   currentPeriodStart: z.nullable(
     z.string().datetime({ offset: true }).transform(v => new Date(v)),
   ),

package/src/models/meteredentitlementlistitem.ts

@@ -69,23 +69,27 @@ export type MeteredEntitlementListItem = {
    */
   isSoftLimit: boolean;
   /**
-   * Remaining grant balance for the current period.
+   * Remaining balance for the current period. When `pricingUnitId` is set, this is expressed in that pricing unit's credits (a balance shared across every feature drawing the same unit); otherwise it is in the feature's native metered units.
    */
   balance: number;
   /**
-   * Total usage consumed in the current billing period.
+   * Total usage consumed in the current billing period, in the same unit as `balance` (credits when `pricingUnitId` is set, otherwise native metered units). When `pricingUnitId` is set, this is the shared-pool aggregate across every feature drawing the same unit, not usage specific to this feature.
    */
   usageInPeriod: number;
   /**
-   * Amount of usage exceeding the granted balance.
+   * Amount of usage exceeding the balance, in the same unit as `balance` (credits when `pricingUnitId` is set, otherwise native metered units).
    */
   overage: number;
   /**
-   * Start of the current usage period. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead describes the pre-activation `[subscription start, activation)` window and may be `null` when there is no associated subscription.
+   * The pricing unit this feature is denominated in when it draws a credit pool. When set, `balance`/`usageInPeriod`/`overage` are in that unit's credits and reflect a balance shared across all features on the same unit. `null` for currency-denominated features (native metered units).
+   */
+  pricingUnitId: string | null;
+  /**
+   * Start of the current usage period. These bounds describe this entitlement's own usage window (not the shared pool's), even for a pool-backed feature (`pricingUnitId` set) whose `balance` and `usageInPeriod` are shared-pool aggregates. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead describes the pre-activation `[subscription start, activation)` window and may be `null` when there is no associated subscription.
    */
   currentPeriodStart: Date | null;
   /**
-   * End of the current usage period. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead holds `activeFrom` — the end of the pre-activation `[subscription start, activation)` window.
+   * End of the current usage period. These bounds describe this entitlement's own usage window (not the shared pool's), even for a pool-backed feature (`pricingUnitId` set) whose `balance` and `usageInPeriod` are shared-pool aggregates. Before the entitlement activates (the pre-activation "dark window", when the query time is earlier than `activeFrom`) this instead holds `activeFrom` — the end of the pre-activation `[subscription start, activation)` window.
    */
   currentPeriodEnd: Date | null;
 };
@@ -115,6 +119,7 @@ export const MeteredEntitlementListItem$inboundSchema: z.ZodType<
   balance: z.number(),
   usageInPeriod: z.number(),
   overage: z.number(),
+  pricingUnitId: z.nullable(z.string()),
   currentPeriodStart: z.nullable(
     z.string().datetime({ offset: true }).transform(v => new Date(v)),
   ),

package/src/models/operations/createplan.ts

@@ -4,6 +4,7 @@
 
 import * as z from "zod/v3";
 import { ClosedEnum } from "../../types/enums.js";
+import * as models from "../index.js";
 
 /**
  * ISO 8601 duration for the billing period. Takes precedence over billingInterval when both are provided.
@@ -49,14 +50,14 @@ export const CreatePlanTaxBehavior = {
 export type CreatePlanTaxBehavior = ClosedEnum<typeof CreatePlanTaxBehavior>;
 
 /**
- * Billing engine version. 0 = legacy fee-schedule billing (Legacy), 1 = line-item billing with metered usage support (Standard).
+ * Billing engine version. Only 1 (Standard, line-item billing with metered usage support) is accepted for new plans; omitting the field defaults to 1. 0 (Legacy, fee-schedule billing) is rejected — it exists only on plans created before this restriction.
  */
 export const BillingVersion = {
   Zero: 0,
   One: 1,
 } as const;
 /**
- * Billing engine version. 0 = legacy fee-schedule billing (Legacy), 1 = line-item billing with metered usage support (Standard).
+ * Billing engine version. Only 1 (Standard, line-item billing with metered usage support) is accepted for new plans; omitting the field defaults to 1. 0 (Legacy, fee-schedule billing) is rejected — it exists only on plans created before this restriction.
  */
 export type BillingVersion = ClosedEnum<typeof BillingVersion>;
 
@@ -104,7 +105,7 @@ export type CreatePlanRequest = {
   /**
    * Unique identifier for a product
    */
-  productId?: string | undefined;
+  productId: string;
   /**
    * Whether tax is added on top of the price (exclusive) or included in the price (inclusive)
    */
@@ -118,13 +119,17 @@ export type CreatePlanRequest = {
    */
   renewalReminderDays?: number | undefined;
   /**
-   * Billing engine version. 0 = legacy fee-schedule billing (Legacy), 1 = line-item billing with metered usage support (Standard).
+   * Billing engine version. Only 1 (Standard, line-item billing with metered usage support) is accepted for new plans; omitting the field defaults to 1. 0 (Legacy, fee-schedule billing) is rejected — it exists only on plans created before this restriction.
    */
   billingVersion?: BillingVersion | undefined;
   /**
    * ISO 8601 datetime reference point for billing period alignment. Must be in the past or present. When set, subscriptions created under this plan align their first billing period to the next recurrence of this anchor.
    */
   billingAnchor?: Date | null | undefined;
+  /**
+   * 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;
 };
 
 /** @internal */
@@ -159,12 +164,13 @@ export type CreatePlanRequest$Outbound = {
   merchantId: string;
   name: string;
   prices?: Array<string> | undefined;
-  productId?: string | undefined;
+  productId: string;
   taxBehavior: string;
   renewalReminderEnabled: boolean;
   renewalReminderDays: number;
   billingVersion: number;
   billingAnchor?: string | null | undefined;
+  creditAllocations?: Array<models.PlanCreditAllocation$Outbound> | undefined;
 };
 
 /** @internal */
@@ -183,13 +189,15 @@ export const CreatePlanRequest$outboundSchema: z.ZodType<
   merchantId: z.string(),
   name: z.string(),
   prices: z.array(z.string()).optional(),
-  productId: z.string().optional(),
+  productId: z.string(),
   taxBehavior: CreatePlanTaxBehavior$outboundSchema.default("exclusive"),
   renewalReminderEnabled: z.boolean().default(true),
   renewalReminderDays: z.number().int().default(3),
-  billingVersion: BillingVersion$outboundSchema.default(0),
+  billingVersion: BillingVersion$outboundSchema.default(1),
   billingAnchor: z.nullable(z.date().transform(v => v.toISOString()))
     .optional(),
+  creditAllocations: z.array(models.PlanCreditAllocation$outboundSchema)
+    .optional(),
 });
 
 export function createPlanRequestToJSON(

package/src/models/operations/createprice.ts

@@ -6,20 +6,6 @@ import * as z from "zod/v3";
 import { ClosedEnum } from "../../types/enums.js";
 import * as models from "../index.js";
 
-/**
- * Pricing calculation model. Required for billable metrics, optional for fees (defaults to 'standard').
- */
-export const CreatePriceModel = {
-  Standard: "standard",
-  Dynamic: "dynamic",
-  Volume: "volume",
-  Percentage: "percentage",
-} as const;
-/**
- * Pricing calculation model. Required for billable metrics, optional for fees (defaults to 'standard').
- */
-export type CreatePriceModel = ClosedEnum<typeof CreatePriceModel>;
-
 /**
  * Billing timing preference. For billable metrics: 'instant' (charges immediately) or 'in_arrears' (charges at period end). For fees: 'in_advance' (charges upfront) or 'in_arrears' (charges at period end).
  */
@@ -43,9 +29,13 @@ export type CreatePriceRequest = {
    */
   feeId?: string | undefined;
   /**
-   * Pricing calculation model. Required for billable metrics, optional for fees (defaults to 'standard').
+   * Unique identifier for a pricing unit
+   */
+  pricingUnitId?: string | undefined;
+  /**
+   * Pricing calculation model. Required for billable metrics, optional for fees (defaults to 'standard'). Only 'standard' is accepted; for percentage/revenue-share use 'standard' with a unit-price multiplier. Legacy prices using 'dynamic'/'volume'/'percentage' stay readable and billable but cannot be created.
    */
-  model?: CreatePriceModel | undefined;
+  model?: models.PriceModelInput | undefined;
   /**
    * Line item label shown on customer invoices. Sample values: 'Claude Token Consumption', 'Storage Usage (GB)', 'Inference API Calls', 'Image Generation Count', 'Training Compute Hours', 'Data Transfer (TB)'
    */
@@ -70,11 +60,6 @@ export type CreatePriceRequest = {
   quantity?: number | undefined;
 };
 
-/** @internal */
-export const CreatePriceModel$outboundSchema: z.ZodNativeEnum<
-  typeof CreatePriceModel
-> = z.nativeEnum(CreatePriceModel);
-
 /** @internal */
 export const CreatePricePaymentTerm$outboundSchema: z.ZodNativeEnum<
   typeof CreatePricePaymentTerm
@@ -84,6 +69,7 @@ export const CreatePricePaymentTerm$outboundSchema: z.ZodNativeEnum<
 export type CreatePriceRequest$Outbound = {
   billableMetricId?: string | undefined;
   feeId?: string | undefined;
+  pricingUnitId?: string | undefined;
   model?: string | undefined;
   invoiceDisplayName: string;
   paymentTerm: string;
@@ -102,7 +88,8 @@ export const CreatePriceRequest$outboundSchema: z.ZodType<
 > = z.object({
   billableMetricId: z.string().optional(),
   feeId: z.string().optional(),
-  model: CreatePriceModel$outboundSchema.optional(),
+  pricingUnitId: z.string().optional(),
+  model: models.PriceModelInput$outboundSchema.optional(),
   invoiceDisplayName: z.string(),
   paymentTerm: CreatePricePaymentTerm$outboundSchema,
   billingCadence: z.nullable(z.string()).optional(),

package/src/models/operations/index.ts

@@ -105,6 +105,7 @@ export * from "./listsources.js";
 export * from "./listsubscriptions.js";
 export * from "./listtestclocks.js";
 export * from "./purchaseentitlementgrant.js";
+export * from "./reconcilesubscriptionfeatures.js";
 export * from "./rejectsourceevent.js";
 export * from "./replacescheduleintervals.js";
 export * from "./terminatesubscription.js";

package/src/models/operations/reconcilesubscriptionfeatures.ts

@@ -0,0 +1,78 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+export type ReconcileSubscriptionFeaturesRequestBody = {
+  /**
+   * Preview the outcome without creating any entitlement, grant, or line item.
+   */
+  dryRun?: boolean | undefined;
+};
+
+export type ReconcileSubscriptionFeaturesRequest = {
+  /**
+   * The subscription ID
+   */
+  id: string;
+  requestBody?: ReconcileSubscriptionFeaturesRequestBody | undefined;
+};
+
+/** @internal */
+export type ReconcileSubscriptionFeaturesRequestBody$Outbound = {
+  dryRun: boolean;
+};
+
+/** @internal */
+export const ReconcileSubscriptionFeaturesRequestBody$outboundSchema: z.ZodType<
+  ReconcileSubscriptionFeaturesRequestBody$Outbound,
+  z.ZodTypeDef,
+  ReconcileSubscriptionFeaturesRequestBody
+> = z.object({
+  dryRun: z.boolean().default(false),
+});
+
+export function reconcileSubscriptionFeaturesRequestBodyToJSON(
+  reconcileSubscriptionFeaturesRequestBody:
+    ReconcileSubscriptionFeaturesRequestBody,
+): string {
+  return JSON.stringify(
+    ReconcileSubscriptionFeaturesRequestBody$outboundSchema.parse(
+      reconcileSubscriptionFeaturesRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type ReconcileSubscriptionFeaturesRequest$Outbound = {
+  id: string;
+  RequestBody?: ReconcileSubscriptionFeaturesRequestBody$Outbound | undefined;
+};
+
+/** @internal */
+export const ReconcileSubscriptionFeaturesRequest$outboundSchema: z.ZodType<
+  ReconcileSubscriptionFeaturesRequest$Outbound,
+  z.ZodTypeDef,
+  ReconcileSubscriptionFeaturesRequest
+> = z.object({
+  id: z.string(),
+  requestBody: z.lazy(() =>
+    ReconcileSubscriptionFeaturesRequestBody$outboundSchema
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    requestBody: "RequestBody",
+  });
+});
+
+export function reconcileSubscriptionFeaturesRequestToJSON(
+  reconcileSubscriptionFeaturesRequest: ReconcileSubscriptionFeaturesRequest,
+): string {
+  return JSON.stringify(
+    ReconcileSubscriptionFeaturesRequest$outboundSchema.parse(
+      reconcileSubscriptionFeaturesRequest,
+    ),
+  );
+}

package/src/models/operations/updateplan.ts

@@ -5,6 +5,7 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { ClosedEnum } from "../../types/enums.js";
+import * as models from "../index.js";
 
 /**
  * ISO 8601 duration for the billing period. Takes precedence over billingInterval when both are provided.
@@ -98,6 +99,10 @@ export type UpdatePlanRequestBody = {
    * ISO 8601 datetime reference point for billing period alignment. Must be in the past or present. Set to null to clear the anchor and revert to start-time-based anchoring.
    */
   billingAnchor?: Date | null | undefined;
+  /**
+   * 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;
 };
 
 export type UpdatePlanRequest = {
@@ -137,6 +142,7 @@ export type UpdatePlanRequestBody$Outbound = {
   renewalReminderEnabled?: boolean | undefined;
   renewalReminderDays?: number | undefined;
   billingAnchor?: string | null | undefined;
+  creditAllocations?: Array<models.PlanCreditAllocation$Outbound> | undefined;
 };
 
 /** @internal */
@@ -158,6 +164,8 @@ export const UpdatePlanRequestBody$outboundSchema: z.ZodType<
   renewalReminderDays: z.number().int().optional(),
   billingAnchor: z.nullable(z.date().transform(v => v.toISOString()))
     .optional(),
+  creditAllocations: z.array(models.PlanCreditAllocation$outboundSchema)
+    .optional(),
 });
 
 export function updatePlanRequestBodyToJSON(