@trigger.dev/core 0.0.0-v3-prerelease-20250108141813 → 0.0.0-v4-prerelease-20250916125920

package/dist/esm/v3/config.d.ts

@@ -1,25 +1,111 @@
 import type { Instrumentation } from "@opentelemetry/instrumentation";
+import type { SpanExporter } from "@opentelemetry/sdk-trace-base";
 import type { BuildExtension } from "./build/extensions.js";
-import type { MachinePresetName } from "./schemas/common.js";
+import type { AnyOnFailureHookFunction, AnyOnInitHookFunction, AnyOnStartHookFunction, AnyOnSuccessHookFunction, BuildRuntime, RetryOptions } from "./index.js";
 import type { LogLevel } from "./logger/taskLogger.js";
-import type { FailureFnParams, InitFnParams, StartFnParams, SuccessFnParams } from "./types/index.js";
-import type { BuildRuntime, RetryOptions } from "./index.js";
+import type { MachinePresetName } from "./schemas/common.js";
+import { LogRecordExporter } from "@opentelemetry/sdk-logs";
+export type CompatibilityFlag = "run_engine_v2";
+export type CompatibilityFlagFeatures = {
+    [key in CompatibilityFlag]: boolean;
+};
+type ProcessKeepAlive = boolean | {
+    enabled: boolean;
+    /**
+     * The maximum number of executions per process. If the process has run more than this number of times, it will be killed.
+     *
+     * @default 50
+     */
+    maxExecutionsPerProcess?: number;
+    /**
+     * The maximum number of processes to keep alive in dev.
+     *
+     * @default 25
+     */
+    devMaxPoolSize?: number;
+};
 export type TriggerConfig = {
     /**
      * @default "node"
      */
     runtime?: BuildRuntime;
+    /**
+     * Specify the project ref for your trigger.dev tasks. This is the project ref that you get when you create a new project in the trigger.dev dashboard.
+     */
     project: string;
+    /**
+     * Specify the directories that contain your trigger.dev tasks. This is useful if you have multiple directories that contain tasks.
+     *
+     * We automatically detect directories named `trigger` to be task directories. You can override this behavior by specifying the directories here.
+     *
+     * @see @see https://trigger.dev/docs/config/config-file#dirs
+     */
     dirs?: string[];
+    /**
+     * Specify glob patterns to ignore when detecting task files. By default we ignore:
+     *
+     * - *.test.ts
+     * - *.spec.ts
+     * - *.test.mts
+     * - *.spec.mts
+     * - *.test.cts
+     * - *.spec.cts
+     * - *.test.js
+     * - *.spec.js
+     * - *.test.mjs
+     * - *.spec.mjs
+     * - *.test.cjs
+     * - *.spec.cjs
+     *
+     */
+    ignorePatterns?: string[];
+    /**
+     * Instrumentations to use for OpenTelemetry. This is useful if you want to add custom instrumentations to your tasks.
+     *
+     * @see https://trigger.dev/docs/config/config-file#instrumentations
+     *
+     * @deprecated Use the `telemetry.instrumentations` option instead.
+     */
     instrumentations?: Array<Instrumentation>;
+    telemetry?: {
+        /**
+         * Instrumentations to use for OpenTelemetry. This is useful if you want to add custom instrumentations to your tasks.
+         *
+         * @see https://trigger.dev/docs/config/config-file#instrumentations
+         */
+        instrumentations?: Array<Instrumentation>;
+        /**
+         * Exporters to use for OpenTelemetry. This is useful if you want to add custom exporters to your tasks.
+         *
+         * @see https://trigger.dev/docs/config/config-file#exporters
+         */
+        exporters?: Array<SpanExporter>;
+        /**
+         * Log exporters to use for OpenTelemetry. This is useful if you want to add custom log exporters to your tasks.
+         *
+         * @see https://trigger.dev/docs/config/config-file#exporters
+         */
+        logExporters?: Array<LogRecordExporter>;
+    };
+    /**
+     * Specify a custom path to your tsconfig file. This is useful if you have a custom tsconfig file that you want to use.
+     */
     tsconfig?: string;
+    /**
+     * Specify the global retry options for your tasks. You can override this on a per-task basis.
+     *
+     * @see https://trigger.dev/docs/tasks/overview#retry-options
+     */
     retries?: {
         enabledInDev?: boolean;
         default?: RetryOptions;
     };
+    compatibilityFlags?: Array<CompatibilityFlag>;
     /**
      * The default machine preset to use for your deployed trigger.dev tasks. You can override this on a per-task basis.
      * @default "small-1x"
+     *
+     * @see https://trigger.dev/docs/machines
      */
     machine?: MachinePresetName;
     /**
@@ -36,12 +122,18 @@ export type TriggerConfig = {
      * Minimum value is 5 seconds
      *
      * Setting this value will effect all tasks in the project.
+     *
+     * @see https://trigger.dev/docs/tasks/overview#maxduration-option
      */
-    maxDuration?: number;
+    maxDuration: number;
     /**
      * Enable console logging while running the dev CLI. This will print out logs from console.log, console.warn, and console.error. By default all logs are sent to the trigger.dev backend, and not logged to the console.
      */
     enableConsoleLogging?: boolean;
+    /**
+     * Disable the console interceptor. This will prevent logs from being sent to the trigger.dev backend.
+     */
+    disableConsoleInterceptor?: boolean;
     build?: {
         /**
          * Add custom conditions to the esbuild build. For example, if you are importing `ai/rsc`, you'll need to add "react-server" condition.
@@ -53,8 +145,57 @@ export type TriggerConfig = {
          * - "node"
          */
         conditions?: string[];
+        /**
+         * Add custom build extensions to the build process.
+         *
+         * @see https://trigger.dev/docs/config/config-file#extensions
+         */
         extensions?: BuildExtension[];
+        /**
+         * External dependencies to exclude from the bundle. This is useful if you want to keep some dependencies as external, and not bundle them with your code.
+         *
+         * @see https://trigger.dev/docs/config/config-file#external
+         */
         external?: string[];
+        /**
+         * This still works but use `autoDetectExternal` instead.
+         *
+         * @deprecated (use autoDetectExternal instead)
+         */
+        experimental_autoDetectExternal?: boolean;
+        /**
+         * Automatically detect dependencies that shouldn't be bundled and mark them as external. For example, native modules.
+         *
+         * Turn this off if you are having issues and want to manually specify all `external` dependencies.
+         *
+         * @default true
+         */
+        autoDetectExternal?: boolean;
+        /**
+         * This still works but use `keepNames` instead.
+         *
+         * @deprecated (use keepNames instead)
+         */
+        experimental_keepNames?: boolean;
+        keepNames?: boolean;
+        /**
+         * This still works but use `minify` instead.
+         *
+         * @deprecated (use minify instead)
+         */
+        experimental_minify?: boolean;
+        /**
+         * **WARNING: This is an experimental feature and might be removed in a future version.**
+         *
+         * "Minification is not safe for 100% of all JavaScript code" - esbuild docs
+         *
+         * Minify the generated code to help decrease bundle size. This may break stuff.
+         *
+         * @link https://esbuild.github.io/api/#minify
+         *
+         * @default false
+         */
+        minify?: boolean;
         jsx?: {
             /**
              * @default "React.createElement"
@@ -75,6 +216,29 @@ export type TriggerConfig = {
     deploy?: {
         env?: Record<string, string>;
     };
+    /**
+     * This still works but use `processKeepAlive` instead.
+     *
+     * @deprecated (use processKeepAlive instead)
+     */
+    experimental_processKeepAlive?: ProcessKeepAlive;
+    /**
+     * @default false
+     * @description Keep the process alive after the task has finished running so the next task doesn't have to wait for the process to start up again.
+     *
+     * Note that the process could be killed at any time, and we don't make any guarantees about the process being alive for a certain amount of time
+     */
+    processKeepAlive?: ProcessKeepAlive;
+    /**
+     * @default true
+     * @description If set to true when running the dev CLI, the current working directory will be set to where the command is run from.
+     *
+     * Setting this to `false` will set the current working directory to the build directory.
+     * This more closely matches the behavior of the CLI when running in production and is highly recommended.
+     *
+     * This impacts the value of process.cwd() in your task code.
+     */
+    legacyDevProcessCwdBehaviour?: boolean;
     /**
      * @deprecated Use `dirs` instead
      */
@@ -96,7 +260,7 @@ export type TriggerConfig = {
      */
     tsconfigPath?: string;
     /**
-     * CA Cert file to be added to NODE_EXTRA_CA_CERT environment variable in, useful in use with self signed cert in the trigger.dev environment.
+     * CA Cert file to be added to NODE_EXTRA_CA_CERT environment variable, useful in use with self signed cert in the trigger.dev environment.
      *
      * @example "./certs/ca.crt"
      * Note: must start with "./" and be relative to the project root.
@@ -105,22 +269,31 @@ export type TriggerConfig = {
     extraCACerts?: string;
     /**
      * Run before a task is executed, for all tasks. This is useful for setting up any global state that is needed for all tasks.
+     *
+     * @deprecated, please use tasks.init instead
      */
-    init?: (payload: unknown, params: InitFnParams) => void | Promise<void>;
+    init?: AnyOnInitHookFunction;
     /**
      * onSuccess is called after the run function has successfully completed.
+     *
+     * @deprecated, please use tasks.onSuccess instead
      */
-    onSuccess?: (payload: unknown, output: unknown, params: SuccessFnParams<any>) => Promise<void>;
+    onSuccess?: AnyOnSuccessHookFunction;
     /**
      * onFailure is called after a task run has failed (meaning the run function threw an error and won't be retried anymore)
+     *
+     * @deprecated, please use tasks.onFailure instead
      */
-    onFailure?: (payload: unknown, error: unknown, params: FailureFnParams<any>) => Promise<void>;
+    onFailure?: AnyOnFailureHookFunction;
     /**
      * onStart is called the first time a task is executed in a run (not before every retry)
+     *
+     * @deprecated, please use tasks.onStart instead
      */
-    onStart?: (payload: unknown, params: StartFnParams) => Promise<void>;
+    onStart?: AnyOnStartHookFunction;
     /**
      * @deprecated Use a custom build extension to add post install commands
      */
     postInstall?: string;
 };
+export {};

package/dist/esm/v3/consoleInterceptor.d.ts

@@ -3,7 +3,9 @@ export declare class ConsoleInterceptor {
     #private;
     private readonly logger;
     private readonly sendToStdIO;
-    constructor(logger: logsAPI.Logger, sendToStdIO: boolean);
+    private readonly interceptingDisabled;
+    private readonly maxAttributeCount?;
+    constructor(logger: logsAPI.Logger, sendToStdIO: boolean, interceptingDisabled: boolean, maxAttributeCount?: number | undefined);
     intercept<T>(console: Console, callback: () => Promise<T>): Promise<T>;
     debug(...args: unknown[]): void;
     log(...args: unknown[]): void;

package/dist/esm/v3/consoleInterceptor.js

@@ -7,13 +7,20 @@ import { clock } from "./clock-api.js";
 export class ConsoleInterceptor {
     logger;
     sendToStdIO;
-    constructor(logger, sendToStdIO) {
+    interceptingDisabled;
+    maxAttributeCount;
+    constructor(logger, sendToStdIO, interceptingDisabled, maxAttributeCount) {
         this.logger = logger;
         this.sendToStdIO = sendToStdIO;
+        this.interceptingDisabled = interceptingDisabled;
+        this.maxAttributeCount = maxAttributeCount;
     }
     // Intercept the console and send logs to the OpenTelemetry logger
     // during the execution of the callback
     async intercept(console, callback) {
+        if (this.interceptingDisabled) {
+            return await callback();
+        }
         // Save the original console methods
         const originalConsole = {
             log: console.log,
@@ -71,7 +78,10 @@ export class ConsoleInterceptor {
                 severityNumber,
                 severityText,
                 body: getLogMessage(parsed.value, severityText),
-                attributes: { ...this.#getAttributes(severityNumber), ...flattenAttributes(parsed.value) },
+                attributes: {
+                    ...this.#getAttributes(severityNumber),
+                    ...flattenAttributes(parsed.value, undefined, this.maxAttributeCount),
+                },
                 timestamp,
             });
             return;

package/dist/esm/v3/consoleInterceptor.js.map

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

package/dist/esm/v3/errors.d.ts

@@ -1,21 +1,50 @@
 import { z } from "zod";
 import { DeploymentErrorData } from "./schemas/api.js";
 import { ImportTaskFileErrors, WorkerManifest } from "./schemas/build.js";
-import { SerializedError, TaskRunError, TaskRunInternalError } from "./schemas/common.js";
+import { SerializedError, TaskRunError, TaskRunErrorCodes, TaskRunInternalError } from "./schemas/common.js";
 import { TaskMetadataFailedToParseData } from "./schemas/messages.js";
 import { ExceptionEventProperties } from "./schemas/openTelemetry.js";
+/**
+ * If you throw this, it will get converted into an INTERNAL_ERROR
+ */
+export declare class InternalError extends Error {
+    readonly code: TaskRunErrorCodes;
+    readonly skipRetrying: boolean;
+    constructor({ code, message, showStackTrace, skipRetrying, }: {
+        code: TaskRunErrorCodes;
+        message?: string;
+        showStackTrace?: boolean;
+        skipRetrying?: boolean;
+    });
+}
+export declare function isInternalError(error: unknown): error is InternalError;
 export declare class AbortTaskRunError extends Error {
     constructor(message: string);
 }
+/**
+ * This causes an Out Of Memory error on the run (if it's uncaught).
+ * This can be useful if you use a native package that detects it's run out of memory but doesn't kill Node.js
+ */
+export declare class OutOfMemoryError extends Error {
+    constructor();
+}
+export declare function isManualOutOfMemoryError(error: TaskRunError): boolean;
+export declare function isOOMRunError(error: TaskRunError): boolean;
 export declare class TaskPayloadParsedError extends Error {
     readonly cause: unknown;
     constructor(cause: unknown);
 }
+export declare class CompleteTaskWithOutput extends Error {
+    readonly output: unknown;
+    constructor(output?: unknown);
+}
+export declare function isCompleteTaskWithOutput(error: unknown): error is CompleteTaskWithOutput;
 export declare function parseError(error: unknown): TaskRunError;
 export declare function createErrorTaskError(error: TaskRunError): any;
 export declare function createJsonErrorObject(error: TaskRunError): SerializedError;
 export declare function sanitizeError(error: TaskRunError): TaskRunError;
 export declare function shouldRetryError(error: TaskRunError): boolean;
+export declare function shouldLookupRetrySettings(error: TaskRunError): boolean;
 export declare function correctErrorStackTrace(stackTrace: string, projectDir?: string, options?: {
     removeFirstLine?: boolean;
     isDev?: boolean;
@@ -61,6 +90,9 @@ export declare class UnexpectedExitError extends Error {
 export declare class CleanupProcessError extends Error {
     constructor();
 }
+export declare class SuspendedProcessError extends Error {
+    constructor();
+}
 export declare class CancelledProcessError extends Error {
     constructor();
 }
@@ -84,4 +116,5 @@ export declare function internalErrorFromUnexpectedExit(error: UnexpectedExitErr
 export declare function serializeIndexingError(error: unknown, stderr?: string): DeploymentErrorData;
 export declare function prepareDeploymentError(errorData: DeploymentErrorData): DeploymentErrorData | undefined;
 export declare function createTaskMetadataFailedErrorStack(data: z.infer<typeof TaskMetadataFailedToParseData>): string;
+export declare function taskRunErrorToString(error: TaskRunError): string;
 export {};