@dudousxd/nestjs-durable-core 0.1.0

package/dist/engine.js

@@ -0,0 +1,588 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteStepError = exports.WorkflowEngine = void 0;
+const duration_1 = require("./duration");
+const errors_1 = require("./errors");
+const protocol_1 = require("./protocol");
+const versionKey = (name, version) => `${name}@${version}`;
+/** True when version `a` is newer than `b` (numeric when both parse as numbers, else natural sort). */
+function isNewerVersion(a, b) {
+    const na = Number(a);
+    const nb = Number(b);
+    if (!Number.isNaN(na) && !Number.isNaN(nb))
+        return na > nb;
+    return a.localeCompare(b, undefined, { numeric: true }) > 0;
+}
+/** Read a `Completion` from a signal payload: return the value, or throw a FatalError if it failed. */
+function unwrapCompletion(payload, label) {
+    const c = payload;
+    if (c && typeof c === 'object' && 'ok' in c && c.ok === false) {
+        throw new errors_1.FatalError(`${label} failed: ${c.error}`);
+    }
+    return c?.value;
+}
+/**
+ * The orchestrator. Owns workflow state and replays runs deterministically: each step's
+ * result is checkpointed, so on resume a completed step returns its saved output instead of
+ * re-executing. Remote steps are dispatched over the Transport; their results checkpoint the
+ * same way local steps do.
+ */
+class WorkflowEngine {
+    store;
+    transport;
+    clock;
+    instanceId;
+    leaseMs;
+    /** Every registered workflow, keyed by `name@version` — so old versions stay runnable. */
+    workflows = new Map();
+    /** The newest registered version per workflow name — used to `start` new runs. */
+    latest = new Map();
+    /** In-flight remote steps awaiting a worker result, keyed by stepId. */
+    pending = new Map();
+    /** Per-step "reset the liveness timer" callbacks, called when a heartbeat arrives. */
+    heartbeatResets = new Map();
+    listeners = new Set();
+    /** Executions currently in flight, so a graceful shutdown can wait for them to settle. */
+    inflight = new Set();
+    draining = false;
+    constructor(deps) {
+        this.store = deps.store;
+        this.transport = deps.transport;
+        this.clock = deps.clock ?? Date.now;
+        this.instanceId = deps.instanceId ?? globalThis.crypto.randomUUID();
+        this.leaseMs = deps.leaseMs ?? 30_000;
+        this.transport?.onResult(async (result) => {
+            const waiter = this.pending.get(result.stepId);
+            if (!waiter)
+                return;
+            this.pending.delete(result.stepId);
+            if (result.status === 'completed') {
+                waiter.resolve(result.output);
+            }
+            else {
+                waiter.reject(new RemoteStepError(result.error));
+            }
+        });
+        // A heartbeat for an in-flight long step resets its liveness window (see callRemote).
+        this.transport?.onHeartbeat(async (beat) => {
+            this.heartbeatResets.get(beat.stepId)?.();
+        });
+    }
+    /**
+     * Register a workflow version. Register multiple versions of the same name to keep in-flight
+     * runs working across a breaking change: old runs resume on the version they started on, new
+     * runs start on the newest registered version.
+     */
+    register(name, version, fn) {
+        const registered = { name, version, fn };
+        this.workflows.set(versionKey(name, version), registered);
+        const current = this.latest.get(name);
+        if (!current || isNewerVersion(version, current.version))
+            this.latest.set(name, registered);
+    }
+    /** Subscribe to lifecycle events. Returns an unsubscribe function. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(event) {
+        const full = { ...event, at: new Date() };
+        for (const listener of this.listeners) {
+            try {
+                listener(full);
+            }
+            catch {
+                // a misbehaving subscriber must never break workflow execution
+            }
+        }
+    }
+    async start(workflow, input, runId) {
+        const registered = this.latest.get(workflow);
+        if (!registered)
+            throw new Error(`workflow ${workflow} is not registered`);
+        // Idempotent by run id: a redelivered trigger (at-least-once queues) or a scheduler re-tick for
+        // the same id is a no-op, returning the existing run's state instead of starting a duplicate.
+        const prior = await this.store.getRun(runId);
+        if (prior) {
+            return { runId, status: prior.status, output: prior.output, error: prior.error };
+        }
+        const now = new Date();
+        const run = {
+            id: runId,
+            workflow,
+            workflowVersion: registered.version,
+            status: 'running',
+            input,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.store.createRun(run);
+        this.emit({ type: 'run.started', runId, workflow });
+        return this.track(this.execute(run, registered.fn));
+    }
+    async resume(runId) {
+        const run = await this.store.getRun(runId);
+        if (!run)
+            throw new Error(`run ${runId} not found`);
+        // Pin to the version the run STARTED on — replay is positional, so running a changed
+        // workflow body against old checkpoints would corrupt the run.
+        const registered = this.workflows.get(versionKey(run.workflow, run.workflowVersion));
+        if (!registered) {
+            throw new Error(`workflow ${run.workflow}@${run.workflowVersion} is not registered — keep the prior version deployed so in-flight runs can drain (skew protection)`);
+        }
+        return this.track(this.execute(run, registered.fn));
+    }
+    /** Track an in-flight execution so {@link drain} can wait for it. */
+    track(p) {
+        this.inflight.add(p);
+        void p.finally(() => this.inflight.delete(p));
+        return p;
+    }
+    /**
+     * Graceful shutdown: stop picking up new runs (recovery/timer become no-ops) and wait for
+     * in-flight executions to settle, up to `timeoutMs`. Call from your app's shutdown hook so a
+     * deploy hands off cleanly instead of leaving runs to the lease timeout.
+     */
+    async drain(timeoutMs = 10_000) {
+        this.draining = true;
+        if (this.inflight.size === 0)
+            return;
+        const timer = new Promise((resolve) => {
+            const t = setTimeout(resolve, timeoutMs);
+            t.unref?.();
+        });
+        await Promise.race([Promise.allSettled([...this.inflight]), timer]);
+    }
+    /**
+     * Resume every run left incomplete by a crash or deploy. Called on boot. Completed steps
+     * replay from their checkpoints, so only the work that had not finished runs again.
+     */
+    async recoverIncomplete() {
+        return this.resumeLeased(await this.store.listIncompleteRuns());
+    }
+    /**
+     * Resume every suspended run whose durable timer is due. Call periodically (a poller) and on
+     * boot. A run still not due re-suspends cheaply without running new work.
+     */
+    async resumeDueTimers(nowMs = this.clock()) {
+        return this.resumeLeased(await this.store.listDueTimers(nowMs), nowMs);
+    }
+    /**
+     * Resume each run only if this instance can acquire its recovery lease — so when several
+     * replicas recover or poll at once, each run is picked up by exactly one of them.
+     */
+    async resumeLeased(runs, nowMs = this.clock()) {
+        if (this.draining)
+            return []; // shutting down — don't pick up new runs
+        const results = [];
+        for (const run of runs) {
+            const acquired = await this.store.tryLockRun(run.id, this.instanceId, nowMs + this.leaseMs, nowMs);
+            if (acquired)
+                results.push(await this.resume(run.id));
+        }
+        return results;
+    }
+    /**
+     * Deliver an external signal to the run waiting on `token` and resume it with `payload`.
+     * Returns the run result, or null if no run is waiting for that token.
+     */
+    async signal(token, payload) {
+        const waiter = await this.store.takeSignalWaiter(token);
+        if (!waiter)
+            return null;
+        const at = new Date();
+        await this.store.saveCheckpoint({
+            runId: waiter.runId,
+            seq: waiter.seq,
+            name: `signal:${token}`,
+            kind: 'signal',
+            stepId: (0, protocol_1.stepId)(waiter.runId, waiter.seq),
+            status: 'completed',
+            output: payload,
+            attempts: 1,
+            startedAt: at,
+            finishedAt: at,
+        });
+        return this.resume(waiter.runId);
+    }
+    /**
+     * Report the result of a `ctx.task(name, …)` back to its run (async completion). The external
+     * worker that the task dispatched to calls this when done; the run resumes with `result`. Returns
+     * null if no run is waiting on the task (e.g. a duplicate/late delivery) — a safe no-op.
+     */
+    async completeTask(runId, name, result) {
+        return this.signal(`task:${runId}:${name}`, { ok: true, value: result });
+    }
+    /** Report that a `ctx.task` failed — the run resumes and throws a FatalError at the task. */
+    async failTask(runId, name, error) {
+        return this.signal(`task:${runId}:${name}`, { ok: false, error });
+    }
+    /**
+     * Notify a parent that's waiting on `runId` as a child of its terminal outcome (the `ctx.child`
+     * rendezvous). A no-op when no parent is waiting, so `execute()` can call it on every run without
+     * knowing about the child feature.
+     */
+    notifyParent(runId, completion) {
+        void this.signal(`child:${runId}`, completion).catch(() => undefined);
+    }
+    /** Cancel a run (e.g. from the dashboard). Returns null if the run does not exist. */
+    async cancel(runId) {
+        const run = await this.store.getRun(runId);
+        if (!run)
+            return null;
+        const error = { message: 'cancelled' };
+        await this.store.updateRun(runId, { status: 'cancelled', error, updatedAt: new Date() });
+        this.emit({ type: 'run.failed', runId, workflow: run.workflow, error });
+        return { runId, status: 'cancelled', error };
+    }
+    /** Checkpoint a finished step and announce it — the two things that must always happen together. */
+    async completeStep(step) {
+        await this.store.saveCheckpoint({
+            runId: step.runId,
+            seq: step.seq,
+            name: step.name,
+            kind: step.kind,
+            stepId: (0, protocol_1.stepId)(step.runId, step.seq),
+            status: 'completed',
+            output: step.output,
+            attempts: step.attempts,
+            workerGroup: step.workerGroup,
+            startedAt: step.startedAt,
+            finishedAt: new Date(),
+        });
+        this.emit({
+            type: 'step.completed',
+            runId: step.runId,
+            seq: step.seq,
+            name: step.name,
+            kind: step.kind,
+            output: step.output,
+            durationMs: Date.now() - step.startedAt.getTime(),
+        });
+    }
+    /** Checkpoint a step that failed terminally, so the failure point is visible (not just the run). */
+    async failStep(step) {
+        await this.store.saveCheckpoint({
+            runId: step.runId,
+            seq: step.seq,
+            name: step.name,
+            kind: step.kind,
+            stepId: (0, protocol_1.stepId)(step.runId, step.seq),
+            status: 'failed',
+            error: step.error,
+            attempts: step.attempts,
+            workerGroup: step.workerGroup,
+            startedAt: step.startedAt,
+            finishedAt: new Date(),
+        });
+        this.emit({
+            type: 'step.failed',
+            runId: step.runId,
+            seq: step.seq,
+            name: step.name,
+            kind: step.kind,
+            error: step.error,
+            durationMs: Date.now() - step.startedAt.getTime(),
+        });
+    }
+    async execute(run, fn) {
+        // Saga compensations registered by completed steps; run in reverse if the run later fails.
+        const compensations = [];
+        const ctx = this.makeCtx(run.id, compensations);
+        try {
+            const output = await fn(ctx, run.input);
+            // Clear any error from an earlier failed-then-retried attempt: a completed run is a success
+            // and must not carry a stale error (otherwise dashboards show a green run with a red error).
+            await this.store.updateRun(run.id, {
+                status: 'completed',
+                output,
+                error: undefined,
+                updatedAt: new Date(),
+            });
+            this.emit({ type: 'run.completed', runId: run.id, workflow: run.workflow, output });
+            // Wake a parent waiting on this run as a child (no-op when there's no parent).
+            void this.notifyParent(run.id, { ok: true, value: output });
+            return { runId: run.id, status: 'completed', output };
+        }
+        catch (err) {
+            if (err instanceof errors_1.WorkflowSuspended) {
+                await this.store.updateRun(run.id, {
+                    status: 'suspended',
+                    wakeAt: err.wakeAt,
+                    updatedAt: new Date(),
+                });
+                this.emit({ type: 'run.suspended', runId: run.id, workflow: run.workflow });
+                return { runId: run.id, status: 'suspended' };
+            }
+            const error = {
+                message: err instanceof Error ? err.message : String(err),
+                stack: err instanceof Error ? err.stack : undefined,
+            };
+            // Saga: undo completed steps in reverse. A compensation that throws is logged-and-skipped so
+            // one bad undo can't strand the rest. (Compensations are best-effort and should be idempotent.)
+            for (let i = compensations.length - 1; i >= 0; i -= 1) {
+                try {
+                    await compensations[i]?.();
+                }
+                catch {
+                    // a failing compensation must not mask the original failure
+                }
+            }
+            await this.store.updateRun(run.id, { status: 'failed', error, updatedAt: new Date() });
+            this.emit({ type: 'run.failed', runId: run.id, workflow: run.workflow, error });
+            void this.notifyParent(run.id, { ok: false, error: error.message });
+            return { runId: run.id, status: 'failed', error };
+        }
+        finally {
+            // Release the recovery lease once the run reaches a terminal/suspended state, so the
+            // next instance (or the timer poller) can pick it up promptly.
+            await this.store.releaseRunLock(run.id);
+        }
+    }
+    makeCtx(runId, compensations) {
+        let seq = -1;
+        const nextSeq = () => {
+            seq += 1;
+            return seq;
+        };
+        const store = this.store;
+        // Each ctx primitive is a named closure over `nextSeq` (the per-run logical position counter)
+        // and `compensations` (the saga undo stack). They're defined up front so `task`/`child` can
+        // compose `step`/`waitForSignal` directly — no post-construction mutation, no cast.
+        const step = async (name, fn, options) => {
+            const current = nextSeq();
+            const existing = await store.getCheckpoint(runId, current);
+            if (existing && existing.status === 'completed') {
+                // Register the compensation on replay too, so a saga undoes ALL completed steps — even
+                // those done in an earlier (since-suspended) pass — not just the ones run this pass.
+                if (options?.compensate)
+                    compensations.push(options.compensate);
+                return existing.output;
+            }
+            const maxAttempts = Math.max(1, options?.retries ?? 1);
+            const startedAt = new Date();
+            for (let attempt = 1;; attempt += 1) {
+                try {
+                    const output = await fn();
+                    await this.completeStep({ runId, seq: current, name, kind: 'local', output, attempts: attempt, startedAt });
+                    if (options?.compensate)
+                        compensations.push(options.compensate);
+                    return output;
+                }
+                catch (err) {
+                    if (err instanceof errors_1.FatalError || attempt >= maxAttempts) {
+                        await this.failStep({
+                            runId,
+                            seq: current,
+                            name,
+                            kind: 'local',
+                            error: {
+                                message: err instanceof Error ? err.message : String(err),
+                                stack: err instanceof Error ? err.stack : undefined,
+                            },
+                            attempts: attempt,
+                            startedAt,
+                        });
+                        throw err;
+                    }
+                }
+            }
+        };
+        const sleep = async (duration) => {
+            const current = nextSeq();
+            const now = this.clock();
+            const existing = await store.getCheckpoint(runId, current);
+            if (existing) {
+                // Timer already recorded: resume if due, otherwise re-suspend cheaply.
+                if (now >= (existing.wakeAt ?? 0))
+                    return;
+                throw new errors_1.WorkflowSuspended(existing.wakeAt ?? now);
+            }
+            const wakeAt = now + (0, duration_1.parseDuration)(duration);
+            await this.recordTimer(runId, current, 'sleep', wakeAt);
+            throw new errors_1.WorkflowSuspended(wakeAt);
+        };
+        // NOTE (determinism): a bounded wait consumes TWO logical positions (deadline + wait), an
+        // unbounded one consumes ONE. So adding or removing `{ timeoutMs }` on an existing
+        // `waitForSignal` shifts the seq of every later step — treat it as a workflow-version change
+        // (register a new @Workflow version) for runs already in flight.
+        const waitForSignal = async (token, opts) => {
+            if (opts?.timeoutMs == null) {
+                const current = nextSeq();
+                const existing = await store.getCheckpoint(runId, current);
+                if (existing && existing.status === 'completed')
+                    return existing.output;
+                await store.putSignalWaiter({ token, runId, seq: current });
+                throw new errors_1.WorkflowSuspended();
+            }
+            const timeoutMs = opts.timeoutMs;
+            const deadlineSeq = nextSeq();
+            const waitSeq = nextSeq();
+            // The deadline is recorded durably as a timer checkpoint so replay knows it; the run also gets
+            // a run-level wakeAt (via WorkflowSuspended) so the timer poller resumes it at the deadline.
+            const recorded = await store.getCheckpoint(runId, deadlineSeq);
+            const deadline = recorded?.wakeAt ?? this.clock() + timeoutMs;
+            if (!recorded)
+                await this.recordTimer(runId, deadlineSeq, `timeout:${token}`, deadline);
+            const waited = await store.getCheckpoint(runId, waitSeq);
+            if (waited && waited.status === 'completed')
+                return waited.output;
+            if (this.clock() >= deadline) {
+                await store.takeSignalWaiter(token).catch(() => undefined);
+                throw new errors_1.SignalTimeoutError(token, timeoutMs);
+            }
+            await store.putSignalWaiter({ token, runId, seq: waitSeq });
+            throw new errors_1.WorkflowSuspended(deadline);
+        };
+        // An external task = a checkpointed dispatch + a wait for its async-completion `Completion`
+        // (delivered by engine.completeTask/failTask). The whole "fire at a foreign system, suspend,
+        // resume when it reports back" pattern as one call.
+        const task = async (name, dispatch, options) => {
+            await step(`task:dispatch:${name}`, dispatch, options);
+            return unwrapCompletion(await waitForSignal(`task:${runId}:${name}`), `task "${name}"`);
+        };
+        // Child workflow: start it once, then suspend on a `child:<id>` waiter the child signals on its
+        // terminal state (see notifyParent). The start is deferred to a microtask so it runs AFTER this
+        // run suspends — a fast child can't reentrantly resume a parent that's still running.
+        const child = async (workflow, input, childId) => {
+            const current = nextSeq();
+            const id = childId ?? `${runId}.child.${current}`;
+            const existing = await store.getCheckpoint(runId, current);
+            if (existing && existing.status === 'completed') {
+                return unwrapCompletion(existing.output, `child "${id}"`);
+            }
+            await store.putSignalWaiter({ token: `child:${id}`, runId, seq: current });
+            if (!(await store.getRun(id))) {
+                queueMicrotask(() => {
+                    void this.start(workflow, input, id).catch(() => undefined);
+                });
+            }
+            throw new errors_1.WorkflowSuspended();
+        };
+        return {
+            runId,
+            step,
+            sleep,
+            waitForSignal,
+            task,
+            child,
+            call: (remote, input) => this.callRemote(runId, nextSeq(), remote, input),
+        };
+    }
+    /** Persist a completed timer checkpoint (a durable sleep / signal deadline) at a logical position. */
+    async recordTimer(runId, seq, name, wakeAt) {
+        const at = new Date();
+        await this.store.saveCheckpoint({
+            runId,
+            seq,
+            name,
+            kind: 'sleep',
+            stepId: (0, protocol_1.stepId)(runId, seq),
+            status: 'completed',
+            wakeAt,
+            attempts: 1,
+            startedAt: at,
+            finishedAt: at,
+        });
+    }
+    async callRemote(runId, seq, step, input) {
+        const existing = await this.store.getCheckpoint(runId, seq);
+        if (existing && existing.status === 'completed') {
+            return existing.output;
+        }
+        if (!this.transport)
+            throw new Error('remote steps require a Transport');
+        const validInput = step.input.parse(input);
+        const id = (0, protocol_1.stepId)(runId, seq);
+        const startedAt = new Date();
+        // Retry policy differs from a LOCAL step on purpose: a local `ctx.step` retries any non-fatal
+        // throw (the work is in-process), but a remote step only re-dispatches on a liveness TIMEOUT
+        // (presumed-dead worker). A worker that *reported* an error returned a deterministic verdict, so
+        // we surface it to the workflow instead of hammering the worker. Timeout retries need a window
+        // to detect death, so they're gated on `timeoutMs` being set.
+        const maxAttempts = step.timeoutMs ? Math.max(1, step.retries ?? 1) : 1;
+        for (let attempt = 1;; attempt += 1) {
+            const resultPromise = new Promise((resolve, reject) => {
+                this.pending.set(id, { resolve, reject });
+            });
+            await this.transport.dispatch({
+                runId,
+                seq,
+                name: step.name,
+                stepId: id,
+                group: step.group,
+                input: validInput,
+                attempt,
+            });
+            try {
+                const rawOutput = step.timeoutMs
+                    ? await this.awaitWithHeartbeat(id, resultPromise, step.timeoutMs)
+                    : await resultPromise;
+                const output = step.output.parse(rawOutput);
+                await this.completeStep({
+                    runId,
+                    seq,
+                    name: step.name,
+                    kind: 'remote',
+                    output,
+                    attempts: attempt,
+                    workerGroup: step.group,
+                    startedAt,
+                });
+                return output;
+            }
+            catch (err) {
+                this.pending.delete(id);
+                if (err instanceof errors_1.RemoteStepTimeout && attempt < maxAttempts)
+                    continue;
+                throw err;
+            }
+        }
+    }
+    /**
+     * Await a remote result, but reject with `RemoteStepTimeout` if neither the result nor a heartbeat
+     * arrives within `timeoutMs`. Each heartbeat (delivered via `transport.onHeartbeat`) rearms the
+     * window, so a worker that keeps beating stays alive past `timeoutMs`.
+     */
+    awaitWithHeartbeat(id, resultPromise, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            let timer;
+            const cleanup = () => {
+                clearTimeout(timer);
+                this.heartbeatResets.delete(id);
+            };
+            const arm = () => {
+                timer = setTimeout(() => {
+                    cleanup();
+                    this.pending.delete(id);
+                    reject(new errors_1.RemoteStepTimeout(id, timeoutMs));
+                }, timeoutMs);
+                timer.unref?.();
+            };
+            this.heartbeatResets.set(id, () => {
+                clearTimeout(timer);
+                arm();
+            });
+            arm();
+            resultPromise.then((value) => {
+                cleanup();
+                resolve(value);
+            }, (err) => {
+                cleanup();
+                reject(err);
+            });
+        });
+    }
+}
+exports.WorkflowEngine = WorkflowEngine;
+/** Raised inside the workflow when a remote worker reports a step failure. */
+class RemoteStepError extends Error {
+    stepError;
+    constructor(stepError) {
+        super(stepError?.message ?? 'remote step failed');
+        this.name = 'RemoteStepError';
+        this.stepError = stepError;
+    }
+}
+exports.RemoteStepError = RemoteStepError;
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Thrown inside a step to signal an unrecoverable failure: the engine will NOT retry it,
+ * regardless of the step's `retries` setting, and fails the run immediately. Use it for
+ * business errors that retrying cannot fix (e.g. a declined card, invalid input).
+ */
+export declare class FatalError extends Error {
+    readonly code?: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Internal control signal thrown to suspend a run (e.g. on a durable sleep). Not an error the
+ * user should throw or catch; the engine uses it to stop execution and persist `wakeAt`.
+ */
+export declare class SignalTimeoutError extends Error {
+    readonly token: string;
+    readonly timeoutMs: number;
+    constructor(token: string, timeoutMs: number);
+}
+/**
+ * Thrown when a remote step produces no result and no heartbeat within its `timeoutMs` window —
+ * i.e. the worker is presumed dead. Subject to the step's `retries` (it's retryable), so the engine
+ * re-dispatches before giving up.
+ */
+export declare class RemoteStepTimeout extends Error {
+    readonly stepId: string;
+    readonly timeoutMs: number;
+    constructor(stepId: string, timeoutMs: number);
+}
+export declare class WorkflowSuspended extends Error {
+    /** Epoch ms to auto-resume (durable sleep), or undefined when waiting on an external signal. */
+    readonly wakeAt?: number;
+    constructor(wakeAt?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK3C;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM7C;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM9C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBACb,MAAM,CAAC,EAAE,MAAM;CAK5B"}