@geekmidas/constructs 10.0.0-alpha.3 → 10.0.0-alpha.30

package/dist/worker.cjs

@@ -1,62 +1,136 @@
-const require_chunk = require('./chunk-DWy1uDak.cjs');
-const require_construct_interface = require('./construct-interface-BfjcOD_E.cjs');
-require('./Construct-CyS3RpTL.cjs');
-const require_functions = require('./functions-Bd3TPxid.cjs');
-require('./clone-Dy0cR2SZ.cjs');
-const require_surfaceEnv = require('./surfaceEnv-BFXEms2f.cjs');
-const require_CronBuilder = require('./CronBuilder-CkXPJiGO.cjs');
-const require_SubscriberBuilder = require('./SubscriberBuilder-4OPehf2R.cjs');
-const __geekmidas_manifest = require_chunk.__toESM(require("@geekmidas/manifest"));
-const __geekmidas_logger_console = require_chunk.__toESM(require("@geekmidas/logger/console"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_construct_interface = require("./construct-interface.cjs");
+const require_functions = require("./functions-DKN6aQWJ.cjs");
+const require_surfaceEnv = require("./surfaceEnv-CNimK76p.cjs");
+const require_CronBuilder = require("./CronBuilder-BbnT7tqo.cjs");
+const require_SubscriberBuilder = require("./SubscriberBuilder-C2bCOuPT.cjs");
+let _geekmidas_manifest = require("@geekmidas/manifest");
+let _geekmidas_logger_console = require("@geekmidas/logger/console");
 //#region src/worker.ts
 var Worker = class Worker {
+	config;
+	dependencies;
 	id;
 	/** Always defined — the worker's own, or the console logger. */
 	logger;
 	/** Always defined, and normally the default. */
 	envParser;
-	constructor(id, config = {}, dependencies = []) {
+	/**
+	* Where this worker's schedules live, when it has crons and a server runs
+	* them. `undefined` until `.database(…)` says.
+	*/
+	scheduleStore;
+	constructor(id, config = {}, dependencies = [], scheduleStore) {
 		this.config = config;
 		this.dependencies = dependencies;
-		const canonical = (0, __geekmidas_manifest.canonicalId)(id);
+		const canonical = (0, _geekmidas_manifest.canonicalId)(id);
 		this.id = canonical;
-		this.logger = config.logger ?? __geekmidas_logger_console.DEFAULT_LOGGER;
+		this.logger = config.logger ?? _geekmidas_logger_console.DEFAULT_LOGGER;
 		this.envParser = require_surfaceEnv.envParserFor(config.envParser ? {
 			id: canonical,
 			envParser: config.envParser
 		} : void 0);
+		this.scheduleStore = scheduleStore;
 	}
 	/**
-	* This worker's cron factory, carrying its logger.
+	* The database this worker keeps its schedules in.
+	*
+	* Only a server target uses it. On AWS a cron is an EventBridge rule
+	* invoking a Lambda and nothing here is consulted — but a server has nothing
+	* firing its crons except itself, and a process that schedules in memory
+	* fires every job once per replica while reporting that all is well.
+	*
+	* So the store is declared rather than discovered. It could have been
+	* inferred — from a database the app happens to declare, or from the events
+	* backend when that backend is pg-boss — and both would work until an app
+	* had two databases, or moved its events to SNS, at which point the
+	* schedules would quietly move or stop. Naming it is one line and cannot
+	* drift.
 	*
-	* `export const c = crons.logger(logger)` written once and hung off the
-	* thing that runs it, so a cron file opens with the schedule rather than
-	* with an import of a logger it has to know the path to.
+	* @example
+	* ```ts
+	* export const jobs = new Worker('Jobs', { logger }).database(database);
+	* ```
 	*/
-	get crons() {
-		return this.own(new require_CronBuilder.CronBuilder().logger(this.logger));
+	database(source) {
+		return new Worker(this.id, this.config, [...this.dependencies, require_construct_interface.edgeTo(source)], source);
 	}
 	/**
-	* This worker's subscriber factory, carrying its logger.
+	* A scheduled runnable.
 	*
-	* Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed
-	* from the publisher's message union, so there is nothing to spell twice.
+	* @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
 	*/
-	get subscribers() {
-		return this.own(new require_SubscriberBuilder.SubscriberBuilder().logger(this.logger));
+	cron(schedule) {
+		return this.own(new require_CronBuilder.CronBuilder().logger(this.logger)).schedule(schedule);
 	}
-	/** This worker's function factory, carrying its logger. */
-	get functions() {
-		return this.own(new require_functions.FunctionBuilder().logger(this.logger));
+	/**
+	* A runnable that consumes a topic.
+	*
+	* Binding is not publishing: a consumer is handed the topic's event types
+	* and no connection string it could publish with. Chain `.publishes(…)` when
+	* the handler emits follow-up events, which is the only reason it would need
+	* one.
+	*
+	* @example `worker.topic(users).subscribe(['user.created']).handle(…)`
+	*/
+	topic(topic) {
+		return this.own(new require_SubscriberBuilder.SubscriberBuilder().logger(this.logger)).topic(topic);
 	}
 	/**
-	* Sugar for the common case, the way `api.get()` is for `api.endpoints`.
+	* A runnable that consumes events typed from a publisher service.
 	*
-	* @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
+	* The older of the two ways to bind a subscriber, kept for a project whose
+	* events come from a hand-written publisher rather than a `Topic`
+	* construct. `topic()` is the one to reach for: it types the events the same
+	* way and hands the consumer no connection string it could publish with.
 	*/
-	cron(schedule) {
-		return this.crons.schedule(schedule);
+	publisher(service) {
+		return this.own(new require_SubscriberBuilder.SubscriberBuilder().logger(this.logger)).publisher(service);
+	}
+	/**
+	* Everything below builds a function — the runnable with no schedule and no
+	* topic, invoked by something else.
+	*
+	* These sit on the worker rather than behind a `functions` namespace because
+	* the namespace was a hop that said nothing: `worker.functions.input(…)`
+	* names a collection to reach one member of it. What kind of runnable is
+	* being built is decided by which of these is called first — a schedule
+	* makes a cron, a topic makes a subscriber, and anything else makes a
+	* function.
+	*/
+	input(schema) {
+		return this.functions.input(schema);
+	}
+	output(schema) {
+		return this.functions.output(schema);
+	}
+	timeout(ms) {
+		return this.functions.timeout(ms);
+	}
+	memorySize(mb) {
+		return this.functions.memorySize(mb);
+	}
+	dependsOn(constructs) {
+		return this.functions.dependsOn(constructs);
+	}
+	services(services) {
+		return this.functions.services(services);
+	}
+	/**
+	* A function with no input schema — the shortest runnable there is.
+	*
+	* @example `worker.handle(async ({ logger }) => { … })`
+	*/
+	handle(...args) {
+		return this.schemalessFunction().handle(...args);
+	}
+	/** The builder `handle` delegates to, named so its type can be referred to. */
+	schemalessFunction() {
+		return this.functions;
+	}
+	/** The function builder the delegating methods above are built on. */
+	get functions() {
+		return this.own(new require_functions.FunctionBuilder().logger(this.logger));
 	}
 	/**
 	* Resources and surfaces this worker calls.
@@ -65,7 +139,7 @@ var Worker = class Worker {
 	* environment and its access, the same distinction `RestApi.calls()` draws.
 	*/
 	calls(constructs) {
-		return new Worker(this.id, this.config, [...this.dependencies, ...constructs.map(require_construct_interface.edgeTo)]);
+		return new Worker(this.id, this.config, [...this.dependencies, ...constructs.map(require_construct_interface.edgeTo)], this.scheduleStore);
 	}
 	/**
 	* Stamps this worker's id onto a builder, so everything built from it says
@@ -73,19 +147,19 @@ var Worker = class Worker {
 	*/
 	own(builder) {
 		builder._owner = this.id;
+		builder._scheduleStore = this.scheduleStore;
 		return builder;
 	}
 	declare() {
 		return [{
 			kind: "worker",
 			id: this.id,
-			...this.config.app ? { app: this.config.app } : {},
 			...this.dependencies.length ? { dependencies: this.dependencies } : {},
 			provides: []
 		}];
 	}
 };
-
 //#endregion
 exports.Worker = Worker;
+
 //# sourceMappingURL=worker.cjs.map

package/dist/worker.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"worker.cjs","names":["id: ConstructName<TName>","config: WorkerConfig","dependencies: readonly Dependency[]","DEFAULT_LOGGER","CronBuilder","SubscriberBuilder","FunctionBuilder","schedule: ScheduleExpression","constructs: readonly Declarable[]","edgeTo","builder: T"],"sources":["../src/worker.ts"],"sourcesContent":["/**\n * A process with no port.\n *\n * `RestApi` is the process that answers HTTP. This is the one that does not —\n * the thing that runs a schedule, drains a queue, consumes a topic. Until it\n * existed, those had nowhere to say they belonged: a cron declared a schedule\n * and nothing else, and which container ran it was decided by the directory the\n * file sat in. A glob owned it.\n *\n * The cost of that shows up in the scaffolds. `gkm init --template worker` —\n * a project that is background jobs and nothing else — declared\n * `new RestApi('Api', { defaultAuthorizer: 'none', logger })`: an HTTP surface\n * with no HTTP on it, written because it was the only construct that made an\n * app exist and the only way to get a logger into the generated runtime.\n *\n * It takes no authorizer, and that is the tell that these are two constructs\n * rather than one with a flag: a `RestApi` needs one because an HTTP surface\n * can ship open by omission, and nothing reaches a worker from outside.\n *\n * @example\n * ```ts\n * // constructs/worker.ts\n * import { Worker } from '@geekmidas/constructs/worker';\n * import { logger } from './logger.js';\n *\n * export const worker = new Worker('Worker', { logger }).calls([database]);\n *\n * // crons/cleanup.ts\n * import { worker } from '@acme/constructs/worker.js';\n *\n * export const cleanup = worker\n *   .cron('rate(1 day)')\n *   .handle(async ({ logger }) => { … });\n * ```\n */\n\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype AppSpec,\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\ttype Dependency,\n} from '@geekmidas/manifest';\nimport { type Declarable, edgeTo } from './construct-interface';\nimport type { ScheduleExpression } from './crons/Cron';\nimport { CronBuilder } from './crons/CronBuilder';\nimport { envParserFor } from './endpoints/surfaceEnv';\nimport { FunctionBuilder } from './functions/FunctionBuilder';\nimport { SubscriberBuilder } from './subscribers/SubscriberBuilder';\n\nexport interface WorkerConfig {\n\t/**\n\t * Where its source lives and how it is run.\n\t *\n\t * Normally omitted, like every other app's: `Worker` means `apps/worker`\n\t * where that directory exists and the project root otherwise. Write one only\n\t * for a layout that genuinely differs.\n\t */\n\tapp?: AppSpec;\n\t/**\n\t * The logger everything built from this worker runs with.\n\t *\n\t * The actual logger, not a path to one — the same reason `RestApi` takes\n\t * one. Every cron and subscriber in a scaffolded project used to open with\n\t * `import { logger } from '…/constructs/logger.js'`, which is the line this\n\t * removes.\n\t */\n\tlogger?: Logger;\n\t/**\n\t * The environment parser everything built from this worker runs with.\n\t *\n\t * Defaults to `process.env` merged with the credentials `gkm dev` injected,\n\t * which is what an application's own `config/env.ts` always was.\n\t */\n\tenvParser?: EnvironmentParser<{}>;\n}\n\nexport class Worker<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\n\t/** Always defined — the worker's own, or the console logger. */\n\treadonly logger: Logger;\n\n\t/** Always defined, and normally the default. */\n\treadonly envParser: EnvironmentParser<{}>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly config: WorkerConfig = {},\n\t\t/** Internal: how `.calls()` carries edges into the copy it returns. */\n\t\tprivate readonly dependencies: readonly Dependency[] = [],\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.logger = config.logger ?? DEFAULT_LOGGER;\n\t\tthis.envParser = envParserFor(\n\t\t\tconfig.envParser\n\t\t\t\t? { id: canonical, envParser: config.envParser }\n\t\t\t\t: undefined,\n\t\t);\n\t}\n\n\t/**\n\t * This worker's cron factory, carrying its logger.\n\t *\n\t * `export const c = crons.logger(logger)` written once and hung off the\n\t * thing that runs it, so a cron file opens with the schedule rather than\n\t * with an import of a logger it has to know the path to.\n\t */\n\tget crons() {\n\t\treturn this.own(new CronBuilder().logger(this.logger));\n\t}\n\n\t/**\n\t * This worker's subscriber factory, carrying its logger.\n\t *\n\t * Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed\n\t * from the publisher's message union, so there is nothing to spell twice.\n\t */\n\tget subscribers() {\n\t\treturn this.own(new SubscriberBuilder().logger(this.logger));\n\t}\n\n\t/** This worker's function factory, carrying its logger. */\n\tget functions() {\n\t\treturn this.own(new FunctionBuilder().logger(this.logger));\n\t}\n\n\t/**\n\t * Sugar for the common case, the way `api.get()` is for `api.endpoints`.\n\t *\n\t * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`\n\t */\n\tcron(schedule: ScheduleExpression) {\n\t\treturn this.crons.schedule(schedule);\n\t}\n\n\t/**\n\t * Resources and surfaces this worker calls.\n\t *\n\t * Not `.dependsOn()`: this records the edge that derives the worker's\n\t * environment and its access, the same distinction `RestApi.calls()` draws.\n\t */\n\tcalls(constructs: readonly Declarable[]): Worker<TName> {\n\t\treturn new Worker<TName>(this.id as ConstructName<TName>, this.config, [\n\t\t\t...this.dependencies,\n\t\t\t...constructs.map(edgeTo),\n\t\t]);\n\t}\n\n\t/**\n\t * Stamps this worker's id onto a builder, so everything built from it says\n\t * which process runs it.\n\t */\n\tprivate own<T extends { _owner?: string }>(builder: T): T {\n\t\tbuilder._owner = this.id;\n\n\t\treturn builder;\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'worker',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.config.app ? { app: this.config.app } : {}),\n\t\t\t\t...(this.dependencies.length\n\t\t\t\t\t? { dependencies: this.dependencies }\n\t\t\t\t\t: {}),\n\t\t\t\t// Nothing calls a worker, so it publishes no address.\n\t\t\t\tprovides: [],\n\t\t\t},\n\t\t];\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAgFA,IAAa,SAAb,MAAa,OAEb;CACC,AAAS;;CAGT,AAAS;;CAGT,AAAS;CAET,YACCA,IACiBC,SAAuB,CAAE,GAEzBC,eAAsC,CAAE,GACxD;EAHgB;EAEA;EAEjB,MAAM,YAAY,sCAAY,GAAa;AAE3C,OAAK,KAAK;AACV,OAAK,SAAS,OAAO,UAAUC;AAC/B,OAAK,YAAY,gCAChB,OAAO,YACJ;GAAE,IAAI;GAAW,WAAW,OAAO;EAAW,WAEjD;CACD;;;;;;;;CASD,IAAI,QAAQ;AACX,SAAO,KAAK,IAAI,IAAIC,kCAAc,OAAO,KAAK,OAAO,CAAC;CACtD;;;;;;;CAQD,IAAI,cAAc;AACjB,SAAO,KAAK,IAAI,IAAIC,8CAAoB,OAAO,KAAK,OAAO,CAAC;CAC5D;;CAGD,IAAI,YAAY;AACf,SAAO,KAAK,IAAI,IAAIC,oCAAkB,OAAO,KAAK,OAAO,CAAC;CAC1D;;;;;;CAOD,KAAKC,UAA8B;AAClC,SAAO,KAAK,MAAM,SAAS,SAAS;CACpC;;;;;;;CAQD,MAAMC,YAAkD;AACvD,SAAO,IAAI,OAAc,KAAK,IAA4B,KAAK,QAAQ,CACtE,GAAG,KAAK,cACR,GAAG,WAAW,IAAIC,mCAAO,AACzB;CACD;;;;;CAMD,AAAQ,IAAmCC,SAAe;AACzD,UAAQ,SAAS,KAAK;AAEtB,SAAO;CACP;CAED,UAAyB;AACxB,SAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,OAAO,MAAM,EAAE,KAAK,KAAK,OAAO,IAAK,IAAG,CAAE;GACnD,GAAI,KAAK,aAAa,SACnB,EAAE,cAAc,KAAK,aAAc,IACnC,CAAE;GAEL,UAAU,CAAE;EACZ,CACD;CACD;AACD"}
+{"version":3,"file":"worker.cjs","names":["canonicalId","DEFAULT_LOGGER","envParserFor","edgeTo","CronBuilder","SubscriberBuilder","FunctionBuilder"],"sources":["../src/worker.ts"],"sourcesContent":["/**\n * A process with no port.\n *\n * `RestApi` is the process that answers HTTP. This is the one that does not —\n * the thing that runs a schedule, drains a queue, consumes a topic. Until it\n * existed, those had nowhere to say they belonged: a cron declared a schedule\n * and nothing else, and which container ran it was decided by the directory the\n * file sat in. A glob owned it.\n *\n * The cost of that shows up in the scaffolds. `gkm init --template worker` —\n * a project that is background jobs and nothing else — declared\n * `new RestApi('Api', { defaultAuthorizer: 'none', logger })`: an HTTP surface\n * with no HTTP on it, written because it was the only construct that made an\n * app exist and the only way to get a logger into the generated runtime.\n *\n * It takes no authorizer, and that is the tell that these are two constructs\n * rather than one with a flag: a `RestApi` needs one because an HTTP surface\n * can ship open by omission, and nothing reaches a worker from outside.\n *\n * ## Crons on a server target need a database\n *\n * A cron becomes an EventBridge rule on AWS and nothing here is consulted. A\n * server has nothing firing its crons but itself, and a process that schedules\n * in memory fires every job once per replica while reporting success — so the\n * schedule is kept in Postgres, and the worker says which one with\n * `.database(db)`.\n *\n * A worker with crons and no `.database(…)` schedules nothing on a server\n * target and says so at startup. That is a limitation of workers today rather\n * than a design: the store could be a cache, or something the target\n * provisions, and Postgres is what exists.\n *\n * It is not an app. A worker names the process that runs its crons and\n * subscribers, and that process is the app's server — the same one the\n * endpoints run in, minus the HTTP surface. Giving a worker a container of its\n * own made a second thing to build, deploy and keep alive for work that was\n * always going to run somewhere already. Declare as many as the shape of the\n * work wants: they are groupings, not deployments.\n *\n * @example\n * ```ts\n * // constructs/worker.ts\n * import { Worker } from '@geekmidas/constructs/worker';\n * import { logger } from './logger.js';\n *\n * export const worker = new Worker('Worker', { logger }).calls([database]);\n *\n * // crons/cleanup.ts\n * import { worker } from '@acme/constructs/worker.js';\n *\n * export const cleanup = worker\n *   .cron('rate(1 day)')\n *   .handle(async ({ logger }) => { … });\n * ```\n */\n\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\ttype Dependency,\n} from '@geekmidas/manifest';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport {\n\ttype Consumable,\n\ttype Declarable,\n\tedgeTo,\n} from './construct-interface';\nimport type { ScheduleExpression } from './crons/Cron';\nimport { CronBuilder } from './crons/CronBuilder';\nimport { envParserFor } from './endpoints/surfaceEnv';\nimport { FunctionBuilder } from './functions/FunctionBuilder';\nimport { SubscriberBuilder } from './subscribers/SubscriberBuilder';\nimport type { Topic, TopicEvents } from './topic/Topic';\n\nexport interface WorkerConfig {\n\t/**\n\t * The logger everything built from this worker runs with.\n\t *\n\t * The actual logger, not a path to one — the same reason `RestApi` takes\n\t * one. Every cron and subscriber in a scaffolded project used to open with\n\t * `import { logger } from '…/constructs/logger.js'`, which is the line this\n\t * removes.\n\t */\n\tlogger?: Logger;\n\t/**\n\t * The environment parser everything built from this worker runs with.\n\t *\n\t * Defaults to `process.env` merged with the credentials `gkm dev` injected,\n\t * which is what an application's own `config/env.ts` always was.\n\t */\n\tenvParser?: EnvironmentParser<{}>;\n}\n\nexport class Worker<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\n\t/** Always defined — the worker's own, or the console logger. */\n\treadonly logger: Logger;\n\n\t/** Always defined, and normally the default. */\n\treadonly envParser: EnvironmentParser<{}>;\n\n\t/**\n\t * Where this worker's schedules live, when it has crons and a server runs\n\t * them. `undefined` until `.database(…)` says.\n\t */\n\treadonly scheduleStore?: Consumable<string, unknown>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly config: WorkerConfig = {},\n\t\t/** Internal: how `.calls()` carries edges into the copy it returns. */\n\t\tprivate readonly dependencies: readonly Dependency[] = [],\n\t\tscheduleStore?: Consumable<string, unknown>,\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.logger = config.logger ?? DEFAULT_LOGGER;\n\t\tthis.envParser = envParserFor(\n\t\t\tconfig.envParser\n\t\t\t\t? { id: canonical, envParser: config.envParser }\n\t\t\t\t: undefined,\n\t\t);\n\t\tthis.scheduleStore = scheduleStore;\n\t}\n\n\t/**\n\t * The database this worker keeps its schedules in.\n\t *\n\t * Only a server target uses it. On AWS a cron is an EventBridge rule\n\t * invoking a Lambda and nothing here is consulted — but a server has nothing\n\t * firing its crons except itself, and a process that schedules in memory\n\t * fires every job once per replica while reporting that all is well.\n\t *\n\t * So the store is declared rather than discovered. It could have been\n\t * inferred — from a database the app happens to declare, or from the events\n\t * backend when that backend is pg-boss — and both would work until an app\n\t * had two databases, or moved its events to SNS, at which point the\n\t * schedules would quietly move or stop. Naming it is one line and cannot\n\t * drift.\n\t *\n\t * @example\n\t * ```ts\n\t * export const jobs = new Worker('Jobs', { logger }).database(database);\n\t * ```\n\t */\n\tdatabase<T, TDbName extends string>(\n\t\tsource: Consumable<TDbName, T>,\n\t): Worker<TName> {\n\t\treturn new Worker<TName>(\n\t\t\tthis.id as ConstructName<TName>,\n\t\t\tthis.config,\n\t\t\t[...this.dependencies, edgeTo(source)],\n\t\t\tsource as unknown as Consumable<string, unknown>,\n\t\t);\n\t}\n\n\t/**\n\t * A scheduled runnable.\n\t *\n\t * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`\n\t */\n\tcron(schedule: ScheduleExpression) {\n\t\treturn this.own(new CronBuilder().logger(this.logger)).schedule(schedule);\n\t}\n\n\t/**\n\t * A runnable that consumes a topic.\n\t *\n\t * Binding is not publishing: a consumer is handed the topic's event types\n\t * and no connection string it could publish with. Chain `.publishes(…)` when\n\t * the handler emits follow-up events, which is the only reason it would need\n\t * one.\n\t *\n\t * @example `worker.topic(users).subscribe(['user.created']).handle(…)`\n\t */\n\ttopic<TTopicName extends string, TEvents extends TopicEvents>(\n\t\ttopic: Topic<TTopicName, TEvents>,\n\t) {\n\t\treturn this.own(new SubscriberBuilder().logger(this.logger)).topic(topic);\n\t}\n\n\t/**\n\t * A runnable that consumes events typed from a publisher service.\n\t *\n\t * The older of the two ways to bind a subscriber, kept for a project whose\n\t * events come from a hand-written publisher rather than a `Topic`\n\t * construct. `topic()` is the one to reach for: it types the events the same\n\t * way and hands the consumer no connection string it could publish with.\n\t */\n\tpublisher<T extends EventPublisher<any>, TPubName extends string>(\n\t\tservice: Service<TPubName, T> | Consumable<TPubName, T>,\n\t) {\n\t\treturn this.own(new SubscriberBuilder().logger(this.logger)).publisher(\n\t\t\tservice as never,\n\t\t);\n\t}\n\n\t/**\n\t * Everything below builds a function — the runnable with no schedule and no\n\t * topic, invoked by something else.\n\t *\n\t * These sit on the worker rather than behind a `functions` namespace because\n\t * the namespace was a hop that said nothing: `worker.functions.input(…)`\n\t * names a collection to reach one member of it. What kind of runnable is\n\t * being built is decided by which of these is called first — a schedule\n\t * makes a cron, a topic makes a subscriber, and anything else makes a\n\t * function.\n\t */\n\tinput<T extends ComposableStandardSchema>(schema: T) {\n\t\treturn this.functions.input(schema);\n\t}\n\n\toutput<T extends StandardSchemaV1>(schema: T) {\n\t\treturn this.functions.output(schema);\n\t}\n\n\ttimeout(ms: number) {\n\t\treturn this.functions.timeout(ms);\n\t}\n\n\tmemorySize(mb: number) {\n\t\treturn this.functions.memorySize(mb);\n\t}\n\n\tdependsOn<const T extends readonly Consumable[]>(constructs: T) {\n\t\treturn this.functions.dependsOn(constructs);\n\t}\n\n\tservices<T extends Service[]>(services: T) {\n\t\treturn this.functions.services(services);\n\t}\n\n\t/**\n\t * A function with no input schema — the shortest runnable there is.\n\t *\n\t * @example `worker.handle(async ({ logger }) => { … })`\n\t */\n\thandle(\n\t\t...args: Parameters<\n\t\t\tReturnType<Worker<TName>['schemalessFunction']>['handle']\n\t\t>\n\t) {\n\t\treturn this.schemalessFunction().handle(...args);\n\t}\n\n\t/** The builder `handle` delegates to, named so its type can be referred to. */\n\tprivate schemalessFunction() {\n\t\treturn this.functions;\n\t}\n\n\t/** The function builder the delegating methods above are built on. */\n\tprivate get functions() {\n\t\treturn this.own(new FunctionBuilder().logger(this.logger));\n\t}\n\n\t/**\n\t * Resources and surfaces this worker calls.\n\t *\n\t * Not `.dependsOn()`: this records the edge that derives the worker's\n\t * environment and its access, the same distinction `RestApi.calls()` draws.\n\t */\n\tcalls(constructs: readonly Declarable[]): Worker<TName> {\n\t\treturn new Worker<TName>(\n\t\t\tthis.id as ConstructName<TName>,\n\t\t\tthis.config,\n\t\t\t[...this.dependencies, ...constructs.map(edgeTo)],\n\t\t\tthis.scheduleStore,\n\t\t);\n\t}\n\n\t/**\n\t * Stamps this worker's id onto a builder, so everything built from it says\n\t * which process runs it.\n\t */\n\tprivate own<T extends { _owner?: string; _scheduleStore?: unknown }>(\n\t\tbuilder: T,\n\t): T {\n\t\tbuilder._owner = this.id;\n\t\tbuilder._scheduleStore = this.scheduleStore;\n\n\t\treturn builder;\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'worker',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.dependencies.length\n\t\t\t\t\t? { dependencies: this.dependencies }\n\t\t\t\t\t: {}),\n\t\t\t\t// Nothing calls a worker, so it publishes no address.\n\t\t\t\tprovides: [],\n\t\t\t},\n\t\t];\n\t}\n}\n"],"mappings":";;;;;;;;;AAoGA,IAAa,SAAb,MAAa,OAEb;CAiBmB;CAEA;CAlBlB;;CAGA;;CAGA;;;;;CAMA;CAEA,YACC,IACA,SAAwC,CAAC,GAEzC,eAAuD,CAAC,GACxD,eACC;EAJgB,KAAA,SAAA;EAEA,KAAA,eAAA;EAGjB,MAAM,aAAA,GAAYA,oBAAAA,YAAAA,CAAY,EAAY;EAE1C,KAAK,KAAK;EACV,KAAK,SAAS,OAAO,UAAUC,0BAAAA;EAC/B,KAAK,YAAYC,mBAAAA,aAChB,OAAO,YACJ;GAAE,IAAI;GAAW,WAAW,OAAO;EAAU,IAC7C,KAAA,CACJ;EACA,KAAK,gBAAgB;CACtB;;;;;;;;;;;;;;;;;;;;;CAsBA,SACC,QACgB;EAChB,OAAO,IAAI,OACV,KAAK,IACL,KAAK,QACL,CAAC,GAAG,KAAK,cAAcC,4BAAAA,OAAO,MAAM,CAAC,GACrC,MACD;CACD;;;;;;CAOA,KAAK,UAA8B;EAClC,OAAO,KAAK,IAAI,IAAIC,oBAAAA,YAAY,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,QAAQ;CACzE;;;;;;;;;;;CAYA,MACC,OACC;EACD,OAAO,KAAK,IAAI,IAAIC,0BAAAA,kBAAkB,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK;CACzE;;;;;;;;;CAUA,UACC,SACC;EACD,OAAO,KAAK,IAAI,IAAIA,0BAAAA,kBAAkB,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,UAC5D,OACD;CACD;;;;;;;;;;;;CAaA,MAA0C,QAAW;EACpD,OAAO,KAAK,UAAU,MAAM,MAAM;CACnC;CAEA,OAAmC,QAAW;EAC7C,OAAO,KAAK,UAAU,OAAO,MAAM;CACpC;CAEA,QAAQ,IAAY;EACnB,OAAO,KAAK,UAAU,QAAQ,EAAE;CACjC;CAEA,WAAW,IAAY;EACtB,OAAO,KAAK,UAAU,WAAW,EAAE;CACpC;CAEA,UAAiD,YAAe;EAC/D,OAAO,KAAK,UAAU,UAAU,UAAU;CAC3C;CAEA,SAA8B,UAAa;EAC1C,OAAO,KAAK,UAAU,SAAS,QAAQ;CACxC;;;;;;CAOA,OACC,GAAG,MAGF;EACD,OAAO,KAAK,mBAAmB,CAAC,CAAC,OAAO,GAAG,IAAI;CAChD;;CAGA,qBAA6B;EAC5B,OAAO,KAAK;CACb;;CAGA,IAAY,YAAY;EACvB,OAAO,KAAK,IAAI,IAAIC,kBAAAA,gBAAgB,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC;CAC1D;;;;;;;CAQA,MAAM,YAAkD;EACvD,OAAO,IAAI,OACV,KAAK,IACL,KAAK,QACL,CAAC,GAAG,KAAK,cAAc,GAAG,WAAW,IAAIH,4BAAAA,MAAM,CAAC,GAChD,KAAK,aACN;CACD;;;;;CAMA,IACC,SACI;EACJ,QAAQ,SAAS,KAAK;EACtB,QAAQ,iBAAiB,KAAK;EAE9B,OAAO;CACR;CAEA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,aAAa,SACnB,EAAE,cAAc,KAAK,aAAa,IAClC,CAAC;GAEJ,UAAU,CAAC;EACZ,CACD;CACD;AACD"}

package/dist/worker.d.cts

@@ -1,29 +1,19 @@
-import "./Construct-C0ijr2qp.cjs";
-import { FunctionBuilder } from "./index-JSf9xNIJ.cjs";
-import { Declarable } from "./construct-interface-D9d4Gm4p.cjs";
-import { ScheduleExpression } from "./Cron-Wqh464aO.cjs";
-import "./Subscriber-2mEi0ImH.cjs";
-import { CronBuilder } from "./CronBuilder-BqpEzMPQ.cjs";
-import "./Topic-19QeHBIR.cjs";
-import { SubscriberBuilder } from "./SubscriberBuilder-waNhzjSM.cjs";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
+import { a as FunctionHandler, r as Function, t as FunctionBuilder } from "./index-BI23K3wy.cjs";
+import { c as ServicesOf, i as Declarable, r as Consumable } from "./construct-interface-DPusCUSQ.cjs";
+import { i as ScheduleExpression } from "./Cron-CA2oa2nC.cjs";
+import { t as CronBuilder } from "./CronBuilder-B_KqaodP.cjs";
+import { n as TopicEvents, r as TopicMessage, t as Topic } from "./Topic-D6blllEn.cjs";
+import { t as SubscriberBuilder } from "./SubscriberBuilder-CjDGSTZc.cjs";
+import "./index-tE_119SX.cjs";
 import { EnvironmentParser } from "@geekmidas/envkit";
+import { EventPublisher } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
-import * as _geekmidas_schema12 from "@geekmidas/schema";
-import * as _geekmidas_services13 from "@geekmidas/services";
-import * as _geekmidas_audit15 from "@geekmidas/audit";
-import { AppSpec, ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
-
+import { ComposableStandardSchema } from "@geekmidas/schema";
+import { Service } from "@geekmidas/services";
+import { ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
 //#region src/worker.d.ts
-
-interface WorkerConfig {
-  /**
-   * Where its source lives and how it is run.
-   *
-   * Normally omitted, like every other app's: `Worker` means `apps/worker`
-   * where that directory exists and the project root otherwise. Write one only
-   * for a layout that genuinely differs.
-   */
-  app?: AppSpec;
+export interface WorkerConfig {
   /**
    * The logger everything built from this worker runs with.
    *
@@ -41,7 +31,7 @@ interface WorkerConfig {
    */
   envParser?: EnvironmentParser<{}>;
 }
-declare class Worker<TName extends string = string> implements Declarable<TName> {
+export declare class Worker<TName extends string = string> implements Declarable<TName> {
   private readonly config;
   /** Internal: how `.calls()` carries edges into the copy it returns. */
   private readonly dependencies;
@@ -50,31 +40,88 @@ declare class Worker<TName extends string = string> implements Declarable<TName>
   readonly logger: Logger;
   /** Always defined, and normally the default. */
   readonly envParser: EnvironmentParser<{}>;
-  constructor(id: ConstructName<TName>, config?: WorkerConfig, /** Internal: how `.calls()` carries edges into the copy it returns. */
-  dependencies?: readonly Dependency[]);
   /**
-   * This worker's cron factory, carrying its logger.
-   *
-   * `export const c = crons.logger(logger)` written once and hung off the
-   * thing that runs it, so a cron file opens with the schedule rather than
-   * with an import of a logger it has to know the path to.
+   * Where this worker's schedules live, when it has crons and a server runs
+   * them. `undefined` until `.database(…)` says.
    */
-  get crons(): CronBuilder<_geekmidas_schema12.ComposableStandardSchema, _geekmidas_services13.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  readonly scheduleStore?: Consumable<string, unknown>;
+  constructor(id: ConstructName<TName>, config?: WorkerConfig,
+  /** Internal: how `.calls()` carries edges into the copy it returns. */
+  dependencies?: readonly Dependency[], scheduleStore?: Consumable<string, unknown>);
   /**
-   * This worker's subscriber factory, carrying its logger.
+   * The database this worker keeps its schedules in.
    *
-   * Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed
-   * from the publisher's message union, so there is nothing to spell twice.
+   * Only a server target uses it. On AWS a cron is an EventBridge rule
+   * invoking a Lambda and nothing here is consulted — but a server has nothing
+   * firing its crons except itself, and a process that schedules in memory
+   * fires every job once per replica while reporting that all is well.
+   *
+   * So the store is declared rather than discovered. It could have been
+   * inferred — from a database the app happens to declare, or from the events
+   * backend when that backend is pg-boss — and both would work until an app
+   * had two databases, or moved its events to SNS, at which point the
+   * schedules would quietly move or stop. Naming it is one line and cannot
+   * drift.
+   *
+   * @example
+   * ```ts
+   * export const jobs = new Worker('Jobs', { logger }).database(database);
+   * ```
    */
-  get subscribers(): SubscriberBuilder<[], Logger, undefined, undefined, string, []>;
-  /** This worker's function factory, carrying its logger. */
-  get functions(): FunctionBuilder<_geekmidas_schema12.ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, _geekmidas_audit15.AuditableAction<string, unknown>>;
+  database<T, TDbName extends string>(source: Consumable<TDbName, T>): Worker<TName>;
   /**
-   * Sugar for the common case, the way `api.get()` is for `api.endpoints`.
+   * A scheduled runnable.
    *
    * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
    */
-  cron(schedule: ScheduleExpression): CronBuilder<_geekmidas_schema12.ComposableStandardSchema, _geekmidas_services13.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  cron(schedule: ScheduleExpression): CronBuilder<ComposableStandardSchema, Service[], Logger, undefined, undefined, string, undefined, string>;
+  /**
+   * A runnable that consumes a topic.
+   *
+   * Binding is not publishing: a consumer is handed the topic's event types
+   * and no connection string it could publish with. Chain `.publishes(…)` when
+   * the handler emits follow-up events, which is the only reason it would need
+   * one.
+   *
+   * @example `worker.topic(users).subscribe(['user.created']).handle(…)`
+   */
+  topic<TTopicName extends string, TEvents extends TopicEvents>(topic: Topic<TTopicName, TEvents>): SubscriberBuilder<[], Logger, undefined, EventPublisher<TopicMessage<TEvents_1>>, string, []>;
+  /**
+   * A runnable that consumes events typed from a publisher service.
+   *
+   * The older of the two ways to bind a subscriber, kept for a project whose
+   * events come from a hand-written publisher rather than a `Topic`
+   * construct. `topic()` is the one to reach for: it types the events the same
+   * way and hands the consumer no connection string it could publish with.
+   */
+  publisher<T extends EventPublisher<any>, TPubName extends string>(service: Service<TPubName, T> | Consumable<TPubName, T>): SubscriberBuilder<[], Logger, undefined, EventPublisher<any>, string, []>;
+  /**
+   * Everything below builds a function — the runnable with no schedule and no
+   * topic, invoked by something else.
+   *
+   * These sit on the worker rather than behind a `functions` namespace because
+   * the namespace was a hop that said nothing: `worker.functions.input(…)`
+   * names a collection to reach one member of it. What kind of runnable is
+   * being built is decided by which of these is called first — a schedule
+   * makes a cron, a topic makes a subscriber, and anything else makes a
+   * function.
+   */
+  input<T extends ComposableStandardSchema>(schema: T): FunctionBuilder<T, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  output<T extends StandardSchemaV1>(schema: T): FunctionBuilder<ComposableStandardSchema, T, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  timeout(ms: number): FunctionBuilder<ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  memorySize(mb: number): FunctionBuilder<ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): FunctionBuilder<ComposableStandardSchema, undefined, [...ServicesOf<T>], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  services<T extends Service[]>(services: T): FunctionBuilder<ComposableStandardSchema, undefined, [...T], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  /**
+   * A function with no input schema — the shortest runnable there is.
+   *
+   * @example `worker.handle(async ({ logger }) => { … })`
+   */
+  handle(...args: Parameters<ReturnType<Worker<TName>['schemalessFunction']>['handle']>): Function<ComposableStandardSchema, [], Logger, undefined, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>, FunctionHandler<ComposableStandardSchema, [], Logger, undefined, undefined, undefined, AuditableAction<string, unknown>>>;
+  /** The builder `handle` delegates to, named so its type can be referred to. */
+  private schemalessFunction;
+  /** The function builder the delegating methods above are built on. */
+  private get functions();
   /**
    * Resources and surfaces this worker calls.
    *
@@ -89,7 +136,5 @@ declare class Worker<TName extends string = string> implements Declarable<TName>
   private own;
   declare(): Declaration[];
 }
-//# sourceMappingURL=worker.d.ts.map
 //#endregion
-export { Worker, WorkerConfig };
 //# sourceMappingURL=worker.d.cts.map

package/dist/worker.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.cts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AA2IkC,UAtFjB,YAAA,CAsFiB;EAAA;;;;;;;EA2BX,GArFX,CAAA,EApBL,OAoBK;EAAU;;;;;;;;WAXZ;;;;;;;cAOG;;cAGA,iDACD,WAAW;;;;eAET;;mBAGI;;sBAGG;kBAGf,cAAc,iBACO;0BAEe;;;;;;;;eAoBhC,YApB0C,mBAAA,CAoB1C,wBAAA,EAAA,qBAAA,CAAA,4BAAA;;;;;;;qBAUM,sBAAA;;mBAKF,gBALE,mBAAA,CAKF,wBAAA,iBAAA,iEAAA,kBAAA,CAAA;;;;;;iBASE,qBAAkB,YAAA,mBAAA,CAAA,wBAAA,EAAA,qBAAA,CAAA,4BAAA;;;;;;;6BAUN,eAAe,OAAO;;;;;;aAiBtC"}
+{"version":3,"file":"worker.d.cts","names":["_$__topic0.TopicMessage","_$__construct_interface0.ServicesOf","_$__functions0.FunctionHandler","_$__functions0.Function"],"sources":["../src/worker.ts"],"mappings":";;;;;;;;;;;;;;;iBAiFiB;;;;;;;;;EAShB,SAAS;;;;;;;EAOT,YAAY;;qBAGA,OAAO,0CACR,WAAW;mBAkBJ;;mBAEA;WAlBT,IAAI;;WAGJ,QAAQ;;WAGR,WAAW;;;;;WAMX,gBAAgB;EAEzB,YACC,IAAI,cAAc,QACD,SAAQ,cAER;;EAAA,wBAAuB,cACxC,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAkCjB,SAAS,GAAG,wBACX,QAAQ,WAAW,SAAS,KAC1B,OAAO;;;;;;EAcV,KAAK,UAAU,qBAAkB,YAAA,0BAAA,WAAA;;;;;;;;;;;EAcjC,MAAM,2BAA2B,gBAAgB,aAChD,OAAO,MAAM,YAAY,WAAQ,sBAAA,mBAAA,eAAAA,aAAA;;;;;;;;;EAalC,UAAU,UAAU,qBAAqB,yBACxC,SAAS,QAAQ,UAAU,KAAK,WAAW,UAAU,KAAE,sBAAA,mBAAA;;;;;;;;;;;;EAkBxD,MAAM,UAAU,0BAA0B,QAAQ,IAAC,gBAAA,kBAAA,iEAAA;EAInD,OAAO,UAAU,kBAAkB,QAAQ,IAAC,gBAAA,0BAAA,OAAA,iEAAA;EAI5C,QAAQ,aAAU,gBAAA,yCAAA,iEAAA;EAIlB,WAAW,aAAU,gBAAA,yCAAA,iEAAA;EAIrB,gBAAgB,mBAAmB,cAAc,YAAY,IAAC,gBAAA,yCAAAC,WAAA,KAAA,iEAAA;EAI9D,SAAS,UAAU,WAAW,UAAU,IAAC,gBAAA,yCAAA,IAAA,iEAAA;;;;;;EASzC,UACI,MAAM,WACR,WAAW,OAAO,2CAClBE,SAAA,8BAAA,4EAAA,kCAAAD,gBAAA,8BAAA,yCAAA;;UAMM;;cAKI;;;;;;;EAUZ,MAAM,qBAAqB,eAAe,OAAO;;;;;UAazC;EASR,WAAW"}

package/dist/worker.d.mts

@@ -1,29 +1,19 @@
-import "./Construct-Ct8nalEi.mjs";
-import { FunctionBuilder } from "./index-CubPzHd9.mjs";
-import { Declarable } from "./construct-interface-g5GM5pwR.mjs";
-import { ScheduleExpression } from "./Cron-ByxdOfpE.mjs";
-import "./Subscriber-xTJ9ayPN.mjs";
-import { CronBuilder } from "./CronBuilder-BL0AP6fs.mjs";
-import "./Topic-DuFeqkBh.mjs";
-import { SubscriberBuilder } from "./SubscriberBuilder-Dptmo-1A.mjs";
-import { AppSpec, ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
+import { a as FunctionHandler, r as Function, t as FunctionBuilder } from "./index-yb3fXNyH.mjs";
+import { c as ServicesOf, i as Declarable, r as Consumable } from "./construct-interface-D2gesxos.mjs";
+import { i as ScheduleExpression } from "./Cron-B_iuyNxr.mjs";
+import { t as CronBuilder } from "./CronBuilder-BIKCLWu7.mjs";
+import { n as TopicEvents, r as TopicMessage, t as Topic } from "./Topic-DVvheJ_-.mjs";
+import { t as SubscriberBuilder } from "./SubscriberBuilder-C2FRfd26.mjs";
+import "./index-fnpjXiA-.mjs";
+import { ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
 import { EnvironmentParser } from "@geekmidas/envkit";
-import * as _geekmidas_services1 from "@geekmidas/services";
-import * as _geekmidas_audit3 from "@geekmidas/audit";
+import { EventPublisher } from "@geekmidas/events";
+import { Service } from "@geekmidas/services";
 import { Logger } from "@geekmidas/logger";
-import * as _geekmidas_schema0 from "@geekmidas/schema";
-
+import { ComposableStandardSchema } from "@geekmidas/schema";
 //#region src/worker.d.ts
-
-interface WorkerConfig {
-  /**
-   * Where its source lives and how it is run.
-   *
-   * Normally omitted, like every other app's: `Worker` means `apps/worker`
-   * where that directory exists and the project root otherwise. Write one only
-   * for a layout that genuinely differs.
-   */
-  app?: AppSpec;
+export interface WorkerConfig {
   /**
    * The logger everything built from this worker runs with.
    *
@@ -41,7 +31,7 @@ interface WorkerConfig {
    */
   envParser?: EnvironmentParser<{}>;
 }
-declare class Worker<TName extends string = string> implements Declarable<TName> {
+export declare class Worker<TName extends string = string> implements Declarable<TName> {
   private readonly config;
   /** Internal: how `.calls()` carries edges into the copy it returns. */
   private readonly dependencies;
@@ -50,31 +40,88 @@ declare class Worker<TName extends string = string> implements Declarable<TName>
   readonly logger: Logger;
   /** Always defined, and normally the default. */
   readonly envParser: EnvironmentParser<{}>;
-  constructor(id: ConstructName<TName>, config?: WorkerConfig, /** Internal: how `.calls()` carries edges into the copy it returns. */
-  dependencies?: readonly Dependency[]);
   /**
-   * This worker's cron factory, carrying its logger.
-   *
-   * `export const c = crons.logger(logger)` written once and hung off the
-   * thing that runs it, so a cron file opens with the schedule rather than
-   * with an import of a logger it has to know the path to.
+   * Where this worker's schedules live, when it has crons and a server runs
+   * them. `undefined` until `.database(…)` says.
    */
-  get crons(): CronBuilder<_geekmidas_schema0.ComposableStandardSchema, _geekmidas_services1.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  readonly scheduleStore?: Consumable<string, unknown>;
+  constructor(id: ConstructName<TName>, config?: WorkerConfig,
+  /** Internal: how `.calls()` carries edges into the copy it returns. */
+  dependencies?: readonly Dependency[], scheduleStore?: Consumable<string, unknown>);
   /**
-   * This worker's subscriber factory, carrying its logger.
+   * The database this worker keeps its schedules in.
    *
-   * Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed
-   * from the publisher's message union, so there is nothing to spell twice.
+   * Only a server target uses it. On AWS a cron is an EventBridge rule
+   * invoking a Lambda and nothing here is consulted — but a server has nothing
+   * firing its crons except itself, and a process that schedules in memory
+   * fires every job once per replica while reporting that all is well.
+   *
+   * So the store is declared rather than discovered. It could have been
+   * inferred — from a database the app happens to declare, or from the events
+   * backend when that backend is pg-boss — and both would work until an app
+   * had two databases, or moved its events to SNS, at which point the
+   * schedules would quietly move or stop. Naming it is one line and cannot
+   * drift.
+   *
+   * @example
+   * ```ts
+   * export const jobs = new Worker('Jobs', { logger }).database(database);
+   * ```
    */
-  get subscribers(): SubscriberBuilder<[], Logger, undefined, undefined, string, []>;
-  /** This worker's function factory, carrying its logger. */
-  get functions(): FunctionBuilder<_geekmidas_schema0.ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, _geekmidas_audit3.AuditableAction<string, unknown>>;
+  database<T, TDbName extends string>(source: Consumable<TDbName, T>): Worker<TName>;
   /**
-   * Sugar for the common case, the way `api.get()` is for `api.endpoints`.
+   * A scheduled runnable.
    *
    * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
    */
-  cron(schedule: ScheduleExpression): CronBuilder<_geekmidas_schema0.ComposableStandardSchema, _geekmidas_services1.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  cron(schedule: ScheduleExpression): CronBuilder<ComposableStandardSchema, Service[], Logger, undefined, undefined, string, undefined, string>;
+  /**
+   * A runnable that consumes a topic.
+   *
+   * Binding is not publishing: a consumer is handed the topic's event types
+   * and no connection string it could publish with. Chain `.publishes(…)` when
+   * the handler emits follow-up events, which is the only reason it would need
+   * one.
+   *
+   * @example `worker.topic(users).subscribe(['user.created']).handle(…)`
+   */
+  topic<TTopicName extends string, TEvents extends TopicEvents>(topic: Topic<TTopicName, TEvents>): SubscriberBuilder<[], Logger, undefined, EventPublisher<TopicMessage<TEvents_1>>, string, []>;
+  /**
+   * A runnable that consumes events typed from a publisher service.
+   *
+   * The older of the two ways to bind a subscriber, kept for a project whose
+   * events come from a hand-written publisher rather than a `Topic`
+   * construct. `topic()` is the one to reach for: it types the events the same
+   * way and hands the consumer no connection string it could publish with.
+   */
+  publisher<T extends EventPublisher<any>, TPubName extends string>(service: Service<TPubName, T> | Consumable<TPubName, T>): SubscriberBuilder<[], Logger, undefined, EventPublisher<any>, string, []>;
+  /**
+   * Everything below builds a function — the runnable with no schedule and no
+   * topic, invoked by something else.
+   *
+   * These sit on the worker rather than behind a `functions` namespace because
+   * the namespace was a hop that said nothing: `worker.functions.input(…)`
+   * names a collection to reach one member of it. What kind of runnable is
+   * being built is decided by which of these is called first — a schedule
+   * makes a cron, a topic makes a subscriber, and anything else makes a
+   * function.
+   */
+  input<T extends ComposableStandardSchema>(schema: T): FunctionBuilder<T, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  output<T extends StandardSchemaV1>(schema: T): FunctionBuilder<ComposableStandardSchema, T, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  timeout(ms: number): FunctionBuilder<ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  memorySize(mb: number): FunctionBuilder<ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): FunctionBuilder<ComposableStandardSchema, undefined, [...ServicesOf<T>], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  services<T extends Service[]>(services: T): FunctionBuilder<ComposableStandardSchema, undefined, [...T], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
+  /**
+   * A function with no input schema — the shortest runnable there is.
+   *
+   * @example `worker.handle(async ({ logger }) => { … })`
+   */
+  handle(...args: Parameters<ReturnType<Worker<TName>['schemalessFunction']>['handle']>): Function<ComposableStandardSchema, [], Logger, undefined, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>, FunctionHandler<ComposableStandardSchema, [], Logger, undefined, undefined, undefined, AuditableAction<string, unknown>>>;
+  /** The builder `handle` delegates to, named so its type can be referred to. */
+  private schemalessFunction;
+  /** The function builder the delegating methods above are built on. */
+  private get functions();
   /**
    * Resources and surfaces this worker calls.
    *
@@ -89,7 +136,5 @@ declare class Worker<TName extends string = string> implements Declarable<TName>
   private own;
   declare(): Declaration[];
 }
-//# sourceMappingURL=worker.d.ts.map
 //#endregion
-export { Worker, WorkerConfig };
 //# sourceMappingURL=worker.d.mts.map

package/dist/worker.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.mts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AA2IkC,UAtFjB,YAAA,CAsFiB;EAAA;;;;;;;EA2BX,GArFX,CAAA,EApBL,OAoBK;EAAU;;;;;;;;WAXZ;;;;;;;cAOG;;cAGA,iDACD,WAAW;;;;eAET;;mBAGI;;sBAGG;kBAGf,cAAc,iBACO;0BAEe;;;;;;;;eAoBhC,YApB0C,kBAAA,CAoB1C,wBAAA,EAAA,oBAAA,CAAA,4BAAA;;;;;;;qBAUM,sBAAA;;mBAKF,gBALE,kBAAA,CAKF,wBAAA,iBAAA,iEAAA,iBAAA,CAAA;;;;;;iBASE,qBAAkB,YAAA,kBAAA,CAAA,wBAAA,EAAA,oBAAA,CAAA,4BAAA;;;;;;;6BAUN,eAAe,OAAO;;;;;;aAiBtC"}
+{"version":3,"file":"worker.d.mts","names":["_$__topic0.TopicMessage","_$__construct_interface0.ServicesOf","_$__functions0.FunctionHandler","_$__functions0.Function"],"sources":["../src/worker.ts"],"mappings":";;;;;;;;;;;;;;;iBAiFiB;;;;;;;;;EAShB,SAAS;;;;;;;EAOT,YAAY;;qBAGA,OAAO,0CACR,WAAW;mBAkBJ;;mBAEA;WAlBT,IAAI;;WAGJ,QAAQ;;WAGR,WAAW;;;;;WAMX,gBAAgB;EAEzB,YACC,IAAI,cAAc,QACD,SAAQ,cAER;;EAAA,wBAAuB,cACxC,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAkCjB,SAAS,GAAG,wBACX,QAAQ,WAAW,SAAS,KAC1B,OAAO;;;;;;EAcV,KAAK,UAAU,qBAAkB,YAAA,0BAAA,WAAA;;;;;;;;;;;EAcjC,MAAM,2BAA2B,gBAAgB,aAChD,OAAO,MAAM,YAAY,WAAQ,sBAAA,mBAAA,eAAAA,aAAA;;;;;;;;;EAalC,UAAU,UAAU,qBAAqB,yBACxC,SAAS,QAAQ,UAAU,KAAK,WAAW,UAAU,KAAE,sBAAA,mBAAA;;;;;;;;;;;;EAkBxD,MAAM,UAAU,0BAA0B,QAAQ,IAAC,gBAAA,kBAAA,iEAAA;EAInD,OAAO,UAAU,kBAAkB,QAAQ,IAAC,gBAAA,0BAAA,OAAA,iEAAA;EAI5C,QAAQ,aAAU,gBAAA,yCAAA,iEAAA;EAIlB,WAAW,aAAU,gBAAA,yCAAA,iEAAA;EAIrB,gBAAgB,mBAAmB,cAAc,YAAY,IAAC,gBAAA,yCAAAC,WAAA,KAAA,iEAAA;EAI9D,SAAS,UAAU,WAAW,UAAU,IAAC,gBAAA,yCAAA,IAAA,iEAAA;;;;;;EASzC,UACI,MAAM,WACR,WAAW,OAAO,2CAClBE,SAAA,8BAAA,4EAAA,kCAAAD,gBAAA,8BAAA,yCAAA;;UAMM;;cAKI;;;;;;;EAUZ,MAAM,qBAAqB,eAAe,OAAO;;;;;UAazC;EASR,WAAW"}