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

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

@@ -0,0 +1,84 @@
+import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+export declare class InputStreamTimeoutError extends Error {
+    readonly streamId: string;
+    readonly timeoutMs: number;
+    constructor(streamId: string, timeoutMs: number);
+}
+export type InputStreamOnceResult<TData> = {
+    ok: true;
+    output: TData;
+} | {
+    ok: false;
+    error: InputStreamTimeoutError;
+};
+export declare class InputStreamOncePromise<TData> extends Promise<InputStreamOnceResult<TData>> {
+    constructor(executor: (resolve: (value: InputStreamOnceResult<TData> | PromiseLike<InputStreamOnceResult<TData>>) => void, reject: (reason?: any) => void) => void);
+    unwrap(): Promise<TData>;
+}
+export interface InputStreamManager {
+    /**
+     * Set the current run ID and streams version. The tail connection will be
+     * established lazily when `on()` or `once()` is first called, but only
+     * for v2 (S2-backed) realtime streams.
+     */
+    setRunId(runId: string, streamsVersion?: string): void;
+    /**
+     * Register a handler that fires every time data arrives on the given input stream.
+     * Handlers are automatically cleaned up when the task run completes.
+     * Returns `{ off }` for early unsubscription if needed.
+     */
+    on(streamId: string, handler: (data: unknown) => void | Promise<void>): {
+        off: () => void;
+    };
+    /**
+     * Wait for the next piece of data on the given input stream.
+     * Returns a result object `{ ok, output }` or `{ ok, error }`.
+     * Chain `.unwrap()` to get the data directly or throw on timeout.
+     */
+    once(streamId: string, options?: InputStreamOnceOptions): InputStreamOncePromise<unknown>;
+    /**
+     * Non-blocking peek at the most recent data on the given input stream.
+     */
+    peek(streamId: string): unknown | undefined;
+    /**
+     * The last S2 sequence number seen for the given input stream.
+     * Used by `.wait()` to tell the server where to check for existing data.
+     */
+    lastSeqNum(streamId: string): number | undefined;
+    /**
+     * Advance the last-seen S2 sequence number for the given input stream.
+     * Used after `.wait()` resumes to prevent the SSE tail from replaying
+     * the record that was consumed via the waitpoint path.
+     */
+    setLastSeqNum(streamId: string, seqNum: number): void;
+    /**
+     * Remove and discard the first buffered item for the given input stream.
+     * Used after `.wait()` resumes to remove the duplicate that the SSE tail
+     * buffered while the waitpoint was being completed via a separate path.
+     * Returns true if an item was removed, false if the buffer was empty.
+     */
+    shiftBuffer(streamId: string): boolean;
+    /**
+     * Disconnect the SSE tail and clear the buffer for a specific input stream.
+     * Used before suspending via `.wait()` so the tail doesn't buffer duplicates
+     * of data that will be delivered through the waitpoint path.
+     */
+    disconnectStream(streamId: string): void;
+    /**
+     * Clear all persistent `.on()` handlers and abort tails that have no remaining once waiters.
+     * Called automatically when a task run completes.
+     */
+    clearHandlers(): void;
+    /**
+     * Reset state between task executions.
+     */
+    reset(): void;
+    /**
+     * Disconnect any active tails / connections.
+     */
+    disconnect(): void;
+    /**
+     * Connect a tail to receive input stream records for the given run.
+     */
+    connectTail(runId: string, fromSeq?: number): void;
+}

package/dist/commonjs/v3/inputStreams/types.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputStreamOncePromise = exports.InputStreamTimeoutError = void 0;
+class InputStreamTimeoutError extends Error {
+    streamId;
+    timeoutMs;
+    constructor(streamId, timeoutMs) {
+        super(`Timeout waiting for input stream "${streamId}" after ${timeoutMs}ms`);
+        this.streamId = streamId;
+        this.timeoutMs = timeoutMs;
+        this.name = "InputStreamTimeoutError";
+    }
+}
+exports.InputStreamTimeoutError = InputStreamTimeoutError;
+class InputStreamOncePromise extends Promise {
+    constructor(executor) {
+        super(executor);
+    }
+    unwrap() {
+        return this.then((result) => {
+            if (result.ok) {
+                return result.output;
+            }
+            else {
+                throw result.error;
+            }
+        });
+    }
+}
+exports.InputStreamOncePromise = InputStreamOncePromise;
+//# sourceMappingURL=types.js.map

package/dist/commonjs/v3/inputStreams/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/v3/inputStreams/types.ts"],"names":[],"mappings":";;;AAEA,6BAAqC,SAAQ,KAAK;IAE9B,QAAQ;IACR,SAAS;IAF3B,YACkB,QAAgB,EAChB,SAAiB;QAEjC,KAAK,CAAC,qCAAqC,QAAQ,WAAW,SAAS,IAAI,CAAC,CAAC;wBAH7D,QAAQ;yBACR,SAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;;AAMD,4BAA2C,SAAQ,OAAqC;IACtF,YACE,QAKS;QAET,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,MAAM,CAAC,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,CAAC,KAAK,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export declare const CURRENT_DEPLOYMENT_LABEL = "current";
+export declare const CURRENT_UNMANAGED_DEPLOYMENT_LABEL = "current-unmanaged";

package/dist/commonjs/v3/isomorphic/consts.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENT_UNMANAGED_DEPLOYMENT_LABEL = exports.CURRENT_DEPLOYMENT_LABEL = void 0;
+exports.CURRENT_DEPLOYMENT_LABEL = "current";
+exports.CURRENT_UNMANAGED_DEPLOYMENT_LABEL = "current-unmanaged";
+//# sourceMappingURL=consts.js.map

package/dist/commonjs/v3/isomorphic/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/consts.ts"],"names":[],"mappings":";;;AAAa,QAAA,wBAAwB,GAAG,SAAS,CAAC;AACrC,QAAA,kCAAkC,GAAG,mBAAmB,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Attempts to parse a string into a valid Date.
+ *
+ * Supported formats:
+ * - ISO and RFC date strings (e.g. "2025-08-18", "2025-08-18T12:34:56Z")
+ * - Natural language dates supported by JS Date (e.g. "August 18, 2025")
+ * - Epoch seconds (10-digit numeric string, e.g. "1629302400")
+ * - Epoch milliseconds (13-digit numeric string, e.g. "1629302400000")
+ *
+ * @param input The string to parse.
+ * @returns A valid Date object, or undefined if parsing fails.
+ */
+export declare function parseDate(input: string): Date | undefined;

package/dist/commonjs/v3/isomorphic/dates.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDate = parseDate;
+/**
+ * Attempts to parse a string into a valid Date.
+ *
+ * Supported formats:
+ * - ISO and RFC date strings (e.g. "2025-08-18", "2025-08-18T12:34:56Z")
+ * - Natural language dates supported by JS Date (e.g. "August 18, 2025")
+ * - Epoch seconds (10-digit numeric string, e.g. "1629302400")
+ * - Epoch milliseconds (13-digit numeric string, e.g. "1629302400000")
+ *
+ * @param input The string to parse.
+ * @returns A valid Date object, or undefined if parsing fails.
+ */
+function parseDate(input) {
+    if (typeof input !== "string")
+        return undefined;
+    // Handle pure numeric strings as epoch values
+    if (/^\d+$/.test(input)) {
+        const num = Number(input);
+        if (input.length === 10) {
+            // Epoch seconds
+            return new Date(num * 1000);
+        }
+        else if (input.length === 13) {
+            // Epoch milliseconds
+            return new Date(num);
+        }
+        else {
+            // Unsupported numeric length
+            return undefined;
+        }
+    }
+    // Handle general date strings
+    const date = new Date(input);
+    return isNaN(date.getTime()) ? undefined : date;
+}
+//# sourceMappingURL=dates.js.map

package/dist/commonjs/v3/isomorphic/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/dates.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,mBAA0B,KAAa;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhD,8CAA8C;IAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACxB,gBAAgB;YAChB,OAAO,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC/B,qBAAqB;YACrB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}

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

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

package/dist/commonjs/v3/isomorphic/deploymentVersions.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareDeploymentVersions = compareDeploymentVersions;
+function compareDeploymentVersions(versionA, versionB) {
+    const [dateA = "", numberA] = versionA.split(".");
+    const [dateB = "", numberB] = versionB.split(".");
+    if (dateA < dateB) {
+        return -1;
+    }
+    if (dateA > dateB) {
+        return 1;
+    }
+    const numA = Number(numberA);
+    const numB = Number(numberB);
+    if (numA < numB) {
+        return -1;
+    }
+    if (numA > numB) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=deploymentVersions.js.map

package/dist/commonjs/v3/isomorphic/deploymentVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploymentVersions.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/deploymentVersions.ts"],"names":[],"mappings":";;;AAAA,mCAA0C,QAAgB,EAAE,QAAgB;IAC1E,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7B,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Parses a natural language duration string into milliseconds.
+ *
+ * @param duration - Duration string like "1s", "5m", "2h", "1d", "1w"
+ * @returns The duration in milliseconds, or undefined if invalid
+ *
+ * @example
+ * parseNaturalLanguageDurationInMs("30m") // 1800000
+ * parseNaturalLanguageDurationInMs("2h") // 7200000
+ */
+export declare function parseNaturalLanguageDurationInMs(duration: string): number | undefined;
+export declare function parseNaturalLanguageDuration(duration: string): Date | undefined;
+export declare function safeParseNaturalLanguageDuration(duration: string): Date | undefined;
+export declare function parseNaturalLanguageDurationAgo(duration: string): Date | undefined;
+export declare function safeParseNaturalLanguageDurationAgo(duration: string): Date | undefined;
+export declare function stringifyDuration(seconds: number): string | undefined;

package/dist/commonjs/v3/isomorphic/duration.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNaturalLanguageDurationInMs = parseNaturalLanguageDurationInMs;
+exports.parseNaturalLanguageDuration = parseNaturalLanguageDuration;
+exports.safeParseNaturalLanguageDuration = safeParseNaturalLanguageDuration;
+exports.parseNaturalLanguageDurationAgo = parseNaturalLanguageDurationAgo;
+exports.safeParseNaturalLanguageDurationAgo = safeParseNaturalLanguageDurationAgo;
+exports.stringifyDuration = stringifyDuration;
+/**
+ * Parses a natural language duration string into milliseconds.
+ *
+ * @param duration - Duration string like "1s", "5m", "2h", "1d", "1w"
+ * @returns The duration in milliseconds, or undefined if invalid
+ *
+ * @example
+ * parseNaturalLanguageDurationInMs("30m") // 1800000
+ * parseNaturalLanguageDurationInMs("2h") // 7200000
+ */
+function parseNaturalLanguageDurationInMs(duration) {
+    // Handle Code scanning alert #44 by limiting the length of the input string
+    if (duration.length > 100) {
+        return undefined;
+    }
+    // More flexible regex that captures all units individually regardless of order
+    const weekMatch = duration.match(/(\d+)w/);
+    const dayMatch = duration.match(/(\d+)d/);
+    const hourMatch = duration.match(/(\d+)(?:hr|h)/);
+    const minuteMatch = duration.match(/(\d+)m/);
+    const secondMatch = duration.match(/(\d+)s/);
+    // Check if the entire string consists only of valid duration units
+    const validPattern = /^(\d+(?:w|d|hr|h|m|s))+$/;
+    if (!validPattern.test(duration)) {
+        return undefined;
+    }
+    let totalMilliseconds = 0;
+    let hasMatch = false;
+    if (weekMatch) {
+        const weeks = Number(weekMatch[1]);
+        if (weeks >= 0) {
+            totalMilliseconds += weeks * 7 * 24 * 60 * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (dayMatch) {
+        const days = Number(dayMatch[1]);
+        if (days >= 0) {
+            totalMilliseconds += days * 24 * 60 * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (hourMatch) {
+        const hours = Number(hourMatch[1]);
+        if (hours >= 0) {
+            totalMilliseconds += hours * 60 * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (minuteMatch) {
+        const minutes = Number(minuteMatch[1]);
+        if (minutes >= 0) {
+            totalMilliseconds += minutes * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (secondMatch) {
+        const seconds = Number(secondMatch[1]);
+        if (seconds >= 0) {
+            totalMilliseconds += seconds * 1000;
+            hasMatch = true;
+        }
+    }
+    return hasMatch ? totalMilliseconds : undefined;
+}
+function parseNaturalLanguageDuration(duration) {
+    const ms = parseNaturalLanguageDurationInMs(duration);
+    return ms !== undefined ? new Date(Date.now() + ms) : undefined;
+}
+function safeParseNaturalLanguageDuration(duration) {
+    try {
+        return parseNaturalLanguageDuration(duration);
+    }
+    catch (_error) {
+        return undefined;
+    }
+}
+// ... existing code ...
+function parseNaturalLanguageDurationAgo(duration) {
+    // Handle Code scanning alert #44 (https://github.com/triggerdotdev/trigger.dev/security/code-scanning/44) by limiting the length of the input string
+    if (duration.length > 100) {
+        return undefined;
+    }
+    // More flexible regex that captures all units individually regardless of order
+    const weekMatch = duration.match(/(\d+)w/);
+    const dayMatch = duration.match(/(\d+)d/);
+    const hourMatch = duration.match(/(\d+)(?:hr|h)/);
+    const minuteMatch = duration.match(/(\d+)m/);
+    const secondMatch = duration.match(/(\d+)s/);
+    // Check if the entire string consists only of valid duration units
+    const validPattern = /^(\d+(?:w|d|hr|h|m|s))+$/;
+    if (!validPattern.test(duration)) {
+        return undefined;
+    }
+    let totalMilliseconds = 0;
+    let hasMatch = false;
+    if (weekMatch) {
+        const weeks = Number(weekMatch[1]);
+        if (weeks >= 0) {
+            totalMilliseconds += weeks * 7 * 24 * 60 * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (dayMatch) {
+        const days = Number(dayMatch[1]);
+        if (days >= 0) {
+            totalMilliseconds += days * 24 * 60 * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (hourMatch) {
+        const hours = Number(hourMatch[1]);
+        if (hours >= 0) {
+            totalMilliseconds += hours * 60 * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (minuteMatch) {
+        const minutes = Number(minuteMatch[1]);
+        if (minutes >= 0) {
+            totalMilliseconds += minutes * 60 * 1000;
+            hasMatch = true;
+        }
+    }
+    if (secondMatch) {
+        const seconds = Number(secondMatch[1]);
+        if (seconds >= 0) {
+            totalMilliseconds += seconds * 1000;
+            hasMatch = true;
+        }
+    }
+    if (hasMatch) {
+        return new Date(Date.now() - totalMilliseconds);
+    }
+    return undefined;
+}
+function safeParseNaturalLanguageDurationAgo(duration) {
+    try {
+        return parseNaturalLanguageDurationAgo(duration);
+    }
+    catch (_error) {
+        return undefined;
+    }
+}
+function stringifyDuration(seconds) {
+    if (seconds <= 0) {
+        return;
+    }
+    const units = {
+        w: Math.floor(seconds / 604800),
+        d: Math.floor((seconds % 604800) / 86400),
+        h: Math.floor((seconds % 86400) / 3600),
+        m: Math.floor((seconds % 3600) / 60),
+        s: Math.floor(seconds % 60),
+    };
+    // Filter the units having non-zero values and join them
+    const result = Object.entries(units)
+        .filter(([unit, val]) => val != 0)
+        .map(([unit, val]) => `${val}${unit}`)
+        .join("");
+    return result;
+}
+//# sourceMappingURL=duration.js.map

package/dist/commonjs/v3/isomorphic/duration.js.map

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

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

@@ -0,0 +1,167 @@
+export declare function generateFriendlyId(prefix: string, size?: number): string;
+export declare const RUN_OPS_ID_LENGTH = 26;
+export declare const RUN_OPS_ID_REGION_INDEX = 24;
+export declare const RUN_OPS_ID_VERSION_INDEX = 25;
+export declare const RUN_OPS_ID_VERSION = "1";
+export declare const RUN_OPS_ID_VERSION_2 = "2";
+export declare const RUN_OPS_ID_SHARD_INDEX = 24;
+/** Region char stamped when the region is unknown or unmapped at mint. */
+export declare const DEFAULT_REGION_CHAR = "0";
+/** True iff `value` is a single valid gen-2 shard char. The descriptor validator and
+ * `resolveShard` share this so a configured key and a decoded key cannot drift. */
+export declare function isValidShardChar(value: string): boolean;
+/** One lowercase [a-z0-9] char per supported region, at RUN_OPS_ID_REGION_INDEX. */
+export declare const REGION_CODES: Readonly<Record<string, string>>;
+export declare function regionCharForRegion(region: string | undefined): string;
+/** Lowercase base32hex (RFC 4648 §7): 5 bits per char, order-preserving, no padding. */
+export declare function base32hexEncode(bytes: Uint8Array): string;
+/** Inverse of base32hexEncode. Throws on characters outside the lowercase alphabet. */
+export declare function base32hexDecode(s: string): Uint8Array;
+/**
+ * Mint a run-ops v1 id body (26 chars, no prefix): 24-char base32hex core
+ * (6-byte ms timestamp + 9 CSPRNG bytes) + region char + version char "1".
+ * The trailing version char at RUN_OPS_ID_VERSION_INDEX is the residency
+ * discriminator — see runOpsResidency.ts.
+ */
+export declare function generateRunOpsId(region?: string): string;
+/**
+ * Mint a gen-2 id body (26 chars, no prefix): the same core, then the shard key,
+ * then version char "2". Throws on a shard char outside [a-z0-9] — an id that
+ * cannot be routed must never be minted.
+ */
+export declare function generateRunOpsIdV2(shardChar: string): string;
+export type ParsedRunId = {
+    format: "b32hex";
+    table: "partitioned";
+    timestamp: Date;
+    region: string;
+    version: string;
+} | {
+    format: "b32hexV2";
+    table: "partitioned";
+    timestamp: Date;
+    shard: string;
+    version: string;
+} | {
+    format: "legacy";
+    table: "legacy";
+};
+/**
+ * Parse a v1 id body (no prefix). Returns undefined unless the body is exactly
+ * 26 chars with version "1" at index 25 and every char inside the base32hex
+ * alphabet — anything else (cuid, nanoid, pre-cutover 27-char base62, malformed
+ * v1) is a legacy shape.
+ */
+export declare function parseRunOpsIdBody(body: string): {
+    timestamp: Date;
+    region: string;
+    version: string;
+} | undefined;
+/**
+ * Parse a gen-2 id body (no prefix): the mirror of {@link parseRunOpsIdBody},
+ * requiring version "2" at index 25 and a shard key in [a-z0-9] at index 24.
+ * Total: returns undefined for any other string, and never throws.
+ */
+export declare function parseRunOpsIdV2Body(body: string): {
+    timestamp: Date;
+    shard: string;
+    version: string;
+} | undefined;
+/** True if the (prefixless) id body is a well-formed run-ops v1 id. */
+export declare function isRunOpsIdBody(body: string): boolean;
+export declare function isRunOpsIdBodyShape(body: string): boolean;
+export declare function runOpsIdV2ShardShape(body: string): string | undefined;
+/** Parse a `run_`-prefixed friendly id; anything not a well-formed v1/gen-2 id is legacy. */
+export declare function parseRunId(id: string): ParsedRunId;
+export declare const WAITPOINT_ID_VERSION = "w";
+export declare const WAITPOINT_ID_TYPE_INDEX = 24;
+export type WaitpointIdType = "RUN" | "BATCH" | "DATETIME" | "MANUAL";
+export type ParsedWaitpointId = {
+    format: "b32hexW";
+    type: WaitpointIdType;
+    timestamp: Date;
+} | {
+    format: "legacy";
+};
+/**
+ * Mint a standalone waitpoint id body (26 chars, no prefix) for DATETIME and MANUAL: a
+ * fresh core, the type char, then the waitpoint version char.
+ */
+export declare function generateWaitpointId(type: WaitpointIdType): string;
+/**
+ * Derive the 1:1 waitpoint id body for a RUN or BATCH anchor by reusing the anchor's
+ * 24-char core. Pure, so create-if-absent is idempotent without a lock. Returns
+ * undefined when the anchor is not a run-ops id, which is the caller's signal to mint a
+ * legacy waitpoint instead.
+ *
+ * Only the core survives: the anchor's region or shard char and its version char are
+ * both replaced. So the anchor id is NOT recoverable from the waitpoint id — the reverse
+ * direction uses the completedBy* back-pointer.
+ */
+export declare function deriveWaitpointIdFromAnchor(anchorId: string, type: WaitpointIdType): string | undefined;
+/**
+ * Classify a waitpoint id. Accepts the prefixed (`waitpoint_<body>`) and bare forms, but
+ * NOT another entity's prefix (`run_`, `batch_`, ...) — this is the discriminator a
+ * later ticket uses to route a possibly customer-supplied id, so a foreign prefix must
+ * classify legacy rather than have its body reinterpreted as a waitpoint id. Total:
+ * never throws.
+ */
+export declare function parseWaitpointId(id: string): ParsedWaitpointId;
+export declare function generateInternalId(): string;
+/** Convert an internal ID to a friendly ID */
+export declare function toFriendlyId(entityName: string, internalId: string): string;
+/** Convert a friendly ID to an internal ID */
+export declare function fromFriendlyId(friendlyId: string, expectedEntityName?: string): string;
+export declare class IdUtil {
+    private entityName;
+    constructor(entityName: string);
+    generate(): {
+        id: string;
+        friendlyId: string;
+    };
+    toFriendlyId(internalId: string): string;
+    fromFriendlyId(friendlyId: string): string;
+    /** Will convert friendlyIds, and will leave ids as they are */
+    toId(value: string): string;
+}
+export declare const BackgroundWorkerId: IdUtil;
+export declare const CheckpointId: IdUtil;
+export declare const QueueId: IdUtil;
+export declare const RunId: IdUtil;
+export declare const SnapshotId: IdUtil;
+export declare const WaitpointId: IdUtil;
+export declare const BatchId: IdUtil;
+export declare const BulkActionId: IdUtil;
+export declare const AttemptId: IdUtil;
+export declare const ErrorId: IdUtil;
+export declare const SessionId: IdUtil;
+export declare const WebhookEndpointId: IdUtil;
+export declare const WebhookDeliveryId: {
+    /**
+     * Mint a delivery id. The row's `createdAt` MUST be set to the returned `timestamp` so the id's
+     * embedded timestamp equals the partition key that {@link WebhookDeliveryId.parseTimestamp} recovers.
+     */
+    generate(): {
+        id: string;
+        friendlyId: string;
+        timestamp: Date;
+    };
+    toFriendlyId(id: string): string;
+    toId(idOrFriendlyId: string): string;
+    /**
+     * Decode the mint timestamp (== the row's `createdAt` partition key) from an id or friendlyId.
+     * Returns `undefined` if the value is not a well-formed time-encoded id.
+     */
+    parseTimestamp(idOrFriendlyId: string): Date | undefined;
+};
+export declare class IdGenerator {
+    private alphabet;
+    private length;
+    private prefix;
+    constructor({ alphabet, length, prefix }: {
+        alphabet: string;
+        length: number;
+        prefix: string;
+    });
+    generate(): string;
+}