@paygentic/sdk 0.8.6 → 0.8.7

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

@@ -16,7 +16,7 @@ export type ReplacePrice = {
 };
 
 /**
- * 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. An empty body copies the current prices into the new version unchanged. A version must carry at least one price, so a diff that would leave none is rejected.
+ * 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 = {
   /**

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(),

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/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;
   /**
@@ -21,6 +21,10 @@ export type GetInvoiceRequest = {
    * 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

@@ -17,6 +17,14 @@ export type GetInvoiceLineItemsRequest = {
    * 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/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/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/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/resolveditem.ts

@@ -0,0 +1,63 @@
+/*
+ * 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 {
+  ExternalReference,
+  ExternalReference$inboundSchema,
+} from "./externalreference.js";
+
+/**
+ * An item a line was tagged with, together with its external accounting/tax codes. Deliberately narrower than the /v0/items Item resource: it carries what is needed to translate a line into a GL/SKU code, not the full record.
+ */
+export type ResolvedItem = {
+  /**
+   * Unique identifier for an item
+   */
+  id: string;
+  /**
+   * Human-readable item name
+   */
+  name: string;
+  /**
+   * The product this item belongs to, for grouping lines by product
+   */
+  catalogId: string | null;
+  /**
+   * When this item was retired from the catalog. Archived items still resolve here — invoices that already reference them have to keep resolving — but cannot be tagged onto new pricing. Null while active.
+   */
+  archivedAt: Date | null;
+  /**
+   * The item's external codes, narrowed to the requested provider when one is given. An empty list means the item is not yet mapped for that provider — an actionable state, not an error. More than one may be returned for a single provider, and more than one of those may carry `isPrimary: true`: the uniqueness constraint runs the other way round (an external id is the primary reference of at most one item per merchant), so it does not reduce an item's references to one per provider. Entries are ordered newest first, tie-broken by id, so the order is stable across reads — but a consumer that needs exactly one code must choose deliberately rather than assume there is only one.
+   */
+  externalReferences: Array<ExternalReference>;
+};
+
+/** @internal */
+export const ResolvedItem$inboundSchema: z.ZodType<
+  ResolvedItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+  catalogId: z.nullable(z.string()),
+  archivedAt: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ),
+  externalReferences: z.array(ExternalReference$inboundSchema),
+});
+
+export function resolvedItemFromJSON(
+  jsonString: string,
+): SafeParseResult<ResolvedItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResolvedItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResolvedItem' from JSON`,
+  );
+}

package/src/models/subscription.ts

@@ -174,11 +174,15 @@ export type Subscription = {
    */
   versionNumber?: number | undefined;
   /**
-   * @deprecated Use minimumAccountBalance instead. Minimum required wallet balance in atomic units. Sample values: '200000000000' equals $200.00 minimum, '1000000000000' equals $1000.00 minimum
+   * Deprecated. Legacy-only, not populated for new subscriptions.
+   *
+   * @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 nanodollars. Can be '0' to disable. The system calculates the difference between this minimum and the customer's current balance, charging only what's needed to reach the minimum. Note: If the calculated charge amount is below payment processor minimums (typically $1.00), the actual charged amount may be automatically adjusted upward to meet the minimum requirement. Sample values: '200000000000' equals $200.00 minimum, '1000000000000' equals $1000.00 minimum
+   * Deprecated. Legacy-only, not populated for new subscriptions.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   minimumAccountBalance?: string | undefined;
   startedAt: Date;
@@ -198,7 +202,9 @@ export type Subscription = {
   testClockId?: string | undefined;
   updatedAt: Date;
   /**
-   * Optional (virtual) wallet ID for the subscription
+   * Deprecated. Legacy-only, not populated for new subscriptions.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   walletId?: string | undefined;
   /**