@paygentic/sdk 0.9.11 → 0.9.12

package/src/models/grouptrendentry.ts

@@ -17,7 +17,7 @@ export type GroupTrendEntry = {
    */
   groupLabel: string;
   /**
-   * Total issued invoice amount in dollars for this group in this bucket
+   * Total issued invoice amount in dollars for this group in this bucket, excluding tax
    */
   issuedInvoices: string;
 };

package/src/models/index.ts

@@ -18,6 +18,8 @@ export * from "./createapprovalrequest.js";
 export * from "./createbillingschedulerequest.js";
 export * from "./creategrantrequest.js";
 export * from "./createmanuallineitemrequest.js";
+export * from "./createmaximumquantityadjustment.js";
+export * from "./createminimumquantityadjustment.js";
 export * from "./createorderapprovalrequest.js";
 export * from "./createorderlineitemrequest.js";
 export * from "./createorderrequest.js";

package/src/models/invoicecategorysummary.ts

@@ -13,7 +13,7 @@ export type InvoiceCategorySummary = {
    */
   count: number;
   /**
-   * Total amount of invoices in this category in dollars
+   * Total amount of invoices in this category in dollars, including tax
    */
   amount: string;
 };

package/src/models/operations/createbillablemetric.ts

@@ -56,9 +56,9 @@ export type CreateBillableMetricRequest = {
   /**
    * CloudEvents type for meter routing. Links this billable metric to the metering service.
    */
-  eventType?: string | undefined;
+  eventType: string;
   /**
-   * JSONPath to extract a numeric value from event data. Must start with `$.` (example: `$.amount` or `$.payload.bytes`). Required for SUM/AVG/MIN/MAX/LATEST aggregations.
+   * JSONPath to extract a numeric value from event data. Must start with `$.` (example: `$.amount` or `$.payload.bytes`). Required for SUM/AVG/MIN/MAX/LATEST aggregations. Optional for UNIQUE_COUNT, which counts distinct values of this property when set and distinct events when not. Not stored for COUNT.
    */
   valueProperty?: string | undefined;
   /**
@@ -85,7 +85,7 @@ export type CreateBillableMetricRequest$Outbound = {
   productId?: string | undefined;
   itemId?: string | undefined;
   unit: string;
-  eventType?: string | undefined;
+  eventType: string;
   valueProperty?: string | undefined;
   groupBy?: { [k: string]: string } | undefined;
   eventFrom?: string | undefined;
@@ -104,7 +104,7 @@ export const CreateBillableMetricRequest$outboundSchema: z.ZodType<
   productId: z.string().optional(),
   itemId: z.string().optional(),
   unit: z.string(),
-  eventType: z.string().optional(),
+  eventType: z.string(),
   valueProperty: z.string().optional(),
   groupBy: z.record(z.string()).optional(),
   eventFrom: z.date().transform(v => v.toISOString()).optional(),

package/src/models/operations/createtestclock.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v3";
 
 export type CreateTestClockRequest = {
   /**
-   * Initial time for the test clock (defaults to current time). Cannot be more than 1 hour in the past to prevent accidental backdating. The 1-hour buffer accounts for clock drift and network delays.
+   * Initial time for the test clock (defaults to current time). May be in the past, which lets a subscription on the clock start on a past date and bill its periods as the clock advances.
    */
   currentTime?: Date | undefined;
   /**

package/src/models/operations/updatebillablemetric.ts

@@ -23,11 +23,11 @@ export type UpdateBillableMetricRequestBody = {
    */
   itemId?: string | null | undefined;
   /**
-   * CloudEvents type for meter routing.
+   * CloudEvents type for meter routing. Cannot be cleared: every billable metric needs one.
    */
-  eventType?: string | null | undefined;
+  eventType?: string | undefined;
   /**
-   * JSONPath to extract a numeric value from event data. Must start with `$.` (example: `$.amount` or `$.payload.bytes`).
+   * JSONPath to extract a numeric value from event data. Must start with `$.` (example: `$.amount` or `$.payload.bytes`). Cannot be cleared on a SUM/AVG/MIN/MAX/LATEST metric. Not stored for COUNT.
    */
   valueProperty?: string | null | undefined;
   /**
@@ -51,7 +51,7 @@ export type UpdateBillableMetricRequestBody$Outbound = {
   name?: string | undefined;
   unit?: string | undefined;
   itemId?: string | null | undefined;
-  eventType?: string | null | undefined;
+  eventType?: string | undefined;
   valueProperty?: string | null | undefined;
   groupBy?: { [k: string]: string } | null | undefined;
   eventFrom?: string | null | undefined;
@@ -67,7 +67,7 @@ export const UpdateBillableMetricRequestBody$outboundSchema: z.ZodType<
   name: z.string().optional(),
   unit: z.string().optional(),
   itemId: z.nullable(z.string()).optional(),
-  eventType: z.nullable(z.string()).optional(),
+  eventType: z.string().optional(),
   valueProperty: z.nullable(z.string()).optional(),
   groupBy: z.nullable(z.record(z.string())).optional(),
   eventFrom: z.nullable(z.date().transform(v => v.toISOString())).optional(),

package/src/models/profitabilityrow.ts

@@ -21,7 +21,7 @@ export type ProfitabilityRow = {
    */
   customerName: string;
   /**
-   * Net revenue (paid + outstanding) in unit currency, with two decimals.
+   * Revenue excluding tax (paid + outstanding invoices issued in the period), in unit currency, with two decimals.
    */
   netRevenue: string;
   /**

package/src/models/revenuesummaryresponse.ts

@@ -47,11 +47,11 @@ export type RevenueSummaryResponse = {
    */
   object: "revenue_summary";
   /**
-   * Net collected revenue in dollars (paid invoices + completed payments), already net of non-voided refunds. Omitted when groupBy=currency is active.
+   * Revenue in dollars, excluding tax: invoices issued in the period plus completed payments, less non-voided refunds issued in the period. Invoices and refunds are counted excluding tax. Omitted when groupBy=currency is active.
    */
   netRevenue?: string | undefined;
   /**
-   * Gross total of non-voided refunds (credit notes) issued in the period, in dollars. Already subtracted from netRevenue and invoice totals. Omitted when groupBy=currency is active.
+   * Total of non-voided refunds (credit notes) issued in the period, in dollars, including tax. netRevenue subtracts these refunds excluding tax. Omitted when groupBy=currency is active.
    */
   totalRefunds?: string | undefined;
   /**

package/src/models/revenuetrendbucket.ts

@@ -17,7 +17,7 @@ export type RevenueTrendBucket = {
    */
   timestamp: Date;
   /**
-   * Total amount of all invoices issued in this bucket (all statuses, by issuedAt)
+   * Total amount of all invoices issued in this bucket (all statuses, by issuedAt), excluding tax
    */
   issuedInvoices: string;
   /**

package/src/models/subscriptionadjustment.ts

@@ -18,6 +18,8 @@ export type SubscriptionAdjustmentObject = ClosedEnum<
 export const SubscriptionAdjustmentType = {
   PercentageDiscount: "percentageDiscount",
   UsageDiscount: "usageDiscount",
+  MinimumQuantity: "minimumQuantity",
+  MaximumQuantity: "maximumQuantity",
 } as const;
 export type SubscriptionAdjustmentType = ClosedEnum<
   typeof SubscriptionAdjustmentType
@@ -35,27 +37,35 @@ export type SubscriptionAdjustment = {
   subscriptionId: string;
   type: SubscriptionAdjustmentType;
   /**
-   * 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.
+   * The discount rate as a decimal fraction between 0 and 1. "0.35" means 35 percent. Null on every other type.
    */
   percentageDiscount: string | null;
   /**
-   * The number of usage units taken off the targeted line's billable quantity. Null on a percentageDiscount, which carries a rate instead.
+   * The number of usage units taken off the targeted line's billable quantity. Null on every other type.
    */
   usageDiscount: string | null;
   /**
-   * The prices this adjustment reduces. Exactly one metered price on a usageDiscount; empty on a percentageDiscount, which reduces every discountable charge.
+   * The contracted minimum quantity billed for one period of the targeted price. Null on every other type.
+   */
+  minimumQuantity: string | null;
+  /**
+   * The contracted maximum quantity billed for one period of the targeted price. Null on every other type.
+   */
+  maximumQuantity: string | null;
+  /**
+   * The prices this adjustment applies to. Exactly one price on a usageDiscount; empty on a percentageDiscount, which reduces every discountable charge. A minimumQuantity or maximumQuantity is created against exactly one price, and later lists more than one only where that charge moved to a new price — a floating subscription moving to a new plan version, or a price edit freezing the subscription's version. Every id listed is the same charge, and the bound applies to whichever one a period bills under.
    */
   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.
+   * Opens the window. Read per type: INCLUSIVE on a percentageDiscount, whose window is prorated by day overlap; EXCLUSIVE on a usageDiscount and on both quantity bounds, which apply to a line whose period END falls strictly after this instant.
    */
   effectiveFrom: Date;
   /**
-   * 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.
+   * Closes the window, or null for never. Read per type: EXCLUSIVE on a percentageDiscount; INCLUSIVE on a usageDiscount and on both quantity bounds, which apply to a line whose period END falls on or before this instant. A delete shortens this to the end of the last period the adjustment has already been billed on.
    */
   effectiveTo: Date | null;
   /**
-   * 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.
+   * The deal's own name. Shown on each discount line a percentageDiscount emits; every other type emits no line, so its description is carried here only.
    */
   description: string | null;
   createdAt: Date;
@@ -83,6 +93,8 @@ export const SubscriptionAdjustment$inboundSchema: z.ZodType<
   type: SubscriptionAdjustmentType$inboundSchema,
   percentageDiscount: z.nullable(z.string()),
   usageDiscount: z.nullable(z.string()),
+  minimumQuantity: z.nullable(z.string()),
+  maximumQuantity: z.nullable(z.string()),
   targetPriceIds: z.array(z.string()),
   effectiveFrom: z.string().datetime({ offset: true }).transform(v =>
     new Date(v)

package/src/sdk/subscriptions.ts

@@ -166,12 +166,12 @@ export class Subscriptions extends ClientSDK {
    * Delete Adjustment
    *
    * @remarks
-   * Deletes an adjustment that has not yet reached an issued invoice. No invoice changes: an invoice still in draft keeps its numbers, and loses the discount only when its period is calculated again. An adjustment that has already discounted an issued invoice cannot be deleted, because the invoice records why the customer was charged that amount. Its window cannot be shortened afterwards either, so set effectiveTo at creation time whenever the deal has a known end date.
+   * Stops an adjustment from applying to any period it has not already been billed on. An adjustment that has never reached an issued invoice is removed, and the response is 204. An adjustment that has already been billed on an issued invoice is RETRACTED instead: its effectiveTo moves to the end of the last period it was billed on, the adjustment still exists, and the response is 200 carrying it. Read a 200 as "shortened", not as "removed". No invoice changes either way: an issued invoice keeps its numbers, and a draft loses the adjustment only when its period is calculated again. Deleting the same adjustment again returns the same 200 and the same window.
    */
   async deleteSubscriptionAdjustment(
     request: operations.DeleteSubscriptionAdjustmentRequest,
     options?: RequestOptions,
-  ): Promise<void> {
+  ): Promise<models.SubscriptionAdjustment | undefined> {
     return unwrapAsync(subscriptionsDeleteSubscriptionAdjustment(
       this,
       request,