@browserlessapi/inferlo 0.3.0 → 0.4.0

package/dist/jobs.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Background jobs: work that runs after the request, with retries.
+ *
+ *   export const sendWelcome = job("send-welcome", { input: t.object({ userId: t.uuid() }) })
+ *     .handle(async ({ input, db }) => { ... })
+ *
+ *   createApp({ jobs: [jobs] })                          // import * as jobs from "./jobs.ts"
+ *   await ctx.jobs.enqueue(sendWelcome, { userId })      // in a route handler, validated
+ *
+ * Jobs are plain values like routes. The queue is kept by a JobStore; app.jobs.start() runs due
+ * jobs in this process, app.jobs.runDue() runs them once (tests).
+ */
+import type { AI } from "./ai/index.ts";
+import { type CronDef } from "./cron.ts";
+import type { Adapter } from "./db/types.ts";
+import type { AppDb } from "./route.ts";
+import { type AnySchema, type Infer, type InferInput } from "./schema.ts";
+export interface JobOptions<I extends AnySchema> {
+    /** Schema of the job's input. Checked when the job is enqueued and again when it runs. */
+    input: I;
+    /** Extra attempts after a failure, with growing delays (10s, 20s, 40s, ... up to 1 hour). Default 3. */
+    retries?: number;
+    /** One line shown in describe. */
+    summary?: string;
+}
+export interface JobContext<Input> {
+    /** The validated input. */
+    input: Input;
+    db: AppDb;
+    ai: AI;
+    /** Enqueue follow-up jobs. */
+    jobs: Jobs;
+    /** Job id. */
+    id: string;
+    /** 1 on the first run, 2 on the first retry, and so on. */
+    attempt: number;
+}
+export interface JobDef<Input = any, Output = any> {
+    readonly kind: "inferlo.job";
+    readonly name: string;
+    readonly options: JobOptions<AnySchema>;
+    readonly handler: (ctx: JobContext<Output>) => unknown;
+    /** Type only: what enqueue accepts. */
+    readonly $input?: Input;
+}
+/** What enqueue accepts for a job. */
+export type JobInput<J> = J extends JobDef<infer I, any> ? I : never;
+export interface EnqueueOptions {
+    /** Run no earlier than this time. Default: now. */
+    runAt?: Date;
+}
+export type JobStatus = "pending" | "running" | "done" | "failed";
+export interface JobRecord {
+    id: string;
+    name: string;
+    /** The input as stored (JSON). */
+    input: unknown;
+    status: JobStatus;
+    /** Runs started so far. */
+    attempts: number;
+    /** 1 + retries. */
+    maxAttempts: number;
+    /** When the job runs next (pending) or last ran. */
+    runAt: Date;
+    /** Message of the last failure. */
+    lastError?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Jobs {
+    /** Validate the input and queue the job. Returns the queued record. */
+    enqueue<J extends JobDef>(job: J, input: JobInput<J>, options?: EnqueueOptions): Promise<JobRecord>;
+}
+export interface JobQueueConfig {
+    /**
+     * Where queued jobs are kept. "memory" (default): in this process, for development and tests.
+     * "database": in the inferlo_jobs table of the app's Postgres database, shared by every instance.
+     */
+    store?: "memory" | "database";
+}
+/** Where queued jobs are kept. */
+export interface JobStore {
+    /** Add a record. A record whose id is already stored is ignored (cron ticks use fixed ids). */
+    add(record: JobRecord): Promise<void>;
+    /** Mark up to limit pending jobs named in names with runAt <= now as running (attempts + 1) and return them, oldest first. */
+    claim(now: Date, limit: number, names: readonly string[]): Promise<JobRecord[]>;
+    update(id: string, patch: Partial<Pick<JobRecord, "status" | "runAt" | "lastError">>): Promise<void>;
+    get(id: string): Promise<JobRecord | null>;
+    /** Record that a running job is still alive (database store), so it is not picked up again as stuck. */
+    touch?(id: string): Promise<void>;
+}
+export interface RunResult {
+    /** Jobs that finished. */
+    done: number;
+    /** Jobs that failed and will run again later. */
+    retried: number;
+    /** Jobs that failed for the last time. */
+    failed: number;
+}
+export interface Worker {
+    /** Stop polling and wait for running jobs to finish. */
+    stop(): Promise<void>;
+}
+/** app.jobs: enqueue, inspect and run jobs. */
+export interface AppJobs extends Jobs {
+    /** The registered jobs. */
+    readonly list: readonly JobDef[];
+    /** The registered crons: cron(schedule, job) values in createApp({ jobs }). */
+    readonly crons: readonly CronDef[];
+    /** Where queued jobs are kept (createApp({ jobQueue: { store } })). */
+    readonly queue: "memory" | "database";
+    /** A queued job by id, or null. */
+    get(id: string): Promise<JobRecord | null>;
+    /** Run every job that is due now (or at options.now), one after another, including follow-ups they enqueue, then return. For tests and scripts. */
+    runDue(options?: {
+        now?: Date;
+    }): Promise<RunResult>;
+    /** Run due jobs in this process every pollMs (default 1000) until stop() is called. Also queues each cron's job at every tick after the start. */
+    start(options?: {
+        pollMs?: number;
+    }): Worker;
+}
+/** Delay before retry n (1-based): 10s, 20s, 40s, ... at most one hour. */
+export declare function retryDelayMs(attempt: number): number;
+export declare class JobBuilder<I extends AnySchema> {
+    readonly name: string;
+    readonly options: JobOptions<I>;
+    constructor(name: string, options: JobOptions<I>);
+    /** The job's work. Throw to fail the attempt; it is retried until retries run out. */
+    handle(handler: (ctx: JobContext<Infer<I>>) => unknown): JobDef<InferInput<I>, Infer<I>>;
+}
+/** Define a background job: job("send-email", { input: t.object({ to: t.email() }) }).handle(fn). */
+export declare function job<I extends AnySchema>(name: string, options: JobOptions<I>): JobBuilder<I>;
+export declare function isJob(value: unknown): value is JobDef;
+/** Anything that contains jobs: a job, a cron, an array, or a module (import * as jobs from "./jobs.ts"). */
+export type JobSource = JobDef | CronDef | readonly JobSource[] | {
+    readonly [name: string]: unknown;
+};
+/** The jobs and crons in createApp({ jobs }). A cron's job is registered with it. */
+export declare function collectJobs(sources: readonly JobSource[] | undefined): JobDef[];
+export declare function collectCrons(sources: readonly JobSource[] | undefined): CronDef[];
+/** Jobs kept in this process. They are lost when it stops, so use it for development and tests. */
+export declare function memoryJobStore(): JobStore;
+/** A running job whose worker has not reported for this long is treated as stuck (its process stopped) and run again. */
+export declare const STALE_AFTER_MS: number;
+/** How often a worker reports that a running job is still alive. */
+export declare const HEARTBEAT_MS = 30000;
+export declare const STOPPED_MESSAGE = "The worker stopped while running this job (the process exited or lost its database connection).";
+/**
+ * Jobs in the inferlo_jobs table (created on first use), shared by every instance. Due jobs are
+ * claimed with FOR UPDATE SKIP LOCKED, so each one runs in one place. A running job whose worker
+ * stopped reporting (see STALE_AFTER_MS) is claimed again, or marked failed if it has no attempts left.
+ */
+export declare function databaseJobStore(adapter: Adapter, options?: {
+    staleAfterMs?: number;
+}): JobStore;
+/** Pick the job store for createApp({ jobQueue }). Raises IL6011 for an unknown store, IL6012 for "database" without Postgres. */
+export declare function jobStoreFor(config: JobQueueConfig | undefined, adapter: Adapter): JobStore;
+export interface JobRuntime {
+    db: AppDb;
+    ai: AI;
+    store: JobStore;
+    /** Name of the store, shown as app.jobs.queue. Default "memory". */
+    queue?: "memory" | "database";
+    /** How often a running job is reported alive to stores that support it. Default HEARTBEAT_MS. */
+    heartbeatMs?: number;
+    logger: {
+        info(message: string, data?: unknown): void;
+        error(message: string, data?: unknown): void;
+    };
+}
+/** app.jobs plus what the framework tests reach directly. */
+export interface InternalJobs extends AppJobs {
+    /** Queue the job of each cron's latest tick in (from, to]. */
+    queueCrons(from: Date, to: Date): Promise<void>;
+}
+export declare function createJobs(list: readonly JobDef[], runtime: JobRuntime, crons?: readonly CronDef[]): InternalJobs;

package/dist/jobs.js

@@ -0,0 +1,374 @@
+import { cronTickId, isCron } from "./cron.js";
+import { InferloError } from "./errors.js";
+import { ValidationError } from "./schema.js";
+const MAX_RETRIES = 25;
+const BASE_DELAY_MS = 10_000;
+const MAX_DELAY_MS = 3_600_000;
+/** Delay before retry n (1-based): 10s, 20s, 40s, ... at most one hour. */
+export function retryDelayMs(attempt) {
+    return Math.min(BASE_DELAY_MS * 2 ** (attempt - 1), MAX_DELAY_MS);
+}
+export class JobBuilder {
+    name;
+    options;
+    constructor(name, options) {
+        this.name = name;
+        this.options = options;
+    }
+    /** The job's work. Throw to fail the attempt; it is retried until retries run out. */
+    handle(handler) {
+        return { kind: "inferlo.job", name: this.name, options: this.options, handler: handler };
+    }
+}
+const JOB_NAME = /^[a-z][a-z0-9-]{0,62}$/;
+/** Define a background job: job("send-email", { input: t.object({ to: t.email() }) }).handle(fn). */
+export function job(name, options) {
+    checkJob(name, options);
+    return new JobBuilder(name, options);
+}
+function checkJob(name, options) {
+    const o = options;
+    const problems = [];
+    if (typeof name !== "string" || !JOB_NAME.test(name))
+        problems.push("the name must be lowercase letters, digits and dashes, starting with a letter");
+    if (!o || typeof o !== "object")
+        problems.push("options must be an object with an input schema");
+    else {
+        if (!o.input || typeof o.input.safeParse !== "function")
+            problems.push("input must be a schema such as t.object({ ... })");
+        if (o.retries !== undefined && (!Number.isInteger(o.retries) || o.retries < 0 || o.retries > MAX_RETRIES))
+            problems.push(`retries must be a whole number from 0 to ${MAX_RETRIES}`);
+    }
+    if (problems.length) {
+        throw new InferloError("IL6009", `Invalid job "${String(name)}": ${problems.join(", ")}.`, {
+            fix: 'Use job("send-email", { input: t.object({ to: t.email() }), retries: 3 }).handle(async ({ input }) => { ... }).',
+        });
+    }
+}
+export function isJob(value) {
+    return typeof value === "object" && value !== null && value.kind === "inferlo.job";
+}
+/** The jobs and crons in createApp({ jobs }). A cron's job is registered with it. */
+export function collectJobs(sources) {
+    return collect(sources).jobs;
+}
+export function collectCrons(sources) {
+    return collect(sources).crons;
+}
+function collect(sources) {
+    const out = [];
+    const crons = [];
+    const seen = new Set();
+    const visit = (source) => {
+        if (!source || typeof source !== "object" || seen.has(source))
+            return;
+        seen.add(source);
+        if (isJob(source))
+            out.push(source);
+        else if (isCron(source)) {
+            crons.push(source);
+            visit(source.job);
+        }
+        else if (Array.isArray(source))
+            source.forEach(visit);
+        else
+            for (const value of Object.values(source))
+                if (isJob(value) || isCron(value) || Array.isArray(value))
+                    visit(value);
+    };
+    visit(sources);
+    const names = new Map();
+    for (const j of out) {
+        if (names.has(j.name))
+            throw new InferloError("IL6009", `Two jobs are named "${j.name}".`, { fix: "Give each job a unique name." });
+        names.set(j.name, j);
+    }
+    return { jobs: out, crons };
+}
+/** Jobs kept in this process. They are lost when it stops, so use it for development and tests. */
+export function memoryJobStore() {
+    const records = new Map();
+    const copy = (r) => ({ ...r, runAt: new Date(r.runAt), createdAt: new Date(r.createdAt), updatedAt: new Date(r.updatedAt) });
+    return {
+        async add(record) {
+            if (!records.has(record.id))
+                records.set(record.id, copy(record));
+        },
+        async claim(now, limit, names) {
+            const due = [...records.values()]
+                .filter((r) => r.status === "pending" && r.runAt.getTime() <= now.getTime() && names.includes(r.name))
+                .sort((a, b) => a.runAt.getTime() - b.runAt.getTime() || a.createdAt.getTime() - b.createdAt.getTime())
+                .slice(0, limit);
+            for (const r of due)
+                Object.assign(r, { status: "running", attempts: r.attempts + 1, updatedAt: new Date() });
+            return due.map(copy);
+        },
+        async update(id, patch) {
+            const r = records.get(id);
+            if (r)
+                Object.assign(r, patch, { updatedAt: new Date() });
+        },
+        async get(id) {
+            const r = records.get(id);
+            return r ? copy(r) : null;
+        },
+    };
+}
+/** A running job whose worker has not reported for this long is treated as stuck (its process stopped) and run again. */
+export const STALE_AFTER_MS = 5 * 60_000;
+/** How often a worker reports that a running job is still alive. */
+export const HEARTBEAT_MS = 30_000;
+export const STOPPED_MESSAGE = "The worker stopped while running this job (the process exited or lost its database connection).";
+const JOB_COLUMNS = `"id", "name", "input", "status", "attempts", "max_attempts", "run_at", "last_error", "created_at", "updated_at"`;
+function fromRow(row) {
+    const record = {
+        id: String(row.id),
+        name: String(row.name),
+        input: typeof row.input === "string" ? JSON.parse(row.input) : row.input,
+        status: row.status,
+        attempts: Number(row.attempts),
+        maxAttempts: Number(row.max_attempts),
+        runAt: new Date(row.run_at),
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at),
+    };
+    if (row.last_error !== null && row.last_error !== undefined)
+        record.lastError = String(row.last_error);
+    return record;
+}
+/**
+ * Jobs in the inferlo_jobs table (created on first use), shared by every instance. Due jobs are
+ * claimed with FOR UPDATE SKIP LOCKED, so each one runs in one place. A running job whose worker
+ * stopped reporting (see STALE_AFTER_MS) is claimed again, or marked failed if it has no attempts left.
+ */
+export function databaseJobStore(adapter, options = {}) {
+    const sql = adapter.sql?.bind(adapter);
+    if (!sql) {
+        throw new InferloError("IL6012", `jobQueue store "database" needs a Postgres database, but the app uses the ${adapter.dialect} adapter.`, {
+            fix: 'Use postgres() from "@browserlessapi/inferlo/postgres" for createApp({ db }), or jobQueue: { store: "memory" }.',
+        });
+    }
+    const staleAfterMs = options.staleAfterMs ?? STALE_AFTER_MS;
+    let ready;
+    const create = async () => {
+        try {
+            await sql(`CREATE TABLE IF NOT EXISTS "inferlo_jobs" (
+          "id" uuid PRIMARY KEY, "name" text NOT NULL, "input" jsonb NOT NULL, "status" text NOT NULL,
+          "attempts" integer NOT NULL, "max_attempts" integer NOT NULL, "run_at" timestamptz NOT NULL,
+          "last_error" text, "created_at" timestamptz NOT NULL, "updated_at" timestamptz NOT NULL)`);
+            await sql('CREATE INDEX IF NOT EXISTS "inferlo_jobs_due_idx" ON "inferlo_jobs" ("status", "run_at")');
+        }
+        catch {
+            // Two instances creating the table at the same moment: the other one won.
+            await sql('SELECT 1 FROM "inferlo_jobs" LIMIT 1');
+        }
+    };
+    const table = async () => {
+        ready ??= create().catch((error) => {
+            ready = undefined;
+            throw error;
+        });
+        await ready;
+    };
+    return {
+        async add(r) {
+            await table();
+            await sql(`INSERT INTO "inferlo_jobs" (${JOB_COLUMNS}) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10) ON CONFLICT ("id") DO NOTHING`, [
+                r.id, r.name, JSON.stringify(r.input), r.status, r.attempts, r.maxAttempts, r.runAt, r.lastError ?? null, r.createdAt, r.updatedAt,
+            ]);
+        },
+        async claim(now, limit, names) {
+            await table();
+            if (!names.length)
+                return [];
+            const stale = `"status" = 'running' AND "updated_at" < now() - $1 * interval '1 millisecond'`;
+            // Stuck jobs without attempts left are failed, not run again.
+            await sql(`UPDATE "inferlo_jobs" SET "status" = 'failed', "last_error" = $2, "updated_at" = now() WHERE ${stale} AND "attempts" >= "max_attempts" AND "name" = ANY($3)`, [
+                staleAfterMs, STOPPED_MESSAGE, names,
+            ]);
+            const rows = await sql(`WITH due AS (
+           SELECT "id" FROM "inferlo_jobs"
+           WHERE "name" = ANY($3) AND (("status" = 'pending' AND "run_at" <= $4) OR (${stale} AND "attempts" < "max_attempts"))
+           ORDER BY "run_at", "created_at" LIMIT $5 FOR UPDATE SKIP LOCKED)
+         UPDATE "inferlo_jobs" j SET "status" = 'running', "attempts" = j."attempts" + 1, "updated_at" = now(),
+           "last_error" = CASE WHEN j."status" = 'running' THEN $2 ELSE j."last_error" END
+         FROM due WHERE j."id" = due."id"
+         RETURNING j.*`, [staleAfterMs, STOPPED_MESSAGE, names, now, limit]);
+            return rows
+                .map(fromRow)
+                .sort((a, b) => a.runAt.getTime() - b.runAt.getTime() || a.createdAt.getTime() - b.createdAt.getTime());
+        },
+        async update(id, patch) {
+            await table();
+            const sets = ['"updated_at" = now()'];
+            const params = [id];
+            if (patch.status !== undefined)
+                sets.push(`"status" = $${params.push(patch.status)}`);
+            if (patch.runAt !== undefined)
+                sets.push(`"run_at" = $${params.push(patch.runAt)}`);
+            if (patch.lastError !== undefined)
+                sets.push(`"last_error" = $${params.push(patch.lastError)}`);
+            await sql(`UPDATE "inferlo_jobs" SET ${sets.join(", ")} WHERE "id" = $1`, params);
+        },
+        async get(id) {
+            await table();
+            if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id))
+                return null;
+            const rows = await sql(`SELECT ${JOB_COLUMNS} FROM "inferlo_jobs" WHERE "id" = $1`, [id]);
+            return rows[0] ? fromRow(rows[0]) : null;
+        },
+        async touch(id) {
+            await table();
+            await sql(`UPDATE "inferlo_jobs" SET "updated_at" = now() WHERE "id" = $1 AND "status" = 'running'`, [id]);
+        },
+    };
+}
+/** Pick the job store for createApp({ jobQueue }). Raises IL6011 for an unknown store, IL6012 for "database" without Postgres. */
+export function jobStoreFor(config, adapter) {
+    const store = config?.store ?? "memory";
+    if (store === "memory")
+        return memoryJobStore();
+    if (store === "database")
+        return databaseJobStore(adapter);
+    throw new InferloError("IL6011", `Invalid jobQueue store "${String(store)}".`, { fix: 'Use createApp({ jobQueue: { store: "memory" } }) (the default) or { store: "database" }.' });
+}
+export function createJobs(list, runtime, crons = []) {
+    const byName = new Map(list.map((j) => [j.name, j]));
+    const names = list.map((j) => j.name);
+    const registered = (j) => {
+        const found = isJob(j) ? byName.get(j.name) : undefined;
+        if (!found) {
+            const name = isJob(j) ? `"${j.name}"` : "This value";
+            throw new InferloError("IL6010", `${name} is not a registered job.`, {
+                fix: "Pass a job defined with job(...).handle(...) and add it (or its module) to createApp({ jobs: [...] }).",
+            });
+        }
+        return found;
+    };
+    const parse = (j, input) => {
+        const result = j.options.input.safeParse(input);
+        if (!result.ok)
+            throw new ValidationError(result.issues, `input for job "${j.name}"`);
+        return result.value;
+    };
+    const record = (def, input, runAt, id) => {
+        // Stored as JSON, so it survives a restart with a database store; parsed again when it runs.
+        const stored = JSON.parse(JSON.stringify(parse(def, input) ?? null));
+        const now = new Date();
+        return {
+            id,
+            name: def.name,
+            input: stored,
+            status: "pending",
+            attempts: 0,
+            maxAttempts: 1 + (def.options.retries ?? 3),
+            runAt: runAt ?? now,
+            createdAt: now,
+            updatedAt: now,
+        };
+    };
+    /** Queue the job of every cron tick in (from, to]. Only the latest tick of each cron is queued, so a pause does not cause a burst. */
+    const queueCrons = async (from, to) => {
+        for (const c of crons) {
+            let tick = c.next(from);
+            if (tick.getTime() > to.getTime())
+                continue;
+            for (let later = c.next(tick); later.getTime() <= to.getTime(); later = c.next(later))
+                tick = later;
+            await runtime.store.add(record(c.job, {}, tick, await cronTickId(c, tick)));
+        }
+    };
+    const jobs = {
+        list,
+        crons,
+        queueCrons,
+        queue: runtime.queue ?? "memory",
+        async enqueue(j, input, options = {}) {
+            const def = registered(j);
+            if (options.runAt !== undefined && (!(options.runAt instanceof Date) || Number.isNaN(options.runAt.getTime()))) {
+                throw new InferloError("IL6009", `runAt for job "${def.name}" must be a valid Date.`, { fix: "Pass runAt: new Date(Date.now() + 60_000) or leave it out to run now." });
+            }
+            const queued = record(def, input, options.runAt, crypto.randomUUID());
+            await runtime.store.add(queued);
+            return queued;
+        },
+        get: (id) => runtime.store.get(id),
+        async runDue(options = {}) {
+            const result = { done: 0, retried: 0, failed: 0 };
+            while (true) {
+                // Without options.now, jobs enqueued by the jobs that run (follow-ups) run in the same call.
+                const now = options.now ?? new Date();
+                const [record] = await runtime.store.claim(now, 1, names);
+                if (!record)
+                    return result;
+                result[await run(record, now)]++;
+            }
+        },
+        start(options = {}) {
+            const pollMs = options.pollMs ?? 1000;
+            let stopped = false;
+            let timer;
+            let wake;
+            let cronFrom = new Date();
+            const loop = (async () => {
+                while (!stopped) {
+                    try {
+                        if (crons.length) {
+                            const now = new Date();
+                            await queueCrons(cronFrom, now);
+                            cronFrom = now;
+                        }
+                        await jobs.runDue();
+                    }
+                    catch (error) {
+                        runtime.logger.error("job worker error", error);
+                    }
+                    if (stopped)
+                        break;
+                    await new Promise((resolve) => {
+                        wake = resolve;
+                        timer = setTimeout(resolve, pollMs);
+                    });
+                }
+            })();
+            return {
+                async stop() {
+                    stopped = true;
+                    if (timer)
+                        clearTimeout(timer);
+                    wake?.();
+                    await loop;
+                },
+            };
+        },
+    };
+    async function run(record, now) {
+        const def = byName.get(record.name);
+        const touch = runtime.store.touch?.bind(runtime.store);
+        const heartbeat = touch ? setInterval(() => void touch(record.id).catch(() => { }), runtime.heartbeatMs ?? HEARTBEAT_MS) : undefined;
+        try {
+            if (!def)
+                throw new InferloError("IL6010", `"${record.name}" is not a registered job.`, { fix: "Add the job to createApp({ jobs: [...] }) in the process that runs jobs." });
+            await def.handler({ input: parse(def, record.input), db: runtime.db, ai: runtime.ai, jobs, id: record.id, attempt: record.attempts });
+            await runtime.store.update(record.id, { status: "done" });
+            return "done";
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (record.attempts < record.maxAttempts) {
+                await runtime.store.update(record.id, { status: "pending", lastError: message, runAt: new Date(now.getTime() + retryDelayMs(record.attempts)) });
+                runtime.logger.error(`job "${record.name}" failed (attempt ${record.attempts} of ${record.maxAttempts}), will retry`, { id: record.id, error: message });
+                return "retried";
+            }
+            await runtime.store.update(record.id, { status: "failed", lastError: message });
+            runtime.logger.error(`job "${record.name}" failed after ${record.attempts} attempt(s)`, { id: record.id, error: message });
+            return "failed";
+        }
+        finally {
+            if (heartbeat)
+                clearInterval(heartbeat);
+        }
+    }
+    return jobs;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAgB,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,eAAe,EAA+C,MAAM,aAAa,CAAC;AAoH3F,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,OAAO,UAAU;IACZ,IAAI,CAAS;IACb,OAAO,CAAgB;IAEhC,YAAY,IAAY,EAAE,OAAsB;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,OAA+C;QACpD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAA4B,EAAE,CAAC;IAChH,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAE1C,qGAAqG;AACrG,MAAM,UAAU,GAAG,CAAsB,IAAY,EAAE,OAAsB;IAC3E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxB,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa,EAAE,OAAgB;IAC/C,MAAM,CAAC,GAAG,OAA4C,CAAC;IACvD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IACrJ,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;SAC5F,CAAC;QACJ,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,OAAQ,CAAC,CAAC,KAAmB,CAAC,SAAS,KAAK,UAAU;YAAE,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC1I,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,4CAA4C,WAAW,EAAE,CAAC,CAAC;IACtL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,gBAAgB,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACzF,GAAG,EAAE,iHAAiH;SACvH,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAgB,CAAC,IAAI,KAAK,aAAa,CAAC;AACjG,CAAC;AAKD,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,OAAyC;IACnE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAyC;IACpE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;AAChC,CAAC;AAED,SAAS,OAAO,CAAC,OAAyC;IACxD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,MAAe,EAAE,EAAE;QAChC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO;QACtE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,IAAI,KAAK,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aAC/B,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;YACnD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;gBAAE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1H,CAAC,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,8BAA8B,EAAE,CAAC,CAAC;QACpI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,CAAY,EAAa,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnJ,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,MAAM;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK;YAC3B,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBACrG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;iBACtG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACnB,KAAK,MAAM,CAAC,IAAI,GAAG;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9G,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK;YACpB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,EAAE;YACV,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yHAAyH;AACzH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AACzC,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,iGAAiG,CAAC;AAEjI,MAAM,WAAW,GAAG,iHAAiH,CAAC;AAEtI,SAAS,OAAO,CAAC,GAA4B;IAC3C,MAAM,MAAM,GAAc;QACxB,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAa,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK;QACrF,MAAM,EAAE,GAAG,CAAC,MAAmB;QAC/B,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;QACrC,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,MAAgB,CAAC;QACrC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC;QAC7C,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAoB,CAAC;KAC9C,CAAC;IACF,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,UAAqC,EAAE;IACxF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,6EAA6E,OAAO,CAAC,OAAO,WAAW,EAAE;YACxI,GAAG,EAAE,iHAAiH;SACvH,CAAC,CAAC;IACL,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,cAAc,CAAC;IAC5D,IAAI,KAAmC,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,CACP;;;mGAG2F,CAC5F,CAAC;YACF,MAAM,GAAG,CAAC,0FAA0F,CAAC,CAAC;QACxG,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,MAAM,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,KAAK,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,KAAK,GAAG,SAAS,CAAC;YAClB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,CAAC;YACT,MAAM,KAAK,EAAE,CAAC;YACd,MAAM,GAAG,CAAC,+BAA+B,WAAW,kFAAkF,EAAE;gBACtI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS;aACnI,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK;YAC3B,MAAM,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,+EAA+E,CAAC;YAC9F,8DAA8D;YAC9D,MAAM,GAAG,CAAC,gGAAgG,KAAK,wDAAwD,EAAE;gBACvK,YAAY,EAAE,eAAe,EAAE,KAAK;aACrC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CACpB;;uFAE+E,KAAK;;;;;uBAKrE,EACf,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CACnD,CAAC;YACF,OAAO,IAAI;iBACR,GAAG,CAAC,OAAO,CAAC;iBACZ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5G,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK;YACpB,MAAM,KAAK,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACtC,MAAM,MAAM,GAAc,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpF,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAChG,MAAM,GAAG,CAAC,6BAA6B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACpF,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,EAAE;YACV,MAAM,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,iEAAiE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7F,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,UAAU,WAAW,sCAAsC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1F,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,EAAE;YACZ,MAAM,KAAK,EAAE,CAAC;YACd,MAAM,GAAG,CAAC,yFAAyF,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7G,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kIAAkI;AAClI,MAAM,UAAU,WAAW,CAAC,MAAkC,EAAE,OAAgB;IAC9E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,QAAQ,CAAC;IACxC,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,cAAc,EAAE,CAAC;IAChD,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,2BAA2B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,0FAA0F,EAAE,CAAC,CAAC;AACtL,CAAC;AAmBD,MAAM,UAAU,UAAU,CAAC,IAAuB,EAAE,OAAmB,EAAE,QAA4B,EAAE;IACrG,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;YACrD,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,GAAG,IAAI,2BAA2B,EAAE;gBACnE,GAAG,EAAE,wGAAwG;aAC9G,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,KAAc,EAAW,EAAE;QACnD,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACtF,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,KAAuB,EAAE,EAAU,EAAa,EAAE;QAC7F,6FAA6F;QAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,CAAY,CAAC;QAChF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO;YACL,EAAE;YACF,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;YAC3C,KAAK,EAAE,KAAK,IAAI,GAAG;YACnB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC,CAAC;IAEF,sIAAsI;IACtI,MAAM,UAAU,GAAG,KAAK,EAAE,IAAU,EAAE,EAAQ,EAAE,EAAE;QAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE;gBAAE,SAAS;YAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,IAAI,GAAG,KAAK,CAAC;YACpG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAiB;QACzB,IAAI;QACJ,KAAK;QACL,UAAU;QACV,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE;YAClC,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC/G,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,CAAC,IAAI,yBAAyB,EAAE,EAAE,GAAG,EAAE,uEAAuE,EAAE,CAAC,CAAC;YAC1K,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACtE,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAElC,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,EAAE;YACvB,MAAM,MAAM,GAAc,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,EAAE,CAAC;gBACZ,6FAA6F;gBAC7F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;gBACtC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC1D,IAAI,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBAC3B,MAAM,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACnC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO,GAAG,EAAE;YAChB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;YACtC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,KAAgD,CAAC;YACrD,IAAI,IAA8B,CAAC;YACnC,IAAI,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;gBACvB,OAAO,CAAC,OAAO,EAAE,CAAC;oBAChB,IAAI,CAAC;wBACH,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;4BACjB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;4BACvB,MAAM,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;4BAChC,QAAQ,GAAG,GAAG,CAAC;wBACjB,CAAC;wBACD,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;oBACtB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;oBAClD,CAAC;oBACD,IAAI,OAAO;wBAAE,MAAM;oBACnB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;wBAClC,IAAI,GAAG,OAAO,CAAC;wBACf,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBACtC,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,OAAO;gBACL,KAAK,CAAC,IAAI;oBACR,OAAO,GAAG,IAAI,CAAC;oBACf,IAAI,KAAK;wBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,EAAE,EAAE,CAAC;oBACT,MAAM,IAAI,CAAC;gBACb,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,KAAK,UAAU,GAAG,CAAC,MAAiB,EAAE,GAAS;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpI,IAAI,CAAC;YACH,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,IAAI,MAAM,CAAC,IAAI,4BAA4B,EAAE,EAAE,GAAG,EAAE,0EAA0E,EAAE,CAAC,CAAC;YAC7K,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtI,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBACzC,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;gBACjJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,MAAM,CAAC,IAAI,qBAAqB,MAAM,CAAC,QAAQ,OAAO,MAAM,CAAC,WAAW,eAAe,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzJ,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,MAAM,CAAC,IAAI,kBAAkB,MAAM,CAAC,QAAQ,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3H,OAAO,QAAQ,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,IAAI,SAAS;gBAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mcp.d.ts

@@ -15,4 +15,8 @@ export interface ToolDefinition {
 }
 export declare function toolName(route: RouteDef): string;
 export declare function toolDefinitions(app: App<any>): ToolDefinition[];
+/** The tool definition of one route: its name, description and a JSON Schema of params, query and body together. */
+export declare function toolDefinition(route: RouteDef): ToolDefinition;
 export declare function handleMcp(app: App<any>, req: Request, headers: Headers, testUsers: WeakMap<Request, unknown>): Promise<Response>;
+/** Run a tool call as an HTTP request to its route, forwarding the caller's credentials, so auth, roles and validation apply. */
+export declare function callTool(app: App<any>, tool: ToolDefinition, args: Record<string, unknown>, original: Request, testUsers: WeakMap<Request, unknown>): Promise<Response>;