@enclave-run/sdk 0.1.0 → 0.3.0

package/dist/index.mjs

@@ -60,7 +60,7 @@ import createClient from "openapi-fetch";
 import platform2 from "platform";
 
 // package.json
-var version = "0.1.0";
+var version = "0.3.0";
 
 // src/utils.ts
 import platform from "platform";
@@ -249,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;
@@ -3373,7 +3373,7 @@ var SandboxApi = class {
     return true;
   }
   static async createSandbox(template, timeoutMs, opts) {
-    var _a3, _b, _c;
+    var _a3, _b;
     const config = ConnectionConfig.forSandbox(opts);
     const client = new ApiClient(config);
     const idempotencyKey = (_a3 = opts == null ? void 0 : opts.idempotencyKey) != null ? _a3 : crypto.randomUUID();
@@ -3392,8 +3392,7 @@ var SandboxApi = class {
       mcp: opts == null ? void 0 : opts.mcp,
       envVars: opts == null ? void 0 : opts.envs,
       timeout: timeoutToSeconds(timeoutMs),
-      secure: (_b = opts == null ? void 0 : opts.secure) != null ? _b : true,
-      allow_internet_access: (_c = opts == null ? void 0 : opts.allowInternetAccess) != null ? _c : true,
+      allow_internet_access: (_b = opts == null ? void 0 : opts.allowInternetAccess) != null ? _b : true,
       network: opts == null ? void 0 : opts.network,
       autoPause: pauseOnTimeout
     }, pauseOnTimeout ? { autoResume: { policy: lifecycle.autoResume ? "any" : "off" } } : {}), config.region ? { region: config.region } : {});
@@ -5046,7 +5045,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
   }));
 }
 
@@ -5272,126 +5272,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}", {
@@ -5417,7 +5301,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);
@@ -5427,14 +5311,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) {
@@ -5442,7 +5322,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");
   }
@@ -5597,29 +5477,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.
    *
@@ -5657,10 +5514,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 });
   }
   /**
@@ -5705,42 +5577,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}`);
   }
@@ -6418,15 +6254,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;