@trigger.dev/core 4.5.11 → 4.5.12

package/dist/commonjs/v3/externalDeploymentId.d.ts

@@ -0,0 +1,14 @@
+export declare const EXTERNAL_DEPLOYMENT_ID_ENV_VAR = "TRIGGER_EXTERNAL_DEPLOYMENT_ID";
+export declare const AUTOMATIC_SKEW_PROTECTION_ENV_VAR = "TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION";
+export declare const EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH = 128;
+export type EnvVarReader = (name: string) => string | undefined;
+export declare const PLATFORM_COMMIT_SHA_ENV_VARS: readonly ["VERCEL_GIT_COMMIT_SHA", "RAILWAY_GIT_COMMIT_SHA", "RENDER_GIT_COMMIT", "CF_PAGES_COMMIT_SHA", "WORKERS_CI_COMMIT_SHA", "COMMIT_REF", "AWS_COMMIT_ID", "HEROKU_BUILD_COMMIT", "HEROKU_SLUG_COMMIT", "KOYEB_GIT_SHA", "GITHUB_SHA", "CI_COMMIT_SHA", "CIRCLE_SHA1", "BITBUCKET_COMMIT", "BUILDKITE_COMMIT", "BUILD_SOURCEVERSION", "COMMIT_SHA", "DRONE_COMMIT_SHA", "GIT_COMMIT", "BUILD_VCS_NUMBER", "TRAVIS_COMMIT", "COMMIT_SHA", "COMMIT_HASH", "GIT_COMMIT", "GIT_SHA", "GIT_HASH"];
+export declare function normalizeExternalDeploymentId(value: string | undefined): string | undefined;
+export declare function isAutomaticSkewProtectionEnabled(read: EnvVarReader): boolean;
+export declare function discoverPlatformCommitSha(read: EnvVarReader): string | undefined;
+export type ResolveExternalDeploymentIdOptions = {
+    explicit?: string;
+    clientConfig?: string;
+    read: EnvVarReader;
+};
+export declare function resolveExternalDeploymentId({ explicit, clientConfig, read, }: ResolveExternalDeploymentIdOptions): string | undefined;

package/dist/commonjs/v3/externalDeploymentId.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_COMMIT_SHA_ENV_VARS = exports.EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH = exports.AUTOMATIC_SKEW_PROTECTION_ENV_VAR = exports.EXTERNAL_DEPLOYMENT_ID_ENV_VAR = void 0;
+exports.normalizeExternalDeploymentId = normalizeExternalDeploymentId;
+exports.isAutomaticSkewProtectionEnabled = isAutomaticSkewProtectionEnabled;
+exports.discoverPlatformCommitSha = discoverPlatformCommitSha;
+exports.resolveExternalDeploymentId = resolveExternalDeploymentId;
+exports.EXTERNAL_DEPLOYMENT_ID_ENV_VAR = "TRIGGER_EXTERNAL_DEPLOYMENT_ID";
+exports.AUTOMATIC_SKEW_PROTECTION_ENV_VAR = "TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION";
+exports.EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH = 128;
+exports.PLATFORM_COMMIT_SHA_ENV_VARS = [
+    "VERCEL_GIT_COMMIT_SHA",
+    "RAILWAY_GIT_COMMIT_SHA",
+    "RENDER_GIT_COMMIT",
+    "CF_PAGES_COMMIT_SHA",
+    "WORKERS_CI_COMMIT_SHA",
+    "COMMIT_REF",
+    "AWS_COMMIT_ID",
+    "HEROKU_BUILD_COMMIT",
+    "HEROKU_SLUG_COMMIT",
+    "KOYEB_GIT_SHA",
+    "GITHUB_SHA",
+    "CI_COMMIT_SHA",
+    "CIRCLE_SHA1",
+    "BITBUCKET_COMMIT",
+    "BUILDKITE_COMMIT",
+    "BUILD_SOURCEVERSION",
+    "COMMIT_SHA",
+    "DRONE_COMMIT_SHA",
+    "GIT_COMMIT",
+    "BUILD_VCS_NUMBER",
+    "TRAVIS_COMMIT",
+    "COMMIT_SHA",
+    "COMMIT_HASH",
+    "GIT_COMMIT",
+    "GIT_SHA",
+    "GIT_HASH",
+];
+function normalizeExternalDeploymentId(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed === "" || trimmed.length > exports.EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH) {
+        return undefined;
+    }
+    return trimmed;
+}
+function isAutomaticSkewProtectionEnabled(read) {
+    const raw = read(exports.AUTOMATIC_SKEW_PROTECTION_ENV_VAR);
+    if (typeof raw !== "string") {
+        return false;
+    }
+    const normalized = raw.trim().toLowerCase();
+    return normalized === "1" || normalized === "true";
+}
+function discoverPlatformCommitSha(read) {
+    for (const name of exports.PLATFORM_COMMIT_SHA_ENV_VARS) {
+        const candidate = normalizeExternalDeploymentId(read(name));
+        if (candidate) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function resolveExternalDeploymentId({ explicit, clientConfig, read, }) {
+    const fromCall = normalizeExternalDeploymentId(explicit);
+    if (fromCall)
+        return fromCall;
+    const fromClient = normalizeExternalDeploymentId(clientConfig);
+    if (fromClient)
+        return fromClient;
+    const fromEnv = normalizeExternalDeploymentId(read(exports.EXTERNAL_DEPLOYMENT_ID_ENV_VAR));
+    if (fromEnv)
+        return fromEnv;
+    if (isAutomaticSkewProtectionEnabled(read)) {
+        return discoverPlatformCommitSha(read);
+    }
+    return undefined;
+}
+//# sourceMappingURL=externalDeploymentId.js.map

package/dist/commonjs/v3/externalDeploymentId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalDeploymentId.js","sourceRoot":"","sources":["../../../src/v3/externalDeploymentId.ts"],"names":[],"mappings":";;;;;;;AAAa,QAAA,8BAA8B,GAAG,gCAAgC,CAAC;AAElE,QAAA,iCAAiC,GAAG,2CAA2C,CAAC;AAEhF,QAAA,iCAAiC,GAAG,GAAG,CAAC;AAIxC,QAAA,4BAA4B,GAAG;IAC1C,uBAAuB;IACvB,wBAAwB;IACxB,mBAAmB;IACnB,qBAAqB;IACrB,uBAAuB;IACvB,YAAY;IACZ,eAAe;IACf,qBAAqB;IACrB,oBAAoB;IACpB,eAAe;IAEf,YAAY;IACZ,eAAe;IACf,aAAa;IACb,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,kBAAkB;IAClB,eAAe;IAEf,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,SAAS;IACT,UAAU;CACF,CAAC;AAEX,uCAA8C,KAAyB;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,QAAA,iCAAiC,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0CAAiD,IAAkB;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAA,iCAAiC,CAAC,CAAC;IAEpD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE5C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,CAAC;AACrD,CAAC;AAED,mCAA0C,IAAkB;IAC1D,KAAK,MAAM,IAAI,IAAI,QAAA,4BAA4B,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE5D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAQD,qCAA4C,EAC1C,QAAQ,EACR,YAAY,EACZ,IAAI,GAC+B;IACnC,MAAM,QAAQ,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,UAAU,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC/D,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,QAAA,8BAA8B,CAAC,CAAC,CAAC;IACpF,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,IAAI,gCAAgC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/commonjs/v3/externalDeploymentId.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/v3/externalDeploymentId.test.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const externalDeploymentId_js_1 = require("./externalDeploymentId.js");
+function reader(vars) {
+    return (name) => vars[name];
+}
+const SHA = "fa1eade47b73733d6312d5abfad33ce9e4068081";
+(0, vitest_1.describe)("normalizeExternalDeploymentId", () => {
+    (0, vitest_1.it)("trims surrounding whitespace", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.normalizeExternalDeploymentId)(`  ${SHA}  `)).toBe(SHA);
+    });
+    vitest_1.it.each([undefined, "", "   ", "\t\n"])("treats %j as absent", (value) => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.normalizeExternalDeploymentId)(value)).toBeUndefined();
+    });
+    (0, vitest_1.it)("accepts exactly 128 characters", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.normalizeExternalDeploymentId)("a".repeat(128))).toBe("a".repeat(128));
+    });
+    (0, vitest_1.it)("skips a value longer than 128 characters rather than sending it to be rejected", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.normalizeExternalDeploymentId)("a".repeat(129))).toBeUndefined();
+    });
+    (0, vitest_1.it)("measures the length limit after trimming", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.normalizeExternalDeploymentId)(`  ${"a".repeat(128)}  `)).toBe("a".repeat(128));
+    });
+});
+(0, vitest_1.describe)("isAutomaticSkewProtectionEnabled", () => {
+    vitest_1.it.each([
+        ["1", true],
+        ["true", true],
+        ["TRUE", true],
+        ["True", true],
+        [" 1 ", true],
+        ["0", false],
+        ["false", false],
+        ["", false],
+        ["yes", false],
+        ["on", false],
+        ["2", false],
+        [undefined, false],
+    ])("reads %j as %s", (value, expected) => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.isAutomaticSkewProtectionEnabled)(reader({ TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION: value }))).toBe(expected);
+    });
+});
+(0, vitest_1.describe)("discoverPlatformCommitSha", () => {
+    (0, vitest_1.it)("returns undefined when nothing is set", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({}))).toBeUndefined();
+    });
+    vitest_1.it.each(externalDeploymentId_js_1.PLATFORM_COMMIT_SHA_ENV_VARS)("reads %s", (name) => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ [name]: SHA }))).toBe(SHA);
+    });
+    (0, vitest_1.it)("prefers a hosting variable over a CI variable, because it describes the deployment that is running", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ VERCEL_GIT_COMMIT_SHA: "vercel-sha", GITHUB_SHA: "github-sha" }))).toBe("vercel-sha");
+    });
+    (0, vitest_1.it)("prefers a CI variable over the generic tier", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ GITHUB_SHA: "github-sha", GIT_HASH: "generic-sha" }))).toBe("github-sha");
+    });
+    (0, vitest_1.it)("falls back to the generic tier when nothing named is set", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ COMMIT_HASH: "generic-sha" }))).toBe("generic-sha");
+    });
+    (0, vitest_1.it)("honours the full hosting order", () => {
+        const order = [
+            "VERCEL_GIT_COMMIT_SHA",
+            "RAILWAY_GIT_COMMIT_SHA",
+            "RENDER_GIT_COMMIT",
+            "CF_PAGES_COMMIT_SHA",
+            "WORKERS_CI_COMMIT_SHA",
+            "COMMIT_REF",
+            "AWS_COMMIT_ID",
+            "HEROKU_BUILD_COMMIT",
+            "HEROKU_SLUG_COMMIT",
+            "KOYEB_GIT_SHA",
+        ];
+        const vars = Object.fromEntries(order.map((n) => [n, n]));
+        for (const expected of order) {
+            (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader(vars))).toBe(expected);
+            delete vars[expected];
+        }
+    });
+    (0, vitest_1.it)("skips an empty value and keeps looking", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ VERCEL_GIT_COMMIT_SHA: "", GITHUB_SHA: SHA }))).toBe(SHA);
+    });
+    (0, vitest_1.it)("skips an over-long value and keeps looking, rather than sending something that will be rejected", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ VERCEL_GIT_COMMIT_SHA: "a".repeat(129), GITHUB_SHA: SHA }))).toBe(SHA);
+    });
+    (0, vitest_1.it)("never reads CACHED_COMMIT_REF, which is the previous build's SHA", () => {
+        (0, vitest_1.expect)(externalDeploymentId_js_1.PLATFORM_COMMIT_SHA_ENV_VARS).not.toContain("CACHED_COMMIT_REF");
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.discoverPlatformCommitSha)(reader({ CACHED_COMMIT_REF: SHA }))).toBeUndefined();
+    });
+});
+(0, vitest_1.describe)("resolveExternalDeploymentId", () => {
+    (0, vitest_1.it)("returns nothing when no source yields a value", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ read: reader({}) })).toBeUndefined();
+    });
+    (0, vitest_1.it)("honours a per-call id above everything else", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            explicit: "per-call",
+            clientConfig: "per-client",
+            read: reader({
+                TRIGGER_EXTERNAL_DEPLOYMENT_ID: "per-env",
+                TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION: "1",
+                VERCEL_GIT_COMMIT_SHA: "discovered",
+            }),
+        })).toBe("per-call");
+    });
+    (0, vitest_1.it)("honours a per-client id above the environment and discovery", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            clientConfig: "per-client",
+            read: reader({
+                TRIGGER_EXTERNAL_DEPLOYMENT_ID: "per-env",
+                TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION: "1",
+                VERCEL_GIT_COMMIT_SHA: "discovered",
+            }),
+        })).toBe("per-client");
+    });
+    (0, vitest_1.it)("honours TRIGGER_EXTERNAL_DEPLOYMENT_ID above discovery", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            read: reader({
+                TRIGGER_EXTERNAL_DEPLOYMENT_ID: "per-env",
+                TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION: "1",
+                VERCEL_GIT_COMMIT_SHA: "discovered",
+            }),
+        })).toBe("per-env");
+    });
+    (0, vitest_1.it)("honours an explicit id with no opt-in variable at all — the gate is on discovery, not pinning", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            read: reader({ TRIGGER_EXTERNAL_DEPLOYMENT_ID: "per-env" }),
+        })).toBe("per-env");
+    });
+    (0, vitest_1.it)("honours a per-call id with no opt-in variable", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ explicit: "per-call", read: reader({}) })).toBe("per-call");
+    });
+    (0, vitest_1.it)("discovers when the opt-in is exactly 1", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            read: reader({
+                TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION: "1",
+                VERCEL_GIT_COMMIT_SHA: SHA,
+            }),
+        })).toBe(SHA);
+    });
+    vitest_1.it.each(["0", "", "false", "yes", undefined])("discovers nothing when the opt-in reads %j", (gate) => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            read: reader({
+                TRIGGER_AUTOMATIC_SKEW_VERSION_PROTECTION: gate,
+                VERCEL_GIT_COMMIT_SHA: SHA,
+            }),
+        })).toBeUndefined();
+    });
+    (0, vitest_1.it)("normalises whatever it resolves, whichever tier produced it", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ explicit: `  ${SHA} `, read: reader({}) })).toBe(SHA);
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ clientConfig: `  ${SHA} `, read: reader({}) })).toBe(SHA);
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ read: reader({ TRIGGER_EXTERNAL_DEPLOYMENT_ID: ` ${SHA} ` }) })).toBe(SHA);
+    });
+    (0, vitest_1.it)("falls through a blank higher tier to a usable lower one", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            explicit: "   ",
+            clientConfig: "",
+            read: reader({ TRIGGER_EXTERNAL_DEPLOYMENT_ID: SHA }),
+        })).toBe(SHA);
+    });
+    (0, vitest_1.it)("reads the environment on every call, so a variable appearing later is picked up", () => {
+        const vars = {};
+        const read = reader(vars);
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ read })).toBeUndefined();
+        vars.TRIGGER_EXTERNAL_DEPLOYMENT_ID = SHA;
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({ read })).toBe(SHA);
+    });
+    (0, vitest_1.it)("reads nothing at all when the reader refuses, which is how a non-inheriting SDK scope behaves", () => {
+        (0, vitest_1.expect)((0, externalDeploymentId_js_1.resolveExternalDeploymentId)({
+            read: () => undefined,
+        })).toBeUndefined();
+    });
+});
+//# sourceMappingURL=externalDeploymentId.test.js.map

package/dist/commonjs/v3/externalDeploymentId.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalDeploymentId.test.js","sourceRoot":"","sources":["../../../src/v3/externalDeploymentId.test.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/v3/idempotencyKeys.js

@@ -12,6 +12,7 @@ const apiClientManager_api_js_1 = require("./apiClientManager-api.js");
 const idempotency_key_catalog_api_js_1 = require("./idempotency-key-catalog-api.js");
 const task_context_api_js_1 = require("./task-context-api.js");
 const crypto_js_1 = require("./utils/crypto.js");
+const errors_js_1 = require("./apiClient/errors.js");
 /**
  * Extracts the user-provided key and scope from an idempotency key created with `idempotencyKeys.create()`.
  *
@@ -176,22 +177,26 @@ function attemptKey(ctx) {
  */
 async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requestOptions) {
     const client = apiClientManager_api_js_1.apiClientManager.clientOrThrow();
-    // If the key is already a 64-char hash, use it directly
-    if (typeof idempotencyKey === "string" && idempotencyKey.length === 64) {
-        return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+    // A 64-char key is only assumed pre-hashed if the catalog knows it, or there's no scope to hash with
+    const is64CharKey = typeof idempotencyKey === "string" && idempotencyKey.length === 64;
+    if (is64CharKey) {
+        const isCreatedKey = getIdempotencyKeyOptions(idempotencyKey) !== undefined;
+        if (isCreatedKey || options?.scope === undefined) {
+            return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+        }
     }
-    // Try to extract options from an IdempotencyKey created with idempotencyKeys.create()
-    const attachedOptions = typeof idempotencyKey === "string" ? getIdempotencyKeyOptions(idempotencyKey) : undefined;
-    const scope = attachedOptions?.scope ?? options?.scope ?? "run";
-    const keyArray = Array.isArray(idempotencyKey)
-        ? idempotencyKey
-        : [attachedOptions?.key ?? String(idempotencyKey)];
+    const scope = options?.scope ?? "run";
+    const keyArray = Array.isArray(idempotencyKey) ? idempotencyKey : [idempotencyKey];
     // Build scope suffix based on scope type
     let scopeSuffix = [];
     switch (scope) {
         case "run": {
             const parentRunId = options?.parentRunId ?? task_context_api_js_1.taskContext?.ctx?.run.id;
             if (!parentRunId) {
+                // We can't derive a hash, but a 64-char key may already be one, so try it rather than fail
+                if (is64CharKey) {
+                    return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+                }
                 throw new Error("resetIdempotencyKey: parentRunId is required for 'run' scope when called outside a task context");
             }
             scopeSuffix = [parentRunId];
@@ -201,6 +206,9 @@ async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requ
             const parentRunId = options?.parentRunId ?? task_context_api_js_1.taskContext?.ctx?.run.id;
             const attemptNumber = options?.attemptNumber ?? task_context_api_js_1.taskContext?.ctx?.attempt.number;
             if (!parentRunId || attemptNumber === undefined) {
+                if (is64CharKey) {
+                    return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+                }
                 throw new Error("resetIdempotencyKey: parentRunId and attemptNumber are required for 'attempt' scope when called outside a task context");
             }
             scopeSuffix = [parentRunId, attemptNumber.toString()];
@@ -209,6 +217,22 @@ async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requ
     }
     // Generate the hash using the same algorithm as createIdempotencyKey
     const hash = await generateIdempotencyKey(keyArray.concat(scopeSuffix));
-    return client.resetIdempotencyKey(taskIdentifier, hash, requestOptions);
+    if (!is64CharKey) {
+        return client.resetIdempotencyKey(taskIdentifier, hash, requestOptions);
+    }
+    try {
+        return await client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+    }
+    catch (error) {
+        if (!(error instanceof errors_js_1.NotFoundError)) {
+            throw error;
+        }
+        try {
+            return await client.resetIdempotencyKey(taskIdentifier, hash, requestOptions);
+        }
+        catch (fallbackError) {
+            throw fallbackError instanceof errors_js_1.NotFoundError ? error : fallbackError;
+        }
+    }
 }
 //# sourceMappingURL=idempotencyKeys.js.map

package/dist/commonjs/v3/idempotencyKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/v3/idempotencyKeys.test.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const node_http_1 = require("node:http");
 const vitest_1 = require("vitest");
+const apiClientManager_api_js_1 = require("./apiClientManager-api.js");
 const idempotencyKeys_js_1 = require("./idempotencyKeys.js");
+const crypto_js_1 = require("./utils/crypto.js");
 (0, vitest_1.describe)("idempotencyKeys metadata retention", () => {
     (0, vitest_1.it)("retains key/scope options for every key created in a run, even beyond 1000", async () => {
         const count = 3000;
@@ -31,4 +34,159 @@ const idempotencyKeys_js_1 = require("./idempotencyKeys.js");
         (0, vitest_1.expect)((0, idempotencyKeys_js_1.getIdempotencyKeyOptions)(key)).toBeUndefined();
     });
 });
+(0, vitest_1.describe)("resetIdempotencyKey", () => {
+    const digestShapedKey = "a".repeat(64);
+    let server;
+    let resetKeys = [];
+    /** Keys the server has runs for. `undefined` means "accept every key". */
+    let existingKeys;
+    /** Per-key failure statuses, applied before the existence check. */
+    let statusByKey;
+    function notFoundMessage(key) {
+        return `No runs found with idempotency key: ${key}`;
+    }
+    async function resetAndCaptureKey(...args) {
+        resetKeys = [];
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)(...args);
+        (0, vitest_1.expect)(resetKeys).toHaveLength(1);
+        return resetKeys[0];
+    }
+    (0, vitest_1.beforeEach)(async () => {
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        resetKeys = [];
+        existingKeys = undefined;
+        statusByKey = new Map();
+        server = (0, node_http_1.createServer)((req, res) => {
+            req.resume();
+            req.on("end", () => {
+                const match = /^\/api\/v1\/idempotencyKeys\/(.+)\/reset$/.exec(req.url ?? "");
+                if (!match) {
+                    res.writeHead(404).end();
+                    return;
+                }
+                const key = decodeURIComponent(match[1]);
+                resetKeys.push(key);
+                const failWith = statusByKey.get(key);
+                if (failWith !== undefined) {
+                    res.writeHead(failWith, { "content-type": "application/json" });
+                    res.end(JSON.stringify({ error: `request failed for ${key}` }));
+                    return;
+                }
+                if (existingKeys !== undefined && !existingKeys.has(key)) {
+                    res.writeHead(404, { "content-type": "application/json" });
+                    res.end(JSON.stringify({ error: notFoundMessage(key) }));
+                    return;
+                }
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end(JSON.stringify({ id: "run_reset" }));
+            });
+        });
+        await new Promise((resolve) => {
+            server.listen(0, "127.0.0.1", () => resolve());
+        });
+        apiClientManager_api_js_1.apiClientManager.setGlobalAPIClientConfiguration({
+            baseURL: `http://127.0.0.1:${server.address().port}`,
+            accessToken: "tr_test_key",
+        });
+    });
+    (0, vitest_1.afterEach)(async () => {
+        apiClientManager_api_js_1.apiClientManager.disable();
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        await new Promise((resolve) => server.close(() => resolve()));
+    });
+    (0, vitest_1.it)("derives the hash for 64-character key material with an explicit scope when the verbatim key misses", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)(digestShapedKey, { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, created]);
+    });
+    (0, vitest_1.it)("derives the run-scoped hash for 64-character key material when the verbatim key misses", async () => {
+        const parentRunId = "run_abc123";
+        const expected = await (0, crypto_js_1.digestSHA256)(`${digestShapedKey}-${parentRunId}`);
+        existingKeys = new Set([expected]);
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "run", parentRunId });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, expected]);
+    });
+    (0, vitest_1.it)("sends a key created with idempotencyKeys.create() unchanged while the catalog knows it", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        existingKeys = new Set([created]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created)).toBe(created);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created, { scope: "global" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a created key unchanged when no scope is passed and the catalog is cold", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        // The reset can happen in a different process from the create
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created)).toBe(created);
+    });
+    (0, vitest_1.it)("resolves a created key in one request when reset with a scope and the catalog is cold", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created, { scope: "global" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a 64-character key unchanged when no scope is passed", async () => {
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", digestShapedKey)).toBe(digestShapedKey);
+    });
+    (0, vitest_1.it)("resets 64-character material that trigger stored verbatim when no scope is passed", async () => {
+        // trigger() forwards 64-character material as-is, so that is what the server stored
+        (0, vitest_1.expect)(await (0, idempotencyKeys_js_1.makeIdempotencyKey)(digestShapedKey)).toBe(digestShapedKey);
+        existingKeys = new Set([digestShapedKey]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", digestShapedKey)).toBe(digestShapedKey);
+    });
+    (0, vitest_1.it)("resets the verbatim run when runs exist under both the verbatim key and the derived hash", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)(digestShapedKey, { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([digestShapedKey, created]);
+        await (0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey]);
+    });
+    (0, vitest_1.it)("does not reset the derived run when the verbatim attempt fails transiently", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)(digestShapedKey, { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        statusByKey.set(digestShapedKey, 503);
+        existingKeys = new Set([created]);
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" }, { retry: { maxAttempts: 1 } })).rejects.toMatchObject({ status: 503 });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey]);
+    });
+    (0, vitest_1.it)("surfaces the fallback's error when it fails with something other than a 404", async () => {
+        const derived = await (0, crypto_js_1.digestSHA256)(digestShapedKey);
+        statusByKey.set(digestShapedKey, 404);
+        statusByKey.set(derived, 503);
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" }, { retry: { maxAttempts: 1 } })).rejects.toMatchObject({ status: 503 });
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, derived]);
+    });
+    (0, vitest_1.it)("surfaces the verbatim key's error when both attempts 404", async () => {
+        const derived = await (0, crypto_js_1.digestSHA256)(digestShapedKey);
+        existingKeys = new Set();
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", digestShapedKey, { scope: "global" })).rejects.toThrow(notFoundMessage(digestShapedKey));
+        (0, vitest_1.expect)(resetKeys).toEqual([digestShapedKey, derived]);
+    });
+    (0, vitest_1.it)("hashes key material that is not 64 characters", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "global" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", "my-key", { scope: "global" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a 64-character key verbatim when run scope cannot be derived", async () => {
+        const created = await (0, idempotencyKeys_js_1.createIdempotencyKey)("my-key", { scope: "run" });
+        (0, idempotencyKeys_js_1.resetIdempotencyKeyCatalog)();
+        existingKeys = new Set([created]);
+        // No parentRunId and no task context, so the hash is underivable
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", created, { scope: "run" })).toBe(created);
+    });
+    (0, vitest_1.it)("sends a 64-character key verbatim when attempt scope cannot be derived", async () => {
+        existingKeys = new Set([digestShapedKey]);
+        (0, vitest_1.expect)(await resetAndCaptureKey("my-task", digestShapedKey, { scope: "attempt" })).toBe(digestShapedKey);
+    });
+    (0, vitest_1.it)("still throws for non-64-character material when run scope cannot be derived", async () => {
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", "my-key", { scope: "run" })).rejects.toThrow("parentRunId is required for 'run' scope");
+        (0, vitest_1.expect)(resetKeys).toEqual([]);
+    });
+    (0, vitest_1.it)("still throws for non-64-character material when attempt scope cannot be derived", async () => {
+        await (0, vitest_1.expect)((0, idempotencyKeys_js_1.resetIdempotencyKey)("my-task", "my-key", { scope: "attempt", parentRunId: "run_abc123" })).rejects.toThrow("parentRunId and attemptNumber are required for 'attempt' scope");
+        (0, vitest_1.expect)(resetKeys).toEqual([]);
+    });
+});
 //# sourceMappingURL=idempotencyKeys.test.js.map

package/dist/commonjs/v3/idempotencyKeys.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotencyKeys.test.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,6DAI8B;AAE9B,IAAA,iBAAQ,EAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,IAAA,WAAE,EAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,+CAA+C;QAC/C,MAAM,YAAY,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QACxD,IAAA,eAAM,EAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjE,wDAAwD;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YACnD,IAAA,eAAM,EAAC,OAAO,EAAE,iCAAiC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;gBAC5D,GAAG,EAAE,QAAQ,CAAC,EAAE;gBAChB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,GAAG,GAAG,MAAM,IAAA,yCAAoB,EAAC,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,IAAA,eAAM,EAAC,IAAA,6CAAwB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExF,IAAA,+CAA0B,GAAE,CAAC;QAE7B,IAAA,eAAM,EAAC,IAAA,6CAAwB,EAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"idempotencyKeys.test.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.test.ts"],"names":[],"mappings":";;AAAA,yCAAsD;AAEtD,mCAAqE;AACrE,uEAA6D;AAC7D,6DAM8B;AAC9B,iDAAiD;AAEjD,IAAA,iBAAQ,EAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,IAAA,WAAE,EAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,+CAA+C;QAC/C,MAAM,YAAY,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QACxD,IAAA,eAAM,EAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjE,wDAAwD;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YACnD,IAAA,eAAM,EAAC,OAAO,EAAE,iCAAiC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;gBAC5D,GAAG,EAAE,QAAQ,CAAC,EAAE;gBAChB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,GAAG,GAAG,MAAM,IAAA,yCAAoB,EAAC,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,IAAA,eAAM,EAAC,IAAA,6CAAwB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExF,IAAA,+CAA0B,GAAE,CAAC;QAE7B,IAAA,eAAM,EAAC,IAAA,6CAAwB,EAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEvC,IAAI,MAAc,CAAC;IACnB,IAAI,SAAS,GAAa,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,IAAI,YAAqC,CAAC;IAC1C,oEAAoE;IACpE,IAAI,WAAgC,CAAC;IAErC,SAAS,eAAe,CAAC,GAAW;QAClC,OAAO,uCAAuC,GAAG,EAAE,CAAC;IACtD,CAAC;IAED,KAAK,UAAU,kBAAkB,CAC/B,GAAG,IAA4C;QAE/C,SAAS,GAAG,EAAE,CAAC;QACf,MAAM,IAAA,wCAAmB,EAAC,GAAG,IAAI,CAAC,CAAC;QACnC,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC,CAAC,CAAE,CAAC;IACvB,CAAC;IAED,IAAA,mBAAU,EAAC,KAAK,IAAI,EAAE;QACpB,IAAA,+CAA0B,GAAE,CAAC;QAC7B,SAAS,GAAG,EAAE,CAAC;QACf,YAAY,GAAG,SAAS,CAAC;QACzB,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAExB,MAAM,GAAG,IAAA,wBAAY,EAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACjC,GAAG,CAAC,MAAM,EAAE,CAAC;YACb,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,MAAM,KAAK,GAAG,2CAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;gBAC9E,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBACzB,OAAO;gBACT,CAAC;gBAED,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;gBAC1C,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEpB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAChE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;oBAChE,OAAO;gBACT,CAAC;gBAED,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBACzD,OAAO;gBACT,CAAC;gBAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,0CAAgB,CAAC,+BAA+B,CAAC;YAC/C,OAAO,EAAE,oBAAqB,MAAM,CAAC,OAAO,EAAkB,CAAC,IAAI,EAAE;YACrE,WAAW,EAAE,aAAa;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,KAAK,IAAI,EAAE;QACnB,0CAAgB,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAA,+CAA0B,GAAE,CAAC;QAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oGAAoG,EAAE,KAAK,IAAI,EAAE;QAClH,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjF,IAAA,+CAA0B,GAAE,CAAC;QAC7B,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAElC,MAAM,IAAA,wCAAmB,EAAC,SAAS,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3E,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;QACtG,MAAM,WAAW,GAAG,YAAY,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAY,EAAC,GAAG,eAAe,IAAI,WAAW,EAAE,CAAC,CAAC;QACzE,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEnC,MAAM,IAAA,wCAAmB,EAAC,SAAS,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAErF,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;QACtG,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAElC,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE1E,8DAA8D;QAC9D,IAAA,+CAA0B,GAAE,CAAC;QAC7B,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAElC,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uFAAuF,EAAE,KAAK,IAAI,EAAE;QACrG,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE1E,IAAA,+CAA0B,GAAE,CAAC;QAC7B,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAElC,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,oFAAoF;QACpF,IAAA,eAAM,EAAC,MAAM,IAAA,uCAAkB,EAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxE,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QAE1C,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0FAA0F,EAAE,KAAK,IAAI,EAAE;QACxG,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjF,IAAA,+CAA0B,GAAE,CAAC;QAC7B,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QAEnD,MAAM,IAAA,wCAAmB,EAAC,SAAS,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3E,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjF,IAAA,+CAA0B,GAAE,CAAC;QAC7B,WAAW,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACtC,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAElC,MAAM,IAAA,eAAM,EACV,IAAA,wCAAmB,EACjB,SAAS,EACT,eAAe,EACf,EAAE,KAAK,EAAE,QAAQ,EAAE,EACnB,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAC9B,CACF,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAEzC,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAY,EAAC,eAAe,CAAC,CAAC;QACpD,WAAW,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACtC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE9B,MAAM,IAAA,eAAM,EACV,IAAA,wCAAmB,EACjB,SAAS,EACT,eAAe,EACf,EAAE,KAAK,EAAE,QAAQ,EAAE,EACnB,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAC9B,CACF,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAEzC,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAY,EAAC,eAAe,CAAC,CAAC;QACpD,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAEzB,MAAM,IAAA,eAAM,EACV,IAAA,wCAAmB,EAAC,SAAS,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CACrE,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;QAEpD,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,IAAA,+CAA0B,GAAE,CAAC;QAE7B,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,OAAO,GAAG,MAAM,IAAA,yCAAoB,EAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEvE,IAAA,+CAA0B,GAAE,CAAC;QAC7B,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAElC,iEAAiE;QACjE,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QAE1C,IAAA,eAAM,EAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CACrF,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,IAAA,eAAM,EAAC,IAAA,wCAAmB,EAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACtF,yCAAyC,CAC1C,CAAC;QAEF,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,MAAM,IAAA,eAAM,EACV,IAAA,wCAAmB,EAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAC1F,CAAC,OAAO,CAAC,OAAO,CAAC,gEAAgE,CAAC,CAAC;QAEpF,IAAA,eAAM,EAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commonjs/v3/index.d.ts

@@ -5,6 +5,7 @@ export type { ApiPromise, OffsetLimitPagePromise, CursorPagePromise } from "./ap
 export * from "./apiClient/errors.js";
 export * from "./clock-api.js";
 export * from "./errors.js";
+export * from "./externalDeploymentId.js";
 export * from "./limits.js";
 export * from "./logger-api.js";
 export * from "./runtime-api.js";

package/dist/commonjs/v3/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./apiClient/pagination.js"), exports);
 __exportStar(require("./apiClient/errors.js"), exports);
 __exportStar(require("./clock-api.js"), exports);
 __exportStar(require("./errors.js"), exports);
+__exportStar(require("./externalDeploymentId.js"), exports);
 __exportStar(require("./limits.js"), exports);
 __exportStar(require("./logger-api.js"), exports);
 __exportStar(require("./runtime-api.js"), exports);

package/dist/commonjs/v3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAE1C,wDAAsC;AACtC,iDAA+B;AAC/B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,mDAAiC;AACjC,wDAAsC;AACtC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,iDAA+B;AAC/B,wDAAsC;AACtC,sDAAoC;AACpC,mDAAiC;AACjC,gEAA8C;AAC9C,2DAAyC;AACzC,kDAAgC;AAChC,sDAAoC;AACpC,4DAA0C;AAC1C,yDAAuC;AACvC,2DAAyC;AACzC,wDAAsC;AACtC,qDAAmC;AACnC,iFAA6E;AAApE,2IAAA,0BAA0B,OAAA;AACnC,4DAA0C;AAC1C,mDAAiC;AACjC,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,2CAAyB;AACzB,+CAA6B;AAC7B,+DAA6C;AAC7C,uDAAqC;AACrC,mEAAiD;AACjD,oDAAkC;AAClC,gDAA8B;AAC9B,qDAO8B;AAN5B,8GAAA,cAAc,OAAA;AACd,oHAAA,oBAAoB,OAAA;AACpB,0HAAA,0BAA0B,OAAA;AAC1B,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AAK3B,kEAA8D;AAArD,2HAAA,kBAAkB,OAAA;AAC3B,qEAKsC;AAJpC,yHAAA,iBAAiB,OAAA;AACjB,2IAAA,mCAAmC,OAAA;AACnC,2HAAA,mBAAmB,OAAA;AACnB,qHAAA,aAAa,OAAA;AAEf,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,4DAAgF;AAAvE,mHAAA,kBAAkB,OAAA;AAAE,+GAAA,cAAc,OAAA;AAC3C,iDAK4B;AAJ1B,qHAAA,uBAAuB,OAAA;AACvB,8GAAA,gBAAgB,OAAA;AAChB,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AAErB,iEAAiE;AAAxD,yHAAA,mBAAmB,OAAA;AAE5B,iEAUoC;AATlC,+HAAA,yBAAyB,OAAA;AACzB,+HAAA,yBAAyB,OAAA;AACzB,4HAAA,sBAAsB,OAAA;AACtB,kIAAA,4BAA4B,OAAA;AAC5B,8HAAA,wBAAwB,OAAA;AACxB,iHAAA,WAAW,OAAA;AACX,uHAAA,iBAAiB,OAAA;AACjB,iHAAA,WAAW,OAAA;AAIb,sDAAoC;AACpC,sDAAoC;AAEpC,8CAA4B;AAC5B,iDAQ4B;AAP1B,8GAAA,gBAAgB,OAAA;AAIhB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,8CAAwC;6FAA/B,oBAAO"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAE1C,wDAAsC;AACtC,iDAA+B;AAC/B,8CAA4B;AAC5B,4DAA0C;AAC1C,8CAA4B;AAC5B,kDAAgC;AAChC,mDAAiC;AACjC,wDAAsC;AACtC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC;AAClC,iDAA+B;AAC/B,wDAAsC;AACtC,sDAAoC;AACpC,mDAAiC;AACjC,gEAA8C;AAC9C,2DAAyC;AACzC,kDAAgC;AAChC,sDAAoC;AACpC,4DAA0C;AAC1C,yDAAuC;AACvC,2DAAyC;AACzC,wDAAsC;AACtC,qDAAmC;AACnC,iFAA6E;AAApE,2IAAA,0BAA0B,OAAA;AACnC,4DAA0C;AAC1C,mDAAiC;AACjC,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AACd,2CAAyB;AACzB,+CAA6B;AAC7B,+DAA6C;AAC7C,uDAAqC;AACrC,mEAAiD;AACjD,oDAAkC;AAClC,gDAA8B;AAC9B,qDAO8B;AAN5B,8GAAA,cAAc,OAAA;AACd,oHAAA,oBAAoB,OAAA;AACpB,0HAAA,0BAA0B,OAAA;AAC1B,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AAK3B,kEAA8D;AAArD,2HAAA,kBAAkB,OAAA;AAC3B,qEAKsC;AAJpC,yHAAA,iBAAiB,OAAA;AACjB,2IAAA,mCAAmC,OAAA;AACnC,2HAAA,mBAAmB,OAAA;AACnB,qHAAA,aAAa,OAAA;AAEf,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,4DAAgF;AAAvE,mHAAA,kBAAkB,OAAA;AAAE,+GAAA,cAAc,OAAA;AAC3C,iDAK4B;AAJ1B,qHAAA,uBAAuB,OAAA;AACvB,8GAAA,gBAAgB,OAAA;AAChB,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AAErB,iEAAiE;AAAxD,yHAAA,mBAAmB,OAAA;AAE5B,iEAUoC;AATlC,+HAAA,yBAAyB,OAAA;AACzB,+HAAA,yBAAyB,OAAA;AACzB,4HAAA,sBAAsB,OAAA;AACtB,kIAAA,4BAA4B,OAAA;AAC5B,8HAAA,wBAAwB,OAAA;AACxB,iHAAA,WAAW,OAAA;AACX,uHAAA,iBAAiB,OAAA;AACjB,iHAAA,WAAW,OAAA;AAIb,sDAAoC;AACpC,sDAAoC;AAEpC,8CAA4B;AAC5B,iDAQ4B;AAP1B,8GAAA,gBAAgB,OAAA;AAIhB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,8CAAwC;6FAA/B,oBAAO"}

package/dist/commonjs/v3/isomorphic/deploymentVersions.d.ts

@@ -0,0 +1 @@
+export declare function compareDeploymentVersions(versionA: string, versionB: string): number;