oblien 2.0.2 → 2.0.4

package/dist/client.d.ts

@@ -1,5 +1,7 @@
 import { HttpClient } from './http.js';
 import { Workspace } from './workspace.js';
+import { WorkspaceHandle } from './workspace-handle.js';
+import { Namespace } from './namespace.js';
 import type { OblienOptions } from './types/index.js';
 /**
  * Oblien API client.
@@ -12,20 +14,39 @@ import type { OblienOptions } from './types/index.js';
  *   clientSecret: process.env.OBLIEN_CLIENT_SECRET!,
  * });
  *
- * // Via the client
+ * // Collection-level operations (list, create, quota)
  * const data = await client.workspaces.create({ image: 'node' });
- * await client.workspaces.start(data.id);
  *
- * // Or standalone (same class)
- * import { Workspace } from 'oblien/workspace';
- * const ws = new Workspace(client);
+ * // Scoped handle — bind to a single workspace
+ * const ws = client.workspace(data.id);
+ * await ws.start();
+ * const rt = await ws.runtime();
+ * await rt.exec.run(['node', '--version']);
  * ```
  */
 export declare class Oblien {
     /** @internal — used by resource classes to make HTTP requests. */
     readonly _http: HttpClient;
-    /** Workspace operations (CRUD, power, quota). */
+    /** Workspace operations (CRUD, power, quota, and sub-resources). */
     readonly workspaces: Workspace;
+    /** Namespace operations (CRUD, lifecycle, activity, usage). */
+    readonly namespaces: Namespace;
     constructor(options: OblienOptions);
+    /**
+     * Get a scoped {@link WorkspaceHandle} bound to a single workspace ID.
+     *
+     * Every method on the handle delegates to `client.workspaces` with
+     * the ID pre-filled, so you never have to pass it again.
+     *
+     * ```ts
+     * const ws = client.workspace('ws_abc');
+     *
+     * await ws.start();
+     * const rt = await ws.runtime();
+     * await rt.files.list({ dirPath: '/' });
+     * await ws.stop();
+     * ```
+     */
+    workspace(workspaceId: string): WorkspaceHandle;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IACjB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;gBAEnB,OAAO,EAAE,aAAa;CAInC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,MAAM;IACjB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAE/B,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;gBAEnB,OAAO,EAAE,aAAa;IAMlC;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe;CAGhD"}

package/dist/client.js

@@ -1,5 +1,7 @@
 import { HttpClient } from './http.js';
 import { Workspace } from './workspace.js';
+import { WorkspaceHandle } from './workspace-handle.js';
+import { Namespace } from './namespace.js';
 /**
  * Oblien API client.
  *
@@ -11,23 +13,45 @@ import { Workspace } from './workspace.js';
  *   clientSecret: process.env.OBLIEN_CLIENT_SECRET!,
  * });
  *
- * // Via the client
+ * // Collection-level operations (list, create, quota)
  * const data = await client.workspaces.create({ image: 'node' });
- * await client.workspaces.start(data.id);
  *
- * // Or standalone (same class)
- * import { Workspace } from 'oblien/workspace';
- * const ws = new Workspace(client);
+ * // Scoped handle — bind to a single workspace
+ * const ws = client.workspace(data.id);
+ * await ws.start();
+ * const rt = await ws.runtime();
+ * await rt.exec.run(['node', '--version']);
  * ```
  */
 export class Oblien {
     /** @internal — used by resource classes to make HTTP requests. */
     _http;
-    /** Workspace operations (CRUD, power, quota). */
+    /** Workspace operations (CRUD, power, quota, and sub-resources). */
     workspaces;
+    /** Namespace operations (CRUD, lifecycle, activity, usage). */
+    namespaces;
     constructor(options) {
         this._http = new HttpClient(options);
         this.workspaces = new Workspace(this);
+        this.namespaces = new Namespace(this);
+    }
+    /**
+     * Get a scoped {@link WorkspaceHandle} bound to a single workspace ID.
+     *
+     * Every method on the handle delegates to `client.workspaces` with
+     * the ID pre-filled, so you never have to pass it again.
+     *
+     * ```ts
+     * const ws = client.workspace('ws_abc');
+     *
+     * await ws.start();
+     * const rt = await ws.runtime();
+     * await rt.files.list({ dirPath: '/' });
+     * await ws.stop();
+     * ```
+     */
+    workspace(workspaceId) {
+        return new WorkspaceHandle(this.workspaces, workspaceId);
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,MAAM;IACjB,kEAAkE;IACzD,KAAK,CAAa;IAE3B,iDAAiD;IACxC,UAAU,CAAY;IAE/B,YAAY,OAAsB;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,MAAM;IACjB,kEAAkE;IACzD,KAAK,CAAa;IAE3B,oEAAoE;IAC3D,UAAU,CAAY;IAE/B,+DAA+D;IACtD,UAAU,CAAY;IAE/B,YAAY,OAAsB;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { Oblien as default } from './client.js';
 export { Oblien } from './client.js';
 export { Workspace } from './workspace.js';
+export { WorkspaceHandle } from './workspace-handle.js';
+export { Namespace } from './namespace.js';
 export { Runtime } from './runtime.js';
 export { RuntimeWebSocket } from './runtime/ws.js';
 export { OblienError, AuthenticationError, NotFoundError, RateLimitError, ValidationError, PaymentRequiredError, ConflictError, } from './error.js';
-export type { OblienOptions, RequestOptions, ApiResponse, WorkspaceCreateParams, WorkspaceUpdateParams, WorkspaceListParams, WorkspaceListResponse, WorkspaceData, ResourceSpec, LifecycleSpec, NetworkSpec, FirewallRule, PrivateLink, RuntimeOptions, FileListParams, FileEntry, FileListResponse, FileReadParams, FileReadResponse, FileWriteParams, FileWriteResponse, FileMkdirParams, FileStatParams, FileStatResponse, FileDeleteParams, ContentSearchParams, SearchMatch, ContentSearchResponse, FileSearchParams, FileSearchResponse, SearchStatusResponse, SearchInitResponse, ExecRunParams, ExecTask, ExecListResponse, ExecStreamEvent, TerminalCreateParams, TerminalSession, TerminalListResponse, TerminalScrollbackResponse, WatcherCreateParams, WatcherInfo, WatcherListResponse, WSOptions, WSMessage, WSTerminalResize, WSTerminalExit, WSTerminalEvent, WSWatcherChange, WSWatcherReady, WSWatcherOverflow, WSWatcherEvent, LifecycleStatus, MakeTemporaryParams, UpdateTtlParams, SshStatus, SshPasswordParams, SshKeyParams, PublicAccessPort, ExposePortParams, SnapshotParams, ArchiveCreateParams, ArchiveInfo, WorkloadCreateParams, WorkloadUpdateParams, WorkloadInfo, WorkloadListParams, UsageParams, UpdateResourcesParams, UpdateMetadataParams, ApiAccessStatus, RawTokenResponse, NetworkUpdateParams, NetworkConfig, LogsParams, LogFile, LogStreamEvent, StatsEvent, WorkloadStatsEvent, WorkloadLogEntry, ImagesListParams, } from './types/index.js';
+export type { OblienOptions, RequestOptions, ApiResponse, WorkspaceCreateParams, WorkspaceUpdateParams, WorkspaceListParams, WorkspaceListResponse, WorkspaceData, ResourceSpec, LifecycleSpec, NetworkSpec, FirewallRule, PrivateLink, RuntimeOptions, FileListParams, FileEntry, FileListResponse, FileReadParams, FileReadResponse, FileWriteParams, FileWriteResponse, FileMkdirParams, FileStatParams, FileStatResponse, FileDeleteParams, ContentSearchParams, SearchMatch, ContentSearchResponse, FileSearchParams, FileSearchResponse, SearchStatusResponse, SearchInitResponse, ExecRunParams, ExecTask, ExecListResponse, ExecStreamEvent, TerminalCreateParams, TerminalSession, TerminalListResponse, TerminalScrollbackResponse, WatcherCreateParams, WatcherInfo, WatcherListResponse, WSOptions, WSMessage, WSTerminalResize, WSTerminalExit, WSTerminalEvent, WSWatcherChange, WSWatcherReady, WSWatcherOverflow, WSWatcherEvent, LifecycleStatus, MakeTemporaryParams, UpdateTtlParams, SshStatus, SshPasswordParams, SshKeyParams, PublicAccessPort, ExposePortParams, SnapshotParams, ArchiveCreateParams, ArchiveInfo, WorkloadCreateParams, WorkloadUpdateParams, WorkloadInfo, WorkloadListParams, UsageParams, UpdateResourcesParams, UpdateMetadataParams, ApiAccessStatus, RawTokenResponse, NetworkUpdateParams, NetworkConfig, LogsParams, LogFile, LogStreamEvent, StatsEvent, WorkloadStatsEvent, WorkloadLogEntry, ImagesListParams, NamespaceStatus, NamespaceType, NamespaceResourceLimits, NamespaceData, NamespaceCreateParams, NamespaceUpdateParams, NamespaceListParams, NamespaceListResponse, NamespaceActivity, NamespaceActivityParams, NamespaceUsageParams, NamespaceDeleteParams, QuotaPeriod, OverdraftAction, NamespaceQuota, SetNamespaceQuotaParams, ResetNamespaceQuotaParams, NamespaceListWithQuotasParams, NamespaceDetailsParams, DefaultQuotaConfig, SetDefaultQuotaParams, ToggleDefaultQuotaAutoApplyParams, DeleteDefaultQuotaParams, } from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEV,aAAa,EACb,cAAc,EACd,WAAW,EAEX,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,WAAW,EAEX,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EAEnB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEV,aAAa,EACb,cAAc,EACd,WAAW,EAEX,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,WAAW,EAEX,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EAEnB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,iCAAiC,EACjC,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -3,6 +3,8 @@ export { Oblien as default } from './client.js';
 // ── Named exports ──────────────────────────────────────────────────
 export { Oblien } from './client.js';
 export { Workspace } from './workspace.js';
+export { WorkspaceHandle } from './workspace-handle.js';
+export { Namespace } from './namespace.js';
 export { Runtime } from './runtime.js';
 export { RuntimeWebSocket } from './runtime/ws.js';
 // Errors

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhD,sEAAsE;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,SAAS;AACT,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhD,sEAAsE;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,SAAS;AACT,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/namespace.d.ts

@@ -0,0 +1,232 @@
+import type { HttpClient } from './http.js';
+import type { ApiResponse } from './types/common.js';
+import type { NamespaceData, NamespaceCreateParams, NamespaceUpdateParams, NamespaceListParams, NamespaceListResponse, NamespaceActivityParams, NamespaceUsageParams, NamespaceDeleteParams, SetNamespaceQuotaParams, ResetNamespaceQuotaParams, NamespaceListWithQuotasParams, NamespaceDetailsParams, SetDefaultQuotaParams } from './types/namespace.js';
+/**
+ * Namespace operations — CRUD, lifecycle actions, activity, and usage.
+ *
+ * ```ts
+ * import Oblien from 'oblien';
+ * const client = new Oblien({ clientId, clientSecret });
+ *
+ * // Create
+ * const ns = await client.namespaces.create({ name: 'production' });
+ *
+ * // List
+ * const { data } = await client.namespaces.list({ status: 'active' });
+ *
+ * // Suspend / Activate
+ * await client.namespaces.suspend(ns.data.id);
+ * await client.namespaces.activate(ns.data.id);
+ *
+ * // Delete
+ * await client.namespaces.delete(ns.data.id, { deleteWorkspaces: true });
+ * ```
+ */
+export declare class Namespace {
+    /** @internal */
+    readonly _http: HttpClient;
+    private readonly _base;
+    constructor(client: {
+        _http: HttpClient;
+    });
+    /**
+     * Create a new namespace.
+     *
+     * ```ts
+     * const res = await client.namespaces.create({
+     *   name: 'my-project',
+     *   type: 'production',
+     *   tags: ['api', 'v2'],
+     * });
+     * console.log(res.data.slug); // 'my-project'
+     * ```
+     */
+    create(params: NamespaceCreateParams): Promise<ApiResponse & {
+        data: NamespaceData;
+    }>;
+    /**
+     * List namespaces with optional filtering, search, and pagination.
+     *
+     * ```ts
+     * const { data, pagination } = await client.namespaces.list({
+     *   status: 'active',
+     *   search: 'prod',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    list(params?: NamespaceListParams): Promise<NamespaceListResponse>;
+    /**
+     * Get a namespace by ID or slug.
+     *
+     * ```ts
+     * const ns = await client.namespaces.get('my-project');
+     * console.log(ns.data.status); // 'active'
+     * ```
+     */
+    get(idOrSlug: string): Promise<ApiResponse & {
+        data: NamespaceData;
+    }>;
+    /**
+     * Update a namespace.
+     *
+     * ```ts
+     * await client.namespaces.update('ns_abc', {
+     *   description: 'Production workloads',
+     *   tags: ['production', 'critical'],
+     * });
+     * ```
+     */
+    update(id: string, params: NamespaceUpdateParams): Promise<ApiResponse & {
+        data: NamespaceData;
+    }>;
+    /**
+     * Delete a namespace. Optionally delete all its workspaces.
+     *
+     * ```ts
+     * await client.namespaces.delete('ns_abc', { deleteWorkspaces: true });
+     * ```
+     */
+    delete(id: string, params?: NamespaceDeleteParams): Promise<ApiResponse>;
+    /**
+     * Suspend a namespace — stops all running workspaces and sets status to `suspended`.
+     *
+     * ```ts
+     * await client.namespaces.suspend('ns_abc');
+     * ```
+     */
+    suspend(id: string): Promise<ApiResponse>;
+    /**
+     * Activate a suspended namespace — sets status back to `active`.
+     *
+     * ```ts
+     * await client.namespaces.activate('ns_abc');
+     * ```
+     */
+    activate(id: string): Promise<ApiResponse>;
+    /**
+     * Stop all running workspaces in a namespace without changing namespace status.
+     *
+     * ```ts
+     * await client.namespaces.stopWorkspaces('ns_abc');
+     * ```
+     */
+    stopWorkspaces(id: string): Promise<ApiResponse>;
+    /**
+     * Get namespace activity log.
+     *
+     * ```ts
+     * const { data } = await client.namespaces.activity('ns_abc', { limit: 20 });
+     * ```
+     */
+    activity(id: string, params?: NamespaceActivityParams): Promise<ApiResponse>;
+    /**
+     * Get namespace usage statistics.
+     *
+     * ```ts
+     * const { data } = await client.namespaces.usage('ns_abc', { days: 30 });
+     * ```
+     */
+    usage(id: string, params?: NamespaceUsageParams): Promise<ApiResponse>;
+    /**
+     * Set or update a namespace quota for a service.
+     *
+     * Configures spending limits with optional overdraft (grace zone beyond the
+     * hard limit). When usage exceeds `quotaLimit + overdraft`, the
+     * `onOverdraftAction` fires — either blocking new requests or stopping all
+     * running workspaces in the namespace.
+     *
+     * ```ts
+     * await client.namespaces.setQuota({
+     *   namespace: 'production',
+     *   service: 'sandbox',
+     *   quotaLimit: 500,
+     *   period: 'monthly',
+     *   overdraft: 50,
+     *   onOverdraftAction: 'stop_workspaces',
+     * });
+     * ```
+     */
+    setQuota(params: SetNamespaceQuotaParams): Promise<ApiResponse>;
+    /**
+     * Reset quota usage to zero for a namespace + service.
+     *
+     * ```ts
+     * await client.namespaces.resetQuota({ namespace: 'production', service: 'sandbox' });
+     * ```
+     */
+    resetQuota(params: ResetNamespaceQuotaParams): Promise<ApiResponse>;
+    /**
+     * List namespaces enriched with quota and spending data.
+     *
+     * Returns namespace entities merged with financial info — total spent,
+     * active quotas, and per-service breakdown.
+     *
+     * ```ts
+     * const res = await client.namespaces.listWithQuotas({ status: 'active', limit: 20 });
+     * ```
+     */
+    listWithQuotas(params?: NamespaceListWithQuotasParams): Promise<ApiResponse>;
+    /**
+     * Get comprehensive namespace details — quotas, usage stats, service breakdown,
+     * daily timeline, and recent transactions.
+     *
+     * ```ts
+     * const details = await client.namespaces.getDetails('production', { days: 30 });
+     * ```
+     */
+    getDetails(namespace: string, params?: NamespaceDetailsParams): Promise<ApiResponse>;
+    /**
+     * Set a default quota configuration.
+     *
+     * Default quotas are automatically applied to new namespaces when
+     * `autoApply` is enabled. Useful for SaaS platforms that assign a standard
+     * spending limit to every customer namespace.
+     *
+     * ```ts
+     * await client.namespaces.setDefaultQuota({
+     *   service: 'sandbox',
+     *   quotaLimit: 100,
+     *   period: 'monthly',
+     *   overdraft: 10,
+     *   onOverdraftAction: 'block',
+     *   autoApply: true,
+     * });
+     * ```
+     */
+    setDefaultQuota(params: SetDefaultQuotaParams): Promise<ApiResponse>;
+    /**
+     * Get the default quota configuration for a service.
+     *
+     * ```ts
+     * const config = await client.namespaces.getDefaultQuota('sandbox');
+     * ```
+     */
+    getDefaultQuota(service: string): Promise<ApiResponse>;
+    /**
+     * Get all default quota configurations.
+     *
+     * ```ts
+     * const configs = await client.namespaces.getAllDefaultQuotas();
+     * ```
+     */
+    getAllDefaultQuotas(): Promise<ApiResponse>;
+    /**
+     * Delete a default quota configuration for a service.
+     *
+     * ```ts
+     * await client.namespaces.deleteDefaultQuota('sandbox');
+     * ```
+     */
+    deleteDefaultQuota(service: string): Promise<ApiResponse>;
+    /**
+     * Toggle auto-apply for a default quota. When enabled, the default quota
+     * is automatically assigned to new namespaces that don't have one yet.
+     *
+     * ```ts
+     * await client.namespaces.toggleDefaultQuotaAutoApply('sandbox', true);
+     * ```
+     */
+    toggleDefaultQuotaAutoApply(service: string, autoApply: boolean): Promise<ApiResponse>;
+}
+//# sourceMappingURL=namespace.d.ts.map

package/dist/namespace.d.ts.map

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