@q32/core 0.1.1

package/dist/http.d.ts

@@ -0,0 +1,14 @@
+export type JsonResponseInit = ResponseInit & {
+    pretty?: boolean;
+};
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, message: string, code?: string);
+}
+export declare function jsonResponse(value: unknown, init?: JsonResponseInit): Response;
+export declare function errorResponse(error: unknown, fallbackStatus?: number): Response;
+export declare function readJson<T = unknown>(request: Request): Promise<T>;
+export declare function requireBearerToken(request: Request): string;
+export declare function requireAdminToken(request: Request, expected: string | undefined): void;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,SAAU,SAAQ,KAAK;aAEhB,MAAM,EAAE,MAAM;aAEd,IAAI;gBAFJ,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,IAAI,SAAe;CAKtC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB,GAAG,QAAQ,CAOlF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,SAAM,GAAG,QAAQ,CAM5E;AAED,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAUxE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAK3D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAItF"}

package/dist/http.js

@@ -0,0 +1,53 @@
+export class HttpError extends Error {
+    status;
+    code;
+    constructor(status, message, code = "http_error") {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "HttpError";
+    }
+}
+export function jsonResponse(value, init = {}) {
+    const headers = new Headers(init.headers);
+    if (!headers.has("content-type"))
+        headers.set("content-type", "application/json; charset=utf-8");
+    return new Response(JSON.stringify(value, null, init.pretty ? 2 : 0), {
+        ...init,
+        headers,
+    });
+}
+export function errorResponse(error, fallbackStatus = 500) {
+    if (error instanceof HttpError) {
+        return jsonResponse({ error: { code: error.code, message: error.message } }, { status: error.status });
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return jsonResponse({ error: { code: "internal_error", message } }, { status: fallbackStatus });
+}
+export async function readJson(request) {
+    const contentType = request.headers.get("content-type") ?? "";
+    if (!contentType.toLowerCase().includes("application/json")) {
+        throw new HttpError(415, "Expected application/json request body.", "unsupported_media_type");
+    }
+    try {
+        return (await request.json());
+    }
+    catch {
+        throw new HttpError(400, "Invalid JSON request body.", "invalid_json");
+    }
+}
+export function requireBearerToken(request) {
+    const value = request.headers.get("authorization") ?? "";
+    const match = value.match(/^Bearer\s+(.+)$/i);
+    if (!match)
+        throw new HttpError(401, "Missing bearer token.", "missing_bearer_token");
+    return match[1];
+}
+export function requireAdminToken(request, expected) {
+    if (!expected)
+        throw new HttpError(500, "Admin token is not configured.", "admin_token_not_configured");
+    const provided = request.headers.get("x-admin-token") ?? requireBearerToken(request);
+    if (provided !== expected)
+        throw new HttpError(403, "Invalid admin token.", "invalid_admin_token");
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,7 @@
+export declare function createId(prefix: string, bytes?: number): string;
+export declare function createToken(prefix?: string, bytes?: number): string;
+export declare function randomBase64Url(bytes?: number): string;
+export declare function toBase64Url(input: string | Uint8Array): string;
+export declare function fromBase64Url(value: string): Uint8Array;
+export declare function sha256Hex(input: string): Promise<string>;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAI3D;AAED,wBAAgB,WAAW,CAAC,MAAM,SAAQ,EAAE,KAAK,SAAsB,GAAG,MAAM,CAE/E;AAED,wBAAgB,eAAe,CAAC,KAAK,SAAsB,GAAG,MAAM,CAInE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAK9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9D"}

package/dist/ids.js

@@ -0,0 +1,35 @@
+const DEFAULT_TOKEN_BYTES = 32;
+export function createId(prefix, bytes = 12) {
+    const cleanPrefix = prefix.trim().replace(/[^a-zA-Z0-9_-]/g, "_");
+    if (!cleanPrefix)
+        throw new Error("ID prefix is required.");
+    return `${cleanPrefix}_${randomBase64Url(bytes)}`;
+}
+export function createToken(prefix = "tok", bytes = DEFAULT_TOKEN_BYTES) {
+    return createId(prefix, bytes);
+}
+export function randomBase64Url(bytes = DEFAULT_TOKEN_BYTES) {
+    const data = new Uint8Array(Math.max(1, Math.floor(bytes)));
+    crypto.getRandomValues(data);
+    return toBase64Url(data);
+}
+export function toBase64Url(input) {
+    const bytes = typeof input === "string" ? new TextEncoder().encode(input) : input;
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
+}
+export function fromBase64Url(value) {
+    const padded = value.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(value.length / 4) * 4, "=");
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+export async function sha256Hex(input) {
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(input));
+    return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAK,GAAG,EAAE;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5D,OAAO,GAAG,WAAW,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAM,GAAG,KAAK,EAAE,KAAK,GAAG,mBAAmB;IACrE,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAK,GAAG,mBAAmB;IACzD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA0B;IACpD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClF,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxG,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export * from "./api.js";
+export * from "./ai.js";
+export * from "./billing.js";
+export * from "./cloudflare.js";
+export * from "./crypto.js";
+export * from "./d1.js";
+export * from "./email.js";
+export * from "./env.js";
+export * from "./http.js";
+export * from "./ids.js";
+export * from "./jobs.js";
+export * from "./mcp.js";
+export * from "./oauth.js";
+export * from "./ops-events.js";
+export * from "./pg.js";
+export * from "./r2-json.js";
+export * from "./rate-limit.js";
+export * from "./seo.js";
+export * from "./session.js";
+export * from "./testing.js";
+export * from "./time.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,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+export * from "./api.js";
+export * from "./ai.js";
+export * from "./billing.js";
+export * from "./cloudflare.js";
+export * from "./crypto.js";
+export * from "./d1.js";
+export * from "./email.js";
+export * from "./env.js";
+export * from "./http.js";
+export * from "./ids.js";
+export * from "./jobs.js";
+export * from "./mcp.js";
+export * from "./oauth.js";
+export * from "./ops-events.js";
+export * from "./pg.js";
+export * from "./r2-json.js";
+export * from "./rate-limit.js";
+export * from "./seo.js";
+export * from "./session.js";
+export * from "./testing.js";
+export * from "./time.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,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/jobs.d.ts

@@ -0,0 +1,52 @@
+import type { D1DatabaseLike } from "./d1.js";
+export type JobStatus = "queued" | "running" | "succeeded" | "failed";
+export type JobHandlerResult<TResult = unknown> = {
+    kind: "done";
+    result?: TResult | null;
+} | {
+    kind: "requeue";
+    result?: TResult | null;
+    availableAt?: string | null;
+};
+export type JobRecord<TPayload = unknown, TResult = unknown> = {
+    jobId: string;
+    jobType: string;
+    status: JobStatus;
+    payload: TPayload;
+    result: TResult | null;
+    lockKey: string | null;
+    attemptCount: number;
+    maxAttempts: number;
+    availableAt: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type EnqueueJobInput<TPayload = unknown> = {
+    jobType: string;
+    payload?: TPayload;
+    lockKey?: string | null;
+    maxAttempts?: number;
+    availableAt?: string | null;
+};
+export declare class D1JobStore {
+    private readonly db;
+    private readonly options;
+    constructor(db: D1DatabaseLike, options?: {
+        tableName?: string;
+        idPrefix?: string;
+    });
+    get tableName(): string;
+    enqueue<TPayload = unknown>(input: EnqueueJobInput<TPayload>): Promise<JobRecord<TPayload>>;
+    get<TPayload = unknown, TResult = unknown>(jobId: string): Promise<JobRecord<TPayload, TResult> | null>;
+    listQueued(limit?: number): Promise<JobRecord[]>;
+    claim<TPayload = unknown>(jobId: string): Promise<JobRecord<TPayload> | null>;
+    succeed<TResult = unknown>(jobId: string, result?: TResult | null): Promise<void>;
+    requeue<TResult = unknown>(jobId: string, result?: TResult | null, availableAt?: string | null): Promise<void>;
+    fail(jobId: string, error: unknown): Promise<void>;
+    run<TPayload = unknown, TResult = unknown>(jobId: string, handler: (job: JobRecord<TPayload, TResult>) => Promise<JobHandlerResult<TResult> | TResult | void>): Promise<JobHandlerResult<TResult>>;
+}
+export declare const D1_JOBS_SCHEMA = "\nCREATE TABLE IF NOT EXISTS jobs (\n  job_id TEXT PRIMARY KEY,\n  job_type TEXT NOT NULL,\n  status TEXT NOT NULL,\n  payload_json TEXT NOT NULL DEFAULT '{}',\n  result_json TEXT,\n  lock_key TEXT,\n  attempt_count INTEGER NOT NULL DEFAULT 0,\n  max_attempts INTEGER NOT NULL DEFAULT 3,\n  available_at TEXT,\n  started_at TEXT,\n  completed_at TEXT,\n  last_error TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS jobs_status_available_idx ON jobs(status, available_at, created_at);\nCREATE INDEX IF NOT EXISTS jobs_type_status_idx ON jobs(job_type, status, created_at);\nCREATE UNIQUE INDEX IF NOT EXISTS jobs_active_lock_key_idx ON jobs(lock_key)\n  WHERE lock_key IS NOT NULL AND status IN ('queued', 'running');\n";
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

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

package/dist/jobs.js

@@ -0,0 +1,195 @@
+import { parseJsonColumn, stringifyJsonColumn } from "./d1.js";
+import { createId } from "./ids.js";
+import { isFutureIso, nowIso } from "./time.js";
+export class D1JobStore {
+    db;
+    options;
+    constructor(db, options = {}) {
+        this.db = db;
+        this.options = options;
+    }
+    get tableName() {
+        return this.options.tableName ?? "jobs";
+    }
+    async enqueue(input) {
+        const jobId = createId(this.options.idPrefix ?? "job");
+        const now = nowIso();
+        await this.db
+            .prepare(`INSERT INTO ${this.tableName} (
+          job_id, job_type, status, payload_json, result_json, lock_key,
+          attempt_count, max_attempts, available_at, created_at, updated_at
+        ) VALUES (?, ?, 'queued', ?, NULL, ?, 0, ?, ?, ?, ?)`)
+            .bind(jobId, input.jobType, stringifyJsonColumn(input.payload ?? {}), input.lockKey ?? null, Math.max(1, Math.floor(input.maxAttempts ?? 3)), input.availableAt ?? null, now, now)
+            .run();
+        const job = await this.get(jobId);
+        if (!job)
+            throw new Error(`Failed to load enqueued job: ${jobId}`);
+        return job;
+    }
+    async get(jobId) {
+        const row = await this.db
+            .prepare(`SELECT
+          job_id AS jobId,
+          job_type AS jobType,
+          status,
+          payload_json AS payloadJson,
+          result_json AS resultJson,
+          lock_key AS lockKey,
+          attempt_count AS attemptCount,
+          max_attempts AS maxAttempts,
+          available_at AS availableAt,
+          started_at AS startedAt,
+          completed_at AS completedAt,
+          last_error AS lastError,
+          created_at AS createdAt,
+          updated_at AS updatedAt
+        FROM ${this.tableName}
+        WHERE job_id = ?
+        LIMIT 1`)
+            .bind(jobId)
+            .first();
+        return row ? rowToJob(row) : null;
+    }
+    async listQueued(limit = 25) {
+        const now = nowIso();
+        const rows = await this.db
+            .prepare(`SELECT
+          job_id AS jobId, job_type AS jobType, status, payload_json AS payloadJson,
+          result_json AS resultJson, lock_key AS lockKey, attempt_count AS attemptCount,
+          max_attempts AS maxAttempts, available_at AS availableAt, started_at AS startedAt,
+          completed_at AS completedAt, last_error AS lastError, created_at AS createdAt, updated_at AS updatedAt
+        FROM ${this.tableName}
+        WHERE status = 'queued' AND (available_at IS NULL OR available_at <= ?)
+        ORDER BY created_at ASC
+        LIMIT ?`)
+            .bind(now, Math.max(1, Math.min(100, Math.floor(limit))))
+            .all();
+        return (rows.results ?? []).map(rowToJob);
+    }
+    async claim(jobId) {
+        const current = await this.get(jobId);
+        if (!current || current.status === "succeeded" || current.status === "failed")
+            return null;
+        if (current.status === "queued" && isFutureIso(current.availableAt))
+            return null;
+        if (current.attemptCount >= current.maxAttempts) {
+            await this.fail(jobId, "Job exhausted all attempts.");
+            return null;
+        }
+        const now = nowIso();
+        const result = await this.db
+            .prepare(`UPDATE ${this.tableName}
+         SET status = 'running',
+             attempt_count = attempt_count + 1,
+             started_at = COALESCE(started_at, ?),
+             updated_at = ?,
+             last_error = NULL
+         WHERE job_id = ?
+           AND status IN ('queued', 'running')
+           AND (available_at IS NULL OR available_at <= ?)`)
+            .bind(now, now, jobId, now)
+            .run();
+        if (!Number(result.meta.changes ?? 0))
+            return null;
+        return this.get(jobId);
+    }
+    async succeed(jobId, result = null) {
+        const now = nowIso();
+        await this.db
+            .prepare(`UPDATE ${this.tableName}
+         SET status = 'succeeded', result_json = ?, completed_at = ?, updated_at = ?
+         WHERE job_id = ?`)
+            .bind(stringifyJsonColumn(result), now, now, jobId)
+            .run();
+    }
+    async requeue(jobId, result = null, availableAt = null) {
+        const now = nowIso();
+        await this.db
+            .prepare(`UPDATE ${this.tableName}
+         SET status = 'queued', result_json = ?, available_at = ?, updated_at = ?
+         WHERE job_id = ?`)
+            .bind(stringifyJsonColumn(result), availableAt, now, jobId)
+            .run();
+    }
+    async fail(jobId, error) {
+        const now = nowIso();
+        const message = error instanceof Error ? error.message : String(error);
+        await this.db
+            .prepare(`UPDATE ${this.tableName}
+         SET status = 'failed', last_error = ?, completed_at = ?, updated_at = ?
+         WHERE job_id = ?`)
+            .bind(message, now, now, jobId)
+            .run();
+    }
+    async run(jobId, handler) {
+        const job = await this.claim(jobId);
+        if (!job)
+            return { kind: "done", result: null };
+        try {
+            const output = await handler(job);
+            const normalized = normalizeJobResult(output);
+            if (normalized.kind === "requeue") {
+                await this.requeue(jobId, normalized.result ?? null, normalized.availableAt ?? null);
+            }
+            else {
+                await this.succeed(jobId, normalized.result ?? null);
+            }
+            return normalized;
+        }
+        catch (error) {
+            const latest = await this.get(jobId);
+            if (latest && latest.attemptCount < latest.maxAttempts) {
+                await this.requeue(jobId, { retryError: error instanceof Error ? error.message : String(error) });
+                return { kind: "requeue", result: null };
+            }
+            await this.fail(jobId, error);
+            throw error;
+        }
+    }
+}
+export const D1_JOBS_SCHEMA = `
+CREATE TABLE IF NOT EXISTS jobs (
+  job_id TEXT PRIMARY KEY,
+  job_type TEXT NOT NULL,
+  status TEXT NOT NULL,
+  payload_json TEXT NOT NULL DEFAULT '{}',
+  result_json TEXT,
+  lock_key TEXT,
+  attempt_count INTEGER NOT NULL DEFAULT 0,
+  max_attempts INTEGER NOT NULL DEFAULT 3,
+  available_at TEXT,
+  started_at TEXT,
+  completed_at TEXT,
+  last_error TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS jobs_status_available_idx ON jobs(status, available_at, created_at);
+CREATE INDEX IF NOT EXISTS jobs_type_status_idx ON jobs(job_type, status, created_at);
+CREATE UNIQUE INDEX IF NOT EXISTS jobs_active_lock_key_idx ON jobs(lock_key)
+  WHERE lock_key IS NOT NULL AND status IN ('queued', 'running');
+`;
+function rowToJob(row) {
+    return {
+        jobId: row.jobId,
+        jobType: row.jobType,
+        status: row.status,
+        payload: parseJsonColumn(row.payloadJson, {}),
+        result: parseJsonColumn(row.resultJson, null),
+        lockKey: row.lockKey,
+        attemptCount: Number(row.attemptCount),
+        maxAttempts: Number(row.maxAttempts),
+        availableAt: row.availableAt,
+        startedAt: row.startedAt,
+        completedAt: row.completedAt,
+        lastError: row.lastError,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+function normalizeJobResult(output) {
+    if (output && typeof output === "object" && "kind" in output)
+        return output;
+    return { kind: "done", result: (output ?? null) };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,18 @@
+import type { ApiOperationRegistry } from "./api.js";
+export type McpToolDescriptor = {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+};
+export declare function mcpToolsFromApiRegistry<TContext>(registry: ApiOperationRegistry<TContext>, options?: {
+    includeScopes?: boolean;
+}): McpToolDescriptor[];
+export declare function mcpWellKnownServerMetadata(options: {
+    name: string;
+    url: string;
+    description?: string;
+    authorizationServers?: string[];
+}): Record<string, unknown>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAC9C,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EACxC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,iBAAiB,EAAE,CAQrB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1B"}

package/dist/mcp.js

@@ -0,0 +1,33 @@
+export function mcpToolsFromApiRegistry(registry, options = {}) {
+    return Object.values(registry).map((operation) => ({
+        name: operation.name,
+        title: operation.title,
+        description: operation.description,
+        inputSchema: jsonSchemaPlaceholder(operation.path),
+        annotations: options.includeScopes && operation.scope ? { scope: operation.scope } : undefined,
+    }));
+}
+export function mcpWellKnownServerMetadata(options) {
+    return {
+        name: options.name,
+        description: options.description,
+        transport: "http",
+        url: options.url,
+        authorization_servers: options.authorizationServers,
+    };
+}
+function jsonSchemaPlaceholder(path) {
+    const properties = {};
+    const required = [];
+    for (const match of path.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)) {
+        properties[match[1]] = { type: "string" };
+        required.push(match[1]);
+    }
+    return {
+        type: "object",
+        properties,
+        required,
+        additionalProperties: true,
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,uBAAuB,CACrC,QAAwC,EACxC,UAAuC,EAAE;IAEzC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,WAAW,EAAE,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC;QAClD,WAAW,EAAE,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;KAC/F,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAK1C;IACC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,qBAAqB,EAAE,OAAO,CAAC,oBAAoB;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;QACnE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ;QACR,oBAAoB,EAAE,IAAI;KAC3B,CAAC;AACJ,CAAC"}

package/dist/oauth.d.ts

@@ -0,0 +1,17 @@
+export type OAuthMetadataOptions = {
+    issuer: string;
+    authorizationPath?: string;
+    tokenPath?: string;
+    registrationPath?: string;
+    revocationPath?: string;
+    scopes?: string[];
+    resourceDocumentation?: string;
+};
+export declare function oauthAuthorizationServerMetadata(options: OAuthMetadataOptions): Record<string, unknown>;
+export declare function oauthProtectedResourceMetadata(resource: string, authorizationServer: string, scopes?: string[]): Record<string, unknown>;
+export declare function mcpServerCard(options: {
+    name: string;
+    description?: string;
+    url: string;
+}): Record<string, unknown>;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevG;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOxI;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOnH"}

package/dist/oauth.js

@@ -0,0 +1,33 @@
+export function oauthAuthorizationServerMetadata(options) {
+    const issuer = options.issuer.replace(/\/$/, "");
+    return {
+        issuer,
+        authorization_endpoint: `${issuer}${options.authorizationPath ?? "/authorize"}`,
+        token_endpoint: `${issuer}${options.tokenPath ?? "/token"}`,
+        registration_endpoint: `${issuer}${options.registrationPath ?? "/register"}`,
+        revocation_endpoint: `${issuer}${options.revocationPath ?? "/revoke"}`,
+        response_types_supported: ["code"],
+        grant_types_supported: ["authorization_code", "refresh_token"],
+        token_endpoint_auth_methods_supported: ["client_secret_post", "none"],
+        code_challenge_methods_supported: ["S256"],
+        scopes_supported: options.scopes ?? ["mcp:read", "mcp:write"],
+        resource_documentation: options.resourceDocumentation ?? `${issuer}/mcp`,
+    };
+}
+export function oauthProtectedResourceMetadata(resource, authorizationServer, scopes) {
+    return {
+        resource,
+        authorization_servers: [authorizationServer.replace(/\/$/, "")],
+        scopes_supported: scopes ?? ["mcp:read", "mcp:write"],
+        bearer_methods_supported: ["header"],
+    };
+}
+export function mcpServerCard(options) {
+    return {
+        name: options.name,
+        description: options.description,
+        url: options.url,
+        transport: "http",
+    };
+}
+//# sourceMappingURL=oauth.js.map

package/dist/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,gCAAgC,CAAC,OAA6B;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO;QACL,MAAM;QACN,sBAAsB,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,IAAI,YAAY,EAAE;QAC/E,cAAc,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,QAAQ,EAAE;QAC3D,qBAAqB,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,gBAAgB,IAAI,WAAW,EAAE;QAC5E,mBAAmB,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,EAAE;QACtE,wBAAwB,EAAE,CAAC,MAAM,CAAC;QAClC,qBAAqB,EAAE,CAAC,oBAAoB,EAAE,eAAe,CAAC;QAC9D,qCAAqC,EAAE,CAAC,oBAAoB,EAAE,MAAM,CAAC;QACrE,gCAAgC,EAAE,CAAC,MAAM,CAAC;QAC1C,gBAAgB,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC;QAC7D,sBAAsB,EAAE,OAAO,CAAC,qBAAqB,IAAI,GAAG,MAAM,MAAM;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,QAAgB,EAAE,mBAA2B,EAAE,MAAiB;IAC7G,OAAO;QACL,QAAQ;QACR,qBAAqB,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/D,gBAAgB,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC;QACrD,wBAAwB,EAAE,CAAC,QAAQ,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA4D;IACxF,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,MAAM;KAClB,CAAC;AACJ,CAAC"}

package/dist/ops-events.d.ts

@@ -0,0 +1,25 @@
+import type { D1DatabaseLike } from "./d1.js";
+export type OpsSeverity = "debug" | "info" | "warn" | "error";
+export type OpsEventInput = {
+    eventType: string;
+    severity?: OpsSeverity;
+    source: string;
+    fingerprint?: string | null;
+    payload?: unknown;
+};
+export type OpsEventRow = {
+    id: number;
+    event_type: string;
+    severity: OpsSeverity;
+    source: string;
+    fingerprint: string | null;
+    payload_json: string;
+    created_at: string;
+};
+export declare function recordOpsEvent(db: D1DatabaseLike, input: OpsEventInput): Promise<void>;
+export declare function listRecentOpsEvents(db: D1DatabaseLike, options?: {
+    limit?: number;
+    eventType?: string | null;
+}): Promise<OpsEventRow[]>;
+export declare const D1_OPS_EVENTS_SCHEMA = "\nCREATE TABLE IF NOT EXISTS ops_events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  event_type TEXT NOT NULL,\n  severity TEXT NOT NULL DEFAULT 'info',\n  source TEXT NOT NULL,\n  fingerprint TEXT,\n  payload_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP\n);\nCREATE INDEX IF NOT EXISTS ops_events_created_at_idx ON ops_events(created_at DESC);\nCREATE INDEX IF NOT EXISTS ops_events_type_created_idx ON ops_events(event_type, created_at DESC);\nCREATE INDEX IF NOT EXISTS ops_events_severity_created_idx ON ops_events(severity, created_at DESC);\n";
+//# sourceMappingURL=ops-events.d.ts.map

package/dist/ops-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-events.d.ts","sourceRoot":"","sources":["../src/ops-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,cAAc,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5F;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC1D,OAAO,CAAC,WAAW,EAAE,CAAC,CAuBxB;AAED,eAAO,MAAM,oBAAoB,olBAahC,CAAC"}