@lotiai/composer 0.2.0 → 0.2.1

package/dist/internal/async/register-scripts/sync-schedules.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Run Schedule Sync
+ *
+ * Generic framework function that syncs a list of `ScheduleDefinition`s to the
+ * Temporal server configured on a Composer instance. Mirrors the shape of
+ * `startActivityWorker` / `startWorkflowWorker`: the caller supplies the
+ * schedules explicitly (no directory scanning), and this wrapper handles the
+ * cross-cutting concerns -- current-environment filtering, `DRY_RUN` env var,
+ * structured logging, and non-zero exit on sync errors.
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { runScheduleSync } from "@lotiai/composer";
+ * import { composer } from "./my-app-composer";
+ * import * as schedules from "./schedules";
+ *
+ * await runScheduleSync(composer, {
+ *   schedules: Object.values(schedules).filter(isScheduleDefinition),
+ * });
+ * ```
+ *
+ * @module sync-schedules
+ */
+import type { Composer } from "../../context-provider";
+import type { ScheduleDefinition } from "../schedule/define-schedule";
+/**
+ * Options for `runScheduleSync`.
+ */
+export interface SyncScheduleScriptOptions {
+    /**
+     * Schedule definitions to reconcile against the Temporal server.
+     * The caller is responsible for discovering these (typically by filtering a
+     * schedules barrel export with `isScheduleDefinition`).
+     */
+    schedules: ScheduleDefinition[];
+    /**
+     * Name of the current environment (e.g. "prod"). Used to filter schedules
+     * that declare an `environments` allowlist.
+     *
+     * @default process.env.ENVIRONMENT_NAME
+     */
+    currentEnvironment?: string | null;
+    /**
+     * If true, log what would happen without making changes on the server.
+     *
+     * @default process.env.COMPOSER_SCHEDULE_SYNC_DRY_RUN === "true"
+     */
+    dryRun?: boolean;
+}
+/**
+ * Reconciles composer-managed Temporal schedules with the supplied list using
+ * the Composer's configured Temporal connection.
+ *
+ * This function:
+ * 1. Resolves the current environment (options or `ENVIRONMENT_NAME`) and
+ *    dry-run flag (options or `DRY_RUN`).
+ * 2. Filters schedules by their `environments` allowlist.
+ * 3. Logs the resolved configuration and any skipped schedules.
+ * 4. Delegates to `composer.syncSchedules()` for the actual reconciliation.
+ * 5. Logs a create/update/delete summary.
+ * 6. Exits with code 1 if any schedule failed to sync.
+ *
+ * @param composer - Composer instance providing the Temporal connection + logger
+ * @param options - Schedules, current environment, and dry-run flag
+ */
+export declare function runScheduleSync<TContext>(composer: Composer<TContext>, options: SyncScheduleScriptOptions): Promise<void>;
+//# sourceMappingURL=sync-schedules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schedules.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/register-scripts/sync-schedules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAC5C,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAqEf"}

package/dist/internal/async/register-scripts/sync-schedules.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScheduleSync = runScheduleSync;
+/**
+ * Reconciles composer-managed Temporal schedules with the supplied list using
+ * the Composer's configured Temporal connection.
+ *
+ * This function:
+ * 1. Resolves the current environment (options or `ENVIRONMENT_NAME`) and
+ *    dry-run flag (options or `DRY_RUN`).
+ * 2. Filters schedules by their `environments` allowlist.
+ * 3. Logs the resolved configuration and any skipped schedules.
+ * 4. Delegates to `composer.syncSchedules()` for the actual reconciliation.
+ * 5. Logs a create/update/delete summary.
+ * 6. Exits with code 1 if any schedule failed to sync.
+ *
+ * @param composer - Composer instance providing the Temporal connection + logger
+ * @param options - Schedules, current environment, and dry-run flag
+ */
+async function runScheduleSync(composer, options) {
+    const logger = composer.logger;
+    const { serverAddress, namespace } = composer.temporal;
+    const currentEnvironment = options.currentEnvironment ?? process.env.ENVIRONMENT_NAME ?? null;
+    const dryRun = options.dryRun ?? process.env.COMPOSER_SCHEDULE_SYNC_DRY_RUN === "true";
+    if (currentEnvironment === null && options.schedules.length > 0) {
+        logger.error("Cannot sync schedules: no current environment was provided", {
+            hint: "Set ENVIRONMENT_NAME or pass options.currentEnvironment to runScheduleSync",
+            scheduleCount: options.schedules.length,
+        });
+        process.exit(1);
+    }
+    const activeSchedules = [];
+    const skippedSchedules = [];
+    for (const schedule of options.schedules) {
+        if (currentEnvironment !== null && schedule.environments.includes(currentEnvironment)) {
+            activeSchedules.push(schedule);
+        }
+        else {
+            skippedSchedules.push({
+                scheduleId: schedule.scheduleId,
+                environments: schedule.environments,
+            });
+        }
+    }
+    logger.info("Syncing Temporal schedules", {
+        serverAddress,
+        namespace,
+        currentEnvironment,
+        dryRun,
+        active: activeSchedules.length,
+        skipped: skippedSchedules.length,
+    });
+    for (const { scheduleId, environments } of skippedSchedules) {
+        logger.debug("Skipping schedule (not active in current environment)", {
+            scheduleId,
+            environments,
+            currentEnvironment,
+        });
+    }
+    try {
+        const result = await composer.syncSchedules(activeSchedules, { dryRun });
+        logger.info("Schedule sync complete", {
+            dryRun,
+            created: result.created.length,
+            updated: result.updated.length,
+            deleted: result.deleted.length,
+            errors: result.errors.length,
+        });
+        if (result.errors.length > 0) {
+            for (const { scheduleId, error } of result.errors) {
+                logger.error("Schedule failed to sync", { scheduleId, error });
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        logger.error("Failed to sync Temporal schedules", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=sync-schedules.js.map

package/dist/internal/async/register-scripts/sync-schedules.js.map

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

package/dist/internal/async/schedule/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Memo key and value used to tag schedules managed by composer.
+ *
+ * During sync, only schedules with this memo are considered for update
+ * or deletion. Schedules without it (manually created or from other
+ * systems) are never touched.
+ */
+export declare const MANAGED_BY_MEMO_KEY = "managedBy";
+export declare const MANAGED_BY_MEMO_VALUE = "composer";
+//# sourceMappingURL=constants.d.ts.map

package/dist/internal/async/schedule/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/schedule/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,qBAAqB,aAAa,CAAC"}

package/dist/internal/async/schedule/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANAGED_BY_MEMO_VALUE = exports.MANAGED_BY_MEMO_KEY = void 0;
+/**
+ * Memo key and value used to tag schedules managed by composer.
+ *
+ * During sync, only schedules with this memo are considered for update
+ * or deletion. Schedules without it (manually created or from other
+ * systems) are never touched.
+ */
+exports.MANAGED_BY_MEMO_KEY = "managedBy";
+exports.MANAGED_BY_MEMO_VALUE = "composer";
+//# sourceMappingURL=constants.js.map

package/dist/internal/async/schedule/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/internal/async/schedule/constants.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAG,WAAW,CAAC;AAClC,QAAA,qBAAqB,GAAG,UAAU,CAAC"}

package/dist/internal/async/schedule/define-schedule.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Schedule Definition
+ *
+ * Provides the `defineSchedule()` function for declaring Temporal schedule
+ * definitions that reference composer workflows. Schedule definitions are
+ * declarative -- they describe what should be scheduled, not how to create
+ * the schedule on the Temporal server (that's handled at sync time by
+ * `composer.syncSchedules()` / `runScheduleSync()`).
+ *
+ * Consumers export schedule definitions from a barrel (typically
+ * `src/schedules/index.ts`) and pass them explicitly to a sync entrypoint --
+ * the same "pass it in" pattern used for workflows and steps.
+ *
+ * @module define-schedule
+ */
+import type { ScheduleSpec } from "@temporalio/client";
+import { ScheduleOverlapPolicy } from "@temporalio/client";
+import type { ExtractWorkflowBag, ExtractWorkflowConfig, ExtractWorkflowRequiredInitial, Workflow } from "../../dag-sync-workflow";
+export type { ScheduleSpec } from "@temporalio/client";
+export { ScheduleOverlapPolicy } from "@temporalio/client";
+/**
+ * Extracts the required initial data type for a workflow, combining
+ * RequiredInitial fields with ConfiguredValues keys.
+ *
+ * - If the workflow has RequiredInitial fields, those must be provided.
+ * - ConfiguredValues are already baked into the workflow and don't need
+ *   to be provided in initialData.
+ */
+type ScheduleInitialData<W extends Workflow<any, any, any, any, any>> = [
+    ExtractWorkflowRequiredInitial<W>
+] extends [never] ? Partial<ExtractWorkflowBag<W>> | undefined : Partial<ExtractWorkflowBag<W>> & Pick<ExtractWorkflowBag<W>, Exclude<ExtractWorkflowRequiredInitial<W>, keyof ExtractWorkflowConfig<W>>>;
+/**
+ * Options for defining a schedule.
+ *
+ * @typeParam W - The workflow type this schedule is for
+ */
+export interface ScheduleDefinitionOptions<W extends Workflow<any, any, any, any, any>> {
+    /**
+     * Unique, stable identifier for this schedule on the Temporal server.
+     *
+     * This ID persists across deployments -- it's how `syncSchedules()` knows
+     * which schedule to update. Choose a descriptive, kebab-case name.
+     *
+     * @example "daily-report", "weekly-cleanup", "hourly-health-check"
+     */
+    scheduleId: string;
+    /**
+     * The workflow to execute on this schedule.
+     *
+     * Pass the workflow definition object (the result of `createWorkflow(...).build(...)`.
+     */
+    workflow: W;
+    /**
+     * Static initial data for scheduled runs.
+     *
+     * Type-safe: must satisfy the workflow's RequiredInitial constraint.
+     * For workflows with no required initial fields, this is optional.
+     */
+    initialData: ScheduleInitialData<W>;
+    /**
+     * When the schedule should fire.
+     *
+     * Uses Temporal's `ScheduleSpec` type directly. Supports:
+     * - `calendars`: Calendar-based times (like cron but more readable)
+     * - `intervals`: Repeating intervals (e.g., every 1 hour)
+     * - `cronExpressions`: Legacy cron strings
+     * - `timezone`: IANA timezone (default: UTC)
+     * - `jitter`: Random jitter added to each trigger time
+     * - `startAt` / `endAt`: Time bounds
+     * - `skip`: Calendar specs for times to exclude
+     *
+     * @example
+     * // Every day at 2am UTC
+     * { calendars: [{ hour: 2 }] }
+     *
+     * @example
+     * // Every Monday at 8:30am Eastern
+     * { calendars: [{ hour: 8, minute: 30, dayOfWeek: "MONDAY" }], timezone: "US/Eastern" }
+     *
+     * @example
+     * // Every hour
+     * { intervals: [{ every: "1h" }] }
+     */
+    spec: ScheduleSpec;
+    /**
+     * What happens when a new run would start while a previous is still running.
+     *
+     * @default ScheduleOverlapPolicy.SKIP
+     */
+    overlap?: ScheduleOverlapPolicy;
+    /**
+     * Maximum time period for catching up missed runs.
+     *
+     * If the Temporal server was down or the schedule was paused, this controls
+     * how far back it will try to execute missed runs on recovery.
+     *
+     * Accepts ms-formatted strings (e.g., "1d", "1h") or milliseconds as a number.
+     *
+     * @default "1 minute" (Temporal's default)
+     * @example "1 day", "1h", "0" (no catchup)
+     */
+    catchupWindow?: number | string;
+    /**
+     * Whether to create the schedule in a paused state.
+     *
+     * @default false
+     */
+    paused?: boolean;
+    /**
+     * Human-readable note about this schedule.
+     * Visible in the Temporal UI.
+     */
+    note?: string;
+    /**
+     * Task queue for the scheduled workflow.
+     * @default "workflow-tasks"
+     */
+    taskQueue?: string;
+    /**
+     * Environments in which this schedule should be active.
+     *
+     * Must be a non-empty list of environment names (e.g. `"prod"`, `"preview"`).
+     * At sync time, the schedule is only reconciled when the current environment
+     * (`ENVIRONMENT_NAME`) matches one of these values. This keeps
+     * production-only schedules from running in preview / local environments.
+     *
+     * @example ["prod"]
+     * @example ["preview", "prod"]
+     */
+    environments: readonly string[];
+}
+/**
+ * A schedule definition ready for syncing to the Temporal server.
+ *
+ * This is the runtime representation produced by `defineSchedule()`.
+ * It carries the workflow name (extracted from the workflow definition)
+ * and all schedule configuration.
+ */
+export interface ScheduleDefinition {
+    /** Marker for type guard identification */
+    readonly __scheduleDefinition: true;
+    /** Unique schedule ID on the Temporal server */
+    readonly scheduleId: string;
+    /** Workflow name (unversioned -- versioning is applied at sync time) */
+    readonly workflowName: string;
+    /** Static initial data for scheduled runs */
+    readonly initialData: Record<string, unknown>;
+    /** Configured values from the workflow (merged at sync time, overriding initialData) */
+    readonly configuredValues: Record<string, unknown>;
+    /** When the schedule should fire */
+    readonly spec: ScheduleSpec;
+    /** Overlap policy */
+    readonly overlap: ScheduleOverlapPolicy;
+    /** Catchup window for missed runs */
+    readonly catchupWindow?: number | string;
+    /** Whether to create in paused state */
+    readonly paused: boolean;
+    /** Human-readable note */
+    readonly note?: string;
+    /** Task queue */
+    readonly taskQueue: string;
+    /** Environments in which this schedule should be active (non-empty). */
+    readonly environments: readonly string[];
+}
+/**
+ * Defines a Temporal schedule for a composer workflow.
+ *
+ * Creates a typed, declarative schedule definition that consumers export from
+ * a `schedules/` barrel and pass explicitly to a sync entrypoint (e.g.
+ * `runScheduleSync()`), mirroring how workflows are passed to
+ * `startWorkflowWorker()`.
+ *
+ * @example
+ * ```typescript
+ * import { defineSchedule, ScheduleOverlapPolicy } from "@lotiai/composer";
+ * import { dailyReportWorkflow } from "../workflows/daily-report-workflow";
+ *
+ * export const dailyReport = defineSchedule({
+ *   scheduleId: "daily-report",
+ *   workflow: dailyReportWorkflow,
+ *   initialData: { reportType: "daily" },
+ *   environments: ["prod"],
+ *   spec: {
+ *     calendars: [{ hour: 8, minute: 0 }],
+ *     timezone: "US/Eastern",
+ *   },
+ *   overlap: ScheduleOverlapPolicy.SKIP,
+ * });
+ * ```
+ */
+export declare function defineSchedule<W extends Workflow<any, any, any, any, any>>(options: ScheduleDefinitionOptions<W>): ScheduleDefinition;
+//# sourceMappingURL=define-schedule.d.ts.map

package/dist/internal/async/schedule/define-schedule.d.ts.map

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

package/dist/internal/async/schedule/define-schedule.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Schedule Definition
+ *
+ * Provides the `defineSchedule()` function for declaring Temporal schedule
+ * definitions that reference composer workflows. Schedule definitions are
+ * declarative -- they describe what should be scheduled, not how to create
+ * the schedule on the Temporal server (that's handled at sync time by
+ * `composer.syncSchedules()` / `runScheduleSync()`).
+ *
+ * Consumers export schedule definitions from a barrel (typically
+ * `src/schedules/index.ts`) and pass them explicitly to a sync entrypoint --
+ * the same "pass it in" pattern used for workflows and steps.
+ *
+ * @module define-schedule
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduleOverlapPolicy = void 0;
+exports.defineSchedule = defineSchedule;
+const client_1 = require("@temporalio/client");
+var client_2 = require("@temporalio/client");
+Object.defineProperty(exports, "ScheduleOverlapPolicy", { enumerable: true, get: function () { return client_2.ScheduleOverlapPolicy; } });
+/**
+ * Defines a Temporal schedule for a composer workflow.
+ *
+ * Creates a typed, declarative schedule definition that consumers export from
+ * a `schedules/` barrel and pass explicitly to a sync entrypoint (e.g.
+ * `runScheduleSync()`), mirroring how workflows are passed to
+ * `startWorkflowWorker()`.
+ *
+ * @example
+ * ```typescript
+ * import { defineSchedule, ScheduleOverlapPolicy } from "@lotiai/composer";
+ * import { dailyReportWorkflow } from "../workflows/daily-report-workflow";
+ *
+ * export const dailyReport = defineSchedule({
+ *   scheduleId: "daily-report",
+ *   workflow: dailyReportWorkflow,
+ *   initialData: { reportType: "daily" },
+ *   environments: ["prod"],
+ *   spec: {
+ *     calendars: [{ hour: 8, minute: 0 }],
+ *     timezone: "US/Eastern",
+ *   },
+ *   overlap: ScheduleOverlapPolicy.SKIP,
+ * });
+ * ```
+ */
+function defineSchedule(options) {
+    if (!options.scheduleId || typeof options.scheduleId !== "string") {
+        throw new Error("scheduleId is required and must be a non-empty string");
+    }
+    if (!options.workflow || typeof options.workflow.name !== "string") {
+        throw new Error("workflow is required and must be a valid workflow definition");
+    }
+    if (!options.spec) {
+        throw new Error("spec is required -- define when the schedule should fire");
+    }
+    if (!Array.isArray(options.environments) ||
+        options.environments.length === 0 ||
+        !options.environments.every((env) => typeof env === "string" && env.length > 0)) {
+        throw new Error(`environments is required for schedule "${options.scheduleId}" and must be a non-empty array of environment names (e.g. ["prod"])`);
+    }
+    return {
+        __scheduleDefinition: true,
+        scheduleId: options.scheduleId,
+        workflowName: options.workflow.name,
+        initialData: (options.initialData ?? {}),
+        configuredValues: (options.workflow.configuredValues ?? {}),
+        spec: options.spec,
+        overlap: options.overlap ?? client_1.ScheduleOverlapPolicy.SKIP,
+        catchupWindow: options.catchupWindow,
+        paused: options.paused ?? false,
+        note: options.note,
+        taskQueue: options.taskQueue ?? "workflow-tasks",
+        environments: [...options.environments],
+    };
+}
+//# sourceMappingURL=define-schedule.js.map

package/dist/internal/async/schedule/define-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-schedule.js","sourceRoot":"","sources":["../../../../src/internal/async/schedule/define-schedule.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAqNH,wCAuCC;AAzPD,+CAA2D;AAS3D,6CAA2D;AAAlD,+GAAA,qBAAqB,OAAA;AA+K9B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,cAAc,CAC5B,OAAqC;IAErC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;QACpC,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QACjC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAC/E,CAAC;QACD,MAAM,IAAI,KAAK,CACb,0CAA0C,OAAO,CAAC,UAAU,sEAAsE,CACnI,CAAC;IACJ,CAAC;IAED,OAAO;QACL,oBAAoB,EAAE,IAAI;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;QACnC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAA4B;QACnE,gBAAgB,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,IAAI,EAAE,CAA4B;QACtF,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,8BAAqB,CAAC,IAAI;QACtD,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,gBAAgB;QAChD,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/internal/async/schedule/index.d.ts

@@ -0,0 +1,3 @@
+export { defineSchedule, type ScheduleDefinition, type ScheduleDefinitionOptions, ScheduleOverlapPolicy, type ScheduleSpec, } from "./define-schedule";
+export { type SyncSchedulesConfig, type SyncSchedulesResult, syncSchedules, type TemporalScheduleConfig, } from "./sync-schedules";
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/async/schedule/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/schedule/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,aAAa,EACb,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/internal/async/schedule/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncSchedules = exports.ScheduleOverlapPolicy = exports.defineSchedule = void 0;
+var define_schedule_1 = require("./define-schedule");
+Object.defineProperty(exports, "defineSchedule", { enumerable: true, get: function () { return define_schedule_1.defineSchedule; } });
+Object.defineProperty(exports, "ScheduleOverlapPolicy", { enumerable: true, get: function () { return define_schedule_1.ScheduleOverlapPolicy; } });
+var sync_schedules_1 = require("./sync-schedules");
+Object.defineProperty(exports, "syncSchedules", { enumerable: true, get: function () { return sync_schedules_1.syncSchedules; } });
+//# sourceMappingURL=index.js.map

package/dist/internal/async/schedule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/async/schedule/index.ts"],"names":[],"mappings":";;;AAAA,qDAM2B;AALzB,iHAAA,cAAc,OAAA;AAGd,wHAAA,qBAAqB,OAAA;AAGvB,mDAK0B;AAFxB,+GAAA,aAAa,OAAA"}

package/dist/internal/async/schedule/schedule-definition-schema.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Zod schema for `ScheduleDefinition`.
+ *
+ * Used at trust boundaries where schedule definitions arrive as JSON from
+ * another process -- notably the `schedule-sync` Lambda's event payload. The
+ * schema mirrors the `ScheduleDefinition` interface and matches the shape
+ * produced by `defineSchedule()`.
+ *
+ * @module schedule-definition-schema
+ */
+import { z } from "zod";
+/**
+ * Overlap policy values accepted by `ScheduleDefinition.overlap`.
+ *
+ * Mirrors the string values exported by `@temporalio/client`'s
+ * `ScheduleOverlapPolicy` (excluding the deprecated `UNSPECIFIED`). Hand-listed
+ * rather than derived from the SDK object because the SDK includes an
+ * `UNSPECIFIED: undefined` entry that is not a valid Zod enum value.
+ */
+export declare const scheduleOverlapPolicySchema: z.ZodEnum<{
+    SKIP: "SKIP";
+    BUFFER_ONE: "BUFFER_ONE";
+    BUFFER_ALL: "BUFFER_ALL";
+    CANCEL_OTHER: "CANCEL_OTHER";
+    TERMINATE_OTHER: "TERMINATE_OTHER";
+    ALLOW_ALL: "ALLOW_ALL";
+}>;
+/**
+ * Zod schema for `ScheduleDefinition`.
+ *
+ * Structurally mirrors the `ScheduleDefinition` interface produced by
+ * `defineSchedule()`. Used at trust boundaries where schedule definitions
+ * arrive as JSON from another process -- notably the schedule-sync Lambda.
+ *
+ * Note: the inferred output type preserves structural compatibility with
+ * `ScheduleDefinition`, but `spec` widens to a loose object. Callers handing
+ * the parsed value to `syncSchedules()` should cast the array as
+ * `ScheduleDefinition[]`.
+ */
+export declare const scheduleDefinitionSchema: z.ZodObject<{
+    __scheduleDefinition: z.ZodLiteral<true>;
+    scheduleId: z.ZodString;
+    workflowName: z.ZodString;
+    initialData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    configuredValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    spec: z.ZodObject<{
+        startAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        endAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    }, z.core.$loose>;
+    overlap: z.ZodEnum<{
+        SKIP: "SKIP";
+        BUFFER_ONE: "BUFFER_ONE";
+        BUFFER_ALL: "BUFFER_ALL";
+        CANCEL_OTHER: "CANCEL_OTHER";
+        TERMINATE_OTHER: "TERMINATE_OTHER";
+        ALLOW_ALL: "ALLOW_ALL";
+    }>;
+    catchupWindow: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    paused: z.ZodBoolean;
+    note: z.ZodOptional<z.ZodString>;
+    taskQueue: z.ZodString;
+    environments: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+//# sourceMappingURL=schedule-definition-schema.d.ts.map

package/dist/internal/async/schedule/schedule-definition-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-definition-schema.d.ts","sourceRoot":"","sources":["../../../../src/internal/async/schedule/schedule-definition-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;EAOtC,CAAC;AAuBH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;kBAanC,CAAC"}

package/dist/internal/async/schedule/schedule-definition-schema.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scheduleDefinitionSchema = exports.scheduleOverlapPolicySchema = void 0;
+/**
+ * Zod schema for `ScheduleDefinition`.
+ *
+ * Used at trust boundaries where schedule definitions arrive as JSON from
+ * another process -- notably the `schedule-sync` Lambda's event payload. The
+ * schema mirrors the `ScheduleDefinition` interface and matches the shape
+ * produced by `defineSchedule()`.
+ *
+ * @module schedule-definition-schema
+ */
+const zod_1 = require("zod");
+/**
+ * Overlap policy values accepted by `ScheduleDefinition.overlap`.
+ *
+ * Mirrors the string values exported by `@temporalio/client`'s
+ * `ScheduleOverlapPolicy` (excluding the deprecated `UNSPECIFIED`). Hand-listed
+ * rather than derived from the SDK object because the SDK includes an
+ * `UNSPECIFIED: undefined` entry that is not a valid Zod enum value.
+ */
+exports.scheduleOverlapPolicySchema = zod_1.z.enum([
+    "SKIP",
+    "BUFFER_ONE",
+    "BUFFER_ALL",
+    "CANCEL_OTHER",
+    "TERMINATE_OTHER",
+    "ALLOW_ALL",
+]);
+/**
+ * Zod schema for `ScheduleSpec`.
+ *
+ * Passes unrecognized fields through untouched so detailed `ScheduleSpec`
+ * shape validation stays with the Temporal client (which runs downstream of
+ * this schema). The known `Date`-valued fields (`startAt`, `endAt`) are
+ * explicitly coerced because schedule definitions are `JSON.stringify`ed
+ * when shipped to the schedule-sync Lambda, which loses `Date` identity --
+ * without this coercion, `startAt`/`endAt` would arrive as ISO strings and
+ * the Temporal client would reject them when constructing the protobuf
+ * payload.
+ *
+ * `z.coerce.date()` accepts both real `Date` instances (direct path, where
+ * this schema is not strictly needed but may still be applied) and ISO
+ * strings (Lambda path, after JSON round-trip).
+ */
+const scheduleSpecSchema = zod_1.z.looseObject({
+    startAt: zod_1.z.coerce.date().optional(),
+    endAt: zod_1.z.coerce.date().optional(),
+});
+/**
+ * Zod schema for `ScheduleDefinition`.
+ *
+ * Structurally mirrors the `ScheduleDefinition` interface produced by
+ * `defineSchedule()`. Used at trust boundaries where schedule definitions
+ * arrive as JSON from another process -- notably the schedule-sync Lambda.
+ *
+ * Note: the inferred output type preserves structural compatibility with
+ * `ScheduleDefinition`, but `spec` widens to a loose object. Callers handing
+ * the parsed value to `syncSchedules()` should cast the array as
+ * `ScheduleDefinition[]`.
+ */
+exports.scheduleDefinitionSchema = zod_1.z.strictObject({
+    __scheduleDefinition: zod_1.z.literal(true),
+    scheduleId: zod_1.z.string().min(1),
+    workflowName: zod_1.z.string().min(1),
+    initialData: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    configuredValues: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    spec: scheduleSpecSchema,
+    overlap: exports.scheduleOverlapPolicySchema,
+    catchupWindow: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).optional(),
+    paused: zod_1.z.boolean(),
+    note: zod_1.z.string().optional(),
+    taskQueue: zod_1.z.string().min(1),
+    environments: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+});
+//# sourceMappingURL=schedule-definition-schema.js.map

package/dist/internal/async/schedule/schedule-definition-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-definition-schema.js","sourceRoot":"","sources":["../../../../src/internal/async/schedule/schedule-definition-schema.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,6BAAwB;AAExB;;;;;;;GAOG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,IAAI,CAAC;IAChD,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,kBAAkB,GAAG,OAAC,CAAC,WAAW,CAAC;IACvC,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,YAAY,CAAC;IACrD,oBAAoB,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACrC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;IAC9C,gBAAgB,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;IACnD,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,mCAA2B;IACpC,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;IACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAChD,CAAC,CAAC"}