@blaxel/core 0.3.26-preview.310 → 0.3.26-preview.311

package/dist/cjs/common/settings.js

@@ -30,8 +30,8 @@ function missingCredentialsMessage() {
     return "No Blaxel credentials found. Set the BL_API_KEY and BL_WORKSPACE environment variables, or run `bl login`.";
 }
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.3.26-preview.310";
-const BUILD_COMMIT = "13bd8f75d15c2c81add546bcabeee2f20a224417";
+const BUILD_VERSION = "0.3.26-preview.311";
+const BUILD_COMMIT = "a62496fa4537136926770cdd0d6e48ceb8506491";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-09-22";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2

package/dist/cjs/sandbox/preview.js

@@ -2,11 +2,48 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxPreviews = exports.SandboxPreview = exports.SandboxPreviewTokens = exports.SandboxPreviewToken = void 0;
 const index_js_1 = require("../client/index.js");
+function isShorthand(preview) {
+    return !("metadata" in preview || "spec" in preview);
+}
+function normalizePreview(preview) {
+    if (!isShorthand(preview))
+        return preview;
+    if (!Number.isInteger(preview.port) || preview.port < 1 || preview.port > 65535) {
+        throw new RangeError("Preview port must be an integer between 1 and 65535");
+    }
+    if (preview.name !== undefined && (typeof preview.name !== "string" || preview.name.length === 0)) {
+        throw new RangeError("Preview name must be a nonempty string");
+    }
+    if (preview.public !== undefined && typeof preview.public !== "boolean") {
+        throw new RangeError("Preview public must be a boolean");
+    }
+    return {
+        metadata: { name: preview.name ?? `preview-${preview.port}` },
+        spec: { port: preview.port, public: preview.public ?? false },
+    };
+}
+// Explicit HTTP status takes precedence over a legacy numeric service code.
+function httpStatus(error) {
+    if (typeof error !== "object" || error === null)
+        return undefined;
+    const fields = error;
+    const response = fields.response;
+    const responseStatus = typeof response === "object" && response !== null && "status" in response
+        ? response.status : undefined;
+    for (const status of [fields.status, fields.statusCode, responseStatus, fields.code]) {
+        if (typeof status === "number")
+            return status;
+    }
+    return undefined;
+}
 class SandboxPreviewToken {
     previewToken;
     constructor(previewToken) {
         this.previewToken = previewToken;
     }
+    get name() {
+        return this.previewToken.metadata?.name ?? "";
+    }
     get value() {
         return this.previewToken.spec.token ?? "";
     }
@@ -47,6 +84,49 @@ class SandboxPreviewTokens {
         });
         return new SandboxPreviewToken(data);
     }
+    /**
+     * Reuse the latest token within the requested expiry ceiling, or mint one.
+     * minValidity is in milliseconds. Concurrent callers may create separate tokens.
+     */
+    async createIfExpired(expiresAt, minValidity = 3_600_000) {
+        const now = Date.now();
+        if (!Number.isFinite(minValidity) || minValidity < 0) {
+            throw new RangeError("minValidity must be finite and non-negative");
+        }
+        const requestedExpiry = expiresAt ?? new Date(now + 86_400_000);
+        const ceiling = requestedExpiry instanceof Date ? requestedExpiry.getTime() : NaN;
+        if (!Number.isFinite(ceiling) || ceiling <= now || ceiling < now + minValidity) {
+            throw new RangeError("expiresAt must be a valid future date at least minValidity from now");
+        }
+        if (this.preview.spec?.public === true) {
+            throw new Error("Cannot create or reuse a token for a public preview");
+        }
+        const { data } = await (0, index_js_1.listSandboxPreviewTokens)({
+            path: {
+                sandboxName: this.resourceName,
+                previewName: this.previewName,
+            },
+            throwOnError: true,
+        });
+        if (!Array.isArray(data))
+            throw new Error("Failed to list preview tokens");
+        let selected;
+        let latestExpiry = -Infinity;
+        for (const token of data) {
+            const spec = token?.spec;
+            if (!spec || typeof spec.token !== "string" || spec.token.length === 0 || spec.expired === true ||
+                typeof spec.expiresAt !== "string")
+                continue;
+            const expiry = Date.parse(spec.expiresAt);
+            if (!Number.isFinite(expiry) || expiry <= now || expiry < now + minValidity || expiry > ceiling)
+                continue;
+            if (expiry > latestExpiry) {
+                selected = token;
+                latestExpiry = expiry;
+            }
+        }
+        return selected ? new SandboxPreviewToken(selected) : this.create(requestedExpiry);
+    }
     async list() {
         const { data } = await (0, index_js_1.listSandboxPreviewTokens)({
             path: {
@@ -80,6 +160,9 @@ class SandboxPreview {
     get name() {
         return this.preview.metadata.name;
     }
+    get url() {
+        return this.preview.spec?.url ?? "";
+    }
     get metadata() {
         return this.preview.metadata;
     }
@@ -106,6 +189,7 @@ class SandboxPreviews {
         return data.map((preview) => new SandboxPreview(preview));
     }
     async create(preview, force) {
+        const normalized = normalizePreview(preview);
         const query = {};
         if (force) {
             query['force'] = 'true';
@@ -115,12 +199,31 @@ class SandboxPreviews {
                 sandboxName: this.sandboxName,
             },
             query,
-            body: preview,
+            body: normalized,
             throwOnError: true,
         });
         return new SandboxPreview(data);
     }
+    /** Existing previews are returned as-is; shorthand's private default applies only on creation. */
     async createIfNotExists(preview, force) {
+        if (isShorthand(preview)) {
+            const normalized = normalizePreview(preview);
+            try {
+                return await this.get(normalized.metadata.name);
+            }
+            catch (error) {
+                if (httpStatus(error) !== 404)
+                    throw error;
+            }
+            try {
+                return await this.create(normalized, force);
+            }
+            catch (error) {
+                if (httpStatus(error) !== 409)
+                    throw error;
+                return this.get(normalized.metadata.name);
+            }
+        }
         try {
             const previewInstance = await this.get(preview.metadata.name);
             return previewInstance;

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

@@ -1,7 +1,9 @@
-import { Preview, PreviewToken, Sandbox } from "../client/index.js";
+import type { Preview, PreviewToken, Sandbox } from "../client/index.js";
+import type { SandboxPreviewCreateConfiguration } from "./types.js";
 export declare class SandboxPreviewToken {
     private previewToken;
     constructor(previewToken: PreviewToken);
+    get name(): string;
     get value(): string;
     get expiresAt(): string | Date;
     get expired(): boolean;
@@ -12,6 +14,11 @@ export declare class SandboxPreviewTokens {
     get previewName(): string;
     get resourceName(): string;
     create(expiresAt: Date): Promise<SandboxPreviewToken>;
+    /**
+     * Reuse the latest token within the requested expiry ceiling, or mint one.
+     * minValidity is in milliseconds. Concurrent callers may create separate tokens.
+     */
+    createIfExpired(expiresAt?: Date, minValidity?: number): Promise<SandboxPreviewToken>;
     list(): Promise<SandboxPreviewToken[]>;
     delete(tokenName: string): Promise<{
         message?: string;
@@ -22,6 +29,7 @@ export declare class SandboxPreview {
     tokens: SandboxPreviewTokens;
     constructor(preview: Preview);
     get name(): string;
+    get url(): string;
     get metadata(): import("../client/types.gen.js").PreviewMetadata;
     get spec(): import("../client/types.gen.js").PreviewSpec;
 }
@@ -30,8 +38,9 @@ export declare class SandboxPreviews {
     constructor(sandbox: Sandbox);
     get sandboxName(): string;
     list(): Promise<SandboxPreview[]>;
-    create(preview: Preview, force?: boolean): Promise<SandboxPreview>;
-    createIfNotExists(preview: Preview, force?: boolean): Promise<SandboxPreview>;
+    create(preview: Preview | SandboxPreviewCreateConfiguration, force?: boolean): Promise<SandboxPreview>;
+    /** Existing previews are returned as-is; shorthand's private default applies only on creation. */
+    createIfNotExists(preview: Preview | SandboxPreviewCreateConfiguration, force?: boolean): Promise<SandboxPreview>;
     get(previewName: string): Promise<SandboxPreview>;
     delete(previewName: string): Promise<Preview>;
     private waitForDeletion;

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

@@ -38,6 +38,13 @@ export type SandboxUpdateMetadata = {
 export type SandboxUpdateNetwork = {
     network?: SandboxNetwork;
 };
+export type SandboxPreviewCreateConfiguration = {
+    port: number;
+    /** Defaults to preview-<port> within this sandbox. */
+    name?: string;
+    /** Defaults to false on creation; existing previews are not changed. */
+    public?: boolean;
+};
 export type SandboxCreateConfiguration = {
     name?: string;
     image?: string;