@nirvana-labs/nirvana 1.85.3 → 1.86.1

package/resources/usage/usage.d.mts

@@ -0,0 +1,89 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as Shared from "../shared.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class UsageResource extends APIResource {
+    /**
+     * List per-resource usage records for the current organization. Each item is one
+     * resource with its nested dimension history (active and closed segments).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const usage of client.usage.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: UsageListParams | null | undefined, options?: RequestOptions): PagePromise<UsagesCursor, Usage>;
+    /**
+     * Get the usage record for a single resource (metadata plus dimension history) for
+     * the current organization.
+     *
+     * @example
+     * ```ts
+     * const usage = await client.usage.get(
+     *   '123e4567-e89b-12d3-a456-426614174000',
+     * );
+     * ```
+     */
+    get(resourceID: string, options?: RequestOptions): APIPromise<Usage>;
+}
+export type UsagesCursor = Cursor<Usage>;
+/**
+ * Usage record for a single metered resource.
+ */
+export interface Usage {
+    dimensions: Array<UsageDimension>;
+    ended_at: string | null;
+    project_id: string;
+    /**
+     * Region the resource is in.
+     */
+    region: Shared.RegionName;
+    resource_id: string;
+    /**
+     * Kind of metered resource a ledger row belongs to.
+     */
+    resource_type: UsageResourceType;
+    started_at: string;
+}
+/**
+ * Top-level dimension entry; bundle heads expand via children.
+ */
+export interface UsageDimension {
+    id: string;
+    dimension: string;
+    ended_at: string | null;
+    quantity: number;
+    started_at: string;
+    children?: Array<UsageDimensionLeaf>;
+}
+/**
+ * One ledger segment for a (resource, dimension) pair.
+ */
+export interface UsageDimensionLeaf {
+    id: string;
+    dimension: string;
+    ended_at: string | null;
+    quantity: number;
+    started_at: string;
+}
+export interface UsageList {
+    items: Array<Usage>;
+    /**
+     * Pagination response details.
+     */
+    pagination: Shared.Pagination;
+}
+/**
+ * Kind of metered resource a ledger row belongs to.
+ */
+export type UsageResourceType = 'vm' | 'volume' | 'vpc' | 'connect_connection' | 'nks_cluster' | 'nks_node_pool' | 'nks_load_balancer';
+export interface UsageListParams extends CursorParams {
+}
+export declare namespace UsageResource {
+    export { type Usage as Usage, type UsageDimension as UsageDimension, type UsageDimensionLeaf as UsageDimensionLeaf, type UsageList as UsageList, type UsageResourceType as UsageResourceType, type UsagesCursor as UsagesCursor, type UsageListParams as UsageListParams, };
+}
+//# sourceMappingURL=usage.d.mts.map

package/resources/usage/usage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../../src/resources/usage/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,MAAM,sBAAkB;AACpC,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE,kCAA8B;AAC/E,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;OAWG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC;IAInC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;CAGrE;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAElC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,EAAE,iBAAiB,CAAC;IAEjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,QAAQ,GACR,KAAK,GACL,oBAAoB,GACpB,aAAa,GACb,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,WAAW,eAAgB,SAAQ,YAAY;CAAG;AAExD,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/usage/usage.d.ts

@@ -0,0 +1,89 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class UsageResource extends APIResource {
+    /**
+     * List per-resource usage records for the current organization. Each item is one
+     * resource with its nested dimension history (active and closed segments).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const usage of client.usage.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: UsageListParams | null | undefined, options?: RequestOptions): PagePromise<UsagesCursor, Usage>;
+    /**
+     * Get the usage record for a single resource (metadata plus dimension history) for
+     * the current organization.
+     *
+     * @example
+     * ```ts
+     * const usage = await client.usage.get(
+     *   '123e4567-e89b-12d3-a456-426614174000',
+     * );
+     * ```
+     */
+    get(resourceID: string, options?: RequestOptions): APIPromise<Usage>;
+}
+export type UsagesCursor = Cursor<Usage>;
+/**
+ * Usage record for a single metered resource.
+ */
+export interface Usage {
+    dimensions: Array<UsageDimension>;
+    ended_at: string | null;
+    project_id: string;
+    /**
+     * Region the resource is in.
+     */
+    region: Shared.RegionName;
+    resource_id: string;
+    /**
+     * Kind of metered resource a ledger row belongs to.
+     */
+    resource_type: UsageResourceType;
+    started_at: string;
+}
+/**
+ * Top-level dimension entry; bundle heads expand via children.
+ */
+export interface UsageDimension {
+    id: string;
+    dimension: string;
+    ended_at: string | null;
+    quantity: number;
+    started_at: string;
+    children?: Array<UsageDimensionLeaf>;
+}
+/**
+ * One ledger segment for a (resource, dimension) pair.
+ */
+export interface UsageDimensionLeaf {
+    id: string;
+    dimension: string;
+    ended_at: string | null;
+    quantity: number;
+    started_at: string;
+}
+export interface UsageList {
+    items: Array<Usage>;
+    /**
+     * Pagination response details.
+     */
+    pagination: Shared.Pagination;
+}
+/**
+ * Kind of metered resource a ledger row belongs to.
+ */
+export type UsageResourceType = 'vm' | 'volume' | 'vpc' | 'connect_connection' | 'nks_cluster' | 'nks_node_pool' | 'nks_load_balancer';
+export interface UsageListParams extends CursorParams {
+}
+export declare namespace UsageResource {
+    export { type Usage as Usage, type UsageDimension as UsageDimension, type UsageDimensionLeaf as UsageDimensionLeaf, type UsageList as UsageList, type UsageResourceType as UsageResourceType, type UsagesCursor as UsagesCursor, type UsageListParams as UsageListParams, };
+}
+//# sourceMappingURL=usage.d.ts.map

package/resources/usage/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/usage/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,MAAM,qBAAkB;AACpC,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE,iCAA8B;AAC/E,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;OAWG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC;IAInC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;CAGrE;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAElC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,EAAE,iBAAiB,CAAC;IAEjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IAEX,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,QAAQ,GACR,KAAK,GACL,oBAAoB,GACpB,aAAa,GACb,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,WAAW,eAAgB,SAAQ,YAAY;CAAG;AAExD,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/usage/usage.js

@@ -0,0 +1,40 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageResource = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+class UsageResource extends resource_1.APIResource {
+    /**
+     * List per-resource usage records for the current organization. Each item is one
+     * resource with its nested dimension history (active and closed segments).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const usage of client.usage.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/usage', (pagination_1.Cursor), { query, ...options });
+    }
+    /**
+     * Get the usage record for a single resource (metadata plus dimension history) for
+     * the current organization.
+     *
+     * @example
+     * ```ts
+     * const usage = await client.usage.get(
+     *   '123e4567-e89b-12d3-a456-426614174000',
+     * );
+     * ```
+     */
+    get(resourceID, options) {
+        return this._client.get((0, path_1.path) `/v1/usage/${resourceID}`, options);
+    }
+}
+exports.UsageResource = UsageResource;
+//# sourceMappingURL=usage.js.map

package/resources/usage/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/usage/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,yDAA+E;AAE/E,uDAAiD;AAEjD,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,mBAAa,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,UAAkB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF;AAlCD,sCAkCC"}

package/resources/usage/usage.mjs

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { Cursor } from "../../core/pagination.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class UsageResource extends APIResource {
+    /**
+     * List per-resource usage records for the current organization. Each item is one
+     * resource with its nested dimension history (active and closed segments).
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const usage of client.usage.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/usage', (Cursor), { query, ...options });
+    }
+    /**
+     * Get the usage record for a single resource (metadata plus dimension history) for
+     * the current organization.
+     *
+     * @example
+     * ```ts
+     * const usage = await client.usage.get(
+     *   '123e4567-e89b-12d3-a456-426614174000',
+     * );
+     * ```
+     */
+    get(resourceID, options) {
+        return this._client.get(path `/v1/usage/${resourceID}`, options);
+    }
+}
+//# sourceMappingURL=usage.mjs.map

package/resources/usage/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","sourceRoot":"","sources":["../../src/resources/usage/usage.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,MAAM,EAAkC,kCAA8B;AAE/E,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,MAAa,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,UAAkB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF"}

package/resources/usage.d.mts

@@ -0,0 +1,2 @@
+export * from "./usage/index.mjs";
+//# sourceMappingURL=usage.d.mts.map

package/resources/usage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../src/resources/usage.ts"],"names":[],"mappings":"AAEA,kCAA8B"}

package/resources/usage.d.ts

@@ -0,0 +1,2 @@
+export * from "./usage/index.js";
+//# sourceMappingURL=usage.d.ts.map

package/resources/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/resources/usage.ts"],"names":[],"mappings":"AAEA,iCAA8B"}

package/resources/usage.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./usage/index.js"), exports);
+//# sourceMappingURL=usage.js.map

package/resources/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/resources/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAA8B"}

package/resources/usage.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./usage/index.mjs";
+//# sourceMappingURL=usage.mjs.map

package/resources/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","sourceRoot":"","sources":["../src/resources/usage.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,kCAA8B"}

package/resources/user/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/user/index.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE;OAC1D,EAAE,YAAY,EAAE"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/user/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,uBAAmB;AACpF,OAAO,EAAE,YAAY,EAAE,mBAAe"}

package/resources/user/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/user/index.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE;OAC1D,EAAE,YAAY,EAAE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/user/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,sBAAmB;AACpF,OAAO,EAAE,YAAY,EAAE,kBAAe"}

package/resources/user/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/user/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,QAAQ,EAAgD;OAC1D,EAAE,YAAY,EAAE"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/user/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,QAAQ,EAAgD,uBAAmB;AACpF,OAAO,EAAE,YAAY,EAAE,mBAAe"}

package/resources/user/security.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.mts","sourceRoot":"","sources":["../../src/resources/user/security.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;IAItF;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;CAGxD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC;IAE5C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;CACtC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,YAAY,IAAI,YAAY,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;CACjG"}
+{"version":3,"file":"security.d.mts","sourceRoot":"","sources":["../../src/resources/user/security.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,MAAM,sBAAkB;AACpC,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAEhE,qBAAa,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;IAItF;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;CAGxD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC;IAE5C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;CACtC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,YAAY,IAAI,YAAY,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;CACjG"}

package/resources/user/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/resources/user/security.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;IAItF;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;CAGxD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC;IAE5C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;CACtC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,YAAY,IAAI,YAAY,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;CACjG"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/resources/user/security.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,MAAM,qBAAkB;AACpC,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAEhE,qBAAa,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;IAItF;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;CAGxD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC;IAE5C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;CACtC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,YAAY,IAAI,YAAY,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;CACjG"}

package/resources/user/security.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"security.mjs","sourceRoot":"","sources":["../../src/resources/user/security.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAwB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;CACF"}
+{"version":3,"file":"security.mjs","sourceRoot":"","sources":["../../src/resources/user/security.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAKlD,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;OAEG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAwB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;CACF"}

package/resources/user/user.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.mts","sourceRoot":"","sources":["../../src/resources/user/user.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE;OAChD,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAGhD;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}
+{"version":3,"file":"user.d.mts","sourceRoot":"","sources":["../../src/resources/user/user.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAmB;AAC1E,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAEhE,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAGhD;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/user/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/resources/user/user.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE;OAChD,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAGhD;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/resources/user/user.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,WAAW,sBAAmB;AAC1C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,sBAAmB;AAC1E,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAEhE,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAGhD;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EAAE,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/user/user.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"user.mjs","sourceRoot":"","sources":["../../src/resources/user/user.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,QAAQ,EAAsC;AAIvD,MAAM,OAAO,YAAa,SAAQ,WAAW;IAA7C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAQ1E,CAAC;IANC;;OAEG;IACH,GAAG,CAAC,OAAwB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF;AA2BD,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"user.mjs","sourceRoot":"","sources":["../../src/resources/user/user.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAE,QAAQ,EAAsC,uBAAmB;AAI1E,MAAM,OAAO,YAAa,SAAQ,WAAW;IAA7C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAQ1E,CAAC;IANC;;OAEG;IACH,GAAG,CAAC,OAAwB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF;AA2BD,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/resources/user.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.mts","sourceRoot":"","sources":["../src/resources/user.ts"],"names":[],"mappings":""}
+{"version":3,"file":"user.d.mts","sourceRoot":"","sources":["../src/resources/user.ts"],"names":[],"mappings":"AAEA,iCAA6B"}

package/resources/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../src/resources/user.ts"],"names":[],"mappings":""}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../src/resources/user.ts"],"names":[],"mappings":"AAEA,gCAA6B"}

package/resources/user.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"user.mjs","sourceRoot":"","sources":["../src/resources/user.ts"],"names":[],"mappings":"AAAA,sFAAsF"}
+{"version":3,"file":"user.mjs","sourceRoot":"","sources":["../src/resources/user.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,iCAA6B"}

package/resources.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.mts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.d.mts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":"AAAA,sCAAkC"}

package/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":"AAAA,qCAAkC"}

package/resources.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resources.mjs","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.mjs","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":"AAAA,sCAAkC"}

package/src/client.ts

@@ -31,6 +31,7 @@ import { Projects } from './resources/projects/projects';
 import { Quotas } from './resources/quotas/quotas';
 import { Regions } from './resources/regions/regions';
 import { RPCNodes } from './resources/rpc-nodes/rpc-nodes';
+import { UsageResource } from './resources/usage/usage';
 import { UserResource } from './resources/user/user';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -773,6 +774,7 @@ export class NirvanaLabs {
   operations: API.Operations = new API.Operations(this);
   organizations: API.Organizations = new API.Organizations(this);
   quotas: API.Quotas = new API.Quotas(this);
+  usage: API.UsageResource = new API.UsageResource(this);
   auditLogs: API.AuditLogs = new API.AuditLogs(this);
   projects: API.Projects = new API.Projects(this);
   regions: API.Regions = new API.Regions(this);
@@ -788,6 +790,7 @@ NirvanaLabs.APIKeys = APIKeys;
 NirvanaLabs.Operations = Operations;
 NirvanaLabs.Organizations = Organizations;
 NirvanaLabs.Quotas = Quotas;
+NirvanaLabs.UsageResource = UsageResource;
 NirvanaLabs.AuditLogs = AuditLogs;
 NirvanaLabs.Projects = Projects;
 NirvanaLabs.Regions = Regions;
@@ -813,6 +816,8 @@ export declare namespace NirvanaLabs {
 
   export { Quotas as Quotas };
 
+  export { UsageResource as UsageResource };
+
   export { AuditLogs as AuditLogs };
 
   export { Projects as Projects };

package/src/resources/index.ts

@@ -13,4 +13,5 @@ export { Projects } from './projects';
 export { Quotas } from './quotas';
 export { RPCNodes } from './rpc-nodes/rpc-nodes';
 export { Regions } from './regions';
+export { UsageResource } from './usage';
 export { UserResource } from './user/user';

package/src/resources/usage/api.md

@@ -0,0 +1,14 @@
+# Usage
+
+Types:
+
+- <code><a href="./src/resources/usage.ts">Usage</a></code>
+- <code><a href="./src/resources/usage.ts">UsageDimension</a></code>
+- <code><a href="./src/resources/usage.ts">UsageDimensionLeaf</a></code>
+- <code><a href="./src/resources/usage.ts">UsageList</a></code>
+- <code><a href="./src/resources/usage.ts">UsageResourceType</a></code>
+
+Methods:
+
+- <code title="get /v1/usage">client.usage.<a href="./src/resources/usage.ts">list</a>({ ...params }) -> UsagesCursor</code>
+- <code title="get /v1/usage/{resource_id}">client.usage.<a href="./src/resources/usage.ts">get</a>(resourceID) -> Usage</code>

package/src/resources/usage/index.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { UsageResource } from './usage';

package/src/resources/usage/usage.ts

@@ -0,0 +1,138 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+import { APIPromise } from '../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class UsageResource extends APIResource {
+  /**
+   * List per-resource usage records for the current organization. Each item is one
+   * resource with its nested dimension history (active and closed segments).
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const usage of client.usage.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: UsageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<UsagesCursor, Usage> {
+    return this._client.getAPIList('/v1/usage', Cursor<Usage>, { query, ...options });
+  }
+
+  /**
+   * Get the usage record for a single resource (metadata plus dimension history) for
+   * the current organization.
+   *
+   * @example
+   * ```ts
+   * const usage = await client.usage.get(
+   *   '123e4567-e89b-12d3-a456-426614174000',
+   * );
+   * ```
+   */
+  get(resourceID: string, options?: RequestOptions): APIPromise<Usage> {
+    return this._client.get(path`/v1/usage/${resourceID}`, options);
+  }
+}
+
+export type UsagesCursor = Cursor<Usage>;
+
+/**
+ * Usage record for a single metered resource.
+ */
+export interface Usage {
+  dimensions: Array<UsageDimension>;
+
+  ended_at: string | null;
+
+  project_id: string;
+
+  /**
+   * Region the resource is in.
+   */
+  region: Shared.RegionName;
+
+  resource_id: string;
+
+  /**
+   * Kind of metered resource a ledger row belongs to.
+   */
+  resource_type: UsageResourceType;
+
+  started_at: string;
+}
+
+/**
+ * Top-level dimension entry; bundle heads expand via children.
+ */
+export interface UsageDimension {
+  id: string;
+
+  dimension: string;
+
+  ended_at: string | null;
+
+  quantity: number;
+
+  started_at: string;
+
+  children?: Array<UsageDimensionLeaf>;
+}
+
+/**
+ * One ledger segment for a (resource, dimension) pair.
+ */
+export interface UsageDimensionLeaf {
+  id: string;
+
+  dimension: string;
+
+  ended_at: string | null;
+
+  quantity: number;
+
+  started_at: string;
+}
+
+export interface UsageList {
+  items: Array<Usage>;
+
+  /**
+   * Pagination response details.
+   */
+  pagination: Shared.Pagination;
+}
+
+/**
+ * Kind of metered resource a ledger row belongs to.
+ */
+export type UsageResourceType =
+  | 'vm'
+  | 'volume'
+  | 'vpc'
+  | 'connect_connection'
+  | 'nks_cluster'
+  | 'nks_node_pool'
+  | 'nks_load_balancer';
+
+export interface UsageListParams extends CursorParams {}
+
+export declare namespace UsageResource {
+  export {
+    type Usage as Usage,
+    type UsageDimension as UsageDimension,
+    type UsageDimensionLeaf as UsageDimensionLeaf,
+    type UsageList as UsageList,
+    type UsageResourceType as UsageResourceType,
+    type UsagesCursor as UsagesCursor,
+    type UsageListParams as UsageListParams,
+  };
+}

package/src/resources/usage.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './usage/index';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.85.3'; // x-release-please-version
+export const VERSION = '1.86.1'; // x-release-please-version

package/uploads.d.mts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/uploads.d.ts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.js";
 //# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,kCAA+B"}

package/uploads.mjs

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}