@workflow/core 4.0.1-beta.0

package/dist/telemetry.d.ts

@@ -0,0 +1,24 @@
+import type { Span, SpanOptions } from '@opentelemetry/api';
+/**
+ * Serializes the current trace context into a format that can be passed through queues
+ * @returns A record of strings representing the trace context
+ */
+export declare function serializeTraceCarrier(): Promise<Record<string, string>>;
+/**
+ * Deserializes trace context and returns a context that can be used to continue the trace
+ * @param traceCarrier The serialized trace context
+ * @returns OpenTelemetry context with the restored trace
+ */
+export declare function deserializeTraceCarrier(traceCarrier: Record<string, string>): Promise<import("@opentelemetry/api").Context | undefined>;
+/**
+ * Runs a function within the context of a deserialized trace
+ * @param traceCarrier The serialized trace carrier (optional)
+ * @param fn The function to run within the trace context
+ * @returns The result of the function
+ */
+export declare function withTraceContext<T>(traceCarrier: Record<string, string> | undefined, fn: () => Promise<T>): Promise<T>;
+export declare function trace<T>(spanName: string, ...args: [fn: (span?: Span) => Promise<T>] | [opts: SpanOptions, fn: (span?: Span) => Promise<T>]): Promise<T>;
+export declare function getSpanContextForTraceCarrier(carrier: Record<string, string>): Promise<import("@opentelemetry/api").SpanContext | undefined>;
+export declare function getActiveSpan(): Promise<Span | null | undefined>;
+export declare function instrumentObject<T extends object>(prefix: string, o: T): T;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAO5D;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAO7E;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,6DAMrC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAChD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ;AAiBD,wBAAsB,KAAK,CAAC,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,IAAI,EACH,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GACjC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GACvD,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iEAQhC;AAED,wBAAsB,aAAa,qCAIlC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAa1E"}

package/dist/telemetry.js

@@ -0,0 +1,121 @@
+import { once } from './util.js';
+// ============================================================
+// Trace Context Propagation Utilities
+// ============================================================
+/**
+ * Serializes the current trace context into a format that can be passed through queues
+ * @returns A record of strings representing the trace context
+ */
+export async function serializeTraceCarrier() {
+    const otel = await OtelApi.value;
+    if (!otel)
+        return {};
+    const carrier = {};
+    // Inject the current context into the carrier
+    otel.propagation.inject(otel.context.active(), carrier);
+    return carrier;
+}
+/**
+ * Deserializes trace context and returns a context that can be used to continue the trace
+ * @param traceCarrier The serialized trace context
+ * @returns OpenTelemetry context with the restored trace
+ */
+export async function deserializeTraceCarrier(traceCarrier) {
+    const otel = await OtelApi.value;
+    if (!otel)
+        return;
+    // Extract the context from the carrier
+    return otel.propagation.extract(otel.context.active(), traceCarrier);
+}
+/**
+ * Runs a function within the context of a deserialized trace
+ * @param traceCarrier The serialized trace carrier (optional)
+ * @param fn The function to run within the trace context
+ * @returns The result of the function
+ */
+export async function withTraceContext(traceCarrier, fn) {
+    if (!traceCarrier) {
+        return fn();
+    }
+    const otel = await OtelApi.value;
+    if (!otel)
+        return fn();
+    const extractedContext = await deserializeTraceCarrier(traceCarrier);
+    if (!extractedContext) {
+        return fn();
+    }
+    return otel.context.with(extractedContext, async () => await fn());
+}
+const OtelApi = once(async () => {
+    try {
+        return await import('@opentelemetry/api');
+    }
+    catch {
+        console.warn('OpenTelemetry not available, tracing will be disabled');
+        return null;
+    }
+});
+const Tracer = once(async () => {
+    const api = await OtelApi.value;
+    if (!api)
+        return null;
+    return api.trace.getTracer('workflow');
+});
+export async function trace(spanName, ...args) {
+    const [tracer, otel] = await Promise.all([Tracer.value, OtelApi.value]);
+    const { fn, opts } = typeof args[0] === 'function'
+        ? { fn: args[0], opts: {} }
+        : { fn: args[1], opts: args[0] };
+    if (!fn)
+        throw new Error('Function to trace must be provided');
+    if (!tracer || !otel) {
+        return await fn();
+    }
+    return tracer.startActiveSpan(spanName, opts, async (span) => {
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: otel.SpanStatusCode.OK });
+            return result;
+        }
+        catch (e) {
+            span.setStatus({
+                code: otel.SpanStatusCode.ERROR,
+                message: e.message,
+            });
+            throw e;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+export async function getSpanContextForTraceCarrier(carrier) {
+    const [deserialized, otel] = await Promise.all([
+        deserializeTraceCarrier(carrier),
+        OtelApi.value,
+    ]);
+    if (!deserialized || !otel)
+        return;
+    return otel.trace.getSpanContext(deserialized);
+}
+export async function getActiveSpan() {
+    const otel = await OtelApi.value;
+    if (!otel)
+        return null;
+    return otel.trace.getActiveSpan();
+}
+export function instrumentObject(prefix, o) {
+    const handlers = {};
+    for (const key of Object.keys(o)) {
+        if (typeof o[key] !== 'function') {
+            handlers[key] = o[key];
+        }
+        else {
+            const f = o[key];
+            // @ts-expect-error
+            handlers[key] = async (...args) => trace(`${prefix}.${String(key)}`, {}, () => f(...args));
+        }
+    }
+    return handlers;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+export declare function getConstructorName(obj: unknown): string | null;
+export declare function getConstructorNames(obj: unknown): string[];
+/**
+ * `instanceof` operator that works across different `vm` contexts,
+ * based on the `name` property of the constructors of the prototype chain.
+ */
+export declare function isInstanceOf<T>(v: unknown, ctor: new (...args: any[]) => T): v is T;
+export declare function getErrorName(v: unknown): string;
+export declare function getErrorStack(v: unknown): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAS9D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAO1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,CAAC,EAAE,OAAO,EACV,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAC9B,CAAC,IAAI,CAAC,CAER;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAK/C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAKhD"}

package/dist/types.js

@@ -0,0 +1,39 @@
+import { types } from 'node:util';
+export function getConstructorName(obj) {
+    if (obj === null || obj === undefined) {
+        return null;
+    }
+    const ctor = obj.constructor;
+    if (!ctor || ctor.name === 'Object') {
+        return null;
+    }
+    return ctor.name;
+}
+export function getConstructorNames(obj) {
+    const proto = Object.getPrototypeOf(obj);
+    const name = getConstructorName(proto);
+    if (name === null) {
+        return [];
+    }
+    return [name, ...getConstructorNames(proto)];
+}
+/**
+ * `instanceof` operator that works across different `vm` contexts,
+ * based on the `name` property of the constructors of the prototype chain.
+ */
+export function isInstanceOf(v, ctor) {
+    return getConstructorNames(v).includes(ctor.name);
+}
+export function getErrorName(v) {
+    if (types.isNativeError(v)) {
+        return v.name;
+    }
+    return 'Error';
+}
+export function getErrorStack(v) {
+    if (types.isNativeError(v)) {
+        return v.stack ?? '';
+    }
+    return '';
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,CAAU,EACV,IAA+B;IAE/B,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,43 @@
+export interface PromiseWithResolvers<T> {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: any) => void;
+}
+/**
+ * Polyfill for `Promise.withResolvers()`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+ */
+export declare function withResolvers<T>(): PromiseWithResolvers<T>;
+/**
+ * Creates a lazily-evaluated, memoized version of the provided function.
+ *
+ * The returned object exposes a `value` getter that calls `fn` only once,
+ * caches its result, and returns the cached value on subsequent accesses.
+ *
+ * @typeParam T - The return type of the provided function.
+ * @param fn - The function to be called once and whose result will be cached.
+ * @returns An object with a `value` property that returns the memoized result of `fn`.
+ */
+export declare function once<T>(fn: () => T): {
+    readonly value: T;
+};
+/**
+ * Builds a workflow suspension log message based on the counts of steps and hooks.
+ * @param runId - The workflow run ID
+ * @param stepCount - Number of steps to be enqueued
+ * @param hookCount - Number of hooks to be enqueued
+ * @returns The formatted log message or null if both counts are 0
+ */
+export declare function buildWorkflowSuspensionMessage(runId: string, stepCount: number, hookCount: number): string | null;
+/**
+ * Generates a stream ID for a workflow run.
+ * User-defined streams include a "user" segment for isolation from future system-defined streams.
+ * Namespaces are base64-encoded to handle characters not allowed in Redis key names.
+ *
+ * @param runId - The workflow run ID
+ * @param namespace - Optional namespace for the stream
+ * @returns The stream ID in format: `strm_{ULID}_user_{base64(namespace)?}`
+ */
+export declare function getWorkflowRunStreamId(runId: string, namespace?: string): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAK,oBAAoB,CAAC,CAAC,CAAC,CAQ1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC;;EASlC;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAmBf;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,UAUvE"}

package/dist/util.js

@@ -0,0 +1,76 @@
+/**
+ * Polyfill for `Promise.withResolvers()`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+ */
+export function withResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((_resolve, _reject) => {
+        resolve = _resolve;
+        reject = _reject;
+    });
+    return { promise, resolve, reject };
+}
+/**
+ * Creates a lazily-evaluated, memoized version of the provided function.
+ *
+ * The returned object exposes a `value` getter that calls `fn` only once,
+ * caches its result, and returns the cached value on subsequent accesses.
+ *
+ * @typeParam T - The return type of the provided function.
+ * @param fn - The function to be called once and whose result will be cached.
+ * @returns An object with a `value` property that returns the memoized result of `fn`.
+ */
+export function once(fn) {
+    const result = {
+        get value() {
+            const value = fn();
+            Object.defineProperty(result, 'value', { value });
+            return value;
+        },
+    };
+    return result;
+}
+/**
+ * Builds a workflow suspension log message based on the counts of steps and hooks.
+ * @param runId - The workflow run ID
+ * @param stepCount - Number of steps to be enqueued
+ * @param hookCount - Number of hooks to be enqueued
+ * @returns The formatted log message or null if both counts are 0
+ */
+export function buildWorkflowSuspensionMessage(runId, stepCount, hookCount) {
+    if (stepCount === 0 && hookCount === 0) {
+        return null;
+    }
+    const parts = [];
+    if (stepCount > 0) {
+        parts.push(`${stepCount} ${stepCount === 1 ? 'step' : 'steps'}`);
+    }
+    if (hookCount > 0) {
+        parts.push(`${hookCount} ${hookCount === 1 ? 'hook' : 'hooks'}`);
+    }
+    const resumeMsg = hookCount > 0
+        ? 'steps are created and hooks are triggered'
+        : 'steps are created';
+    return `[Workflows] "${runId}" - ${parts.join(' and ')} to be enqueued\n  Workflow will suspend and resume when ${resumeMsg}`;
+}
+/**
+ * Generates a stream ID for a workflow run.
+ * User-defined streams include a "user" segment for isolation from future system-defined streams.
+ * Namespaces are base64-encoded to handle characters not allowed in Redis key names.
+ *
+ * @param runId - The workflow run ID
+ * @param namespace - Optional namespace for the stream
+ * @returns The stream ID in format: `strm_{ULID}_user_{base64(namespace)?}`
+ */
+export function getWorkflowRunStreamId(runId, namespace) {
+    const streamId = `${runId.replace('wrun_', 'strm_')}_user`;
+    if (!namespace) {
+        return streamId;
+    }
+    // Base64 encode the namespace to handle special characters that may not be allowed in Redis keys
+    const encodedNamespace = Buffer.from(namespace, 'utf-8').toString('base64url');
+    return `${streamId}_${encodedNamespace}`;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAA4B,CAAC;IACjC,IAAI,MAA+B,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QACnD,OAAO,GAAG,QAAQ,CAAC;QACnB,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAI,EAAW;IACjC,MAAM,MAAM,GAAG;QACb,IAAI,KAAK;YACP,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAa,EACb,SAAiB,EACjB,SAAiB;IAEjB,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,IAAI,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,IAAI,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,SAAS,GACb,SAAS,GAAG,CAAC;QACX,CAAC,CAAC,2CAA2C;QAC7C,CAAC,CAAC,mBAAmB,CAAC;IAE1B,OAAO,gBAAgB,KAAK,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,4DAA4D,SAAS,EAAE,CAAC;AAChI,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,SAAkB;IACtE,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,iGAAiG;IACjG,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,CAC/D,WAAW,CACZ,CAAC;IACF,OAAO,GAAG,QAAQ,IAAI,gBAAgB,EAAE,CAAC;AAC3C,CAAC"}

package/dist/vm/index.d.ts

@@ -0,0 +1,17 @@
+export interface CreateContextOptions {
+    seed: string;
+    fixedTimestamp: number;
+}
+/**
+ * Creates a Node.js `vm.Context` configured to be usable for
+ * executing workflow logic in a deterministic environment.
+ *
+ * @param options - The options for the context.
+ * @returns The context.
+ */
+export declare function createContext(options: CreateContextOptions): {
+    context: import("vm").Context;
+    globalThis: typeof globalThis;
+    updateTimestamp: (timestamp: number) => void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/vm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vm/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB;;;iCA0F1B,MAAM;EAItC"}

package/dist/vm/index.js

@@ -0,0 +1,93 @@
+import { runInContext, createContext as vmCreateContext } from 'node:vm';
+import seedrandom from 'seedrandom';
+import { createRandomUUID } from './uuid.js';
+/**
+ * Creates a Node.js `vm.Context` configured to be usable for
+ * executing workflow logic in a deterministic environment.
+ *
+ * @param options - The options for the context.
+ * @returns The context.
+ */
+export function createContext(options) {
+    let { fixedTimestamp } = options;
+    const { seed } = options;
+    const rng = seedrandom(seed);
+    const context = vmCreateContext();
+    const g = runInContext('globalThis', context);
+    // Deterministic `Math.random()`
+    g.Math.random = rng;
+    // Override `Date` constructor to return fixed time when called without arguments
+    const Date_ = g.Date;
+    // biome-ignore lint/suspicious/noShadowRestrictedNames: We're shadowing the global `Date` property to make it deterministic.
+    g.Date = function Date(...args) {
+        if (args.length === 0) {
+            return new Date_(fixedTimestamp);
+        }
+        // @ts-expect-error - Args is `Date` constructor arguments
+        return new Date_(...args);
+    };
+    g.Date.prototype = Date_.prototype;
+    // Preserve static methods
+    Object.setPrototypeOf(g.Date, Date_);
+    g.Date.now = () => fixedTimestamp;
+    // Deterministic `crypto` using Proxy to avoid mutating global objects
+    const originalCrypto = globalThis.crypto;
+    const originalSubtle = originalCrypto.subtle;
+    function getRandomValues(array) {
+        for (let i = 0; i < array.length; i++) {
+            array[i] = Math.floor(rng() * 256);
+        }
+        return array;
+    }
+    const randomUUID = createRandomUUID(rng);
+    const boundDigest = originalSubtle.digest.bind(originalSubtle);
+    g.crypto = new Proxy(originalCrypto, {
+        get(target, prop) {
+            if (prop === 'getRandomValues') {
+                return getRandomValues;
+            }
+            if (prop === 'randomUUID') {
+                return randomUUID;
+            }
+            if (prop === 'subtle') {
+                return new Proxy(originalSubtle, {
+                    get(target, prop) {
+                        if (prop === 'generateKey') {
+                            return () => {
+                                throw new Error('Not implemented');
+                            };
+                        }
+                        else if (prop === 'digest') {
+                            return boundDigest;
+                        }
+                        return target[prop];
+                    },
+                });
+            }
+            return target[prop];
+        },
+    });
+    // Propagate environment variables
+    g.process = {
+        env: process.env,
+    };
+    // Stateless + synchronous Web APIs that are made available inside the sandbox
+    g.Headers = globalThis.Headers;
+    g.TextEncoder = globalThis.TextEncoder;
+    g.TextDecoder = globalThis.TextDecoder;
+    g.console = globalThis.console;
+    g.URL = globalThis.URL;
+    g.URLSearchParams = globalThis.URLSearchParams;
+    g.structuredClone = globalThis.structuredClone;
+    // HACK: Shim `exports` for the bundle
+    g.exports = {};
+    g.module = { exports: g.exports };
+    return {
+        context,
+        globalThis: g,
+        updateTimestamp: (timestamp) => {
+            fixedTimestamp = timestamp;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/vm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,IAAI,eAAe,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAQ7C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAElC,MAAM,CAAC,GAAsB,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEjE,gCAAgC;IAChC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IAEpB,iFAAiF;IACjF,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;IACrB,6HAA6H;IAC5H,CAAS,CAAC,IAAI,GAAG,SAAS,IAAI,CAC7B,GAAG,IAA+C;QAElD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACnC,CAAC;QACD,0DAA0D;QAC1D,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;IACD,CAAS,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAC5C,0BAA0B;IAC1B,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC;IAElC,sEAAsE;IACtE,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IACzC,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC;IAE7C,SAAS,eAAe,CAAC,KAAiB;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEzC,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE/D,CAAC,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,cAAc,EAAE;QACnC,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC/B,OAAO,eAAe,CAAC;YACzB,CAAC;YACD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1B,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE;oBAC/B,GAAG,CAAC,MAAM,EAAE,IAAI;wBACd,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;4BAC3B,OAAO,GAAG,EAAE;gCACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;4BACrC,CAAC,CAAC;wBACJ,CAAC;6BAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC7B,OAAO,WAAW,CAAC;wBACrB,CAAC;wBACD,OAAO,MAAM,CAAC,IAAmC,CAAC,CAAC;oBACrD,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC,IAAmC,CAAC,CAAC;QACrD,CAAC;KACF,CAAC,CAAC;IAEH,kCAAkC;IACjC,CAAS,CAAC,OAAO,GAAG;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;IAEF,8EAA8E;IAC9E,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IAC/B,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IACvC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IACvC,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IAC/B,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;IACvB,CAAC,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;IAC/C,CAAC,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;IAE/C,sCAAsC;IACtC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC;IACd,CAAS,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAE3C,OAAO;QACL,OAAO;QACP,UAAU,EAAE,CAAC;QACb,eAAe,EAAE,CAAC,SAAiB,EAAE,EAAE;YACrC,cAAc,GAAG,SAAS,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/vm/uuid.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns a function that generates a random UUID, based on the given RNG.
+ *
+ * `rng` is expected to be a seeded random number generator (i.e. `seedrandom.PRNG` instance).
+ *
+ * @param rng - A function that returns a random number between 0 and 1.
+ * @returns A `crypto.randomUUID`-like function.
+ */
+export declare function createRandomUUID(rng: () => number): () => ReturnType<typeof crypto.randomUUID>;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/vm/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/vm/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,MAAM,SAClB,UAAU,CAAC,OAAO,MAAM,CAAC,UAAU,CAAC,CAgBnE"}

package/dist/vm/uuid.js

@@ -0,0 +1,30 @@
+/**
+ * Returns a function that generates a random UUID, based on the given RNG.
+ *
+ * `rng` is expected to be a seeded random number generator (i.e. `seedrandom.PRNG` instance).
+ *
+ * @param rng - A function that returns a random number between 0 and 1.
+ * @returns A `crypto.randomUUID`-like function.
+ */
+export function createRandomUUID(rng) {
+    return function randomUUID() {
+        const chars = '0123456789abcdef';
+        let uuid = '';
+        for (let i = 0; i < 36; i++) {
+            if (i === 8 || i === 13 || i === 18 || i === 23) {
+                uuid += '-';
+            }
+            else if (i === 14) {
+                uuid += '4'; // Version 4 UUID
+            }
+            else if (i === 19) {
+                uuid += chars[Math.floor(rng() * 4) + 8]; // 8, 9, a, or b
+            }
+            else {
+                uuid += chars[Math.floor(rng() * 16)];
+            }
+        }
+        return uuid;
+    };
+}
+//# sourceMappingURL=uuid.js.map

package/dist/vm/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/vm/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,OAAO,SAAS,UAAU;QACxB,MAAM,KAAK,GAAG,kBAAkB,CAAC;QACjC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBAChD,IAAI,IAAI,GAAG,CAAC;YACd,CAAC;iBAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACpB,IAAI,IAAI,GAAG,CAAC,CAAC,iBAAiB;YAChC,CAAC;iBAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACpB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB;YAC5D,CAAC;iBAAM,CAAC;gBACN,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,IAA4C,CAAC;IACtD,CAAC,CAAC;AACJ,CAAC"}

package/dist/workflow/create-hook.d.ts

@@ -0,0 +1,7 @@
+import type { Hook, HookOptions, RequestWithResponse, Webhook, WebhookOptions } from '../create-hook.js';
+export declare function createHook<T = any>(options?: HookOptions): Hook<T>;
+export declare function createWebhook(options: WebhookOptions & {
+    respondWith: 'manual';
+}): Webhook<RequestWithResponse>;
+export declare function createWebhook(options?: WebhookOptions): Webhook<Request>;
+//# sourceMappingURL=create-hook.d.ts.map

package/dist/workflow/create-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-hook.d.ts","sourceRoot":"","sources":["../../src/workflow/create-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,OAAO,EACP,cAAc,EACf,MAAM,mBAAmB,CAAC;AAI3B,wBAAgB,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAWlE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,GAAG;IAAE,WAAW,EAAE,QAAQ,CAAA;CAAE,GAClD,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAChC,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/workflow/create-hook.js

@@ -0,0 +1,22 @@
+import { WORKFLOW_CREATE_HOOK } from '../symbols.js';
+import { getWorkflowMetadata } from './get-workflow-metadata.js';
+export function createHook(options) {
+    // Inside the workflow VM, the hook function is stored in the globalThis object behind a symbol
+    const createHookFn = globalThis[WORKFLOW_CREATE_HOOK];
+    if (!createHookFn) {
+        throw new Error('`createHook()` can only be called inside a workflow function');
+    }
+    return createHookFn(options);
+}
+export function createWebhook(options) {
+    const { respondWith, ...rest } = options ?? {};
+    let metadata;
+    if (typeof respondWith !== 'undefined') {
+        metadata = { respondWith };
+    }
+    const hook = createHook({ ...rest, metadata });
+    const { url } = getWorkflowMetadata();
+    hook.url = `${url}/.well-known/workflow/v1/webhook/${encodeURIComponent(hook.token)}`;
+    return hook;
+}
+//# sourceMappingURL=create-hook.js.map

package/dist/workflow/create-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-hook.js","sourceRoot":"","sources":["../../src/workflow/create-hook.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,UAAU,UAAU,CAAU,OAAqB;IACvD,+FAA+F;IAC/F,MAAM,YAAY,GAAI,UAAkB,CACtC,oBAAoB,CACG,CAAC;IAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAMD,MAAM,UAAU,aAAa,CAC3B,OAAwB;IAExB,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/C,IAAI,QAAyD,CAAC;IAC9D,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;QACvC,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAEb,CAAC;IAEjC,MAAM,EAAE,GAAG,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACtC,IAAI,CAAC,GAAG,GAAG,GAAG,GAAG,oCAAoC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAEtF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/workflow/define-hook.d.ts

@@ -0,0 +1,10 @@
+import type { Hook as HookEntity } from '@workflow/world';
+import type { Hook, HookOptions } from '../create-hook.js';
+/**
+ * NOTE: This is the implementation of `defineHook()` that is used in workflow contexts.
+ */
+export declare function defineHook<T>(): {
+    create(options?: HookOptions): Hook<T>;
+    resume(_token: string, _payload: T): Promise<HookEntity | null>;
+};
+//# sourceMappingURL=define-hook.d.ts.map

package/dist/workflow/define-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-hook.d.ts","sourceRoot":"","sources":["../../src/workflow/define-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG3D;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC;qBAEP,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;mBAIvB,MAAM,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;EAMlE"}

package/dist/workflow/define-hook.js

@@ -0,0 +1,15 @@
+import { createHook } from './create-hook.js';
+/**
+ * NOTE: This is the implementation of `defineHook()` that is used in workflow contexts.
+ */
+export function defineHook() {
+    return {
+        create(options) {
+            return createHook(options);
+        },
+        resume(_token, _payload) {
+            throw new Error('`defineHook().resume()` can only be called from external contexts (e.g. API routes).');
+        },
+    };
+}
+//# sourceMappingURL=define-hook.js.map

package/dist/workflow/define-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-hook.js","sourceRoot":"","sources":["../../src/workflow/define-hook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,CAAC,OAAqB;YAC1B,OAAO,UAAU,CAAI,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,CAAC,MAAc,EAAE,QAAW;YAChC,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/workflow/get-workflow-metadata.d.ts

@@ -0,0 +1,17 @@
+export interface WorkflowMetadata {
+    /**
+     * Unique identifier for the workflow run.
+     */
+    workflowRunId: string;
+    /**
+     * Timestamp when the workflow run started.
+     */
+    workflowStartedAt: Date;
+    /**
+     * The URL where the workflow can be triggered.
+     */
+    url: string;
+}
+export declare const WORKFLOW_CONTEXT_SYMBOL: unique symbol;
+export declare function getWorkflowMetadata(): WorkflowMetadata;
+//# sourceMappingURL=get-workflow-metadata.d.ts.map

package/dist/workflow/get-workflow-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-workflow-metadata.d.ts","sourceRoot":"","sources":["../../src/workflow/get-workflow-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,iBAAiB,EAAE,IAAI,CAAC;IAExB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,uBAAuB,eACY,CAAC;AAEjD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAStD"}

package/dist/workflow/get-workflow-metadata.js

@@ -0,0 +1,11 @@
+export const WORKFLOW_CONTEXT_SYMBOL = 
+/* @__PURE__ */ Symbol.for('WORKFLOW_CONTEXT');
+export function getWorkflowMetadata() {
+    // Inside the workflow VM, the context is stored in the globalThis object behind a symbol
+    const ctx = globalThis[WORKFLOW_CONTEXT_SYMBOL];
+    if (!ctx) {
+        throw new Error('`getWorkflowMetadata()` can only be called inside a workflow or step function');
+    }
+    return ctx;
+}
+//# sourceMappingURL=get-workflow-metadata.js.map

package/dist/workflow/get-workflow-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-workflow-metadata.js","sourceRoot":"","sources":["../../src/workflow/get-workflow-metadata.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,uBAAuB;AAClC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAEjD,MAAM,UAAU,mBAAmB;IACjC,yFAAyF;IACzF,MAAM,GAAG,GAAI,UAAkB,CAAC,uBAAuB,CAAqB,CAAC;IAC7E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/workflow/hook.d.ts

@@ -0,0 +1,4 @@
+import type { Hook, HookOptions } from '../create-hook.js';
+import type { WorkflowOrchestratorContext } from '../private.js';
+export declare function createCreateHook(ctx: WorkflowOrchestratorContext): <T = any>(options?: HookOptions) => Hook<T>;
+//# sourceMappingURL=hook.d.ts.map