@browserlessapi/inferlo 0.3.0 → 0.5.0

package/dist/elysia.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Inferlo inside ElysiaJS (1.0 and later), without a runtime dependency on Elysia:
+ *
+ *   import { Elysia } from "elysia";
+ *   import { createAI, anthropic } from "@browserlessapi/inferlo/ai";
+ *   import { inferloAI } from "@browserlessapi/inferlo/elysia";
+ *
+ *   const server = new Elysia()
+ *     .use(inferloAI(ai))                               // ({ ai }) in every handler, typed
+ *     .mount("/api", inferloApp.fetch);                 // or a whole Inferlo app under a path
+ *
+ * This entry point never loads the router, database or jobs code.
+ */
+import type { Elysia } from "elysia";
+import type { AI } from "./ai/index.ts";
+/**
+ * An Elysia plugin that decorates the context with an AI client (createAI(...) or an Inferlo app's app.ai):
+ * new Elysia().use(inferloAI(ai)).post("/classify", ({ ai, body }) => ...).
+ */
+export declare function inferloAI(ai: AI): (app: Elysia) => Elysia<"", {
+    decorator: {
+        ai: AI;
+    };
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/elysia.js

@@ -0,0 +1,10 @@
+import { assertAIClient } from "./ai-client.js";
+/**
+ * An Elysia plugin that decorates the context with an AI client (createAI(...) or an Inferlo app's app.ai):
+ * new Elysia().use(inferloAI(ai)).post("/classify", ({ ai, body }) => ...).
+ */
+export function inferloAI(ai) {
+    assertAIClient(ai, 'Pass createAI({ providers, models }) from "@browserlessapi/inferlo/ai", or an Inferlo app\'s app.ai: new Elysia().use(inferloAI(ai)).');
+    return (app) => app.decorate("ai", ai);
+}
+//# sourceMappingURL=elysia.js.map

package/dist/elysia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elysia.js","sourceRoot":"","sources":["../src/elysia.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAM;IAC9B,cAAc,CAAC,EAAE,EAAE,uIAAuI,CAAC,CAAC;IAC5J,OAAO,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/env.d.ts

@@ -1,5 +1,7 @@
 /** Use a fixed set of variables (tests, Cloudflare Workers bindings). */
 export declare function setEnv(values: Record<string, string | undefined> | undefined): void;
+/** The raw value of an environment variable (or of setEnv overrides). */
+export declare function readEnv(name: string): string | undefined;
 interface EnvFn {
     (name: string): string;
     (name: string, options: {

package/dist/env.js

@@ -12,7 +12,8 @@ let overrides;
 export function setEnv(values) {
     overrides = values;
 }
-function read(name) {
+/** The raw value of an environment variable (or of setEnv overrides). */
+export function readEnv(name) {
     if (overrides && name in overrides)
         return overrides[name];
     const g = globalThis;
@@ -34,7 +35,7 @@ function missing(name) {
     });
 }
 export const env = Object.assign((name, options = {}) => {
-    const value = read(name);
+    const value = readEnv(name);
     if (value !== undefined && value !== "")
         return value;
     if (options.default !== undefined)
@@ -44,7 +45,7 @@ export const env = Object.assign((name, options = {}) => {
     throw missing(name);
 }, {
     int(name, options = {}) {
-        const value = read(name);
+        const value = readEnv(name);
         if (value === undefined || value === "") {
             if (options.default !== undefined)
                 return options.default;
@@ -56,7 +57,7 @@ export const env = Object.assign((name, options = {}) => {
         return n;
     },
     bool(name, options = {}) {
-        const value = read(name)?.toLowerCase();
+        const value = readEnv(name)?.toLowerCase();
         if (value === undefined || value === "") {
             if (options.default !== undefined)
                 return options.default;

package/dist/env.js.map

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

package/dist/express.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Inferlo inside Express (4 and 5), without a runtime dependency on Express:
+ *
+ *   import express from "express";
+ *   import { createAI, anthropic } from "@browserlessapi/inferlo/ai";
+ *   import { toNodeHandler } from "@browserlessapi/inferlo";
+ *   import { inferloAI, sendResponse } from "@browserlessapi/inferlo/express";
+ *
+ *   const server = express();
+ *   server.use(inferloAI(ai));                          // req.ai in every handler
+ *   server.get("/chat", (req, res) => sendResponse(res, req.ai.stream({ prompt: "Hi" }).toResponse()));
+ *   server.use("/api", toNodeHandler(inferloApp));      // or a whole Inferlo app under a path
+ *
+ * Importing this entry point adds `ai` to Express's Request type. It never loads the router, database or jobs code.
+ */
+import type { AI } from "./ai/index.ts";
+import { type NodeResponse } from "./serve.ts";
+declare global {
+    namespace Express {
+        interface Request {
+            /** The AI client set by inferloAI() from @browserlessapi/inferlo/express. */
+            ai: AI;
+        }
+    }
+}
+/** The part of an Express request that inferloAI() uses. */
+export interface ExpressRequestLike {
+    ai?: AI;
+}
+/** An Express middleware: server.use(inferloAI(ai)) or server.use("/chat", inferloAI(ai)). */
+export type InferloAIMiddleware = (req: ExpressRequestLike, res: unknown, next: (error?: unknown) => void) => void;
+/** Puts an AI client (createAI(...) or an Inferlo app's app.ai) on every Express request as req.ai. */
+export declare function inferloAI(ai: AI): InferloAIMiddleware;
+/**
+ * Send a Web Response from an Express (or node:http) handler: status, headers (every Set-Cookie) and the
+ * body, streamed. Use it for AI streams: sendResponse(res, req.ai.stream({ prompt }).toResponse()).
+ */
+export declare function sendResponse(res: NodeResponse, response: Response): Promise<void>;

package/dist/express.js

@@ -0,0 +1,18 @@
+import { assertAIClient } from "./ai-client.js";
+import { writeResponse } from "./serve.js";
+/** Puts an AI client (createAI(...) or an Inferlo app's app.ai) on every Express request as req.ai. */
+export function inferloAI(ai) {
+    assertAIClient(ai, 'Pass createAI({ providers, models }) from "@browserlessapi/inferlo/ai", or an Inferlo app\'s app.ai: server.use(inferloAI(ai)).');
+    return (req, _res, next) => {
+        req.ai = ai;
+        next();
+    };
+}
+/**
+ * Send a Web Response from an Express (or node:http) handler: status, headers (every Set-Cookie) and the
+ * body, streamed. Use it for AI streams: sendResponse(res, req.ai.stream({ prompt }).toResponse()).
+ */
+export function sendResponse(res, response) {
+    return writeResponse(res, response, "GET");
+}
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAqB,MAAM,YAAY,CAAC;AAoB9D,uGAAuG;AACvG,MAAM,UAAU,SAAS,CAAC,EAAM;IAC9B,cAAc,CAAC,EAAE,EAAE,iIAAiI,CAAC,CAAC;IACtJ,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACzB,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;QACZ,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAiB,EAAE,QAAkB;IAChE,OAAO,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/fastify.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Inferlo inside Fastify (5 and later), without a runtime dependency on Fastify:
+ *
+ *   import Fastify from "fastify";
+ *   import { createAI, anthropic } from "@browserlessapi/inferlo/ai";
+ *   import { inferloPlugin } from "@browserlessapi/inferlo/fastify";
+ *
+ *   const fastify = Fastify();
+ *   await fastify.register(inferloPlugin, { ai });                         // fastify.ai and request.ai
+ *   await fastify.register(inferloPlugin, { app: inferloApp, prefix: "/api" }); // or a whole Inferlo app under /api
+ *
+ * Importing this entry point adds `ai` to Fastify's instance and request types. It never loads the router,
+ * database or jobs code.
+ */
+import type { FastifyPluginAsync } from "fastify";
+import type { AI } from "./ai/index.ts";
+declare module "fastify" {
+    interface FastifyInstance {
+        /** The AI client registered with inferloPlugin from @browserlessapi/inferlo/fastify. */
+        ai: AI;
+    }
+    interface FastifyRequest {
+        /** The AI client registered with inferloPlugin from @browserlessapi/inferlo/fastify. */
+        ai: AI;
+    }
+}
+export interface InferloPluginOptions {
+    /** AI client for fastify.ai and request.ai: createAI(...) or an Inferlo app's app.ai. Default: app.ai, unless fastify.ai is already set. */
+    ai?: AI;
+    /** A whole Inferlo app (routes, auth, OpenAPI, MCP) to serve under prefix. */
+    app?: {
+        fetch(req: Request, ...rest: unknown[]): Promise<Response>;
+        ai?: AI;
+    };
+    /** Path the app is served under, for example "/api". Required with app. */
+    prefix?: string;
+}
+/** A Fastify plugin, registered with fastify.register(inferloPlugin, options). */
+export type InferloPlugin = FastifyPluginAsync<InferloPluginOptions>;
+/**
+ * Fastify plugin. { ai } decorates fastify.ai and request.ai everywhere in the Fastify app; { app, prefix }
+ * serves a whole Inferlo app (routes, auth, validation, OpenAPI, MCP) under prefix. Both can be combined.
+ */
+export declare const inferloPlugin: InferloPlugin;

package/dist/fastify.js

@@ -0,0 +1,47 @@
+import { assertAIClient } from "./ai-client.js";
+import { InferloError } from "./errors.js";
+import { toNodeHandler } from "./serve.js";
+const bad = (message, fix) => new InferloError("IL5015", message, { fix });
+async function plugin(fastify, options) {
+    const { app, prefix } = options ?? {};
+    if (app !== undefined && (typeof app !== "object" || app === null || typeof app.fetch !== "function")) {
+        throw bad("inferloPlugin's app must be an Inferlo app (createApp(...)).", 'Use fastify.register(inferloPlugin, { app: inferloApp, prefix: "/api" }).');
+    }
+    // app.ai is the default, unless an earlier register(inferloPlugin, { ai }) already set fastify.ai.
+    const ai = options?.ai ?? (fastify.hasDecorator("ai") ? undefined : app?.ai);
+    if (!app && !options?.ai)
+        throw bad("inferloPlugin needs ai, app or both.", 'Use fastify.register(inferloPlugin, { ai }) for fastify.ai and request.ai, or { app, prefix: "/api" } to serve an Inferlo app.');
+    if (ai !== undefined) {
+        assertAIClient(ai, 'Pass createAI({ providers, models }) from "@browserlessapi/inferlo/ai", or an Inferlo app\'s app.ai: fastify.register(inferloPlugin, { ai }).');
+        fastify.decorate("ai", ai);
+        fastify.decorateRequest("ai", { getter: () => ai });
+    }
+    if (!app)
+        return;
+    if (typeof prefix !== "string" || !/^\/[^*?#]*[^/*?#]$/.test(prefix)) {
+        throw bad(`inferloPlugin needs a prefix such as "/api" to serve an app, got ${JSON.stringify(prefix)}.`, 'Use fastify.register(inferloPlugin, { app, prefix: "/api" }).');
+    }
+    const handler = toNodeHandler(app, { prefix });
+    // In a child context, so the catch-all body parser applies to the app's routes only: Inferlo reads the
+    // body stream itself (JSON, forms, any size limit), and Fastify answers nothing for these paths.
+    await fastify.register(async (child) => {
+        child.removeAllContentTypeParsers();
+        child.addContentTypeParser("*", (_request, _payload, done) => done(null));
+        const mount = async (request, reply) => {
+            reply.hijack();
+            await handler(request.raw, reply.raw);
+        };
+        child.all(prefix, mount);
+        child.all(`${prefix}/*`, mount);
+    });
+}
+/**
+ * Fastify plugin. { ai } decorates fastify.ai and request.ai everywhere in the Fastify app; { app, prefix }
+ * serves a whole Inferlo app (routes, auth, validation, OpenAPI, MCP) under prefix. Both can be combined.
+ */
+export const inferloPlugin = Object.assign(plugin, {
+    // Like fastify-plugin: the decorators are visible to the whole Fastify app, not only inside this plugin.
+    [Symbol.for("skip-override")]: true,
+    [Symbol.for("fastify.display-name")]: "inferlo",
+});
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

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

package/dist/hono.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Inferlo inside Hono (4.0 and later), without a runtime dependency on Hono:
+ *
+ *   import { Hono } from "hono";
+ *   import { createAI, anthropic } from "@browserlessapi/inferlo/ai";
+ *   import { inferloAI, type InferloVariables } from "@browserlessapi/inferlo/hono";
+ *
+ *   const hono = new Hono<{ Variables: InferloVariables }>();
+ *   hono.use(inferloAI(ai));                          // c.var.ai in every handler
+ *   hono.mount("/api", inferloApp.fetch);             // or a whole Inferlo app under a path
+ *
+ * This entry point never loads the router, database or jobs code.
+ */
+import type { AI } from "./ai/index.ts";
+/** Context variables set by inferloAI(): new Hono<{ Variables: InferloVariables }>(). */
+export type InferloVariables = {
+    ai: AI;
+};
+/** The part of Hono's Context that inferloAI() uses. */
+export interface HonoContextLike {
+    set(key: "ai", value: AI): void;
+}
+/** A Hono middleware: hono.use(inferloAI(ai)) or hono.use("/chat/*", inferloAI(ai)). */
+export type InferloAIMiddleware = (c: HonoContextLike, next: () => Promise<void>) => Promise<void>;
+/** Puts an AI client (createAI(...) or an Inferlo app's app.ai) on the Hono context as c.var.ai. */
+export declare function inferloAI(ai: AI): InferloAIMiddleware;

package/dist/hono.js

@@ -0,0 +1,10 @@
+import { assertAIClient } from "./ai-client.js";
+/** Puts an AI client (createAI(...) or an Inferlo app's app.ai) on the Hono context as c.var.ai. */
+export function inferloAI(ai) {
+    assertAIClient(ai, 'Pass createAI({ providers, models }) from "@browserlessapi/inferlo/ai", or an Inferlo app\'s app.ai: hono.use(inferloAI(ai)).');
+    return async (c, next) => {
+        c.set("ai", ai);
+        await next();
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAahD,oGAAoG;AACpG,MAAM,UAAU,SAAS,CAAC,EAAM;IAC9B,cAAc,CAAC,EAAE,EAAE,+HAA+H,CAAC,CAAC;IACpJ,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChB,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,26 +1,40 @@
 /**
- * Inferlo: the TypeScript backend framework with built-in AI model support.
+ * Inferlo: the enterprise-ready TypeScript backend framework, with AI models built in.
  * https://github.com/BrowserlessAPI/Inferlo
  */
 export { createApp } from "./app.ts";
-export type { App, AppConfig, AuthConfig, CorsConfig, Middleware, MiddlewareContext, RequestOptions, RouteSource, Logger } from "./app.ts";
+export type { LogFields, LoggingConfig } from "./logging.ts";
+export type { MetricsConfig } from "./metrics.ts";
+export type { Deprecation } from "./deprecation.ts";
+export type { App, AppConfig, AuthConfig, CorsConfig, Middleware, MiddlewareContext, RequestOptions, RouteSource, Logger, HealthConfig, HealthCheck, CheckResult, ReadinessReport, CloseOptions } from "./app.ts";
+export type { SecureHeadersConfig } from "./secure-headers.ts";
 export { route, isRoute } from "./route.ts";
 export type { Register, Context, RouteDef, RouteOptions, Auth, Method, ToolOptions, AppUser, AppDb } from "./route.ts";
-export { t, Schema, ObjectSchema, ArraySchema, ValidationError, toJSONSchema } from "./schema.ts";
+export { t, Schema, ObjectSchema, ArraySchema, RefSchema, ValidationError, toJSONSchema } from "./schema.ts";
 export type { Infer, InferInput, Issue, JSONSchema, ParseResult, Shape, AnySchema } from "./schema.ts";
 export { model, Model, columnName } from "./model.ts";
 export type { Row, CreateInput, UpdateInput, AnyModel } from "./model.ts";
 export { memory } from "./db/memory.ts";
 export { createDb, Table } from "./db/table.ts";
-export type { Db, Where, OrderBy, FindManyOptions } from "./db/table.ts";
+export type { Db, Where, OrderBy, FindManyOptions, FindOptions, PaginateOptions, Page, Include, Relations, ReverseRelations, WithInclude } from "./db/table.ts";
 export type { Adapter, Condition, Query, DbRecord } from "./db/types.ts";
 export { planMigration, applyMigrations } from "./db/migrate.ts";
 export type { ApplyMigrationsOptions, Migration, MigrationPlan, MigrationSnapshot, MigrationSnapshotColumn, MigrationSnapshotV1, PlanMigrationOptions, } from "./db/migrate.ts";
 export { createAI, cosineSimilarity, extractJson, openai, openaiCompatible, anthropic, gemini, ollama, mockProvider, ProviderError } from "./ai/index.ts";
-export type { AI, AIConfig, GenerateOptions, GenerateResult, StreamResult, Usage, Pricing, Provider, ProviderRequest, Message } from "./ai/index.ts";
+export { tool, isTool, ToolBuilder } from "./ai/tool.ts";
+export type { ToolDef, FunctionToolOptions, ToolContext } from "./ai/tool.ts";
+export type { AI, AIConfig, GenerateOptions, GenerateResult, StreamResult, Usage, Pricing, Provider, ProviderRequest, ProviderResponse, Image, ImageMediaType, Message, MockReply, Step, ToolCall, ToolCallResult, ToolSpec, } from "./ai/index.ts";
+export type { RateLimit, RateLimitConfig } from "./rate-limit.ts";
+export { job, isJob, retryDelayMs } from "./jobs.ts";
+export { cron, isCron } from "./cron.ts";
+export type { CronDef } from "./cron.ts";
+export type { JobDef, JobOptions, JobContext, JobInput, JobRecord, JobStatus, JobSource, JobQueueConfig, Jobs, AppJobs, EnqueueOptions, RunResult, Worker } from "./jobs.ts";
 export { bearer, hashToken, createToken, hashPassword, verifyPassword, safeEqual } from "./auth.ts";
 export { env, setEnv } from "./env.ts";
+export { config } from "./config.ts";
+export type { Config, ConfigOptions } from "./config.ts";
 export { InferloError, httpError, notFound, forbidden, badRequest, docsUrl } from "./errors.ts";
-export { serve } from "./serve.ts";
+export { serve, toNodeHandler, fromNodeRequest } from "./serve.ts";
+export type { ServeOptions, Server, NodeRequest, NodeResponse, NodeHandler, NodeHandlerOptions, FromNodeRequestOptions } from "./serve.ts";
 export { INFERLO_VERSION } from "./describe.ts";
 export type { AppDescription } from "./describe.ts";

package/dist/index.js

@@ -1,18 +1,22 @@
 /**
- * Inferlo: the TypeScript backend framework with built-in AI model support.
+ * Inferlo: the enterprise-ready TypeScript backend framework, with AI models built in.
  * https://github.com/BrowserlessAPI/Inferlo
  */
 export { createApp } from "./app.js";
 export { route, isRoute } from "./route.js";
-export { t, Schema, ObjectSchema, ArraySchema, ValidationError, toJSONSchema } from "./schema.js";
+export { t, Schema, ObjectSchema, ArraySchema, RefSchema, ValidationError, toJSONSchema } from "./schema.js";
 export { model, Model, columnName } from "./model.js";
 export { memory } from "./db/memory.js";
 export { createDb, Table } from "./db/table.js";
 export { planMigration, applyMigrations } from "./db/migrate.js";
 export { createAI, cosineSimilarity, extractJson, openai, openaiCompatible, anthropic, gemini, ollama, mockProvider, ProviderError } from "./ai/index.js";
+export { tool, isTool, ToolBuilder } from "./ai/tool.js";
+export { job, isJob, retryDelayMs } from "./jobs.js";
+export { cron, isCron } from "./cron.js";
 export { bearer, hashToken, createToken, hashPassword, verifyPassword, safeEqual } from "./auth.js";
 export { env, setEnv } from "./env.js";
+export { config } from "./config.js";
 export { InferloError, httpError, notFound, forbidden, badRequest, docsUrl } from "./errors.js";
-export { serve } from "./serve.js";
+export { serve, toNodeHandler, fromNodeRequest } from "./serve.js";
 export { INFERLO_VERSION } from "./describe.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGlG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAWjE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG1J,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAOrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7G,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAWjE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1J,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAwBzD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/jobs.d.ts

@@ -0,0 +1,181 @@
+/**
+ * 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;
+}
+/** Stop every worker started with jobs.start() and wait for their running jobs (used by app.close()). */
+export declare function stopWorkers(jobs: AppJobs): Promise<void>;
+/** 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;
+    };
+    /** Called after each attempt with its outcome and duration (metrics). */
+    onRun?(name: string, outcome: keyof RunResult, durationMs: number): 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;