@geekmidas/constructs 9.0.2 → 10.0.0-alpha.0

package/dist/site.d.mts

@@ -0,0 +1,101 @@
+import { Declarable } from "./construct-interface-BqwRNYA2.mjs";
+import { ConstructName, Declaration, Dependency, SiteDeclaration } from "@geekmidas/manifest";
+
+//#region src/site.d.ts
+
+/**
+ * A site's config is flat, where a surface's nests its `app`.
+ *
+ * Not an inconsistency: a `RestApi` may or may not have a process of its own,
+ * so "what the surface is" and "how its process is built" are separable there
+ * and worth separating. A site *is* its app — there is nothing to separate it
+ * from, and `{ app: { path } }` would be a wrapper around the only thing in it.
+ *
+ * Every field is optional, so `new StaticSite('Web')` is a complete site.
+ */
+interface StaticSiteConfig {
+  /**
+   * Where its source lives, relative to the workspace root.
+   *
+   * Optional, and normally omitted: `apps/<kebab-id>` where that directory
+   * exists, and the workspace root otherwise. `StaticSite('Web')` means
+   * `apps/web`, which is the thing the id already said.
+   *
+   * Worth writing only when the layout differs — `path: 'sites/marketing'`.
+   */
+  path?: string;
+  /**
+   * The port it answers on locally.
+   *
+   * Normally omitted: ports are assigned in a stable order, so adding a site
+   * does not renumber the ones already running.
+   */
+  port?: number;
+  /**
+   * Modules to import when sniffing which env vars this site reads.
+   *
+   * A frontend's values are inlined at build time, so the build has to know
+   * which ones it reads before it reads them.
+   */
+  config?: {
+    client?: string;
+    server?: string;
+  };
+  /**
+   * Whether the base domain points at this site.
+   *
+   * A project with one site needs this no more than a project with one
+   * database needs to say which database. It matters when there are several
+   * and none is called `web`: the base domain then belongs to whichever site
+   * says so, rather than to whichever file the glob happened to reach first.
+   */
+  root?: boolean;
+  /**
+   * Which framework builds it.
+   *
+   * It selects how values are delivered — `VITE_`, `NEXT_PUBLIC_`, a fetched
+   * `config.json` — and never which values there are. One neutral name from the
+   * construct, one serialisation per framework, the same rule as everywhere
+   * else.
+   */
+  variant?: SiteDeclaration['variant'];
+}
+declare class StaticSite<TName extends string = string> implements Declarable<TName> {
+  private readonly config;
+  /**
+   * Internal: how `.dependsOn()` carries edges into the copy it returns.
+   * Written as a parameter rather than a mutable field so the builder can
+   * stay immutable without a clone method, the same shape
+   * `KyselyDatabase` uses for its derived forms.
+   */
+  private readonly dependencies;
+  readonly id: TName;
+  readonly keys: {
+    url: string;
+  };
+  constructor(id: ConstructName<TName>, config?: StaticSiteConfig,
+  /**
+   * Internal: how `.dependsOn()` carries edges into the copy it returns.
+   * Written as a parameter rather than a mutable field so the builder can
+   * stay immutable without a clone method, the same shape
+   * `KyselyDatabase` uses for its derived forms.
+   */
+  dependencies?: readonly Dependency[]);
+  /**
+   * What this site calls.
+   *
+   * Immutable, like every other builder here: it returns a new site rather than
+   * mutating this one, so a module that exports both a base and a variant of it
+   * cannot have the second silently change the first.
+   *
+   * Takes {@link Declarable} rather than {@link Consumable} because a site's
+   * edge is a build-time link and not a service injection — requiring a client
+   * would exclude exactly the surfaces a frontend actually depends on.
+   */
+  dependsOn(constructs: readonly Declarable[]): StaticSite<TName>;
+  declare(): Declaration[];
+}
+//# sourceMappingURL=site.d.ts.map
+//#endregion
+export { StaticSite, StaticSiteConfig };
+//# sourceMappingURL=site.d.mts.map

package/dist/site.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.mts","names":[],"sources":["../src/site.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;UA4CiB,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA0CN;;cAGE,qDACD,WAAW;;;;;;;;;eAET;;;;kBAIR,cAAc,iBACO;;;;;;;0BAOe;;;;;;;;;;;;iCAiBV,eAAe,WAAW;aAO9C"}

package/dist/site.mjs

@@ -0,0 +1,47 @@
+import { edgeTo } from "./construct-interface-Z4CpS8tK.mjs";
+import { canonicalId, provideKey } from "@geekmidas/manifest";
+
+//#region src/site.ts
+var StaticSite = class StaticSite {
+	id;
+	keys;
+	constructor(id, config = {}, dependencies = []) {
+		this.config = config;
+		this.dependencies = dependencies;
+		this.id = canonicalId(id);
+		this.keys = { url: provideKey(this.id, "url") };
+	}
+	/**
+	* What this site calls.
+	*
+	* Immutable, like every other builder here: it returns a new site rather than
+	* mutating this one, so a module that exports both a base and a variant of it
+	* cannot have the second silently change the first.
+	*
+	* Takes {@link Declarable} rather than {@link Consumable} because a site's
+	* edge is a build-time link and not a service injection — requiring a client
+	* would exclude exactly the surfaces a frontend actually depends on.
+	*/
+	dependsOn(constructs) {
+		return new StaticSite(this.id, this.config, [...this.dependencies, ...constructs.map(edgeTo)]);
+	}
+	declare() {
+		return [{
+			kind: "site",
+			id: this.id,
+			variant: this.config.variant ?? "static",
+			app: {
+				...this.config.path ? { path: this.config.path } : {},
+				...this.config.port ? { port: this.config.port } : {},
+				...this.config.config ? { config: this.config.config } : {}
+			},
+			...this.config.root ? { root: true } : {},
+			dependencies: this.dependencies,
+			provides: [this.keys.url]
+		}];
+	}
+};
+
+//#endregion
+export { StaticSite };
+//# sourceMappingURL=site.mjs.map

package/dist/site.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.mjs","names":["id: ConstructName<TName>","config: StaticSiteConfig","dependencies: readonly Dependency[]","constructs: readonly Declarable[]"],"sources":["../src/site.ts"],"sourcesContent":["/**\n * `StaticSite` — a frontend, declared like anything else.\n *\n * The point is not that a site needs provisioning; it is that a site is the\n * *consumer* whose edges make four hand-maintained lists derivable. Declaring it\n * is what turns \"which origins does the API allow\" from something a person keeps\n * in step into something the graph already knows.\n *\n * ```ts\n * export const console = new StaticSite('Console', { path: 'apps/console' })\n *   .dependsOn([api, auth]);\n * ```\n *\n * It has no `.service`. A site is not a process that registers clients — it is\n * built, and the values it needs are inlined or fetched by its own framework —\n * so the edge is {@link Declarable} rather than {@link Consumable}, and the\n * asymmetry is the honest one: a site consumes addresses, not connections.\n *\n * Only the static variant ships. SSR deploy shapes are unstable and each one is\n * its own maintenance, so they follow rather than arrive together; Expo and\n * mobile are out of scope entirely, because an app store is not infrastructure\n * and there is no URL to hand anyone.\n */\n\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\ttype Dependency,\n\tprovideKey,\n\ttype SiteDeclaration,\n} from '@geekmidas/manifest';\nimport { type Declarable, edgeTo } from './construct-interface';\n\n/**\n * A site's config is flat, where a surface's nests its `app`.\n *\n * Not an inconsistency: a `RestApi` may or may not have a process of its own,\n * so \"what the surface is\" and \"how its process is built\" are separable there\n * and worth separating. A site *is* its app — there is nothing to separate it\n * from, and `{ app: { path } }` would be a wrapper around the only thing in it.\n *\n * Every field is optional, so `new StaticSite('Web')` is a complete site.\n */\nexport interface StaticSiteConfig {\n\t/**\n\t * Where its source lives, relative to the workspace root.\n\t *\n\t * Optional, and normally omitted: `apps/<kebab-id>` where that directory\n\t * exists, and the workspace root otherwise. `StaticSite('Web')` means\n\t * `apps/web`, which is the thing the id already said.\n\t *\n\t * Worth writing only when the layout differs — `path: 'sites/marketing'`.\n\t */\n\tpath?: string;\n\t/**\n\t * The port it answers on locally.\n\t *\n\t * Normally omitted: ports are assigned in a stable order, so adding a site\n\t * does not renumber the ones already running.\n\t */\n\tport?: number;\n\t/**\n\t * Modules to import when sniffing which env vars this site reads.\n\t *\n\t * A frontend's values are inlined at build time, so the build has to know\n\t * which ones it reads before it reads them.\n\t */\n\tconfig?: { client?: string; server?: string };\n\t/**\n\t * Whether the base domain points at this site.\n\t *\n\t * A project with one site needs this no more than a project with one\n\t * database needs to say which database. It matters when there are several\n\t * and none is called `web`: the base domain then belongs to whichever site\n\t * says so, rather than to whichever file the glob happened to reach first.\n\t */\n\troot?: boolean;\n\t/**\n\t * Which framework builds it.\n\t *\n\t * It selects how values are delivered — `VITE_`, `NEXT_PUBLIC_`, a fetched\n\t * `config.json` — and never which values there are. One neutral name from the\n\t * construct, one serialisation per framework, the same rule as everywhere\n\t * else.\n\t */\n\tvariant?: SiteDeclaration['variant'];\n}\n\nexport class StaticSite<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\treadonly keys: { url: string };\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly config: StaticSiteConfig = {},\n\t\t/**\n\t\t * Internal: how `.dependsOn()` carries edges into the copy it returns.\n\t\t * Written as a parameter rather than a mutable field so the builder can\n\t\t * stay immutable without a clone method, the same shape\n\t\t * `KyselyDatabase` uses for its derived forms.\n\t\t */\n\t\tprivate readonly dependencies: readonly Dependency[] = [],\n\t) {\n\t\tthis.id = canonicalId(id as string) as TName;\n\t\tthis.keys = { url: provideKey(this.id, 'url') };\n\t}\n\n\t/**\n\t * What this site calls.\n\t *\n\t * Immutable, like every other builder here: it returns a new site rather than\n\t * mutating this one, so a module that exports both a base and a variant of it\n\t * cannot have the second silently change the first.\n\t *\n\t * Takes {@link Declarable} rather than {@link Consumable} because a site's\n\t * edge is a build-time link and not a service injection — requiring a client\n\t * would exclude exactly the surfaces a frontend actually depends on.\n\t */\n\tdependsOn(constructs: readonly Declarable[]): StaticSite<TName> {\n\t\treturn new StaticSite<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\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'site',\n\t\t\t\tid: this.id,\n\t\t\t\tvariant: this.config.variant ?? 'static',\n\t\t\t\tapp: {\n\t\t\t\t\t...(this.config.path ? { path: this.config.path } : {}),\n\t\t\t\t\t...(this.config.port ? { port: this.config.port } : {}),\n\t\t\t\t\t...(this.config.config ? { config: this.config.config } : {}),\n\t\t\t\t},\n\t\t\t\t...(this.config.root ? { root: true } : {}),\n\t\t\t\tdependencies: this.dependencies,\n\t\t\t\tprovides: [this.keys.url],\n\t\t\t},\n\t\t];\n\t}\n}\n"],"mappings":";;;;AAyFA,IAAa,aAAb,MAAa,WAEb;CACC,AAAS;CACT,AAAS;CAET,YACCA,IACiBC,SAA2B,CAAE,GAO7BC,eAAsC,CAAE,GACxD;EARgB;EAOA;AAEjB,OAAK,KAAK,YAAY,GAAa;AACnC,OAAK,OAAO,EAAE,KAAK,WAAW,KAAK,IAAI,MAAM,CAAE;CAC/C;;;;;;;;;;;;CAaD,UAAUC,YAAsD;AAC/D,SAAO,IAAI,WAAkB,KAAK,IAA4B,KAAK,QAAQ,CAC1E,GAAG,KAAK,cACR,GAAG,WAAW,IAAI,OAAO,AACzB;CACD;CAED,UAAyB;AACxB,SAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,SAAS,KAAK,OAAO,WAAW;GAChC,KAAK;IACJ,GAAI,KAAK,OAAO,OAAO,EAAE,MAAM,KAAK,OAAO,KAAM,IAAG,CAAE;IACtD,GAAI,KAAK,OAAO,OAAO,EAAE,MAAM,KAAK,OAAO,KAAM,IAAG,CAAE;IACtD,GAAI,KAAK,OAAO,SAAS,EAAE,QAAQ,KAAK,OAAO,OAAQ,IAAG,CAAE;GAC5D;GACD,GAAI,KAAK,OAAO,OAAO,EAAE,MAAM,KAAM,IAAG,CAAE;GAC1C,cAAc,KAAK;GACnB,UAAU,CAAC,KAAK,KAAK,GAAI;EACzB,CACD;CACD;AACD"}

package/dist/subscribers/index.cjs

@@ -1,15 +1,17 @@
-const require_Construct = require('../Construct-vXMZJgRp.cjs');
-const __geekmidas_logger_console = require_Construct.__toESM(require("@geekmidas/logger/console"));
+const require_chunk = require('../chunk-DWy1uDak.cjs');
+const require_construct_interface = require('../construct-interface-BfjcOD_E.cjs');
+const require_Construct = require('../Construct-roId57cU.cjs');
+const require_clone = require('../clone-Dy0cR2SZ.cjs');
+const __geekmidas_logger_console = require_chunk.__toESM(require("@geekmidas/logger/console"));
 
 //#region src/subscribers/Subscriber.ts
-const DEFAULT_LOGGER$1 = new __geekmidas_logger_console.ConsoleLogger();
 var Subscriber = class extends require_Construct.Construct {
 	__IS_SUBSCRIBER__ = true;
 	static isSubscriber(obj) {
 		return Boolean(obj && obj.__IS_SUBSCRIBER__ === true && obj.type === require_Construct.ConstructType.Subscriber);
 	}
-	constructor(handler, timeout = 3e4, _subscribedEvents, outputSchema, services = [], logger = DEFAULT_LOGGER$1, publisherService, topicName) {
-		super(require_Construct.ConstructType.Subscriber, logger, services, [], publisherService, outputSchema);
+	constructor(handler, timeout = 3e4, _subscribedEvents, outputSchema, services = [], logger = __geekmidas_logger_console.DEFAULT_LOGGER, publisherService, topicName, constructs = []) {
+		super(require_Construct.ConstructType.Subscriber, logger, services, [], publisherService, outputSchema, timeout, void 0, void 0, constructs);
 		this.handler = handler;
 		this.timeout = timeout;
 		this._subscribedEvents = _subscribedEvents;
@@ -31,6 +33,8 @@ var SubscriberBuilder = class {
 	_timeout;
 	outputSchema;
 	_services = [];
+	/** The construct ids `.dependsOn()` named — what the manifest records. */
+	_constructs = [];
 	_logger = __geekmidas_logger_console.DEFAULT_LOGGER;
 	_publisher;
 	_topicName;
@@ -49,43 +53,47 @@ var SubscriberBuilder = class {
 	* subscriber actually publishes follow-up events.
 	*/
 	topic(topic) {
-		this._topicName = topic.name;
-		return this;
+		return require_clone.cloneWith(this, { _topicName: topic.name });
 	}
 	timeout(timeout) {
-		this._timeout = timeout;
-		return this;
+		return require_clone.cloneWith(this, { _timeout: timeout });
 	}
 	output(schema) {
-		this.outputSchema = schema;
-		return this;
+		return require_clone.cloneWith(this, { outputSchema: schema });
+	}
+	/**
+	* Depend on constructs — a database, a bucket, a mail sender, a queue, a
+	* topic.
+	*
+	* It records the edge and dissolves each construct's client into the
+	* handler's service record under the construct's own id, so
+	* `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+	*
+	* Constructs only. A `Service` does not match the shape, which is what keeps
+	* env sniffing confined to `.services()` and the explicit lift.
+	*/
+	dependsOn(constructs) {
+		const services = require_construct_interface.servicesOf(constructs);
+		return require_clone.cloneWith(this, {
+			_services: [...this._services, ...services],
+			_constructs: require_construct_interface.idsOf(constructs, this._constructs)
+		});
 	}
 	services(services) {
-		this._services = [...this._services, ...services];
-		return this;
+		return require_clone.cloneWith(this, { _services: [...this._services, ...services] });
 	}
 	logger(logger) {
-		this._logger = logger;
-		return this;
+		return require_clone.cloneWith(this, { _logger: logger });
 	}
 	publisher(publisher) {
-		this._publisher = publisher;
-		return this;
+		return require_clone.cloneWith(this, { _publisher: publisher });
 	}
 	subscribe(event) {
 		const eventsToAdd = Array.isArray(event) ? event : [event];
-		this._subscribedEvents = [...this._subscribedEvents, ...eventsToAdd];
-		return this;
+		return require_clone.cloneWith(this, { _subscribedEvents: [...this._subscribedEvents, ...eventsToAdd] });
 	}
 	handle(fn) {
-		const subscriber = new Subscriber(fn, this._timeout, this._subscribedEvents, this.outputSchema, this._services, this._logger, this._publisher, this._topicName);
-		this._services = [];
-		this._logger = __geekmidas_logger_console.DEFAULT_LOGGER;
-		this._publisher = void 0;
-		this._topicName = void 0;
-		this._subscribedEvents = [];
-		this._timeout = 3e4;
-		this.outputSchema = void 0;
+		const subscriber = new Subscriber(fn, this._timeout, this._subscribedEvents, this.outputSchema, this._services, this._logger, this._publisher, this._topicName, this._constructs);
 		return subscriber;
 	}
 };

package/dist/subscribers/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["DEFAULT_LOGGER","ConsoleLogger","Construct","obj: any","ConstructType","handler: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>","timeout: number","_subscribedEvents?: TSubscribedEvents","outputSchema?: OutSchema","services: TServices","logger: TLogger","publisherService?: Service<\n\t\t\tTEventPublisherServiceName,\n\t\t\tTEventPublisher\n\t\t>","topicName?: string","DEFAULT_LOGGER","topic: Topic<TName, TEvents>","timeout: number","schema: T","services: T","logger: T","publisher: Service<TName, T>","event: TEvent","fn: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>"],"sources":["../../src/subscribers/Subscriber.ts","../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":["import type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { ConsoleLogger } from '@geekmidas/logger/console';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\nconst DEFAULT_LOGGER = new ConsoleLogger() as any;\n\n// Helper type to extract payload types for subscribed events\ntype ExtractEventPayloads<\n\tTPublisher extends EventPublisher<any> | undefined,\n\tTEventTypes extends any[],\n> = TPublisher extends EventPublisher<any>\n\t? Extract<ExtractPublisherMessage<TPublisher>, { type: TEventTypes[number] }>\n\t: never;\n\nexport class Subscriber<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends\n\t\tExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][],\n> extends Construct<\n\tTLogger,\n\tTEventPublisherServiceName,\n\tTEventPublisher,\n\tOutSchema,\n\tTServices\n> {\n\t__IS_SUBSCRIBER__ = true;\n\n\tstatic isSubscriber(\n\t\tobj: any,\n\t): obj is Subscriber<any, any, any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\tobj.__IS_SUBSCRIBER__ === true &&\n\t\t\t\tobj.type === ConstructType.Subscriber,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tpublic readonly handler: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>,\n\t\tpublic override readonly timeout: number = 30000,\n\t\tprotected _subscribedEvents?: TSubscribedEvents,\n\t\tpublic override readonly outputSchema?: OutSchema,\n\t\tpublic override readonly services: TServices = [] as unknown as TServices,\n\t\tpublic override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,\n\t\tpublic override readonly publisherService?: Service<\n\t\t\tTEventPublisherServiceName,\n\t\t\tTEventPublisher\n\t\t>,\n\t\t/**\n\t\t * The name of the {@link Topic} this subscriber binds to (via\n\t\t * `s.topic(topic)`), recorded for the manifest so infra wires the SNS\n\t\t * subscription. Undefined when the subscriber's events are typed from a\n\t\t * (hand-written) publisher instead.\n\t\t */\n\t\tpublic readonly topicName?: string,\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Subscriber,\n\t\t\tlogger,\n\t\t\tservices,\n\t\t\t[],\n\t\t\tpublisherService,\n\t\t\toutputSchema,\n\t\t);\n\t}\n\n\tget subscribedEvents(): TSubscribedEvents | undefined {\n\t\treturn this._subscribedEvents;\n\t}\n}\n\n// Handler type for subscribers that receives an array of events\nexport type SubscriberHandler<\n\tTEventPublisher extends EventPublisher<any> | undefined,\n\tTSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n> = (\n\tctx: SubscriberContext<\n\t\tTEventPublisher,\n\t\tTSubscribedEvents,\n\t\tTServices,\n\t\tTLogger\n\t>,\n) => OutSchema extends StandardSchemaV1\n\t? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>>\n\t: any | Promise<any>;\n\n// Context type for subscriber handlers\nexport type SubscriberContext<\n\tTEventPublisher extends EventPublisher<any> | undefined,\n\tTSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = {\n\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n};\n","import type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Topic, TopicEvents, TopicMessage } from '../topic/Topic';\nimport { Subscriber, type SubscriberHandler } from './Subscriber';\n\nexport class SubscriberBuilder<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends any[] = [],\n> {\n\tprivate _subscribedEvents: TSubscribedEvents = [] as any;\n\tprivate _timeout?: number;\n\tprivate outputSchema?: OutSchema;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\tprivate _logger: TLogger = DEFAULT_LOGGER;\n\tprivate _publisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\tprivate _topicName?: string;\n\n\tconstructor() {\n\t\tthis._timeout = 30000; // Default timeout\n\t}\n\n\t/**\n\t * Bind this subscriber to a {@link Topic} — the preferred way to type and wire\n\t * a fan-out consumer. It supplies the subscribable event types (and their\n\t * payloads) from the topic's contract and records the binding for the manifest,\n\t * so infra wires the SNS subscription.\n\t *\n\t * Prefer this over typing via a hand-written publisher service: a consumer does\n\t * not publish, so binding a topic does *not* require the topic's publisher\n\t * connection string (least privilege). Use `.publisher(...)` only when the\n\t * subscriber actually publishes follow-up events.\n\t */\n\ttopic<TName extends string, TEvents extends TopicEvents>(\n\t\ttopic: Topic<TName, TEvents>,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tEventPublisher<TopicMessage<TEvents>>,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tthis._topicName = topic.name;\n\t\treturn this as unknown as SubscriberBuilder<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tEventPublisher<TopicMessage<TEvents>>,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\tthis._timeout = timeout;\n\t\treturn this;\n\t}\n\n\toutput<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tthis.outputSchema = schema as unknown as OutSchema;\n\t\treturn this as any;\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): SubscriberBuilder<\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tthis._services = [...this._services, ...services] as any;\n\t\treturn this as any;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tthis._logger = logger as unknown as TLogger;\n\t\treturn this as any;\n\t}\n\n\tpublisher<T extends EventPublisher<any>, TName extends string>(\n\t\tpublisher: Service<TName, T>,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tT,\n\t\tTName,\n\t\tTSubscribedEvents\n\t> {\n\t\tthis._publisher = publisher as any;\n\t\treturn this as any;\n\t}\n\n\tsubscribe<\n\t\tTEvent extends TEventPublisher extends EventPublisher<any>\n\t\t\t?\n\t\t\t\t\t| ExtractPublisherMessage<TEventPublisher>['type']\n\t\t\t\t\t| ExtractPublisherMessage<TEventPublisher>['type'][]\n\t\t\t: never,\n\t>(\n\t\tevent: TEvent,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTEvent extends any[]\n\t\t\t? [...TSubscribedEvents, ...TEvent]\n\t\t\t: [...TSubscribedEvents, TEvent]\n\t> {\n\t\tconst eventsToAdd = Array.isArray(event) ? event : [event];\n\t\tthis._subscribedEvents = [...this._subscribedEvents, ...eventsToAdd] as any;\n\t\treturn this as any;\n\t}\n\n\thandle(\n\t\tfn: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>,\n\t): Subscriber<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tconst subscriber = new Subscriber(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._subscribedEvents,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._publisher,\n\t\t\tthis._topicName,\n\t\t);\n\n\t\t// Reset builder state after creating the subscriber to prevent pollution\n\t\tthis._services = [] as Service[] as TServices;\n\t\tthis._logger = DEFAULT_LOGGER;\n\t\tthis._publisher = undefined;\n\t\tthis._topicName = undefined;\n\t\tthis._subscribedEvents = [] as any;\n\t\tthis._timeout = 30000; // Reset to default\n\t\tthis.outputSchema = undefined;\n\n\t\treturn subscriber;\n\t}\n}\n","import { SubscriberBuilder } from './SubscriberBuilder';\n\nexport { Subscriber } from './Subscriber';\nexport { SubscriberBuilder };\n\nexport const s = new SubscriberBuilder();\n"],"mappings":";;;;AAWA,MAAMA,mBAAiB,IAAIC;AAU3B,IAAa,aAAb,cAQUC,4BAMR;CACD,oBAAoB;CAEpB,OAAO,aACNC,KACkD;AAClD,SAAO,QACN,OACC,IAAI,sBAAsB,QAC1B,IAAI,SAASC,gCAAc,WAC5B;CACD;CAED,YACiBC,SAOSC,UAAkB,KACjCC,mBACeC,cACAC,WAAsB,CAAE,GACxBC,SAAkBV,kBAClBW,kBAUTC,WACf;AACD,QACCR,gCAAc,YACd,QACA,UACA,CAAE,GACF,kBACA,aACA;EA/Be;EAOS;EACf;EACe;EACA;EACA;EACA;EAUT;CAUhB;CAED,IAAI,mBAAkD;AACrD,SAAO,KAAK;CACZ;AACD;;;;AC3ED,IAAa,oBAAb,MAOE;CACD,AAAQ,oBAAuC,CAAE;CACjD,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmBS;CAC3B,AAAQ;CACR,AAAQ;CAER,cAAc;AACb,OAAK,WAAW;CAChB;;;;;;;;;;;;CAaD,MACCC,OAQC;AACD,OAAK,aAAa,MAAM;AACxB,SAAO;CAQP;CAED,QAAQC,SAAuB;AAC9B,OAAK,WAAW;AAChB,SAAO;CACP;CAED,OACCC,QAQC;AACD,OAAK,eAAe;AACpB,SAAO;CACP;CAED,SACCC,UAQC;AACD,OAAK,YAAY,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS;AACjD,SAAO;CACP;CAED,OACCC,QAQC;AACD,OAAK,UAAU;AACf,SAAO;CACP;CAED,UACCC,WAQC;AACD,OAAK,aAAa;AAClB,SAAO;CACP;CAED,UAOCC,OAUC;EACD,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,KAAM;AAC1D,OAAK,oBAAoB,CAAC,GAAG,KAAK,mBAAmB,GAAG,WAAY;AACpE,SAAO;CACP;CAED,OACCC,IAcC;EACD,MAAM,aAAa,IAAI,WACtB,IACA,KAAK,UACL,KAAK,mBACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK;AAIN,OAAK,YAAY,CAAE;AACnB,OAAK,UAAUR;AACf,OAAK;AACL,OAAK;AACL,OAAK,oBAAoB,CAAE;AAC3B,OAAK,WAAW;AAChB,OAAK;AAEL,SAAO;CACP;AACD;;;;ACpLD,MAAa,IAAI,IAAI"}
+{"version":3,"file":"index.cjs","names":["Construct","obj: any","ConstructType","handler: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>","timeout: number","_subscribedEvents?: TSubscribedEvents","outputSchema?: OutSchema","services: TServices","logger: TLogger","DEFAULT_LOGGER","publisherService?: Service<\n\t\t\tTEventPublisherServiceName,\n\t\t\tTEventPublisher\n\t\t>","topicName?: string","constructs: string[]","DEFAULT_LOGGER","topic: Topic<TName, TEvents>","timeout: number","schema: T","constructs: T","services: T","logger: T","publisher: Service<TName, T>","event: TEvent","fn: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>"],"sources":["../../src/subscribers/Subscriber.ts","../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":["import type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\n// Helper type to extract payload types for subscribed events\ntype ExtractEventPayloads<\n\tTPublisher extends EventPublisher<any> | undefined,\n\tTEventTypes extends any[],\n> = TPublisher extends EventPublisher<any>\n\t? Extract<ExtractPublisherMessage<TPublisher>, { type: TEventTypes[number] }>\n\t: never;\n\nexport class Subscriber<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends\n\t\tExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][],\n> extends Construct<\n\tTLogger,\n\tTEventPublisherServiceName,\n\tTEventPublisher,\n\tOutSchema,\n\tTServices\n> {\n\t__IS_SUBSCRIBER__ = true;\n\n\tstatic isSubscriber(\n\t\tobj: any,\n\t): obj is Subscriber<any, any, any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\tobj.__IS_SUBSCRIBER__ === true &&\n\t\t\t\tobj.type === ConstructType.Subscriber,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tpublic readonly handler: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>,\n\t\tpublic override readonly timeout: number = 30000,\n\t\tprotected _subscribedEvents?: TSubscribedEvents,\n\t\tpublic override readonly outputSchema?: OutSchema,\n\t\tpublic override readonly services: TServices = [] as unknown as TServices,\n\t\tpublic override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,\n\t\tpublic override readonly publisherService?: Service<\n\t\t\tTEventPublisherServiceName,\n\t\t\tTEventPublisher\n\t\t>,\n\t\t/**\n\t\t * The name of the {@link Topic} this subscriber binds to (via\n\t\t * `s.topic(topic)`), recorded for the manifest so infra wires the SNS\n\t\t * subscription. Undefined when the subscriber's events are typed from a\n\t\t * (hand-written) publisher instead.\n\t\t */\n\t\tpublic readonly topicName?: string,\n\t\t/**\n\t\t * The construct ids `.dependsOn()` named — last, so no existing positional\n\t\t * argument moves.\n\t\t */\n\t\tconstructs: string[] = [],\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Subscriber,\n\t\t\tlogger,\n\t\t\tservices,\n\t\t\t[],\n\t\t\tpublisherService,\n\t\t\toutputSchema,\n\t\t\ttimeout,\n\t\t\tundefined, // memorySize\n\t\t\tundefined, // auditorStorageService\n\t\t\tconstructs,\n\t\t);\n\t}\n\n\tget subscribedEvents(): TSubscribedEvents | undefined {\n\t\treturn this._subscribedEvents;\n\t}\n}\n\n// Handler type for subscribers that receives an array of events\nexport type SubscriberHandler<\n\tTEventPublisher extends EventPublisher<any> | undefined,\n\tTSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n> = (\n\tctx: SubscriberContext<\n\t\tTEventPublisher,\n\t\tTSubscribedEvents,\n\t\tTServices,\n\t\tTLogger\n\t>,\n) => OutSchema extends StandardSchemaV1\n\t? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>>\n\t: any | Promise<any>;\n\n// Context type for subscriber handlers\nexport type SubscriberContext<\n\tTEventPublisher extends EventPublisher<any> | undefined,\n\tTSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = {\n\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n};\n","import type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tservicesOf,\n} from '../construct-interface';\nimport type { Topic, TopicEvents, TopicMessage } from '../topic/Topic';\nimport { Subscriber, type SubscriberHandler } from './Subscriber';\n\nexport class SubscriberBuilder<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends any[] = [],\n> {\n\tprivate _subscribedEvents: TSubscribedEvents = [] as any;\n\tprivate _timeout?: number;\n\tprivate outputSchema?: OutSchema;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\t/** The construct ids `.dependsOn()` named — what the manifest records. */\n\tpublic _constructs: string[] = [];\n\tprivate _logger: TLogger = DEFAULT_LOGGER;\n\tprivate _publisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\tprivate _topicName?: string;\n\n\tconstructor() {\n\t\tthis._timeout = 30000; // Default timeout\n\t}\n\n\t/**\n\t * Bind this subscriber to a {@link Topic} — the preferred way to type and wire\n\t * a fan-out consumer. It supplies the subscribable event types (and their\n\t * payloads) from the topic's contract and records the binding for the manifest,\n\t * so infra wires the SNS subscription.\n\t *\n\t * Prefer this over typing via a hand-written publisher service: a consumer does\n\t * not publish, so binding a topic does *not* require the topic's publisher\n\t * connection string (least privilege). Use `.publisher(...)` only when the\n\t * subscriber actually publishes follow-up events.\n\t */\n\ttopic<TName extends string, TEvents extends TopicEvents>(\n\t\ttopic: Topic<TName, TEvents>,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tEventPublisher<TopicMessage<TEvents>>,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_topicName: topic.name,\n\t\t}) as unknown as SubscriberBuilder<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tEventPublisher<TopicMessage<TEvents>>,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\toutput<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as any;\n\t}\n\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\tdependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): SubscriberBuilder<\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\t// Both halves of the edge, from one call and one clone: the services the\n\t\t// handler runs with, and the ids the manifest records. Recording them\n\t\t// separately is what let them drift apart.\n\t\t//\n\t\t// `servicesOf` is the half that validates, so it runs first — recording\n\t\t// ids ahead of it left a caught `NotAConstruct` with `undefined` already\n\t\t// on a `string[]`.\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services],\n\t\t\t_constructs: idsOf(constructs, this._constructs),\n\t\t}) as unknown as SubscriberBuilder<\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>;\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): SubscriberBuilder<\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as any,\n\t\t}) as any;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, { _logger: logger as unknown as TLogger }) as any;\n\t}\n\n\tpublisher<T extends EventPublisher<any>, TName extends string>(\n\t\tpublisher: Service<TName, T>,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tT,\n\t\tTName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, { _publisher: publisher as any }) as any;\n\t}\n\n\tsubscribe<\n\t\tTEvent extends TEventPublisher extends EventPublisher<any>\n\t\t\t?\n\t\t\t\t\t| ExtractPublisherMessage<TEventPublisher>['type']\n\t\t\t\t\t| ExtractPublisherMessage<TEventPublisher>['type'][]\n\t\t\t: never,\n\t>(\n\t\tevent: TEvent,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTEvent extends any[]\n\t\t\t? [...TSubscribedEvents, ...TEvent]\n\t\t\t: [...TSubscribedEvents, TEvent]\n\t> {\n\t\tconst eventsToAdd = Array.isArray(event) ? event : [event];\n\t\treturn cloneWith(this, {\n\t\t\t_subscribedEvents: [...this._subscribedEvents, ...eventsToAdd] as any,\n\t\t}) as any;\n\t}\n\n\thandle(\n\t\tfn: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>,\n\t): Subscriber<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tconst subscriber = new Subscriber(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._subscribedEvents,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._publisher,\n\t\t\tthis._topicName,\n\t\t\tthis._constructs,\n\t\t);\n\n\t\t// No reset: `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base stays usable for the next subscriber.\n\t\treturn subscriber;\n\t}\n}\n","import { SubscriberBuilder } from './SubscriberBuilder';\n\nexport { Subscriber } from './Subscriber';\nexport { SubscriberBuilder };\n\nexport const s = new SubscriberBuilder();\n"],"mappings":";;;;;;;AAmBA,IAAa,aAAb,cAQUA,4BAMR;CACD,oBAAoB;CAEpB,OAAO,aACNC,KACkD;AAClD,SAAO,QACN,OACC,IAAI,sBAAsB,QAC1B,IAAI,SAASC,gCAAc,WAC5B;CACD;CAED,YACiBC,SAOSC,UAAkB,KACjCC,mBACeC,cACAC,WAAsB,CAAE,GACxBC,SAAkBC,2CAClBC,kBAUTC,WAKhBC,aAAuB,CAAE,GACxB;AACD,QACCV,gCAAc,YACd,QACA,UACA,CAAE,GACF,kBACA,cACA,yBAGA,WACA;EAxCe;EAOS;EACf;EACe;EACA;EACA;EACA;EAUT;CAmBhB;CAED,IAAI,mBAAkD;AACrD,SAAO,KAAK;CACZ;AACD;;;;AC3ED,IAAa,oBAAb,MAOE;CACD,AAAQ,oBAAuC,CAAE;CACjD,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;;CAEjC,AAAO,cAAwB,CAAE;CACjC,AAAQ,UAAmBW;CAC3B,AAAQ;CACR,AAAQ;CAER,cAAc;AACb,OAAK,WAAW;CAChB;;;;;;;;;;;;CAaD,MACCC,OAQC;AACD,SAAO,wBAAU,MAAM,EACtB,YAAY,MAAM,KAClB,EAAC;CAQF;CAED,QAAQC,SAAuB;AAC9B,SAAO,wBAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;CAED,OACCC,QAQC;AACD,SAAO,wBAAU,MAAM,EACtB,cAAc,OACd,EAAC;CACF;;;;;;;;;;;;CAaD,UACCC,YAQC;EAQD,MAAM,WAAW,uCAAW,WAAW;AAEvC,SAAO,wBAAU,MAAM;GACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS;GAC3C,aAAa,kCAAM,YAAY,KAAK,YAAY;EAChD,EAAC;CAQF;CAED,SACCC,UAQC;AACD,SAAO,wBAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CACF;CAED,OACCC,QAQC;AACD,SAAO,wBAAU,MAAM,EAAE,SAAS,OAA8B,EAAC;CACjE;CAED,UACCC,WAQC;AACD,SAAO,wBAAU,MAAM,EAAE,YAAY,UAAkB,EAAC;CACxD;CAED,UAOCC,OAUC;EACD,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,KAAM;AAC1D,SAAO,wBAAU,MAAM,EACtB,mBAAmB,CAAC,GAAG,KAAK,mBAAmB,GAAG,WAAY,EAC9D,EAAC;CACF;CAED,OACCC,IAcC;EACD,MAAM,aAAa,IAAI,WACtB,IACA,KAAK,UACL,KAAK,mBACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,YACL,KAAK;AAKN,SAAO;CACP;AACD;;;;ACnOD,MAAa,IAAI,IAAI"}

package/dist/subscribers/index.d.cts

@@ -1,8 +1,9 @@
-import "../Construct-_1wX7p_Y.cjs";
-import { Subscriber, SubscriberHandler } from "../Subscriber-B69ngPwl.cjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-C5ZMfveW.cjs";
+import "../Construct-WhCXIOPV.cjs";
+import { Consumable, ServicesOf } from "../construct-interface-D2nNkHUN.cjs";
+import { Subscriber, SubscriberHandler } from "../Subscriber-DVQowdyj.cjs";
+import { Topic, TopicEvents, TopicMessage } from "../Topic-Ohx9dvWr.cjs";
 import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
-import * as _geekmidas_logger10 from "@geekmidas/logger";
+import * as _geekmidas_logger19 from "@geekmidas/logger";
 import { Logger } from "@geekmidas/logger";
 import { Service } from "@geekmidas/services";
 import { StandardSchemaV1 } from "@standard-schema/spec";
@@ -13,6 +14,8 @@ declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extend
   private _timeout?;
   private outputSchema?;
   private _services;
+  /** The construct ids `.dependsOn()` named — what the manifest records. */
+  _constructs: string[];
   private _logger;
   private _publisher?;
   private _topicName?;
@@ -31,6 +34,18 @@ declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extend
   topic<TName extends string, TEvents extends TopicEvents>(topic: Topic<TName, TEvents>): SubscriberBuilder<TServices, TLogger, OutSchema, EventPublisher<TopicMessage<TEvents>>, TEventPublisherServiceName, TSubscribedEvents>;
   timeout(timeout: number): this;
   output<T extends StandardSchemaV1>(schema: T): SubscriberBuilder<TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): SubscriberBuilder<[...TServices, ...ServicesOf<T>], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
   services<T extends Service[]>(services: T): SubscriberBuilder<[...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
   logger<T extends Logger>(logger: T): SubscriberBuilder<TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
   publisher<T extends EventPublisher<any>, TName extends string>(publisher: Service<TName, T>): SubscriberBuilder<TServices, TLogger, OutSchema, T, TName, TSubscribedEvents>;
@@ -40,7 +55,7 @@ declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extend
 //# sourceMappingURL=SubscriberBuilder.d.ts.map
 //#endregion
 //#region src/subscribers/index.d.ts
-declare const s: SubscriberBuilder<[], _geekmidas_logger10.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger19.Logger, undefined, undefined, string, []>;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion

package/dist/subscribers/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAWa,oCACM,gCACF,SAAS,0BACP,kEACM;;;;EAJZ,QAAA,SAAA;EAAiB,QAAA,OAAA;EAAA,QACX,UAAA;EAAO,QACT,UAAA;EAAM,WAAG,CAAA;EAAM;;;;;;;;;;;EAmCH,KAA3B,CAAA,cAAA,MAAA,EAAA,gBAN2C,WAM3C,CAAA,CAAA,KAAA,EALO,KAKP,CALa,KAKb,EALoB,OAKpB,CAAA,CAAA,EAJE,iBAIF,CAHA,SAGA,EAFA,OAEA,EADA,SACA,EAAA,cAAA,CAAe,YAAf,CAA4B,OAA5B,CAAA,CAAA,EACA,0BADA,EAEA,iBAFA,CAAA;EAAc,OACd,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAA0B,MAC1B,CAAA,UAkBgB,gBAlBhB,CAAA,CAAA,MAAA,EAmBQ,CAnBR,CAAA,EAoBE,iBApBF,CAqBA,SArBA,EAsBA,OAtBA,EAuBA,CAvBA,EAwBA,eAxBA,EAyBA,0BAzBA,EA0BA,iBA1BA,CAAA;EAAiB,QANf,CAAA,UAsCgB,OAtChB,EAAA,CAAA,CAAA,QAAA,EAuCQ,CAvCR,CAAA,EAwCA,iBAxCA,CAAA,CAwBc,GAiBZ,SAjBY,EACR,GAgBU,CAhBV,CAAC,EAiBT,OAfA,EAgBA,SAhBA,EAiBA,eAjBA,EAkBA,0BAlBA,EAmBA,iBAnBA,CAAA;EAAS,MACT,CAAA,UAwBgB,MAxBhB,CAAA,CAAA,MAAA,EAyBQ,CAzBR,CAAA,EA0BE,iBA1BF,CA2BA,SA3BA,EA4BA,CA5BA,EA6BA,SA7BA,EA8BA,eA9BA,EA+BA,0BA/BA,EAgCA,iBAhCA,CAAA;EAAO,SACP,CAAA,UAqCmB,cArCnB,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAsCW,OAtCX,CAsCmB,KAtCnB,EAsC0B,CAtC1B,CAAA,CAAA,EAuCE,iBAvCF,CAwCA,SAxCA,EAyCA,OAzCA,EA0CA,SA1CA,EA2CA,CA3CA,EA4CA,KA5CA,EA6CA,iBA7CA,CAAA;EAAC,SACD,CAAA,gBAmDe,eAnDf,SAmDuC,cAnDvC,CAAA,GAAA,CAAA,GAqDK,uBArDL,CAqD6B,eArD7B,CAAA,CAAA,MAAA,CAAA,GAsDK,uBAtDL,CAsD6B,eAtD7B,CAAA,CAAA,MAAA,CAAA,EAAA,GAAA,KAAA,EAAA,CAAA,KAAA,EAyDO,MAzDP,CAAA,EA0DE,iBA1DF,CA2DA,SA3DA,EA4DA,OA5DA,EA6DA,SA7DA,EA8DA,eA9DA,EA+DA,0BA/DA,EAgEA,MAhEA,SAAA,GAAA,EAAA,GAAA,CAAA,GAiEO,iBAjEP,EAAA,GAiE6B,MAjE7B,CAAA,GAAA,CAAA,GAkEO,iBAlEP,EAkE0B,MAlE1B,CAAA,CAAA;EAAe,MACf,CAAA,EAAA,EAyEI,iBAzEJ,CA0EC,eA1ED,EA2EC,iBA3ED,EA4EC,SA5ED,EA6EC,OA7ED,EA8EC,SA9ED,CAAA,CAAA,EAgFE,UAhFF,CAiFA,SAjFA,EAkFA,OAlFA,EAmFA,SAnFA,EAoFA,eApFA,EAqFA,0BArFA,EAsFA,iBAtFA,CAAA;;;;;cCtEW,GAAC,sBAA0B,mBAAA,CAA1B,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/subscribers/index.d.mts

@@ -1,17 +1,21 @@
-import "../Construct-DCMuYOox.mjs";
-import { Subscriber, SubscriberHandler } from "../Subscriber-D8Xm-86W.mjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-DT10AqHk.mjs";
+import "../Construct-B-xc0SE9.mjs";
+import { Consumable, ServicesOf } from "../construct-interface-BqwRNYA2.mjs";
+import { Subscriber, SubscriberHandler } from "../Subscriber-4rBJgDKI.mjs";
+import { Topic, TopicEvents, TopicMessage } from "../Topic-cmy2jOUy.mjs";
 import { Service } from "@geekmidas/services";
 import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
-import { Logger as Logger$1 } from "@geekmidas/logger";
+import * as _geekmidas_logger16 from "@geekmidas/logger";
+import { Logger } from "@geekmidas/logger";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/subscribers/SubscriberBuilder.d.ts
-declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extends Logger$1 = Logger$1, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TSubscribedEvents extends any[] = []> {
+declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TSubscribedEvents extends any[] = []> {
   private _subscribedEvents;
   private _timeout?;
   private outputSchema?;
   private _services;
+  /** The construct ids `.dependsOn()` named — what the manifest records. */
+  _constructs: string[];
   private _logger;
   private _publisher?;
   private _topicName?;
@@ -30,8 +34,20 @@ declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extend
   topic<TName extends string, TEvents extends TopicEvents>(topic: Topic<TName, TEvents>): SubscriberBuilder<TServices, TLogger, OutSchema, EventPublisher<TopicMessage<TEvents>>, TEventPublisherServiceName, TSubscribedEvents>;
   timeout(timeout: number): this;
   output<T extends StandardSchemaV1>(schema: T): SubscriberBuilder<TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): SubscriberBuilder<[...TServices, ...ServicesOf<T>], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
   services<T extends Service[]>(services: T): SubscriberBuilder<[...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  logger<T extends Logger$1>(logger: T): SubscriberBuilder<TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
+  logger<T extends Logger>(logger: T): SubscriberBuilder<TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
   publisher<T extends EventPublisher<any>, TName extends string>(publisher: Service<TName, T>): SubscriberBuilder<TServices, TLogger, OutSchema, T, TName, TSubscribedEvents>;
   subscribe<TEvent extends (TEventPublisher extends EventPublisher<any> ? ExtractPublisherMessage<TEventPublisher>['type'] | ExtractPublisherMessage<TEventPublisher>['type'][] : never)>(event: TEvent): SubscriberBuilder<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TEvent extends any[] ? [...TSubscribedEvents, ...TEvent] : [...TSubscribedEvents, TEvent]>;
   handle(fn: SubscriberHandler<TEventPublisher, TSubscribedEvents, TServices, TLogger, OutSchema>): Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
@@ -39,7 +55,7 @@ declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extend
 //# sourceMappingURL=SubscriberBuilder.d.ts.map
 //#endregion
 //#region src/subscribers/index.d.ts
-declare const s: SubscriberBuilder<[], Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger16.Logger, undefined, undefined, string, []>;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion

package/dist/subscribers/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAWa,oCACM,gCACF,WAAS,4BACP,kEACM;;;EAJZ,QAAA,YAAiB;EAAA,QAAA,SAAA;EAAA,QACX,OAAA;EAAO,QACT,UAAA;EAAM,QAAG,UAAA;EAAM,WACb,CAAA;EAAgB;;;;;;;;;;;EAkCnB,KACd,CAAA,cAAA,MAAA,EAAA,gBAP2C,WAO3C,CAAA,CAAA,KAAA,EANO,KAMP,CANa,KAMb,EANoB,OAMpB,CAAA,CAAA,EALE,iBAKF,CAJA,SAIA,EAHA,OAGA,EAFA,SAEA,EADA,cACA,CADe,YACf,CAD4B,OAC5B,CAAA,CAAA,EAAA,0BAAA,EACA,iBADA,CAAA;EAA0B,OAC1B,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAiB,MANf,CAAA,UAwBc,gBAxBd,CAAA,CAAA,MAAA,EAyBM,CAzBN,CAAA,EA0BA,iBA1BA,CA2BF,SA3BE,EA4BF,OA5BE,EA6BF,CA7BE,EA8BF,eA9BE,EA+BF,0BA/BE,EAgCF,iBAhCE,CAAA;EAAiB,QAwBH,CAAA,UAcE,OAdF,EAAA,CAAA,CAAA,QAAA,EAeN,CAfM,CAAA,EAgBd,iBAhBc,CAAA,CACR,GAgBJ,SAhBI,EAER,GAckB,CAdlB,CAAS,EAeT,OAdA,EAeA,SAfA,EAgBA,eAhBA,EAiBA,0BAjBA,EAkBA,iBAlBA,CAAA;EAAO,MACP,CAAA,UAuBgB,QAvBhB,CAAA,CAAA,MAAA,EAwBQ,CAxBR,CAAA,EAyBE,iBAzBF,CA0BA,SA1BA,EA2BA,CA3BA,EA4BA,SA5BA,EA6BA,eA7BA,EA8BA,0BA9BA,EA+BA,iBA/BA,CAAA;EAAC,SACD,CAAA,UAoCmB,cApCnB,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAqCW,OArCX,CAqCmB,KArCnB,EAqC0B,CArC1B,CAAA,CAAA,EAsCE,iBAtCF,CAuCA,SAvCA,EAwCA,OAxCA,EAyCA,SAzCA,EA0CA,CA1CA,EA2CA,KA3CA,EA4CA,iBA5CA,CAAA;EAAe,SACf,CAAA,gBAkDe,eAlDf,SAkDuC,cAlDvC,CAAA,GAAA,CAAA,GAoDK,uBApDL,CAoD6B,eApD7B,CAAA,CAAA,MAAA,CAAA,GAqDK,uBArDL,CAqD6B,eArD7B,CAAA,CAAA,MAAA,CAAA,EAAA,GAAA,KAAA,EAAA,CAAA,KAAA,EAwDO,MAxDP,CAAA,EAyDE,iBAzDF,CA0DA,SA1DA,EA2DA,OA3DA,EA4DA,SA5DA,EA6DA,eA7DA,EA8DA,0BA9DA,EA+DA,MA/DA,SAAA,GAAA,EAAA,GAAA,CAAA,GAgEO,iBAhEP,EAAA,GAgE6B,MAhE7B,CAAA,GAAA,CAAA,GAiEO,iBAjEP,EAiE0B,MAjE1B,CAAA,CAAA;EAA0B,MAC1B,CAAA,EAAA,EAwEI,iBAxEJ,CAyEC,eAzED,EA0EC,iBA1ED,EA2EC,SA3ED,EA4EC,OA5ED,EA6EC,SA7ED,CAAA,CAAA,EA+EE,UA/EF,CAgFA,SAhFA,EAiFA,OAjFA,EAkFA,SAlFA,EAmFA,eAnFA,EAoFA,0BApFA,EAqFA,iBArFA,CAAA;;;;;cCvEW,GAAC,sBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/subscribers/index.mjs

@@ -1,15 +1,16 @@
-import { Construct, ConstructType } from "../Construct-r0U2zBwW.mjs";
-import { ConsoleLogger, DEFAULT_LOGGER } from "@geekmidas/logger/console";
+import { Construct, ConstructType } from "../Construct-HmWM6YYu.mjs";
+import { idsOf, servicesOf } from "../construct-interface-Z4CpS8tK.mjs";
+import { cloneWith } from "../clone-DblgEZZa.mjs";
+import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
 
 //#region src/subscribers/Subscriber.ts
-const DEFAULT_LOGGER$1 = new ConsoleLogger();
 var Subscriber = class extends Construct {
 	__IS_SUBSCRIBER__ = true;
 	static isSubscriber(obj) {
 		return Boolean(obj && obj.__IS_SUBSCRIBER__ === true && obj.type === ConstructType.Subscriber);
 	}
-	constructor(handler, timeout = 3e4, _subscribedEvents, outputSchema, services = [], logger = DEFAULT_LOGGER$1, publisherService, topicName) {
-		super(ConstructType.Subscriber, logger, services, [], publisherService, outputSchema);
+	constructor(handler, timeout = 3e4, _subscribedEvents, outputSchema, services = [], logger = DEFAULT_LOGGER, publisherService, topicName, constructs = []) {
+		super(ConstructType.Subscriber, logger, services, [], publisherService, outputSchema, timeout, void 0, void 0, constructs);
 		this.handler = handler;
 		this.timeout = timeout;
 		this._subscribedEvents = _subscribedEvents;
@@ -31,6 +32,8 @@ var SubscriberBuilder = class {
 	_timeout;
 	outputSchema;
 	_services = [];
+	/** The construct ids `.dependsOn()` named — what the manifest records. */
+	_constructs = [];
 	_logger = DEFAULT_LOGGER;
 	_publisher;
 	_topicName;
@@ -49,43 +52,47 @@ var SubscriberBuilder = class {
 	* subscriber actually publishes follow-up events.
 	*/
 	topic(topic) {
-		this._topicName = topic.name;
-		return this;
+		return cloneWith(this, { _topicName: topic.name });
 	}
 	timeout(timeout) {
-		this._timeout = timeout;
-		return this;
+		return cloneWith(this, { _timeout: timeout });
 	}
 	output(schema) {
-		this.outputSchema = schema;
-		return this;
+		return cloneWith(this, { outputSchema: schema });
+	}
+	/**
+	* Depend on constructs — a database, a bucket, a mail sender, a queue, a
+	* topic.
+	*
+	* It records the edge and dissolves each construct's client into the
+	* handler's service record under the construct's own id, so
+	* `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+	*
+	* Constructs only. A `Service` does not match the shape, which is what keeps
+	* env sniffing confined to `.services()` and the explicit lift.
+	*/
+	dependsOn(constructs) {
+		const services = servicesOf(constructs);
+		return cloneWith(this, {
+			_services: [...this._services, ...services],
+			_constructs: idsOf(constructs, this._constructs)
+		});
 	}
 	services(services) {
-		this._services = [...this._services, ...services];
-		return this;
+		return cloneWith(this, { _services: [...this._services, ...services] });
 	}
 	logger(logger) {
-		this._logger = logger;
-		return this;
+		return cloneWith(this, { _logger: logger });
 	}
 	publisher(publisher) {
-		this._publisher = publisher;
-		return this;
+		return cloneWith(this, { _publisher: publisher });
 	}
 	subscribe(event) {
 		const eventsToAdd = Array.isArray(event) ? event : [event];
-		this._subscribedEvents = [...this._subscribedEvents, ...eventsToAdd];
-		return this;
+		return cloneWith(this, { _subscribedEvents: [...this._subscribedEvents, ...eventsToAdd] });
 	}
 	handle(fn) {
-		const subscriber = new Subscriber(fn, this._timeout, this._subscribedEvents, this.outputSchema, this._services, this._logger, this._publisher, this._topicName);
-		this._services = [];
-		this._logger = DEFAULT_LOGGER;
-		this._publisher = void 0;
-		this._topicName = void 0;
-		this._subscribedEvents = [];
-		this._timeout = 3e4;
-		this.outputSchema = void 0;
+		const subscriber = new Subscriber(fn, this._timeout, this._subscribedEvents, this.outputSchema, this._services, this._logger, this._publisher, this._topicName, this._constructs);
 		return subscriber;
 	}
 };