@trigger.dev/core 0.0.0-prerelease-20250213143202 → 0.0.0-python-preview-20250226140121

package/dist/esm/v3/runTimelineMetrics/index.d.ts

@@ -0,0 +1,23 @@
+import { Attributes } from "@opentelemetry/api";
+import { TriggerTracerSpanEvent } from "../tracer.js";
+import { RunTimelineMetric, RunTimelineMetricsManager } from "./types.js";
+export declare class RunTimelineMetricsAPI implements RunTimelineMetricsManager {
+    #private;
+    private static _instance?;
+    private constructor();
+    static getInstance(): RunTimelineMetricsAPI;
+    registerMetric(metric: RunTimelineMetric): void;
+    getMetrics(): RunTimelineMetric[];
+    /**
+     * Measures the execution time of an async function and registers it as a metric
+     * @param metricName The name of the metric
+     * @param eventName The event name
+     * @param attributesOrCallback Optional attributes or the callback function
+     * @param callbackFn The async function to measure (if attributes were provided)
+     * @returns The result of the callback function
+     */
+    measureMetric<T>(metricName: string, eventName: string, attributesOrCallback: Attributes | (() => Promise<T>), callbackFn?: () => Promise<T>): Promise<T>;
+    convertMetricsToSpanEvents(): TriggerTracerSpanEvent[];
+    convertMetricsToSpanAttributes(): Attributes;
+    setGlobalManager(manager: RunTimelineMetricsManager): boolean;
+}

package/dist/esm/v3/runTimelineMetrics/index.js

@@ -0,0 +1,156 @@
+import { getGlobal, registerGlobal } from "../utils/globals.js";
+import { NoopRunTimelineMetricsManager } from "./runTimelineMetricsManager.js";
+import { flattenAttributes } from "../utils/flattenAttributes.js";
+import { SemanticInternalAttributes } from "../semanticInternalAttributes.js";
+const API_NAME = "run-timeline-metrics";
+const NOOP_MANAGER = new NoopRunTimelineMetricsManager();
+export class RunTimelineMetricsAPI {
+    static _instance;
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new RunTimelineMetricsAPI();
+        }
+        return this._instance;
+    }
+    registerMetric(metric) {
+        this.#getManager().registerMetric(metric);
+    }
+    getMetrics() {
+        return this.#getManager().getMetrics();
+    }
+    /**
+     * Measures the execution time of an async function and registers it as a metric
+     * @param metricName The name of the metric
+     * @param eventName The event name
+     * @param attributesOrCallback Optional attributes or the callback function
+     * @param callbackFn The async function to measure (if attributes were provided)
+     * @returns The result of the callback function
+     */
+    async measureMetric(metricName, eventName, attributesOrCallback, callbackFn) {
+        // Handle overloaded function signature
+        let attributes = {};
+        let callback;
+        if (typeof attributesOrCallback === "function") {
+            callback = attributesOrCallback;
+        }
+        else {
+            attributes = attributesOrCallback || {};
+            if (!callbackFn) {
+                throw new Error("Callback function is required when attributes are provided");
+            }
+            callback = callbackFn;
+        }
+        // Record start time
+        const startTime = Date.now();
+        try {
+            // Execute the callback
+            const result = await callback();
+            // Calculate duration
+            const duration = Date.now() - startTime;
+            // Register the metric
+            this.registerMetric({
+                name: metricName,
+                event: eventName,
+                attributes: {
+                    ...attributes,
+                    duration,
+                },
+                timestamp: startTime,
+            });
+            return result;
+        }
+        catch (error) {
+            // Register the metric even if there's an error, but mark it as failed
+            const duration = Date.now() - startTime;
+            this.registerMetric({
+                name: metricName,
+                event: eventName,
+                attributes: {
+                    ...attributes,
+                    duration,
+                    error: error instanceof Error ? error.message : String(error),
+                    status: "failed",
+                },
+                timestamp: startTime,
+            });
+            // Re-throw the error
+            throw error;
+        }
+    }
+    convertMetricsToSpanEvents() {
+        const metrics = this.getMetrics();
+        const spanEvents = metrics.map((metric) => {
+            return {
+                name: metric.name,
+                startTime: metric.timestamp,
+                attributes: {
+                    ...metric.attributes,
+                    event: metric.event,
+                },
+            };
+        });
+        return spanEvents;
+    }
+    convertMetricsToSpanAttributes() {
+        const metrics = this.getMetrics();
+        if (metrics.length === 0) {
+            return {};
+        }
+        // Group metrics by name
+        const metricsByName = metrics.reduce((acc, metric) => {
+            if (!acc[metric.name]) {
+                acc[metric.name] = [];
+            }
+            acc[metric.name].push(metric);
+            return acc;
+        }, {});
+        // Process each metric type
+        const reducedMetrics = metrics.reduce((acc, metric) => {
+            acc[metric.event] = {
+                name: metric.name,
+                timestamp: metric.timestamp,
+                event: metric.event,
+                ...flattenAttributes(metric.attributes, "attributes"),
+            };
+            return acc;
+        }, {});
+        const metricEventRollups = {};
+        // Calculate duration for each metric type
+        // Calculate duration for each metric type
+        for (const [metricName, metricEvents] of Object.entries(metricsByName)) {
+            // Skip if there are no events for this metric
+            if (metricEvents.length === 0)
+                continue;
+            // Sort events by timestamp
+            const sortedEvents = [...metricEvents].sort((a, b) => a.timestamp - b.timestamp);
+            // Get first event timestamp (we know it exists because we checked length above)
+            const firstTimestamp = sortedEvents[0].timestamp;
+            // Get last event (we know it exists because we checked length above)
+            const lastEvent = sortedEvents[sortedEvents.length - 1];
+            // Calculate total duration: from first event to (last event + its duration)
+            // Use optional chaining and nullish coalescing for safety
+            const lastEventDuration = lastEvent.attributes?.duration ?? 0;
+            const lastEventEndTime = lastEvent.timestamp + lastEventDuration;
+            // Store the total duration for this metric type
+            const duration = lastEventEndTime - firstTimestamp;
+            const timestamp = firstTimestamp;
+            metricEventRollups[metricName] = {
+                name: metricName,
+                duration,
+                timestamp,
+            };
+        }
+        return {
+            ...flattenAttributes(reducedMetrics, SemanticInternalAttributes.METRIC_EVENTS),
+            ...flattenAttributes(metricEventRollups, SemanticInternalAttributes.METRIC_EVENTS),
+        };
+    }
+    setGlobalManager(manager) {
+        return registerGlobal(API_NAME, manager);
+    }
+    #getManager() {
+        return getGlobal(API_NAME) ?? NOOP_MANAGER;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/v3/runTimelineMetrics/index.js.map

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

package/dist/esm/v3/runTimelineMetrics/runTimelineMetricsManager.d.ts

@@ -0,0 +1,13 @@
+import { TaskRunExecutionMetrics } from "../schemas/schemas.js";
+import { RunTimelineMetric, RunTimelineMetricsManager } from "./types.js";
+export declare class StandardRunTimelineMetricsManager implements RunTimelineMetricsManager {
+    private _metrics;
+    registerMetric(metric: RunTimelineMetric): void;
+    getMetrics(): RunTimelineMetric[];
+    registerMetricsFromExecution(metrics?: TaskRunExecutionMetrics): void;
+    seedMetricsFromEnvironment(): void;
+}
+export declare class NoopRunTimelineMetricsManager implements RunTimelineMetricsManager {
+    registerMetric(metric: RunTimelineMetric): void;
+    getMetrics(): RunTimelineMetric[];
+}

package/dist/esm/v3/runTimelineMetrics/runTimelineMetricsManager.js

@@ -0,0 +1,47 @@
+import { getEnvVar } from "../utils/getEnv.js";
+export class StandardRunTimelineMetricsManager {
+    _metrics = [];
+    registerMetric(metric) {
+        this._metrics.push(metric);
+    }
+    getMetrics() {
+        return this._metrics;
+    }
+    registerMetricsFromExecution(metrics) {
+        if (metrics) {
+            metrics.forEach((metric) => {
+                this.registerMetric({
+                    name: `trigger.dev/${metric.name}`,
+                    event: metric.event,
+                    timestamp: metric.timestamp,
+                    attributes: {
+                        duration: metric.duration,
+                    },
+                });
+            });
+        }
+    }
+    seedMetricsFromEnvironment() {
+        const forkStartTime = getEnvVar("TRIGGER_PROCESS_FORK_START_TIME");
+        if (typeof forkStartTime === "string") {
+            const forkStartTimeMs = parseInt(forkStartTime, 10);
+            this.registerMetric({
+                name: "trigger.dev/start",
+                event: "fork",
+                attributes: {
+                    duration: Date.now() - forkStartTimeMs,
+                },
+                timestamp: forkStartTimeMs,
+            });
+        }
+    }
+}
+export class NoopRunTimelineMetricsManager {
+    registerMetric(metric) {
+        // Do nothing
+    }
+    getMetrics() {
+        return [];
+    }
+}
+//# sourceMappingURL=runTimelineMetricsManager.js.map

package/dist/esm/v3/runTimelineMetrics/runTimelineMetricsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTimelineMetricsManager.js","sourceRoot":"","sources":["../../../../src/v3/runTimelineMetrics/runTimelineMetricsManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,OAAO,iCAAiC;IACpC,QAAQ,GAAwB,EAAE,CAAC;IAE3C,cAAc,CAAC,MAAyB;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,4BAA4B,CAAC,OAAiC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACzB,IAAI,CAAC,cAAc,CAAC;oBAClB,IAAI,EAAE,eAAe,MAAM,CAAC,IAAI,EAAE;oBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,UAAU,EAAE;wBACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0BAA0B;QACxB,MAAM,aAAa,GAAG,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAEnE,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,eAAe,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAEpD,IAAI,CAAC,cAAc,CAAC;gBAClB,IAAI,EAAE,mBAAmB;gBACzB,KAAK,EAAE,MAAM;gBACb,UAAU,EAAE;oBACV,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe;iBACvC;gBACD,SAAS,EAAE,eAAe;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,6BAA6B;IACxC,cAAc,CAAC,MAAyB;QACtC,aAAa;IACf,CAAC;IAED,UAAU;QACR,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import { Attributes } from "@opentelemetry/api";
+export type RunTimelineMetric = {
+    name: string;
+    event: string;
+    timestamp: number;
+    attributes?: Attributes;
+};
+export interface RunTimelineMetricsManager {
+    registerMetric(metric: RunTimelineMetric): void;
+    getMetrics(): RunTimelineMetric[];
+}

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

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

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

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