@relkit/providers-local 0.0.0

package/dist/events/router.js

@@ -0,0 +1,148 @@
+import { join, resolve } from "node:path";
+import { normalizeId } from "@relkit/contracts";
+import { createEventDelivery } from "./delivery.js";
+import { createEphemeralDelivery } from "./ephemeral.js";
+import { EventRouterStateError, normalizeDelivery, normalizeEnvelope, normalizeExpansion, } from "./router-records.js";
+import { createSnapshot, normalizeContract, publication, retryDelivery, drainDeliveries, runNextDelivery, } from "./router-inspection.js";
+export { EVENT_DELIVERY_VERSION, EventRouterStateError } from "./router-records.js";
+/** Routes accepted envelopes using only the compiler's explicit expansions. */
+export async function createEventRouter(requestedRoot, options = {}) {
+    const root = resolve(requestedRoot);
+    if (root === resolve("/"))
+        throw new EventRouterStateError("Event router root is too broad");
+    const triggers = new Map();
+    const contracts = new Map();
+    const publications = [];
+    let publicationSequence = 0;
+    let closed = false;
+    const registerContract = async (contract) => {
+        ensureOpen();
+        const normalized = normalizeContract(contract);
+        const key = `${normalized.id}@${normalized.version}`;
+        if (contracts.has(key))
+            throw new EventRouterStateError(`Duplicate event contract ${key}`);
+        contracts.set(key, normalized);
+    };
+    const registerTrigger = async (binding) => {
+        ensureOpen();
+        const id = normalizeId(binding.id);
+        if (triggers.has(id))
+            throw new EventRouterStateError(`Duplicate event trigger ${id}`);
+        const delivery = normalizeDelivery(binding.delivery);
+        if (typeof binding.invoke !== "function")
+            throw new EventRouterStateError(`Event trigger ${id} has no invocation target`);
+        const normalized = Object.freeze({
+            ...binding,
+            id,
+            delivery,
+            expansion: normalizeExpansion(binding.expansion),
+        });
+        const durable = delivery === "durable"
+            ? await createEventDelivery(join(root, "triggers", id), normalized, {
+                ...(options.now === undefined ? {} : { now: options.now }),
+                ...(options.random === undefined ? {} : { random: options.random }),
+                ...(options.ownerToken === undefined ? {} : { ownerToken: options.ownerToken }),
+                ...(options.leaseDurationMs === undefined
+                    ? {}
+                    : { leaseDurationMs: options.leaseDurationMs }),
+                onBoundary: (boundary) => options.onBoundary?.(boundary, id),
+            })
+            : undefined;
+        const ephemeral = delivery === "ephemeral"
+            ? createEphemeralDelivery(normalized.invoke, options.ephemeralCapacity)
+            : undefined;
+        triggers.set(id, {
+            binding: normalized,
+            ...(durable === undefined ? {} : { durable }),
+            ...(ephemeral === undefined ? {} : { ephemeral }),
+        });
+    };
+    const route = async (input, routeOptions = {}) => {
+        ensureOpen();
+        const event = normalizeEnvelope(input);
+        publications.push(publication(input, event, ++publicationSequence, options.now ?? Date.now));
+        const pair = `${event.eventId}@${event.version}`;
+        const matching = [...triggers.values()]
+            .filter(({ binding }) => binding.expansion.includes(pair))
+            .sort((left, right) => left.binding.id.localeCompare(right.binding.id));
+        const deliveries = await Promise.all(matching.map((trigger) => deliver(trigger, event, routeOptions.run !== false)));
+        return Object.freeze({
+            event,
+            matchedTriggerIds: Object.freeze(matching.map(({ binding }) => binding.id)),
+            deliveries: Object.freeze(deliveries),
+        });
+    };
+    const runNext = async (triggerId) => {
+        ensureOpen();
+        return runNextDelivery(triggers, triggerId);
+    };
+    const drain = async () => {
+        ensureOpen();
+        return drainDeliveries(triggers);
+    };
+    const retry = async (deliveryId) => {
+        ensureOpen();
+        return retryDelivery(triggers, deliveryId);
+    };
+    const snapshot = () => {
+        ensureOpen();
+        return createSnapshot(triggers, contracts, publications);
+    };
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        await Promise.all([...triggers.values()].flatMap(({ durable }) => (durable ? [durable.close()] : [])));
+    };
+    return Object.freeze({
+        root,
+        registerContract,
+        registerTrigger,
+        route,
+        runNext,
+        drain,
+        retry,
+        snapshot,
+        close,
+    });
+    function ensureOpen() {
+        if (closed)
+            throw new EventRouterStateError("Event router is closed");
+    }
+}
+async function deliver({ binding, durable, ephemeral }, envelope, run) {
+    if (binding.delivery === "ephemeral") {
+        if (ephemeral === undefined)
+            throw new EventRouterStateError("Ephemeral trigger has no delivery limiter");
+        return Object.freeze({
+            triggerId: binding.id,
+            delivery: binding.delivery,
+            ...(await ephemeral.deliver(envelope)),
+        });
+    }
+    if (durable === undefined) {
+        return {
+            triggerId: binding.id,
+            delivery: binding.delivery,
+            accepted: false,
+            persisted: false,
+            status: "failed",
+            error: new EventRouterStateError("Durable trigger has no delivery"),
+        };
+    }
+    try {
+        const result = run ? await durable.deliver(envelope) : await durable.accept(envelope);
+        return Object.freeze({ delivery: binding.delivery, ...result });
+    }
+    catch (error) {
+        return Object.freeze({
+            triggerId: binding.id,
+            delivery: binding.delivery,
+            accepted: false,
+            persisted: false,
+            status: "failed",
+            error,
+        });
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/events/router.js.map

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

package/dist/factory.d.ts

@@ -0,0 +1,26 @@
+import type { ProviderBinding, ProviderCapability } from "@relkit/app";
+import type { MaybePromise } from "@relkit/contracts";
+export interface LocalBindingFactoryContext {
+    readonly generationId: string;
+    readonly environment: "development" | "test" | "production";
+    readonly capability: ProviderCapability;
+    readonly profile: string;
+    readonly binding: ProviderBinding;
+    readonly configuration: Readonly<Record<string, unknown>>;
+    readonly signal?: AbortSignal;
+}
+export interface LocalBindingGeneration {
+    readonly value?: unknown;
+    readonly modelRegistry?: unknown;
+    readonly ready?: () => MaybePromise<void>;
+    readonly release?: () => MaybePromise<void>;
+    readonly dispose?: () => MaybePromise<void>;
+}
+export interface LocalBindingFactory {
+    readonly capability: ProviderCapability;
+    readonly adapter: "memory";
+    readonly create: (context: LocalBindingFactoryContext) => MaybePromise<LocalBindingGeneration>;
+}
+export declare const localProviderFactories: Readonly<Record<ProviderCapability, LocalBindingFactory>>;
+export declare function getLocalProviderFactory(capability: ProviderCapability): LocalBindingFactory | undefined;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,YAAY,CAAC,sBAAsB,CAAC,CAAC;CAChG;AAED,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAQzF,CAAC;AAEL,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,kBAAkB,GAC7B,mBAAmB,GAAG,SAAS,CAEjC"}

package/dist/factory.js

@@ -0,0 +1,66 @@
+import { join } from "node:path";
+import { createLocalBucketProvider } from "./buckets/index.js";
+import { createLocalCacheProvider } from "./cache/index.js";
+import { createLocalEventProvider } from "./events/provider.js";
+import { createLocalJobProvider, createLocalObservabilityProvider, } from "./runtime-capabilities.js";
+import { createLocalProviderStateRoot } from "./state.js";
+export const localProviderFactories = Object.freeze({
+    buckets: factory("buckets", createBucket),
+    cache: factory("cache", createCache),
+    jobs: factory("jobs", createJobs),
+    events: factory("events", createEvents),
+    models: factory("models", createModels),
+    observability: factory("observability", createObservability),
+});
+export function getLocalProviderFactory(capability) {
+    return localProviderFactories[capability];
+}
+function factory(capability, create) {
+    return Object.freeze({ capability, adapter: "memory", create });
+}
+function createBucket(context) {
+    const provider = createLocalBucketProvider({
+        root: join(stateRoot(context).buckets, context.profile),
+    });
+    return { value: provider, ready: provider.ready, release: provider.close };
+}
+function createCache(context) {
+    const provider = createLocalCacheProvider({
+        stateRoot: join(stateRoot(context).cache, context.profile),
+        cacheId: context.profile,
+    });
+    return { value: provider, ready: provider.ready, release: provider.close };
+}
+async function createEvents(context) {
+    const provider = await createLocalEventProvider(join(stateRoot(context).root, "events", context.profile));
+    return { value: provider, release: provider.close };
+}
+function createJobs(context) {
+    const provider = createLocalJobProvider(stateRoot(context).root, context.profile);
+    return { value: provider, release: provider.close };
+}
+function createObservability(_context) {
+    return { value: createLocalObservabilityProvider() };
+}
+function createModels(_context) {
+    const modelRegistry = Object.freeze({
+        resolveModel: (selector) => ({
+            provider: "test",
+            id: selector ?? "test:default",
+            model: Object.freeze({ provider: "relkit.test", modelId: "default" }),
+        }),
+    });
+    return { modelRegistry };
+}
+function stateRoot(context) {
+    check(context);
+    return createLocalProviderStateRoot(join(process.cwd(), ".relkit", "state", "testing", context.generationId));
+}
+function check(context) {
+    if (context.generationId.trim() === "")
+        throw new TypeError("Generation ID is required");
+    if (context.signal?.aborted) {
+        throw context.signal.reason ?? new Error("Provider generation was aborted");
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from "./factory.js";
+export * from "./buckets/index.js";
+export * from "./cache/index.js";
+export * from "./jobs/queue.js";
+export type * from "./jobs/queue-utils.js";
+export { createJobStore } from "./jobs/store.js";
+export type { JobRecord, JobRecordInput, JobStore, JobStoreBoundary, JobStoreCheckpoint, JobStoreIndex, JobStoreOptions, JobStoreSnapshot, } from "./jobs/store.js";
+export * from "./jobs/retry.js";
+export * from "./jobs/scheduler.js";
+export * from "./jobs/admin.js";
+export * from "./events/log.js";
+export * from "./events/router.js";
+export * from "./events/provider.js";
+export * from "./events/admin.js";
+export * from "./events/ephemeral.js";
+export { EVENT_DELIVERY_CAPABILITIES, createEventDelivery } from "./events/delivery.js";
+export type { EventDelivery, EventDeliveryBinding, EventDeliveryBoundary, EventDeliveryLedgerRecord, EventDeliveryOptions, EventDeliveryResult as DurableEventDeliveryResult, EventDeliverySnapshot, } from "./events/delivery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EACV,SAAS,EACT,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,IAAI,0BAA0B,EACjD,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from "./factory.js";
+export * from "./buckets/index.js";
+export * from "./cache/index.js";
+export * from "./jobs/queue.js";
+export { createJobStore } from "./jobs/store.js";
+export * from "./jobs/retry.js";
+export * from "./jobs/scheduler.js";
+export * from "./jobs/admin.js";
+export * from "./events/log.js";
+export * from "./events/router.js";
+export * from "./events/provider.js";
+export * from "./events/admin.js";
+export * from "./events/ephemeral.js";
+export { EVENT_DELIVERY_CAPABILITIES, createEventDelivery } from "./events/delivery.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/jobs/admin-contracts.d.ts

@@ -0,0 +1,66 @@
+import { type MaybePromise } from "@relkit/contracts";
+import type { JobFailureMetadata, JobQueueCounts, JobQueueState } from "./queue-utils.js";
+export declare const JOB_ADMIN_PROTOCOL: "relkit.jobs.admin";
+export declare const JOB_ADMIN_VERSION: 1;
+export type JobAdminMode = "development" | "test" | "production";
+export type JobAdminAction = "retry" | "cancel" | "dead-letter";
+export type JobAdminActionOutcome = "applied" | "rejected";
+export interface JobAdminVersion {
+    readonly protocol: typeof JOB_ADMIN_PROTOCOL;
+    readonly version: typeof JOB_ADMIN_VERSION;
+}
+/** Safe, versioned state returned to inspector consumers. */
+export interface JobStatusContract extends JobAdminVersion {
+    readonly instanceId: string;
+    readonly state: JobQueueState;
+    readonly profile: string;
+    readonly attempt: number;
+    readonly acceptedAt: number;
+    readonly order: number;
+    readonly availableAt?: number;
+    readonly leaseExpiresAt?: number;
+    readonly idempotencyExpiresAt?: number;
+    readonly failure?: JobFailureMetadata;
+}
+export interface JobQueryRequest {
+    readonly protocol?: typeof JOB_ADMIN_PROTOCOL;
+    readonly version?: typeof JOB_ADMIN_VERSION;
+    readonly instanceId?: string;
+    readonly state?: JobQueueState;
+    readonly states?: readonly JobQueueState[];
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+export interface JobQueryContract extends JobAdminVersion {
+    readonly items: readonly JobStatusContract[];
+    readonly counts: JobQueueCounts;
+    readonly nextCursor?: string;
+}
+export interface JobActionRequest {
+    readonly protocol?: typeof JOB_ADMIN_PROTOCOL;
+    readonly version?: typeof JOB_ADMIN_VERSION;
+    readonly instanceId: string;
+    readonly reason?: string;
+}
+export type JobRetryRequest = JobActionRequest;
+export type JobCancelRequest = JobActionRequest;
+export type JobDeadLetterRequest = JobActionRequest;
+export interface JobAdminActionRecord extends JobAdminVersion {
+    readonly actionId: string;
+    readonly action: JobAdminAction;
+    readonly instanceId: string;
+    readonly mode: JobAdminMode;
+    readonly outcome: JobAdminActionOutcome;
+    readonly requestedAt: number;
+    readonly fromState?: JobQueueState;
+    readonly toState?: JobQueueState;
+    readonly errorCode?: string;
+    readonly reason?: string;
+}
+export interface JobActionContract extends JobAdminVersion {
+    readonly action: JobAdminAction;
+    readonly status: JobStatusContract;
+    readonly record: JobAdminActionRecord;
+}
+export type JobAdminActionSink = (record: JobAdminActionRecord) => MaybePromise<void>;
+//# sourceMappingURL=admin-contracts.d.ts.map

package/dist/jobs/admin-contracts.d.ts.map

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

package/dist/jobs/admin-contracts.js

@@ -0,0 +1,4 @@
+import { PROTOCOL_VERSION } from "@relkit/contracts";
+export const JOB_ADMIN_PROTOCOL = "relkit.jobs.admin";
+export const JOB_ADMIN_VERSION = PROTOCOL_VERSION;
+//# sourceMappingURL=admin-contracts.js.map

package/dist/jobs/admin-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-contracts.js","sourceRoot":"","sources":["../../src/jobs/admin-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAqB,MAAM,mBAAmB,CAAC;AAGxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAA4B,CAAC;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC"}

package/dist/jobs/admin-errors.d.ts

@@ -0,0 +1,5 @@
+export declare class JobAdminError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=admin-errors.d.ts.map

package/dist/jobs/admin-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-errors.d.ts","sourceRoot":"","sources":["../../src/jobs/admin-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB"}

package/dist/jobs/admin-errors.js

@@ -0,0 +1,9 @@
+export class JobAdminError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "JobAdminError";
+    }
+}
+//# sourceMappingURL=admin-errors.js.map

package/dist/jobs/admin-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-errors.js","sourceRoot":"","sources":["../../src/jobs/admin-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B;IADX,YACW,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/jobs/admin-utils.d.ts

@@ -0,0 +1,29 @@
+import { JobAdminError } from "./admin-errors.js";
+import { type JobAdminAction, type JobAdminActionRecord, type JobAdminActionSink, type JobAdminMode, type JobAdminVersion, type JobQueryRequest, type JobStatusContract } from "./admin-contracts.js";
+import type { JobQueueEntry } from "./queue-utils.js";
+export declare function toStatus(entry: JobQueueEntry): JobStatusContract;
+export declare function matches(entry: JobQueueEntry, request: JobQueryRequest): boolean;
+export declare function afterCursor(entry: JobQueueEntry, value: string | undefined): boolean;
+export declare function cursor(entry: JobQueueEntry): string;
+export declare function pageLimit(value: number | undefined): number;
+export declare function validateQuery(request: JobQueryRequest): void;
+export declare function failureFor(action: JobAdminAction): {
+    readonly kind: "provider" | "cancellation";
+    readonly outcome: "provider-failure" | "cancelled";
+    readonly code: "RELKIT_JOB_ADMIN_CANCELLED" | "RELKIT_JOB_ADMIN_DEAD_LETTERED";
+    readonly message: "Job cancelled by local development action" | "Job dead-lettered by local development action";
+    readonly retry: "never";
+};
+export declare function makeRecord(action: JobAdminAction, actionId: string, instanceId: string, requestedAt: number, outcome: "applied" | "rejected", mode: JobAdminMode, before: JobQueueEntry | undefined, after: JobQueueEntry | undefined, errorCode?: string, reason?: string): JobAdminActionRecord;
+export declare function recordAction(options: {
+    readonly onAction?: JobAdminActionSink;
+    readonly records: JobAdminActionRecord[];
+}, record: JobAdminActionRecord): Promise<JobAdminActionRecord>;
+export declare function versioned<T extends object>(value: T): T & JobAdminVersion;
+export declare function assertVersion(value: unknown): void;
+export declare function assertMode(value: string): asserts value is JobAdminMode;
+export declare function safeId(value: unknown): string | undefined;
+export declare function readReason(value: unknown): string | undefined;
+export declare function safeReason(value: unknown): string | undefined;
+export declare function safeError(value: unknown): JobAdminError;
+//# sourceMappingURL=admin-utils.d.ts.map

package/dist/jobs/admin-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-utils.d.ts","sourceRoot":"","sources":["../../src/jobs/admin-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CAehE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAK/E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAOpF;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK3D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAQ5D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc;;;;;;EAWhD;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,GAAG,UAAU,EAC/B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CAatB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAAE,EAC7F,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAQ/B;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,eAAe,CAEzE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAQlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAGvE;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM7D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAIvD"}

package/dist/jobs/admin-utils.js

@@ -0,0 +1,138 @@
+import { deepFreeze, normalizeId } from "@relkit/contracts";
+import { JobAdminError } from "./admin-errors.js";
+import { JOB_ADMIN_PROTOCOL, JOB_ADMIN_VERSION, } from "./admin-contracts.js";
+export function toStatus(entry) {
+    return versioned({
+        instanceId: entry.instanceId,
+        state: entry.state,
+        profile: entry.profile,
+        attempt: entry.attempt,
+        acceptedAt: entry.acceptedAt,
+        order: entry.order,
+        ...(entry.availableAt === undefined ? {} : { availableAt: entry.availableAt }),
+        ...(entry.leaseExpiresAt === undefined ? {} : { leaseExpiresAt: entry.leaseExpiresAt }),
+        ...(entry.idempotency === undefined
+            ? {}
+            : { idempotencyExpiresAt: entry.idempotency.expiresAt }),
+        ...(entry.failure === undefined ? {} : { failure: entry.failure }),
+    });
+}
+export function matches(entry, request) {
+    if (request.instanceId !== undefined && entry.instanceId !== normalizeId(request.instanceId))
+        return false;
+    const states = request.states ?? (request.state === undefined ? undefined : [request.state]);
+    return states === undefined || states.includes(entry.state);
+}
+export function afterCursor(entry, value) {
+    if (value === undefined)
+        return true;
+    const [order, instanceId] = value.split(":", 2);
+    const parsed = Number(order);
+    if (!Number.isSafeInteger(parsed) || instanceId === undefined)
+        throw newAdminError("RELKIT_JOB_ADMIN_CURSOR_INVALID", "Job query cursor is invalid");
+    return entry.order > parsed || (entry.order === parsed && entry.instanceId > instanceId);
+}
+export function cursor(entry) {
+    return `${entry.order}:${entry.instanceId}`;
+}
+export function pageLimit(value) {
+    if (value === undefined)
+        return 50;
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw newAdminError("RELKIT_JOB_ADMIN_QUERY_INVALID", "Job query limit is invalid");
+    return Math.min(value, 100);
+}
+export function validateQuery(request) {
+    if (request.state !== undefined && !isState(request.state))
+        throw newAdminError("RELKIT_JOB_ADMIN_QUERY_INVALID", "Job query state is invalid");
+    if (request.states !== undefined &&
+        (!Array.isArray(request.states) || request.states.some((state) => !isState(state))))
+        throw newAdminError("RELKIT_JOB_ADMIN_QUERY_INVALID", "Job query states are invalid");
+}
+export function failureFor(action) {
+    return {
+        kind: action === "cancel" ? "cancellation" : "provider",
+        outcome: action === "cancel" ? "cancelled" : "provider-failure",
+        code: action === "cancel" ? "RELKIT_JOB_ADMIN_CANCELLED" : "RELKIT_JOB_ADMIN_DEAD_LETTERED",
+        message: action === "cancel"
+            ? "Job cancelled by local development action"
+            : "Job dead-lettered by local development action",
+        retry: "never",
+    };
+}
+export function makeRecord(action, actionId, instanceId, requestedAt, outcome, mode, before, after, errorCode, reason) {
+    return versioned({
+        actionId,
+        action,
+        instanceId,
+        mode,
+        outcome,
+        requestedAt,
+        ...(before === undefined ? {} : { fromState: before.state }),
+        ...(after === undefined ? {} : { toState: after.state }),
+        ...(errorCode === undefined ? {} : { errorCode }),
+        ...(reason === undefined ? {} : { reason }),
+    });
+}
+export async function recordAction(options, record) {
+    options.records.push(record);
+    try {
+        await options.onAction?.(record);
+    }
+    catch {
+        // A failing sink cannot erase the local action record or change its result.
+    }
+    return record;
+}
+export function versioned(value) {
+    return deepFreeze({ protocol: JOB_ADMIN_PROTOCOL, version: JOB_ADMIN_VERSION, ...value });
+}
+export function assertVersion(value) {
+    if (!isRecord(value))
+        throw newAdminError("RELKIT_JOB_ADMIN_REQUEST_INVALID", "Job admin request is invalid");
+    if ((value.protocol !== undefined && value.protocol !== JOB_ADMIN_PROTOCOL) ||
+        (value.version !== undefined && value.version !== JOB_ADMIN_VERSION))
+        throw newAdminError("RELKIT_JOB_ADMIN_PROTOCOL_MISMATCH", "Unsupported job admin protocol");
+}
+export function assertMode(value) {
+    if (value !== "development" && value !== "test" && value !== "production")
+        throw newAdminError("RELKIT_JOB_ADMIN_MODE_INVALID", "Job admin mode is invalid");
+}
+export function safeId(value) {
+    try {
+        return normalizeId(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function readReason(value) {
+    if (!isRecord(value) || value.reason === undefined)
+        return undefined;
+    if (typeof value.reason !== "string" || value.reason.trim() === "")
+        throw newAdminError("RELKIT_JOB_ADMIN_REQUEST_INVALID", "Job action reason is invalid");
+    return value.reason.trim().slice(0, 256);
+}
+export function safeReason(value) {
+    try {
+        return readReason(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function safeError(value) {
+    return value instanceof JobAdminError
+        ? value
+        : newAdminError("RELKIT_JOB_ADMIN_ACTION_FAILED", "Job admin action failed");
+}
+function isState(value) {
+    return ["accepted", "available", "leased", "delayed", "completed", "dead-lettered"].includes(value);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function newAdminError(code, message) {
+    return new JobAdminError(code, message);
+}
+//# sourceMappingURL=admin-utils.js.map

package/dist/jobs/admin-utils.js.map

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

package/dist/jobs/admin.d.ts

@@ -0,0 +1,25 @@
+import type { JobQueue } from "./queue-utils.js";
+import { JOB_ADMIN_PROTOCOL, JOB_ADMIN_VERSION, type JobActionContract, type JobActionRequest, type JobAdminActionRecord, type JobAdminActionSink, type JobAdminMode, type JobQueryContract, type JobQueryRequest, type JobStatusContract } from "./admin-contracts.js";
+export * from "./admin-contracts.js";
+export { JobAdminError } from "./admin-errors.js";
+export interface JobAdminOptions {
+    readonly mode?: JobAdminMode;
+    readonly environment?: JobAdminMode;
+    readonly enabled?: boolean;
+    readonly now?: () => number;
+    readonly createActionId?: () => string;
+    readonly onAction?: JobAdminActionSink;
+}
+export interface JobAdmin {
+    readonly protocol: typeof JOB_ADMIN_PROTOCOL;
+    readonly version: typeof JOB_ADMIN_VERSION;
+    readonly status: (instanceId: string) => JobStatusContract | undefined;
+    readonly query: (request?: JobQueryRequest) => JobQueryContract;
+    readonly retry: (request: string | JobActionRequest) => Promise<JobActionContract>;
+    readonly cancel: (request: string | JobActionRequest) => Promise<JobActionContract>;
+    readonly deadLetter: (request: string | JobActionRequest) => Promise<JobActionContract>;
+    readonly actions: () => readonly JobAdminActionRecord[];
+}
+/** Exposes versioned local job inspection and explicitly audited mutations. */
+export declare function createJobAdmin(queue: JobQueue, options?: JobAdminOptions): JobAdmin;
+//# sourceMappingURL=admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/jobs/admin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAErB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAoB9B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,gBAAgB,CAAC;IAChE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnF,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpF,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,oBAAoB,EAAE,CAAC;CACzD;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CA8CvF"}