veryfront 0.1.274 → 0.1.276

package/src/src/sandbox/sandbox.ts

@@ -18,6 +18,7 @@ import {
 } from "../errors/index.js";
 import { getVeryfrontCloudAuthToken } from "../platform/cloud/resolver.js";
 import { getHostEnv } from "../platform/compat/process.js";
+import { LazySandbox, type LazySandboxOptions } from "./lazy-sandbox.js";
 
 /** Options for command execution: working directory, timeout, and environment variables. */
 export interface ExecOptions {
@@ -39,6 +40,25 @@ export interface SandboxOptions {
   projectId?: string;
 }
 
+export function resolveSandboxApiUrl(options: SandboxOptions = {}): string {
+  return options.apiUrl ||
+    getHostEnv("VERYFRONT_API_URL") ||
+    "https://api.veryfront.com";
+}
+
+export function resolveSandboxAuthToken(options: SandboxOptions = {}): string {
+  const authToken = options.authToken?.trim() || getVeryfrontCloudAuthToken();
+  if (authToken) return authToken;
+
+  throw toError(
+    createError({
+      type: "config",
+      message:
+        "Sandbox auth not configured. Set VERYFRONT_API_TOKEN, provide request-scoped Veryfront credentials, or pass authToken explicitly.",
+    }),
+  );
+}
+
 /** Result of a command execution: stdout, stderr, and exit code. */
 export interface ExecResult {
   stdout: string;
@@ -117,22 +137,11 @@ export class Sandbox {
   ) {}
 
   private static resolveApiUrl(options: SandboxOptions = {}): string {
-    return options.apiUrl ||
-      getHostEnv("VERYFRONT_API_URL") ||
-      "https://api.veryfront.com";
+    return resolveSandboxApiUrl(options);
   }
 
   private static resolveAuthToken(options: SandboxOptions = {}): string {
-    const authToken = options.authToken?.trim() || getVeryfrontCloudAuthToken();
-    if (authToken) return authToken;
-
-    throw toError(
-      createError({
-        type: "config",
-        message:
-          "Sandbox auth not configured. Set VERYFRONT_API_TOKEN, provide request-scoped Veryfront credentials, or pass authToken explicitly.",
-      }),
-    );
+    return resolveSandboxAuthToken(options);
   }
 
   /** Create a new sandbox session. Claims a warm pod or creates a new one. */
@@ -232,26 +241,12 @@ export class Sandbox {
     maxWaitMs = 60_000,
     pollIntervalMs = 2_000,
   ): Promise<void> {
-    const start = Date.now();
-    while (Date.now() - start < maxWaitMs) {
-      // no cleanup needed: one-shot
-      await new Promise((r) => dntShim.setTimeout(r, pollIntervalMs));
-
-      const res = await fetch(`${apiUrl}/sandbox-sessions/${id}`, {
-        headers: { Authorization: `Bearer ${authToken}` },
-      });
+    await waitForSandboxReady({ apiUrl, id, authToken, maxWaitMs, pollIntervalMs });
+  }
 
-      if (res.ok) {
-        const data = await res.json();
-        if (data.status === "running") return;
-        if (data.status === "error" || data.status === "deleting") {
-          throw INITIALIZATION_ERROR.create({
-            detail: `Sandbox failed to start: status=${data.status}`,
-          });
-        }
-      }
-    }
-    throw TIMEOUT_ERROR.create({ detail: "Sandbox did not become ready within timeout" });
+  /** Create a lazily-provisioned sandbox session with automatic heartbeats. */
+  static createLazy(options: LazySandboxOptions = {}): LazySandbox {
+    return new LazySandbox(options);
   }
 
   /** Execute a bash command in the sandbox and return buffered result. */
@@ -486,3 +481,37 @@ export class Sandbox {
     return this.endpoint;
   }
 }
+
+export async function waitForSandboxReady(input: {
+  apiUrl: string;
+  id: string;
+  authToken: string;
+  maxWaitMs?: number;
+  pollIntervalMs?: number;
+}): Promise<void> {
+  const maxWaitMs = input.maxWaitMs ?? 60_000;
+  const pollIntervalMs = input.pollIntervalMs ?? 2_000;
+  const start = Date.now();
+
+  while (Date.now() - start < maxWaitMs) {
+    await new Promise((resolve) => dntShim.setTimeout(resolve, pollIntervalMs));
+
+    const res = await fetch(`${input.apiUrl}/sandbox-sessions/${input.id}`, {
+      headers: { Authorization: `Bearer ${input.authToken}` },
+    });
+
+    if (!res.ok) {
+      continue;
+    }
+
+    const data = await res.json();
+    if (data.status === "running") return;
+    if (data.status === "error" || data.status === "deleting") {
+      throw INITIALIZATION_ERROR.create({
+        detail: `Sandbox failed to start: status=${data.status}`,
+      });
+    }
+  }
+
+  throw TIMEOUT_ERROR.create({ detail: "Sandbox did not become ready within timeout" });
+}

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.274";
+export const VERSION = "0.1.276";