@relkit/providers-local 0.0.0

package/dist/jobs/scheduler.js

@@ -0,0 +1,122 @@
+import { canonicalJson, deepFreeze, normalizeId, } from "@relkit/contracts";
+import { nextCronFire } from "./cron.js";
+export class ScheduleValidationError extends TypeError {
+    code = "RELKIT_SCHEDULE_INVALID";
+    constructor(message) {
+        super(message);
+        this.name = "ScheduleValidationError";
+    }
+}
+/** Validates a static schedule and hides the cron parser behind native dates. */
+export function compileSchedule(schedule, options = {}) {
+    try {
+        if (!isRecord(schedule))
+            throw new Error("Schedule must be an object");
+        const id = normalizeId(schedule.id);
+        const cron = requiredText(schedule.cron, "cron").replace(/\s+/g, " ");
+        if (cron.split(" ").length !== 5)
+            throw new Error("cron must have five fields");
+        const timezone = requiredText(schedule.timezone, "timezone");
+        if (!Object.prototype.hasOwnProperty.call(schedule, "input"))
+            throw new Error("schedule.input is required");
+        const input = JSON.parse(canonicalJson(schedule.input));
+        const overlap = schedule.overlap;
+        if (overlap !== "skip" && overlap !== "allow")
+            throw new Error("overlap must be skip or allow");
+        const currentDate = validDate(options.currentDate ?? new Date(0), "current date");
+        const first = parseNext(cron, timezone, currentDate);
+        return deepFreeze({
+            id,
+            cron,
+            timezone,
+            input: deepFreeze(input),
+            overlap,
+            nextFireAt: first,
+            nextFire: (date) => parseNext(cron, timezone, validDate(date, "current date")),
+        });
+    }
+    catch (cause) {
+        if (cause instanceof ScheduleValidationError)
+            throw cause;
+        throw new ScheduleValidationError(cause instanceof Error ? cause.message : String(cause));
+    }
+}
+/** Runs due schedules against an injected clock without owning or calling handlers. */
+export function createScheduler(options = {}) {
+    const readClock = options.clock?.now ?? options.now ?? (() => new Date());
+    const states = new Map();
+    const register = (schedule, enqueue) => {
+        if (typeof enqueue !== "function")
+            throw new TypeError("Schedule enqueue target is required");
+        const compiled = compileSchedule(schedule, { currentDate: readDate(readClock()) });
+        if (states.has(compiled.id))
+            throw new ScheduleValidationError(`Duplicate schedule "${compiled.id}"`);
+        states.set(compiled.id, {
+            compiled,
+            enqueue,
+            nextFireAt: compiled.nextFireAt.getTime(),
+            active: 0,
+        });
+        return compiled;
+    };
+    for (const registration of options.schedules ?? [])
+        register(registration.schedule, registration.enqueue);
+    const nextFire = (scheduleId) => {
+        const state = states.get(normalizeId(scheduleId));
+        return state === undefined ? undefined : new Date(state.nextFireAt);
+    };
+    const runDue = async (currentDate) => {
+        const now = readDate(currentDate ?? readClock()).getTime();
+        const runs = [];
+        for (const state of [...states.values()].sort((a, b) => a.compiled.id.localeCompare(b.compiled.id))) {
+            while (state.nextFireAt <= now) {
+                const fireAt = new Date(state.nextFireAt);
+                state.nextFireAt = state.compiled.nextFire(fireAt).getTime();
+                if (state.compiled.overlap === "skip" && state.active > 0) {
+                    runs.push(Promise.resolve({ scheduleId: state.compiled.id, fireAt, status: "skipped" }));
+                    continue;
+                }
+                state.active += 1;
+                runs.push(Promise.resolve()
+                    .then(() => state.enqueue(state.compiled.input, { scheduleId: state.compiled.id, fireAt }))
+                    .then((result) => ({
+                    scheduleId: state.compiled.id,
+                    fireAt,
+                    status: "enqueued",
+                    result,
+                }))
+                    .finally(() => {
+                    state.active -= 1;
+                }));
+            }
+        }
+        return Promise.all(runs);
+    };
+    return Object.freeze({ register, nextFire, runDue, tick: runDue });
+}
+function parseNext(cron, timezone, currentDate) {
+    try {
+        return nextCronFire(cron, { timezone, currentDate });
+    }
+    catch (cause) {
+        throw new ScheduleValidationError(`Invalid cron/timezone: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+}
+function requiredText(value, name) {
+    if (typeof value !== "string" || value.trim() === "")
+        throw new Error(`${name} is required`);
+    return value.trim();
+}
+function validDate(value, name) {
+    const date = new Date(value.getTime());
+    if (!Number.isFinite(date.getTime()))
+        throw new ScheduleValidationError(`${name} is invalid`);
+    return date;
+}
+function readDate(value) {
+    return validDate(typeof value === "number" ? new Date(value) : value, "clock date");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/jobs/scheduler.js.map

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

package/dist/jobs/store-files.d.ts

@@ -0,0 +1,20 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { JobRecord, JobStoreCheckpoint, JobStoreIndex } from "./store.js";
+export declare const STORE_VERSION: 1;
+export interface JobStorePaths {
+    readonly records: string;
+    readonly index: string;
+    readonly checkpoint: string;
+}
+export declare function ensureJobRoot(requestedRoot: string): string;
+export declare function createJobStorePaths(root: string): JobStorePaths;
+export declare function makeMetadata(records: readonly JobRecord[]): {
+    readonly index: JobStoreIndex;
+    readonly checkpoint: JobStoreCheckpoint;
+};
+export declare function recoverJobRecords(path: string, root: string, validateData?: (data: JsonValue) => void): Promise<readonly JobRecord[]>;
+export declare function parseJobRecord(value: unknown): JobRecord;
+export declare function readJobMetadata<T>(path: string, root: string, guard: (value: unknown) => value is T): Promise<T | undefined>;
+export declare function writeJobMetadata(indexPath: string, checkpointPath: string, index: JobStoreIndex, checkpoint: JobStoreCheckpoint, afterIndex?: () => void | Promise<void>, afterCheckpoint?: () => void | Promise<void>): Promise<void>;
+export declare function appendDurably(path: string, value: string): Promise<void>;
+//# sourceMappingURL=store-files.d.ts.map

package/dist/jobs/store-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-files.d.ts","sourceRoot":"","sources":["../../src/jobs/store-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EAAiB,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9F,eAAO,MAAM,aAAa,EAAG,CAAU,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AACD,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAK3D;AACD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAM/D;AACD,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG;IAC3D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC,CAoBA;AACD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GACvC,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CA+B/B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAuBxD;AAED,wBAAsB,eAAe,CAAC,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACpC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAiBxB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,kBAAkB,EAC9B,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACvC,eAAe,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9E"}

package/dist/jobs/store-files.js

@@ -0,0 +1,177 @@
+import { randomUUID } from "node:crypto";
+import { open, readFile, rename, rm } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { canonicalJson, deepFreeze } from "@relkit/contracts";
+import { ensureOwnedDirectory, quarantineStateFile } from "../state.js";
+export const STORE_VERSION = 1;
+export function ensureJobRoot(requestedRoot) {
+    if (requestedRoot.trim() === "")
+        throw new Error("Job state root is empty");
+    const root = ensureOwnedDirectory(requestedRoot);
+    if (root === resolve("/"))
+        throw new Error("Job state root is too broad");
+    return root;
+}
+export function createJobStorePaths(root) {
+    return Object.freeze({
+        records: join(root, "records.ndjson"),
+        index: join(root, "index.json"),
+        checkpoint: join(root, "checkpoint.json"),
+    });
+}
+export function makeMetadata(records) {
+    const entries = {};
+    let offset = 0;
+    let sequence = 0;
+    for (const record of records) {
+        entries[record.instanceId] = { sequence: record.sequence, offset };
+        offset += Buffer.byteLength(`${canonicalJson(record)}\n`);
+        sequence = Math.max(sequence, record.sequence);
+    }
+    const commit = sequence;
+    return {
+        index: Object.freeze({ version: STORE_VERSION, commit, entries: Object.freeze(entries) }),
+        checkpoint: Object.freeze({
+            version: STORE_VERSION,
+            commit,
+            sequence,
+            offset,
+            recordCount: records.length,
+        }),
+    };
+}
+export async function recoverJobRecords(path, root, validateData) {
+    let contents;
+    try {
+        contents = await readFile(path, "utf8");
+    }
+    catch (cause) {
+        if (cause.code === "ENOENT") {
+            await writeDurably(path, "");
+            return [];
+        }
+        throw new Error("Job records cannot be read");
+    }
+    const records = [];
+    const sequences = new Set();
+    let malformed = false;
+    for (const line of contents.split("\n")) {
+        if (line === "")
+            continue;
+        try {
+            const record = parseJobRecord(JSON.parse(line));
+            validateData?.(record.data);
+            if (sequences.has(record.sequence))
+                throw new Error("duplicate sequence");
+            sequences.add(record.sequence);
+            records.push(record);
+        }
+        catch {
+            malformed = true;
+        }
+    }
+    if (!malformed)
+        return records;
+    await quarantineStateFile(path, root);
+    await syncDirectory(root);
+    await writeDurably(path, records.map((record) => `${canonicalJson(record)}\n`).join(""));
+    return records;
+}
+export function parseJobRecord(value) {
+    if (!isRecord(value) || value.version !== STORE_VERSION) {
+        throw new Error("Job record is malformed");
+    }
+    if (!isPositiveCount(value.sequence) ||
+        typeof value.instanceId !== "string" ||
+        value.instanceId.trim() === "" ||
+        typeof value.kind !== "string" ||
+        value.kind.trim() === "" ||
+        !isCount(value.timestamp)) {
+        throw new Error("Job record is malformed");
+    }
+    const data = deepFreeze(JSON.parse(canonicalJson(value.data)));
+    return Object.freeze({
+        version: STORE_VERSION,
+        sequence: value.sequence,
+        instanceId: value.instanceId,
+        kind: value.kind,
+        timestamp: value.timestamp,
+        data,
+    });
+}
+export async function readJobMetadata(path, root, guard) {
+    let contents;
+    try {
+        contents = await readFile(path, "utf8");
+    }
+    catch (cause) {
+        if (cause.code === "ENOENT")
+            return undefined;
+        throw new Error("Job metadata cannot be read");
+    }
+    try {
+        const value = JSON.parse(contents);
+        if (!guard(value))
+            throw new Error();
+        return value;
+    }
+    catch {
+        await quarantineStateFile(path, root);
+        await syncDirectory(root);
+        return undefined;
+    }
+}
+export async function writeJobMetadata(indexPath, checkpointPath, index, checkpoint, afterIndex, afterCheckpoint) {
+    await writeDurably(indexPath, canonicalJson(index));
+    await afterIndex?.();
+    await writeDurably(checkpointPath, canonicalJson(checkpoint));
+    await afterCheckpoint?.();
+}
+export async function appendDurably(path, value) {
+    const handle = await open(path, "a", 0o600);
+    try {
+        await handle.writeFile(value, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function writeDurably(path, value) {
+    const directory = ensureOwnedDirectory(dirname(path));
+    const temporary = join(directory, `.relkit-tmp-${randomUUID()}`);
+    let handle;
+    try {
+        handle = await open(temporary, "wx", 0o600);
+        await handle.writeFile(value, "utf8");
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await rename(temporary, path);
+        await syncDirectory(directory);
+    }
+    catch (cause) {
+        await handle?.close().catch(() => undefined);
+        await rm(temporary, { force: true }).catch(() => undefined);
+        throw new Error(`Job state file could not be committed: ${cause instanceof Error ? cause.message : "unknown error"}`);
+    }
+}
+async function syncDirectory(directory) {
+    const handle = await open(directory, "r");
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isCount(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isPositiveCount(value) {
+    return isCount(value) && value > 0;
+}
+//# sourceMappingURL=store-files.js.map

package/dist/jobs/store-files.js.map

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

package/dist/jobs/store.d.ts

@@ -0,0 +1,60 @@
+import { type JsonValue } from "@relkit/contracts";
+import { createJobStorePaths, STORE_VERSION } from "./store-files.js";
+export { STORE_VERSION } from "./store-files.js";
+export type JobStoreBoundary = "record-fsynced" | "index-committed" | "checkpoint-committed";
+export interface JobStoreOptions {
+    readonly now?: () => number;
+    /** Test-only failure seam; an error rejects append before acknowledgement. */
+    readonly onBoundary?: (boundary: JobStoreBoundary) => void | Promise<void>;
+    /** Optional semantic guard used by durable stores layered on this record format. */
+    readonly validateData?: (data: JsonValue) => void;
+}
+export interface JobRecordInput {
+    readonly instanceId: string;
+    readonly kind: string;
+    readonly data: JsonValue;
+    readonly timestamp?: number;
+}
+export interface JobRecord {
+    readonly version: typeof STORE_VERSION;
+    readonly sequence: number;
+    readonly instanceId: string;
+    readonly kind: string;
+    readonly timestamp: number;
+    readonly data: JsonValue;
+}
+export interface JobIndexEntry {
+    readonly sequence: number;
+    readonly offset: number;
+}
+export interface JobStoreIndex {
+    readonly version: typeof STORE_VERSION;
+    readonly commit: number;
+    readonly entries: Readonly<Record<string, JobIndexEntry>>;
+}
+export interface JobStoreCheckpoint {
+    readonly version: typeof STORE_VERSION;
+    readonly commit: number;
+    readonly sequence: number;
+    readonly offset: number;
+    readonly recordCount: number;
+}
+export interface JobStoreSnapshot {
+    readonly records: readonly JobRecord[];
+    readonly index: JobStoreIndex;
+    readonly checkpoint: JobStoreCheckpoint;
+}
+export interface JobStore {
+    readonly root: string;
+    readonly paths: Readonly<ReturnType<typeof createJobStorePaths>>;
+    readonly append: (input: JobRecordInput) => Promise<JobRecord>;
+    readonly snapshot: () => JobStoreSnapshot;
+    readonly close: () => Promise<void>;
+}
+export declare class JobStoreStateError extends Error {
+    readonly code: "RELKIT_JOB_STORE_STATE_INVALID";
+    constructor(message: string);
+}
+/** Opens and repairs the append log before exposing durable job operations. */
+export declare function createJobStore(requestedRoot: string, options?: JobStoreOptions): Promise<JobStore>;
+//# sourceMappingURL=store.d.ts.map

package/dist/jobs/store.d.ts.map

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

package/dist/jobs/store.js

@@ -0,0 +1,97 @@
+import { canonicalJson } from "@relkit/contracts";
+import { createJobStorePaths, ensureJobRoot, makeMetadata, parseJobRecord, readJobMetadata, recoverJobRecords, writeJobMetadata, appendDurably, STORE_VERSION, } from "./store-files.js";
+export { STORE_VERSION } from "./store-files.js";
+export class JobStoreStateError extends Error {
+    code = "RELKIT_JOB_STORE_STATE_INVALID";
+    constructor(message) {
+        super(message);
+        this.name = "JobStoreStateError";
+    }
+}
+/** Opens and repairs the append log before exposing durable job operations. */
+export async function createJobStore(requestedRoot, options = {}) {
+    const root = ensureJobRoot(requestedRoot);
+    const paths = createJobStorePaths(root);
+    const records = await recoverJobRecords(paths.records, root, options.validateData);
+    const current = makeMetadata(records);
+    const storedIndex = await readJobMetadata(paths.index, root, isIndex);
+    const storedCheckpoint = await readJobMetadata(paths.checkpoint, root, isCheckpoint);
+    if (storedIndex === undefined ||
+        storedCheckpoint === undefined ||
+        canonicalJson(storedIndex) !== canonicalJson(current.index) ||
+        canonicalJson(storedCheckpoint) !== canonicalJson(current.checkpoint)) {
+        await writeJobMetadata(paths.index, paths.checkpoint, current.index, current.checkpoint);
+    }
+    let snapshot = makeSnapshot(records, current);
+    // ponytail: one store-wide write lock; shard by state root if throughput matters.
+    let tail = Promise.resolve();
+    let closing = false;
+    let closed = false;
+    const append = (input) => {
+        if (closing || closed)
+            return Promise.reject(new JobStoreStateError("Job store is closed"));
+        const result = tail.then(async () => {
+            if (closed)
+                throw new JobStoreStateError("Job store is closed");
+            const record = makeRecord(input, snapshot.checkpoint.sequence + 1, options.now);
+            await appendDurably(paths.records, `${canonicalJson(record)}\n`);
+            await options.onBoundary?.("record-fsynced");
+            const nextRecords = [...snapshot.records, record];
+            const next = makeMetadata(nextRecords);
+            snapshot = makeSnapshot(nextRecords, next);
+            await writeJobMetadata(paths.index, paths.checkpoint, next.index, next.checkpoint, async () => options.onBoundary?.("index-committed"), async () => options.onBoundary?.("checkpoint-committed"));
+            return record;
+        });
+        tail = result.then(() => undefined, () => undefined);
+        return result;
+    };
+    const close = async () => {
+        closing = true;
+        await tail;
+        closed = true;
+    };
+    return Object.freeze({ root, paths, append, snapshot: () => snapshot, close });
+}
+function makeRecord(input, sequence, now) {
+    const timestamp = input.timestamp ?? now?.() ?? Date.now();
+    if (!Number.isSafeInteger(timestamp) || timestamp < 0) {
+        throw new JobStoreStateError("Job record timestamp is invalid");
+    }
+    return parseJobRecord({
+        version: STORE_VERSION,
+        sequence,
+        instanceId: input.instanceId,
+        kind: input.kind,
+        timestamp,
+        data: JSON.parse(canonicalJson(input.data)),
+    });
+}
+function makeSnapshot(records, current) {
+    return Object.freeze({
+        records: Object.freeze([...records]),
+        index: current.index,
+        checkpoint: current.checkpoint,
+    });
+}
+function isIndex(value) {
+    if (!isRecord(value) || value.version !== STORE_VERSION || !isCount(value.commit))
+        return false;
+    if (!isRecord(value.entries))
+        return false;
+    return Object.values(value.entries).every((entry) => isRecord(entry) && isCount(entry.sequence) && entry.sequence > 0 && isCount(entry.offset));
+}
+function isCheckpoint(value) {
+    return (isRecord(value) &&
+        value.version === STORE_VERSION &&
+        isCount(value.commit) &&
+        isCount(value.sequence) &&
+        isCount(value.offset) &&
+        isCount(value.recordCount));
+}
+function isCount(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=store.js.map

package/dist/jobs/store.js.map

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

package/dist/runtime-capabilities.d.ts

@@ -0,0 +1,17 @@
+import type { JsonValue } from "@relkit/contracts";
+import { type JobQueue } from "./jobs/queue.js";
+import type { JobIdempotencyDefinition } from "./jobs/queue-utils.js";
+export interface LocalJobProvider {
+    readonly createQueue: (context: {
+        readonly jobId: string;
+        readonly idempotency?: JobIdempotencyDefinition;
+    }) => Promise<JobQueue>;
+    readonly close: () => Promise<void>;
+}
+export declare function createLocalJobProvider(root: string, profile: string): LocalJobProvider;
+export declare function createLocalObservabilityProvider(): Readonly<{
+    collect: (record: JsonValue) => void;
+    emit: (record: JsonValue) => void;
+    read: () => readonly JsonValue[];
+}>;
+//# sourceMappingURL=runtime-capabilities.d.ts.map

package/dist/runtime-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-capabilities.d.ts","sourceRoot":"","sources":["../src/runtime-capabilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE;QAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;KACjD,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAkBtF;AAED,wBAAgB,gCAAgC;sBAG1B,SAAS,KAAG,IAAI;mBAGnB,SAAS,KAAG,IAAI;gBAGrB,SAAS,SAAS,EAAE;GAEjC"}

package/dist/runtime-capabilities.js

@@ -0,0 +1,32 @@
+import { join } from "node:path";
+import { createJobQueue } from "./jobs/queue.js";
+import { createJobStore } from "./jobs/store.js";
+export function createLocalJobProvider(root, profile) {
+    const stores = new Map();
+    return Object.freeze({
+        createQueue: async (context) => {
+            const existing = stores.get(context.jobId);
+            const store = existing ?? (await createJobStore(join(root, "jobs", profile, context.jobId)));
+            stores.set(context.jobId, store);
+            return createJobQueue(store, {
+                ...(context.idempotency === undefined ? {} : { idempotency: context.idempotency }),
+            });
+        },
+        close: async () => {
+            await Promise.all([...stores.values()].map((store) => store.close()));
+        },
+    });
+}
+export function createLocalObservabilityProvider() {
+    const records = [];
+    return Object.freeze({
+        collect: (record) => {
+            records.push(record);
+        },
+        emit: (record) => {
+            records.push(record);
+        },
+        read: () => Object.freeze([...records]),
+    });
+}
+//# sourceMappingURL=runtime-capabilities.js.map

package/dist/runtime-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-capabilities.js","sourceRoot":"","sources":["../src/runtime-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAiB,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAiB,MAAM,iBAAiB,CAAC;AAUhE,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,OAAe;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,KAAK,EAAE,OAGnB,EAAE,EAAE;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,IAAI,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7F,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,cAAc,CAAC,KAAK,EAAE;gBAC3B,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;aACnF,CAAC,CAAC;QACL,CAAC;QACD,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,MAAiB,EAAQ,EAAE;YACnC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,EAAE,CAAC,MAAiB,EAAQ,EAAE;YAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,EAAE,GAAyB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,15 @@
+export interface LocalProviderStateRoot {
+    readonly root: string;
+    readonly buckets: string;
+    readonly cache: string;
+}
+export declare class LocalProviderStateError extends Error {
+    readonly code: "RELKIT_LOCAL_PROVIDER_STATE_INVALID";
+    constructor(message?: string);
+}
+/** Owns the capability directories used by one local provider generation. */
+export declare function createLocalProviderStateRoot(requestedRoot?: string): LocalProviderStateRoot;
+/** Moves malformed provider state aside so a later startup can continue safely. */
+export declare function quarantineStateFile(file: string, ownerRoot: string): string;
+export declare function ensureOwnedDirectory(path: string): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,qCAAqC,CAAU;gBAEnD,OAAO,SAAyC;CAI7D;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAY3F;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgB3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzD"}