dotdo 0.0.1 → 0.1.0

package/dist/workflows/StepResultStorage.js

@@ -0,0 +1,232 @@
+/**
+ * StepResultStorage - Stores and retrieves workflow step execution results
+ *
+ * Provides:
+ * - Store step results with metadata (timing, status, retry count)
+ * - Retrieve results by step name
+ * - Get all results with filtering
+ * - Result persistence to Durable Object storage
+ * - Cleanup utilities for old results
+ *
+ * This integrates with WorkflowRuntime to provide step result caching
+ * and inspection capabilities.
+ */
+/// <reference types="@cloudflare/workers-types" />
+// ============================================================================
+// DURATION PARSING
+// ============================================================================
+function parseDuration(duration) {
+    if (typeof duration === 'number') {
+        return duration;
+    }
+    // Support formats like "100ms", "1 second", "30 seconds", "1 hour", etc.
+    const match = duration.match(/^(\d+(?:\.\d+)?)\s*(ms|millisecond|s|sec|second|m|min|minute|h|hr|hour|d|day|w|week)s?$/i);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}`);
+    }
+    const value = parseFloat(match[1]);
+    const unit = match[2].toLowerCase();
+    const multipliers = {
+        ms: 1,
+        millisecond: 1,
+        s: 1000,
+        sec: 1000,
+        second: 1000,
+        m: 60 * 1000,
+        min: 60 * 1000,
+        minute: 60 * 1000,
+        h: 60 * 60 * 1000,
+        hr: 60 * 60 * 1000,
+        hour: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+        day: 24 * 60 * 60 * 1000,
+        w: 7 * 24 * 60 * 60 * 1000,
+        week: 7 * 24 * 60 * 60 * 1000,
+    };
+    return value * (multipliers[unit] || 1000);
+}
+// ============================================================================
+// STEP RESULT STORAGE
+// ============================================================================
+const STORAGE_PREFIX = 'step-result:';
+export class StepResultStorage {
+    storage;
+    constructor(state) {
+        this.storage = state.storage;
+    }
+    // ==========================================================================
+    // STORE
+    // ==========================================================================
+    /**
+     * Store a step result with metadata
+     */
+    async store(stepName, result) {
+        const persisted = {
+            stepName,
+            output: result.output,
+            status: result.status,
+            duration: result.duration,
+            retryCount: result.retryCount,
+            startedAt: result.startedAt?.toISOString(),
+            completedAt: result.completedAt?.toISOString(),
+            error: result.error,
+            metadata: result.metadata,
+            storedAt: new Date().toISOString(),
+        };
+        await this.storage.put(`${STORAGE_PREFIX}${stepName}`, persisted);
+    }
+    // ==========================================================================
+    // GET
+    // ==========================================================================
+    /**
+     * Retrieve a step result by name
+     */
+    async get(stepName) {
+        const persisted = await this.storage.get(`${STORAGE_PREFIX}${stepName}`);
+        if (!persisted) {
+            return undefined;
+        }
+        return this.hydrate(persisted);
+    }
+    /**
+     * Alias for get - convenience method for WorkflowRuntime integration
+     */
+    async getStepResult(stepName) {
+        return this.get(stepName);
+    }
+    /**
+     * Check if a step has a stored result
+     */
+    async hasResult(stepName) {
+        const result = await this.storage.get(`${STORAGE_PREFIX}${stepName}`);
+        return result !== undefined;
+    }
+    // ==========================================================================
+    // GET ALL
+    // ==========================================================================
+    /**
+     * Get all stored step results with optional filtering
+     */
+    async getAll(options = {}) {
+        const entries = await this.storage.list({ prefix: STORAGE_PREFIX });
+        let results = [];
+        for (const [, persisted] of entries) {
+            const hydrated = this.hydrate(persisted);
+            // Apply status filter
+            if (options.status && hydrated.status !== options.status) {
+                continue;
+            }
+            results.push(hydrated);
+        }
+        // Sort by stored time (oldest first)
+        results.sort((a, b) => {
+            const timeA = a.storedAt ? new Date(a.storedAt).getTime() : 0;
+            const timeB = b.storedAt ? new Date(b.storedAt).getTime() : 0;
+            return timeA - timeB;
+        });
+        // Apply limit
+        if (options.limit && options.limit > 0) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    /**
+     * Get a summary of all step results
+     */
+    async getSummary() {
+        const results = await this.getAll();
+        const summary = {
+            total: results.length,
+            completed: 0,
+            failed: 0,
+            totalDuration: 0,
+            stepNames: [],
+        };
+        for (const result of results) {
+            summary.stepNames.push(result.stepName);
+            if (result.status === 'completed') {
+                summary.completed++;
+            }
+            else if (result.status === 'failed') {
+                summary.failed++;
+            }
+            if (result.duration) {
+                summary.totalDuration += result.duration;
+            }
+        }
+        return summary;
+    }
+    // ==========================================================================
+    // CLEAR / CLEANUP
+    // ==========================================================================
+    /**
+     * Clear a specific step result
+     */
+    async clear(stepName) {
+        await this.storage.delete(`${STORAGE_PREFIX}${stepName}`);
+    }
+    /**
+     * Clear all step results
+     */
+    async clearAll() {
+        const entries = await this.storage.list({ prefix: STORAGE_PREFIX });
+        const keys = Array.from(entries.keys());
+        for (const key of keys) {
+            await this.storage.delete(key);
+        }
+    }
+    /**
+     * Clear results older than specified duration
+     * @param maxAge Duration string (e.g., "1 hour", "30 minutes") or milliseconds
+     */
+    async clearOlderThan(maxAge) {
+        const maxAgeMs = typeof maxAge === 'string' ? parseDuration(maxAge) : maxAge;
+        const cutoffTime = Date.now() - maxAgeMs;
+        const entries = await this.storage.list({ prefix: STORAGE_PREFIX });
+        let clearedCount = 0;
+        for (const [key, persisted] of entries) {
+            const storedTime = persisted.storedAt ? new Date(persisted.storedAt).getTime() : 0;
+            if (storedTime < cutoffTime) {
+                await this.storage.delete(key);
+                clearedCount++;
+            }
+        }
+        return clearedCount;
+    }
+    /**
+     * Clear results by status
+     */
+    async clearByStatus(status) {
+        const entries = await this.storage.list({ prefix: STORAGE_PREFIX });
+        let clearedCount = 0;
+        for (const [key, persisted] of entries) {
+            if (persisted.status === status) {
+                await this.storage.delete(key);
+                clearedCount++;
+            }
+        }
+        return clearedCount;
+    }
+    // ==========================================================================
+    // PRIVATE HELPERS
+    // ==========================================================================
+    /**
+     * Convert persisted data to StoredStepResult with proper Date objects
+     */
+    hydrate(persisted) {
+        return {
+            stepName: persisted.stepName,
+            output: persisted.output,
+            status: persisted.status,
+            duration: persisted.duration,
+            retryCount: persisted.retryCount,
+            startedAt: persisted.startedAt ? new Date(persisted.startedAt) : undefined,
+            completedAt: persisted.completedAt ? new Date(persisted.completedAt) : undefined,
+            error: persisted.error,
+            metadata: persisted.metadata,
+            storedAt: persisted.storedAt,
+        };
+    }
+}
+export default StepResultStorage;
+//# sourceMappingURL=StepResultStorage.js.map

package/dist/workflows/StepResultStorage.js.map

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