@enclave-run/sdk 0.0.0 → 0.2.0

package/dist/index.mjs

@@ -60,7 +60,7 @@ import createClient from "openapi-fetch";
 import platform2 from "platform";
 
 // package.json
-var version = "0.0.0";
+var version = "0.2.0";
 
 // src/utils.ts
 import platform from "platform";
@@ -102,12 +102,6 @@ async function sha256(data) {
 function timeoutToSeconds(timeout) {
   return Math.ceil(timeout / 1e3);
 }
-async function dynamicImport(module) {
-  if (runtime === "browser") {
-    throw new Error("Browser runtime is not supported for dynamic import");
-  }
-  return await import(module);
-}
 function ansiRegex({ onlyFirst = false } = {}) {
   const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
   const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
@@ -172,6 +166,13 @@ var OutcomeUnknownError = class extends SandboxError {
     this.cause = cause;
   }
 };
+var SandboxCreateFailedError = class extends SandboxError {
+  constructor(message, recovery) {
+    super(message);
+    this.name = "SandboxCreateFailedError";
+    this.recovery = recovery;
+  }
+};
 var SandboxCreateRejectedError = class extends SandboxError {
   constructor(message, recovery, reason, spilloverAllowed = false, capacityTier = "shared") {
     super(message);
@@ -248,7 +249,7 @@ var TemplateTagConflictError = class extends TemplateError {
   constructor(options) {
     var _a3;
     super(
-      (_a3 = options.message) != null ? _a3 : `Template tag "${options.tag}" conflicted with another mutation. Fetch its current head with Template.getTagHead() before retrying.`
+      (_a3 = options.message) != null ? _a3 : `Template tag "${options.tag}" conflicted with another mutation. Read its current head with Template.getTags() before retrying.`
     );
     this.name = "TemplateTagConflictError";
     this.templateId = options.templateId;
@@ -3529,8 +3530,9 @@ var SandboxApi = class {
         return operation.sandbox;
       }
       if (operation.state === "failed") {
-        throw new SandboxError(
-          (_b = (_a3 = operation.error) == null ? void 0 : _a3.message) != null ? _b : "Sandbox create failed after admission"
+        throw new SandboxCreateFailedError(
+          (_b = (_a3 = operation.error) == null ? void 0 : _a3.message) != null ? _b : "Sandbox create failed after admission",
+          recovery
         );
       }
       await new Promise((resolve) => setTimeout(resolve, 25));
@@ -4561,6 +4563,18 @@ var STACK_TRACE_DEPTH = 3;
 var RESOLVE_SYMLINKS = false;
 
 // src/template/utils.ts
+async function loadGlob() {
+  if (runtime === "browser") {
+    throw new Error("Browser runtime is not supported for local file copies");
+  }
+  return await import("glob");
+}
+async function loadTar() {
+  if (runtime === "browser") {
+    throw new Error("Browser runtime is not supported for local file copies");
+  }
+  return await import("tar");
+}
 function validateRelativePath(src, stackTrace) {
   if (path.isAbsolute(src)) {
     const error = new TemplateError(
@@ -4591,7 +4605,7 @@ function normalizePath(path2) {
   return path2.replace(/\\/g, "/");
 }
 async function getAllFilesInPath(src, contextPath, ignorePatterns, includeDirectories = true) {
-  const { glob } = await dynamicImport("glob");
+  const { glob } = await loadGlob();
   const files = /* @__PURE__ */ new Map();
   const globFiles = await glob(src, {
     ignore: ignorePatterns,
@@ -4708,7 +4722,7 @@ function padOctal(mode) {
   return mode.toString(8).padStart(4, "0");
 }
 async function getTarArchiveInputs(fileName, fileContextPath, ignorePatterns) {
-  const { create } = await dynamicImport("tar");
+  const { create } = await loadTar();
   const allFiles = await getAllFilesInPath(
     fileName,
     fileContextPath,
@@ -5032,7 +5046,8 @@ async function getTemplateTags(client, { templateID }) {
   return res.data.map((item) => ({
     tag: item.tag,
     buildId: item.buildID,
-    createdAt: new Date(item.createdAt)
+    createdAt: new Date(item.createdAt),
+    version: item.version
   }));
 }
 
@@ -5258,126 +5273,10 @@ function handleCmdEntrypointInstruction(instruction, templateBuilder) {
   }
 }
 
-// src/template/activationApi.ts
-async function activateTemplate(build, options = {}) {
-  assertBuildIdentity(build);
-  assertExpectedVersion(options.expectedVersion);
-  const region = resolveRegion(options.region);
-  const config = ConnectionConfig.forGlobal(options);
-  const client = new ApiClient(config);
-  const response = await client.api.POST(
-    "/templates/{templateID}/activations/{region}",
-    {
-      params: {
-        path: {
-          templateID: build.templateId,
-          region
-        }
-      },
-      body: {
-        buildID: build.buildId,
-        active: true,
-        requiredReadyNodes: options.requiredReadyNodes,
-        allowRemoteFallback: options.allowRemoteFallback,
-        expectedVersion: options.expectedVersion
-      },
-      signal: config.getSignal(options.requestTimeoutMs)
-    }
-  );
-  return responseData(response, "Enclave API returned no template activation");
-}
-async function deactivateTemplate(build, options = {}) {
-  assertBuildIdentity(build);
-  assertExpectedVersion(options.expectedVersion);
-  const region = resolveRegion(options.region);
-  const config = ConnectionConfig.forGlobal(options);
-  const client = new ApiClient(config);
-  const response = await client.api.POST(
-    "/templates/{templateID}/activations/{region}",
-    {
-      params: {
-        path: {
-          templateID: build.templateId,
-          region
-        }
-      },
-      body: {
-        buildID: build.buildId,
-        active: false,
-        expectedVersion: options.expectedVersion
-      },
-      signal: config.getSignal(options.requestTimeoutMs)
-    }
-  );
-  return responseData(response, "Enclave API returned no template activation");
-}
-async function getTemplateActivation(templateId, options = {}) {
-  if (!templateId.trim()) {
-    throw new InvalidArgumentError("templateId is required");
-  }
-  if (options.buildId !== void 0 && !options.buildId.trim()) {
-    throw new InvalidArgumentError("buildId must not be empty");
-  }
-  const region = resolveRegion(options.region);
-  const config = ConnectionConfig.forSandbox(__spreadProps(__spreadValues({}, options), { region }));
-  const client = new ApiClient(config);
-  const response = await client.api.GET(
-    "/templates/{templateID}/activations/{region}",
-    {
-      params: {
-        path: {
-          templateID: templateId,
-          region
-        },
-        query: {
-          buildID: options.buildId
-        }
-      },
-      signal: config.getSignal(options.requestTimeoutMs)
-    }
-  );
-  return responseData(response, "Enclave API returned no template activation");
-}
-function assertBuildIdentity(build) {
-  if (!build.templateId.trim() || !build.buildId.trim()) {
-    throw new InvalidArgumentError("templateId and buildId are required");
-  }
-}
-function resolveRegion(region) {
-  return ConnectionConfig.resolveRegion(region);
-}
-function assertExpectedVersion(expectedVersion) {
-  if (expectedVersion !== void 0 && (!Number.isSafeInteger(expectedVersion) || expectedVersion < 0)) {
-    throw new InvalidArgumentError(
-      "expectedVersion must be a non-negative safe integer"
-    );
-  }
-}
-
 // src/template/tagHeadApi.ts
-async function getTemplateTagHead(client, templateId, tag, signal) {
-  assertTemplateAndTag(templateId, tag);
-  const response = await client.api.GET("/templates/{templateID}/tags/{tag}", {
-    params: {
-      path: {
-        templateID: templateId,
-        tag
-      }
-    },
-    signal
-  });
-  const error = handleApiError(response, TemplateError);
-  if (error) {
-    throw error;
-  }
-  if (!response.data) {
-    throw new TemplateError("Enclave API returned no template tag head");
-  }
-  return mapTagHead(response.data);
-}
 async function promoteTemplateTag(client, candidate, tag, expected, signal) {
   var _a3, _b, _c, _d, _e, _f;
-  assertBuildIdentity2(candidate);
+  assertBuildIdentity(candidate);
   assertTemplateAndTag(candidate.templateId, tag);
   assertExpectation(expected);
   const response = await client.api.PUT("/templates/{templateID}/tags/{tag}", {
@@ -5403,7 +5302,7 @@ async function promoteTemplateTag(client, candidate, tag, expected, signal) {
       expectedBuildId: expected == null ? void 0 : expected.buildId,
       expectedVersion: (_f = expected == null ? void 0 : expected.version) != null ? _f : 0,
       reason: response.error.code,
-      message: `409: ${message}. Fetch its current head with Template.getTagHead() before retrying.`
+      message: `409: ${message}. Read its current head with Template.getTags() before retrying.`
     });
   }
   const error = handleApiError(response, TemplateError);
@@ -5413,14 +5312,10 @@ async function promoteTemplateTag(client, candidate, tag, expected, signal) {
   if (!response.data) {
     throw new TemplateError("Enclave API returned no promoted template tag");
   }
-  return mapTagHead(response.data);
-}
-function mapTagHead(head) {
   return {
-    tag: head.tag,
-    buildId: head.buildID,
-    version: head.version,
-    createdAt: new Date(head.createdAt)
+    buildId: response.data.buildID,
+    tags: [response.data.tag],
+    version: response.data.version
   };
 }
 function assertTemplateAndTag(templateId, tag) {
@@ -5428,7 +5323,7 @@ function assertTemplateAndTag(templateId, tag) {
     throw new InvalidArgumentError("templateId and tag are required");
   }
 }
-function assertBuildIdentity2(candidate) {
+function assertBuildIdentity(candidate) {
   if (!candidate.templateId.trim() || !candidate.buildId.trim()) {
     throw new InvalidArgumentError("templateId and buildId are required");
   }
@@ -5583,29 +5478,6 @@ var TemplateBase = class {
       logsOffset: options == null ? void 0 : options.logsOffset
     });
   }
-  /**
-   * Materialize one immutable template build in a region before create.
-   *
-   * The request is recorded on the global control plane; hydration then runs
-   * asynchronously inside the selected region. Poll {@link getActivation}
-   * until the returned status is `ready`.
-   */
-  static async activate(data, options) {
-    return activateTemplate(data, options);
-  }
-  /**
-   * Return desired state plus exact-generation evidence from the selected
-   * regional cell.
-   */
-  static async getActivation(templateId, options) {
-    return getTemplateActivation(templateId, options);
-  }
-  /**
-   * Stop pinning and maintaining one exact build generation in a region.
-   */
-  static async deactivate(data, options) {
-    return deactivateTemplate(data, options);
-  }
   /**
    * Check if a template with the given name exists.
    *
@@ -5643,10 +5515,25 @@ var TemplateBase = class {
    * await Template.assignTags('my-template:v1.0', ['production', 'stable'])
    * ```
    */
-  static async assignTags(targetName, tags, options) {
+  static async assignTags(target, tags, options) {
     const config = ConnectionConfig.forGlobal(options);
     const client = new ApiClient(config);
     const normalizedTags = Array.isArray(tags) ? tags : [tags];
+    if ((options == null ? void 0 : options.expect) !== void 0) {
+      if (typeof target === "string" || normalizedTags.length !== 1) {
+        throw new InvalidArgumentError(
+          "assignTags with expect requires an exact build ({ templateId, buildId }) and exactly one tag"
+        );
+      }
+      return promoteTemplateTag(
+        client,
+        target,
+        normalizedTags[0],
+        options.expect,
+        config.getSignal(options.requestTimeoutMs)
+      );
+    }
+    const targetName = typeof target === "string" ? target : `${target.templateId}:${target.buildId}`;
     return assignTags(client, { targetName, tags: normalizedTags });
   }
   /**
@@ -5691,42 +5578,6 @@ var TemplateBase = class {
     const client = new ApiClient(config);
     return getTemplateTags(client, { templateID: templateId });
   }
-  /**
-   * Get the authoritative traffic-selection token for one template tag.
-   *
-   * Pass the returned head directly to {@link promoteTag}; its monotonic
-   * version prevents concurrent releasers from silently overwriting each
-   * other.
-   */
-  static async getTagHead(templateId, tag, options) {
-    const config = ConnectionConfig.forGlobal(options);
-    const client = new ApiClient(config);
-    return getTemplateTagHead(
-      client,
-      templateId,
-      tag,
-      config.getSignal(options == null ? void 0 : options.requestTimeoutMs)
-    );
-  }
-  /**
-   * Atomically move one template tag to an exact ready, durable build.
-   *
-   * Use a head returned by {@link getTagHead} as `expected`. Pass `null` only
-   * when creating a tag that must not already exist. A concurrent change throws
-   * `TemplateTagConflictError`; fetch the head again before deciding whether to
-   * retry.
-   */
-  static async promoteTag(candidate, tag, expected, options) {
-    const config = ConnectionConfig.forGlobal(options);
-    const client = new ApiClient(config);
-    return promoteTemplateTag(
-      client,
-      candidate,
-      tag,
-      expected,
-      config.getSignal(options == null ? void 0 : options.requestTimeoutMs)
-    );
-  }
   fromDebianImage(variant = "stable") {
     return this.fromImage(`debian:${variant}`);
   }
@@ -6404,15 +6255,10 @@ function Template(options) {
 Template.build = TemplateBase.build;
 Template.buildInBackground = TemplateBase.buildInBackground;
 Template.getBuildStatus = TemplateBase.getBuildStatus;
-Template.activate = TemplateBase.activate;
-Template.getActivation = TemplateBase.getActivation;
-Template.deactivate = TemplateBase.deactivate;
 Template.exists = TemplateBase.exists;
 Template.assignTags = TemplateBase.assignTags;
 Template.removeTags = TemplateBase.removeTags;
 Template.getTags = TemplateBase.getTags;
-Template.getTagHead = TemplateBase.getTagHead;
-Template.promoteTag = TemplateBase.promoteTag;
 Template.toJSON = TemplateBase.toJSON;
 Template.toDockerfile = TemplateBase.toDockerfile;
 
@@ -6444,6 +6290,7 @@ export {
   ReadyCmd,
   RegionCapacityError,
   Sandbox,
+  SandboxCreateFailedError,
   SandboxCreateRejectedError,
   SandboxError,
   SandboxRegionScope,