@nirvana-labs/nirvana 1.95.3 → 1.96.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.96.0](https://github.com/nirvana-labs/nirvana-typescript/compare/v1.95.3...v1.96.0) (2026-07-22)
+
+
+### Features
+
+* **stainless:** add recharge_policy group to SDK config ([6f980be](https://github.com/nirvana-labs/nirvana-typescript/commit/6f980be1346829f1830b36100a6d20f2a4cb9f33))
+
 ## [1.95.3](https://github.com/nirvana-labs/nirvana-typescript/compare/v1.95.2...v1.95.3) (2026-07-22)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nirvana-labs/nirvana",
-  "version": "1.95.3",
+  "version": "1.96.0",
   "description": "The official TypeScript library for the Nirvana Labs API",
   "author": "Nirvana Labs <engineering@nirvanalabs.io>",
   "types": "./index.d.ts",

package/resources/organizations/billing/billing.d.mts

@@ -0,0 +1,208 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as Shared from "../../shared.mjs";
+import * as RechargePolicyAPI from "./recharge-policy.mjs";
+import { AutomaticPolicyArgs, OrganizationRechargePolicy, RechargePolicy, RechargePolicyMode, RechargePolicyUpdateParams } from "./recharge-policy.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Billing extends APIResource {
+    rechargePolicy: RechargePolicyAPI.RechargePolicy;
+    /**
+     * Get the organization's billing summary: effective balance, monthly and daily
+     * run-rate cost, runway, and the projected next-recharge date. Costs are run-rate
+     * projections.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.summary(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    summary(organizationID: string, options?: RequestOptions): APIPromise<Shared.OrganizationBillingSummary>;
+    /**
+     * Get the organization's total usage cost per UTC day over a date range (max 90
+     * days), summing open and closed resources. One entry per day, oldest first.
+     * Defaults to the last 30 days.
+     *
+     * @example
+     * ```ts
+     * const organizationDailyCost =
+     *   await client.organizations.billing.cost(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    cost(organizationID: string, query?: BillingCostParams | null | undefined, options?: RequestOptions): APIPromise<OrganizationDailyCost>;
+    /**
+     * List the organization's billing history: prepaid credits, top-ups, and manual
+     * adjustments, newest first. Paginated with an opaque cursor.
+     *
+     * @example
+     * ```ts
+     * const billingHistoryEntryList =
+     *   await client.organizations.billing.history(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    history(organizationID: string, query?: BillingHistoryParams | null | undefined, options?: RequestOptions): APIPromise<BillingHistoryEntryList>;
+    /**
+     * Charge the card on file and credit the prepaid balance. A unique Idempotency-Key
+     * header is required; reuse it across retries so a timed-out top-up is not charged
+     * twice.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.topUp(
+     *     'organization_id',
+     *     {
+     *       amount: '50.00',
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *     },
+     *   );
+     * ```
+     */
+    topUp(organizationID: string, params: BillingTopUpParams, options?: RequestOptions): APIPromise<Shared.OrganizationBillingSummary>;
+    /**
+     * Charge the card on file up to the recharge target now instead of waiting for the
+     * scheduled retry. Automatic-policy prepaid organizations only. Idempotency-Key
+     * header required.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.recharge(
+     *     'organization_id',
+     *     { 'Idempotency-Key': 'Idempotency-Key' },
+     *   );
+     * ```
+     */
+    recharge(organizationID: string, params: BillingRechargeParams, options?: RequestOptions): APIPromise<Shared.OrganizationBillingSummary>;
+}
+/**
+ * A single billing history line item: a prepaid credit or a manual adjustment.
+ */
+export interface BillingHistoryEntry {
+    /**
+     * Unique identifier for the entry.
+     */
+    id: string;
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    amount: string;
+    /**
+     * When the entry was recorded.
+     */
+    created_at: string;
+    /**
+     * ISO 4217 currency code.
+     */
+    currency: string;
+    /**
+     * Kind of entry.
+     */
+    type: BillingHistoryEntryType;
+    /**
+     * Human-readable note describing the entry, when available.
+     */
+    description?: string | null;
+    /**
+     * Link to the hosted receipt for the payment behind this entry, when one is
+     * available. Present for prepaid credits funded by a card charge; absent for
+     * manual adjustments and while a payment's receipt is still being finalized.
+     */
+    receipt_url?: string | null;
+}
+export interface BillingHistoryEntryList {
+    items: Array<BillingHistoryEntry>;
+    /**
+     * Pagination response details.
+     */
+    pagination: Shared.Pagination;
+}
+/**
+ * Kind of entry.
+ */
+export type BillingHistoryEntryType = 'grant' | 'adjustment';
+/**
+ * Total usage cost for a single UTC day.
+ */
+export interface DailyCostPoint {
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    cost: string;
+    /**
+     * UTC calendar day (YYYY-MM-DD).
+     */
+    date: string;
+}
+/**
+ * Daily usage cost over a date range: one entry per UTC day (zero on idle days),
+ * summing open and closed resources. Suitable for a daily cost bar chart.
+ */
+export interface OrganizationDailyCost {
+    /**
+     * ISO 4217 currency code.
+     */
+    currency: string;
+    /**
+     * One entry per UTC day in the range, oldest first.
+     */
+    days: Array<DailyCostPoint>;
+    /**
+     * Inclusive start of the range, as a UTC calendar day (YYYY-MM-DD).
+     */
+    from: string;
+    /**
+     * Inclusive end of the range, as a UTC calendar day (YYYY-MM-DD).
+     */
+    to: string;
+}
+export interface BillingCostParams {
+    /**
+     * Inclusive start day, YYYY-MM-DD (UTC). Defaults to 30 days before to.
+     */
+    from?: string;
+    /**
+     * Inclusive end day, YYYY-MM-DD (UTC). Defaults to today.
+     */
+    to?: string;
+}
+export interface BillingHistoryParams {
+    /**
+     * Pagination cursor returned by a previous request
+     */
+    cursor?: string;
+    /**
+     * Maximum number of items to return
+     */
+    limit?: number;
+}
+export interface BillingTopUpParams {
+    /**
+     * Body param: Amount to charge and credit, in USD. Must be greater than 0, at most
+     * two decimal places, and at most 10000.
+     */
+    amount: string;
+    /**
+     * Header param: Unique idempotency key scoping the charge; reuse the same value
+     * across retries so a timed-out top-up is not charged twice
+     */
+    'Idempotency-Key': string;
+}
+export interface BillingRechargeParams {
+    /**
+     * Idempotency key scoping one charge attempt; reuse to retry it, but use a fresh
+     * key for a new attempt (e.g. after updating a declined card)
+     */
+    'Idempotency-Key': string;
+}
+export declare namespace Billing {
+    export { type BillingHistoryEntry as BillingHistoryEntry, type BillingHistoryEntryList as BillingHistoryEntryList, type BillingHistoryEntryType as BillingHistoryEntryType, type DailyCostPoint as DailyCostPoint, type OrganizationDailyCost as OrganizationDailyCost, type BillingCostParams as BillingCostParams, type BillingHistoryParams as BillingHistoryParams, type BillingTopUpParams as BillingTopUpParams, type BillingRechargeParams as BillingRechargeParams, };
+    export { RechargePolicy as RechargePolicy, type AutomaticPolicyArgs as AutomaticPolicyArgs, type OrganizationRechargePolicy as OrganizationRechargePolicy, type RechargePolicyMode as RechargePolicyMode, type RechargePolicyUpdateParams as RechargePolicyUpdateParams, };
+}
+//# sourceMappingURL=billing.d.mts.map

package/resources/organizations/billing/billing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.mts","sourceRoot":"","sources":["../../../src/resources/organizations/billing/billing.ts"],"names":[],"mappings":"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"}

package/resources/organizations/billing/billing.d.ts

@@ -0,0 +1,208 @@
+import { APIResource } from "../../../core/resource.js";
+import * as Shared from "../../shared.js";
+import * as RechargePolicyAPI from "./recharge-policy.js";
+import { AutomaticPolicyArgs, OrganizationRechargePolicy, RechargePolicy, RechargePolicyMode, RechargePolicyUpdateParams } from "./recharge-policy.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Billing extends APIResource {
+    rechargePolicy: RechargePolicyAPI.RechargePolicy;
+    /**
+     * Get the organization's billing summary: effective balance, monthly and daily
+     * run-rate cost, runway, and the projected next-recharge date. Costs are run-rate
+     * projections.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.summary(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    summary(organizationID: string, options?: RequestOptions): APIPromise<Shared.OrganizationBillingSummary>;
+    /**
+     * Get the organization's total usage cost per UTC day over a date range (max 90
+     * days), summing open and closed resources. One entry per day, oldest first.
+     * Defaults to the last 30 days.
+     *
+     * @example
+     * ```ts
+     * const organizationDailyCost =
+     *   await client.organizations.billing.cost(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    cost(organizationID: string, query?: BillingCostParams | null | undefined, options?: RequestOptions): APIPromise<OrganizationDailyCost>;
+    /**
+     * List the organization's billing history: prepaid credits, top-ups, and manual
+     * adjustments, newest first. Paginated with an opaque cursor.
+     *
+     * @example
+     * ```ts
+     * const billingHistoryEntryList =
+     *   await client.organizations.billing.history(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    history(organizationID: string, query?: BillingHistoryParams | null | undefined, options?: RequestOptions): APIPromise<BillingHistoryEntryList>;
+    /**
+     * Charge the card on file and credit the prepaid balance. A unique Idempotency-Key
+     * header is required; reuse it across retries so a timed-out top-up is not charged
+     * twice.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.topUp(
+     *     'organization_id',
+     *     {
+     *       amount: '50.00',
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *     },
+     *   );
+     * ```
+     */
+    topUp(organizationID: string, params: BillingTopUpParams, options?: RequestOptions): APIPromise<Shared.OrganizationBillingSummary>;
+    /**
+     * Charge the card on file up to the recharge target now instead of waiting for the
+     * scheduled retry. Automatic-policy prepaid organizations only. Idempotency-Key
+     * header required.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.recharge(
+     *     'organization_id',
+     *     { 'Idempotency-Key': 'Idempotency-Key' },
+     *   );
+     * ```
+     */
+    recharge(organizationID: string, params: BillingRechargeParams, options?: RequestOptions): APIPromise<Shared.OrganizationBillingSummary>;
+}
+/**
+ * A single billing history line item: a prepaid credit or a manual adjustment.
+ */
+export interface BillingHistoryEntry {
+    /**
+     * Unique identifier for the entry.
+     */
+    id: string;
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    amount: string;
+    /**
+     * When the entry was recorded.
+     */
+    created_at: string;
+    /**
+     * ISO 4217 currency code.
+     */
+    currency: string;
+    /**
+     * Kind of entry.
+     */
+    type: BillingHistoryEntryType;
+    /**
+     * Human-readable note describing the entry, when available.
+     */
+    description?: string | null;
+    /**
+     * Link to the hosted receipt for the payment behind this entry, when one is
+     * available. Present for prepaid credits funded by a card charge; absent for
+     * manual adjustments and while a payment's receipt is still being finalized.
+     */
+    receipt_url?: string | null;
+}
+export interface BillingHistoryEntryList {
+    items: Array<BillingHistoryEntry>;
+    /**
+     * Pagination response details.
+     */
+    pagination: Shared.Pagination;
+}
+/**
+ * Kind of entry.
+ */
+export type BillingHistoryEntryType = 'grant' | 'adjustment';
+/**
+ * Total usage cost for a single UTC day.
+ */
+export interface DailyCostPoint {
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    cost: string;
+    /**
+     * UTC calendar day (YYYY-MM-DD).
+     */
+    date: string;
+}
+/**
+ * Daily usage cost over a date range: one entry per UTC day (zero on idle days),
+ * summing open and closed resources. Suitable for a daily cost bar chart.
+ */
+export interface OrganizationDailyCost {
+    /**
+     * ISO 4217 currency code.
+     */
+    currency: string;
+    /**
+     * One entry per UTC day in the range, oldest first.
+     */
+    days: Array<DailyCostPoint>;
+    /**
+     * Inclusive start of the range, as a UTC calendar day (YYYY-MM-DD).
+     */
+    from: string;
+    /**
+     * Inclusive end of the range, as a UTC calendar day (YYYY-MM-DD).
+     */
+    to: string;
+}
+export interface BillingCostParams {
+    /**
+     * Inclusive start day, YYYY-MM-DD (UTC). Defaults to 30 days before to.
+     */
+    from?: string;
+    /**
+     * Inclusive end day, YYYY-MM-DD (UTC). Defaults to today.
+     */
+    to?: string;
+}
+export interface BillingHistoryParams {
+    /**
+     * Pagination cursor returned by a previous request
+     */
+    cursor?: string;
+    /**
+     * Maximum number of items to return
+     */
+    limit?: number;
+}
+export interface BillingTopUpParams {
+    /**
+     * Body param: Amount to charge and credit, in USD. Must be greater than 0, at most
+     * two decimal places, and at most 10000.
+     */
+    amount: string;
+    /**
+     * Header param: Unique idempotency key scoping the charge; reuse the same value
+     * across retries so a timed-out top-up is not charged twice
+     */
+    'Idempotency-Key': string;
+}
+export interface BillingRechargeParams {
+    /**
+     * Idempotency key scoping one charge attempt; reuse to retry it, but use a fresh
+     * key for a new attempt (e.g. after updating a declined card)
+     */
+    'Idempotency-Key': string;
+}
+export declare namespace Billing {
+    export { type BillingHistoryEntry as BillingHistoryEntry, type BillingHistoryEntryList as BillingHistoryEntryList, type BillingHistoryEntryType as BillingHistoryEntryType, type DailyCostPoint as DailyCostPoint, type OrganizationDailyCost as OrganizationDailyCost, type BillingCostParams as BillingCostParams, type BillingHistoryParams as BillingHistoryParams, type BillingTopUpParams as BillingTopUpParams, type BillingRechargeParams as BillingRechargeParams, };
+    export { RechargePolicy as RechargePolicy, type AutomaticPolicyArgs as AutomaticPolicyArgs, type OrganizationRechargePolicy as OrganizationRechargePolicy, type RechargePolicyMode as RechargePolicyMode, type RechargePolicyUpdateParams as RechargePolicyUpdateParams, };
+}
+//# sourceMappingURL=billing.d.ts.map

package/resources/organizations/billing/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../src/resources/organizations/billing/billing.ts"],"names":[],"mappings":"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"}

package/resources/organizations/billing/billing.js

@@ -0,0 +1,112 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Billing = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const RechargePolicyAPI = tslib_1.__importStar(require("./recharge-policy.js"));
+const recharge_policy_1 = require("./recharge-policy.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Billing extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.rechargePolicy = new RechargePolicyAPI.RechargePolicy(this._client);
+    }
+    /**
+     * Get the organization's billing summary: effective balance, monthly and daily
+     * run-rate cost, runway, and the projected next-recharge date. Costs are run-rate
+     * projections.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.summary(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    summary(organizationID, options) {
+        return this._client.get((0, path_1.path) `/v1/organizations/${organizationID}/billing/summary`, options);
+    }
+    /**
+     * Get the organization's total usage cost per UTC day over a date range (max 90
+     * days), summing open and closed resources. One entry per day, oldest first.
+     * Defaults to the last 30 days.
+     *
+     * @example
+     * ```ts
+     * const organizationDailyCost =
+     *   await client.organizations.billing.cost(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    cost(organizationID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/organizations/${organizationID}/billing/cost`, { query, ...options });
+    }
+    /**
+     * List the organization's billing history: prepaid credits, top-ups, and manual
+     * adjustments, newest first. Paginated with an opaque cursor.
+     *
+     * @example
+     * ```ts
+     * const billingHistoryEntryList =
+     *   await client.organizations.billing.history(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    history(organizationID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/organizations/${organizationID}/billing/history`, { query, ...options });
+    }
+    /**
+     * Charge the card on file and credit the prepaid balance. A unique Idempotency-Key
+     * header is required; reuse it across retries so a timed-out top-up is not charged
+     * twice.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.topUp(
+     *     'organization_id',
+     *     {
+     *       amount: '50.00',
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *     },
+     *   );
+     * ```
+     */
+    topUp(organizationID, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/organizations/${organizationID}/billing/topup`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+        });
+    }
+    /**
+     * Charge the card on file up to the recharge target now instead of waiting for the
+     * scheduled retry. Automatic-policy prepaid organizations only. Idempotency-Key
+     * header required.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.recharge(
+     *     'organization_id',
+     *     { 'Idempotency-Key': 'Idempotency-Key' },
+     *   );
+     * ```
+     */
+    recharge(organizationID, params, options) {
+        const { 'Idempotency-Key': idempotencyKey } = params;
+        return this._client.post((0, path_1.path) `/v1/organizations/${organizationID}/billing/recharge`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+        });
+    }
+}
+exports.Billing = Billing;
+Billing.RechargePolicy = recharge_policy_1.RechargePolicy;
+//# sourceMappingURL=billing.js.map

package/resources/organizations/billing/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/resources/organizations/billing/billing.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AAErD,gFAAuD;AACvD,0DAM2B;AAE3B,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,mBAAc,GAAqC,IAAI,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAmHxG,CAAC;IAjHC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,cAAsB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,cAAsB,EACtB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,eAAe,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CACL,cAAsB,EACtB,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CACH,cAAsB,EACtB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,gBAAgB,EAAE;YAChF,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACjF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,cAAsB,EACtB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,mBAAmB,EAAE;YACnF,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACjF,CAAC,CAAC;IACL,CAAC;CACF;AApHD,0BAoHC;AAiJD,OAAO,CAAC,cAAc,GAAG,gCAAc,CAAC"}

package/resources/organizations/billing/billing.mjs

@@ -0,0 +1,107 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import * as RechargePolicyAPI from "./recharge-policy.mjs";
+import { RechargePolicy, } from "./recharge-policy.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Billing extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.rechargePolicy = new RechargePolicyAPI.RechargePolicy(this._client);
+    }
+    /**
+     * Get the organization's billing summary: effective balance, monthly and daily
+     * run-rate cost, runway, and the projected next-recharge date. Costs are run-rate
+     * projections.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.summary(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    summary(organizationID, options) {
+        return this._client.get(path `/v1/organizations/${organizationID}/billing/summary`, options);
+    }
+    /**
+     * Get the organization's total usage cost per UTC day over a date range (max 90
+     * days), summing open and closed resources. One entry per day, oldest first.
+     * Defaults to the last 30 days.
+     *
+     * @example
+     * ```ts
+     * const organizationDailyCost =
+     *   await client.organizations.billing.cost(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    cost(organizationID, query = {}, options) {
+        return this._client.get(path `/v1/organizations/${organizationID}/billing/cost`, { query, ...options });
+    }
+    /**
+     * List the organization's billing history: prepaid credits, top-ups, and manual
+     * adjustments, newest first. Paginated with an opaque cursor.
+     *
+     * @example
+     * ```ts
+     * const billingHistoryEntryList =
+     *   await client.organizations.billing.history(
+     *     'organization_id',
+     *   );
+     * ```
+     */
+    history(organizationID, query = {}, options) {
+        return this._client.get(path `/v1/organizations/${organizationID}/billing/history`, { query, ...options });
+    }
+    /**
+     * Charge the card on file and credit the prepaid balance. A unique Idempotency-Key
+     * header is required; reuse it across retries so a timed-out top-up is not charged
+     * twice.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.topUp(
+     *     'organization_id',
+     *     {
+     *       amount: '50.00',
+     *       'Idempotency-Key': 'Idempotency-Key',
+     *     },
+     *   );
+     * ```
+     */
+    topUp(organizationID, params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post(path `/v1/organizations/${organizationID}/billing/topup`, {
+            body,
+            ...options,
+            headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+        });
+    }
+    /**
+     * Charge the card on file up to the recharge target now instead of waiting for the
+     * scheduled retry. Automatic-policy prepaid organizations only. Idempotency-Key
+     * header required.
+     *
+     * @example
+     * ```ts
+     * const organizationBillingSummary =
+     *   await client.organizations.billing.recharge(
+     *     'organization_id',
+     *     { 'Idempotency-Key': 'Idempotency-Key' },
+     *   );
+     * ```
+     */
+    recharge(organizationID, params, options) {
+        const { 'Idempotency-Key': idempotencyKey } = params;
+        return this._client.post(path `/v1/organizations/${organizationID}/billing/recharge`, {
+            ...options,
+            headers: buildHeaders([{ 'Idempotency-Key': idempotencyKey }, options?.headers]),
+        });
+    }
+}
+Billing.RechargePolicy = RechargePolicy;
+//# sourceMappingURL=billing.mjs.map