@trigger.dev/core 3.0.0-beta.7 → 3.0.0

package/dist/esm/v3/usage/devUsageManager.js

@@ -0,0 +1,86 @@
+import { clock } from "../clock-api.js";
+import { calculateDurationInMs } from "../clock/clock.js";
+class DevUsageMeasurement {
+    id;
+    startedAt;
+    _pauses = new Map();
+    _endedAt;
+    constructor(id, startedAt = clock.preciseNow()) {
+        this.id = id;
+        this.startedAt = startedAt;
+    }
+    stop() {
+        this._endedAt = clock.preciseNow();
+    }
+    sample() {
+        const endedAt = this._endedAt ?? clock.preciseNow();
+        const wallTime = this.startedAt ? calculateDurationInMs(this.startedAt, endedAt) : 0;
+        if (wallTime === 0) {
+            return { cpuTime: 0, wallTime: 0 };
+        }
+        const totalPauses = Array.from(this._pauses.values()).reduce((total, pause) => {
+            return total + calculateDurationInMs(pause.start, pause.end ?? endedAt);
+        }, 0);
+        const cpuTime = wallTime - totalPauses;
+        return {
+            wallTime,
+            cpuTime,
+        };
+    }
+    registerPause(pauseId, start, end) {
+        this._pauses.set(pauseId, { start, end });
+    }
+}
+export class DevUsageManager {
+    _firstMeasurement;
+    _currentMeasurements = new Map();
+    _pauses = new Map();
+    disable() { }
+    sample() {
+        return this._firstMeasurement?.sample();
+    }
+    start() {
+        // generate a random ID
+        const id = generateRandomString();
+        const measurement = new DevUsageMeasurement(id);
+        if (!this._firstMeasurement) {
+            this._firstMeasurement = measurement;
+        }
+        this._currentMeasurements.set(id, measurement);
+        return measurement;
+    }
+    stop(measurement) {
+        measurement.stop();
+        const sample = measurement.sample();
+        this._currentMeasurements.delete(measurement.id);
+        return sample;
+    }
+    async pauseAsync(cb) {
+        const pauseId = generateRandomString();
+        const pauseStart = clock.preciseNow();
+        try {
+            this._pauses.set(pauseId, { start: pauseStart });
+            for (const measurement of this._currentMeasurements.values()) {
+                measurement.registerPause(pauseId, pauseStart);
+            }
+            return await cb();
+        }
+        finally {
+            const pauseEnd = clock.preciseNow();
+            this._pauses.set(pauseId, { start: pauseStart, end: pauseEnd });
+            for (const measurement of this._currentMeasurements.values()) {
+                measurement.registerPause(pauseId, pauseStart, pauseEnd);
+            }
+        }
+    }
+}
+function generateRandomString() {
+    let result = "";
+    const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    const charactersLength = characters.length;
+    for (var i = 0; i < 16; i++) {
+        result += characters.charAt(Math.floor(Math.random() * charactersLength));
+    }
+    return result;
+}
+//# sourceMappingURL=devUsageManager.js.map

package/dist/esm/v3/usage/devUsageManager.js.map

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

package/dist/esm/v3/usage/noopUsageManager.d.ts

@@ -0,0 +1,8 @@
+import { UsageManager, UsageMeasurement, UsageSample } from "./types.js";
+export declare class NoopUsageManager implements UsageManager {
+    disable(): void;
+    start(): UsageMeasurement;
+    stop(measurement: UsageMeasurement): UsageSample;
+    pauseAsync<T>(cb: () => Promise<T>): Promise<T>;
+    sample(): UsageSample | undefined;
+}

package/dist/esm/v3/usage/noopUsageManager.js

@@ -0,0 +1,20 @@
+export class NoopUsageManager {
+    disable() {
+        // Noop
+    }
+    start() {
+        return {
+            sample: () => ({ cpuTime: 0, wallTime: 0 }),
+        };
+    }
+    stop(measurement) {
+        return measurement.sample();
+    }
+    pauseAsync(cb) {
+        return cb();
+    }
+    sample() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=noopUsageManager.js.map

package/dist/esm/v3/usage/noopUsageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noopUsageManager.js","sourceRoot":"","sources":["../../../../src/v3/usage/noopUsageManager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC3B,OAAO;QACL,OAAO;IACT,CAAC;IAED,KAAK;QACH,OAAO;YACL,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAA6B;QAChC,OAAO,WAAW,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,UAAU,CAAI,EAAoB;QAChC,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/esm/v3/usage/prodUsageManager.d.ts

@@ -0,0 +1,23 @@
+import { UsageManager, UsageMeasurement, UsageSample } from "./types.js";
+export type ProdUsageManagerOptions = {
+    heartbeatIntervalMs?: number;
+    url?: string;
+    jwt?: string;
+};
+export declare class ProdUsageManager implements UsageManager {
+    #private;
+    private readonly delegageUsageManager;
+    private readonly options;
+    private _measurement;
+    private _abortController;
+    private _lastSample;
+    private _usageClient;
+    constructor(delegageUsageManager: UsageManager, options: ProdUsageManagerOptions);
+    get isReportingEnabled(): boolean;
+    disable(): void;
+    sample(): UsageSample | undefined;
+    start(): UsageMeasurement;
+    stop(measurement: UsageMeasurement): UsageSample;
+    pauseAsync<T>(cb: () => Promise<T>): Promise<T>;
+    flush(): Promise<void>;
+}

package/dist/esm/v3/usage/prodUsageManager.js

@@ -0,0 +1,81 @@
+import { setInterval } from "node:timers/promises";
+import { UsageClient } from "./usageClient.js";
+export class ProdUsageManager {
+    delegageUsageManager;
+    options;
+    _measurement;
+    _abortController;
+    _lastSample;
+    _usageClient;
+    constructor(delegageUsageManager, options) {
+        this.delegageUsageManager = delegageUsageManager;
+        this.options = options;
+        if (this.options.url && this.options.jwt) {
+            this._usageClient = new UsageClient(this.options.url, this.options.jwt);
+        }
+    }
+    get isReportingEnabled() {
+        return typeof this._usageClient !== "undefined";
+    }
+    disable() {
+        this.delegageUsageManager.disable();
+        this._abortController?.abort();
+    }
+    sample() {
+        return this._measurement?.sample();
+    }
+    start() {
+        if (!this.isReportingEnabled || !this.options.heartbeatIntervalMs) {
+            return this.delegageUsageManager.start();
+        }
+        if (!this._measurement) {
+            this._measurement = this.delegageUsageManager.start();
+            this.#startReportingHeartbeat().catch(console.error);
+            return this._measurement;
+        }
+        return this.delegageUsageManager.start();
+    }
+    stop(measurement) {
+        return this.delegageUsageManager.stop(measurement);
+    }
+    async pauseAsync(cb) {
+        return this.delegageUsageManager.pauseAsync(cb);
+    }
+    async #startReportingHeartbeat() {
+        if (!this._measurement || !this.isReportingEnabled || !this.options.heartbeatIntervalMs) {
+            return;
+        }
+        this._abortController = new AbortController();
+        for await (const _ of setInterval(this.options.heartbeatIntervalMs)) {
+            if (this._abortController.signal.aborted) {
+                break;
+            }
+            await this.#reportUsage();
+        }
+    }
+    async flush() {
+        return await this.#reportUsage();
+    }
+    async #reportUsage() {
+        if (!this._measurement) {
+            return;
+        }
+        if (!this.isReportingEnabled) {
+            return;
+        }
+        const client = this._usageClient;
+        if (!client) {
+            return;
+        }
+        const sample = this._measurement.sample();
+        const cpuTimeSinceLastSample = this._lastSample
+            ? sample.cpuTime - this._lastSample.cpuTime
+            : sample.cpuTime;
+        this._lastSample = sample;
+        if (cpuTimeSinceLastSample <= 0) {
+            return;
+        }
+        await client.sendUsageEvent({ durationMs: cpuTimeSinceLastSample });
+    }
+}
+//# sourceMappingURL=prodUsageManager.js.map

package/dist/esm/v3/usage/prodUsageManager.js.map

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

package/dist/esm/v3/usage/types.d.ts

@@ -0,0 +1,14 @@
+export type UsageSample = {
+    cpuTime: number;
+    wallTime: number;
+};
+export interface UsageMeasurement {
+    sample(): UsageSample;
+}
+export interface UsageManager {
+    disable(): void;
+    start(): UsageMeasurement;
+    stop(measurement: UsageMeasurement): UsageSample;
+    sample(): UsageSample | undefined;
+    pauseAsync<T>(cb: () => Promise<T>): Promise<T>;
+}

package/dist/esm/v3/usage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/v3/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/v3/usage/types.ts"],"names":[],"mappings":""}

package/dist/esm/v3/usage/usageClient.d.ts

@@ -0,0 +1,13 @@
+export type UsageClientOptions = {
+    token: string;
+    baseUrl: string;
+};
+export type UsageEvent = {
+    durationMs: number;
+};
+export declare class UsageClient {
+    private readonly url;
+    private jwt;
+    constructor(url: string, jwt: string);
+    sendUsageEvent(event: UsageEvent): Promise<void>;
+}

package/dist/esm/v3/usage/usageClient.js

@@ -0,0 +1,33 @@
+import { apiClientManager } from "../apiClientManager-api.js";
+export class UsageClient {
+    url;
+    jwt;
+    constructor(url, jwt) {
+        this.url = url;
+        this.jwt = jwt;
+    }
+    async sendUsageEvent(event) {
+        try {
+            const response = await fetch(this.url, {
+                method: "POST",
+                body: JSON.stringify(event),
+                headers: {
+                    "content-type": "application/json",
+                    "x-trigger-jwt": this.jwt,
+                    accept: "application/json",
+                    authorization: `Bearer ${apiClientManager.accessToken}`, // this is used to renew the JWT
+                },
+            });
+            if (response.ok) {
+                const renewedJwt = response.headers.get("x-trigger-jwt");
+                if (renewedJwt) {
+                    this.jwt = renewedJwt;
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Failed to send usage event: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=usageClient.js.map

package/dist/esm/v3/usage/usageClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageClient.js","sourceRoot":"","sources":["../../../../src/v3/usage/usageClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAW9D,MAAM,OAAO,WAAW;IAEH;IACT;IAFV,YACmB,GAAW,EACpB,GAAW;QADF,QAAG,GAAH,GAAG,CAAQ;QACpB,QAAG,GAAH,GAAG,CAAQ;IAClB,CAAC;IAEJ,KAAK,CAAC,cAAc,CAAC,KAAiB;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAC3B,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,IAAI,CAAC,GAAG;oBACzB,MAAM,EAAE,kBAAkB;oBAC1B,aAAa,EAAE,UAAU,gBAAgB,CAAC,WAAW,EAAE,EAAE,gCAAgC;iBAC1F;aACF,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAEzD,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF"}

package/dist/esm/v3/usage-api.d.ts

@@ -0,0 +1,3 @@
+import { UsageAPI } from "./usage/api.js";
+/** Entrypoint for usage API */
+export declare const usage: UsageAPI;

package/dist/esm/v3/usage-api.js

@@ -0,0 +1,6 @@
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+import { UsageAPI } from "./usage/api.js";
+/** Entrypoint for usage API */
+export const usage = UsageAPI.getInstance();
+//# sourceMappingURL=usage-api.js.map

package/dist/esm/v3/usage-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-api.js","sourceRoot":"","sources":["../../../src/v3/usage-api.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qCAAqC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,+BAA+B;AAC/B,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC"}

package/dist/esm/v3/utils/durations.d.ts

@@ -0,0 +1,13 @@
+import { Unit } from "humanize-duration";
+type DurationOptions = {
+    style?: "long" | "short";
+    maxDecimalPoints?: number;
+    units?: Unit[];
+};
+export declare function formatDuration(start?: Date | null, end?: Date | null, options?: DurationOptions): string;
+export declare function nanosecondsToMilliseconds(nanoseconds: number): number;
+export declare function millisecondsToNanoseconds(milliseconds: number): number;
+export declare function formatDurationNanoseconds(nanoseconds: number, options?: DurationOptions): string;
+export declare function formatDurationMilliseconds(milliseconds: number, options?: DurationOptions): string;
+export declare function formatDurationInDays(milliseconds: number): string;
+export {};

package/dist/esm/v3/utils/durations.js

@@ -0,0 +1,64 @@
+import humanizeDuration from "humanize-duration";
+function dateDifference(date1, date2) {
+    return Math.abs(date1.getTime() - date2.getTime());
+}
+export function formatDuration(start, end, options) {
+    if (!start || !end) {
+        return "–";
+    }
+    return formatDurationMilliseconds(dateDifference(start, end), options);
+}
+export function nanosecondsToMilliseconds(nanoseconds) {
+    return nanoseconds / 1_000_000;
+}
+export function millisecondsToNanoseconds(milliseconds) {
+    return milliseconds * 1_000_000;
+}
+export function formatDurationNanoseconds(nanoseconds, options) {
+    return formatDurationMilliseconds(nanosecondsToMilliseconds(nanoseconds), options);
+}
+const aboveOneSecondUnits = ["d", "h", "m", "s"];
+const belowOneSecondUnits = ["ms"];
+export function formatDurationMilliseconds(milliseconds, options) {
+    let duration = humanizeDuration(milliseconds, {
+        units: options?.units
+            ? options.units
+            : milliseconds < 1000
+                ? belowOneSecondUnits
+                : aboveOneSecondUnits,
+        maxDecimalPoints: options?.maxDecimalPoints ?? 1,
+        largest: 2,
+    });
+    if (!options) {
+        return duration;
+    }
+    switch (options.style) {
+        case "short":
+            duration = duration.replace(" milliseconds", "ms");
+            duration = duration.replace(" millisecond", "ms");
+            duration = duration.replace(" seconds", "s");
+            duration = duration.replace(" second", "s");
+            duration = duration.replace(" minutes", "m");
+            duration = duration.replace(" minute", "m");
+            duration = duration.replace(" hours", "h");
+            duration = duration.replace(" hour", "h");
+            duration = duration.replace(" days", "d");
+            duration = duration.replace(" day", "d");
+            duration = duration.replace(" weeks", "w");
+            duration = duration.replace(" week", "w");
+            duration = duration.replace(" months", "mo");
+            duration = duration.replace(" month", "mo");
+            duration = duration.replace(" years", "y");
+            duration = duration.replace(" year", "y");
+    }
+    return duration;
+}
+export function formatDurationInDays(milliseconds) {
+    let duration = humanizeDuration(milliseconds, {
+        maxDecimalPoints: 0,
+        largest: 2,
+        units: ["d"],
+    });
+    return duration;
+}
+//# sourceMappingURL=durations.js.map

package/dist/esm/v3/utils/durations.js.map

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

package/dist/esm/v3/utils/flattenAttributes.d.ts

@@ -0,0 +1,5 @@
+import { Attributes } from "@opentelemetry/api";
+export declare const NULL_SENTINEL = "$@null((";
+export declare function flattenAttributes(obj: Record<string, unknown> | Array<unknown> | string | boolean | number | null | undefined, prefix?: string): Attributes;
+export declare function unflattenAttributes(obj: Attributes): Record<string, unknown> | string | number | boolean | null | undefined;
+export declare function primitiveValueOrflattenedAttributes(obj: Record<string, unknown> | Array<unknown> | string | boolean | number | undefined, prefix: string | undefined): Attributes | string | number | boolean | undefined;

package/dist/esm/v3/utils/flattenAttributes.js

@@ -0,0 +1,144 @@
+export const NULL_SENTINEL = "$@null((";
+export function flattenAttributes(obj, prefix) {
+    const result = {};
+    // Check if obj is null or undefined
+    if (obj === undefined) {
+        return result;
+    }
+    if (obj === null) {
+        result[prefix || ""] = NULL_SENTINEL;
+        return result;
+    }
+    if (typeof obj === "string") {
+        result[prefix || ""] = obj;
+        return result;
+    }
+    if (typeof obj === "number") {
+        result[prefix || ""] = obj;
+        return result;
+    }
+    if (typeof obj === "boolean") {
+        result[prefix || ""] = obj;
+        return result;
+    }
+    if (obj instanceof Date) {
+        result[prefix || ""] = obj.toISOString();
+        return result;
+    }
+    for (const [key, value] of Object.entries(obj)) {
+        const newPrefix = `${prefix ? `${prefix}.` : ""}${Array.isArray(obj) ? `[${key}]` : key}`;
+        if (Array.isArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                if (typeof value[i] === "object" && value[i] !== null) {
+                    // update null check here as well
+                    Object.assign(result, flattenAttributes(value[i], `${newPrefix}.[${i}]`));
+                }
+                else {
+                    if (value[i] === null) {
+                        result[`${newPrefix}.[${i}]`] = NULL_SENTINEL;
+                    }
+                    else {
+                        result[`${newPrefix}.[${i}]`] = value[i];
+                    }
+                }
+            }
+        }
+        else if (isRecord(value)) {
+            // update null check here
+            Object.assign(result, flattenAttributes(value, newPrefix));
+        }
+        else {
+            if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") {
+                result[newPrefix] = value;
+            }
+            else if (value === null) {
+                result[newPrefix] = NULL_SENTINEL;
+            }
+        }
+    }
+    return result;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function unflattenAttributes(obj) {
+    if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
+        return obj;
+    }
+    if (typeof obj === "object" &&
+        obj !== null &&
+        Object.keys(obj).length === 1 &&
+        Object.keys(obj)[0] === "") {
+        return rehydrateNull(obj[""]);
+    }
+    if (Object.keys(obj).length === 0) {
+        return;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const parts = key.split(".").reduce((acc, part) => {
+            if (part.includes("[")) {
+                // Handling nested array indices
+                const subparts = part.split(/\[|\]/).filter((p) => p !== "");
+                acc.push(...subparts);
+            }
+            else {
+                acc.push(part);
+            }
+            return acc;
+        }, []);
+        let current = result;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (!part) {
+                continue;
+            }
+            const nextPart = parts[i + 1];
+            const isArray = nextPart && /^\d+$/.test(nextPart);
+            if (isArray && !Array.isArray(current[part])) {
+                current[part] = [];
+            }
+            else if (!isArray && current[part] === undefined) {
+                current[part] = {};
+            }
+            current = current[part];
+        }
+        const lastPart = parts[parts.length - 1];
+        if (lastPart) {
+            current[lastPart] = rehydrateNull(value);
+        }
+    }
+    // Convert the result to an array if all top-level keys are numeric indices
+    if (Object.keys(result).every((k) => /^\d+$/.test(k))) {
+        const maxIndex = Math.max(...Object.keys(result).map((k) => parseInt(k)));
+        const arrayResult = Array(maxIndex + 1);
+        for (const key in result) {
+            arrayResult[parseInt(key)] = result[key];
+        }
+        return arrayResult;
+    }
+    return result;
+}
+export function primitiveValueOrflattenedAttributes(obj, prefix) {
+    if (typeof obj === "string" ||
+        typeof obj === "number" ||
+        typeof obj === "boolean" ||
+        obj === null ||
+        obj === undefined) {
+        return obj;
+    }
+    const attributes = flattenAttributes(obj, prefix);
+    if (prefix !== undefined &&
+        typeof attributes[prefix] !== "undefined" &&
+        attributes[prefix] !== null) {
+        return attributes[prefix];
+    }
+    return attributes;
+}
+function rehydrateNull(value) {
+    if (value === NULL_SENTINEL) {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=flattenAttributes.js.map

package/dist/esm/v3/utils/flattenAttributes.js.map

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

package/dist/esm/v3/utils/getEnv.d.ts

@@ -0,0 +1 @@
+export declare function getEnvVar(name: string): string | undefined;

package/dist/esm/v3/utils/getEnv.js

@@ -0,0 +1,8 @@
+export function getEnvVar(name) {
+    // This could run in a non-Node.js environment (Bun, Deno, CF Worker, etc.), so don't just assume process.env is a thing
+    if (typeof process !== "undefined" && typeof process.env === "object" && process.env !== null) {
+        return process.env[name];
+    }
+    return;
+}
+//# sourceMappingURL=getEnv.js.map

package/dist/esm/v3/utils/getEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEnv.js","sourceRoot":"","sources":["../../../../src/v3/utils/getEnv.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,wHAAwH;IACxH,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QAC9F,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;AACT,CAAC"}

package/dist/esm/v3/utils/globals.d.ts

@@ -0,0 +1,19 @@
+import { ApiClientConfiguration } from "../apiClientManager/types.js";
+import { Clock } from "../clock/clock.js";
+import type { RuntimeManager } from "../runtime/manager.js";
+import { TaskCatalog } from "../task-catalog/catalog.js";
+import { TaskContext } from "../taskContext/types.js";
+import { UsageManager } from "../usage/types.js";
+export declare function registerGlobal<Type extends keyof TriggerDotDevGlobalAPI>(type: Type, instance: TriggerDotDevGlobalAPI[Type], allowOverride?: boolean): boolean;
+export declare function getGlobal<Type extends keyof TriggerDotDevGlobalAPI>(type: Type): TriggerDotDevGlobalAPI[Type] | undefined;
+export declare function unregisterGlobal(type: keyof TriggerDotDevGlobalAPI): void;
+type TriggerDotDevGlobalAPI = {
+    runtime?: RuntimeManager;
+    logger?: any;
+    clock?: Clock;
+    usage?: UsageManager;
+    ["task-catalog"]?: TaskCatalog;
+    ["task-context"]?: TaskContext;
+    ["api-client"]?: ApiClientConfiguration;
+};
+export {};

package/dist/esm/v3/utils/globals.js

@@ -0,0 +1,23 @@
+import { _globalThis } from "./platform.js";
+const GLOBAL_TRIGGER_DOT_DEV_KEY = Symbol.for(`dev.trigger.ts.api`);
+const _global = _globalThis;
+export function registerGlobal(type, instance, allowOverride = false) {
+    const api = (_global[GLOBAL_TRIGGER_DOT_DEV_KEY] = _global[GLOBAL_TRIGGER_DOT_DEV_KEY] ?? {});
+    if (!allowOverride && api[type]) {
+        // already registered an API of this type
+        const err = new Error(`trigger.dev: Attempted duplicate registration of API: ${type}`);
+        return false;
+    }
+    api[type] = instance;
+    return true;
+}
+export function getGlobal(type) {
+    return _global[GLOBAL_TRIGGER_DOT_DEV_KEY]?.[type];
+}
+export function unregisterGlobal(type) {
+    const api = _global[GLOBAL_TRIGGER_DOT_DEV_KEY];
+    if (api) {
+        delete api[type];
+    }
+}
+//# sourceMappingURL=globals.js.map

package/dist/esm/v3/utils/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../../../src/v3/utils/globals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEpE,MAAM,OAAO,GAAG,WAAkC,CAAC;AAEnD,MAAM,UAAU,cAAc,CAC5B,IAAU,EACV,QAAsC,EACtC,aAAa,GAAG,KAAK;IAErB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,0BAA0B,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9F,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,yCAAyC;QACzC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAU;IAEV,OAAO,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAkC;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEhD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC"}