@paygentic/sdk 0.9.6 → 0.9.8

package/dist/esm/models/subscriptionadjustment.d.ts

@@ -8,6 +8,7 @@ export declare const SubscriptionAdjustmentObject: {
 export type SubscriptionAdjustmentObject = ClosedEnum<typeof SubscriptionAdjustmentObject>;
 export declare const SubscriptionAdjustmentType: {
     readonly PercentageDiscount: "percentageDiscount";
+    readonly UsageDiscount: "usageDiscount";
 };
 export type SubscriptionAdjustmentType = ClosedEnum<typeof SubscriptionAdjustmentType>;
 export type SubscriptionAdjustment = {
@@ -22,19 +23,27 @@ export type SubscriptionAdjustment = {
     subscriptionId: string;
     type: SubscriptionAdjustmentType;
     /**
-     * The discount rate as a decimal fraction between 0 and 1. "0.35" means 35 percent.
+     * The discount rate as a decimal fraction between 0 and 1. "0.35" means 35 percent. Null on a usageDiscount, which carries a unit count instead.
      */
-    percentageDiscount: string;
+    percentageDiscount: string | null;
     /**
-     * The first instant the discount applies. Inclusive.
+     * The number of usage units taken off the targeted line's billable quantity. Null on a percentageDiscount, which carries a rate instead.
+     */
+    usageDiscount: string | null;
+    /**
+     * The prices this adjustment reduces. Exactly one metered price on a usageDiscount; empty on a percentageDiscount, which reduces every discountable charge.
+     */
+    targetPriceIds: Array<string>;
+    /**
+     * Opens the window. Read per type: INCLUSIVE on a percentageDiscount, whose window is prorated by day overlap; EXCLUSIVE on a usageDiscount, which corrects a line whose period END falls strictly after this instant.
      */
     effectiveFrom: Date;
     /**
-     * The instant the discount stops applying. Exclusive. Null means the discount never stops.
+     * Closes the window, or null for never. Read per type: EXCLUSIVE on a percentageDiscount; INCLUSIVE on a usageDiscount, which corrects a line whose period END falls on or before this instant.
      */
     effectiveTo: Date | null;
     /**
-     * The deal's own name, shown on each discount line of the invoice.
+     * The deal's own name. Shown on each discount line a percentageDiscount emits; a usageDiscount emits no line, so its description is carried here only.
      */
     description: string | null;
     createdAt: Date;

package/dist/esm/models/subscriptionadjustment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptionadjustment.d.ts","sourceRoot":"","sources":["../../../src/models/subscriptionadjustment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,UAAU,CACnD,OAAO,4BAA4B,CACpC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AACX,MAAM,MAAM,0BAA0B,GAAG,UAAU,CACjD,OAAO,0BAA0B,CAClC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,4BAA4B,CAAC;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,0BAA0B,CAAC;IACjC;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,aAAa,EAAE,IAAI,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,0CAA0C,EAAE,CAAC,CAAC,aAAa,CACtE,OAAO,4BAA4B,CACS,CAAC;AAE/C,gBAAgB;AAChB,eAAO,MAAM,wCAAwC,EAAE,CAAC,CAAC,aAAa,CACpE,OAAO,0BAA0B,CACS,CAAC;AAE7C,gBAAgB;AAChB,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,OAAO,CAC1D,sBAAsB,EACtB,CAAC,CAAC,UAAU,EACZ,OAAO,CAeP,CAAC;AAEH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAM7D"}
+{"version":3,"file":"subscriptionadjustment.d.ts","sourceRoot":"","sources":["../../../src/models/subscriptionadjustment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,UAAU,CACnD,OAAO,4BAA4B,CACpC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AACX,MAAM,MAAM,0BAA0B,GAAG,UAAU,CACjD,OAAO,0BAA0B,CAClC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,4BAA4B,CAAC;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,0BAA0B,CAAC;IACjC;;OAEG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;OAEG;IACH,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B;;OAEG;IACH,aAAa,EAAE,IAAI,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,0CAA0C,EAAE,CAAC,CAAC,aAAa,CACtE,OAAO,4BAA4B,CACS,CAAC;AAE/C,gBAAgB;AAChB,eAAO,MAAM,wCAAwC,EAAE,CAAC,CAAC,aAAa,CACpE,OAAO,0BAA0B,CACS,CAAC;AAE7C,gBAAgB;AAChB,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,OAAO,CAC1D,sBAAsB,EACtB,CAAC,CAAC,UAAU,EACZ,OAAO,CAiBP,CAAC;AAEH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAM7D"}

package/dist/esm/models/subscriptionadjustment.js

@@ -8,6 +8,7 @@ export const SubscriptionAdjustmentObject = {
 };
 export const SubscriptionAdjustmentType = {
     PercentageDiscount: "percentageDiscount",
+    UsageDiscount: "usageDiscount",
 };
 /** @internal */
 export const SubscriptionAdjustmentObject$inboundSchema = z.nativeEnum(SubscriptionAdjustmentObject);
@@ -19,7 +20,9 @@ export const SubscriptionAdjustment$inboundSchema = z.object({
     id: z.string(),
     subscriptionId: z.string(),
     type: SubscriptionAdjustmentType$inboundSchema,
-    percentageDiscount: z.string(),
+    percentageDiscount: z.nullable(z.string()),
+    usageDiscount: z.nullable(z.string()),
+    targetPriceIds: z.array(z.string()),
     effectiveFrom: z.string().datetime({ offset: true }).transform(v => new Date(v)),
     effectiveTo: z.nullable(z.string().datetime({ offset: true }).transform(v => new Date(v))),
     description: z.nullable(z.string()),

package/dist/esm/models/subscriptionadjustment.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptionadjustment.js","sourceRoot":"","sources":["../../../src/models/subscriptionadjustment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,sBAAsB,EAAE,wBAAwB;CACxC,CAAC;AAKX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAmCX,gBAAgB;AAChB,MAAM,CAAC,MAAM,0CAA0C,GAEnD,CAAC,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;AAE/C,gBAAgB;AAChB,MAAM,CAAC,MAAM,wCAAwC,GAEjD,CAAC,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAE7C,gBAAgB;AAChB,MAAM,CAAC,MAAM,oCAAoC,GAI7C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,0CAA0C;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,wCAAwC;IAC9C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CACjE,IAAI,IAAI,CAAC,CAAC,CAAC,CACZ;IACD,WAAW,EAAE,CAAC,CAAC,QAAQ,CACrB,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAClE;IACD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC5C,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,oCAAoC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAChE,oDAAoD,CACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"subscriptionadjustment.js","sourceRoot":"","sources":["../../../src/models/subscriptionadjustment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,sBAAsB,EAAE,wBAAwB;CACxC,CAAC;AAKX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;CACtB,CAAC;AA2CX,gBAAgB;AAChB,MAAM,CAAC,MAAM,0CAA0C,GAEnD,CAAC,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;AAE/C,gBAAgB;AAChB,MAAM,CAAC,MAAM,wCAAwC,GAEjD,CAAC,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAE7C,gBAAgB;AAChB,MAAM,CAAC,MAAM,oCAAoC,GAI7C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,0CAA0C;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,wCAAwC;IAC9C,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CACjE,IAAI,IAAI,CAAC,CAAC,CAAC,CACZ;IACD,WAAW,EAAE,CAAC,CAAC,QAAQ,CACrB,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAClE;IACD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;CAC7E,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC5C,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,oCAAoC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAChE,oDAAoD,CACrD,CAAC;AACJ,CAAC"}

package/dist/esm/sdk/subscriptions.d.ts

@@ -53,7 +53,7 @@ export declare class Subscriptions extends ClientSDK {
      * Create Adjustment
      *
      * @remarks
-     * Attaches a percentage discount to the subscription for a dated window. Every invoice calculated while the window is open carries one discount line for each discounted charge, and tax is assessed on the reduced amount. An invoice that already exists is not changed, including one still in draft — the discount reaches the periods that close after it is created. There is no update operation, and a window cannot be changed after it is created. To change a rate before any invoice has issued under the discount, delete the adjustment and create a replacement. Once an invoice has issued the adjustment is permanent, so set effectiveTo at creation time whenever the deal has a known end date.
+     * Attaches an adjustment to the subscription for a dated window. A percentageDiscount reduces every discountable charge by a rate and carries one discount line per charge on the invoice. A usageDiscount takes a number of usage units off one metered price's billable quantity before that line is priced, so the line re-slots on a volume ladder and shows the corrected quantity; it emits no line of its own. Tax is assessed on the reduced amount either way. An invoice that already exists is not changed, including one still in draft — the adjustment reaches the periods that close after it is created. There is no update operation, and a window cannot be changed after it is created. To change an adjustment before any invoice has issued under it, delete it and create a replacement. Once an invoice has issued the adjustment is permanent, so set effectiveTo at creation time whenever the deal has a known end date.
      */
     createSubscriptionAdjustment(request: operations.CreateSubscriptionAdjustmentRequest, options?: RequestOptions): Promise<models.SubscriptionAdjustment>;
     /**

package/dist/esm/sdk/subscriptions.js

@@ -81,7 +81,7 @@ export class Subscriptions extends ClientSDK {
      * Create Adjustment
      *
      * @remarks
-     * Attaches a percentage discount to the subscription for a dated window. Every invoice calculated while the window is open carries one discount line for each discounted charge, and tax is assessed on the reduced amount. An invoice that already exists is not changed, including one still in draft — the discount reaches the periods that close after it is created. There is no update operation, and a window cannot be changed after it is created. To change a rate before any invoice has issued under the discount, delete the adjustment and create a replacement. Once an invoice has issued the adjustment is permanent, so set effectiveTo at creation time whenever the deal has a known end date.
+     * Attaches an adjustment to the subscription for a dated window. A percentageDiscount reduces every discountable charge by a rate and carries one discount line per charge on the invoice. A usageDiscount takes a number of usage units off one metered price's billable quantity before that line is priced, so the line re-slots on a volume ladder and shows the corrected quantity; it emits no line of its own. Tax is assessed on the reduced amount either way. An invoice that already exists is not changed, including one still in draft — the adjustment reaches the periods that close after it is created. There is no update operation, and a window cannot be changed after it is created. To change an adjustment before any invoice has issued under it, delete it and create a replacement. Once an invoice has issued the adjustment is permanent, so set effectiveTo at creation time whenever the deal has a known end date.
      */
     async createSubscriptionAdjustment(request, options) {
         return unwrapAsync(subscriptionsCreateSubscriptionAdjustment(this, request, options));

package/jsr.json

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

package/package.json

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

package/src/funcs/customersList.ts

@@ -139,7 +139,7 @@ async function $do(
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["400", "403", "4XX", "500", "5XX"],
+    errorCodes: ["400", "403", "429", "4XX", "500", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
@@ -167,7 +167,7 @@ async function $do(
   >(
     M.json(200, operations.ListCustomersResponse$inboundSchema),
     M.jsonErr(400, errors.BadRequest$inboundSchema),
-    M.jsonErr(403, errors.ErrorT$inboundSchema),
+    M.jsonErr([403, 429], errors.ErrorT$inboundSchema),
     M.jsonErr(500, errors.ErrorT$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),

package/src/funcs/subscriptionsCreateSubscriptionAdjustment.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Create Adjustment
  *
  * @remarks
- * Attaches a percentage discount to the subscription for a dated window. Every invoice calculated while the window is open carries one discount line for each discounted charge, and tax is assessed on the reduced amount. An invoice that already exists is not changed, including one still in draft — the discount reaches the periods that close after it is created. There is no update operation, and a window cannot be changed after it is created. To change a rate before any invoice has issued under the discount, delete the adjustment and create a replacement. Once an invoice has issued the adjustment is permanent, so set effectiveTo at creation time whenever the deal has a known end date.
+ * Attaches an adjustment to the subscription for a dated window. A percentageDiscount reduces every discountable charge by a rate and carries one discount line per charge on the invoice. A usageDiscount takes a number of usage units off one metered price's billable quantity before that line is priced, so the line re-slots on a volume ladder and shows the corrected quantity; it emits no line of its own. Tax is assessed on the reduced amount either way. An invoice that already exists is not changed, including one still in draft — the adjustment reaches the periods that close after it is created. There is no update operation, and a window cannot be changed after it is created. To change an adjustment before any invoice has issued under it, delete it and create a replacement. Once an invoice has issued the adjustment is permanent, so set effectiveTo at creation time whenever the deal has a known end date.
  */
 export function subscriptionsCreateSubscriptionAdjustment(
   client: PaygenticCore,

package/src/funcs/subscriptionsReconcileSubscriptionFeatures.ts

@@ -143,7 +143,7 @@ async function $do(
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["400", "401", "403", "404", "4XX", "500", "5XX"],
+    errorCodes: ["400", "401", "403", "404", "429", "4XX", "500", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
@@ -171,7 +171,7 @@ async function $do(
   >(
     M.json([200, 201], models.SubscriptionReconciliation$inboundSchema),
     M.jsonErr(400, errors.BadRequest$inboundSchema),
-    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema),
+    M.jsonErr([401, 403, 404, 429], 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.9.6",
+  sdkVersion: "0.9.8",
   genVersion: "2.879.13",
-  userAgent: "speakeasy-sdk/typescript 0.9.6 2.879.13 0.1.0 @paygentic/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.9.8 2.879.13 0.1.0 @paygentic/sdk",
 } as const;

package/src/models/createpercentagediscountadjustment.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type CreatePercentageDiscountAdjustment = {
+  /**
+   * Reduces every discountable charge on the invoice by a rate.
+   */
+  type: "percentageDiscount";
+  /**
+   * The discount rate as a decimal fraction between 0 and 1, sent as a string. "0.35" means 35 percent. "1" means 100 percent, not 1 percent. At most 6 decimal places. A value of 0 or above 1 is rejected.
+   */
+  percentageDiscount: string;
+  /**
+   * The first instant the discount applies. Inclusive.
+   */
+  effectiveFrom: Date;
+  /**
+   * The instant the discount stops applying. Exclusive, so a window ending on the same date another begins neither overlaps nor leaves a gap. Null means the discount never stops, and it cannot be ended later — set an instant whenever the deal has a known end date. Must be after effectiveFrom.
+   */
+  effectiveTo?: Date | null | undefined;
+  /**
+   * The deal's own name, shown on each discount line of the invoice.
+   */
+  description?: string | null | undefined;
+  /**
+   * A key of your choosing that makes a retry safe. Sending the same key against the same subscription returns the adjustment already created and creates no second one. Without a key a retried request creates a second adjustment, and two percentage discounts compound — two of 0.35 bill 57.75 percent off, not 35 percent.
+   */
+  idempotencyKey?: string | undefined;
+};
+
+/** @internal */
+export type CreatePercentageDiscountAdjustment$Outbound = {
+  type: "percentageDiscount";
+  percentageDiscount: string;
+  effectiveFrom: string;
+  effectiveTo?: string | null | undefined;
+  description?: string | null | undefined;
+  idempotencyKey?: string | undefined;
+};
+
+/** @internal */
+export const CreatePercentageDiscountAdjustment$outboundSchema: z.ZodType<
+  CreatePercentageDiscountAdjustment$Outbound,
+  z.ZodTypeDef,
+  CreatePercentageDiscountAdjustment
+> = z.object({
+  type: z.literal("percentageDiscount"),
+  percentageDiscount: z.string(),
+  effectiveFrom: z.date().transform(v => v.toISOString()),
+  effectiveTo: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  description: z.nullable(z.string()).optional(),
+  idempotencyKey: z.string().optional(),
+});
+
+export function createPercentageDiscountAdjustmentToJSON(
+  createPercentageDiscountAdjustment: CreatePercentageDiscountAdjustment,
+): string {
+  return JSON.stringify(
+    CreatePercentageDiscountAdjustment$outboundSchema.parse(
+      createPercentageDiscountAdjustment,
+    ),
+  );
+}

package/src/models/createsubscriptionadjustmentrequest.ts

@@ -3,76 +3,38 @@
  */
 
 import * as z from "zod/v3";
-import { ClosedEnum } from "../types/enums.js";
+import {
+  CreatePercentageDiscountAdjustment,
+  CreatePercentageDiscountAdjustment$Outbound,
+  CreatePercentageDiscountAdjustment$outboundSchema,
+} from "./createpercentagediscountadjustment.js";
+import {
+  CreateUsageDiscountAdjustment,
+  CreateUsageDiscountAdjustment$Outbound,
+  CreateUsageDiscountAdjustment$outboundSchema,
+} from "./createusagediscountadjustment.js";
 
 /**
- * The kind of adjustment. `percentageDiscount` reduces every discountable charge by a rate.
+ * One adjustment to attach to the subscription. The type decides which number the body carries: a rate for percentageDiscount, a unit count and one target price for usageDiscount.
  */
-export const CreateSubscriptionAdjustmentRequestType = {
-  PercentageDiscount: "percentageDiscount",
-} as const;
-/**
- * The kind of adjustment. `percentageDiscount` reduces every discountable charge by a rate.
- */
-export type CreateSubscriptionAdjustmentRequestType = ClosedEnum<
-  typeof CreateSubscriptionAdjustmentRequestType
->;
-
-export type CreateSubscriptionAdjustmentRequest = {
-  /**
-   * The kind of adjustment. `percentageDiscount` reduces every discountable charge by a rate.
-   */
-  type: CreateSubscriptionAdjustmentRequestType;
-  /**
-   * The discount rate as a decimal fraction between 0 and 1, sent as a string. "0.35" means 35 percent. "1" means 100 percent, not 1 percent. At most 6 decimal places. A value of 0 or above 1 is rejected.
-   */
-  percentageDiscount: string;
-  /**
-   * The first instant the discount applies. Inclusive.
-   */
-  effectiveFrom: Date;
-  /**
-   * The instant the discount stops applying. Exclusive, so a window ending on the same date another begins neither overlaps nor leaves a gap. Null means the discount never stops, and it cannot be ended later — set an instant whenever the deal has a known end date. Must be after effectiveFrom.
-   */
-  effectiveTo?: Date | null | undefined;
-  /**
-   * The deal's own name, shown on each discount line of the invoice.
-   */
-  description?: string | null | undefined;
-  /**
-   * A key of your choosing that makes a retry safe. Sending the same key against the same subscription returns the adjustment already created and creates no second one. Without a key a retried request creates a second adjustment, and two percentage discounts compound — two of 0.35 bill 57.75 percent off, not 35 percent.
-   */
-  idempotencyKey?: string | undefined;
-};
-
-/** @internal */
-export const CreateSubscriptionAdjustmentRequestType$outboundSchema:
-  z.ZodNativeEnum<typeof CreateSubscriptionAdjustmentRequestType> = z
-    .nativeEnum(CreateSubscriptionAdjustmentRequestType);
+export type CreateSubscriptionAdjustmentRequest =
+  | CreatePercentageDiscountAdjustment
+  | CreateUsageDiscountAdjustment;
 
 /** @internal */
-export type CreateSubscriptionAdjustmentRequest$Outbound = {
-  type: string;
-  percentageDiscount: string;
-  effectiveFrom: string;
-  effectiveTo?: string | null | undefined;
-  description?: string | null | undefined;
-  idempotencyKey?: string | undefined;
-};
+export type CreateSubscriptionAdjustmentRequest$Outbound =
+  | CreatePercentageDiscountAdjustment$Outbound
+  | CreateUsageDiscountAdjustment$Outbound;
 
 /** @internal */
 export const CreateSubscriptionAdjustmentRequest$outboundSchema: z.ZodType<
   CreateSubscriptionAdjustmentRequest$Outbound,
   z.ZodTypeDef,
   CreateSubscriptionAdjustmentRequest
-> = z.object({
-  type: CreateSubscriptionAdjustmentRequestType$outboundSchema,
-  percentageDiscount: z.string(),
-  effectiveFrom: z.date().transform(v => v.toISOString()),
-  effectiveTo: z.nullable(z.date().transform(v => v.toISOString())).optional(),
-  description: z.nullable(z.string()).optional(),
-  idempotencyKey: z.string().optional(),
-});
+> = z.union([
+  CreatePercentageDiscountAdjustment$outboundSchema,
+  CreateUsageDiscountAdjustment$outboundSchema,
+]);
 
 export function createSubscriptionAdjustmentRequestToJSON(
   createSubscriptionAdjustmentRequest: CreateSubscriptionAdjustmentRequest,

package/src/models/createusagediscountadjustment.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type CreateUsageDiscountAdjustment = {
+  /**
+   * Reduces one metered price's billable quantity by a number of usage units, before the line is priced.
+   */
+  type: "usageDiscount";
+  /**
+   * The number of usage units to take off the billable quantity, sent as a plain decimal string. "300" waives 300 units. Greater than 0, at most 6 decimal places, fewer than 35 digits before the point. Plain notation only — no sign, exponent, hex or digit separators, so "1_000" and "1e3" are rejected rather than read as 1000. Applied in full or not at all — a unit count is never prorated across a partial window — and once per matching line, so an invoice bundling several periods is corrected on each of them. The line is floored at 0, so a discount larger than the billable quantity zeroes it rather than crediting.
+   */
+  usageDiscount: string;
+  /**
+   * Exactly one metered price of this subscription, priced as standard or volume. Usage units are not comparable across metrics, so a usage discount names the one price it reduces. A dynamic or percentage price is refused: its quantity is a monetary amount rather than a unit count. A price billing at a negative rate (a usage-scaled rebate) is refused too, because removing its units would raise the invoice.
+   */
+  targetPriceIds: Array<string>;
+  /**
+   * Opens the window. Exclusive for this type: a metered line is corrected when its period END falls after this instant, so a window opening exactly when a period ends belongs to the next period, not that one. Set it to the start of the period you are correcting.
+   */
+  effectiveFrom: Date;
+  /**
+   * Closes the window. INCLUSIVE for this type, unlike percentageDiscount: a metered line bills in arrears, so set this to the exact period end you are correcting and that period is covered. Null means the discount never stops — it then takes its full unit count off this price on EVERY later invoice, so set both bounds whenever you are correcting one period. Must be after effectiveFrom.
+   */
+  effectiveTo?: Date | null | undefined;
+  /**
+   * Your own name for this correction. A usageDiscount emits no invoice line, so this is printed nowhere on the invoice — it is returned on the adjustment for your own records.
+   */
+  description?: string | null | undefined;
+  /**
+   * A key of your choosing that makes a retry safe. Sending the same key against the same subscription returns the adjustment already created and creates no second one. Without a key a retried request creates a second adjustment, and usage discounts against one price SUM — two of "300" waive 600 units, not 300. Nothing else detects a duplicate.
+   */
+  idempotencyKey?: string | undefined;
+};
+
+/** @internal */
+export type CreateUsageDiscountAdjustment$Outbound = {
+  type: "usageDiscount";
+  usageDiscount: string;
+  targetPriceIds: Array<string>;
+  effectiveFrom: string;
+  effectiveTo?: string | null | undefined;
+  description?: string | null | undefined;
+  idempotencyKey?: string | undefined;
+};
+
+/** @internal */
+export const CreateUsageDiscountAdjustment$outboundSchema: z.ZodType<
+  CreateUsageDiscountAdjustment$Outbound,
+  z.ZodTypeDef,
+  CreateUsageDiscountAdjustment
+> = z.object({
+  type: z.literal("usageDiscount"),
+  usageDiscount: z.string(),
+  targetPriceIds: z.array(z.string()),
+  effectiveFrom: z.date().transform(v => v.toISOString()),
+  effectiveTo: z.nullable(z.date().transform(v => v.toISOString())).optional(),
+  description: z.nullable(z.string()).optional(),
+  idempotencyKey: z.string().optional(),
+});
+
+export function createUsageDiscountAdjustmentToJSON(
+  createUsageDiscountAdjustment: CreateUsageDiscountAdjustment,
+): string {
+  return JSON.stringify(
+    CreateUsageDiscountAdjustment$outboundSchema.parse(
+      createUsageDiscountAdjustment,
+    ),
+  );
+}

package/src/models/index.ts

@@ -21,8 +21,10 @@ export * from "./createmanuallineitemrequest.js";
 export * from "./createorderapprovalrequest.js";
 export * from "./createorderlineitemrequest.js";
 export * from "./createorderrequest.js";
+export * from "./createpercentagediscountadjustment.js";
 export * from "./createrulerequest.js";
 export * from "./createsubscriptionadjustmentrequest.js";
+export * from "./createusagediscountadjustment.js";
 export * from "./currencybreakdownentry.js";
 export * from "./customer.js";
 export * from "./entitlementdetail.js";
@@ -77,12 +79,14 @@ export * from "./pricefeatureinput.js";
 export * from "./pricemodel.js";
 export * from "./pricemodelinput.js";
 export * from "./priceproperties.js";
+export * from "./pricetax.js";
 export * from "./product.js";
 export * from "./profitabilityrow.js";
 export * from "./profitabilitysummaryresponse.js";
 export * from "./profitabilitytrend.js";
 export * from "./purchasegrantrequest.js";
 export * from "./purchasegrantresponse.js";
+export * from "./ratetype.js";
 export * from "./reconciledfeatureadded.js";
 export * from "./reconciledfeaturefailed.js";
 export * from "./reconciledfeatureremoved.js";

package/src/models/invoicelineitem.ts

@@ -21,6 +21,20 @@ export const EventType = {
  */
 export type EventType = ClosedEnum<typeof EventType>;
 
+/**
+ * When this line falls due relative to the window it covers: `in_advance` at the window's start, `in_arrears` at its end. A metered line is stamped `in_arrears`, because usage is only known once the window closes — but metered rows written before that rule carry `null` and were never backfilled, so do not read a metered line's term as guaranteed. `null` also means the line is not billed on a term of its own: manual, grant-discount and adjustment lines carry no term, and an adjustment instead falls due with the charge it reduces. Treat `null` as an expected value on any line type, not an error.
+ */
+export const InvoiceLineItemPaymentTerm = {
+  InAdvance: "in_advance",
+  InArrears: "in_arrears",
+} as const;
+/**
+ * When this line falls due relative to the window it covers: `in_advance` at the window's start, `in_arrears` at its end. A metered line is stamped `in_arrears`, because usage is only known once the window closes — but metered rows written before that rule carry `null` and were never backfilled, so do not read a metered line's term as guaranteed. `null` also means the line is not billed on a term of its own: manual, grant-discount and adjustment lines carry no term, and an adjustment instead falls due with the charge it reduces. Treat `null` as an expected value on any line type, not an error.
+ */
+export type InvoiceLineItemPaymentTerm = ClosedEnum<
+  typeof InvoiceLineItemPaymentTerm
+>;
+
 /**
  * Type of line item: 'charge' for regular billing, 'refund' for refunded items (amounts are negated)
  */
@@ -60,6 +74,18 @@ export type InvoiceLineItem = {
    * 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;
+  /**
+   * Start of the billed window this line covers, inclusive. Distinct from the invoice's own period, which is the union of its lines' windows (earliest start to latest end) and so covers time no single line bills on a mixed-timing invoice.
+   */
+  periodStart?: Date | undefined;
+  /**
+   * End of the billed window this line covers, exclusive — the instant at `periodEnd` belongs to the next window. Equal to `periodStart` on a one-off charge, which bills at an instant and has no period grid.
+   */
+  periodEnd?: Date | undefined;
+  /**
+   * When this line falls due relative to the window it covers: `in_advance` at the window's start, `in_arrears` at its end. A metered line is stamped `in_arrears`, because usage is only known once the window closes — but metered rows written before that rule carry `null` and were never backfilled, so do not read a metered line's term as guaranteed. `null` also means the line is not billed on a term of its own: manual, grant-discount and adjustment lines carry no term, and an adjustment instead falls due with the charge it reduces. Treat `null` as an expected value on any line type, not an error.
+   */
+  paymentTerm?: InvoiceLineItemPaymentTerm | null | undefined;
   /**
    * Display name for this line item on invoices
    */
@@ -114,6 +140,11 @@ export type InvoiceLineItem = {
 export const EventType$inboundSchema: z.ZodNativeEnum<typeof EventType> = z
   .nativeEnum(EventType);
 
+/** @internal */
+export const InvoiceLineItemPaymentTerm$inboundSchema: z.ZodNativeEnum<
+  typeof InvoiceLineItemPaymentTerm
+> = z.nativeEnum(InvoiceLineItemPaymentTerm);
+
 /** @internal */
 export const InvoiceLineItemLineItemType$inboundSchema: z.ZodNativeEnum<
   typeof InvoiceLineItemLineItemType
@@ -131,6 +162,11 @@ export const InvoiceLineItem$inboundSchema: z.ZodType<
   billableMetricId: z.string(),
   itemId: z.nullable(z.string()).optional(),
   priceId: z.nullable(z.string()).optional(),
+  periodStart: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  periodEnd: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  paymentTerm: z.nullable(InvoiceLineItemPaymentTerm$inboundSchema).optional(),
   invoiceDisplayName: z.string(),
   lineItemType: InvoiceLineItemLineItemType$inboundSchema,
   meterEventId: z.string(),

package/src/models/lineitem.ts

@@ -36,14 +36,14 @@ export const LineItemStatus = {
 export type LineItemStatus = ClosedEnum<typeof LineItemStatus>;
 
 /**
- * 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.
+ * When the line falls due relative to the window it covers. A fee line carries its price's term; a metered line is stamped `in_arrears`, though metered rows predating that rule carry `null`. Manual, grant-discount and adjustment lines are billed on no term of their own and are `null`. `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. `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.
+ * When the line falls due relative to the window it covers. A fee line carries its price's term; a metered line is stamped `in_arrears`, though metered rows predating that rule carry `null`. Manual, grant-discount and adjustment lines are billed on no term of their own and are `null`. `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>;
 
@@ -121,7 +121,11 @@ export type LineItem = {
    */
   meteredQuantity?: string | null | undefined;
   /**
-   * 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.
+   * The subscription adjustments of type `usageDiscount` that reduced this line's billable `quantity`. Empty for every other line. Where this is non-empty, `quantity` is below `meteredQuantity` because an operator waived units, rather than because a grant covered them.
+   */
+  usageDiscountIds?: Array<string> | undefined;
+  /**
+   * When the line falls due relative to the window it covers. A fee line carries its price's term; a metered line is stamped `in_arrears`, though metered rows predating that rule carry `null`. Manual, grant-discount and adjustment lines are billed on no term of their own and are `null`. `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;
   /**
@@ -196,6 +200,7 @@ export const LineItem$inboundSchema: z.ZodType<
   quantity: z.nullable(z.string()).optional(),
   unitPrice: z.string(),
   meteredQuantity: z.nullable(z.string()).optional(),
+  usageDiscountIds: z.array(z.string()).optional(),
   paymentTerm: z.nullable(LineItemPaymentTerm$inboundSchema).optional(),
   subtotal: z.string().optional(),
   taxesTotal: z.nullable(z.string()).optional(),

package/src/models/operations/createprice.ts

@@ -39,6 +39,10 @@ export type CreatePriceRequest = {
    * 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)'
    */
   invoiceDisplayName: string;
+  /**
+   * Presentation only. Prices sharing this value, within one billing period, print as a single row on the rendered invoice PDF and are described by this string. Every member still bills its own line item on the ledger, this API and the compliance document. The combined row's rate is derived from the members' own rates. Requires the 'standard' pricing model. Sample values: 'Cross Border Fees', 'FX Fees'
+   */
+  invoiceDisplayGroup?: string | null | undefined;
   /**
    * Billing timing preference: 'in_advance' (prepaid — charged upfront or drawn from a prepaid commitment) or 'in_arrears' (charged at period end).
    */
@@ -57,6 +61,14 @@ export type CreatePriceRequest = {
    * A fixed amount owed whole rather than a per-period rate. An obligation is not prorated over a partial first period: when a subscription starts before its billing anchor, no truncated stub is billed and the first charge is the full amount at the next anchor. An obligation also refuses an interval boundary that falls strictly inside one of its own billing periods, since part of an amount owed whole is not a thing to bill. Defaults to false, which is a rate and is today's behaviour for every price. Not supported on a metered price, whose amount resolves from usage at close.
    */
   isObligation?: boolean | undefined;
+  /**
+   * What properties.unitPrice is denominated in. 'amount' (the default) is an amount of the invoice currency for each unit metered, so the quantity is the multiplier. 'proportion' is the reverse: a dimensionless share of a currency-denominated quantity, so '0.02' is 2% and the invoice prints '2.00%'. Presentation only. Requires a standard metered price in real currency.
+   */
+  rateType?: models.RateType | undefined;
+  /**
+   * A price's tax declaration. Optional on write — a price that declares nothing is `IN_SCOPE`, and is billed and taxed exactly as it was before this object existed. Always present on read. Replaced as a whole on update: send the object to change it, omit it to leave it alone.
+   */
+  tax?: models.PriceTax | undefined;
   /**
    * Quantity for invoice line items. Total per period = quantity × unitPrice. Only supported for fee prices; metered prices derive quantity from usage. Defaults to 1.
    */
@@ -75,12 +87,15 @@ export type CreatePriceRequest$Outbound = {
   pricingUnitId?: string | undefined;
   model?: string | undefined;
   invoiceDisplayName: string;
+  invoiceDisplayGroup?: string | null | undefined;
   paymentTerm: string;
   billingCadence?: string | null | undefined;
   properties: models.PriceProperties$Outbound;
   feature?: models.PriceFeatureInput$Outbound | undefined;
   grantDiscountEnabled: boolean;
   isObligation: boolean;
+  rateType?: string | undefined;
+  tax?: models.PriceTax$Outbound | undefined;
   quantity?: number | undefined;
 };
 
@@ -95,12 +110,15 @@ export const CreatePriceRequest$outboundSchema: z.ZodType<
   pricingUnitId: z.string().optional(),
   model: models.PriceModelInput$outboundSchema.optional(),
   invoiceDisplayName: z.string(),
+  invoiceDisplayGroup: z.nullable(z.string()).optional(),
   paymentTerm: CreatePricePaymentTerm$outboundSchema,
   billingCadence: z.nullable(z.string()).optional(),
   properties: models.PriceProperties$outboundSchema,
   feature: models.PriceFeatureInput$outboundSchema.optional(),
   grantDiscountEnabled: z.boolean().default(false),
   isObligation: z.boolean().default(false),
+  rateType: models.RateType$outboundSchema.optional(),
+  tax: models.PriceTax$outboundSchema.optional(),
   quantity: z.number().int().optional(),
 });