flingit 0.0.63 → 0.0.65

package/node_modules/flingflow/dist/engine.js

@@ -0,0 +1,306 @@
+import { ok, err } from "neverthrow";
+import { isApplicationFailure } from "determined";
+import { UniqueConstraintError } from "./store.js";
+import { SystemClock } from "./clock.js";
+import { resolveTransition } from "./transitions.js";
+import { buildContext } from "./context.js";
+import { calculateBackoffMS } from "./backoff.js";
+function toError(e) {
+    if (e instanceof Error)
+        return e;
+    return new Error(String(e));
+}
+export class UnknownWorkflowError extends Error {
+    constructor(name) {
+        super(`Unknown workflow: ${name}`);
+        this.name = "UnknownWorkflowError";
+    }
+}
+function extractConfig(payload) {
+    return payload.config;
+}
+export class Engine {
+    store;
+    registry;
+    clock;
+    generateId;
+    constructor(config) {
+        this.store = config.store;
+        this.registry = config.registry;
+        this.clock = config.clock ?? new SystemClock();
+        this.generateId = config.generateId ?? (() => crypto.randomUUID());
+    }
+    async initialize() {
+        return this.store.initialize();
+    }
+    async createWorkflow(workflowId, name, writes, sim) {
+        const def = this.registry.get(name);
+        if (!def) {
+            return err(new UnknownWorkflowError(name));
+        }
+        const config = {
+            maxAttempts: def.maxAttempts,
+            initialBackoffMS: def.initialBackoffMS,
+            backoffMultiplier: def.backoffMultiplier,
+            maxBackoffMS: def.maxBackoffMS,
+            stepTimeoutMS: def.stepTimeoutMS,
+        };
+        const runId = this.generateId();
+        try {
+            await sim.checkpoint("createWorkflow:before-append", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        const event = {
+            run_id: runId,
+            workflow_id: workflowId,
+            seq: 0,
+            event_type: "workflow_created",
+            payload: { workflowName: name, writes, config },
+            created_at: this.clock.now(),
+        };
+        const result = await this.store.appendIfNoActiveWorkflow(workflowId, event, sim);
+        if (result.isErr()) {
+            return err(result.error);
+        }
+        try {
+            await sim.checkpoint("createWorkflow:after-append", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        return ok(runId);
+    }
+    async claimStep(runId, sim) {
+        const lastEventResult = await this.store.getLastEvent(runId, sim);
+        if (lastEventResult.isErr())
+            return err(lastEventResult.error);
+        const lastEvent = lastEventResult.value;
+        try {
+            await sim.checkpoint("claimStep:after-getLastEvent", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        if (!lastEvent)
+            return ok(null);
+        const workflowId = lastEvent.workflow_id;
+        // Get workflow definition and config from event 0
+        const event0Result = await this.store.getEvent(runId, 0, sim);
+        if (event0Result.isErr())
+            return err(event0Result.error);
+        const event0 = event0Result.value;
+        if (event0?.event_type !== "workflow_created")
+            return ok(null);
+        const workflowName = event0.payload.workflowName;
+        const def = this.registry.get(workflowName);
+        if (!def)
+            return ok(null);
+        const config = extractConfig(event0.payload);
+        const transition = resolveTransition(lastEvent, config.maxAttempts);
+        // Unreachable: commitStep/executeStep write terminal events atomically
+        // with step_completed/step_failed via appendBatch. Seeing these transitions
+        // means the event log has been corrupted externally.
+        if (transition.action === "complete_workflow" || transition.action === "fail_workflow") {
+            return err(new Error(`Invariant violation: unexpected transition "${transition.action}" for run ${runId} ` +
+                `(last event: ${lastEvent.event_type} seq ${lastEvent.seq})`));
+        }
+        if (transition.action !== "start_step")
+            return ok(null);
+        // Enforce backoff: if this is a retry after step_failed, check if enough time has elapsed
+        if (lastEvent.event_type === "step_failed") {
+            const backoffMS = calculateBackoffMS(config, transition.attempt);
+            const elapsed = this.clock.now() - lastEvent.created_at;
+            if (elapsed < backoffMS)
+                return ok(null);
+        }
+        const stepStartedEvent = {
+            run_id: runId,
+            workflow_id: workflowId,
+            seq: lastEvent.seq + 1,
+            event_type: "step_started",
+            payload: { step: transition.step, attempt: transition.attempt },
+            created_at: this.clock.now(),
+        };
+        const appendResult = await this.store.append(stepStartedEvent, sim);
+        if (appendResult.isErr())
+            return err(appendResult.error);
+        try {
+            await sim.checkpoint("claimStep:after-append", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        const initialWrites = event0.payload.writes;
+        return ok({
+            workflowId,
+            runId,
+            workflowName,
+            step: transition.step,
+            attempt: transition.attempt,
+            seq: stepStartedEvent.seq,
+            initialWrites,
+            config,
+        });
+    }
+    async executeStep(runId, sim) {
+        const claimResult = await this.claimStep(runId, sim);
+        if (claimResult.isErr()) {
+            // UniqueConstraintError = normal contention (another worker claimed the step).
+            // Return true: the workflow is still active, caller should keep trying.
+            if (claimResult.error instanceof UniqueConstraintError)
+                return ok(true);
+            return err(claimResult.error);
+        }
+        const claim = claimResult.value;
+        if (!claim)
+            return ok(false);
+        const def = this.registry.get(claim.workflowName);
+        if (!def)
+            return ok(false);
+        try {
+            await sim.failpoint("executeStep:before-fn", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        const buildResult = await buildContext(this.store, runId, claim.workflowId, claim.step, claim.initialWrites, sim);
+        if (buildResult.isErr())
+            return err(buildResult.error);
+        const { ctx, getPendingWrites } = buildResult.value;
+        // Only catch errors from the workflow function itself.
+        // Failpoint/store errors propagate out (they represent crashes).
+        let continuation;
+        try {
+            continuation = await def.fn(ctx);
+        }
+        catch (fnErr) {
+            const retryable = !isApplicationFailure(fnErr) || !fnErr.nonRetryable;
+            const reason = fnErr instanceof Error ? fnErr.message : String(fnErr);
+            const terminal = !retryable || claim.attempt >= claim.config.maxAttempts;
+            const failedEvent = {
+                run_id: runId,
+                workflow_id: claim.workflowId,
+                seq: claim.seq + 1,
+                event_type: "step_failed",
+                payload: {
+                    step: claim.step,
+                    attempt: claim.attempt,
+                    reason,
+                    retryable,
+                },
+                created_at: this.clock.now(),
+            };
+            if (terminal) {
+                const terminalReason = !retryable
+                    ? reason
+                    : `max attempts (${claim.config.maxAttempts}) exceeded: ${reason}`;
+                const workflowFailedEvent = {
+                    run_id: runId,
+                    workflow_id: claim.workflowId,
+                    seq: claim.seq + 2,
+                    event_type: "workflow_failed",
+                    payload: { reason: terminalReason, cause: retryable ? "max_attempts_exceeded" : "non_retryable" },
+                    created_at: this.clock.now(),
+                };
+                const result = await this.store.appendBatch([failedEvent, workflowFailedEvent], sim);
+                if (result.isErr()) {
+                    // UniqueConstraintError = recovery already wrote step_failed at this seq
+                    if (result.error instanceof UniqueConstraintError)
+                        return ok(true);
+                    return err(result.error);
+                }
+            }
+            else {
+                const result = await this.store.append(failedEvent, sim);
+                if (result.isErr()) {
+                    if (result.error instanceof UniqueConstraintError)
+                        return ok(true);
+                    return err(result.error);
+                }
+                // Return backoff info for non-terminal retryable failures
+                const nextBackoffMS = calculateBackoffMS(claim.config, claim.attempt + 1);
+                if (nextBackoffMS > 0)
+                    return ok({ backoffMS: nextBackoffMS });
+            }
+            return ok(true);
+        }
+        try {
+            await sim.failpoint("executeStep:after-fn", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        const commitResult = await this.commitStep(runId, claim.workflowId, claim.seq, claim.step, getPendingWrites(), continuation, sim);
+        if (commitResult.isErr()) {
+            // UniqueConstraintError = recovery wrote step_failed at our seq while we were executing
+            if (commitResult.error instanceof UniqueConstraintError)
+                return ok(true);
+            return err(commitResult.error);
+        }
+        return ok(true);
+    }
+    async commitStep(runId, workflowId, claimSeq, step, writes, continuation, sim) {
+        try {
+            await sim.failpoint("commitStep:before-append", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        if ("done" in continuation) {
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-boolean-literal-compare, @typescript-eslint/no-unnecessary-condition -- runtime guard against invalid continuations
+            if (continuation.done !== true) {
+                return err(new Error("Invalid continuation: done must be true"));
+            }
+            const events = [
+                {
+                    run_id: runId,
+                    workflow_id: workflowId,
+                    seq: claimSeq + 1,
+                    event_type: "step_completed",
+                    payload: { step, writes },
+                    created_at: this.clock.now(),
+                },
+                {
+                    run_id: runId,
+                    workflow_id: workflowId,
+                    seq: claimSeq + 2,
+                    event_type: "workflow_completed",
+                    payload: { result: continuation.result },
+                    created_at: this.clock.now(),
+                },
+            ];
+            const result = await this.store.appendBatch(events, sim);
+            if (result.isErr())
+                return err(result.error);
+        }
+        else {
+            const event = {
+                run_id: runId,
+                workflow_id: workflowId,
+                seq: claimSeq + 1,
+                event_type: "step_completed",
+                payload: { step, writes, next_step: continuation.step },
+                created_at: this.clock.now(),
+            };
+            const result = await this.store.append(event, sim);
+            if (result.isErr())
+                return err(result.error);
+        }
+        return ok(undefined);
+    }
+    async runToCompletion(runId, sim) {
+        for (;;) {
+            const stepResult = await this.executeStep(runId, sim);
+            if (stepResult.isErr())
+                return err(stepResult.error);
+            const outcome = stepResult.value;
+            // false = terminal/done, { backoffMS } = backoff pending (caller must wait)
+            if (outcome === false || typeof outcome === "object")
+                break;
+        }
+        return ok(undefined);
+    }
+}
+//# sourceMappingURL=engine.js.map

package/node_modules/flingflow/dist/engine.js.map

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

package/node_modules/flingflow/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { Continuation, Ctx, WorkflowFn, WorkflowEvent, EventType, ClaimResult, StepOutcome, WorkflowConfig, WorkflowCreatedPayload, StepStartedPayload, StepCompletedPayload, StepFailedPayload, WorkflowCompletedPayload, WorkflowFailedPayload, WorkflowFailureCause, SimulationTask, } from "./types.js";
+export { ApplicationFailure, isApplicationFailure, NonRetryableError, TERMINAL_EVENT_TYPES } from "./types.js";
+export { calculateBackoffMS } from "./backoff.js";
+export type { Clock } from "./clock.js";
+export { SystemClock, ManualClock } from "./clock.js";
+export type { TransitionResult } from "./transitions.js";
+export { resolveTransition } from "./transitions.js";
+export type { EventStore, EventStoreCheck, AppendError, AppendIfNoActiveError } from "./store.js";
+export { UniqueConstraintError, WorkflowAlreadyActiveError, WorkflowIdMismatchError } from "./store.js";
+export { MemoryEventStore } from "./store-memory.js";
+export { SqliteEventStore } from "./store-sqlite.js";
+export { buildContext } from "./context.js";
+export type { WorkflowDefinition } from "./registry.js";
+export { WorkflowRegistry } from "./registry.js";
+export type { EngineConfig, CreateWorkflowError } from "./engine.js";
+export { Engine, UnknownWorkflowError } from "./engine.js";
+export type { RecoveryConfig, RecoveryReason, RecoveryResult } from "./recovery.js";
+export { runRecovery } from "./recovery.js";

package/node_modules/flingflow/dist/index.js

@@ -0,0 +1,14 @@
+export { ApplicationFailure, isApplicationFailure, NonRetryableError, TERMINAL_EVENT_TYPES } from "./types.js";
+// Backoff
+export { calculateBackoffMS } from "./backoff.js";
+export { SystemClock, ManualClock } from "./clock.js";
+export { resolveTransition } from "./transitions.js";
+export { UniqueConstraintError, WorkflowAlreadyActiveError, WorkflowIdMismatchError } from "./store.js";
+export { MemoryEventStore } from "./store-memory.js";
+export { SqliteEventStore } from "./store-sqlite.js";
+// Context
+export { buildContext } from "./context.js";
+export { WorkflowRegistry } from "./registry.js";
+export { Engine, UnknownWorkflowError } from "./engine.js";
+export { runRecovery } from "./recovery.js";
+//# sourceMappingURL=index.js.map

package/node_modules/flingflow/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/G,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIlD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAIjD,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAI3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/node_modules/flingflow/dist/recovery.d.ts

@@ -0,0 +1,16 @@
+import { type Result } from "neverthrow";
+import type { SimulationTask } from "determined";
+import { type EventStore } from "./store.js";
+import type { Clock } from "./clock.js";
+import type { WorkflowRegistry } from "./registry.js";
+export interface RecoveryConfig {
+    store: EventStore;
+    registry: WorkflowRegistry;
+    clock: Clock;
+}
+export type RecoveryReason = "timeout" | "stuck_created" | "stuck_completed" | "stuck_failed" | "stuck_terminal";
+export interface RecoveryResult {
+    runId: string;
+    reason: RecoveryReason;
+}
+export declare function runRecovery(config: RecoveryConfig, sim: SimulationTask): Promise<Result<RecoveryResult[], Error>>;

package/node_modules/flingflow/dist/recovery.js

@@ -0,0 +1,118 @@
+import { ok, err } from "neverthrow";
+import { UniqueConstraintError } from "./store.js";
+import { resolveTransition } from "./transitions.js";
+import { calculateBackoffMS } from "./backoff.js";
+function toError(e) {
+    if (e instanceof Error)
+        return e;
+    return new Error(String(e));
+}
+function extractConfig(payload) {
+    return payload.config;
+}
+export async function runRecovery(config, sim) {
+    const { store, registry, clock } = config;
+    const recovered = [];
+    try {
+        await sim.checkpoint("recovery:before-getActiveWorkflows");
+    }
+    catch (e) {
+        return err(toError(e));
+    }
+    const activeResult = await store.getActiveWorkflows(sim);
+    if (activeResult.isErr())
+        return err(activeResult.error);
+    const activeWorkflows = activeResult.value;
+    for (const lastEvent of activeWorkflows) {
+        const runId = lastEvent.run_id;
+        const workflowId = lastEvent.workflow_id;
+        try {
+            await sim.checkpoint("recovery:per-workflow", runId);
+        }
+        catch (e) {
+            return err(toError(e));
+        }
+        // Get workflow definition for timeout and maxAttempts
+        const event0Result = await store.getEvent(runId, 0, sim);
+        if (event0Result.isErr())
+            return err(event0Result.error);
+        const event0 = event0Result.value;
+        if (event0?.event_type !== "workflow_created")
+            continue;
+        const workflowName = event0.payload.workflowName;
+        const def = registry.get(workflowName);
+        if (!def)
+            continue;
+        const config = extractConfig(event0.payload);
+        if (lastEvent.event_type === "step_started") {
+            // Check for timeout
+            const elapsed = clock.now() - lastEvent.created_at;
+            if (elapsed >= config.stepTimeoutMS) {
+                const payload = lastEvent.payload;
+                const terminal = payload.attempt >= config.maxAttempts;
+                const failedEvent = {
+                    run_id: runId,
+                    workflow_id: workflowId,
+                    seq: lastEvent.seq + 1,
+                    event_type: "step_failed",
+                    payload: {
+                        step: payload.step,
+                        attempt: payload.attempt,
+                        reason: "timeout",
+                        retryable: true,
+                    },
+                    created_at: clock.now(),
+                };
+                if (terminal) {
+                    const workflowFailedEvent = {
+                        run_id: runId,
+                        workflow_id: workflowId,
+                        seq: lastEvent.seq + 2,
+                        event_type: "workflow_failed",
+                        payload: { reason: `max attempts (${config.maxAttempts}) exceeded: timeout`, cause: "max_attempts_exceeded" },
+                        created_at: clock.now(),
+                    };
+                    const result = await store.appendBatch([failedEvent, workflowFailedEvent], sim);
+                    if (result.isErr()) {
+                        if (result.error instanceof UniqueConstraintError)
+                            continue;
+                        return err(result.error);
+                    }
+                    recovered.push({ runId, reason: "timeout" });
+                }
+                else {
+                    const result = await store.append(failedEvent, sim);
+                    if (result.isErr()) {
+                        if (result.error instanceof UniqueConstraintError)
+                            continue;
+                        return err(result.error);
+                    }
+                    recovered.push({ runId, reason: "timeout" });
+                }
+            }
+        }
+        else {
+            // workflow_created, step_completed, or step_failed (retryable)
+            // These should have a step running but don't — they're stuck
+            const transition = resolveTransition(lastEvent, config.maxAttempts);
+            if (transition.action === "start_step") {
+                // Check if within backoff window (step_failed only — not stuck, just waiting)
+                if (lastEvent.event_type === "step_failed") {
+                    const backoffMS = calculateBackoffMS(config, transition.attempt);
+                    const elapsed = clock.now() - lastEvent.created_at;
+                    if (elapsed < backoffMS)
+                        continue;
+                }
+                const reason = lastEvent.event_type === "workflow_created" ? "stuck_created" :
+                    lastEvent.event_type === "step_completed" ? "stuck_completed" :
+                        "stuck_failed";
+                recovered.push({ runId, reason });
+            }
+            else if (transition.action === "complete_workflow" || transition.action === "fail_workflow") {
+                recovered.push({ runId, reason: "stuck_terminal" });
+            }
+        }
+    }
+    return ok(recovered);
+}
+//# sourceMappingURL=recovery.js.map

package/node_modules/flingflow/dist/recovery.js.map

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

package/node_modules/flingflow/dist/registry.d.ts

@@ -0,0 +1,24 @@
+import type { WorkflowFn } from "./types.js";
+export interface WorkflowDefinition {
+    name: string;
+    fn: WorkflowFn;
+    maxAttempts: number;
+    initialBackoffMS: number;
+    backoffMultiplier: number;
+    maxBackoffMS: number;
+    stepTimeoutMS: number;
+}
+export declare class WorkflowRegistry {
+    private workflows;
+    register(def: {
+        name: string;
+        fn: WorkflowFn;
+        maxAttempts?: number;
+        initialBackoffMS?: number;
+        backoffMultiplier?: number;
+        maxBackoffMS?: number;
+        stepTimeoutMS?: number;
+    }): void;
+    get(name: string): WorkflowDefinition | undefined;
+    has(name: string): boolean;
+}

package/node_modules/flingflow/dist/registry.js

@@ -0,0 +1,29 @@
+const DEFAULT_MAX_ATTEMPTS = 5;
+const DEFAULT_INITIAL_BACKOFF_MS = 1000;
+const DEFAULT_BACKOFF_MULTIPLIER = 2;
+const DEFAULT_MAX_BACKOFF_MS = 60_000;
+const DEFAULT_STEP_TIMEOUT_MS = 300_000;
+export class WorkflowRegistry {
+    workflows = new Map();
+    register(def) {
+        if (this.workflows.has(def.name)) {
+            throw new Error(`Workflow "${def.name}" is already registered`);
+        }
+        this.workflows.set(def.name, {
+            name: def.name,
+            fn: def.fn,
+            maxAttempts: def.maxAttempts ?? DEFAULT_MAX_ATTEMPTS,
+            initialBackoffMS: def.initialBackoffMS ?? DEFAULT_INITIAL_BACKOFF_MS,
+            backoffMultiplier: def.backoffMultiplier ?? DEFAULT_BACKOFF_MULTIPLIER,
+            maxBackoffMS: def.maxBackoffMS ?? DEFAULT_MAX_BACKOFF_MS,
+            stepTimeoutMS: def.stepTimeoutMS ?? DEFAULT_STEP_TIMEOUT_MS,
+        });
+    }
+    get(name) {
+        return this.workflows.get(name);
+    }
+    has(name) {
+        return this.workflows.has(name);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/node_modules/flingflow/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAYA,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,0BAA0B,GAAG,IAAI,CAAC;AACxC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AACrC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AACtC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAExC,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE1D,QAAQ,CAAC,GAQR;QACC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE;YAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,oBAAoB;YACpD,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,0BAA0B;YACpE,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,0BAA0B;YACtE,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,sBAAsB;YACxD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,uBAAuB;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}

package/node_modules/flingflow/dist/store-memory.d.ts

@@ -0,0 +1,29 @@
+import { type Result } from "neverthrow";
+import type { SimulationTask } from "determined";
+import { type WorkflowEvent } from "./types.js";
+import { type EventStore, type EventStoreCheck, type AppendError, type AppendIfNoActiveError } from "./store.js";
+export declare class MemoryEventStore implements EventStore {
+    private events;
+    private checkFn;
+    constructor(options?: {
+        check?: EventStoreCheck;
+        tableName?: string;
+    });
+    initialize(): Promise<Result<void, Error>>;
+    private getRunMap;
+    private serialize;
+    private deserialize;
+    private collectEvents;
+    private runCheck;
+    private validateWorkflowId;
+    private getLastEventSync;
+    append(event: WorkflowEvent, sim: SimulationTask): Promise<Result<void, AppendError>>;
+    appendBatch(events: WorkflowEvent[], sim: SimulationTask): Promise<Result<void, AppendError>>;
+    appendIfNoActiveWorkflow(workflowId: string, event: WorkflowEvent, sim: SimulationTask): Promise<Result<void, AppendIfNoActiveError>>;
+    getLastEvent(runId: string, sim: SimulationTask): Promise<Result<WorkflowEvent | null, Error>>;
+    getEvent(runId: string, seq: number, sim: SimulationTask): Promise<Result<WorkflowEvent | null, Error>>;
+    getCompletedEvents(runId: string, sim: SimulationTask): Promise<Result<WorkflowEvent[], Error>>;
+    getAllEvents(runId: string, sim: SimulationTask): Promise<Result<WorkflowEvent[], Error>>;
+    getRecentRuns(limit: number, sim: SimulationTask): Promise<Result<WorkflowEvent[], Error>>;
+    getActiveWorkflows(sim: SimulationTask): Promise<Result<WorkflowEvent[], Error>>;
+}