@paygentic/sdk 0.9.18 → 0.10.0

package/dist/esm/models/operations/getinvoice.d.ts

@@ -5,7 +5,7 @@ export type GetInvoiceRequest = {
      */
     id: string;
     /**
-     * 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.
+     * Comma-separated list of fields to expand. Supports: lineItems, items, lineProvenance. `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. `lineProvenance` adds `provenance` to each returned line: how its amount before tax was calculated. It also expands `lineItems`.
      */
     expand?: string | undefined;
     /**

package/dist/esm/models/operations/getinvoicelineitems.d.ts

@@ -13,7 +13,7 @@ export type GetInvoiceLineItemsRequest = {
      */
     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.
+     * Comma-separated list of fields to expand. Supports: items, lineProvenance. `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. `lineProvenance` adds `provenance` to each returned line: how its amount before tax was calculated.
      */
     expand?: string | undefined;
     /**

package/dist/esm/models/operations/listlineitems.d.ts

@@ -25,7 +25,7 @@ export type ListLineItemsRequest = {
      */
     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.
+     * Comma-separated list of fields to expand. Supports: items, lineProvenance. `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. `lineProvenance` adds `provenance` to each returned line: how its amount before tax was calculated.
      */
     expand?: string | undefined;
     /**

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@paygentic/sdk",
-  "version": "0.9.18",
+  "version": "0.10.0",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paygentic/sdk",
-  "version": "0.9.18",
+  "version": "0.10.0",
   "author": "Speakeasy",
   "license": "MIT",
   "repository": {

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

package/src/models/authorizationdenialreason.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Present on a 403 from the authorization check. Says why access was refused: the caller has no role that grants the permission, the OAuth token lacks the scope, or the caller is not a member of the organization.
+ */
+export const AuthorizationDenialReason = {
+  NoPermission: "no_permission",
+  InsufficientScope: "insufficient_scope",
+  NotMember: "not_member",
+} as const;
+/**
+ * Present on a 403 from the authorization check. Says why access was refused: the caller has no role that grants the permission, the OAuth token lacks the scope, or the caller is not a member of the organization.
+ */
+export type AuthorizationDenialReason = ClosedEnum<
+  typeof AuthorizationDenialReason
+>;
+
+/** @internal */
+export const AuthorizationDenialReason$inboundSchema: z.ZodNativeEnum<
+  typeof AuthorizationDenialReason
+> = z.nativeEnum(AuthorizationDenialReason);

package/src/models/errors/error.ts

@@ -3,6 +3,7 @@
  */
 
 import * as z from "zod/v3";
+import * as models from "../index.js";
 import { PaygenticError } from "./paygenticerror.js";
 
 export type ErrorTData = {
@@ -22,6 +23,14 @@ export type ErrorTData = {
    * Additional error details
    */
   details?: { [k: string]: any } | undefined;
+  /**
+   * Present on a 403 from the authorization check. Says why access was refused: the caller has no role that grants the permission, the OAuth token lacks the scope, or the caller is not a member of the organization.
+   */
+  reason?: models.AuthorizationDenialReason | undefined;
+  /**
+   * Present on a 403 from the authorization check. The permissions the caller needs for this request.
+   */
+  requiredPermissions?: Array<string> | undefined;
 };
 
 export class ErrorT extends PaygenticError {
@@ -37,6 +46,14 @@ export class ErrorT extends PaygenticError {
    * Additional error details
    */
   details?: { [k: string]: any } | undefined;
+  /**
+   * Present on a 403 from the authorization check. Says why access was refused: the caller has no role that grants the permission, the OAuth token lacks the scope, or the caller is not a member of the organization.
+   */
+  reason?: models.AuthorizationDenialReason | undefined;
+  /**
+   * Present on a 403 from the authorization check. The permissions the caller needs for this request.
+   */
+  requiredPermissions?: Array<string> | undefined;
 
   /** The original data that was passed to this error instance. */
   data$: ErrorTData;
@@ -51,6 +68,10 @@ export class ErrorT extends PaygenticError {
     if (err.error != null) this.error = err.error;
     if (err.code != null) this.code = err.code;
     if (err.details != null) this.details = err.details;
+    if (err.reason != null) this.reason = err.reason;
+    if (err.requiredPermissions != null) {
+      this.requiredPermissions = err.requiredPermissions;
+    }
 
     this.name = "ErrorT";
   }
@@ -63,6 +84,8 @@ export const ErrorT$inboundSchema: z.ZodType<ErrorT, z.ZodTypeDef, unknown> = z
     message: z.string(),
     code: z.string().optional(),
     details: z.record(z.any()).optional(),
+    reason: models.AuthorizationDenialReason$inboundSchema.optional(),
+    requiredPermissions: z.array(z.string()).optional(),
     request$: z.instanceof(Request),
     response$: z.instanceof(Response),
     body$: z.string(),

package/src/models/errors/recordinvoicepayment.ts

@@ -26,6 +26,14 @@ export type UnprocessableEntityErrorData = {
    * Additional error details
    */
   details?: { [k: string]: any } | undefined;
+  /**
+   * Present on a 403 from the authorization check. Says why access was refused: the caller has no role that grants the permission, the OAuth token lacks the scope, or the caller is not a member of the organization.
+   */
+  reason?: models.AuthorizationDenialReason | undefined;
+  /**
+   * Present on a 403 from the authorization check. The permissions the caller needs for this request.
+   */
+  requiredPermissions?: Array<string> | undefined;
 };
 
 /**
@@ -44,6 +52,14 @@ export class UnprocessableEntityError extends PaygenticError {
    * Additional error details
    */
   details?: { [k: string]: any } | undefined;
+  /**
+   * Present on a 403 from the authorization check. Says why access was refused: the caller has no role that grants the permission, the OAuth token lacks the scope, or the caller is not a member of the organization.
+   */
+  reason?: models.AuthorizationDenialReason | undefined;
+  /**
+   * Present on a 403 from the authorization check. The permissions the caller needs for this request.
+   */
+  requiredPermissions?: Array<string> | undefined;
 
   /** The original data that was passed to this error instance. */
   data$: UnprocessableEntityErrorData;
@@ -58,6 +74,10 @@ export class UnprocessableEntityError extends PaygenticError {
     this.error = err.error;
     this.code = err.code;
     if (err.details != null) this.details = err.details;
+    if (err.reason != null) this.reason = err.reason;
+    if (err.requiredPermissions != null) {
+      this.requiredPermissions = err.requiredPermissions;
+    }
 
     this.name = "UnprocessableEntityError";
   }
@@ -73,6 +93,8 @@ export const UnprocessableEntityError$inboundSchema: z.ZodType<
   message: z.string(),
   code: models.InvoicePaymentLinkErrorCode$inboundSchema,
   details: z.record(z.any()).optional(),
+  reason: models.AuthorizationDenialReason$inboundSchema.optional(),
+  requiredPermissions: z.array(z.string()).optional(),
   request$: z.instanceof(Request),
   response$: z.instanceof(Response),
   body$: z.string(),

package/src/models/index.ts

@@ -6,6 +6,7 @@ export * from "./accountfigure.js";
 export * from "./address.js";
 export * from "./approval.js";
 export * from "./approvallist.js";
+export * from "./authorizationdenialreason.js";
 export * from "./billablemetric.js";
 export * from "./billingschedule.js";
 export * from "./booleanentitlementdetail.js";
@@ -61,9 +62,23 @@ export * from "./invoicerefundlist.js";
 export * from "./invoicesummary.js";
 export * from "./issueentitlementrequest.js";
 export * from "./item.js";
+export * from "./linecalculationcontribution.js";
+export * from "./linecalculationgiven.js";
+export * from "./linecalculationinputprice.js";
+export * from "./linecalculationinputs.js";
+export * from "./linecalculationnotapplied.js";
+export * from "./linecalculationperiod.js";
+export * from "./linecalculationprecision.js";
+export * from "./linecalculationpriceband.js";
+export * from "./linecalculationpricefn.js";
+export * from "./linecalculationresult.js";
+export * from "./linecalculationsource.js";
+export * from "./linecalculationstep.js";
+export * from "./linecalculationvalue.js";
 export * from "./lineitem.js";
 export * from "./lineitemsresponse.js";
 export * from "./lineitemssummary.js";
+export * from "./lineprovenance.js";
 export * from "./mappingcapabilities.js";
 export * from "./merchantintegration.js";
 export * from "./merchantintegrationprovider.js";

package/src/models/invoicelineitem.ts

@@ -7,6 +7,10 @@ import { safeParse } from "../lib/schemas.js";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  LineProvenance,
+  LineProvenance$inboundSchema,
+} from "./lineprovenance.js";
 
 /**
  * Type of event: 'usage' for billable metric events, 'fee' for fee events, 'discount' for grant discount line items (subtotal/total are negative, representing a credit)
@@ -134,6 +138,10 @@ export type InvoiceLineItem = {
    * Unit price in decimal dollars
    */
   unitPrice: string;
+  /**
+   * How the line's amount before tax was calculated: a trace of one evaluation, saved when the invoice was calculated and fixed once it is issued. Returned only with `expand=lineProvenance`. Every field but `status` is present when `status` is `recorded`. Every number is a plain decimal string.
+   */
+  provenance?: LineProvenance | undefined;
 };
 
 /** @internal */
@@ -179,6 +187,7 @@ export const InvoiceLineItem$inboundSchema: z.ZodType<
   totalPrice: z.string(),
   totalTax: z.string(),
   unitPrice: z.string(),
+  provenance: LineProvenance$inboundSchema.optional(),
 });
 
 export function invoiceLineItemFromJSON(

package/src/models/linecalculationcontribution.ts

@@ -0,0 +1,35 @@
+/*
+ * 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 LineCalculationContribution = {
+  lineItemId: string;
+  value: string;
+  share: string | null;
+};
+
+/** @internal */
+export const LineCalculationContribution$inboundSchema: z.ZodType<
+  LineCalculationContribution,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  lineItemId: z.string(),
+  value: z.string(),
+  share: z.nullable(z.string()),
+});
+
+export function lineCalculationContributionFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationContribution, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationContribution$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationContribution' from JSON`,
+  );
+}

package/src/models/linecalculationgiven.ts

@@ -0,0 +1,42 @@
+/*
+ * 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";
+
+/**
+ * A value the evaluation started from, and its source.
+ */
+export type LineCalculationGiven = {
+  /**
+   * The value.
+   */
+  value: string;
+  /**
+   * The key of the source in `sources` that stated it.
+   */
+  source: string;
+};
+
+/** @internal */
+export const LineCalculationGiven$inboundSchema: z.ZodType<
+  LineCalculationGiven,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  value: z.string(),
+  source: z.string(),
+});
+
+export function lineCalculationGivenFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationGiven, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationGiven$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationGiven' from JSON`,
+  );
+}

package/src/models/linecalculationinputprice.ts

@@ -0,0 +1,46 @@
+/*
+ * 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 {
+  LineCalculationPriceFn,
+  LineCalculationPriceFn$inboundSchema,
+} from "./linecalculationpricefn.js";
+
+/**
+ * `priced` only: the price as a function, and its source.
+ */
+export type LineCalculationInputPrice = {
+  /**
+   * A price as a function from quantity to money. A new model may carry fields not listed here.
+   */
+  fn: LineCalculationPriceFn;
+  /**
+   * The key of the source in `sources` that stated the price.
+   */
+  source: string;
+};
+
+/** @internal */
+export const LineCalculationInputPrice$inboundSchema: z.ZodType<
+  LineCalculationInputPrice,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  fn: LineCalculationPriceFn$inboundSchema,
+  source: z.string(),
+});
+
+export function lineCalculationInputPriceFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationInputPrice, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationInputPrice$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationInputPrice' from JSON`,
+  );
+}

package/src/models/linecalculationinputs.ts

@@ -0,0 +1,65 @@
+/*
+ * 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 {
+  LineCalculationGiven,
+  LineCalculationGiven$inboundSchema,
+} from "./linecalculationgiven.js";
+import {
+  LineCalculationInputPrice,
+  LineCalculationInputPrice$inboundSchema,
+} from "./linecalculationinputprice.js";
+
+/**
+ * The values the evaluation started from.
+ */
+export type LineCalculationInputs = {
+  /**
+   * `priced`: a charge from a price, with `quantity`, `selector` and `price`. `fromLine`: a line whose base is another line's amount, with `amount`. `given`: an amount nobody priced on this run, with `amount`. An open set, so it is a string rather than an enum: known values are `priced`, `fromLine`, `given`, and new values may be added.
+   */
+  kind: string;
+  /**
+   * A value the evaluation started from, and its source.
+   */
+  quantity?: LineCalculationGiven | undefined;
+  /**
+   * A value the evaluation started from, and its source.
+   */
+  selector?: LineCalculationGiven | undefined;
+  /**
+   * `priced` only: the price as a function, and its source.
+   */
+  price?: LineCalculationInputPrice | undefined;
+  /**
+   * A value the evaluation started from, and its source.
+   */
+  amount?: LineCalculationGiven | undefined;
+};
+
+/** @internal */
+export const LineCalculationInputs$inboundSchema: z.ZodType<
+  LineCalculationInputs,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  kind: z.string(),
+  quantity: LineCalculationGiven$inboundSchema.optional(),
+  selector: LineCalculationGiven$inboundSchema.optional(),
+  price: LineCalculationInputPrice$inboundSchema.optional(),
+  amount: LineCalculationGiven$inboundSchema.optional(),
+});
+
+export function lineCalculationInputsFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationInputs, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationInputs$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationInputs' from JSON`,
+  );
+}

package/src/models/linecalculationnotapplied.ts

@@ -0,0 +1,42 @@
+/*
+ * 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";
+
+/**
+ * A rule in force for the line that did not change it.
+ */
+export type LineCalculationNotApplied = {
+  /**
+   * The key of the rule's source in `sources`.
+   */
+  source: string;
+  /**
+   * Why the rule did not change the line, for example `within` or `notBinding`.
+   */
+  reason: string;
+};
+
+/** @internal */
+export const LineCalculationNotApplied$inboundSchema: z.ZodType<
+  LineCalculationNotApplied,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  source: z.string(),
+  reason: z.string(),
+});
+
+export function lineCalculationNotAppliedFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationNotApplied, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationNotApplied$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationNotApplied' from JSON`,
+  );
+}

package/src/models/linecalculationperiod.ts

@@ -0,0 +1,36 @@
+/*
+ * 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";
+
+/**
+ * The period the line bills.
+ */
+export type LineCalculationPeriod = {
+  start: Date;
+  end: Date;
+};
+
+/** @internal */
+export const LineCalculationPeriod$inboundSchema: z.ZodType<
+  LineCalculationPeriod,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  start: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  end: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function lineCalculationPeriodFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationPeriod, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationPeriod$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationPeriod' from JSON`,
+  );
+}

package/src/models/linecalculationprecision.ts

@@ -0,0 +1,36 @@
+/*
+ * 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";
+
+/**
+ * The default arithmetic of every step. Any other rounding is an explicit `round` step.
+ */
+export type LineCalculationPrecision = {
+  significantDigits: number;
+  rounding: string;
+};
+
+/** @internal */
+export const LineCalculationPrecision$inboundSchema: z.ZodType<
+  LineCalculationPrecision,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  significantDigits: z.number().int(),
+  rounding: z.string(),
+});
+
+export function lineCalculationPrecisionFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationPrecision, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationPrecision$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationPrecision' from JSON`,
+  );
+}

package/src/models/linecalculationpriceband.ts

@@ -0,0 +1,33 @@
+/*
+ * 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 LineCalculationPriceBand = {
+  upTo: string | null;
+  rate: string;
+};
+
+/** @internal */
+export const LineCalculationPriceBand$inboundSchema: z.ZodType<
+  LineCalculationPriceBand,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  upTo: z.nullable(z.string()),
+  rate: z.string(),
+});
+
+export function lineCalculationPriceBandFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationPriceBand, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationPriceBand$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationPriceBand' from JSON`,
+  );
+}

package/src/models/linecalculationpricefn.ts

@@ -0,0 +1,74 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import {
+  collectExtraKeys as collectExtraKeys$,
+  safeParse,
+} from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  LineCalculationPriceBand,
+  LineCalculationPriceBand$inboundSchema,
+} from "./linecalculationpriceband.js";
+
+/**
+ * A price as a function from quantity to money. A new model may carry fields not listed here.
+ */
+export type LineCalculationPriceFn = {
+  /**
+   * `unit`: `rate` per unit. `volume`: `bands`, each with `upTo` (null for the open band) and `rate`; one band prices every unit. `percentage`: `rate` as a fraction, with `min` and `max` charge or null. `flat`: one `amount`. `dynamic`: the quantity is already money. An open set, so it is a string rather than an enum: known values are `unit`, `volume`, `percentage`, `flat`, `dynamic`, and new values may be added.
+   */
+  model: string;
+  /**
+   * `unit`, `percentage`: the rate.
+   */
+  rate?: string | undefined;
+  /**
+   * `volume` only: the bands in ascending order.
+   */
+  bands?: Array<LineCalculationPriceBand> | undefined;
+  /**
+   * `percentage` only: the minimum charge, or null.
+   */
+  min?: string | null | undefined;
+  /**
+   * `percentage` only: the maximum charge, or null.
+   */
+  max?: string | null | undefined;
+  /**
+   * `flat` only: the amount for the period.
+   */
+  amount?: string | undefined;
+  additionalProperties?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const LineCalculationPriceFn$inboundSchema: z.ZodType<
+  LineCalculationPriceFn,
+  z.ZodTypeDef,
+  unknown
+> = collectExtraKeys$(
+  z.object({
+    model: z.string(),
+    rate: z.string().optional(),
+    bands: z.array(LineCalculationPriceBand$inboundSchema).optional(),
+    min: z.nullable(z.string()).optional(),
+    max: z.nullable(z.string()).optional(),
+    amount: z.string().optional(),
+  }).catchall(z.any()),
+  "additionalProperties",
+  true,
+);
+
+export function lineCalculationPriceFnFromJSON(
+  jsonString: string,
+): SafeParseResult<LineCalculationPriceFn, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LineCalculationPriceFn$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LineCalculationPriceFn' from JSON`,
+  );
+}