@browserlessapi/inferlo 0.5.0 → 0.7.0

package/dist/hapi.js

@@ -0,0 +1,57 @@
+import { assertAIClient } from "./ai-client.js";
+import { InferloError } from "./errors.js";
+import { toNodeHandler } from "./serve.js";
+const bad = (message, fix) => new InferloError("IL5025", message, { fix });
+async function register(server, options) {
+    if (options === null || typeof options !== "object") {
+        throw bad("inferloPlugin options must be an object with ai, app or both.", "Use server.register({ plugin: inferloPlugin, options: { ai } }).");
+    }
+    if ("prefix" in options) {
+        throw bad("inferloPlugin takes the path prefix from hapi, not from its options.", 'Use server.register({ plugin: inferloPlugin, options: { app }, routes: { prefix: "/api" } }).');
+    }
+    const { app } = 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 server.register({ plugin: inferloPlugin, options: { app: inferloApp }, routes: { prefix: "/api" } }).');
+    }
+    if (!app && !options.ai) {
+        throw bad("inferloPlugin needs ai, app or both.", 'Use options: { ai } for server.ai and request.ai, or options: { app } with routes: { prefix: "/api" } to serve an Inferlo app.');
+    }
+    const decorated = server.decorations.server.includes("ai");
+    // app.ai is the default, unless an earlier registration with { ai } already set server.ai.
+    const ai = options.ai ?? (decorated ? undefined : app?.ai);
+    if (ai !== undefined) {
+        assertAIClient(ai, 'Pass createAI({ providers, models }) from "@browserlessapi/inferlo/ai", or an Inferlo app\'s app.ai: server.register({ plugin: inferloPlugin, options: { ai } }).');
+        if (decorated) {
+            throw bad("server.ai is already set by an earlier inferloPlugin registration.", "Register inferloPlugin with { ai } once, and with { app } (without ai) for each app you serve.");
+        }
+        // A value, not a method (older hapi types only describe method decorations).
+        server.decorate("server", "ai", ai);
+        // A getter, so every request reads the one client.
+        server.decorate("request", "ai", () => ai, { apply: true });
+    }
+    if (!app)
+        return;
+    const prefix = server.realm.modifiers.route.prefix;
+    const handler = toNodeHandler(app, { prefix });
+    // Inferlo reads the body stream itself (JSON, forms, its own size limits) and writes the answer, streams
+    // included, to the Node response; hapi's own routes stay more specific than this catch-all.
+    server.route({
+        method: "*",
+        path: "/{path*}",
+        options: { payload: { output: "stream", parse: false }, description: "Inferlo app" },
+        handler: async (request, h) => {
+            await handler(request.raw.req, request.raw.res);
+            return h.abandon;
+        },
+    });
+}
+/**
+ * hapi plugin. options: { ai } decorates server.ai and request.ai; options: { app } serves a whole Inferlo app
+ * (routes, auth, validation, OpenAPI, MCP) under the prefix the plugin is registered with (routes: { prefix }).
+ */
+export const inferloPlugin = {
+    name: "@browserlessapi/inferlo",
+    multiple: true,
+    register,
+};
+//# sourceMappingURL=hapi.js.map

package/dist/hapi.js.map

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

package/dist/index.d.ts

@@ -8,32 +8,52 @@ 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 { module, isModule } from "./module.ts";
+export type { Module, ModuleOptions, AnyModule, ModuleModels } from "./module.ts";
+export { apiVersion } from "./api-version.ts";
+export type { ApiVersionOptions } from "./api-version.ts";
 export { route, isRoute } from "./route.ts";
-export type { Register, Context, RouteDef, RouteOptions, Auth, Method, ToolOptions, AppUser, AppDb } from "./route.ts";
+export type { Register, Context, RouteDef, RouteInput, RouteOptions, Auth, Method, ToolOptions, AppUser, AppDb, AppPermission } from "./route.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 type { Row, CreateInput, UpdateInput, AnyModel, ModelOptions } from "./model.ts";
 export { memory } from "./db/memory.ts";
 export { createDb, Table } from "./db/table.ts";
-export type { Db, Where, OrderBy, FindManyOptions, FindOptions, PaginateOptions, Page, Include, Relations, ReverseRelations, WithInclude } from "./db/table.ts";
+export type { Db, PgClient, 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 { createAI, cosineSimilarity, extractJson, openai, openaiCompatible, anthropic, gemini, ollama, mockProvider, ProviderError, uiChatBody, fromUIMessages } from "./ai/index.ts";
 export { tool, isTool, ToolBuilder } from "./ai/tool.ts";
+export { aiSdk } from "./ai/ai-sdk.ts";
+export type { AISdkProvider, AISdkLanguageModel, AISdkEmbeddingModel, AISdkOptions } from "./ai/ai-sdk.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 { AI, AIConfig, GenerateOptions, GenerateResult, StreamResult, StreamResponseInit, UIChatMessage, 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 type { RedisClient } from "./redis.ts";
 export { job, isJob, retryDelayMs } from "./jobs.ts";
 export { cron, isCron } from "./cron.ts";
+export { event, isEvent, on } from "./events.ts";
+export type { AppEvents, EventDef, EventMessage, EventOptions, EventPayload, Events, EventsConfig, EventTransport, OnDef, PublishedEvent, PublishOptions } from "./events.ts";
 export type { CronDef } from "./cron.ts";
+export type { JobTraceContext } from "./tracing.ts";
 export type { JobDef, JobOptions, JobContext, JobInput, JobRecord, JobStatus, JobSource, JobQueueConfig, Jobs, AppJobs, EnqueueOptions, RunResult, Worker } from "./jobs.ts";
+export { AuditLog, auditChanges } from "./audit.ts";
+export type { Audit, AuditEntry, AuditChange } from "./audit.ts";
+export type { Cache, CacheConfig, CacheSetOptions, RouteCache } from "./cache.ts";
+export { permissions, isPermissions } from "./permissions.ts";
+export type { Permissions, PermissionRule, PermissionInput } from "./permissions.ts";
 export { bearer, hashToken, createToken, hashPassword, verifyPassword, safeEqual } from "./auth.ts";
+export { sessions } from "./sessions.ts";
+export type { TracingConfig, OtelApi, OtelSpan } from "./tracing.ts";
+export type { Sessions, SessionsOptions, SessionData, SessionCookieOptions, SessionResponseContext } from "./sessions.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 { serviceClient, ServiceCallError } from "./service-client.ts";
+export type { ServiceClient, ServiceClientOptions, CallInput, CallOptions, CallContext, CallResult, TypedRoute } from "./service-client.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";

package/dist/index.js

@@ -3,20 +3,28 @@
  * https://github.com/BrowserlessAPI/Inferlo
  */
 export { createApp } from "./app.js";
+export { module, isModule } from "./module.js";
+export { apiVersion } from "./api-version.js";
 export { route, isRoute } from "./route.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 { createAI, cosineSimilarity, extractJson, openai, openaiCompatible, anthropic, gemini, ollama, mockProvider, ProviderError, uiChatBody, fromUIMessages } from "./ai/index.js";
 export { tool, isTool, ToolBuilder } from "./ai/tool.js";
+export { aiSdk } from "./ai/ai-sdk.js";
 export { job, isJob, retryDelayMs } from "./jobs.js";
 export { cron, isCron } from "./cron.js";
+export { event, isEvent, on } from "./events.js";
+export { AuditLog, auditChanges } from "./audit.js";
+export { permissions, isPermissions } from "./permissions.js";
 export { bearer, hashToken, createToken, hashPassword, verifyPassword, safeEqual } from "./auth.js";
+export { sessions } from "./sessions.js";
 export { env, setEnv } from "./env.js";
 export { config } from "./config.js";
 export { InferloError, httpError, notFound, forbidden, badRequest, docsUrl } from "./errors.js";
+export { serviceClient, ServiceCallError } from "./service-client.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;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"}
+{"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,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,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,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtL,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AA4BvC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAKjD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,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,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/jobs.d.ts

@@ -11,10 +11,14 @@
  * jobs in this process, app.jobs.runDue() runs them once (tests).
  */
 import type { AI } from "./ai/index.ts";
+import type { Audit } from "./audit.ts";
+import type { Cache } from "./cache.ts";
 import { type CronDef } from "./cron.ts";
 import type { Adapter } from "./db/types.ts";
+import { type AppEvents, type EventTransport, type Events, type OnDef } from "./events.ts";
 import type { AppDb } from "./route.ts";
 import { type AnySchema, type Infer, type InferInput } from "./schema.ts";
+import type { JobTraceContext, JobTracing } from "./tracing.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;
@@ -30,10 +34,24 @@ export interface JobContext<Input> {
     ai: AI;
     /** Enqueue follow-up jobs. */
     jobs: Jobs;
+    /** Publish events: await events.publish(orderPaid, { orderId }) queues the jobs subscribed with on(event, job). */
+    events: Events;
+    /** The app cache, the same as ctx.cache in routes and app.cache. */
+    cache: Cache;
     /** Job id. */
     id: string;
     /** 1 on the first run, 2 on the first retry, and so on. */
     attempt: number;
+    /**
+     * The tenant the job works for (the tenant of the request or job that queued it, or enqueue's tenantId), or null.
+     * ctx.db is scoped to it, and jobs and events queued from this job keep it.
+     */
+    tenantId: string | null;
+    /**
+     * Write an audit log entry (needs AuditLog in createApp({ models })). Jobs have no signed-in user: pass the
+     * userId of the user who asked for the work, or leave it out for work the system does on its own.
+     */
+    audit: Audit;
 }
 export interface JobDef<Input = any, Output = any> {
     readonly kind: "inferlo.job";
@@ -48,6 +66,11 @@ 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;
+    /**
+     * The tenant the job works for: its ctx.db is scoped to it (tenant-scoped models). Default: the tenant of the
+     * request or job that enqueues it, none from app.jobs. Pass null to queue it without a tenant.
+     */
+    tenantId?: string | null;
 }
 export type JobStatus = "pending" | "running" | "done" | "failed";
 export interface JobRecord {
@@ -64,6 +87,10 @@ export interface JobRecord {
     runAt: Date;
     /** Message of the last failure. */
     lastError?: string;
+    /** With createApp({ tracing }): the trace (W3C traceparent and tracestate) of the request or job that enqueued it, which its runs continue. */
+    trace?: JobTraceContext;
+    /** The tenant the job works for (multi-tenancy): its ctx.db is scoped to it. */
+    tenantId?: string;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -75,8 +102,9 @@ 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.
+     * "redis": in the Redis of createApp({ redis }), shared by every instance.
      */
-    store?: "memory" | "database";
+    store?: "memory" | "database" | "redis";
 }
 /** Where queued jobs are kept. */
 export interface JobStore {
@@ -86,7 +114,7 @@ export interface JobStore {
     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. */
+    /** Record that a running job is still alive (database and Redis stores), so it is not picked up again as stuck. */
     touch?(id: string): Promise<void>;
 }
 export interface RunResult {
@@ -108,14 +136,17 @@ export interface AppJobs extends Jobs {
     /** 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";
+    readonly queue: "memory" | "database" | "redis";
     /** 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. */
+    /**
+     * 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, and with an events transport, the jobs of the events it receives.
+     */
     start(options?: {
         pollMs?: number;
     }): Worker;
@@ -134,13 +165,15 @@ export declare class JobBuilder<I extends AnySchema> {
 /** 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[] | {
+/** Anything that contains jobs: a job, a cron, an event subscription (on), an array, or a module (import * as jobs from "./jobs.ts"). */
+export type JobSource = JobDef | CronDef | OnDef | 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[];
+/** The event subscriptions, on(event, job), in createApp({ jobs }). */
+export declare function collectSubscriptions(sources: readonly JobSource[] | undefined): OnDef[];
 /** 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. */
@@ -156,14 +189,24 @@ export declare const STOPPED_MESSAGE = "The worker stopped while running this jo
 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;
+/**
+ * Pick the job store for createApp({ jobQueue }). Raises IL6011 for an unknown store, IL6012 for "database" without
+ * Postgres. "redis" uses the redis option, a function that returns the Redis store (or throws IL6031 without a client).
+ */
+export declare function jobStoreFor(config: JobQueueConfig | undefined, adapter: Adapter, redis?: () => JobStore): JobStore;
 export interface JobRuntime {
     db: AppDb;
     ai: AI;
+    cache: Cache;
+    /** Builds ctx.audit for one run. */
+    audit(job: {
+        name: string;
+        id: string;
+        tenantId: string | null;
+    }): Audit;
     store: JobStore;
     /** Name of the store, shown as app.jobs.queue. Default "memory". */
-    queue?: "memory" | "database";
+    queue?: "memory" | "database" | "redis";
     /** How often a running job is reported alive to stores that support it. Default HEARTBEAT_MS. */
     heartbeatMs?: number;
     logger: {
@@ -172,10 +215,27 @@ export interface JobRuntime {
     };
     /** Called after each attempt with its outcome and duration (metrics). */
     onRun?(name: string, outcome: keyof RunResult, durationMs: number): void;
+    /** With createApp({ tracing }): a span per attempt that continues the trace the job was enqueued in. */
+    tracing?: JobTracing;
+    /** With createApp({ events: { transport } }): carries published events between services. */
+    eventTransport?: EventTransport;
 }
 /** 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>;
+    /** app.events: publishing queues the jobs subscribed with on(event, job). */
+    readonly events: AppEvents;
 }
-export declare function createJobs(list: readonly JobDef[], runtime: JobRuntime, crons?: readonly CronDef[]): InternalJobs;
+export declare function createJobs(list: readonly JobDef[], runtime: JobRuntime, crons?: readonly CronDef[], subscriptions?: readonly OnDef[]): InternalJobs;
+/**
+ * ctx.jobs and ctx.events for one tenant: jobs and events queued through them carry the tenant unless the call
+ * names another (tenantId) or none (null). Internal: used for requests and jobs with a tenant.
+ */
+export declare function withTenant(base: {
+    jobs: Jobs;
+    events: Events;
+}, tenantId: string): {
+    jobs: Jobs;
+    events: Events;
+};

package/dist/jobs.js

@@ -1,5 +1,7 @@
 import { cronTickId, isCron } from "./cron.js";
+import { checkTenantId } from "./db/table.js";
 import { InferloError } from "./errors.js";
+import { createEvents, isOn } from "./events.js";
 import { ValidationError } from "./schema.js";
 /** Workers started with app.jobs.start() that have not been stopped, so app.close() can stop them. */
 const workers = new WeakMap();
@@ -61,9 +63,14 @@ export function collectJobs(sources) {
 export function collectCrons(sources) {
     return collect(sources).crons;
 }
+/** The event subscriptions, on(event, job), in createApp({ jobs }). */
+export function collectSubscriptions(sources) {
+    return collect(sources).subscriptions;
+}
 function collect(sources) {
     const out = [];
     const crons = [];
+    const subscriptions = [];
     const seen = new Set();
     const visit = (source) => {
         if (!source || typeof source !== "object" || seen.has(source))
@@ -75,11 +82,15 @@ function collect(sources) {
             crons.push(source);
             visit(source.job);
         }
+        else if (isOn(source)) {
+            subscriptions.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))
+                if (isJob(value) || isCron(value) || isOn(value) || Array.isArray(value))
                     visit(value);
     };
     visit(sources);
@@ -89,7 +100,7 @@ function collect(sources) {
             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 };
+    return { jobs: out, crons, subscriptions };
 }
 /** Jobs kept in this process. They are lost when it stops, so use it for development and tests. */
 export function memoryJobStore() {
@@ -125,7 +136,7 @@ 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"`;
+const JOB_COLUMNS = `"id", "name", "input", "status", "attempts", "max_attempts", "run_at", "last_error", "created_at", "updated_at", "traceparent", "tracestate", "tenant_id"`;
 function fromRow(row) {
     const record = {
         id: String(row.id),
@@ -140,6 +151,13 @@ function fromRow(row) {
     };
     if (row.last_error !== null && row.last_error !== undefined)
         record.lastError = String(row.last_error);
+    if (typeof row.traceparent === "string") {
+        record.trace = { traceparent: row.traceparent };
+        if (typeof row.tracestate === "string")
+            record.trace.tracestate = row.tracestate;
+    }
+    if (typeof row.tenant_id === "string")
+        record.tenantId = row.tenant_id;
     return record;
 }
 /**
@@ -161,7 +179,10 @@ export function databaseJobStore(adapter, options = {}) {
             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)`);
+          "last_error" text, "created_at" timestamptz NOT NULL, "updated_at" timestamptz NOT NULL,
+          "traceparent" text, "tracestate" text, "tenant_id" text)`);
+            // Tables created by earlier versions get the trace (Inferlo 0.6) and tenant (0.7) columns.
+            await sql('ALTER TABLE "inferlo_jobs" ADD COLUMN IF NOT EXISTS "traceparent" text, ADD COLUMN IF NOT EXISTS "tracestate" text, ADD COLUMN IF NOT EXISTS "tenant_id" text');
             await sql('CREATE INDEX IF NOT EXISTS "inferlo_jobs_due_idx" ON "inferlo_jobs" ("status", "run_at")');
         }
         catch {
@@ -179,8 +200,8 @@ export function databaseJobStore(adapter, options = {}) {
     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,
+            await sql(`INSERT INTO "inferlo_jobs" (${JOB_COLUMNS}) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13) 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, r.trace?.traceparent ?? null, r.trace?.tracestate ?? null, r.tenantId ?? null,
             ]);
         },
         async claim(now, limit, names) {
@@ -229,16 +250,21 @@ export function databaseJobStore(adapter, options = {}) {
         },
     };
 }
-/** Pick the job store for createApp({ jobQueue }). Raises IL6011 for an unknown store, IL6012 for "database" without Postgres. */
-export function jobStoreFor(config, adapter) {
+/**
+ * Pick the job store for createApp({ jobQueue }). Raises IL6011 for an unknown store, IL6012 for "database" without
+ * Postgres. "redis" uses the redis option, a function that returns the Redis store (or throws IL6031 without a client).
+ */
+export function jobStoreFor(config, adapter, redis) {
     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" }.' });
+    if (store === "redis" && redis)
+        return redis();
+    throw new InferloError("IL6011", `Invalid jobQueue store "${String(store)}".`, { fix: 'Use createApp({ jobQueue: { store: "memory" } }) (the default), { store: "database" } or { store: "redis" } with createApp({ redis }).' });
 }
-export function createJobs(list, runtime, crons = []) {
+export function createJobs(list, runtime, crons = [], subscriptions = []) {
     const byName = new Map(list.map((j) => [j.name, j]));
     const names = list.map((j) => j.name);
     const running = new Set();
@@ -285,9 +311,25 @@ export function createJobs(list, runtime, crons = []) {
             await runtime.store.add(record(c.job, {}, tick, await cronTickId(c, tick)));
         }
     };
+    const events = createEvents(subscriptions, {
+        async enqueue(def, input, id, from, tenantId) {
+            const queued = record(registered(def), input, undefined, id);
+            const trace = from ?? runtime.tracing?.capture();
+            if (runtime.tracing && trace?.traceparent)
+                queued.trace = trace;
+            if (tenantId)
+                queued.tenantId = tenantId;
+            await runtime.store.add(queued);
+            return id;
+        },
+        transport: runtime.eventTransport,
+        capture: runtime.tracing ? () => runtime.tracing.capture() : undefined,
+        logger: runtime.logger,
+    });
     const jobs = {
         list,
         crons,
+        events,
         queueCrons,
         queue: runtime.queue ?? "memory",
         async enqueue(j, input, options = {}) {
@@ -295,7 +337,13 @@ export function createJobs(list, runtime, crons = []) {
             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 tenantId = options.tenantId === undefined || options.tenantId === null ? undefined : checkTenantId(options.tenantId);
             const queued = record(def, input, options.runAt, crypto.randomUUID());
+            const trace = runtime.tracing?.capture();
+            if (trace?.traceparent)
+                queued.trace = trace;
+            if (tenantId)
+                queued.tenantId = tenantId;
             await runtime.store.add(queued);
             return queued;
         },
@@ -325,6 +373,9 @@ export function createJobs(list, runtime, crons = []) {
                             await queueCrons(cronFrom, now);
                             cronFrom = now;
                         }
+                        // Events from other services (createApp({ events: { transport } })) queue their jobs first.
+                        if (events.transport)
+                            await events.receive().catch((error) => runtime.logger.error("event receive error", error));
                         await jobs.runDue();
                     }
                     catch (error) {
@@ -355,22 +406,26 @@ export function createJobs(list, runtime, crons = []) {
     workers.set(jobs, running);
     async function run(record, now) {
         const started = performance.now();
-        const outcome = await attempt(record, now);
+        const outcome = runtime.tracing ? await runtime.tracing.run(record, (fail) => attempt(record, now, fail)) : await attempt(record, now);
         runtime.onRun?.(record.name, outcome, performance.now() - started);
         return outcome;
     }
-    async function attempt(record, now) {
+    async function attempt(record, now, fail) {
         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 });
+            const tenantId = record.tenantId ?? null;
+            const scoped = tenantId ? withTenant({ jobs, events }, tenantId) : { jobs, events };
+            const db = tenantId ? runtime.db.$tenant(tenantId) : runtime.db;
+            await def.handler({ input: parse(def, record.input), db, ai: runtime.ai, jobs: scoped.jobs, events: scoped.events, cache: runtime.cache, id: record.id, attempt: record.attempts, tenantId, audit: runtime.audit({ name: record.name, id: record.id, tenantId }) });
             await runtime.store.update(record.id, { status: "done" });
             return "done";
         }
         catch (error) {
+            fail?.(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)) });
@@ -388,4 +443,14 @@ export function createJobs(list, runtime, crons = []) {
     }
     return jobs;
 }
+/**
+ * ctx.jobs and ctx.events for one tenant: jobs and events queued through them carry the tenant unless the call
+ * names another (tenantId) or none (null). Internal: used for requests and jobs with a tenant.
+ */
+export function withTenant(base, tenantId) {
+    return {
+        jobs: { enqueue: (job, input, options = {}) => base.jobs.enqueue(job, input, { ...options, tenantId: options.tenantId === undefined ? tenantId : options.tenantId }) },
+        events: { publish: (event, payload, options = {}) => base.events.publish(event, payload, { ...options, tenantId: options.tenantId === undefined ? tenantId : options.tenantId }) },
+    };
+}
 //# sourceMappingURL=jobs.js.map