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

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

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

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

@@ -0,0 +1,20 @@
+export 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/esm/v3/isomorphic/deploymentVersions.js.map

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

@@ -0,0 +1,163 @@
+/**
+ * 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 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;
+}
+export function parseNaturalLanguageDuration(duration) {
+    const ms = parseNaturalLanguageDurationInMs(duration);
+    return ms !== undefined ? new Date(Date.now() + ms) : undefined;
+}
+export function safeParseNaturalLanguageDuration(duration) {
+    try {
+        return parseNaturalLanguageDuration(duration);
+    }
+    catch (_error) {
+        return undefined;
+    }
+}
+// ... existing code ...
+export 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;
+}
+export function safeParseNaturalLanguageDurationAgo(duration) {
+    try {
+        return parseNaturalLanguageDurationAgo(duration);
+    }
+    catch (_error) {
+        return undefined;
+    }
+}
+export 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/esm/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/esm/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;
+}