@geekmidas/constructs 10.0.0-alpha.6 → 10.0.0-alpha.61

package/dist/surfaceEnv-CNimK76p.cjs

@@ -0,0 +1,56 @@
+let _geekmidas_envkit = require("@geekmidas/envkit");
+let _geekmidas_envkit_credentials = require("@geekmidas/envkit/credentials");
+//#region src/endpoints/surfaceEnv.ts
+/**
+* The environment parser an endpoint runs with.
+*
+* Three facts, in order:
+*
+* 1. An endpoint built from a surface carries whatever parser that surface was
+*    given. This is the whole point of `api.get()` — the handler already has
+*    the thing, so nothing has to be named in config and nothing has to be
+*    printed into generated code.
+* 2. A surface that named none gets this default, which is what every
+*    application's own `config/env.ts` was: `process.env` merged with the
+*    credentials `gkm dev`/`gkm exec` injected. It was boilerplate identical in
+*    every project, and mandatory, which is a poor combination.
+* 3. An endpoint with no surface at all — a test, an MSW handler — gets the
+*    same default. Nothing has to opt in.
+*
+* Named a parser only when it is genuinely different: a merged secret source, a
+* fixture, a parser that reads from somewhere other than the process.
+*/
+let fallback;
+/**
+* The default parser, built once.
+*
+* Once because `Credentials` resolves through `globalThis` and decryption is
+* not free, and because two parsers over the same environment are two caches of
+* the same answer.
+*/
+function defaultEnvParser() {
+	if (!fallback) fallback = new _geekmidas_envkit.EnvironmentParser({
+		...process.env,
+		..._geekmidas_envkit_credentials.Credentials
+	});
+	return fallback;
+}
+/** The parser for an endpoint, from its surface or the default. */
+function envParserFor(surface) {
+	return surface?.envParser ?? defaultEnvParser();
+}
+//#endregion
+Object.defineProperty(exports, "defaultEnvParser", {
+	enumerable: true,
+	get: function() {
+		return defaultEnvParser;
+	}
+});
+Object.defineProperty(exports, "envParserFor", {
+	enumerable: true,
+	get: function() {
+		return envParserFor;
+	}
+});
+
+//# sourceMappingURL=surfaceEnv-CNimK76p.cjs.map

package/dist/surfaceEnv-CNimK76p.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceEnv-CNimK76p.cjs","names":["EnvironmentParser","Credentials"],"sources":["../src/endpoints/surfaceEnv.ts"],"sourcesContent":["/**\n * The environment parser an endpoint runs with.\n *\n * Three facts, in order:\n *\n * 1. An endpoint built from a surface carries whatever parser that surface was\n *    given. This is the whole point of `api.get()` — the handler already has\n *    the thing, so nothing has to be named in config and nothing has to be\n *    printed into generated code.\n * 2. A surface that named none gets this default, which is what every\n *    application's own `config/env.ts` was: `process.env` merged with the\n *    credentials `gkm dev`/`gkm exec` injected. It was boilerplate identical in\n *    every project, and mandatory, which is a poor combination.\n * 3. An endpoint with no surface at all — a test, an MSW handler — gets the\n *    same default. Nothing has to opt in.\n *\n * Named a parser only when it is genuinely different: a merged secret source, a\n * fixture, a parser that reads from somewhere other than the process.\n */\n\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport { Credentials } from '@geekmidas/envkit/credentials';\nimport type { EndpointSurface } from './Endpoint';\n\nlet fallback: EnvironmentParser<{}> | undefined;\n\n/**\n * The default parser, built once.\n *\n * Once because `Credentials` resolves through `globalThis` and decryption is\n * not free, and because two parsers over the same environment are two caches of\n * the same answer.\n */\nexport function defaultEnvParser(): EnvironmentParser<{}> {\n\tif (!fallback) {\n\t\tfallback = new EnvironmentParser({ ...process.env, ...Credentials });\n\t}\n\n\treturn fallback;\n}\n\n/** The parser for an endpoint, from its surface or the default. */\nexport function envParserFor(\n\tsurface: EndpointSurface | undefined,\n): EnvironmentParser<{}> {\n\treturn surface?.envParser ?? defaultEnvParser();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAI;;;;;;;;AASJ,SAAgB,mBAA0C;CACzD,IAAI,CAAC,UACJ,WAAW,IAAIA,kBAAAA,kBAAkB;EAAE,GAAG,QAAQ;EAAK,GAAGC,8BAAAA;CAAY,CAAC;CAGpE,OAAO;AACR;;AAGA,SAAgB,aACf,SACwB;CACxB,OAAO,SAAS,aAAa,iBAAiB;AAC/C"}

package/dist/surfaceEnv-wMT5QzgZ.mjs

@@ -0,0 +1,45 @@
+import { EnvironmentParser } from "@geekmidas/envkit";
+import { Credentials } from "@geekmidas/envkit/credentials";
+//#region src/endpoints/surfaceEnv.ts
+/**
+* The environment parser an endpoint runs with.
+*
+* Three facts, in order:
+*
+* 1. An endpoint built from a surface carries whatever parser that surface was
+*    given. This is the whole point of `api.get()` — the handler already has
+*    the thing, so nothing has to be named in config and nothing has to be
+*    printed into generated code.
+* 2. A surface that named none gets this default, which is what every
+*    application's own `config/env.ts` was: `process.env` merged with the
+*    credentials `gkm dev`/`gkm exec` injected. It was boilerplate identical in
+*    every project, and mandatory, which is a poor combination.
+* 3. An endpoint with no surface at all — a test, an MSW handler — gets the
+*    same default. Nothing has to opt in.
+*
+* Named a parser only when it is genuinely different: a merged secret source, a
+* fixture, a parser that reads from somewhere other than the process.
+*/
+let fallback;
+/**
+* The default parser, built once.
+*
+* Once because `Credentials` resolves through `globalThis` and decryption is
+* not free, and because two parsers over the same environment are two caches of
+* the same answer.
+*/
+function defaultEnvParser() {
+	if (!fallback) fallback = new EnvironmentParser({
+		...process.env,
+		...Credentials
+	});
+	return fallback;
+}
+/** The parser for an endpoint, from its surface or the default. */
+function envParserFor(surface) {
+	return surface?.envParser ?? defaultEnvParser();
+}
+//#endregion
+export { envParserFor as n, defaultEnvParser as t };
+
+//# sourceMappingURL=surfaceEnv-wMT5QzgZ.mjs.map

package/dist/surfaceEnv-wMT5QzgZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceEnv-wMT5QzgZ.mjs","names":[],"sources":["../src/endpoints/surfaceEnv.ts"],"sourcesContent":["/**\n * The environment parser an endpoint runs with.\n *\n * Three facts, in order:\n *\n * 1. An endpoint built from a surface carries whatever parser that surface was\n *    given. This is the whole point of `api.get()` — the handler already has\n *    the thing, so nothing has to be named in config and nothing has to be\n *    printed into generated code.\n * 2. A surface that named none gets this default, which is what every\n *    application's own `config/env.ts` was: `process.env` merged with the\n *    credentials `gkm dev`/`gkm exec` injected. It was boilerplate identical in\n *    every project, and mandatory, which is a poor combination.\n * 3. An endpoint with no surface at all — a test, an MSW handler — gets the\n *    same default. Nothing has to opt in.\n *\n * Named a parser only when it is genuinely different: a merged secret source, a\n * fixture, a parser that reads from somewhere other than the process.\n */\n\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport { Credentials } from '@geekmidas/envkit/credentials';\nimport type { EndpointSurface } from './Endpoint';\n\nlet fallback: EnvironmentParser<{}> | undefined;\n\n/**\n * The default parser, built once.\n *\n * Once because `Credentials` resolves through `globalThis` and decryption is\n * not free, and because two parsers over the same environment are two caches of\n * the same answer.\n */\nexport function defaultEnvParser(): EnvironmentParser<{}> {\n\tif (!fallback) {\n\t\tfallback = new EnvironmentParser({ ...process.env, ...Credentials });\n\t}\n\n\treturn fallback;\n}\n\n/** The parser for an endpoint, from its surface or the default. */\nexport function envParserFor(\n\tsurface: EndpointSurface | undefined,\n): EnvironmentParser<{}> {\n\treturn surface?.envParser ?? defaultEnvParser();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAI;;;;;;;;AASJ,SAAgB,mBAA0C;CACzD,IAAI,CAAC,UACJ,WAAW,IAAI,kBAAkB;EAAE,GAAG,QAAQ;EAAK,GAAG;CAAY,CAAC;CAGpE,OAAO;AACR;;AAGA,SAAgB,aACf,SACwB;CACxB,OAAO,SAAS,aAAa,iBAAiB;AAC/C"}

package/dist/{telemetry-C3L0iS28.d.cts → telemetry-DGcFlVpB.d.cts}

@@ -1,7 +1,5 @@
 import { Context } from "aws-lambda";
-
 //#region src/telemetry.d.ts
-
 /**
  * Context object returned by onRequestStart, passed to subsequent hooks
  */
@@ -89,7 +87,6 @@ interface Telemetry {
    */
   onRequestError(ctx: TelemetryContext, error: Error): void;
 }
-//# sourceMappingURL=telemetry.d.ts.map
 //#endregion
-export { Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
-//# sourceMappingURL=telemetry-C3L0iS28.d.cts.map
+export { TelemetryResponse as i, TelemetryContext as n, TelemetryRequest as r, Telemetry as t };
+//# sourceMappingURL=telemetry-DGcFlVpB.d.cts.map

package/dist/telemetry-DGcFlVpB.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-DGcFlVpB.d.cts","names":["LambdaContext"],"sources":["../src/telemetry.ts"],"mappings":";;;;;UAWiB;;;;GAIf;;;;;UAMe;;;;EAIhB;;;;EAKA,SAASA;;;;;UAMO;;;;EAIhB;;;;EAKA;;;;EAKA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM;;;;;;;EAOhB,eAAe,SAAS,mBAAmB;;;;;;;EAQ3C,aAAa,KAAK,kBAAkB,UAAU;;;;;;;EAQ9C,eAAe,KAAK,kBAAkB,OAAO"}

package/dist/{telemetry-D7bVFLGi.d.mts → telemetry-DGcFlVpB.d.mts}

@@ -1,7 +1,5 @@
 import { Context } from "aws-lambda";
-
 //#region src/telemetry.d.ts
-
 /**
  * Context object returned by onRequestStart, passed to subsequent hooks
  */
@@ -89,7 +87,6 @@ interface Telemetry {
    */
   onRequestError(ctx: TelemetryContext, error: Error): void;
 }
-//# sourceMappingURL=telemetry.d.ts.map
 //#endregion
-export { Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
-//# sourceMappingURL=telemetry-D7bVFLGi.d.mts.map
+export { TelemetryResponse as i, TelemetryContext as n, TelemetryRequest as r, Telemetry as t };
+//# sourceMappingURL=telemetry-DGcFlVpB.d.mts.map

package/dist/telemetry-DGcFlVpB.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-DGcFlVpB.d.mts","names":["LambdaContext"],"sources":["../src/telemetry.ts"],"mappings":";;;;;UAWiB;;;;GAIf;;;;;UAMe;;;;EAIhB;;;;EAKA,SAASA;;;;;UAMO;;;;EAIhB;;;;EAKA;;;;EAKA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM;;;;;;;EAOhB,eAAe,SAAS,mBAAmB;;;;;;;EAQ3C,aAAa,KAAK,kBAAkB,UAAU;;;;;;;EAQ9C,eAAe,KAAK,kBAAkB,OAAO"}

package/dist/topic/index.cjs

@@ -1,137 +1,3 @@
-const require_chunk = require('../chunk-DWy1uDak.cjs');
-const require_Construct = require('../Construct-CyS3RpTL.cjs');
-const require_clone = require('../clone-Dy0cR2SZ.cjs');
-const __geekmidas_manifest = require_chunk.__toESM(require("@geekmidas/manifest"));
-const __geekmidas_logger_console = require_chunk.__toESM(require("@geekmidas/logger/console"));
-const __geekmidas_events = require_chunk.__toESM(require("@geekmidas/events"));
-
-//#region src/topic/Topic.ts
-/**
-* A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a
-* topic is a *resource* owned by no single handler: it declares the event
-* contract, derives a typed producer (`topic.publisher`), and any number of
-* subscribers (`s.topic(topic)`) bind to it. `gkm build` discovers it into the
-* manifest's `topics` field; infra provisions an SNS topic.
-*
-* This replaces hand-writing a publisher `Service`: the publisher is *derived*
-* from the declared event contract, the same way `Queue` derives its publisher.
-*/
-var Topic = class extends require_Construct.Construct {
-	__IS_TOPIC__ = true;
-	static isTopic(obj) {
-		return Boolean(obj && obj.__IS_TOPIC__ === true && obj.type === require_Construct.ConstructType.Topic);
-	}
-	/**
-	* The canonical id this topic is declared under.
-	*
-	* Derived from the name, so `users` and `Users` are one topic. The name is
-	* left alone: subscribers bind to it and it is what the broker routes on.
-	*/
-	id;
-	/**
-	* The producer's env key, read by both {@link declare} and
-	* {@link publisher} so the two cannot drift.
-	*/
-	connectionKey;
-	constructor(name, eventSchemas, logger = __geekmidas_logger_console.DEFAULT_LOGGER) {
-		super(require_Construct.ConstructType.Topic, logger, [], []);
-		this.name = name;
-		this.eventSchemas = eventSchemas;
-		this.id = (0, __geekmidas_manifest.canonicalId)(name);
-		this.connectionKey = (0, __geekmidas_manifest.provideKey)(this.id, "publisherConnectionString");
-	}
-	/**
-	* What this topic is in the manifest.
-	*
-	* Only the producer's key: a subscriber is *bound* to a topic rather than
-	* depending on it, so the binding is an edge the deploy target reads and not
-	* an env key anyone can hold. Locally both sides meet on the same broker.
-	*/
-	declare() {
-		return [{
-			kind: "topic",
-			id: this.id,
-			provides: [this.connectionKey],
-			events: this.eventTypes,
-			subscribers: []
-		}];
-	}
-	/** The event type names this topic carries. */
-	get eventTypes() {
-		return Object.keys(this.eventSchemas);
-	}
-	/**
-	* The producer side — a `Service` exposing an `EventPublisher` typed to the
-	* union of this topic's events. Inject via `.publisher(topic.publisher)` (for
-	* declarative `.event(...)`) or `.services([topic.publisher])` (to publish
-	* imperatively). Reads `<NAME>_PUBLISHER_CONNECTION_STRING` and selects the
-	* transport from the URL protocol — `pgboss://` locally, `sns://` deployed.
-	*
-	* Because it's a `Service`, the connection-string requirement is sniffed into
-	* the manifest of whatever construct injects it (least-privilege linking).
-	*/
-	/**
-	* The topic as a dependency — what `.dependsOn([users])` dissolves into,
-	* reachable as `services.users`.
-	*
-	* It is the producer, because publishing is the only thing depending on a
-	* topic can mean: a subscriber *binds* with `s.topic(…)` instead, and is
-	* deliberately never handed this. {@link publisher} is the same service
-	* under its older `<name>Publisher` key.
-	*/
-	get service() {
-		const { register } = this.publisher;
-		return {
-			serviceName: (0, __geekmidas_manifest.serviceKey)(this.id),
-			register
-		};
-	}
-	get publisher() {
-		const envVar = this.connectionKey;
-		return {
-			serviceName: `${this.name}Publisher`,
-			async register({ envParser }) {
-				const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
-				return __geekmidas_events.Publisher.fromConnectionString(connectionString);
-			}
-		};
-	}
-};
-
-//#endregion
-//#region src/topic/TopicBuilder.ts
-/**
-* Builds a {@link Topic} — `t.topic('users').events({ 'user.created': schema, … })`.
-* The event map is the topic's contract: it types the derived `topic.publisher`
-* and the subscribers that bind via `s.topic(topic)`.
-*/
-var TopicBuilder = class {
-	_name;
-	_logger = __geekmidas_logger_console.DEFAULT_LOGGER;
-	/** The topic name — drives the infra topic and its `<NAME>_*` env vars. */
-	topic(name) {
-		return require_clone.cloneWith(this, { _name: name });
-	}
-	logger(logger) {
-		return require_clone.cloneWith(this, { _logger: logger });
-	}
-	/**
-	* The event contract — a map of event type → payload schema. Building the
-	* topic requires this; it's what types the publisher and subscribers.
-	*/
-	events(events) {
-		if (!this._name) throw new Error("Topic requires a name — call .topic(name) before .events().");
-		const topic = new Topic(this._name, events, this._logger);
-		return topic;
-	}
-};
-
-//#endregion
-//#region src/topic/index.ts
-const t = new TopicBuilder();
-
-//#endregion
-exports.Topic = Topic;
-exports.TopicBuilder = TopicBuilder;
-exports.t = t;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_Topic = require("../Topic-CkxOTrMv.cjs");
+exports.Topic = require_Topic.Topic;

package/dist/topic/index.d.cts

@@ -1,4 +1,2 @@
-import "../Construct-C0ijr2qp.cjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-19QeHBIR.cjs";
-import { TopicBuilder, t } from "../index-CBSfrowv.cjs";
-export { Topic, TopicBuilder, TopicEvents, TopicMessage, t };
+import { c as Topic, d as TopicOptions, l as TopicEvents, u as TopicMessage } from "../Construct-BQALFCh2.cjs";
+export { Topic, type TopicEvents, type TopicMessage, type TopicOptions };

package/dist/topic/index.d.mts

@@ -1,4 +1,2 @@
-import "../Construct-Ct8nalEi.mjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-DuFeqkBh.mjs";
-import { TopicBuilder, t } from "../index-BknhM6Ux.mjs";
-export { Topic, TopicBuilder, TopicEvents, TopicMessage, t };
+import { c as Topic, d as TopicOptions, l as TopicEvents, u as TopicMessage } from "../Construct-QXnl3VqT.mjs";
+export { Topic, type TopicEvents, type TopicMessage, type TopicOptions };

package/dist/topic/index.mjs

@@ -1,134 +1,2 @@
-import { Construct, ConstructType } from "../Construct-BD5neF7w.mjs";
-import { cloneWith } from "../clone-DblgEZZa.mjs";
-import { canonicalId, provideKey, serviceKey } from "@geekmidas/manifest";
-import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
-import { Publisher } from "@geekmidas/events";
-
-//#region src/topic/Topic.ts
-/**
-* A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a
-* topic is a *resource* owned by no single handler: it declares the event
-* contract, derives a typed producer (`topic.publisher`), and any number of
-* subscribers (`s.topic(topic)`) bind to it. `gkm build` discovers it into the
-* manifest's `topics` field; infra provisions an SNS topic.
-*
-* This replaces hand-writing a publisher `Service`: the publisher is *derived*
-* from the declared event contract, the same way `Queue` derives its publisher.
-*/
-var Topic = class extends Construct {
-	__IS_TOPIC__ = true;
-	static isTopic(obj) {
-		return Boolean(obj && obj.__IS_TOPIC__ === true && obj.type === ConstructType.Topic);
-	}
-	/**
-	* The canonical id this topic is declared under.
-	*
-	* Derived from the name, so `users` and `Users` are one topic. The name is
-	* left alone: subscribers bind to it and it is what the broker routes on.
-	*/
-	id;
-	/**
-	* The producer's env key, read by both {@link declare} and
-	* {@link publisher} so the two cannot drift.
-	*/
-	connectionKey;
-	constructor(name, eventSchemas, logger = DEFAULT_LOGGER) {
-		super(ConstructType.Topic, logger, [], []);
-		this.name = name;
-		this.eventSchemas = eventSchemas;
-		this.id = canonicalId(name);
-		this.connectionKey = provideKey(this.id, "publisherConnectionString");
-	}
-	/**
-	* What this topic is in the manifest.
-	*
-	* Only the producer's key: a subscriber is *bound* to a topic rather than
-	* depending on it, so the binding is an edge the deploy target reads and not
-	* an env key anyone can hold. Locally both sides meet on the same broker.
-	*/
-	declare() {
-		return [{
-			kind: "topic",
-			id: this.id,
-			provides: [this.connectionKey],
-			events: this.eventTypes,
-			subscribers: []
-		}];
-	}
-	/** The event type names this topic carries. */
-	get eventTypes() {
-		return Object.keys(this.eventSchemas);
-	}
-	/**
-	* The producer side — a `Service` exposing an `EventPublisher` typed to the
-	* union of this topic's events. Inject via `.publisher(topic.publisher)` (for
-	* declarative `.event(...)`) or `.services([topic.publisher])` (to publish
-	* imperatively). Reads `<NAME>_PUBLISHER_CONNECTION_STRING` and selects the
-	* transport from the URL protocol — `pgboss://` locally, `sns://` deployed.
-	*
-	* Because it's a `Service`, the connection-string requirement is sniffed into
-	* the manifest of whatever construct injects it (least-privilege linking).
-	*/
-	/**
-	* The topic as a dependency — what `.dependsOn([users])` dissolves into,
-	* reachable as `services.users`.
-	*
-	* It is the producer, because publishing is the only thing depending on a
-	* topic can mean: a subscriber *binds* with `s.topic(…)` instead, and is
-	* deliberately never handed this. {@link publisher} is the same service
-	* under its older `<name>Publisher` key.
-	*/
-	get service() {
-		const { register } = this.publisher;
-		return {
-			serviceName: serviceKey(this.id),
-			register
-		};
-	}
-	get publisher() {
-		const envVar = this.connectionKey;
-		return {
-			serviceName: `${this.name}Publisher`,
-			async register({ envParser }) {
-				const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
-				return Publisher.fromConnectionString(connectionString);
-			}
-		};
-	}
-};
-
-//#endregion
-//#region src/topic/TopicBuilder.ts
-/**
-* Builds a {@link Topic} — `t.topic('users').events({ 'user.created': schema, … })`.
-* The event map is the topic's contract: it types the derived `topic.publisher`
-* and the subscribers that bind via `s.topic(topic)`.
-*/
-var TopicBuilder = class {
-	_name;
-	_logger = DEFAULT_LOGGER;
-	/** The topic name — drives the infra topic and its `<NAME>_*` env vars. */
-	topic(name) {
-		return cloneWith(this, { _name: name });
-	}
-	logger(logger) {
-		return cloneWith(this, { _logger: logger });
-	}
-	/**
-	* The event contract — a map of event type → payload schema. Building the
-	* topic requires this; it's what types the publisher and subscribers.
-	*/
-	events(events) {
-		if (!this._name) throw new Error("Topic requires a name — call .topic(name) before .events().");
-		const topic = new Topic(this._name, events, this._logger);
-		return topic;
-	}
-};
-
-//#endregion
-//#region src/topic/index.ts
-const t = new TopicBuilder();
-
-//#endregion
-export { Topic, TopicBuilder, t };
-//# sourceMappingURL=index.mjs.map
+import { t as Topic } from "../Topic-hPffOsot.mjs";
+export { Topic };

package/dist/{types-BlAkSuGI.d.cts → types-DMuSQeLL.d.cts}

@@ -1,9 +1,7 @@
 //#region src/types.d.ts
-type RemoveUndefined<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K] };
+type RemoveUndefined<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K]; };
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
 type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
-//# sourceMappingURL=types.d.ts.map
-
 //#endregion
-export { HttpMethod, LowerHttpMethod, RemoveUndefined };
-//# sourceMappingURL=types-BlAkSuGI.d.cts.map
+export { LowerHttpMethod as n, RemoveUndefined as r, HttpMethod as t };
+//# sourceMappingURL=types-DMuSQeLL.d.cts.map

package/dist/types-DMuSQeLL.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DMuSQeLL.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,gBAAgB,QAC1B,WAAW,KAAK,EAAE,+BAA+B,IAAI,EAAE;KAG7C;KAQA,gBAAgB,UAAU,cAAc,UAAU"}

package/dist/{types-aKksMEWL.d.mts → types-DMuSQeLL.d.mts}

@@ -1,9 +1,7 @@
 //#region src/types.d.ts
-type RemoveUndefined<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K] };
+type RemoveUndefined<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K]; };
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
 type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
-//# sourceMappingURL=types.d.ts.map
-
 //#endregion
-export { HttpMethod, LowerHttpMethod, RemoveUndefined };
-//# sourceMappingURL=types-aKksMEWL.d.mts.map
+export { LowerHttpMethod as n, RemoveUndefined as r, HttpMethod as t };
+//# sourceMappingURL=types-DMuSQeLL.d.mts.map

package/dist/types-DMuSQeLL.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DMuSQeLL.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,gBAAgB,QAC1B,WAAW,KAAK,EAAE,+BAA+B,IAAI,EAAE;KAG7C;KAQA,gBAAgB,UAAU,cAAc,UAAU"}

package/dist/types.d.cts

@@ -1,2 +1,2 @@
-import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-BlAkSuGI.cjs";
+import { n as LowerHttpMethod, r as RemoveUndefined, t as HttpMethod } from "./types-DMuSQeLL.cjs";
 export { HttpMethod, LowerHttpMethod, RemoveUndefined };

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-aKksMEWL.mjs";
+import { n as LowerHttpMethod, r as RemoveUndefined, t as HttpMethod } from "./types-DMuSQeLL.mjs";
 export { HttpMethod, LowerHttpMethod, RemoveUndefined };

package/dist/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/worker.cjs

@@ -1,16 +1,16 @@
-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-i_la-N5r.cjs');
-require('./clone-Dy0cR2SZ.cjs');
-const require_surfaceEnv = require('./surfaceEnv-BFXEms2f.cjs');
-const require_CronBuilder = require('./CronBuilder-Da0C0edR.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-CbP5ZKma.cjs");
+const require_surfaceEnv = require("./surfaceEnv-CNimK76p.cjs");
+const require_CronBuilder = require("./CronBuilder-BoHzlWU_.cjs");
+const require_QueueBuilder = require("./QueueBuilder-BFQn3OzZ.cjs");
+const require_SubscriberBuilder = require("./SubscriberBuilder-C2PwqwIl.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;
@@ -18,15 +18,16 @@ var Worker = class Worker {
 	envParser;
 	/**
 	* Where this worker's schedules live, when it has crons and a server runs
-	* them. `undefined` until `.database(…)` says.
+	* them — and the database everything built from it receives as `db`.
+	* `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
@@ -34,7 +35,10 @@ var Worker = class Worker {
 		this.scheduleStore = scheduleStore;
 	}
 	/**
-	* The database this worker keeps its schedules in.
+	* The database this worker keeps its schedules in, and the one everything
+	* built from it — crons, queues, subscribers, functions — receives as `db`.
+	* One of them that works against another database names it with its own
+	* `.database(other)`, which replaces this one for that runnable alone.
 	*
 	* 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
@@ -51,6 +55,10 @@ var Worker = class Worker {
 	* @example
 	* ```ts
 	* export const jobs = new Worker('Jobs', { logger }).database(database);
+	*
+	* export const sweep = jobs
+	*   .cron('rate(1 hour)')
+	*   .handle(async ({ db }) => db.deleteFrom('sessions').execute());
 	* ```
 	*/
 	database(source) {
@@ -65,12 +73,31 @@ var Worker = class Worker {
 		return this.own(new require_CronBuilder.CronBuilder().logger(this.logger)).schedule(schedule);
 	}
 	/**
+	* A queue and its one consumer, run by this worker.
+	*
+	* One construct, because a queue has exactly one consumer: nothing else can
+	* attach a second, or forget to attach the first. Producers send to it by
+	* depending on it — `.dependsOn([emails])` makes `services.emails` the
+	* publisher.
+	*
+	* @example
+	* ```ts
+	* export const emails = worker
+	*   .queue('Emails')
+	*   .message(z.object({ userId: z.uuid(), template: z.string() }))
+	*   .handle(async ({ messages, services }) => { … });
+	* ```
+	*/
+	queue(name) {
+		return this.own(new require_QueueBuilder.QueueBuilder().logger(this.logger)).queue(name);
+	}
+	/**
 	* 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.
+	* and no connection string it could publish with. A handler that emits
+	* follow-up events depends on the topic it emits to —
+	* `.dependsOn([orders])` — which is the only reason it would need one.
 	*
 	* @example `worker.topic(users).subscribe(['user.created']).handle(…)`
 	*/
@@ -78,17 +105,6 @@ var Worker = class Worker {
 		return this.own(new require_SubscriberBuilder.SubscriberBuilder().logger(this.logger)).topic(topic);
 	}
 	/**
-	* 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(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.
 	*
@@ -144,12 +160,20 @@ var Worker = class Worker {
 	}
 	/**
 	* Stamps this worker's id onto a builder, so everything built from it says
-	* which process runs it.
+	* which process runs it — and hands it the worker's database.
+	*
+	* The database goes through the builder's own `.database()` rather than
+	* being written into its fields, so the default is recorded exactly as an
+	* explicit one would be: the client the handler gets, and the edge the
+	* manifest reads. That is also what lets a later `.database(other)` replace
+	* it outright. The builder arrives already typed with this worker's
+	* database; this is the runtime half of that.
 	*/
 	own(builder) {
-		builder._owner = this.id;
-		builder._scheduleStore = this.scheduleStore;
-		return builder;
+		const owned = this.scheduleStore ? builder.database(this.scheduleStore) : builder;
+		owned._owner = this.id;
+		owned._scheduleStore = this.scheduleStore;
+		return owned;
 	}
 	declare() {
 		return [{
@@ -160,7 +184,7 @@ var Worker = class Worker {
 		}];
 	}
 };
-
 //#endregion
 exports.Worker = Worker;
+
 //# sourceMappingURL=worker.cjs.map