dotdo 0.0.1 → 0.1.0

package/dist/workflows/ScheduleManager.js

@@ -0,0 +1,473 @@
+/**
+ * ScheduleManager - Manages cron-triggered workflow schedules
+ *
+ * Provides:
+ * - Schedule registration with cron expressions
+ * - Cron expression parsing (standard 5-field format)
+ * - Next run time calculation with timezone support
+ * - Schedule listing, updating, and deletion
+ * - Integration with DO alarm API for execution
+ *
+ * This is the runtime for scheduled workflow triggers in DOs.
+ */
+/// <reference types="@cloudflare/workers-types" />
+// ============================================================================
+// ERROR CLASSES
+// ============================================================================
+export class ScheduleValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ScheduleValidationError';
+    }
+}
+export class ScheduleNotFoundError extends Error {
+    constructor(name) {
+        super(`Schedule not found: ${name}`);
+        this.name = 'ScheduleNotFoundError';
+    }
+}
+export class InvalidCronExpressionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidCronExpressionError';
+    }
+}
+// ============================================================================
+// STORAGE KEYS
+// ============================================================================
+const SCHEDULE_PREFIX = 'schedule:';
+function scheduleKey(name) {
+    return `${SCHEDULE_PREFIX}${name}`;
+}
+// ============================================================================
+// MONTH AND DAY NAME ALIASES
+// ============================================================================
+const MONTH_ALIASES = {
+    JAN: 1,
+    FEB: 2,
+    MAR: 3,
+    APR: 4,
+    MAY: 5,
+    JUN: 6,
+    JUL: 7,
+    AUG: 8,
+    SEP: 9,
+    OCT: 10,
+    NOV: 11,
+    DEC: 12,
+};
+const DAY_ALIASES = {
+    SUN: 0,
+    MON: 1,
+    TUE: 2,
+    WED: 3,
+    THU: 4,
+    FRI: 5,
+    SAT: 6,
+};
+// ============================================================================
+// CRON EXPRESSION PARSING
+// ============================================================================
+function replaceAliases(field, aliases) {
+    let result = field.toUpperCase();
+    for (const [alias, value] of Object.entries(aliases)) {
+        result = result.replace(new RegExp(alias, 'g'), String(value));
+    }
+    return result;
+}
+function parseField(field, min, max, fieldName) {
+    if (field === '*') {
+        return '*';
+    }
+    const values = [];
+    // Split by comma for lists
+    const parts = field.split(',');
+    for (const part of parts) {
+        // Check for step values (e.g., */15 or 0-30/10)
+        const stepMatch = part.match(/^(.+)\/(\d+)$/);
+        if (stepMatch) {
+            const [, rangePart, stepStr] = stepMatch;
+            const step = parseInt(stepStr, 10);
+            let rangeStart = min;
+            let rangeEnd = max;
+            if (rangePart !== '*') {
+                // Parse range like 0-30
+                const rangeMatch = rangePart.match(/^(\d+)-(\d+)$/);
+                if (rangeMatch) {
+                    rangeStart = parseInt(rangeMatch[1], 10);
+                    rangeEnd = parseInt(rangeMatch[2], 10);
+                }
+                else {
+                    rangeStart = parseInt(rangePart, 10);
+                    rangeEnd = max;
+                }
+            }
+            for (let i = rangeStart; i <= rangeEnd; i += step) {
+                values.push(i);
+            }
+            continue;
+        }
+        // Check for range (e.g., 1-5)
+        const rangeMatch = part.match(/^(\d+)-(\d+)$/);
+        if (rangeMatch) {
+            const start = parseInt(rangeMatch[1], 10);
+            const end = parseInt(rangeMatch[2], 10);
+            if (start > end) {
+                throw new InvalidCronExpressionError(`Invalid range in ${fieldName}: ${part} (start > end)`);
+            }
+            for (let i = start; i <= end; i++) {
+                values.push(i);
+            }
+            continue;
+        }
+        // Single value
+        const value = parseInt(part, 10);
+        if (isNaN(value)) {
+            throw new InvalidCronExpressionError(`Invalid value in ${fieldName}: ${part}`);
+        }
+        values.push(value);
+    }
+    // Validate all values are within range
+    for (const value of values) {
+        if (value < min || value > max) {
+            throw new InvalidCronExpressionError(`Value ${value} in ${fieldName} is out of range (${min}-${max})`);
+        }
+    }
+    return values.sort((a, b) => a - b);
+}
+/**
+ * Parse a cron expression string into a structured CronExpression object
+ *
+ * Supports standard 5-field format:
+ * - minute (0-59)
+ * - hour (0-23)
+ * - day of month (1-31)
+ * - month (1-12)
+ * - day of week (0-6, where 0 = Sunday)
+ *
+ * Supports:
+ * - Wildcards (*)
+ * - Ranges (1-5)
+ * - Lists (1,3,5)
+ * - Steps (star/15, 0-30/10)
+ * - Month names (JAN-DEC)
+ * - Day names (SUN-SAT)
+ */
+export function parseCronExpression(expression) {
+    if (!expression || typeof expression !== 'string') {
+        throw new InvalidCronExpressionError('Cron expression is required');
+    }
+    const trimmed = expression.trim();
+    if (!trimmed) {
+        throw new InvalidCronExpressionError('Cron expression cannot be empty');
+    }
+    const fields = trimmed.split(/\s+/);
+    // Standard cron has 5 fields, some systems have 6 (with seconds)
+    if (fields.length < 5 || fields.length > 6) {
+        throw new InvalidCronExpressionError(`Invalid cron expression: expected 5 fields, got ${fields.length}. Expression: "${expression}"`);
+    }
+    // If 6 fields, skip the first (seconds) field
+    const offset = fields.length === 6 ? 1 : 0;
+    // Replace day/month name aliases
+    const monthField = replaceAliases(fields[offset + 3], MONTH_ALIASES);
+    const dowField = replaceAliases(fields[offset + 4], DAY_ALIASES);
+    return {
+        minute: parseField(fields[offset + 0], 0, 59, 'minute'),
+        hour: parseField(fields[offset + 1], 0, 23, 'hour'),
+        dayOfMonth: parseField(fields[offset + 2], 1, 31, 'dayOfMonth'),
+        month: parseField(monthField, 1, 12, 'month'),
+        dayOfWeek: parseField(dowField, 0, 6, 'dayOfWeek'),
+    };
+}
+// ============================================================================
+// NEXT RUN TIME CALCULATION
+// ============================================================================
+function fieldMatches(value, field) {
+    if (field === '*')
+        return true;
+    return field.includes(value);
+}
+function getNextValue(current, field, max) {
+    if (field === '*') {
+        if (current >= max) {
+            return { value: 0, wrapped: true };
+        }
+        return { value: current, wrapped: false };
+    }
+    // Find the next value >= current
+    for (const v of field) {
+        if (v >= current) {
+            return { value: v, wrapped: false };
+        }
+    }
+    // Wrap around to first value
+    return { value: field[0], wrapped: true };
+}
+/**
+ * Get UTC time components from a Date, optionally treating them as if they were in a timezone
+ */
+function getTimeComponents(date, timezone) {
+    if (timezone) {
+        // Get the time as it appears in the target timezone
+        const formatter = new Intl.DateTimeFormat('en-US', {
+            timeZone: timezone,
+            year: 'numeric',
+            month: 'numeric',
+            day: 'numeric',
+            weekday: 'short',
+            hour: 'numeric',
+            minute: 'numeric',
+            hour12: false,
+        });
+        const parts = formatter.formatToParts(date);
+        const getPart = (type) => parts.find((p) => p.type === type)?.value || '0';
+        const weekdayMap = {
+            Sun: 0,
+            Mon: 1,
+            Tue: 2,
+            Wed: 3,
+            Thu: 4,
+            Fri: 5,
+            Sat: 6,
+        };
+        return {
+            year: parseInt(getPart('year'), 10),
+            month: parseInt(getPart('month'), 10),
+            dayOfMonth: parseInt(getPart('day'), 10),
+            dayOfWeek: weekdayMap[getPart('weekday')] ?? 0,
+            hour: parseInt(getPart('hour'), 10),
+            minute: parseInt(getPart('minute'), 10),
+        };
+    }
+    // Default: use UTC components
+    return {
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        dayOfMonth: date.getUTCDate(),
+        dayOfWeek: date.getUTCDay(),
+        hour: date.getUTCHours(),
+        minute: date.getUTCMinutes(),
+    };
+}
+/**
+ * Calculate the next run time for a cron expression
+ *
+ * @param cron - Parsed cron expression
+ * @param options - Optional timezone and reference time
+ * @returns The next Date when the schedule should run (in UTC)
+ */
+export function getNextRunTime(cron, options = {}) {
+    const now = options.from || new Date();
+    const timezone = options.timezone;
+    // Work with a copy in milliseconds since epoch
+    let timestamp = now.getTime();
+    // Round up to the next minute
+    timestamp = Math.ceil(timestamp / 60000) * 60000;
+    // Add one minute to start from the NEXT minute
+    timestamp += 60000;
+    // Maximum iterations to prevent infinite loops (approximately 4 years of minutes)
+    const maxIterations = 60 * 24 * 366 * 4;
+    for (let i = 0; i < maxIterations; i++) {
+        const date = new Date(timestamp);
+        const components = getTimeComponents(date, timezone);
+        // Check if current time matches the cron expression
+        if (fieldMatches(components.month, cron.month) &&
+            fieldMatches(components.dayOfMonth, cron.dayOfMonth) &&
+            fieldMatches(components.dayOfWeek, cron.dayOfWeek) &&
+            fieldMatches(components.hour, cron.hour) &&
+            fieldMatches(components.minute, cron.minute)) {
+            // Found a match! Return the UTC time
+            return date;
+        }
+        // Advance to next minute
+        timestamp += 60000;
+    }
+    throw new Error('Could not find next run time within reasonable time frame');
+}
+// ============================================================================
+// SCHEDULE MANAGER
+// ============================================================================
+export class ScheduleManager {
+    storage;
+    triggerHandler = null;
+    constructor(state) {
+        this.storage = state.storage;
+    }
+    /**
+     * Register a handler to be called when a schedule triggers
+     */
+    onScheduleTrigger(handler) {
+        this.triggerHandler = handler;
+    }
+    /**
+     * Register a new cron schedule
+     *
+     * @param cronExpression - Standard 5-field cron expression
+     * @param name - Unique name for the schedule
+     * @param options - Optional timezone, metadata, and enabled flag
+     * @returns The created schedule
+     */
+    async schedule(cronExpression, name, options = {}) {
+        // Check for duplicate name
+        const existing = await this.storage.get(scheduleKey(name));
+        if (existing) {
+            throw new ScheduleValidationError(`Schedule with name "${name}" already exists`);
+        }
+        // Parse and validate cron expression
+        const cron = parseCronExpression(cronExpression);
+        // Calculate next run time (if enabled)
+        const enabled = options.enabled !== false;
+        let nextRunAt = null;
+        if (enabled) {
+            nextRunAt = getNextRunTime(cron, { timezone: options.timezone });
+        }
+        const now = new Date();
+        const schedule = {
+            id: crypto.randomUUID(),
+            name,
+            cronExpression,
+            status: enabled ? 'active' : 'paused',
+            nextRunAt,
+            lastRunAt: null,
+            runCount: 0,
+            timezone: options.timezone,
+            metadata: options.metadata,
+            createdAt: now,
+            updatedAt: now,
+        };
+        // Persist to storage
+        await this.storage.put(scheduleKey(name), schedule);
+        // Set alarm for next run if enabled
+        if (enabled && nextRunAt) {
+            await this.updateAlarm();
+        }
+        return schedule;
+    }
+    /**
+     * Get a schedule by name
+     */
+    async getSchedule(name) {
+        const schedule = await this.storage.get(scheduleKey(name));
+        return schedule || null;
+    }
+    /**
+     * List all registered schedules
+     */
+    async listSchedules(options = {}) {
+        const map = await this.storage.list({ prefix: SCHEDULE_PREFIX });
+        const schedules = [];
+        for (const [, value] of map) {
+            const schedule = value;
+            if (!options.status || schedule.status === options.status) {
+                schedules.push(schedule);
+            }
+        }
+        return schedules;
+    }
+    /**
+     * Delete a schedule
+     */
+    async deleteSchedule(name) {
+        const existing = await this.storage.get(scheduleKey(name));
+        if (!existing) {
+            throw new ScheduleNotFoundError(name);
+        }
+        await this.storage.delete(scheduleKey(name));
+        // Update alarm for remaining schedules
+        await this.updateAlarm();
+    }
+    /**
+     * Update a schedule
+     */
+    async updateSchedule(name, options) {
+        const existing = await this.storage.get(scheduleKey(name));
+        if (!existing) {
+            throw new ScheduleNotFoundError(name);
+        }
+        const schedule = existing;
+        const now = new Date();
+        // Update cron expression if provided
+        if (options.cronExpression !== undefined) {
+            parseCronExpression(options.cronExpression); // Validate
+            schedule.cronExpression = options.cronExpression;
+        }
+        // Update timezone if provided
+        if (options.timezone !== undefined) {
+            schedule.timezone = options.timezone;
+        }
+        // Update metadata if provided
+        if (options.metadata !== undefined) {
+            schedule.metadata = options.metadata;
+        }
+        // Update enabled status if provided
+        if (options.enabled !== undefined) {
+            schedule.status = options.enabled ? 'active' : 'paused';
+        }
+        // Recalculate next run time
+        if (schedule.status === 'active') {
+            const cron = parseCronExpression(schedule.cronExpression);
+            schedule.nextRunAt = getNextRunTime(cron, { timezone: schedule.timezone });
+        }
+        else {
+            schedule.nextRunAt = null;
+        }
+        schedule.updatedAt = now;
+        // Persist updated schedule
+        await this.storage.put(scheduleKey(name), schedule);
+        // Update alarm
+        await this.updateAlarm();
+        return schedule;
+    }
+    /**
+     * Handle a DO alarm - triggers any schedules due to run
+     */
+    async handleAlarm() {
+        const now = new Date();
+        const schedules = await this.listSchedules({ status: 'active' });
+        // Find all schedules due to run
+        const dueSchedules = schedules.filter((s) => s.nextRunAt && s.nextRunAt.getTime() <= now.getTime());
+        for (const schedule of dueSchedules) {
+            // Trigger the handler
+            if (this.triggerHandler) {
+                await this.triggerHandler(schedule);
+            }
+            // Update schedule: lastRunAt, runCount, nextRunAt
+            const cron = parseCronExpression(schedule.cronExpression);
+            schedule.lastRunAt = now;
+            schedule.runCount += 1;
+            schedule.nextRunAt = getNextRunTime(cron, { timezone: schedule.timezone, from: now });
+            schedule.updatedAt = now;
+            // Persist updated schedule
+            await this.storage.put(scheduleKey(schedule.name), schedule);
+        }
+        // Set alarm for next due schedule
+        await this.updateAlarm();
+    }
+    /**
+     * Update the DO alarm to fire at the next scheduled time
+     */
+    async updateAlarm() {
+        const schedules = await this.listSchedules({ status: 'active' });
+        if (schedules.length === 0) {
+            await this.storage.deleteAlarm();
+            return;
+        }
+        // Find the earliest next run time
+        let earliestTime = null;
+        for (const schedule of schedules) {
+            if (schedule.nextRunAt) {
+                if (!earliestTime || schedule.nextRunAt.getTime() < earliestTime.getTime()) {
+                    earliestTime = schedule.nextRunAt;
+                }
+            }
+        }
+        if (earliestTime) {
+            await this.storage.setAlarm(earliestTime);
+        }
+        else {
+            await this.storage.deleteAlarm();
+        }
+    }
+}
+export default ScheduleManager;
+//# sourceMappingURL=ScheduleManager.js.map

package/dist/workflows/ScheduleManager.js.map

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

package/dist/workflows/StepDOBridge.js

@@ -0,0 +1,149 @@
+/**
+ * StepDOBridge - Bridges workflow step execution to Durable Objects
+ *
+ * Provides the $ proxy pattern for calling DO methods from workflow steps:
+ *
+ * ```typescript
+ * workflow.step('createUser', async (ctx) => {
+ *   const user = await ctx.$.Users('user-123').create({ name: 'John' })
+ *   await ctx.$.Notifications('user-123').send({ message: 'Welcome!' })
+ *   return { userId: user.id }
+ * })
+ * ```
+ *
+ * The bridge:
+ * - Maps $.Noun(id) to DurableObjectNamespace.get(id)
+ * - Proxies method calls to DO.fetch() with JSON-RPC style payloads
+ * - Handles responses and errors from DOs
+ */
+/**
+ * Error thrown when DO call fails
+ */
+export class DOCallError extends Error {
+    noun;
+    id;
+    method;
+    originalError;
+    constructor(noun, id, method, message, originalError) {
+        super(message);
+        this.name = originalError?.name || 'DOCallError';
+        this.noun = noun;
+        this.id = id;
+        this.method = method;
+        this.originalError = originalError;
+    }
+}
+// ============================================================================
+// STEP DO BRIDGE
+// ============================================================================
+export class StepDOBridge {
+    namespaces;
+    /**
+     * Create a new StepDOBridge with DO namespace bindings.
+     *
+     * @param namespaces - Map of noun names to DurableObjectNamespace bindings
+     *
+     * @example
+     * ```typescript
+     * const bridge = new StepDOBridge({
+     *   Users: env.USERS,
+     *   Orders: env.ORDERS,
+     *   Notifications: env.NOTIFICATIONS,
+     * })
+     * ```
+     */
+    constructor(namespaces) {
+        this.namespaces = namespaces;
+    }
+    /**
+     * Create a domain proxy for use in workflow step context.
+     * Returns a proxy that supports $.Noun(id).method(...args) style calls.
+     *
+     * @returns Domain proxy object
+     *
+     * @example
+     * ```typescript
+     * const $ = bridge.createProxy()
+     * const user = await $.Users('user-123').create({ name: 'John' })
+     * ```
+     */
+    createProxy() {
+        const self = this;
+        return new Proxy({}, {
+            get(_, noun) {
+                // Return a function that takes an ID and returns a method proxy
+                return (id) => self.createMethodProxy(noun, id);
+            },
+        });
+    }
+    /**
+     * Create a method proxy for a specific DO instance.
+     * This proxy intercepts method calls and routes them to the DO.
+     */
+    createMethodProxy(noun, id) {
+        const self = this;
+        return new Proxy({}, {
+            get(_, method) {
+                // Return an async function that calls the DO method
+                return async (...args) => {
+                    return self.callDOMethod(noun, id, method, args);
+                };
+            },
+        });
+    }
+    /**
+     * Call a method on a Durable Object.
+     *
+     * @param noun - The DO type/noun name (e.g., 'Users', 'Orders')
+     * @param id - The DO instance ID
+     * @param method - The method name to call
+     * @param args - Arguments to pass to the method
+     * @returns The method result
+     * @throws DOCallError if the call fails
+     */
+    async callDOMethod(noun, id, method, args) {
+        // Get the namespace binding
+        const namespace = this.namespaces[noun];
+        if (!namespace) {
+            throw new DOCallError(noun, id, method, `DO namespace '${noun}' is not registered. Available namespaces: ${Object.keys(this.namespaces).join(', ')}`);
+        }
+        // Get the DO stub
+        const doId = namespace.idFromName(id);
+        const stub = namespace.get(doId);
+        // Build the request
+        // We use a POST request with the method in the path and args in the body
+        const url = `https://do.internal/${method}`;
+        const body = args.length === 1 ? args[0] : args.length > 0 ? args : undefined;
+        const request = new Request(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        // Call the DO
+        let response;
+        try {
+            response = await stub.fetch(request);
+        }
+        catch (error) {
+            throw new DOCallError(noun, id, method, `Failed to call ${noun}(${id}).${method}(): ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Parse the response
+        let data;
+        try {
+            data = await response.json();
+        }
+        catch {
+            throw new DOCallError(noun, id, method, `Invalid JSON response from ${noun}(${id}).${method}()`);
+        }
+        // Handle errors
+        if (!response.ok || data.error) {
+            const errorInfo = data.error || { message: `HTTP ${response.status}`, name: 'Error' };
+            throw new DOCallError(noun, id, method, errorInfo.message, errorInfo);
+        }
+        return data.result;
+    }
+}
+export default StepDOBridge;
+//# sourceMappingURL=StepDOBridge.js.map

package/dist/workflows/StepDOBridge.js.map

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