@paygentic/sdk 0.8.5 → 0.8.7

package/src/funcs/plansTransitionPlanVersion.ts

@@ -0,0 +1,190 @@
+/*
+ * 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";
+
+/**
+ * Set the default version
+ *
+ * @remarks
+ * Point the plan's default at this version, so its floating subscriptions bill from it. Any version may become default, in either direction — this is how you roll a plan back to (or forward to) an earlier price set. Idempotent when the version is already the default.
+ */
+export function plansTransitionPlanVersion(
+  client: PaygenticCore,
+  request: operations.TransitionPlanVersionRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.PlanVersion,
+    | 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.TransitionPlanVersionRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.PlanVersion,
+      | errors.BadRequest
+      | errors.ErrorT
+      | PaygenticError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.TransitionPlanVersionRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.TransitionPlanVersionRequest, {
+    explode: true,
+  });
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    versionNumber: encodeSimple("versionNumber", payload.versionNumber, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/v0/plans/{id}/versions/{versionNumber}")(
+    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: "transitionPlanVersion",
+    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: "PATCH",
+    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", "409", "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.PlanVersion,
+    | errors.BadRequest
+    | errors.ErrorT
+    | PaygenticError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.PlanVersion$inboundSchema),
+    M.jsonErr(400, errors.BadRequest$inboundSchema),
+    M.jsonErr([401, 403, 404, 409], 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/funcs/plansUpdate.ts

@@ -137,7 +137,7 @@ async function $do(
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["400", "401", "403", "404", "4XX", "500", "5XX"],
+    errorCodes: ["400", "401", "403", "404", "409", "4XX", "500", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
@@ -165,7 +165,7 @@ async function $do(
   >(
     M.json(200, models.Plan$inboundSchema),
     M.jsonErr(400, errors.BadRequest$inboundSchema),
-    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema),
+    M.jsonErr([401, 403, 404, 409], errors.ErrorT$inboundSchema),
     M.jsonErr(500, errors.ErrorT$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),

package/src/funcs/subscriptionsCreate.ts

@@ -134,7 +134,7 @@ async function $do(
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["400", "401", "403", "404", "4XX", "500", "5XX"],
+    errorCodes: ["400", "401", "403", "404", "409", "4XX", "500", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
@@ -162,7 +162,7 @@ async function $do(
   >(
     M.json([200, 201], models.Subscription$inboundSchema),
     M.jsonErr(400, errors.BadRequest$inboundSchema),
-    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema),
+    M.jsonErr([401, 403, 404, 409], errors.ErrorT$inboundSchema),
     M.jsonErr(500, errors.ErrorT$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),

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.8.5",
+  sdkVersion: "0.8.7",
   genVersion: "2.879.13",
-  userAgent: "speakeasy-sdk/typescript 0.8.5 2.879.13 0.1.0 @paygentic/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.8.7 2.879.13 0.1.0 @paygentic/sdk",
 } as const;

package/src/models/billablemetric.ts

@@ -44,6 +44,10 @@ export type BillableMetric = {
    * Unique identifier for a product
    */
   productId: string;
+  /**
+   * The item this metric is tagged with, or null when untagged. Used to map this metric's invoice lines to an external accounting/tax identity.
+   */
+  itemId: string | null;
   unit: string;
   updatedAt: Date;
   eventType?: string | null | undefined;
@@ -76,6 +80,7 @@ export const BillableMetric$inboundSchema: z.ZodType<
   merchantId: z.string(),
   name: z.string(),
   productId: z.string(),
+  itemId: z.nullable(z.string()),
   unit: z.string(),
   updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   eventType: z.nullable(z.string()).optional(),

package/src/models/createmanuallineitemrequest.ts

@@ -49,6 +49,10 @@ export type CreateManualLineItemRequest = {
    * Optional caller-provided idempotency key. Auto-generated if not provided.
    */
   idempotencyKey?: string | null | undefined;
+  /**
+   * Optional item to tag this line with, for accounting/GL mapping. Must belong to the caller's merchant and must not be archived. A manual line has no price, so it is never reached by a later restamp — supplying it here is the only opportunity to tag it.
+   */
+  itemId?: string | null | undefined;
 };
 
 /** @internal */
@@ -64,6 +68,7 @@ export type CreateManualLineItemRequest$Outbound = {
   periodStart?: string | null | undefined;
   periodEnd?: string | null | undefined;
   idempotencyKey?: string | null | undefined;
+  itemId?: string | null | undefined;
 };
 
 /** @internal */
@@ -83,6 +88,7 @@ export const CreateManualLineItemRequest$outboundSchema: z.ZodType<
   periodStart: z.nullable(z.date().transform(v => v.toISOString())).optional(),
   periodEnd: z.nullable(z.date().transform(v => v.toISOString())).optional(),
   idempotencyKey: z.nullable(z.string()).optional(),
+  itemId: z.nullable(z.string()).optional(),
 });
 
 export function createManualLineItemRequestToJSON(

package/src/models/fee.ts

@@ -26,6 +26,10 @@ export type Fee = {
    * Unique identifier for a product
    */
   productId: string;
+  /**
+   * The item this fee is tagged with, or null when untagged. Used to map this fee's invoice lines to an external accounting/tax identity.
+   */
+  itemId: string | null;
   createdAt: Date;
   updatedAt: Date;
 };
@@ -43,6 +47,7 @@ export const Fee$inboundSchema: z.ZodType<Fee, z.ZodTypeDef, unknown> = z
     description: z.string(),
     merchantId: z.string(),
     productId: z.string(),
+    itemId: z.nullable(z.string()),
     createdAt: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),

package/src/models/index.ts

@@ -55,6 +55,7 @@ export * from "./meteredentitlementdetail.js";
 export * from "./meteredentitlementlistitem.js";
 export * from "./meterevent.js";
 export * from "./metereventlist.js";
+export * from "./mintplanversionrequest.js";
 export * from "./offsetpagination.js";
 export * from "./order.js";
 export * from "./orderlineitem.js";
@@ -65,6 +66,8 @@ export * from "./paymentsession.js";
 export * from "./paymentsummary.js";
 export * from "./plan.js";
 export * from "./plancreditallocation.js";
+export * from "./planversion.js";
+export * from "./planversionpriceslot.js";
 export * from "./planversionsummary.js";
 export * from "./price.js";
 export * from "./pricefeature.js";
@@ -83,6 +86,7 @@ export * from "./reconciledfeaturefailed.js";
 export * from "./reconciledfeatureremoved.js";
 export * from "./reconciledfeatureskipped.js";
 export * from "./replacescheduleintervalsrequest.js";
+export * from "./resolveditem.js";
 export * from "./revenuesummaryresponse.js";
 export * from "./revenuetrendbucket.js";
 export * from "./rulecondition.js";
@@ -103,6 +107,7 @@ export * from "./subscriptionmetadata.js";
 export * from "./subscriptionportal.js";
 export * from "./subscriptionreconciliation.js";
 export * from "./testclock.js";
+export * from "./transitionplanversionrequest.js";
 export * from "./updateapprovalrequest.js";
 export * from "./updatebillingschedulerequest.js";
 export * from "./updateorderlineitemrequest.js";

package/src/models/invoice.ts

@@ -11,6 +11,7 @@ import {
   InvoiceLineItem,
   InvoiceLineItem$inboundSchema,
 } from "./invoicelineitem.js";
+import { ResolvedItem, ResolvedItem$inboundSchema } from "./resolveditem.js";
 
 /**
  * The object type
@@ -24,7 +25,7 @@ export const InvoiceObject = {
 export type InvoiceObject = ClosedEnum<typeof InvoiceObject>;
 
 /**
- * Line items (only present if expand=lineItems query parameter is provided)
+ * Line items (only present if expand=lineItems query parameter is provided, or if expand=items is, which implies it)
  */
 export type InvoiceLineItems = {
   /**
@@ -35,6 +36,10 @@ export type InvoiceLineItems = {
    * Array of line items for this page
    */
   lineItems: Array<InvoiceLineItem>;
+  /**
+   * Items the returned lines were tagged with, each appearing once, ordered by id. Only present when expand=items is requested. Scoped to the lines in THIS response, not the whole invoice — combine the collections across pages for an invoice-wide set. Join a line to its entry via the line's itemId. A line whose itemId has no entry here is a data-integrity fault — the tag points at an item that no longer resolves for this merchant. It is not the same as an untagged line and must not be counted as unmapped; report it.
+   */
+  items?: Array<ResolvedItem> | undefined;
   /**
    * Token for fetching the next page, null if no more pages
    */
@@ -154,7 +159,7 @@ export type Invoice = {
    */
   itemCount: number;
   /**
-   * Line items (only present if expand=lineItems query parameter is provided)
+   * Line items (only present if expand=lineItems query parameter is provided, or if expand=items is, which implies it)
    */
   lineItems?: InvoiceLineItems | null | undefined;
   /**
@@ -252,6 +257,7 @@ export const InvoiceLineItems$inboundSchema: z.ZodType<
 > = z.object({
   invoiceId: z.string(),
   lineItems: z.array(InvoiceLineItem$inboundSchema),
+  items: z.array(ResolvedItem$inboundSchema).optional(),
   nextPageToken: z.nullable(z.string()).optional(),
   totalCount: z.number().int(),
 });

package/src/models/invoicelineitem.ts

@@ -52,6 +52,14 @@ export type InvoiceLineItem = {
    * HOTFIX: Mirrors eventSourceId for backward compatibility
    */
   billableMetricId: string;
+  /**
+   * Item the line's charge was tagged with, recorded when the line was generated and not re-resolved on read. A discount line carries the same item as the charge it offsets. `null` means the charge carried no tag at that moment, the line predates item stamping, or the line has no originating charge (a grant-credit purchase) — it is an expected value, not an error. Use `priceId` to tell those cases apart.
+   */
+  itemId?: string | null | undefined;
+  /**
+   * The price this line was generated from, or `null` when the line has no originating charge. With `itemId` it says whether a missing tag is fixable: `priceId` set and `itemId` null means the charge was simply untagged, which tagging it and restamping resolves; both null means the line records a grant-credit purchase, which is deferred revenue and is never tagged. Any measure of outstanding mapping work must exclude the latter or it can never reach zero.
+   */
+  priceId?: string | null | undefined;
   /**
    * Display name for this line item on invoices
    */
@@ -121,6 +129,8 @@ export const InvoiceLineItem$inboundSchema: z.ZodType<
   eventId: z.string(),
   eventSourceId: z.string(),
   billableMetricId: z.string(),
+  itemId: z.nullable(z.string()).optional(),
+  priceId: z.nullable(z.string()).optional(),
   invoiceDisplayName: z.string(),
   lineItemType: InvoiceLineItemLineItemType$inboundSchema,
   meterEventId: z.string(),

package/src/models/invoicelineitemsresponse.ts

@@ -10,6 +10,7 @@ import {
   InvoiceLineItem,
   InvoiceLineItem$inboundSchema,
 } from "./invoicelineitem.js";
+import { ResolvedItem, ResolvedItem$inboundSchema } from "./resolveditem.js";
 
 export type InvoiceLineItemsResponse = {
   /**
@@ -20,6 +21,10 @@ export type InvoiceLineItemsResponse = {
    * Array of line items for this page
    */
   lineItems: Array<InvoiceLineItem>;
+  /**
+   * Items the returned lines were tagged with, each appearing once, ordered by id. Only present when expand=items is requested. Scoped to the lines in THIS response, not the whole invoice — combine the collections across pages for an invoice-wide set. Join a line to its entry via the line's itemId. A line whose itemId has no entry here is a data-integrity fault — the tag points at an item that no longer resolves for this merchant. It is not the same as an untagged line and must not be counted as unmapped; report it.
+   */
+  items?: Array<ResolvedItem> | undefined;
   /**
    * Token for fetching the next page, null if no more pages
    */
@@ -38,6 +43,7 @@ export const InvoiceLineItemsResponse$inboundSchema: z.ZodType<
 > = z.object({
   invoiceId: z.string(),
   lineItems: z.array(InvoiceLineItem$inboundSchema),
+  items: z.array(ResolvedItem$inboundSchema).optional(),
   nextPageToken: z.nullable(z.string()).optional(),
   totalCount: z.number().int(),
 });

package/src/models/item.ts

@@ -18,12 +18,23 @@ export const ItemObject = {
 export type ItemObject = ClosedEnum<typeof ItemObject>;
 
 export type Item = {
+  /**
+   * Unique identifier for an item
+   */
   id: string;
   object: ItemObject;
   merchantId: string;
   name: string;
   metadata: { [k: string]: any };
   externalReferences: Array<ExternalReference>;
+  /**
+   * The product this item belongs to.
+   */
+  catalogId: string | null;
+  /**
+   * When this item was retired from the catalog. Null while active.
+   */
+  archivedAt: Date | null;
   createdAt: Date;
   updatedAt: Date;
 };
@@ -41,6 +52,10 @@ export const Item$inboundSchema: z.ZodType<Item, z.ZodTypeDef, unknown> = z
     name: z.string(),
     metadata: z.record(z.any()),
     externalReferences: z.array(ExternalReference$inboundSchema),
+    catalogId: z.nullable(z.string()),
+    archivedAt: z.nullable(
+      z.string().datetime({ offset: true }).transform(v => new Date(v)),
+    ),
     createdAt: z.string().datetime({ offset: true }).transform(v =>
       new Date(v)
     ),

package/src/models/lineitem.ts

@@ -35,14 +35,14 @@ export const LineItemStatus = {
 export type LineItemStatus = ClosedEnum<typeof LineItemStatus>;
 
 /**
- * Payment term for fee items. Null for metered/manual lines
+ * Payment term for fee items. Null for metered/manual lines. `null` is listed in the enum as well as via `nullable` because OpenAPI 3.0 validators check the enum independently — `nullable: true` alone does not admit it, and createLineItem (which always returns null here) was emitting a schema-violating body.
  */
 export const LineItemPaymentTerm = {
   InAdvance: "in_advance",
   InArrears: "in_arrears",
 } as const;
 /**
- * Payment term for fee items. Null for metered/manual lines
+ * Payment term for fee items. Null for metered/manual lines. `null` is listed in the enum as well as via `nullable` because OpenAPI 3.0 validators check the enum independently — `nullable: true` alone does not admit it, and createLineItem (which always returns null here) was emitting a schema-violating body.
  */
 export type LineItemPaymentTerm = ClosedEnum<typeof LineItemPaymentTerm>;
 
@@ -60,9 +60,13 @@ export type LineItem = {
    */
   customerId: string;
   /**
-   * The price ID associated with this line item
+   * The price this line was generated from, or `null` when the line has no originating charge. With `itemId` it says whether a missing tag is fixable: `priceId` set and `itemId` null means the charge was simply untagged, which tagging it and restamping resolves; both null means the line records a grant-credit purchase, which is deferred revenue and is never tagged. Any measure of outstanding mapping work must exclude the latter or it can never reach zero.
    */
   priceId?: string | null | undefined;
+  /**
+   * Item the line's charge was tagged with, recorded when the line was generated and not re-resolved on read. `null` means the charge carried no tag at that moment, the line predates item stamping, or the line has no originating charge (a grant-credit purchase) — it is an expected value, not an error. Use `priceId` to tell those cases apart.
+   */
+  itemId?: string | null | undefined;
   /**
    * The invoice ID if this item has been invoiced
    */
@@ -116,7 +120,7 @@ export type LineItem = {
    */
   meteredQuantity?: string | null | undefined;
   /**
-   * Payment term for fee items. Null for metered/manual lines
+   * Payment term for fee items. Null for metered/manual lines. `null` is listed in the enum as well as via `nullable` because OpenAPI 3.0 validators check the enum independently — `nullable: true` alone does not admit it, and createLineItem (which always returns null here) was emitting a schema-violating body.
    */
   paymentTerm?: LineItemPaymentTerm | null | undefined;
   /**
@@ -173,6 +177,7 @@ export const LineItem$inboundSchema: z.ZodType<
   subscriptionId: z.string(),
   customerId: z.string(),
   priceId: z.nullable(z.string()).optional(),
+  itemId: z.nullable(z.string()).optional(),
   invoiceId: z.nullable(z.string()).optional(),
   type: LineItemType$inboundSchema,
   status: LineItemStatus$inboundSchema,

package/src/models/lineitemsresponse.ts

@@ -12,6 +12,7 @@ import {
   LineItemsSummary,
   LineItemsSummary$inboundSchema,
 } from "./lineitemssummary.js";
+import { ResolvedItem, ResolvedItem$inboundSchema } from "./resolveditem.js";
 
 /**
  * The object type
@@ -35,6 +36,10 @@ export type LineItemsResponse = {
    * Array of line items
    */
   data: Array<LineItem>;
+  /**
+   * Items the returned lines were tagged with, each appearing once, ordered by id. Only present when expand=items is requested. Scoped to the lines in THIS response, not to any invoice as a whole — combine the collections across pages for a complete set. Join a line to its entry via the line's itemId. A line whose itemId has no entry here is a data-integrity fault — the tag points at an item that no longer resolves for this merchant. It is not the same as an untagged line and must not be counted as unmapped; report it.
+   */
+  items?: Array<ResolvedItem> | undefined;
   /**
    * Total number of matching line items
    */
@@ -55,6 +60,7 @@ export const LineItemsResponse$inboundSchema: z.ZodType<
 > = z.object({
   object: LineItemsResponseObject$inboundSchema,
   data: z.array(LineItem$inboundSchema),
+  items: z.array(ResolvedItem$inboundSchema).optional(),
   totalCount: z.number().int(),
   summary: LineItemsSummary$inboundSchema,
 });

package/src/models/mintplanversionrequest.ts

@@ -0,0 +1,80 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type ReplacePrice = {
+  /**
+   * Unique identifier for a price
+   */
+  replacesPriceId: string;
+  /**
+   * Unique identifier for a price
+   */
+  withPriceId: string;
+};
+
+/**
+ * A reference-by-id price diff applied to the prices of the plan's current version. Every id references an existing price created via POST /prices; inline price definitions are not accepted. A mint must carry at least one price change, so an empty body is rejected. A version must carry at least one price, so a diff that would leave none is rejected.
+ */
+export type MintPlanVersionRequest = {
+  /**
+   * Prices to add to the version. Each must not already be on the plan's current version.
+   */
+  addPrices?: Array<string> | undefined;
+  /**
+   * Prices to remove. Each must be on the plan's current version.
+   */
+  removePrices?: Array<string> | undefined;
+  /**
+   * Prices to swap in place, preserving the slot's lineage so the price keeps its identity where the plan is configured for stable price ids. replacesPriceId must be on the plan's current version; withPriceId is the new price.
+   */
+  replacePrices?: Array<ReplacePrice> | undefined;
+};
+
+/** @internal */
+export type ReplacePrice$Outbound = {
+  replacesPriceId: string;
+  withPriceId: string;
+};
+
+/** @internal */
+export const ReplacePrice$outboundSchema: z.ZodType<
+  ReplacePrice$Outbound,
+  z.ZodTypeDef,
+  ReplacePrice
+> = z.object({
+  replacesPriceId: z.string(),
+  withPriceId: z.string(),
+});
+
+export function replacePriceToJSON(replacePrice: ReplacePrice): string {
+  return JSON.stringify(ReplacePrice$outboundSchema.parse(replacePrice));
+}
+
+/** @internal */
+export type MintPlanVersionRequest$Outbound = {
+  addPrices?: Array<string> | undefined;
+  removePrices?: Array<string> | undefined;
+  replacePrices?: Array<ReplacePrice$Outbound> | undefined;
+};
+
+/** @internal */
+export const MintPlanVersionRequest$outboundSchema: z.ZodType<
+  MintPlanVersionRequest$Outbound,
+  z.ZodTypeDef,
+  MintPlanVersionRequest
+> = z.object({
+  addPrices: z.array(z.string()).optional(),
+  removePrices: z.array(z.string()).optional(),
+  replacePrices: z.array(z.lazy(() => ReplacePrice$outboundSchema)).optional(),
+});
+
+export function mintPlanVersionRequestToJSON(
+  mintPlanVersionRequest: MintPlanVersionRequest,
+): string {
+  return JSON.stringify(
+    MintPlanVersionRequest$outboundSchema.parse(mintPlanVersionRequest),
+  );
+}

package/src/models/operations/createbillablemetric.ts

@@ -44,7 +44,11 @@ export type CreateBillableMetricRequest = {
   /**
    * Unique identifier for a product
    */
-  productId: string;
+  productId?: string | undefined;
+  /**
+   * Unique identifier for an item
+   */
+  itemId?: string | undefined;
   /**
    * Measurement unit used when aggregating this metric's values. Common examples: 'tokens', 'GB', 'calls', 'images', 'hours', 'TB', 'queries', 'requests'
    */
@@ -78,7 +82,8 @@ export type CreateBillableMetricRequest$Outbound = {
   description: string;
   merchantId: string;
   name: string;
-  productId: string;
+  productId?: string | undefined;
+  itemId?: string | undefined;
   unit: string;
   eventType?: string | undefined;
   valueProperty?: string | undefined;
@@ -96,7 +101,8 @@ export const CreateBillableMetricRequest$outboundSchema: z.ZodType<
   description: z.string(),
   merchantId: z.string(),
   name: z.string(),
-  productId: z.string(),
+  productId: z.string().optional(),
+  itemId: z.string().optional(),
   unit: z.string(),
   eventType: z.string().optional(),
   valueProperty: z.string().optional(),