@lotiai/composer 0.2.0 → 0.2.2

package/dist/internal/async/schedule/sync-schedules.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Schedule Synchronization
+ *
+ * Declaratively reconciles Temporal schedules with schedule definitions.
+ * The set of definitions passed in is the source of truth -- schedules
+ * are created, updated, or deleted to match.
+ *
+ * Ownership is tracked via a `managedBy: "composer"` memo on each schedule.
+ * Schedules without this memo (manually created or from other systems) are
+ * never touched.
+ *
+ * @module sync-schedules
+ */
+import type { ComposerLogger } from "../../types";
+import type { ScheduleDefinition } from "./define-schedule";
+/**
+ * Configuration for connecting to Temporal for schedule sync.
+ */
+export interface TemporalScheduleConfig {
+    /** Temporal server address (e.g., "localhost:7233") */
+    address: string;
+    /** Temporal namespace (e.g., "default") */
+    namespace: string;
+}
+/**
+ * Configuration for syncing schedules.
+ */
+export interface SyncSchedulesConfig {
+    /** Temporal connection config */
+    temporalConfig: TemporalScheduleConfig;
+    /** Schedule definitions to sync (source of truth) */
+    schedules: ScheduleDefinition[];
+    /**
+     * If true, log what would happen without making changes.
+     * @default false
+     */
+    dryRun?: boolean;
+    /** Logger for sync progress */
+    logger?: ComposerLogger;
+}
+/**
+ * Result of a schedule sync operation.
+ */
+export interface SyncSchedulesResult {
+    /** Schedules that were created */
+    created: string[];
+    /** Schedules that were updated */
+    updated: string[];
+    /** Schedules that were deleted (no longer in definitions) */
+    deleted: string[];
+    /** Schedules that failed to sync */
+    errors: Array<{
+        scheduleId: string;
+        error: string;
+    }>;
+}
+/**
+ * Declaratively synchronizes schedule definitions to the Temporal server.
+ *
+ * This function:
+ * 1. Lists all existing schedules with the `managedBy: "composer"` memo
+ * 2. Creates schedules that exist in definitions but not on the server
+ * 3. Updates schedules that exist in both (applies latest spec, versioned workflow name, policies)
+ * 4. Deletes composer-managed schedules that are no longer in the definitions
+ *
+ * Non-composer schedules are never touched.
+ *
+ * @returns Summary of what was created, updated, and deleted
+ */
+export declare function syncSchedules(config: SyncSchedulesConfig): Promise<SyncSchedulesResult>;
+//# sourceMappingURL=sync-schedules.d.ts.map

package/dist/internal/async/schedule/sync-schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schedules.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/schedule/sync-schedules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,cAAc,EAAE,sBAAsB,CAAC;IAEvC,qDAAqD;IACrD,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAyCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqG7F"}

package/dist/internal/async/schedule/sync-schedules.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Schedule Synchronization
+ *
+ * Declaratively reconciles Temporal schedules with schedule definitions.
+ * The set of definitions passed in is the source of truth -- schedules
+ * are created, updated, or deleted to match.
+ *
+ * Ownership is tracked via a `managedBy: "composer"` memo on each schedule.
+ * Schedules without this memo (manually created or from other systems) are
+ * never touched.
+ *
+ * @module sync-schedules
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncSchedules = syncSchedules;
+const client_1 = require("@temporalio/client");
+const defaults_1 = require("../../defaults");
+const constants_1 = require("./constants");
+/**
+ * Checks if a schedule summary was created by composer (has the managed-by memo).
+ */
+function isComposerManaged(summary) {
+    return summary.memo?.[constants_1.MANAGED_BY_MEMO_KEY] === constants_1.MANAGED_BY_MEMO_VALUE;
+}
+/**
+ * Builds the Temporal ScheduleOptions from a ScheduleDefinition.
+ */
+function buildScheduleOptions(definition) {
+    const mergedInitialData = {
+        ...definition.initialData,
+        ...definition.configuredValues,
+    };
+    return {
+        scheduleId: definition.scheduleId,
+        spec: definition.spec,
+        action: {
+            type: "startWorkflow",
+            workflowType: definition.workflowName,
+            taskQueue: definition.taskQueue,
+            args: [{ initialData: mergedInitialData }],
+        },
+        policies: {
+            overlap: definition.overlap,
+            ...(definition.catchupWindow != null ? { catchupWindow: definition.catchupWindow } : {}),
+        },
+        state: {
+            paused: definition.paused,
+            note: definition.note,
+        },
+        memo: {
+            [constants_1.MANAGED_BY_MEMO_KEY]: constants_1.MANAGED_BY_MEMO_VALUE,
+        },
+    };
+}
+/**
+ * Declaratively synchronizes schedule definitions to the Temporal server.
+ *
+ * This function:
+ * 1. Lists all existing schedules with the `managedBy: "composer"` memo
+ * 2. Creates schedules that exist in definitions but not on the server
+ * 3. Updates schedules that exist in both (applies latest spec, versioned workflow name, policies)
+ * 4. Deletes composer-managed schedules that are no longer in the definitions
+ *
+ * Non-composer schedules are never touched.
+ *
+ * @returns Summary of what was created, updated, and deleted
+ */
+async function syncSchedules(config) {
+    const { temporalConfig, schedules, dryRun = false } = config;
+    const logger = config.logger ?? defaults_1.defaultLogger;
+    const result = {
+        created: [],
+        updated: [],
+        deleted: [],
+        errors: [],
+    };
+    const connection = await client_1.Connection.connect({ address: temporalConfig.address });
+    try {
+        const client = new client_1.Client({ connection, namespace: temporalConfig.namespace });
+        // Collect all composer-managed schedules currently on the server
+        const existingManagedIds = new Set();
+        for await (const summary of client.schedule.list()) {
+            if (isComposerManaged(summary)) {
+                existingManagedIds.add(summary.scheduleId);
+            }
+        }
+        // Build lookup of declared schedule IDs
+        const declaredIds = new Set(schedules.map((s) => s.scheduleId));
+        // Validate no duplicate schedule IDs in definitions
+        if (declaredIds.size !== schedules.length) {
+            const seen = new Set();
+            for (const s of schedules) {
+                if (seen.has(s.scheduleId)) {
+                    throw new Error(`Duplicate scheduleId "${s.scheduleId}" found in schedule definitions`);
+                }
+                seen.add(s.scheduleId);
+            }
+        }
+        // Create or update each declared schedule
+        for (const definition of schedules) {
+            const { scheduleId } = definition;
+            const exists = existingManagedIds.has(scheduleId);
+            try {
+                if (exists) {
+                    if (dryRun) {
+                        logger.info("[dry-run] Would update schedule", { scheduleId });
+                    }
+                    else {
+                        await updateSchedule(client, definition, logger);
+                    }
+                    result.updated.push(scheduleId);
+                }
+                else {
+                    if (dryRun) {
+                        logger.info("[dry-run] Would create schedule", { scheduleId });
+                    }
+                    else {
+                        await createSchedule(client, definition, logger);
+                    }
+                    result.created.push(scheduleId);
+                }
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                logger.error("Failed to sync schedule", { scheduleId, error: errorMessage });
+                result.errors.push({ scheduleId, error: errorMessage });
+            }
+        }
+        // Delete composer-managed schedules that are no longer declared
+        for (const existingId of existingManagedIds) {
+            if (!declaredIds.has(existingId)) {
+                try {
+                    if (dryRun) {
+                        logger.info("[dry-run] Would delete schedule", { scheduleId: existingId });
+                    }
+                    else {
+                        const handle = client.schedule.getHandle(existingId);
+                        await handle.delete();
+                        logger.info("Deleted schedule", { scheduleId: existingId });
+                    }
+                    result.deleted.push(existingId);
+                }
+                catch (err) {
+                    const errorMessage = err instanceof Error ? err.message : String(err);
+                    logger.error("Failed to delete schedule", {
+                        scheduleId: existingId,
+                        error: errorMessage,
+                    });
+                    result.errors.push({ scheduleId: existingId, error: errorMessage });
+                }
+            }
+        }
+        // Summary
+        logger.info("Schedule sync complete", {
+            dryRun,
+            created: result.created.length,
+            updated: result.updated.length,
+            deleted: result.deleted.length,
+            errors: result.errors.length,
+        });
+        return result;
+    }
+    finally {
+        await connection.close();
+    }
+}
+/**
+ * Creates a new schedule on the Temporal server.
+ *
+ * If the schedule already exists (race condition), falls back to update.
+ */
+async function createSchedule(client, definition, logger) {
+    const options = buildScheduleOptions(definition);
+    try {
+        await client.schedule.create(options);
+        logger.info("Created schedule", {
+            scheduleId: definition.scheduleId,
+            workflowType: options.action.workflowType,
+        });
+    }
+    catch (err) {
+        if (err instanceof client_1.ScheduleAlreadyRunning) {
+            const handle = client.schedule.getHandle(definition.scheduleId);
+            const desc = await handle.describe();
+            if (desc.memo?.[constants_1.MANAGED_BY_MEMO_KEY] !== constants_1.MANAGED_BY_MEMO_VALUE) {
+                throw new Error(`Schedule "${definition.scheduleId}" already exists but is not managed by composer. ` +
+                    `Refusing to overwrite. Delete or rename the existing schedule to resolve this conflict.`);
+            }
+            logger.info("Schedule already exists (race condition), updating instead", {
+                scheduleId: definition.scheduleId,
+            });
+            await updateSchedule(client, definition, logger);
+        }
+        else {
+            throw err;
+        }
+    }
+}
+/**
+ * Updates an existing schedule on the Temporal server.
+ */
+async function updateSchedule(client, definition, logger) {
+    const handle = client.schedule.getHandle(definition.scheduleId);
+    const mergedInitialData = {
+        ...definition.initialData,
+        ...definition.configuredValues,
+    };
+    await handle.update((_previous) => ({
+        spec: definition.spec,
+        action: {
+            type: "startWorkflow",
+            workflowType: definition.workflowName,
+            taskQueue: definition.taskQueue,
+            args: [{ initialData: mergedInitialData }],
+        },
+        policies: {
+            overlap: definition.overlap,
+            ...(definition.catchupWindow != null ? { catchupWindow: definition.catchupWindow } : {}),
+        },
+        state: {
+            paused: definition.paused,
+            note: definition.note,
+        },
+    }));
+    logger.info("Updated schedule", {
+        scheduleId: definition.scheduleId,
+        workflowType: definition.workflowName,
+    });
+}
+//# sourceMappingURL=sync-schedules.js.map

package/dist/internal/async/schedule/sync-schedules.js.map

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

package/dist/internal/async/utils/ensure-namespace.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Ensures the Temporal namespace exists before workers start.
+ * This is idempotent - safe to call multiple times.
+ *
+ * @module ensure-namespace
+ */
+/**
+ * Ensures the specified namespace exists on the Temporal server.
+ * Creates it if it doesn't exist. This operation is idempotent.
+ *
+ * @param address - Temporal server address
+ * @param namespace - Namespace name to ensure exists
+ * @param retentionDays - Workflow history retention period (default: 90 days for production)
+ */
+export declare function ensureNamespaceExists(address: string, namespace: string, retentionDays?: number): Promise<void>;
+//# sourceMappingURL=ensure-namespace.d.ts.map

package/dist/internal/async/utils/ensure-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-namespace.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/utils/ensure-namespace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAW,GACzB,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/internal/async/utils/ensure-namespace.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Ensures the Temporal namespace exists before workers start.
+ * This is idempotent - safe to call multiple times.
+ *
+ * @module ensure-namespace
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureNamespaceExists = ensureNamespaceExists;
+const client_1 = require("@temporalio/client");
+const long_1 = __importDefault(require("long"));
+/**
+ * Ensures the specified namespace exists on the Temporal server.
+ * Creates it if it doesn't exist. This operation is idempotent.
+ *
+ * @param address - Temporal server address
+ * @param namespace - Namespace name to ensure exists
+ * @param retentionDays - Workflow history retention period (default: 90 days for production)
+ */
+async function ensureNamespaceExists(address, namespace, retentionDays = 90) {
+    const connection = await client_1.Connection.connect({ address });
+    try {
+        // Check if namespace exists by trying to describe it
+        await connection.workflowService.describeNamespace({ namespace });
+        console.log(`Namespace "${namespace}" already exists`);
+    }
+    catch (error) {
+        const grpcError = error;
+        // gRPC NOT_FOUND code = 5
+        if (grpcError.code === 5) {
+            console.log(`Creating namespace "${namespace}"...`);
+            const retentionSeconds = retentionDays * 24 * 60 * 60;
+            try {
+                await connection.workflowService.registerNamespace({
+                    namespace,
+                    workflowExecutionRetentionPeriod: {
+                        seconds: long_1.default.fromNumber(retentionSeconds),
+                    },
+                });
+                console.log(`Namespace "${namespace}" created successfully`);
+            }
+            catch (registerError) {
+                const registerGrpcError = registerError;
+                // gRPC ALREADY_EXISTS code = 6 - another process won the race, namespace exists now
+                if (registerGrpcError.code === 6) {
+                    console.log(`Namespace "${namespace}" was created by another process`);
+                }
+                else {
+                    throw registerError;
+                }
+            }
+        }
+        else {
+            throw error;
+        }
+    }
+    finally {
+        await connection.close();
+    }
+}
+//# sourceMappingURL=ensure-namespace.js.map

package/dist/internal/async/utils/ensure-namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-namespace.js","sourceRoot":"","sources":["../../../../src/internal/async/utils/ensure-namespace.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAaH,sDAyCC;AApDD,+CAAgD;AAChD,gDAAwB;AAExB;;;;;;;GAOG;AACI,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,SAAiB,EACjB,gBAAwB,EAAE;IAE1B,MAAM,UAAU,GAAG,MAAM,mBAAU,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,qDAAqD;QACrD,MAAM,UAAU,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,KAA4C,CAAC;QAE/D,0BAA0B;QAC1B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,MAAM,CAAC,CAAC;YACpD,MAAM,gBAAgB,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,eAAe,CAAC,iBAAiB,CAAC;oBACjD,SAAS;oBACT,gCAAgC,EAAE;wBAChC,OAAO,EAAE,cAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;qBAC3C;iBACF,CAAC,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,wBAAwB,CAAC,CAAC;YAC/D,CAAC;YAAC,OAAO,aAAsB,EAAE,CAAC;gBAChC,MAAM,iBAAiB,GAAG,aAAkC,CAAC;gBAC7D,oFAAoF;gBACpF,IAAI,iBAAiB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACjC,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,kCAAkC,CAAC,CAAC;gBACzE,CAAC;qBAAM,CAAC;oBACN,MAAM,aAAa,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/internal/async/utils/find-package-root.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Find the package root by searching upward for package.json.
+ *
+ * @param startDir - Directory to start searching from (typically __dirname)
+ * @returns Absolute path to the package root directory
+ * @throws Error if package.json cannot be found
+ */
+export declare function findPackageRoot(startDir: string): string;
+//# sourceMappingURL=find-package-root.d.ts.map

package/dist/internal/async/utils/find-package-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-package-root.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/utils/find-package-root.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBxD"}

package/dist/internal/async/utils/find-package-root.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPackageRoot = findPackageRoot;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Find the package root by searching upward for package.json.
+ *
+ * @param startDir - Directory to start searching from (typically __dirname)
+ * @returns Absolute path to the package root directory
+ * @throws Error if package.json cannot be found
+ */
+function findPackageRoot(startDir) {
+    let currentDir = (0, node_path_1.resolve)(startDir);
+    while (true) {
+        const packageJsonPath = (0, node_path_1.join)(currentDir, "package.json");
+        if ((0, node_fs_1.existsSync)(packageJsonPath)) {
+            return currentDir;
+        }
+        const parentDir = (0, node_path_1.resolve)(currentDir, "..");
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    throw new Error(`Could not find package.json searching up from ${startDir}`);
+}
+//# sourceMappingURL=find-package-root.js.map

package/dist/internal/async/utils/find-package-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-package-root.js","sourceRoot":"","sources":["../../../../src/internal/async/utils/find-package-root.ts"],"names":[],"mappings":";;AAUA,0CAiBC;AA3BD,qCAAqC;AACrC,yCAA0C;AAE1C;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,QAAgB;IAC9C,IAAI,UAAU,GAAG,IAAA,mBAAO,EAAC,QAAQ,CAAC,CAAC;IAEnC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACzD,IAAI,IAAA,oBAAU,EAAC,eAAe,CAAC,EAAE,CAAC;YAChC,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iDAAiD,QAAQ,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/internal/async/utils/is-composer-error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Duck-type check for structured errors with a code and parent code chain.
+ *
+ * Used to detect errors carrying a stable string code (from any error factory
+ * that follows the {code, parentCodes} convention) so they can be converted to
+ * a Temporal ApplicationFailure with the code preserved across the activity
+ * boundary, where instanceof would not work.
+ */
+export interface ComposerErrorInstance extends Error {
+    readonly code: string;
+    readonly parentCodes: readonly string[];
+}
+export declare function isComposerError(error: unknown): error is ComposerErrorInstance;
+//# sourceMappingURL=is-composer-error.d.ts.map

package/dist/internal/async/utils/is-composer-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-composer-error.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/utils/is-composer-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,qBAAsB,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAM9E"}

package/dist/internal/async/utils/is-composer-error.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Duck-type check for structured errors with a code and parent code chain.
+ *
+ * Used to detect errors carrying a stable string code (from any error factory
+ * that follows the {code, parentCodes} convention) so they can be converted to
+ * a Temporal ApplicationFailure with the code preserved across the activity
+ * boundary, where instanceof would not work.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isComposerError = isComposerError;
+function isComposerError(error) {
+    return (error instanceof Error &&
+        typeof error.code === "string" &&
+        Array.isArray(error.parentCodes));
+}
+//# sourceMappingURL=is-composer-error.js.map

package/dist/internal/async/utils/is-composer-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-composer-error.js","sourceRoot":"","sources":["../../../../src/internal/async/utils/is-composer-error.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAOH,0CAMC;AAND,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QACtD,KAAK,CAAC,OAAO,CAAE,KAAmC,CAAC,WAAW,CAAC,CAChE,CAAC;AACJ,CAAC"}