@powerhousedao/reactor 4.1.0-staging.1 → 5.0.0-staging.2

package/dist/test/factories.js

@@ -0,0 +1,347 @@
+import { MemoryStorage, ReactorBuilder, driveDocumentModelModule, } from "document-drive";
+import { documentModelDocumentModelModule, } from "document-model";
+import { v4 as uuidv4 } from "uuid";
+import { vi } from "vitest";
+import { EventBus } from "../src/events/event-bus.js";
+import { SimpleJobExecutor } from "../src/executor/simple-job-executor.js";
+import { SimpleJobExecutorManager } from "../src/executor/simple-job-executor-manager.js";
+import { InMemoryQueue } from "../src/queue/queue.js";
+import { Reactor } from "../src/reactor.js";
+import { DocumentModelRegistry } from "../src/registry/implementation.js";
+/**
+ * Factory for creating test Job objects
+ */
+export function createTestJob(overrides = {}) {
+    const defaultJob = {
+        id: overrides.id || `job-${uuidv4()}`,
+        documentId: "doc-1",
+        scope: "global",
+        branch: "main",
+        operation: createTestOperation(overrides.operation ? { ...overrides.operation } : undefined),
+        createdAt: new Date().toISOString(),
+        queueHint: [],
+        retryCount: 0,
+        maxRetries: 3,
+    };
+    return {
+        ...defaultJob,
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating minimal Job objects (useful for performance tests)
+ */
+export function createMinimalJob(overrides = {}) {
+    return {
+        id: overrides.id || `job-${uuidv4()}`,
+        documentId: overrides.documentId || "doc-1",
+        scope: overrides.scope || "global",
+        branch: overrides.branch || "main",
+        operation: createMinimalOperation(),
+        createdAt: overrides.createdAt || "2023-01-01T00:00:00.000Z",
+        queueHint: overrides.queueHint || [],
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating test Operation objects
+ */
+export function createTestOperation(overrides = {}) {
+    const defaultOperation = {
+        index: 1,
+        timestampUtcMs: new Date().toISOString(),
+        hash: "test-hash",
+        skip: 0,
+        action: createTestAction(overrides.action ? { ...overrides.action } : undefined),
+        id: "op-1",
+    };
+    return {
+        ...defaultOperation,
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating minimal Operation objects
+ */
+export function createMinimalOperation(overrides = {}) {
+    return {
+        index: overrides.index ?? 0,
+        timestampUtcMs: overrides.timestampUtcMs || "2023-01-01T00:00:00.000Z",
+        hash: overrides.hash || "hash-123",
+        skip: overrides.skip ?? 0,
+        action: overrides.action || createMinimalAction(),
+        id: overrides.id || `op-${uuidv4()}`,
+    };
+}
+/**
+ * Factory for creating test Action objects
+ */
+export function createTestAction(overrides = {}) {
+    const defaultAction = {
+        id: uuidv4(),
+        type: "test-operation",
+        timestampUtcMs: new Date().toISOString(),
+        input: { test: "data" },
+        scope: "global",
+    };
+    return {
+        ...defaultAction,
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating minimal Action objects
+ */
+export function createMinimalAction(overrides = {}) {
+    return {
+        id: overrides.id || `action-${uuidv4()}`,
+        type: overrides.type || "CREATE",
+        timestampUtcMs: overrides.timestampUtcMs || "2023-01-01T00:00:00.000Z",
+        input: overrides.input || { data: "test" },
+        scope: overrides.scope || "global",
+    };
+}
+/**
+ * Factory for creating specific document model actions
+ */
+export function createDocumentModelAction(type, overrides = {}) {
+    const actionTypes = {
+        SET_NAME: { name: "Test Name" },
+        SET_DESCRIPTION: { description: "Test Description" },
+        CREATE: { name: "New Document" },
+        UPDATE: { data: "Updated Data" },
+    };
+    return {
+        id: uuidv4(),
+        type,
+        scope: "global",
+        timestampUtcMs: String(Date.now()),
+        input: actionTypes[type] || {},
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating mock PHDocument objects
+ */
+export function createMockDocument(overrides = {}) {
+    const baseDocument = documentModelDocumentModelModule.utils.createDocument();
+    if (overrides.id) {
+        baseDocument.header.id = overrides.id;
+    }
+    if (overrides.slug) {
+        baseDocument.header.slug = overrides.slug;
+    }
+    if (overrides.documentType) {
+        baseDocument.header.documentType = overrides.documentType;
+    }
+    if (overrides.state) {
+        baseDocument.state = {
+            ...baseDocument.state,
+            ...overrides.state,
+        };
+    }
+    return baseDocument;
+}
+/**
+ * Factory for creating test EventBus instances
+ */
+export function createTestEventBus() {
+    return new EventBus();
+}
+/**
+ * Factory for creating test EventBus with mock emit
+ */
+export function createMockEventBus() {
+    const eventBus = new EventBus();
+    const mockEmit = vi.fn().mockResolvedValue(undefined);
+    eventBus.emit = mockEmit;
+    return {
+        eventBus,
+        mockEmit,
+    };
+}
+/**
+ * Factory for creating test Queue instances
+ */
+export function createTestQueue(eventBus) {
+    return new InMemoryQueue(eventBus || createTestEventBus());
+}
+/**
+ * Factory for creating test Registry instances
+ */
+export function createTestRegistry(modules) {
+    const registry = new DocumentModelRegistry();
+    if (modules) {
+        modules.forEach((module) => registry.registerModules(module));
+    }
+    else {
+        // Register default module
+        registry.registerModules(documentModelDocumentModelModule);
+    }
+    return registry;
+}
+/**
+ * Factory for creating mock JobExecutor
+ */
+export function createMockJobExecutor(overrides = {}) {
+    return {
+        executeJob: vi.fn().mockResolvedValue({ success: true }),
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating mock SimpleJobExecutor with spy functions
+ */
+export function createMockSimpleJobExecutor() {
+    const executeJobSpy = vi.fn().mockResolvedValue({
+        success: true,
+        result: {},
+    });
+    const executor = {
+        executeJob: executeJobSpy,
+    };
+    return {
+        executor,
+        executeJobSpy,
+    };
+}
+/**
+ * Factory for creating mock IDocumentStorage
+ */
+export function createMockDocumentStorage(overrides = {}) {
+    return {
+        get: vi.fn().mockResolvedValue({
+            header: {
+                id: "doc-1",
+                documentType: "powerhouse/document-model",
+            },
+            operations: { global: [] },
+            state: {},
+        }),
+        set: vi.fn().mockResolvedValue(undefined),
+        delete: vi.fn().mockResolvedValue(undefined),
+        exists: vi.fn().mockResolvedValue(false),
+        getChildren: vi.fn().mockResolvedValue([]),
+        findByType: vi.fn().mockResolvedValue([]),
+        resolveIds: vi.fn().mockResolvedValue([]),
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating mock IDocumentOperationStorage
+ */
+export function createMockOperationStorage(overrides = {}) {
+    return {
+        addDocumentOperations: vi.fn().mockResolvedValue(undefined),
+        ...overrides,
+    };
+}
+/**
+ * Factory for creating a complete test reactor setup
+ */
+export async function createTestReactorSetup(documentModels = [
+    documentModelDocumentModelModule,
+    driveDocumentModelModule,
+]) {
+    const storage = new MemoryStorage();
+    const eventBus = new EventBus();
+    const queue = new InMemoryQueue(eventBus);
+    // Create real drive server
+    const builder = new ReactorBuilder(documentModels).withStorage(storage);
+    const driveServer = builder.build();
+    await driveServer.initialize();
+    // Create registry and register modules
+    const registry = new DocumentModelRegistry();
+    registry.registerModules(documentModelDocumentModelModule);
+    // Create job executor
+    const jobExecutor = new SimpleJobExecutor(registry, storage, storage);
+    // Create reactor
+    const reactor = new Reactor(driveServer, storage, eventBus, queue, jobExecutor);
+    return {
+        reactor,
+        driveServer,
+        storage,
+        eventBus,
+        queue,
+        jobExecutor,
+        registry,
+    };
+}
+/**
+ * Factory for creating SimpleJobExecutorManager with dependencies
+ */
+export function createTestJobExecutorManager(queue, eventBus, executor) {
+    const actualQueue = queue || createTestQueue();
+    const actualEventBus = eventBus || createTestEventBus();
+    const actualExecutor = executor || createMockJobExecutor();
+    const manager = new SimpleJobExecutorManager(() => actualExecutor, actualEventBus, actualQueue);
+    return {
+        manager,
+        queue: actualQueue,
+        eventBus: actualEventBus,
+        executor: actualExecutor,
+    };
+}
+/**
+ * Factory for creating test data sets
+ */
+export function createTestJobSet(count, baseOverrides = {}) {
+    return Array.from({ length: count }, (_, i) => createTestJob({
+        id: `job-${i + 1}`,
+        ...baseOverrides,
+        operation: createTestOperation({
+            index: i,
+            action: createTestAction({
+                input: { name: `Action ${i + 1}` },
+            }),
+        }),
+    }));
+}
+/**
+ * Factory for creating jobs with dependencies
+ */
+export function createJobWithDependencies(id, dependencies, overrides = {}) {
+    return createTestJob({
+        id,
+        queueHint: dependencies,
+        ...overrides,
+    });
+}
+/**
+ * Factory for creating a dependency chain of jobs
+ */
+export function createJobDependencyChain(length) {
+    const jobs = [];
+    for (let i = 0; i < length; i++) {
+        const dependencies = i === 0 ? [] : [`job-${i}`];
+        jobs.push(createJobWithDependencies(`job-${i + 1}`, dependencies, {
+            operation: createTestOperation({
+                index: i,
+                action: createTestAction({
+                    input: { name: `Chain Action ${i + 1}` },
+                }),
+            }),
+        }));
+    }
+    return jobs;
+}
+/**
+ * Factory for creating multiple actions for testing
+ */
+export function createTestActions(count, type = "SET_NAME") {
+    return Array.from({ length: count }, (_, i) => createDocumentModelAction(type, {
+        input: { name: `Action ${i + 1}` },
+        timestampUtcMs: String(Date.now() + i * 1000),
+    }));
+}
+/**
+ * Factory for creating mock documents in bulk
+ */
+export function createTestDocuments(count, baseOverrides = {}) {
+    return Array.from({ length: count }, (_, i) => createMockDocument({
+        id: `doc-${i + 1}`,
+        slug: `doc-${i + 1}`,
+        ...baseOverrides,
+    }));
+}
+//# sourceMappingURL=factories.js.map

package/dist/test/factories.js.map

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

package/dist/test/queue.test.js

@@ -1,36 +1,15 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { EventBus } from "../src/events/event-bus.js";
+import { beforeEach, describe, expect, it } from "vitest";
 import { InMemoryQueue } from "../src/queue/queue.js";
 import { QueueEventTypes, } from "../src/queue/types.js";
+import { createTestJob, createMockEventBus, createTestOperation, createJobWithDependencies, createJobDependencyChain, } from "./factories.js";
 describe("InMemoryQueue", () => {
     let queue;
     let eventBus;
     let mockEventBusEmit;
-    const createTestOperation = (overrides = {}) => ({
-        index: 1,
-        timestampUtcMs: new Date().toISOString(),
-        hash: "test-hash",
-        skip: 0,
-        type: "test-operation",
-        input: { test: "data" },
-        id: "op-1",
-        ...overrides,
-    });
-    const createTestJob = (overrides = {}) => ({
-        id: "job-1",
-        documentId: "doc-1",
-        scope: "global",
-        branch: "main",
-        operation: createTestOperation(),
-        createdAt: new Date().toISOString(),
-        retryCount: 0,
-        maxRetries: 3,
-        ...overrides,
-    });
     beforeEach(() => {
-        eventBus = new EventBus();
-        mockEventBusEmit = vi.fn().mockResolvedValue(undefined);
-        eventBus.emit = mockEventBusEmit;
+        const mocks = createMockEventBus();
+        eventBus = mocks.eventBus;
+        mockEventBusEmit = mocks.mockEmit;
         queue = new InMemoryQueue(eventBus);
     });
     describe("enqueue", () => {
@@ -349,6 +328,212 @@ describe("InMemoryQueue", () => {
             expect(await queue.size("doc:with:colons", "scope-with-dashes", "branch_with_underscores")).toBe(1);
         });
     });
+    describe("dependency management", () => {
+        it("should dequeue job with no dependencies immediately", async () => {
+            const job = createTestJob({ id: "job-1", queueHint: [] });
+            await queue.enqueue(job);
+            const dequeuedJob = await queue.dequeue(job.documentId, job.scope, job.branch);
+            expect(dequeuedJob?.id).toBe("job-1");
+        });
+        it("should block job with unmet dependencies", async () => {
+            const job1 = createTestJob({ id: "job-1", queueHint: ["job-0"] });
+            await queue.enqueue(job1);
+            const dequeuedJob = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(dequeuedJob).toBeNull();
+            expect(await queue.size(job1.documentId, job1.scope, job1.branch)).toBe(1);
+        });
+        it("should dequeue job after dependencies are completed", async () => {
+            const job1 = createTestJob({ id: "job-1", queueHint: [] });
+            const job2 = createTestJob({ id: "job-2", queueHint: ["job-1"] });
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            // First job should be dequeued
+            const dequeuedJob1 = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(dequeuedJob1?.id).toBe("job-1");
+            // Second job should be blocked
+            const blockedJob = await queue.dequeue(job2.documentId, job2.scope, job2.branch);
+            expect(blockedJob).toBeNull();
+            // Complete first job
+            await queue.completeJob("job-1");
+            // Now second job should be available
+            const dequeuedJob2 = await queue.dequeue(job2.documentId, job2.scope, job2.branch);
+            expect(dequeuedJob2?.id).toBe("job-2");
+        });
+        it("should handle multiple dependencies", async () => {
+            const job1 = createTestJob({ id: "job-1", queueHint: [] });
+            const job2 = createTestJob({ id: "job-2", queueHint: [] });
+            const job3 = createTestJob({
+                id: "job-3",
+                queueHint: ["job-1", "job-2"],
+            });
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            await queue.enqueue(job3);
+            // Dequeue and complete first job
+            const dequeuedJob1 = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(dequeuedJob1?.id).toBe("job-1");
+            await queue.completeJob("job-1");
+            // Next dequeue should return job-2 (not blocked), not job-3 (still blocked)
+            const nextJob = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(nextJob?.id).toBe("job-2");
+            await queue.completeJob("job-2");
+            // Now job 3 should be available
+            const dequeuedJob3 = await queue.dequeue(job3.documentId, job3.scope, job3.branch);
+            expect(dequeuedJob3?.id).toBe("job-3");
+        });
+        it("should handle dependency chains", async () => {
+            const jobs = createJobDependencyChain(4);
+            for (const job of jobs) {
+                await queue.enqueue(job);
+            }
+            // Process in order
+            const d1 = await queue.dequeue(jobs[0].documentId, jobs[0].scope, jobs[0].branch);
+            expect(d1?.id).toBe("job-1");
+            // Others should be blocked
+            expect(await queue.dequeue(jobs[1].documentId, jobs[1].scope, jobs[1].branch)).toBeNull();
+            expect(await queue.dequeue(jobs[2].documentId, jobs[2].scope, jobs[2].branch)).toBeNull();
+            expect(await queue.dequeue(jobs[3].documentId, jobs[3].scope, jobs[3].branch)).toBeNull();
+            await queue.completeJob("job-1");
+            const d2 = await queue.dequeue(jobs[1].documentId, jobs[1].scope, jobs[1].branch);
+            expect(d2?.id).toBe("job-2");
+            // job-3 and job-4 still blocked
+            expect(await queue.dequeue(jobs[2].documentId, jobs[2].scope, jobs[2].branch)).toBeNull();
+            expect(await queue.dequeue(jobs[3].documentId, jobs[3].scope, jobs[3].branch)).toBeNull();
+            await queue.completeJob("job-2");
+            const d3 = await queue.dequeue(jobs[2].documentId, jobs[2].scope, jobs[2].branch);
+            expect(d3?.id).toBe("job-3");
+            // job-4 still blocked
+            expect(await queue.dequeue(jobs[3].documentId, jobs[3].scope, jobs[3].branch)).toBeNull();
+            await queue.completeJob("job-3");
+            const d4 = await queue.dequeue(jobs[3].documentId, jobs[3].scope, jobs[3].branch);
+            expect(d4?.id).toBe("job-4");
+        });
+        it("should dequeue jobs out of order based on dependencies", async () => {
+            const job1 = createTestJob({ id: "job-1", queueHint: ["job-0"] });
+            const job2 = createTestJob({ id: "job-2", queueHint: [] });
+            const job3 = createTestJob({ id: "job-3", queueHint: [] });
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            await queue.enqueue(job3);
+            // Job 1 is blocked, so job 2 should be dequeued
+            const dequeuedJob = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(dequeuedJob?.id).toBe("job-2");
+        });
+        it("should handle dependencies across different queues", async () => {
+            const job1 = createTestJob({
+                id: "job-1",
+                documentId: "doc-1",
+                queueHint: [],
+            });
+            const job2 = createTestJob({
+                id: "job-2",
+                documentId: "doc-2",
+                queueHint: ["job-1"],
+            });
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            // Job 2 should be blocked even though it's in a different queue
+            const blockedJob = await queue.dequeue("doc-2", "global", "main");
+            expect(blockedJob).toBeNull();
+            // Dequeue and complete job 1
+            const dequeuedJob1 = await queue.dequeue("doc-1", "global", "main");
+            expect(dequeuedJob1?.id).toBe("job-1");
+            await queue.completeJob("job-1");
+            // Now job 2 should be available
+            const dequeuedJob2 = await queue.dequeue("doc-2", "global", "main");
+            expect(dequeuedJob2?.id).toBe("job-2");
+        });
+        it("should work with dequeueNext respecting dependencies", async () => {
+            const job1 = createTestJob({
+                id: "job-1",
+                documentId: "doc-1",
+                queueHint: ["job-0"],
+            });
+            const job2 = createTestJob({
+                id: "job-2",
+                documentId: "doc-2",
+                queueHint: [],
+            });
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            // Should dequeue job-2 since job-1 is blocked
+            const dequeuedJob = await queue.dequeueNext();
+            expect(dequeuedJob?.id).toBe("job-2");
+        });
+        it("should handle circular dependencies by blocking all involved jobs", async () => {
+            const job1 = createJobWithDependencies("job-1", ["job-2"]);
+            const job2 = createJobWithDependencies("job-2", ["job-1"]);
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            // Both jobs should be blocked
+            const dequeuedJob1 = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(dequeuedJob1).toBeNull();
+            const dequeuedJob2 = await queue.dequeue(job2.documentId, job2.scope, job2.branch);
+            expect(dequeuedJob2).toBeNull();
+        });
+        it("should handle self-dependencies by blocking the job", async () => {
+            const job = createJobWithDependencies("job-1", ["job-1"]);
+            await queue.enqueue(job);
+            const dequeuedJob = await queue.dequeue(job.documentId, job.scope, job.branch);
+            expect(dequeuedJob).toBeNull();
+        });
+        it("should clear completed jobs tracking when clearAll is called", async () => {
+            const job1 = createTestJob({ id: "job-1", queueHint: [] });
+            const job2 = createTestJob({ id: "job-2", queueHint: ["job-1"] });
+            await queue.enqueue(job1);
+            // Complete job-1
+            await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            await queue.completeJob("job-1");
+            // Clear all
+            await queue.clearAll();
+            // Re-enqueue job-2 - it should be blocked again since completed jobs were cleared
+            await queue.enqueue(job2);
+            const dequeuedJob = await queue.dequeue(job2.documentId, job2.scope, job2.branch);
+            expect(dequeuedJob).toBeNull();
+        });
+        it("should handle already completed dependencies", async () => {
+            // Complete a job that doesn't exist in queue
+            await queue.completeJob("job-0");
+            // Enqueue a job that depends on it
+            const job1 = createJobWithDependencies("job-1", ["job-0"]);
+            await queue.enqueue(job1);
+            // Should be able to dequeue since dependency is already complete
+            const dequeuedJob = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(dequeuedJob?.id).toBe("job-1");
+        });
+        it("should handle mixed dependencies (some met, some unmet)", async () => {
+            // Complete one dependency
+            await queue.completeJob("job-0");
+            // Enqueue a job with mixed dependencies
+            const job = createTestJob({
+                id: "job-3",
+                queueHint: ["job-0", "job-1", "job-2"],
+            });
+            await queue.enqueue(job);
+            // Should be blocked (job-1 and job-2 not complete)
+            let dequeuedJob = await queue.dequeue(job.documentId, job.scope, job.branch);
+            expect(dequeuedJob).toBeNull();
+            // Complete remaining dependencies
+            await queue.completeJob("job-1");
+            await queue.completeJob("job-2");
+            // Now should be available
+            dequeuedJob = await queue.dequeue(job.documentId, job.scope, job.branch);
+            expect(dequeuedJob?.id).toBe("job-3");
+        });
+        it("should handle failJob without marking as completed", async () => {
+            const job1 = createTestJob({ id: "job-1", queueHint: [] });
+            const job2 = createTestJob({ id: "job-2", queueHint: ["job-1"] });
+            await queue.enqueue(job1);
+            await queue.enqueue(job2);
+            // Dequeue and fail job 1
+            const d1 = await queue.dequeue(job1.documentId, job1.scope, job1.branch);
+            expect(d1?.id).toBe("job-1");
+            await queue.failJob("job-1", "Test error");
+            // Job 2 should still be blocked since job 1 wasn't completed
+            const dequeuedJob = await queue.dequeue(job2.documentId, job2.scope, job2.branch);
+            expect(dequeuedJob).toBeNull();
+        });
+    });
     describe("job properties", () => {
         it("should preserve all job properties", async () => {
             const operation = createTestOperation({
@@ -356,8 +541,13 @@ describe("InMemoryQueue", () => {
                 timestampUtcMs: "2023-01-01T00:00:00.000Z",
                 hash: "custom-hash",
                 skip: 5,
-                type: "custom-operation",
-                input: { custom: "input" },
+                action: {
+                    id: "action-1",
+                    type: "custom-operation",
+                    timestampUtcMs: "2023-01-01T00:00:00.000Z",
+                    input: { custom: "input" },
+                    scope: "global",
+                },
                 error: "test error",
                 id: "custom-op-id",
             });
@@ -383,6 +573,7 @@ describe("InMemoryQueue", () => {
                 branch: "main",
                 operation: createTestOperation(),
                 createdAt: new Date().toISOString(),
+                queueHint: [],
                 // retryCount and maxRetries are optional
             };
             await queue.enqueue(job);