@trigger.dev/core 3.0.0-beta.34 → 3.0.0-beta.36

package/dist/catalog-XTlJQaMn.d.mts

@@ -0,0 +1,202 @@
+import { Context as Context$1, Span, SpanOptions, Tracer } from '@opentelemetry/api';
+import { Logger } from '@opentelemetry/api-logs';
+import { R as RetryOptions, P as Prettify, b as TaskMetadata, T as TaskFileMetadata, a as TaskMetadataWithFilePath } from './schemas-r4ZP9S-F.mjs';
+import { InstrumentationOption } from '@opentelemetry/instrumentation';
+import { a as TaskRunContext } from './manager-JkbddlcO.mjs';
+
+type TriggerTracerConfig = {
+    name: string;
+    version: string;
+} | {
+    tracer: Tracer;
+    logger: Logger;
+};
+declare class TriggerTracer {
+    private readonly _config;
+    constructor(_config: TriggerTracerConfig);
+    private _tracer;
+    private get tracer();
+    private _logger;
+    private get logger();
+    extractContext(traceContext?: Record<string, unknown>): Context$1;
+    startActiveSpan<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions, ctx?: Context$1): Promise<T>;
+    startSpan(name: string, options?: SpanOptions, ctx?: Context$1): Span;
+}
+
+type LogLevel = "none" | "error" | "warn" | "info" | "debug" | "log";
+declare const logLevels: Array<LogLevel>;
+type TaskLoggerConfig = {
+    logger: Logger;
+    tracer: TriggerTracer;
+    level: LogLevel;
+};
+interface TaskLogger {
+    debug(message: string, properties?: Record<string, unknown>): void;
+    log(message: string, properties?: Record<string, unknown>): void;
+    info(message: string, properties?: Record<string, unknown>): void;
+    warn(message: string, properties?: Record<string, unknown>): void;
+    error(message: string, properties?: Record<string, unknown>): void;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+}
+declare class OtelTaskLogger implements TaskLogger {
+    #private;
+    private readonly _config;
+    private readonly _level;
+    constructor(_config: TaskLoggerConfig);
+    debug(message: string, properties?: Record<string, unknown>): void;
+    log(message: string, properties?: Record<string, unknown>): void;
+    info(message: string, properties?: Record<string, unknown>): void;
+    warn(message: string, properties?: Record<string, unknown>): void;
+    error(message: string, properties?: Record<string, unknown>): void;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+}
+
+interface ProjectConfig {
+    project: string;
+    triggerDirectories?: string | string[];
+    triggerUrl?: string;
+    retries?: {
+        enabledInDev?: boolean;
+        default?: RetryOptions;
+    };
+    additionalPackages?: string[];
+    /**
+     * List of additional files to include in your trigger.dev bundle. e.g. ["./prisma/schema.prisma"]
+     *
+     * Supports glob patterns.
+     *
+     * Note: The path separator for glob patterns is `/`, even on Windows!
+     */
+    additionalFiles?: string[];
+    /**
+     * List of patterns that determine if a module is included in your trigger.dev bundle. This is needed when consuming ESM only packages, since the trigger.dev bundle is currently built as a CJS module.
+     */
+    dependenciesToBundle?: Array<string | RegExp>;
+    /**
+     * The path to your project's tsconfig.json file. Will use tsconfig.json in the project directory if not provided.
+     */
+    tsconfigPath?: string;
+    /**
+     * The OpenTelemetry instrumentations to enable
+     */
+    instrumentations?: InstrumentationOption[];
+    /**
+     * Set the log level for the logger. Defaults to "info", so you will see "log", "info", "warn", and "error" messages, but not "debug" messages.
+     *
+     * We automatically set the logLevel to "debug" during test runs
+     *
+     * @default "info"
+     */
+    logLevel?: LogLevel;
+    /**
+     * 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;
+    /**
+     * Run before a task is executed, for all tasks. This is useful for setting up any global state that is needed for all tasks.
+     */
+    init?: (payload: unknown, params: InitFnParams) => void | Promise<void>;
+    /**
+     * onSuccess is called after the run function has successfully completed.
+     */
+    onSuccess?: (payload: unknown, output: unknown, params: SuccessFnParams<any>) => Promise<void>;
+    /**
+     * onFailure is called after a task run has failed (meaning the run function threw an error and won't be retried anymore)
+     */
+    onFailure?: (payload: unknown, error: unknown, params: FailureFnParams<any>) => Promise<void>;
+    /**
+     * onStart is called the first time a task is executed in a run (not before every retry)
+     */
+    onStart?: (payload: unknown, params: StartFnParams) => Promise<void>;
+    /**
+     * postInstall will run during the deploy build step, after all the dependencies have been installed.
+     *
+     * @example "prisma generate"
+     */
+    postInstall?: string;
+}
+
+type InitOutput = Record<string, any> | void | undefined;
+type RunFnParams<TInitOutput extends InitOutput> = Prettify<{
+    /** Metadata about the task, run, attempt, queue, environment, organization, project and batch.  */
+    ctx: Context;
+    /** If you use the `init` function, this will be whatever you returned. */
+    init?: TInitOutput;
+}>;
+type MiddlewareFnParams = Prettify<{
+    ctx: Context;
+    next: () => Promise<void>;
+}>;
+type InitFnParams = Prettify<{
+    ctx: Context;
+}>;
+type StartFnParams = Prettify<{
+    ctx: Context;
+}>;
+type Context = TaskRunContext;
+type SuccessFnParams<TInitOutput extends InitOutput> = RunFnParams<TInitOutput>;
+type FailureFnParams<TInitOutput extends InitOutput> = RunFnParams<TInitOutput>;
+type HandleErrorFnParams<TInitOutput extends InitOutput> = RunFnParams<TInitOutput> & Prettify<{
+    retry?: RetryOptions;
+    retryAt?: Date;
+    retryDelayInMs?: number;
+}>;
+type HandleErrorModificationOptions = {
+    skipRetrying?: boolean | undefined;
+    retryAt?: Date | undefined;
+    retryDelayInMs?: number | undefined;
+    retry?: RetryOptions | undefined;
+    error?: unknown;
+};
+type HandleErrorResult = undefined | void | HandleErrorModificationOptions | Promise<undefined | void | HandleErrorModificationOptions>;
+type HandleErrorArgs = {
+    ctx: Context;
+    retry?: RetryOptions;
+    retryAt?: Date;
+    retryDelayInMs?: number;
+};
+type HandleErrorFunction = (payload: any, error: unknown, params: HandleErrorArgs) => HandleErrorResult;
+type ResolveEnvironmentVariablesOptions = {
+    variables: Record<string, string> | Array<{
+        name: string;
+        value: string;
+    }>;
+    override?: boolean;
+};
+type ResolveEnvironmentVariablesResult = ResolveEnvironmentVariablesOptions | Promise<void | undefined | ResolveEnvironmentVariablesOptions> | void | undefined;
+type ResolveEnvironmentVariablesParams = {
+    projectRef: string;
+    environment: "dev" | "staging" | "prod";
+    env: Record<string, string>;
+};
+type ResolveEnvironmentVariablesFunction = (params: ResolveEnvironmentVariablesParams) => ResolveEnvironmentVariablesResult;
+type TaskMetadataWithFunctions = TaskMetadata & {
+    fns: {
+        run: (payload: any, params: RunFnParams<any>) => Promise<any>;
+        init?: (payload: any, params: InitFnParams) => Promise<InitOutput>;
+        cleanup?: (payload: any, params: RunFnParams<any>) => Promise<void>;
+        middleware?: (payload: any, params: MiddlewareFnParams) => Promise<void>;
+        handleError?: (payload: any, error: unknown, params: HandleErrorFnParams<any>) => HandleErrorResult;
+        onSuccess?: (payload: any, output: any, params: SuccessFnParams<any>) => Promise<void>;
+        onFailure?: (payload: any, error: unknown, params: FailureFnParams<any>) => Promise<void>;
+        onStart?: (payload: any, params: StartFnParams) => Promise<void>;
+    };
+};
+
+type ClockTime = [number, number];
+interface Clock {
+    preciseNow(): ClockTime;
+    reset(): void;
+}
+
+interface TaskCatalog {
+    registerTaskMetadata(task: TaskMetadataWithFunctions): void;
+    updateTaskMetadata(id: string, task: Partial<TaskMetadataWithFunctions>): void;
+    registerTaskFileMetadata(id: string, metadata: TaskFileMetadata): void;
+    getAllTaskMetadata(): Array<TaskMetadataWithFilePath>;
+    getTaskMetadata(id: string): TaskMetadataWithFilePath | undefined;
+    getTask(id: string): TaskMetadataWithFunctions | undefined;
+    taskExists(id: string): boolean;
+}
+
+export { type Clock as C, type FailureFnParams as F, type HandleErrorFunction as H, type InitOutput as I, type LogLevel as L, type MiddlewareFnParams as M, OtelTaskLogger as O, type ProjectConfig as P, type RunFnParams as R, type StartFnParams as S, TriggerTracer as T, type TaskMetadataWithFunctions as a, type ClockTime as b, type TaskCatalog as c, type TaskLogger as d, type InitFnParams as e, type Context as f, type SuccessFnParams as g, type HandleErrorFnParams as h, type HandleErrorModificationOptions as i, type HandleErrorResult as j, type HandleErrorArgs as k, logLevels as l, type ResolveEnvironmentVariablesResult as m, type ResolveEnvironmentVariablesParams as n, type ResolveEnvironmentVariablesFunction as o };

package/dist/catalog-dRKTgwQ7.d.ts

@@ -0,0 +1,202 @@
+import { Context as Context$1, Span, SpanOptions, Tracer } from '@opentelemetry/api';
+import { Logger } from '@opentelemetry/api-logs';
+import { R as RetryOptions, P as Prettify, b as TaskMetadata, T as TaskFileMetadata, a as TaskMetadataWithFilePath } from './schemas-r4ZP9S-F.js';
+import { InstrumentationOption } from '@opentelemetry/instrumentation';
+import { a as TaskRunContext } from './manager-JkbddlcO.js';
+
+type TriggerTracerConfig = {
+    name: string;
+    version: string;
+} | {
+    tracer: Tracer;
+    logger: Logger;
+};
+declare class TriggerTracer {
+    private readonly _config;
+    constructor(_config: TriggerTracerConfig);
+    private _tracer;
+    private get tracer();
+    private _logger;
+    private get logger();
+    extractContext(traceContext?: Record<string, unknown>): Context$1;
+    startActiveSpan<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions, ctx?: Context$1): Promise<T>;
+    startSpan(name: string, options?: SpanOptions, ctx?: Context$1): Span;
+}
+
+type LogLevel = "none" | "error" | "warn" | "info" | "debug" | "log";
+declare const logLevels: Array<LogLevel>;
+type TaskLoggerConfig = {
+    logger: Logger;
+    tracer: TriggerTracer;
+    level: LogLevel;
+};
+interface TaskLogger {
+    debug(message: string, properties?: Record<string, unknown>): void;
+    log(message: string, properties?: Record<string, unknown>): void;
+    info(message: string, properties?: Record<string, unknown>): void;
+    warn(message: string, properties?: Record<string, unknown>): void;
+    error(message: string, properties?: Record<string, unknown>): void;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+}
+declare class OtelTaskLogger implements TaskLogger {
+    #private;
+    private readonly _config;
+    private readonly _level;
+    constructor(_config: TaskLoggerConfig);
+    debug(message: string, properties?: Record<string, unknown>): void;
+    log(message: string, properties?: Record<string, unknown>): void;
+    info(message: string, properties?: Record<string, unknown>): void;
+    warn(message: string, properties?: Record<string, unknown>): void;
+    error(message: string, properties?: Record<string, unknown>): void;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+}
+
+interface ProjectConfig {
+    project: string;
+    triggerDirectories?: string | string[];
+    triggerUrl?: string;
+    retries?: {
+        enabledInDev?: boolean;
+        default?: RetryOptions;
+    };
+    additionalPackages?: string[];
+    /**
+     * List of additional files to include in your trigger.dev bundle. e.g. ["./prisma/schema.prisma"]
+     *
+     * Supports glob patterns.
+     *
+     * Note: The path separator for glob patterns is `/`, even on Windows!
+     */
+    additionalFiles?: string[];
+    /**
+     * List of patterns that determine if a module is included in your trigger.dev bundle. This is needed when consuming ESM only packages, since the trigger.dev bundle is currently built as a CJS module.
+     */
+    dependenciesToBundle?: Array<string | RegExp>;
+    /**
+     * The path to your project's tsconfig.json file. Will use tsconfig.json in the project directory if not provided.
+     */
+    tsconfigPath?: string;
+    /**
+     * The OpenTelemetry instrumentations to enable
+     */
+    instrumentations?: InstrumentationOption[];
+    /**
+     * Set the log level for the logger. Defaults to "info", so you will see "log", "info", "warn", and "error" messages, but not "debug" messages.
+     *
+     * We automatically set the logLevel to "debug" during test runs
+     *
+     * @default "info"
+     */
+    logLevel?: LogLevel;
+    /**
+     * 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;
+    /**
+     * Run before a task is executed, for all tasks. This is useful for setting up any global state that is needed for all tasks.
+     */
+    init?: (payload: unknown, params: InitFnParams) => void | Promise<void>;
+    /**
+     * onSuccess is called after the run function has successfully completed.
+     */
+    onSuccess?: (payload: unknown, output: unknown, params: SuccessFnParams<any>) => Promise<void>;
+    /**
+     * onFailure is called after a task run has failed (meaning the run function threw an error and won't be retried anymore)
+     */
+    onFailure?: (payload: unknown, error: unknown, params: FailureFnParams<any>) => Promise<void>;
+    /**
+     * onStart is called the first time a task is executed in a run (not before every retry)
+     */
+    onStart?: (payload: unknown, params: StartFnParams) => Promise<void>;
+    /**
+     * postInstall will run during the deploy build step, after all the dependencies have been installed.
+     *
+     * @example "prisma generate"
+     */
+    postInstall?: string;
+}
+
+type InitOutput = Record<string, any> | void | undefined;
+type RunFnParams<TInitOutput extends InitOutput> = Prettify<{
+    /** Metadata about the task, run, attempt, queue, environment, organization, project and batch.  */
+    ctx: Context;
+    /** If you use the `init` function, this will be whatever you returned. */
+    init?: TInitOutput;
+}>;
+type MiddlewareFnParams = Prettify<{
+    ctx: Context;
+    next: () => Promise<void>;
+}>;
+type InitFnParams = Prettify<{
+    ctx: Context;
+}>;
+type StartFnParams = Prettify<{
+    ctx: Context;
+}>;
+type Context = TaskRunContext;
+type SuccessFnParams<TInitOutput extends InitOutput> = RunFnParams<TInitOutput>;
+type FailureFnParams<TInitOutput extends InitOutput> = RunFnParams<TInitOutput>;
+type HandleErrorFnParams<TInitOutput extends InitOutput> = RunFnParams<TInitOutput> & Prettify<{
+    retry?: RetryOptions;
+    retryAt?: Date;
+    retryDelayInMs?: number;
+}>;
+type HandleErrorModificationOptions = {
+    skipRetrying?: boolean | undefined;
+    retryAt?: Date | undefined;
+    retryDelayInMs?: number | undefined;
+    retry?: RetryOptions | undefined;
+    error?: unknown;
+};
+type HandleErrorResult = undefined | void | HandleErrorModificationOptions | Promise<undefined | void | HandleErrorModificationOptions>;
+type HandleErrorArgs = {
+    ctx: Context;
+    retry?: RetryOptions;
+    retryAt?: Date;
+    retryDelayInMs?: number;
+};
+type HandleErrorFunction = (payload: any, error: unknown, params: HandleErrorArgs) => HandleErrorResult;
+type ResolveEnvironmentVariablesOptions = {
+    variables: Record<string, string> | Array<{
+        name: string;
+        value: string;
+    }>;
+    override?: boolean;
+};
+type ResolveEnvironmentVariablesResult = ResolveEnvironmentVariablesOptions | Promise<void | undefined | ResolveEnvironmentVariablesOptions> | void | undefined;
+type ResolveEnvironmentVariablesParams = {
+    projectRef: string;
+    environment: "dev" | "staging" | "prod";
+    env: Record<string, string>;
+};
+type ResolveEnvironmentVariablesFunction = (params: ResolveEnvironmentVariablesParams) => ResolveEnvironmentVariablesResult;
+type TaskMetadataWithFunctions = TaskMetadata & {
+    fns: {
+        run: (payload: any, params: RunFnParams<any>) => Promise<any>;
+        init?: (payload: any, params: InitFnParams) => Promise<InitOutput>;
+        cleanup?: (payload: any, params: RunFnParams<any>) => Promise<void>;
+        middleware?: (payload: any, params: MiddlewareFnParams) => Promise<void>;
+        handleError?: (payload: any, error: unknown, params: HandleErrorFnParams<any>) => HandleErrorResult;
+        onSuccess?: (payload: any, output: any, params: SuccessFnParams<any>) => Promise<void>;
+        onFailure?: (payload: any, error: unknown, params: FailureFnParams<any>) => Promise<void>;
+        onStart?: (payload: any, params: StartFnParams) => Promise<void>;
+    };
+};
+
+type ClockTime = [number, number];
+interface Clock {
+    preciseNow(): ClockTime;
+    reset(): void;
+}
+
+interface TaskCatalog {
+    registerTaskMetadata(task: TaskMetadataWithFunctions): void;
+    updateTaskMetadata(id: string, task: Partial<TaskMetadataWithFunctions>): void;
+    registerTaskFileMetadata(id: string, metadata: TaskFileMetadata): void;
+    getAllTaskMetadata(): Array<TaskMetadataWithFilePath>;
+    getTaskMetadata(id: string): TaskMetadataWithFilePath | undefined;
+    getTask(id: string): TaskMetadataWithFunctions | undefined;
+    taskExists(id: string): boolean;
+}
+
+export { type Clock as C, type FailureFnParams as F, type HandleErrorFunction as H, type InitOutput as I, type LogLevel as L, type MiddlewareFnParams as M, OtelTaskLogger as O, type ProjectConfig as P, type RunFnParams as R, type StartFnParams as S, TriggerTracer as T, type TaskMetadataWithFunctions as a, type ClockTime as b, type TaskCatalog as c, type TaskLogger as d, type InitFnParams as e, type Context as f, type SuccessFnParams as g, type HandleErrorFnParams as h, type HandleErrorModificationOptions as i, type HandleErrorResult as j, type HandleErrorArgs as k, logLevels as l, type ResolveEnvironmentVariablesResult as m, type ResolveEnvironmentVariablesParams as n, type ResolveEnvironmentVariablesFunction as o };