@revkeen/sdk 1.20260411.859 → 1.20260412.863

package/api/resources/prices/client/requests/CreatePriceRequest.d.ts

@@ -1,3 +1,4 @@
+import type * as RevKeen from "../../../../index.js";
 /**
  * @example
  *     {
@@ -33,6 +34,13 @@ export interface CreatePriceRequest {
     nickname?: string;
     /** Stable key for API lookups */
     lookup_key?: string;
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` with `tiers_mode` + `tiers` for graduated or volume pricing. */
+    billing_scheme?: CreatePriceRequest.BillingScheme;
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be omitted otherwise. */
+    tiers_mode?: CreatePriceRequest.TiersMode;
+    /** Price tiers (ordered by `up_to`, min 2, max 50). Required when `billing_scheme` is `tiered`. Final tier MUST have `up_to: null`. */
+    tiers?: RevKeen.PriceTier[];
+    transform_quantity?: RevKeen.TransformQuantity;
     /** Custom key-value metadata */
     metadata?: Record<string, unknown>;
 }
@@ -58,5 +66,17 @@ export declare namespace CreatePriceRequest {
         readonly Year: "year";
     };
     type Interval = (typeof Interval)[keyof typeof Interval];
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` with `tiers_mode` + `tiers` for graduated or volume pricing. */
+    const BillingScheme: {
+        readonly PerUnit: "per_unit";
+        readonly Tiered: "tiered";
+    };
+    type BillingScheme = (typeof BillingScheme)[keyof typeof BillingScheme];
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be omitted otherwise. */
+    const TiersMode: {
+        readonly Graduated: "graduated";
+        readonly Volume: "volume";
+    };
+    type TiersMode = (typeof TiersMode)[keyof typeof TiersMode];
 }
 //# sourceMappingURL=CreatePriceRequest.d.ts.map

package/api/resources/prices/client/requests/CreatePriceRequest.js

@@ -19,5 +19,15 @@ export var CreatePriceRequest;
         Month: "month",
         Year: "year",
     };
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` with `tiers_mode` + `tiers` for graduated or volume pricing. */
+    CreatePriceRequest.BillingScheme = {
+        PerUnit: "per_unit",
+        Tiered: "tiered",
+    };
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be omitted otherwise. */
+    CreatePriceRequest.TiersMode = {
+        Graduated: "graduated",
+        Volume: "volume",
+    };
 })(CreatePriceRequest || (CreatePriceRequest = {}));
 //# sourceMappingURL=CreatePriceRequest.js.map

package/api/resources/prices/client/requests/CreatePriceRequest.ts

@@ -1,5 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+import type * as RevKeen from "../../../../index.js";
+
 /**
  * @example
  *     {
@@ -35,6 +37,13 @@ export interface CreatePriceRequest {
     nickname?: string;
     /** Stable key for API lookups */
     lookup_key?: string;
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` with `tiers_mode` + `tiers` for graduated or volume pricing. */
+    billing_scheme?: CreatePriceRequest.BillingScheme;
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be omitted otherwise. */
+    tiers_mode?: CreatePriceRequest.TiersMode;
+    /** Price tiers (ordered by `up_to`, min 2, max 50). Required when `billing_scheme` is `tiered`. Final tier MUST have `up_to: null`. */
+    tiers?: RevKeen.PriceTier[];
+    transform_quantity?: RevKeen.TransformQuantity;
     /** Custom key-value metadata */
     metadata?: Record<string, unknown>;
 }
@@ -61,4 +70,16 @@ export namespace CreatePriceRequest {
         Year: "year",
     } as const;
     export type Interval = (typeof Interval)[keyof typeof Interval];
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` with `tiers_mode` + `tiers` for graduated or volume pricing. */
+    export const BillingScheme = {
+        PerUnit: "per_unit",
+        Tiered: "tiered",
+    } as const;
+    export type BillingScheme = (typeof BillingScheme)[keyof typeof BillingScheme];
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be omitted otherwise. */
+    export const TiersMode = {
+        Graduated: "graduated",
+        Volume: "volume",
+    } as const;
+    export type TiersMode = (typeof TiersMode)[keyof typeof TiersMode];
 }

package/api/types/Price.d.ts

@@ -1,3 +1,4 @@
+import type * as RevKeen from "../index.js";
 /**
  * A price defines how much and how often to charge for a product. A single product can have multiple prices for different currencies, intervals, or tiers.
  */
@@ -36,6 +37,14 @@ export interface Price {
     nickname?: string | null;
     /** Stable key for API lookups */
     lookup_key?: string | null;
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` along with `tiers_mode` + `tiers` to use graduated or volume pricing. */
+    billing_scheme: Price.BillingScheme;
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be null otherwise. */
+    tiers_mode?: Price.TiersMode | null;
+    /** Price tiers (ordered by `up_to`). Present only when `billing_scheme` is `tiered`. At least 2 tiers, final tier MUST have `up_to: null`. Immutable after creation. */
+    tiers?: RevKeen.PriceTier[] | null;
+    /** Optional quantity transform (package pricing) applied before tier lookup. Immutable after creation. */
+    transform_quantity?: Price.TransformQuantity | null;
     /** Custom key-value metadata */
     metadata?: Record<string, unknown>;
     /** Creation timestamp */
@@ -70,5 +79,34 @@ export declare namespace Price {
         readonly Year: "year";
     };
     type Interval = (typeof Interval)[keyof typeof Interval];
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` along with `tiers_mode` + `tiers` to use graduated or volume pricing. */
+    const BillingScheme: {
+        readonly PerUnit: "per_unit";
+        readonly Tiered: "tiered";
+    };
+    type BillingScheme = (typeof BillingScheme)[keyof typeof BillingScheme];
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be null otherwise. */
+    const TiersMode: {
+        readonly Graduated: "graduated";
+        readonly Volume: "volume";
+    };
+    type TiersMode = (typeof TiersMode)[keyof typeof TiersMode];
+    /**
+     * Optional quantity transform (package pricing) applied before tier lookup. Immutable after creation.
+     */
+    interface TransformQuantity {
+        /** Package size — quantity is divided by this value before pricing. Must be >= 1. Example: `divide_by: 10` with `round: up` charges per pack of 10. */
+        divide_by: number;
+        /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+        round: TransformQuantity.Round;
+    }
+    namespace TransformQuantity {
+        /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+        const Round: {
+            readonly Up: "up";
+            readonly Down: "down";
+        };
+        type Round = (typeof Round)[keyof typeof Round];
+    }
 }
 //# sourceMappingURL=Price.d.ts.map

package/api/types/Price.js

@@ -23,5 +23,23 @@ export var Price;
         Month: "month",
         Year: "year",
     };
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` along with `tiers_mode` + `tiers` to use graduated or volume pricing. */
+    Price.BillingScheme = {
+        PerUnit: "per_unit",
+        Tiered: "tiered",
+    };
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be null otherwise. */
+    Price.TiersMode = {
+        Graduated: "graduated",
+        Volume: "volume",
+    };
+    let TransformQuantity;
+    (function (TransformQuantity) {
+        /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+        TransformQuantity.Round = {
+            Up: "up",
+            Down: "down",
+        };
+    })(TransformQuantity = Price.TransformQuantity || (Price.TransformQuantity = {}));
 })(Price || (Price = {}));
 //# sourceMappingURL=Price.js.map

package/api/types/Price.ts

@@ -1,5 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 
+import type * as RevKeen from "../index.js";
+
 /**
  * A price defines how much and how often to charge for a product. A single product can have multiple prices for different currencies, intervals, or tiers.
  */
@@ -38,6 +40,14 @@ export interface Price {
     nickname?: string | null;
     /** Stable key for API lookups */
     lookup_key?: string | null;
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` along with `tiers_mode` + `tiers` to use graduated or volume pricing. */
+    billing_scheme: Price.BillingScheme;
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be null otherwise. */
+    tiers_mode?: Price.TiersMode | null;
+    /** Price tiers (ordered by `up_to`). Present only when `billing_scheme` is `tiered`. At least 2 tiers, final tier MUST have `up_to: null`. Immutable after creation. */
+    tiers?: RevKeen.PriceTier[] | null;
+    /** Optional quantity transform (package pricing) applied before tier lookup. Immutable after creation. */
+    transform_quantity?: Price.TransformQuantity | null;
     /** Custom key-value metadata */
     metadata?: Record<string, unknown>;
     /** Creation timestamp */
@@ -73,4 +83,35 @@ export namespace Price {
         Year: "year",
     } as const;
     export type Interval = (typeof Interval)[keyof typeof Interval];
+    /** Billing scheme. Defaults to `per_unit`. Set to `tiered` along with `tiers_mode` + `tiers` to use graduated or volume pricing. */
+    export const BillingScheme = {
+        PerUnit: "per_unit",
+        Tiered: "tiered",
+    } as const;
+    export type BillingScheme = (typeof BillingScheme)[keyof typeof BillingScheme];
+    /** Tiered pricing mode. Required when `billing_scheme` is `tiered`, must be null otherwise. */
+    export const TiersMode = {
+        Graduated: "graduated",
+        Volume: "volume",
+    } as const;
+    export type TiersMode = (typeof TiersMode)[keyof typeof TiersMode];
+
+    /**
+     * Optional quantity transform (package pricing) applied before tier lookup. Immutable after creation.
+     */
+    export interface TransformQuantity {
+        /** Package size — quantity is divided by this value before pricing. Must be >= 1. Example: `divide_by: 10` with `round: up` charges per pack of 10. */
+        divide_by: number;
+        /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+        round: TransformQuantity.Round;
+    }
+
+    export namespace TransformQuantity {
+        /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+        export const Round = {
+            Up: "up",
+            Down: "down",
+        } as const;
+        export type Round = (typeof Round)[keyof typeof Round];
+    }
 }

package/api/types/PriceTier.d.ts

@@ -0,0 +1,9 @@
+export interface PriceTier {
+    /** Upper bound of this tier (1-based inclusive). `null` = open-ended catch-all. Only the FINAL tier may set `up_to: null`. */
+    up_to: number | null;
+    /** Per-unit charge in minor currency units (cents). May be null if the tier charges only a flat fee. */
+    unit_amount_minor: number | null;
+    /** Flat fee charged once when quantity enters this tier. May be null if the tier charges only a per-unit amount. */
+    flat_amount_minor: number | null;
+}
+//# sourceMappingURL=PriceTier.d.ts.map

package/api/types/PriceTier.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};
+//# sourceMappingURL=PriceTier.js.map

package/api/types/PriceTier.ts

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface PriceTier {
+    /** Upper bound of this tier (1-based inclusive). `null` = open-ended catch-all. Only the FINAL tier may set `up_to: null`. */
+    up_to: number | null;
+    /** Per-unit charge in minor currency units (cents). May be null if the tier charges only a flat fee. */
+    unit_amount_minor: number | null;
+    /** Flat fee charged once when quantity enters this tier. May be null if the tier charges only a per-unit amount. */
+    flat_amount_minor: number | null;
+}

package/api/types/TransformQuantity.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Optional quantity transform (package pricing) applied before tier lookup.
+ */
+export interface TransformQuantity {
+    /** Package size — quantity is divided by this value before pricing. Must be >= 1. Example: `divide_by: 10` with `round: up` charges per pack of 10. */
+    divide_by: number;
+    /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+    round: TransformQuantity.Round;
+}
+export declare namespace TransformQuantity {
+    /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+    const Round: {
+        readonly Up: "up";
+        readonly Down: "down";
+    };
+    type Round = (typeof Round)[keyof typeof Round];
+}
+//# sourceMappingURL=TransformQuantity.d.ts.map

package/api/types/TransformQuantity.js

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var TransformQuantity;
+(function (TransformQuantity) {
+    /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+    TransformQuantity.Round = {
+        Up: "up",
+        Down: "down",
+    };
+})(TransformQuantity || (TransformQuantity = {}));
+//# sourceMappingURL=TransformQuantity.js.map

package/api/types/TransformQuantity.ts

@@ -0,0 +1,20 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * Optional quantity transform (package pricing) applied before tier lookup.
+ */
+export interface TransformQuantity {
+    /** Package size — quantity is divided by this value before pricing. Must be >= 1. Example: `divide_by: 10` with `round: up` charges per pack of 10. */
+    divide_by: number;
+    /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+    round: TransformQuantity.Round;
+}
+
+export namespace TransformQuantity {
+    /** Rounding mode when quantity is not an exact multiple of `divide_by`. */
+    export const Round = {
+        Up: "up",
+        Down: "down",
+    } as const;
+    export type Round = (typeof Round)[keyof typeof Round];
+}

package/api/types/index.d.ts

@@ -98,6 +98,7 @@ export * from "./PhaseItem.js";
 export * from "./Price.js";
 export * from "./PriceErrorResponse.js";
 export * from "./PriceListResponse.js";
+export * from "./PriceTier.js";
 export * from "./Product.js";
 export * from "./ProductCreateResponse.js";
 export * from "./ProductErrorResponse.js";
@@ -146,6 +147,7 @@ export * from "./Transaction.js";
 export * from "./TransactionListResponse.js";
 export * from "./TransactionRetrieveResponse.js";
 export * from "./TransactionReversalEligibilityResponse.js";
+export * from "./TransformQuantity.js";
 export * from "./UnauthorizedErrorBody.js";
 export * from "./UpdateMeterResponse.js";
 export * from "./UsageAggregateResponse.js";

package/api/types/index.js

@@ -98,6 +98,7 @@ export * from "./PhaseItem.js";
 export * from "./Price.js";
 export * from "./PriceErrorResponse.js";
 export * from "./PriceListResponse.js";
+export * from "./PriceTier.js";
 export * from "./Product.js";
 export * from "./ProductCreateResponse.js";
 export * from "./ProductErrorResponse.js";
@@ -146,6 +147,7 @@ export * from "./Transaction.js";
 export * from "./TransactionListResponse.js";
 export * from "./TransactionRetrieveResponse.js";
 export * from "./TransactionReversalEligibilityResponse.js";
+export * from "./TransformQuantity.js";
 export * from "./UnauthorizedErrorBody.js";
 export * from "./UpdateMeterResponse.js";
 export * from "./UsageAggregateResponse.js";

package/api/types/index.ts

@@ -98,6 +98,7 @@ export * from "./PhaseItem.js";
 export * from "./Price.js";
 export * from "./PriceErrorResponse.js";
 export * from "./PriceListResponse.js";
+export * from "./PriceTier.js";
 export * from "./Product.js";
 export * from "./ProductCreateResponse.js";
 export * from "./ProductErrorResponse.js";
@@ -146,6 +147,7 @@ export * from "./Transaction.js";
 export * from "./TransactionListResponse.js";
 export * from "./TransactionRetrieveResponse.js";
 export * from "./TransactionReversalEligibilityResponse.js";
+export * from "./TransformQuantity.js";
 export * from "./UnauthorizedErrorBody.js";
 export * from "./UpdateMeterResponse.js";
 export * from "./UsageAggregateResponse.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revkeen/sdk",
-  "version": "1.20260411.859",
+  "version": "1.20260412.863",
   "description": "RevKeen API SDK - Stripe-like billing infrastructure for your SaaS",
   "main": "./index.js",
   "types": "./index.d.ts",