@blaxel/core 0.2.96-preview.204 → 0.2.96-preview.205

package/dist/cjs-browser/types/sandbox/client/types.gen.d.ts

@@ -37,8 +37,16 @@ export type DriveListResponse = {
 export type DriveMountInfo = {
     driveName?: string;
     drivePath?: string;
+    /**
+     * The local GID used for this mount
+     */
+    gidMap?: string;
     mountPath?: string;
     readOnly?: boolean;
+    /**
+     * The local UID used for this mount
+     */
+    uidMap?: string;
 };
 export type DriveMountRequest = {
     driveName: string;
@@ -46,19 +54,35 @@ export type DriveMountRequest = {
      * Optional, defaults to "/"
      */
     drivePath?: string;
+    /**
+     * Optional, local GID to map (filer GID is always 0)
+     */
+    gidMap?: string;
     mountPath: string;
     /**
      * Optional, defaults to false
      */
     readOnly?: boolean;
+    /**
+     * Optional, local UID to map (filer UID is always 0)
+     */
+    uidMap?: string;
 };
 export type DriveMountResponse = {
     driveName?: string;
     drivePath?: string;
+    /**
+     * The local GID used for this mount
+     */
+    gidMap?: string;
     message?: string;
     mountPath?: string;
     readOnly?: boolean;
     success?: boolean;
+    /**
+     * The local UID used for this mount
+     */
+    uidMap?: string;
 };
 export type DriveUnmountResponse = {
     message?: string;
@@ -175,6 +199,9 @@ export type ProcessRequest = {
      * Disable scale-to-zero while process runs. Default timeout is 600s (10 minutes). Set timeout to 0 for infinite.
      */
     keepAlive?: boolean;
+    /**
+     * Maximum number of restarts on failure. Set to a negative value (e.g. -1) for unlimited restarts.
+     */
     maxRestarts?: number;
     name?: string;
     restartOnFailure?: boolean;
@@ -241,7 +268,7 @@ export type UpgradeRequest = {
      */
     baseUrl?: string;
     /**
-     * Version to upgrade to: "develop", "main", "latest", or specific tag like "v1.0.0"
+     * Version to upgrade to: "latest" (default), "develop", "main", or specific tag like "v1.0.0"
      */
     version?: string;
 };

package/dist/cjs-browser/types/sandbox/preview.d.ts

@@ -30,8 +30,8 @@ export declare class SandboxPreviews {
     constructor(sandbox: Sandbox);
     get sandboxName(): string;
     list(): Promise<SandboxPreview[]>;
-    create(preview: Preview): Promise<SandboxPreview>;
-    createIfNotExists(preview: Preview): Promise<SandboxPreview>;
+    create(preview: Preview, force?: boolean): Promise<SandboxPreview>;
+    createIfNotExists(preview: Preview, force?: boolean): Promise<SandboxPreview>;
     get(previewName: string): Promise<SandboxPreview>;
     delete(previewName: string): Promise<Preview>;
     private waitForDeletion;

package/dist/cjs-browser/types/sandbox/sandbox.d.ts

@@ -1,5 +1,5 @@
 import type http2 from "http2";
-import { SandboxLifecycle, Sandbox as SandboxModel } from "../client/index.js";
+import { type ListSandboxesData, type SandboxLifecycle, type Sandbox as SandboxModel } from "../client/index.js";
 import { SandboxCodegen } from "./codegen/index.js";
 import { SandboxDrive } from "./drive/index.js";
 import { SandboxFileSystem } from "./filesystem/index.js";
@@ -10,6 +10,7 @@ import { SandboxSchedules } from "./schedule.js";
 import { SandboxSessions } from "./session.js";
 import { SandboxSystem } from "./system.js";
 import { SandboxConfiguration, SandboxCreateConfiguration, SandboxUpdateMetadata, SandboxUpdateNetwork, SessionWithToken } from "./types.js";
+export type SandboxListQuery = NonNullable<ListSandboxesData["query"]>;
 export declare class SandboxInstance {
     private sandbox;
     fs: SandboxFileSystem;
@@ -54,9 +55,41 @@ export declare class SandboxInstance {
     }): Promise<SandboxInstance>;
     static get(sandboxName: string): Promise<SandboxInstance>;
     static getByExternalId(externalId: string): Promise<SandboxInstance>;
-    static list({ externalId }?: {
+    /**
+     * List one page of sandboxes.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and helpers to fetch more pages only when you need them.
+     *
+     * @example
+     * ```ts
+     * const page = await SandboxInstance.list({ limit: 50 });
+     *
+     * for (const sandbox of page.data) {
+     *   console.log(sandbox.metadata.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const page = await SandboxInstance.list({ limit: 100 });
+     *
+     * for await (const sandbox of page) {
+     *   console.log(sandbox.metadata.name);
+     * }
+     * ```
+     */
+    static list(query?: SandboxListQuery): Promise<import("../common/pagination.js").PaginatedList<SandboxInstance, {
+        showTerminated?: boolean;
+        cursor?: string;
+        limit?: number;
+        sort?: "createdAt:desc" | "createdAt:asc" | "name:asc" | "name:desc";
+        q?: string;
+        anchor?: "end";
         externalId?: string;
-    }): Promise<SandboxInstance[]>;
+    }>>;
     static delete(sandboxName: string): Promise<SandboxModel>;
     delete(): Promise<SandboxModel>;
     static updateMetadata(sandboxName: string, metadata: SandboxUpdateMetadata): Promise<SandboxInstance>;

package/dist/cjs-browser/types/volume/index.d.ts

@@ -1,12 +1,13 @@
-import { Volume } from "../client/index.js";
-export interface VolumeCreateConfiguration {
+import { type ListVolumesData, type Volume } from "../client/index.js";
+export type VolumeListQuery = NonNullable<ListVolumesData["query"]>;
+export type VolumeCreateConfiguration = {
     name?: string;
     displayName?: string;
     labels?: Record<string, string>;
     size?: number;
     region?: string;
     template?: string;
-}
+};
 export declare class VolumeInstance {
     private volume;
     constructor(volume: Volume);
@@ -19,7 +20,39 @@ export declare class VolumeInstance {
     get region(): string | undefined;
     static create(config: VolumeCreateConfiguration | Volume): Promise<VolumeInstance>;
     static get(volumeName: string): Promise<VolumeInstance>;
-    static list(): Promise<VolumeInstance[]>;
+    /**
+     * List one page of volumes.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and helpers to fetch more pages only when you need them.
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 50 });
+     *
+     * for (const volume of page.data) {
+     *   console.log(volume.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 100 });
+     *
+     * for await (const volume of page) {
+     *   console.log(volume.name);
+     * }
+     * ```
+     */
+    static list(query?: VolumeListQuery): Promise<import("../common/pagination.js").PaginatedList<VolumeInstance, {
+        cursor?: string;
+        limit?: number;
+        sort?: "createdAt:desc" | "createdAt:asc" | "name:asc" | "name:desc";
+        q?: string;
+        anchor?: "end";
+    }>>;
     static delete(volumeName: string): Promise<Volume>;
     delete(): Promise<Volume>;
     static update(volumeName: string, updates: VolumeCreateConfiguration | Volume): Promise<VolumeInstance>;

package/dist/cjs-browser/volume/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VolumeInstance = void 0;
 const uuid_1 = require("uuid");
 const index_js_1 = require("../client/index.js");
+const pagination_js_1 = require("../common/pagination.js");
 const settings_js_1 = require("../common/settings.js");
 class VolumeInstance {
     volume;
@@ -88,10 +89,46 @@ class VolumeInstance {
         });
         return new VolumeInstance(data);
     }
-    static async list() {
-        const { data } = await (0, index_js_1.listVolumes)({ throwOnError: true });
-        const items = Array.isArray(data) ? data : (data?.data ?? []);
-        return items.map((volume) => new VolumeInstance(volume));
+    /**
+     * List one page of volumes.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and helpers to fetch more pages only when you need them.
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 50 });
+     *
+     * for (const volume of page.data) {
+     *   console.log(volume.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 100 });
+     *
+     * for await (const volume of page) {
+     *   console.log(volume.name);
+     * }
+     * ```
+     */
+    static async list(query) {
+        const fetchPage = async (pageQuery) => {
+            const { data } = await (0, index_js_1.listVolumes)({
+                query: pageQuery,
+                throwOnError: true,
+            });
+            return data;
+        };
+        return (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(query),
+            fetchPage,
+            mapItem: (volume) => new VolumeInstance(volume),
+            query,
+        });
     }
     static async delete(volumeName) {
         const { data } = await (0, index_js_1.deleteVolume)({