@trigger.dev/core 0.0.0-buffer-fix-20231206151546 → 0.0.0-bun-prerelease-20260909132648

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

@@ -0,0 +1,113 @@
+import type { IdempotencyKeyOptions, IdempotencyKeyScope } from "./idempotency-key-catalog/catalog.js";
+import type { IdempotencyKey } from "./types/idempotencyKeys.js";
+import type { ZodFetchOptions } from "./apiClient/core.js";
+export type { IdempotencyKeyScope, IdempotencyKeyOptions, } from "./idempotency-key-catalog/catalog.js";
+/**
+ * Extracts the user-provided key and scope from an idempotency key created with `idempotencyKeys.create()`.
+ *
+ * @param idempotencyKey The idempotency key to extract options from
+ * @returns The original key and scope, or undefined if the key doesn't have attached options
+ *
+ * @example
+ * ```typescript
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * const options = getIdempotencyKeyOptions(key);
+ * // options = { key: "my-key", scope: "global" }
+ * ```
+ */
+export declare function getIdempotencyKeyOptions(idempotencyKey: IdempotencyKey | string): IdempotencyKeyOptions | undefined;
+/**
+ * Clears the in-process idempotency key catalog.
+ *
+ * The catalog maps an idempotency-key hash back to its original key and scope so
+ * the SDK can attach that metadata when triggering. The worker calls this at each
+ * run boundary so the mapping does not accumulate across warm-start runs.
+ */
+export declare function resetIdempotencyKeyCatalog(): void;
+export declare function isIdempotencyKey(value: string | string[] | IdempotencyKey): value is IdempotencyKey;
+export declare function flattenIdempotencyKey(idempotencyKey?: IdempotencyKey | string | string[] | (undefined | IdempotencyKey | string | string[])[]): IdempotencyKey | string | string[] | undefined;
+export declare function makeIdempotencyKey(idempotencyKey?: IdempotencyKey | string | string[]): Promise<IdempotencyKey | undefined>;
+/**
+ * Creates a deterministic idempotency key based on the provided key material.
+ *
+ * If running inside a task, the task run ID is automatically included in the key material, giving you a unique key per task run.
+ * This ensures that a given child task is only triggered once per task run, even if the parent task is retried.
+ *
+ * @param {string | string[]} key The key material to create the idempotency key from.
+ * @param {object} [options] Additional options.
+ * @param {"run" | "attempt" | "global"} [options.scope="run"] The scope of the idempotency key.
+ *
+ * @returns {Promise<IdempotencyKey>} The idempotency key as a branded string.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { idempotencyKeys, task } from "@trigger.dev/sdk/v3";
+ *
+ * export const myTask = task({
+ *  id: "my-task",
+ *  run: async (payload: any) => {
+ *   const idempotencyKey = await idempotencyKeys.create("my-task-key");
+ *
+ *   // Use the idempotency key when triggering child tasks
+ *   await childTask.triggerAndWait(payload, { idempotencyKey });
+ *  }
+ * });
+ * ```
+ *
+ * You can also use the `scope` parameter to create a key that is unique per task run, task run attempts (retries of the same run), or globally:
+ *
+ * ```typescript
+ *  await idempotencyKeys.create("my-task-key", { scope: "attempt" }); // Creates a key that is unique per task run attempt
+ *  await idempotencyKeys.create("my-task-key", { scope: "global" }); // Skips including the task run ID
+ * ```
+ */
+export declare function createIdempotencyKey(key: string | string[], options?: {
+    scope?: IdempotencyKeyScope;
+}): Promise<IdempotencyKey>;
+type AttemptKeyMaterial = {
+    run: {
+        id: string;
+    };
+    attempt: {
+        number: number;
+    };
+};
+/** Creates a unique key for each attempt. */
+export declare function attemptKey(ctx: AttemptKeyMaterial): string;
+export type ResetIdempotencyKeyOptions = {
+    scope?: IdempotencyKeyScope;
+    /** Required if scope is "run" or "attempt" to reconstruct the hash */
+    parentRunId?: string;
+    /** Required if scope is "attempt" to reconstruct the hash */
+    attemptNumber?: number;
+};
+/**
+ * Resets an idempotency key, effectively deleting it from the associated task.
+ *
+ * @param taskIdentifier The task identifier (e.g., "my-task")
+ * @param idempotencyKey The idempotency key to reset. Can be:
+ *   - An `IdempotencyKey` created with `idempotencyKeys.create()` (options are extracted automatically)
+ *   - A string or string array (requires `options.scope` and potentially `options.parentRunId`)
+ * @param options Options for reconstructing the hash if needed
+ * @param requestOptions Optional fetch options
+ *
+ * @example
+ * ```typescript
+ * // Using a key created with idempotencyKeys.create() - options are extracted automatically
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * await idempotencyKeys.reset("my-task", key);
+ *
+ * // Using a raw string with global scope
+ * await idempotencyKeys.reset("my-task", "my-key", { scope: "global" });
+ *
+ * // Using a raw string with run scope (requires parentRunId)
+ * await idempotencyKeys.reset("my-task", "my-key", {
+ *   scope: "run",
+ *   parentRunId: "run_abc123"
+ * });
+ * ```
+ */
+export declare function resetIdempotencyKey(taskIdentifier: string, idempotencyKey: IdempotencyKey | string | string[], options?: ResetIdempotencyKeyOptions, requestOptions?: ZodFetchOptions): Promise<{
+    id: string;
+}>;

package/dist/commonjs/v3/idempotencyKeys.js

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIdempotencyKeyOptions = getIdempotencyKeyOptions;
+exports.resetIdempotencyKeyCatalog = resetIdempotencyKeyCatalog;
+exports.isIdempotencyKey = isIdempotencyKey;
+exports.flattenIdempotencyKey = flattenIdempotencyKey;
+exports.makeIdempotencyKey = makeIdempotencyKey;
+exports.createIdempotencyKey = createIdempotencyKey;
+exports.attemptKey = attemptKey;
+exports.resetIdempotencyKey = resetIdempotencyKey;
+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()`.
+ *
+ * @param idempotencyKey The idempotency key to extract options from
+ * @returns The original key and scope, or undefined if the key doesn't have attached options
+ *
+ * @example
+ * ```typescript
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * const options = getIdempotencyKeyOptions(key);
+ * // options = { key: "my-key", scope: "global" }
+ * ```
+ */
+function getIdempotencyKeyOptions(idempotencyKey) {
+    // Look up options from the catalog using the hash string
+    if (typeof idempotencyKey === "string") {
+        return idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.getKeyOptions(idempotencyKey);
+    }
+    return undefined;
+}
+/**
+ * Clears the in-process idempotency key catalog.
+ *
+ * The catalog maps an idempotency-key hash back to its original key and scope so
+ * the SDK can attach that metadata when triggering. The worker calls this at each
+ * run boundary so the mapping does not accumulate across warm-start runs.
+ */
+function resetIdempotencyKeyCatalog() {
+    idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.clear();
+}
+function isIdempotencyKey(value) {
+    // Cannot check the brand at runtime because it doesn't exist (it's a TypeScript-only construct)
+    // Check for primitive strings only (we no longer use String objects)
+    if (typeof value === "string") {
+        return value.length === 64;
+    }
+    return false;
+}
+function flattenIdempotencyKey(idempotencyKey) {
+    if (!idempotencyKey) {
+        return;
+    }
+    if (Array.isArray(idempotencyKey)) {
+        //if any items are undefined, then return undefined for the entire key
+        if (idempotencyKey.some((i) => i === undefined)) {
+            return;
+        }
+        return idempotencyKey.flatMap((key) => {
+            const k = flattenIdempotencyKey(key);
+            if (!k)
+                return [];
+            return [k];
+        });
+    }
+    return idempotencyKey;
+}
+async function makeIdempotencyKey(idempotencyKey) {
+    if (!idempotencyKey) {
+        return;
+    }
+    if (isIdempotencyKey(idempotencyKey)) {
+        return idempotencyKey;
+    }
+    return await createIdempotencyKey(idempotencyKey, {
+        scope: "run",
+    });
+}
+/**
+ * Creates a deterministic idempotency key based on the provided key material.
+ *
+ * If running inside a task, the task run ID is automatically included in the key material, giving you a unique key per task run.
+ * This ensures that a given child task is only triggered once per task run, even if the parent task is retried.
+ *
+ * @param {string | string[]} key The key material to create the idempotency key from.
+ * @param {object} [options] Additional options.
+ * @param {"run" | "attempt" | "global"} [options.scope="run"] The scope of the idempotency key.
+ *
+ * @returns {Promise<IdempotencyKey>} The idempotency key as a branded string.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { idempotencyKeys, task } from "@trigger.dev/sdk/v3";
+ *
+ * export const myTask = task({
+ *  id: "my-task",
+ *  run: async (payload: any) => {
+ *   const idempotencyKey = await idempotencyKeys.create("my-task-key");
+ *
+ *   // Use the idempotency key when triggering child tasks
+ *   await childTask.triggerAndWait(payload, { idempotencyKey });
+ *  }
+ * });
+ * ```
+ *
+ * You can also use the `scope` parameter to create a key that is unique per task run, task run attempts (retries of the same run), or globally:
+ *
+ * ```typescript
+ *  await idempotencyKeys.create("my-task-key", { scope: "attempt" }); // Creates a key that is unique per task run attempt
+ *  await idempotencyKeys.create("my-task-key", { scope: "global" }); // Skips including the task run ID
+ * ```
+ */
+async function createIdempotencyKey(key, options) {
+    const scope = options?.scope ?? "run";
+    const keyArray = Array.isArray(key) ? key : [key];
+    const userKey = keyArray.join("-");
+    const idempotencyKey = await generateIdempotencyKey(keyArray.concat(injectScope(scope)));
+    // Register the original key and scope in the catalog for later extraction
+    idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.registerKeyOptions(idempotencyKey, { key: userKey, scope });
+    // Return primitive string cast as IdempotencyKey
+    return idempotencyKey;
+}
+function injectScope(scope) {
+    switch (scope) {
+        case "run": {
+            if (task_context_api_js_1.taskContext?.ctx) {
+                return [task_context_api_js_1.taskContext.ctx.run.id];
+            }
+            break;
+        }
+        case "attempt": {
+            if (task_context_api_js_1.taskContext?.ctx) {
+                return [task_context_api_js_1.taskContext.ctx.run.id, task_context_api_js_1.taskContext.ctx.attempt.number.toString()];
+            }
+            break;
+        }
+    }
+    return [];
+}
+async function generateIdempotencyKey(keyMaterial) {
+    return await (0, crypto_js_1.digestSHA256)(keyMaterial.join("-"));
+}
+/** Creates a unique key for each attempt. */
+function attemptKey(ctx) {
+    return `${ctx.run.id}-${ctx.attempt.number}`;
+}
+/**
+ * Resets an idempotency key, effectively deleting it from the associated task.
+ *
+ * @param taskIdentifier The task identifier (e.g., "my-task")
+ * @param idempotencyKey The idempotency key to reset. Can be:
+ *   - An `IdempotencyKey` created with `idempotencyKeys.create()` (options are extracted automatically)
+ *   - A string or string array (requires `options.scope` and potentially `options.parentRunId`)
+ * @param options Options for reconstructing the hash if needed
+ * @param requestOptions Optional fetch options
+ *
+ * @example
+ * ```typescript
+ * // Using a key created with idempotencyKeys.create() - options are extracted automatically
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * await idempotencyKeys.reset("my-task", key);
+ *
+ * // Using a raw string with global scope
+ * await idempotencyKeys.reset("my-task", "my-key", { scope: "global" });
+ *
+ * // Using a raw string with run scope (requires parentRunId)
+ * await idempotencyKeys.reset("my-task", "my-key", {
+ *   scope: "run",
+ *   parentRunId: "run_abc123"
+ * });
+ * ```
+ */
+async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requestOptions) {
+    const client = apiClientManager_api_js_1.apiClientManager.clientOrThrow();
+    // 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);
+        }
+    }
+    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];
+            break;
+        }
+        case "attempt": {
+            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()];
+            break;
+        }
+    }
+    // Generate the hash using the same algorithm as createIdempotencyKey
+    const hash = await generateIdempotencyKey(keyArray.concat(scopeSuffix));
+    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

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

package/dist/commonjs/v3/imports/superjson-cjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"superjson-cjs.cjs","sourceRoot":"","sources":["../../../../src/v3/imports/superjson-cjs.cts"],"names":[],"mappings":";;AAAA,sEAAsE;AACtE,gEAAgE;AAChE,aAAa;AACb,MAAM,SAAS,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAErD,aAAa;AACb,SAAS,CAAC,OAAO,CAAC,cAAc,CAC9B;IACE,YAAY,EAAE,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7F,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,CAAW,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAC7C,EACD,QAAQ,CACT,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC"}

package/dist/commonjs/v3/imports/superjson.d.ts

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

package/dist/commonjs/v3/imports/superjson.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Use vendored superjson bundle to avoid ESM/CJS compatibility issues
+// See: https://github.com/triggerdotdev/trigger.dev/issues/2937
+// @ts-ignore
+const superjson = require("../vendor/superjson.cjs");
+// @ts-ignore
+superjson.default.registerCustom({
+    isApplicable: (v) => typeof Buffer === "function" && Buffer.isBuffer(v),
+    serialize: (v) => [...v],
+    deserialize: (v) => Buffer.from(v),
+}, "buffer");
+// @ts-ignore
+module.exports.default = superjson.default;
+//# sourceMappingURL=superjson-cjs.cjs.map

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

@@ -0,0 +1,55 @@
+export * from "./apiClient/index.js";
+export * from "./apiClient/types.js";
+export * from "./apiClient/pagination.js";
+export type { ApiPromise, OffsetLimitPagePromise, CursorPagePromise } from "./apiClient/core.js";
+export * from "./apiClient/errors.js";
+export * from "./apiClient/refreshAccessToken.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";
+export * from "./task-context-api.js";
+export * from "./trace-context-api.js";
+export * from "./apiClientManager-api.js";
+export * from "./sdkScope-api.js";
+export * from "./usage-api.js";
+export * from "./run-metadata-api.js";
+export * from "./wait-until-api.js";
+export * from "./timeout-api.js";
+export * from "./run-timeline-metrics-api.js";
+export * from "./lifecycle-hooks-api.js";
+export * from "./locals-api.js";
+export * from "./heartbeats-api.js";
+export * from "./realtime-streams-api.js";
+export * from "./input-streams-api.js";
+export * from "./session-streams-api.js";
+export * from "./waitpoints/index.js";
+export * from "./schemas/index.js";
+export { SemanticInternalAttributes } from "./semanticInternalAttributes.js";
+export * from "./resource-catalog-api.js";
+export * from "./types/index.js";
+export { links } from "./links.js";
+export * from "./jwt.js";
+export * from "./apiKeys.js";
+export * from "./workloadDeploymentToken.js";
+export * from "./idempotencyKeys.js";
+export * from "./streams/asyncIterableStream.js";
+export * from "./utils/getEnv.js";
+export * from "./tryCatch.js";
+export { formatDuration, formatDurationInDays, formatDurationMilliseconds, formatDurationNanoseconds, millisecondsToNanoseconds, nanosecondsToMilliseconds, } from "./utils/durations.js";
+export type { LogLevel } from "./logger/taskLogger.js";
+export { eventFilterMatches } from "../eventFilterMatches.js";
+export { flattenAttributes, primitiveValueOrflattenedAttributes, unflattenAttributes, NULL_SENTINEL, } from "./utils/flattenAttributes.js";
+export { omit } from "./utils/omit.js";
+export { generateFriendlyId, fromFriendlyId } from "./isomorphic/friendlyId.js";
+export { calculateNextRetryDelay, calculateResetAt, defaultFetchRetryOptions, defaultRetryOptions, } from "./utils/retries.js";
+export { accessoryAttributes } from "./utils/styleAttributes.js";
+export { conditionallyExportPacket, conditionallyImportPacket, createPacketAttributes, createPacketAttributesAsJson, packetRequiresOffloading, parsePacket, prettyPrintPacket, stringifyIO, type IOPacket, } from "./utils/ioSerialization.js";
+export * from "./utils/imageRef.js";
+export * from "./utils/interval.js";
+export * from "./config.js";
+export { getSchemaParseFn, type AnySchemaParseFn, type AnyZodSchema, type SchemaParseFn, type ZodErrorLike, type ZodIssueLike, type inferSchemaOut, type inferZodSchemaInput, type inferZodSchemaOutput, isSchemaZodEsque, isSchemaValibotEsque, isSchemaArkTypeEsque, } from "./types/schemas.js";
+import { VERSION } from "../version.js";
+export { VERSION as CORE_VERSION };

package/dist/commonjs/v3/index.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_VERSION = exports.isSchemaArkTypeEsque = exports.isSchemaValibotEsque = exports.isSchemaZodEsque = exports.getSchemaParseFn = exports.stringifyIO = exports.prettyPrintPacket = exports.parsePacket = exports.packetRequiresOffloading = exports.createPacketAttributesAsJson = exports.createPacketAttributes = exports.conditionallyImportPacket = exports.conditionallyExportPacket = exports.accessoryAttributes = exports.defaultRetryOptions = exports.defaultFetchRetryOptions = exports.calculateResetAt = exports.calculateNextRetryDelay = exports.fromFriendlyId = exports.generateFriendlyId = exports.omit = exports.NULL_SENTINEL = exports.unflattenAttributes = exports.primitiveValueOrflattenedAttributes = exports.flattenAttributes = exports.eventFilterMatches = exports.nanosecondsToMilliseconds = exports.millisecondsToNanoseconds = exports.formatDurationNanoseconds = exports.formatDurationMilliseconds = exports.formatDurationInDays = exports.formatDuration = exports.links = exports.SemanticInternalAttributes = void 0;
+__exportStar(require("./apiClient/index.js"), exports);
+__exportStar(require("./apiClient/types.js"), exports);
+__exportStar(require("./apiClient/pagination.js"), exports);
+__exportStar(require("./apiClient/errors.js"), exports);
+__exportStar(require("./apiClient/refreshAccessToken.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);
+__exportStar(require("./task-context-api.js"), exports);
+__exportStar(require("./trace-context-api.js"), exports);
+__exportStar(require("./apiClientManager-api.js"), exports);
+__exportStar(require("./sdkScope-api.js"), exports);
+__exportStar(require("./usage-api.js"), exports);
+__exportStar(require("./run-metadata-api.js"), exports);
+__exportStar(require("./wait-until-api.js"), exports);
+__exportStar(require("./timeout-api.js"), exports);
+__exportStar(require("./run-timeline-metrics-api.js"), exports);
+__exportStar(require("./lifecycle-hooks-api.js"), exports);
+__exportStar(require("./locals-api.js"), exports);
+__exportStar(require("./heartbeats-api.js"), exports);
+__exportStar(require("./realtime-streams-api.js"), exports);
+__exportStar(require("./input-streams-api.js"), exports);
+__exportStar(require("./session-streams-api.js"), exports);
+__exportStar(require("./waitpoints/index.js"), exports);
+__exportStar(require("./schemas/index.js"), exports);
+var semanticInternalAttributes_js_1 = require("./semanticInternalAttributes.js");
+Object.defineProperty(exports, "SemanticInternalAttributes", { enumerable: true, get: function () { return semanticInternalAttributes_js_1.SemanticInternalAttributes; } });
+__exportStar(require("./resource-catalog-api.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+var links_js_1 = require("./links.js");
+Object.defineProperty(exports, "links", { enumerable: true, get: function () { return links_js_1.links; } });
+__exportStar(require("./jwt.js"), exports);
+__exportStar(require("./apiKeys.js"), exports);
+__exportStar(require("./workloadDeploymentToken.js"), exports);
+__exportStar(require("./idempotencyKeys.js"), exports);
+__exportStar(require("./streams/asyncIterableStream.js"), exports);
+__exportStar(require("./utils/getEnv.js"), exports);
+__exportStar(require("./tryCatch.js"), exports);
+var durations_js_1 = require("./utils/durations.js");
+Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return durations_js_1.formatDuration; } });
+Object.defineProperty(exports, "formatDurationInDays", { enumerable: true, get: function () { return durations_js_1.formatDurationInDays; } });
+Object.defineProperty(exports, "formatDurationMilliseconds", { enumerable: true, get: function () { return durations_js_1.formatDurationMilliseconds; } });
+Object.defineProperty(exports, "formatDurationNanoseconds", { enumerable: true, get: function () { return durations_js_1.formatDurationNanoseconds; } });
+Object.defineProperty(exports, "millisecondsToNanoseconds", { enumerable: true, get: function () { return durations_js_1.millisecondsToNanoseconds; } });
+Object.defineProperty(exports, "nanosecondsToMilliseconds", { enumerable: true, get: function () { return durations_js_1.nanosecondsToMilliseconds; } });
+var eventFilterMatches_js_1 = require("../eventFilterMatches.js");
+Object.defineProperty(exports, "eventFilterMatches", { enumerable: true, get: function () { return eventFilterMatches_js_1.eventFilterMatches; } });
+var flattenAttributes_js_1 = require("./utils/flattenAttributes.js");
+Object.defineProperty(exports, "flattenAttributes", { enumerable: true, get: function () { return flattenAttributes_js_1.flattenAttributes; } });
+Object.defineProperty(exports, "primitiveValueOrflattenedAttributes", { enumerable: true, get: function () { return flattenAttributes_js_1.primitiveValueOrflattenedAttributes; } });
+Object.defineProperty(exports, "unflattenAttributes", { enumerable: true, get: function () { return flattenAttributes_js_1.unflattenAttributes; } });
+Object.defineProperty(exports, "NULL_SENTINEL", { enumerable: true, get: function () { return flattenAttributes_js_1.NULL_SENTINEL; } });
+var omit_js_1 = require("./utils/omit.js");
+Object.defineProperty(exports, "omit", { enumerable: true, get: function () { return omit_js_1.omit; } });
+var friendlyId_js_1 = require("./isomorphic/friendlyId.js");
+Object.defineProperty(exports, "generateFriendlyId", { enumerable: true, get: function () { return friendlyId_js_1.generateFriendlyId; } });
+Object.defineProperty(exports, "fromFriendlyId", { enumerable: true, get: function () { return friendlyId_js_1.fromFriendlyId; } });
+var retries_js_1 = require("./utils/retries.js");
+Object.defineProperty(exports, "calculateNextRetryDelay", { enumerable: true, get: function () { return retries_js_1.calculateNextRetryDelay; } });
+Object.defineProperty(exports, "calculateResetAt", { enumerable: true, get: function () { return retries_js_1.calculateResetAt; } });
+Object.defineProperty(exports, "defaultFetchRetryOptions", { enumerable: true, get: function () { return retries_js_1.defaultFetchRetryOptions; } });
+Object.defineProperty(exports, "defaultRetryOptions", { enumerable: true, get: function () { return retries_js_1.defaultRetryOptions; } });
+var styleAttributes_js_1 = require("./utils/styleAttributes.js");
+Object.defineProperty(exports, "accessoryAttributes", { enumerable: true, get: function () { return styleAttributes_js_1.accessoryAttributes; } });
+var ioSerialization_js_1 = require("./utils/ioSerialization.js");
+Object.defineProperty(exports, "conditionallyExportPacket", { enumerable: true, get: function () { return ioSerialization_js_1.conditionallyExportPacket; } });
+Object.defineProperty(exports, "conditionallyImportPacket", { enumerable: true, get: function () { return ioSerialization_js_1.conditionallyImportPacket; } });
+Object.defineProperty(exports, "createPacketAttributes", { enumerable: true, get: function () { return ioSerialization_js_1.createPacketAttributes; } });
+Object.defineProperty(exports, "createPacketAttributesAsJson", { enumerable: true, get: function () { return ioSerialization_js_1.createPacketAttributesAsJson; } });
+Object.defineProperty(exports, "packetRequiresOffloading", { enumerable: true, get: function () { return ioSerialization_js_1.packetRequiresOffloading; } });
+Object.defineProperty(exports, "parsePacket", { enumerable: true, get: function () { return ioSerialization_js_1.parsePacket; } });
+Object.defineProperty(exports, "prettyPrintPacket", { enumerable: true, get: function () { return ioSerialization_js_1.prettyPrintPacket; } });
+Object.defineProperty(exports, "stringifyIO", { enumerable: true, get: function () { return ioSerialization_js_1.stringifyIO; } });
+__exportStar(require("./utils/imageRef.js"), exports);
+__exportStar(require("./utils/interval.js"), exports);
+__exportStar(require("./config.js"), exports);
+var schemas_js_1 = require("./types/schemas.js");
+Object.defineProperty(exports, "getSchemaParseFn", { enumerable: true, get: function () { return schemas_js_1.getSchemaParseFn; } });
+Object.defineProperty(exports, "isSchemaZodEsque", { enumerable: true, get: function () { return schemas_js_1.isSchemaZodEsque; } });
+Object.defineProperty(exports, "isSchemaValibotEsque", { enumerable: true, get: function () { return schemas_js_1.isSchemaValibotEsque; } });
+Object.defineProperty(exports, "isSchemaArkTypeEsque", { enumerable: true, get: function () { return schemas_js_1.isSchemaArkTypeEsque; } });
+const version_js_1 = require("../version.js");
+Object.defineProperty(exports, "CORE_VERSION", { enumerable: true, get: function () { return version_js_1.VERSION; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAE1C,wDAAsC;AACtC,oEAAkD;AAClD,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,iDAa4B;AAZ1B,8GAAA,gBAAgB,OAAA;AAShB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,kHAAA,oBAAoB,OAAA;AAGtB,8CAAwC;6FAA/B,oBAAO"}

package/dist/commonjs/v3/input-streams-api.d.ts

@@ -0,0 +1,3 @@
+import { InputStreamsAPI } from "./inputStreams/index.js";
+export declare const inputStreams: InputStreamsAPI;
+export * from "./inputStreams/types.js";

package/dist/commonjs/v3/input-streams-api.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inputStreams = void 0;
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+const index_js_1 = require("./inputStreams/index.js");
+exports.inputStreams = index_js_1.InputStreamsAPI.getInstance();
+__exportStar(require("./inputStreams/types.js"), exports);
+//# sourceMappingURL=input-streams-api.js.map

package/dist/commonjs/v3/input-streams-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-streams-api.js","sourceRoot":"","sources":["../../../src/v3/input-streams-api.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sEAAsE;AACtE,qCAAqC;AACrC,sDAA0D;AAE7C,QAAA,YAAY,GAAG,0BAAe,CAAC,WAAW,EAAE,CAAC;AAE1D,0DAAwC"}

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

@@ -0,0 +1,23 @@
+import type { InputStreamManager, InputStreamOncePromise } from "./types.js";
+import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+export declare class InputStreamsAPI implements InputStreamManager {
+    #private;
+    private static _instance?;
+    private constructor();
+    static getInstance(): InputStreamsAPI;
+    setGlobalManager(manager: InputStreamManager): boolean;
+    setRunId(runId: string, streamsVersion?: string): void;
+    on(streamId: string, handler: (data: unknown) => void | Promise<void>): {
+        off: () => void;
+    };
+    once(streamId: string, options?: InputStreamOnceOptions): InputStreamOncePromise<unknown>;
+    peek(streamId: string): unknown | undefined;
+    lastSeqNum(streamId: string): number | undefined;
+    setLastSeqNum(streamId: string, seqNum: number): void;
+    shiftBuffer(streamId: string): boolean;
+    disconnectStream(streamId: string): void;
+    clearHandlers(): void;
+    reset(): void;
+    disconnect(): void;
+    connectTail(runId: string, fromSeq?: number): void;
+}