@geekmidas/constructs 10.0.0-alpha.0 → 10.0.0-alpha.2

package/dist/SubscriberBuilder-4OPehf2R.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriberBuilder-4OPehf2R.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"],"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\t/**\n\t * The deploy unit that runs this, by construct id. Seeded by the factory a\n\t * `Worker` hands out, so a subscriber is not owned by its directory.\n\t */\n\tpublic _owner?: string;\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// Which process runs it. Carried from the factory rather than inferred\n\t\t// from the directory the file happens to sit in.\n\t\tsubscriber.owner = this._owner;\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"],"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;;;;;CAK3B,AAAO;CACP,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,aAAW,QAAQ,KAAK;AAIxB,SAAO;CACP;AACD"}

package/dist/SubscriberBuilder-BjkbeT9l.mjs

@@ -0,0 +1,108 @@
+import { Construct, ConstructType } from "./Construct-BD5neF7w.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
+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, 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;
+		this.outputSchema = outputSchema;
+		this.services = services;
+		this.logger = logger;
+		this.publisherService = publisherService;
+		this.topicName = topicName;
+	}
+	get subscribedEvents() {
+		return this._subscribedEvents;
+	}
+};
+
+//#endregion
+//#region src/subscribers/SubscriberBuilder.ts
+var SubscriberBuilder = class {
+	_subscribedEvents = [];
+	_timeout;
+	outputSchema;
+	_services = [];
+	/** The construct ids `.dependsOn()` named — what the manifest records. */
+	_constructs = [];
+	_logger = DEFAULT_LOGGER;
+	/**
+	* The deploy unit that runs this, by construct id. Seeded by the factory a
+	* `Worker` hands out, so a subscriber is not owned by its directory.
+	*/
+	_owner;
+	_publisher;
+	_topicName;
+	constructor() {
+		this._timeout = 3e4;
+	}
+	/**
+	* Bind this subscriber to a {@link Topic} — the preferred way to type and wire
+	* a fan-out consumer. It supplies the subscribable event types (and their
+	* payloads) from the topic's contract and records the binding for the manifest,
+	* so infra wires the SNS subscription.
+	*
+	* Prefer this over typing via a hand-written publisher service: a consumer does
+	* not publish, so binding a topic does *not* require the topic's publisher
+	* connection string (least privilege). Use `.publisher(...)` only when the
+	* subscriber actually publishes follow-up events.
+	*/
+	topic(topic) {
+		return cloneWith(this, { _topicName: topic.name });
+	}
+	timeout(timeout) {
+		return cloneWith(this, { _timeout: timeout });
+	}
+	output(schema) {
+		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) {
+		return cloneWith(this, { _services: [...this._services, ...services] });
+	}
+	logger(logger) {
+		return cloneWith(this, { _logger: logger });
+	}
+	publisher(publisher) {
+		return cloneWith(this, { _publisher: publisher });
+	}
+	subscribe(event) {
+		const eventsToAdd = Array.isArray(event) ? event : [event];
+		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._constructs);
+		subscriber.owner = this._owner;
+		return subscriber;
+	}
+};
+
+//#endregion
+export { Subscriber, SubscriberBuilder };
+//# sourceMappingURL=SubscriberBuilder-BjkbeT9l.mjs.map

package/dist/SubscriberBuilder-BjkbeT9l.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriberBuilder-BjkbeT9l.mjs","names":["obj: any","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","constructs: string[]","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"],"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\t/**\n\t * The deploy unit that runs this, by construct id. Seeded by the factory a\n\t * `Worker` hands out, so a subscriber is not owned by its directory.\n\t */\n\tpublic _owner?: string;\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// Which process runs it. Carried from the factory rather than inferred\n\t\t// from the directory the file happens to sit in.\n\t\tsubscriber.owner = this._owner;\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"],"mappings":";;;;;;AAmBA,IAAa,aAAb,cAQU,UAMR;CACD,oBAAoB;CAEpB,OAAO,aACNA,KACkD;AAClD,SAAO,QACN,OACC,IAAI,sBAAsB,QAC1B,IAAI,SAAS,cAAc,WAC5B;CACD;CAED,YACiBC,SAOSC,UAAkB,KACjCC,mBACeC,cACAC,WAAsB,CAAE,GACxBC,SAAkB,gBAClBC,kBAUTC,WAKhBC,aAAuB,CAAE,GACxB;AACD,QACC,cAAc,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,UAAmB;;;;;CAK3B,AAAO;CACP,AAAQ;CACR,AAAQ;CAER,cAAc;AACb,OAAK,WAAW;CAChB;;;;;;;;;;;;CAaD,MACCC,OAQC;AACD,SAAO,UAAU,MAAM,EACtB,YAAY,MAAM,KAClB,EAAC;CAQF;CAED,QAAQC,SAAuB;AAC9B,SAAO,UAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;CAED,OACCC,QAQC;AACD,SAAO,UAAU,MAAM,EACtB,cAAc,OACd,EAAC;CACF;;;;;;;;;;;;CAaD,UACCC,YAQC;EAQD,MAAM,WAAW,WAAW,WAAW;AAEvC,SAAO,UAAU,MAAM;GACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS;GAC3C,aAAa,MAAM,YAAY,KAAK,YAAY;EAChD,EAAC;CAQF;CAED,SACCC,UAQC;AACD,SAAO,UAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CACF;CAED,OACCC,QAQC;AACD,SAAO,UAAU,MAAM,EAAE,SAAS,OAA8B,EAAC;CACjE;CAED,UACCC,WAQC;AACD,SAAO,UAAU,MAAM,EAAE,YAAY,UAAkB,EAAC;CACxD;CAED,UAOCC,OAUC;EACD,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,KAAM;AAC1D,SAAO,UAAU,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,aAAW,QAAQ,KAAK;AAIxB,SAAO;CACP;AACD"}

package/dist/SubscriberBuilder-Dptmo-1A.d.mts

@@ -0,0 +1,62 @@
+import { Consumable, ServicesOf } from "./construct-interface-g5GM5pwR.mjs";
+import { Subscriber, SubscriberHandler } from "./Subscriber-xTJ9ayPN.mjs";
+import { Topic, TopicEvents, TopicMessage } from "./Topic-DuFeqkBh.mjs";
+import { Service } from "@geekmidas/services";
+import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+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 = 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;
+  /**
+   * The deploy unit that runs this, by construct id. Seeded by the factory a
+   * `Worker` hands out, so a subscriber is not owned by its directory.
+   */
+  _owner?: string;
+  private _publisher?;
+  private _topicName?;
+  constructor();
+  /**
+   * Bind this subscriber to a {@link Topic} — the preferred way to type and wire
+   * a fan-out consumer. It supplies the subscribable event types (and their
+   * payloads) from the topic's contract and records the binding for the manifest,
+   * so infra wires the SNS subscription.
+   *
+   * Prefer this over typing via a hand-written publisher service: a consumer does
+   * not publish, so binding a topic does *not* require the topic's publisher
+   * connection string (least privilege). Use `.publisher(...)` only when the
+   * subscriber actually publishes follow-up events.
+   */
+  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>;
+  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>;
+}
+//# sourceMappingURL=SubscriberBuilder.d.ts.map
+
+//#endregion
+export { SubscriberBuilder };
+//# sourceMappingURL=SubscriberBuilder-Dptmo-1A.d.mts.map

package/dist/SubscriberBuilder-Dptmo-1A.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriberBuilder-Dptmo-1A.d.mts","names":[],"sources":["../src/subscribers/SubscriberBuilder.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/SubscriberBuilder-waNhzjSM.d.cts

@@ -0,0 +1,62 @@
+import { Consumable, ServicesOf } from "./construct-interface-D9d4Gm4p.cjs";
+import { Subscriber, SubscriberHandler } from "./Subscriber-2mEi0ImH.cjs";
+import { Topic, TopicEvents, TopicMessage } from "./Topic-19QeHBIR.cjs";
+import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import { Logger } from "@geekmidas/logger";
+import { Service } from "@geekmidas/services";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/subscribers/SubscriberBuilder.d.ts
+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;
+  /**
+   * The deploy unit that runs this, by construct id. Seeded by the factory a
+   * `Worker` hands out, so a subscriber is not owned by its directory.
+   */
+  _owner?: string;
+  private _publisher?;
+  private _topicName?;
+  constructor();
+  /**
+   * Bind this subscriber to a {@link Topic} — the preferred way to type and wire
+   * a fan-out consumer. It supplies the subscribable event types (and their
+   * payloads) from the topic's contract and records the binding for the manifest,
+   * so infra wires the SNS subscription.
+   *
+   * Prefer this over typing via a hand-written publisher service: a consumer does
+   * not publish, so binding a topic does *not* require the topic's publisher
+   * connection string (least privilege). Use `.publisher(...)` only when the
+   * subscriber actually publishes follow-up events.
+   */
+  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>;
+  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>;
+}
+//# sourceMappingURL=SubscriberBuilder.d.ts.map
+
+//#endregion
+export { SubscriberBuilder };
+//# sourceMappingURL=SubscriberBuilder-waNhzjSM.d.cts.map

package/dist/SubscriberBuilder-waNhzjSM.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriberBuilder-waNhzjSM.d.cts","names":[],"sources":["../src/subscribers/SubscriberBuilder.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{Topic-Ohx9dvWr.d.cts → Topic-19QeHBIR.d.cts}

@@ -1,4 +1,4 @@
-import { Construct } from "./Construct-WhCXIOPV.cjs";
+import { Construct } from "./Construct-C0ijr2qp.cjs";
 import { EventPublisher, PublishableMessage } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { InferStandardSchema } from "@geekmidas/schema";
@@ -88,4 +88,4 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
 //# sourceMappingURL=Topic.d.ts.map
 //#endregion
 export { Topic, TopicEvents, TopicMessage };
-//# sourceMappingURL=Topic-Ohx9dvWr.d.cts.map
+//# sourceMappingURL=Topic-19QeHBIR.d.cts.map

package/dist/{Topic-Ohx9dvWr.d.cts.map → Topic-19QeHBIR.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"Topic-Ohx9dvWr.d.cts","names":[],"sources":["../src/topic/Topic.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAoBY,WAAA,GAAc,eAAe;AAAzC;;;;AAAgC,KAMpB,YANoB,CAAA,gBAMS,WANT,CAAA,GAAA,QAMpB,MACC,OADW,GAAA,MAAA,GACQ,kBADR,CAEtB,CAFsB,EAGtB,mBAHsB,CAGF,OAHE,CAGM,CAHN,CAAA,CAAA,CAAA,EAAA,CAAA,MAKhB,OALgB,GAAA,MAAA,CAAA;;;;;;;;;AAKT;AAYf;AAAkB,cAAL,KAAK,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,gBAED,WAFC,GAEa,WAFb,CAAA,SAGR,SAAA,CAHQ;EAAA,SAED,IAAA,EA2BO,KA3BP;EAAW;;;;;EAIe,SAuBnB,YAAA,EAMQ,OANR;EAAK,YAMG,EAAA,OAAA;EAAO,OAC7B,OAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IA9B4B,KA8B5B,CAAA,MAAA,EA9B0C,WA8B1C,CAAA;EAAuB;;;;;;EA2DJ,SAA3B,EAAA,EAAA,MAAA;EAAc;;;;EAYa,iBAA3B,aAAA;EAAc,WAFE,CAAA,IAAA,EA5EM,KA4EN;EAAO;AAtGN;;;;gBAgCa,kBACtB;;;;;;;;aAeE;;2BAmBc;;;;;;;;;;;;;;;;;;;;iBAuBV,QACd,aAAa,QACb,eAAe,aAAa;mBAUZ,WACb,kBACH,eAAe,aAAa"}
+{"version":3,"file":"Topic-19QeHBIR.d.cts","names":[],"sources":["../src/topic/Topic.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAoBY,WAAA,GAAc,eAAe;AAAzC;;;;AAAgC,KAMpB,YANoB,CAAA,gBAMS,WANT,CAAA,GAAA,QAMpB,MACC,OADW,GAAA,MAAA,GACQ,kBADR,CAEtB,CAFsB,EAGtB,mBAHsB,CAGF,OAHE,CAGM,CAHN,CAAA,CAAA,CAAA,EAAA,CAAA,MAKhB,OALgB,GAAA,MAAA,CAAA;;;;;;;;;AAKT;AAYf;AAAkB,cAAL,KAAK,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,gBAED,WAFC,GAEa,WAFb,CAAA,SAGR,SAAA,CAHQ;EAAA,SAED,IAAA,EA2BO,KA3BP;EAAW;;;;;EAIe,SAuBnB,YAAA,EAMQ,OANR;EAAK,YAMG,EAAA,OAAA;EAAO,OAC7B,OAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IA9B4B,KA8B5B,CAAA,MAAA,EA9B0C,WA8B1C,CAAA;EAAuB;;;;;;EA2DJ,SAA3B,EAAA,EAAA,MAAA;EAAc;;;;EAYa,iBAA3B,aAAA;EAAc,WAFE,CAAA,IAAA,EA5EM,KA4EN;EAAO;AAtGN;;;;gBAgCa,kBACtB;;;;;;;;aAeE;;2BAmBc;;;;;;;;;;;;;;;;;;;;iBAuBV,QACd,aAAa,QACb,eAAe,aAAa;mBAUZ,WACb,kBACH,eAAe,aAAa"}

package/dist/{Topic-cmy2jOUy.d.mts → Topic-DuFeqkBh.d.mts}

@@ -1,4 +1,4 @@
-import { Construct } from "./Construct-B-xc0SE9.mjs";
+import { Construct } from "./Construct-Ct8nalEi.mjs";
 import { Declaration } from "@geekmidas/manifest";
 import { Service } from "@geekmidas/services";
 import { EventPublisher, PublishableMessage } from "@geekmidas/events";
@@ -88,4 +88,4 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
 //# sourceMappingURL=Topic.d.ts.map
 //#endregion
 export { Topic, TopicEvents, TopicMessage };
-//# sourceMappingURL=Topic-cmy2jOUy.d.mts.map
+//# sourceMappingURL=Topic-DuFeqkBh.d.mts.map

package/dist/{Topic-cmy2jOUy.d.mts.map → Topic-DuFeqkBh.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"Topic-cmy2jOUy.d.mts","names":[],"sources":["../src/topic/Topic.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAoBY,WAAA,GAAc,eAAe;AAAzC;;;;AAAgC,KAMpB,YANoB,CAAA,gBAMS,WANT,CAAA,GAAA,QAMpB,MACC,OADW,GAAA,MAAA,GACQ,kBADR,CAEtB,CAFsB,EAGtB,mBAHsB,CAGF,OAHE,CAGM,CAHN,CAAA,CAAA,CAAA,EAAA,CAAA,MAKhB,OALgB,GAAA,MAAA,CAAA;;;;;;;;;AAKT;AAYf;AAAkB,cAAL,KAAK,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,gBAED,WAFC,GAEa,WAFb,CAAA,SAGR,SAAA,CAHQ;EAAA,SAED,IAAA,EA2BO,KA3BP;EAAW;;;;;EAIe,SAuBnB,YAAA,EAMQ,OANR;EAAK,YAMG,EAAA,OAAA;EAAO,OAC7B,OAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IA9B4B,KA8B5B,CAAA,MAAA,EA9B0C,WA8B1C,CAAA;EAAuB;;;;;;EA2DJ,SAA3B,EAAA,EAAA,MAAA;EAAc;;;;EAYa,iBAA3B,aAAA;EAAc,WAFE,CAAA,IAAA,EA5EM,KA4EN;EAAO;AAtGN;;;;gBAgCa,kBACtB;;;;;;;;aAeE;;2BAmBc;;;;;;;;;;;;;;;;;;;;iBAuBV,QACd,aAAa,QACb,eAAe,aAAa;mBAUZ,WACb,kBACH,eAAe,aAAa"}
+{"version":3,"file":"Topic-DuFeqkBh.d.mts","names":[],"sources":["../src/topic/Topic.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAoBY,WAAA,GAAc,eAAe;AAAzC;;;;AAAgC,KAMpB,YANoB,CAAA,gBAMS,WANT,CAAA,GAAA,QAMpB,MACC,OADW,GAAA,MAAA,GACQ,kBADR,CAEtB,CAFsB,EAGtB,mBAHsB,CAGF,OAHE,CAGM,CAHN,CAAA,CAAA,CAAA,EAAA,CAAA,MAKhB,OALgB,GAAA,MAAA,CAAA;;;;;;;;;AAKT;AAYf;AAAkB,cAAL,KAAK,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,gBAED,WAFC,GAEa,WAFb,CAAA,SAGR,SAAA,CAHQ;EAAA,SAED,IAAA,EA2BO,KA3BP;EAAW;;;;;EAIe,SAuBnB,YAAA,EAMQ,OANR;EAAK,YAMG,EAAA,OAAA;EAAO,OAC7B,OAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IA9B4B,KA8B5B,CAAA,MAAA,EA9B0C,WA8B1C,CAAA;EAAuB;;;;;;EA2DJ,SAA3B,EAAA,EAAA,MAAA;EAAc;;;;EAYa,iBAA3B,aAAA;EAAc,WAFE,CAAA,IAAA,EA5EM,KA4EN;EAAO;AAtGN;;;;gBAgCa,kBACtB;;;;;;;;aAeE;;2BAmBc;;;;;;;;;;;;;;;;;;;;iBAuBV,QACd,aAAa,QACb,eAAe,aAAa;mBAUZ,WACb,kBACH,eAAe,aAAa"}

package/dist/adaptors/aws.cjs

@@ -1,20 +1,253 @@
 const require_chunk = require('../chunk-DWy1uDak.cjs');
 require('../construct-interface-BfjcOD_E.cjs');
-require('../Construct-roId57cU.cjs');
-require('../functions-DukjG8ov.cjs');
+require('../Construct-CyS3RpTL.cjs');
+const require_functions = require('../functions-Bd3TPxid.cjs');
 require('../clone-Dy0cR2SZ.cjs');
-const require_Endpoint = require('../Endpoint-BBkV6l0k.cjs');
+const require_Endpoint = require('../Endpoint-BiaaMEn_.cjs');
 const require_surfaceEnv = require('../surfaceEnv-BFXEms2f.cjs');
-const require_publisher = require('../publisher-CqGsXB2X.cjs');
-const require_AWSScheduledFunction = require('../AWSScheduledFunction-qu4ieRZR.cjs');
-const require_processAudits = require('../processAudits-Bc8rz6Ev.cjs');
-const require_lazyAccessors = require('../lazyAccessors-DrJj8NpA.cjs');
+const require_lazyAccessors = require('../lazyAccessors-e3j2oE2m.cjs');
+const require_processAudits = require('../processAudits-CGqttuXm.cjs');
 const __geekmidas_errors = require_chunk.__toESM(require("@geekmidas/errors"));
 const __geekmidas_services = require_chunk.__toESM(require("@geekmidas/services"));
 const __middy_core = require_chunk.__toESM(require("@middy/core"));
+const __geekmidas_audit = require_chunk.__toESM(require("@geekmidas/audit"));
+const __geekmidas_audit_kysely = require_chunk.__toESM(require("@geekmidas/audit/kysely"));
 const __geekmidas_db_rls = require_chunk.__toESM(require("@geekmidas/db/rls"));
 const qs = require_chunk.__toESM(require("qs"));
 
+//#region src/functions/FunctionExecutionWrapper.ts
+var FunctionExecutionWrapper = class {
+	constructor(envParser, fn) {
+		this.envParser = envParser;
+		this.fn = fn;
+	}
+	_logger;
+	get logger() {
+		return this._logger || this.fn.logger;
+	}
+	get serviceDiscovery() {
+		const serviceDiscovery = __geekmidas_services.ServiceDiscovery.getInstance(this.envParser);
+		return serviceDiscovery;
+	}
+	getServices() {
+		return this.serviceDiscovery.register(this.fn.services);
+	}
+	async getDatabase() {
+		if (!this.fn.databaseService) return void 0;
+		const services = await this.serviceDiscovery.register([this.fn.databaseService]);
+		return services[this.fn.databaseService.serviceName];
+	}
+	/**
+	* Get the audit storage service if configured.
+	* Returns undefined if no auditor storage is configured.
+	*/
+	async getAuditStorage() {
+		if (!this.fn.auditorStorageService) return void 0;
+		const services = await this.serviceDiscovery.register([this.fn.auditorStorageService]);
+		return services[this.fn.auditorStorageService.serviceName];
+	}
+	/**
+	* Create an auditor instance for the function.
+	* Returns undefined if no auditor storage is configured.
+	*/
+	async createAuditor() {
+		const storage = await this.getAuditStorage();
+		if (!storage) return void 0;
+		return new __geekmidas_audit.DefaultAuditor({
+			actor: {
+				id: "system",
+				type: "system"
+			},
+			storage,
+			metadata: { function: this.fn.type }
+		});
+	}
+	/**
+	* Execute handler with audit transaction support.
+	* If the audit storage has a database (via getDatabase()), wraps execution
+	* in a transaction so audits are atomic with handler's database operations.
+	*
+	* @param handler - The handler function to execute (receives auditor and db)
+	* @returns The handler result
+	*/
+	async executeWithAudit(handler) {
+		const auditor = await this.createAuditor();
+		const storage = await this.getAuditStorage();
+		if (!auditor || !storage) {
+			const db$1 = await this.getDatabase();
+			return handler({ db: db$1 });
+		}
+		const storageDb = storage.getDatabase?.();
+		const databaseServiceName = this.fn.databaseService?.serviceName;
+		const auditDbServiceName = this.fn.auditorStorageService?.serviceName;
+		if (storageDb && databaseServiceName && auditDbServiceName) return (0, __geekmidas_audit_kysely.withAuditableTransaction)(storageDb, auditor, async (trx) => {
+			const response$1 = await handler({
+				auditor,
+				db: trx
+			});
+			return response$1;
+		});
+		const db = await this.getDatabase();
+		const response = await handler({
+			auditor,
+			db
+		});
+		await auditor.flush();
+		return response;
+	}
+	async getFunctionInput(event) {
+		const parsedInput = await require_functions.FunctionBuilder.parseComposableStandardSchema(event, this.fn.input);
+		return parsedInput;
+	}
+	async publishEvents(response) {
+		await require_lazyAccessors.publishEvents(this.logger, this.serviceDiscovery, this.fn.events, response, this.fn.publisherService);
+	}
+	async parseComposableStandardSchema(data, schema) {
+		return require_functions.FunctionBuilder.parseComposableStandardSchema(data, schema);
+	}
+};
+
+//#endregion
+//#region src/functions/AWSLambdaFunction.ts
+var AWSLambdaFunction = class extends FunctionExecutionWrapper {
+	constructor(envParser, fn) {
+		super(envParser, fn);
+		this.fn = fn;
+	}
+	error() {
+		return { onError: (req) => {
+			const logger = req.event?.logger || this.fn.logger;
+			logger.error(req.error || {}, "Error processing function");
+			throw (0, __geekmidas_errors.wrapError)(req.error);
+		} };
+	}
+	baseInput() {
+		return { before: (_req) => {} };
+	}
+	input() {
+		return { before: async (req) => {
+			try {
+				if (this.fn.input) {
+					const parsedInput = await require_functions.FunctionBuilder.parseComposableStandardSchema(req.event, this.fn.input);
+					req.event.parsedInput = parsedInput;
+				} else req.event.parsedInput = req.event;
+			} catch (error) {
+				this.logger.error({
+					error,
+					event: req.event
+				}, "Failed to parse input");
+				throw error;
+			}
+		} };
+	}
+	loggerMiddleware() {
+		return { before: (req) => {
+			this._logger = this.fn.logger.child({
+				fn: {
+					name: req.context.functionName,
+					version: req.context.functionVersion,
+					memory: req.context.memoryLimitInMB
+				},
+				req: { id: req.context.awsRequestId }
+			});
+			req.event.logger = this._logger;
+		} };
+	}
+	services() {
+		return { before: async (req) => {
+			req.event.services = await this.getServices();
+		} };
+	}
+	database() {
+		return { before: async (req) => {
+			req.event.db = await this.getDatabase();
+		} };
+	}
+	auditor() {
+		return {
+			before: async (req) => {
+				req.event.auditor = await this.createAuditor();
+			},
+			after: async (req) => {
+				if (req.event.auditor) {
+					const records = req.event.auditor.getRecords();
+					if (records.length > 0) {
+						this.logger.debug({ auditCount: records.length }, "Flushing function audits");
+						await req.event.auditor.flush();
+					}
+				}
+			}
+		};
+	}
+	events() {
+		return { after: async (req) => {
+			const response = req.response || void 0;
+			await this.publishEvents(response);
+		} };
+	}
+	async _handler(event) {
+		const result = await this.fn.fn({
+			input: event.parsedInput,
+			services: event.services,
+			logger: event.logger,
+			db: event.db,
+			auditor: event.auditor
+		});
+		const output = await this.fn.parseOutput(result);
+		return output;
+	}
+	get handler() {
+		const handler = this._handler.bind(this);
+		const chain = (0, __middy_core.default)(handler).use(this.loggerMiddleware()).use(this.baseInput()).use(this.error()).use(this.services()).use(this.database()).use(this.auditor()).use(this.input()).use(this.events());
+		const wrappedHandler = async (event, context) => {
+			const startTime = Date.now();
+			const requestId = context.awsRequestId;
+			const logger = this.fn.logger.child({ requestId });
+			return (0, __geekmidas_services.runWithRequestContext)({
+				logger,
+				requestId,
+				startTime
+			}, () => chain(event, context));
+		};
+		return wrappedHandler;
+	}
+};
+
+//#endregion
+//#region src/crons/AWSScheduledFunction.ts
+/**
+* AWS Lambda adaptor for {@link Cron} constructs.
+*
+* A `Cron` is a {@link import('../functions').Function} that is invoked on a
+* schedule (an EventBridge rule) rather than by an API request. Because of
+* that, the runtime execution pipeline is identical to a regular Lambda
+* function: input parsing, service/database/auditor wiring, event publishing,
+* error handling, and the `runWithRequestContext` wrapper that powers
+* request-scoped logging via `serviceContext.getLogger()`.
+*
+* This adaptor therefore reuses {@link AWSLambdaFunction} wholesale and only
+* narrows the constructor to accept a `Cron`. The schedule expression itself
+* (`cron.schedule`) is **deploy-time** infrastructure consumed by the CLI to
+* provision the EventBridge rule — it is not needed at runtime.
+*
+* @example
+* ```typescript
+* import { AWSScheduledFunction } from '@geekmidas/constructs/crons';
+* import { cancelPastBookings } from '../../../src/crons/cancelPastBookings.js';
+* import { envParser } from '../../../src/env';
+*
+* const adapter = new AWSScheduledFunction(envParser, cancelPastBookings);
+*
+* export const handler = adapter.handler;
+* ```
+*/
+var AWSScheduledFunction = class extends AWSLambdaFunction {
+	constructor(envParser, cron) {
+		super(envParser, cron);
+	}
+};
+
+//#endregion
 //#region src/endpoints/AmazonApiGatewayEndpointAdaptor.ts
 var import_lodash = require_chunk.__toESM(require_Endpoint.require_lodash(), 1);
 var AmazonApiGatewayEndpoint = class {
@@ -154,7 +387,7 @@ var AmazonApiGatewayEndpoint = class {
 			if (require_Endpoint.Endpoint.isSuccessStatus(statusCode)) {
 				const logger = event.logger;
 				const serviceDiscovery = __geekmidas_services.ServiceDiscovery.getInstance(this.envParser);
-				await require_publisher.publishConstructEvents(this.endpoint, response, serviceDiscovery, logger);
+				await require_lazyAccessors.publishConstructEvents(this.endpoint, response, serviceDiscovery, logger);
 			}
 		} };
 	}
@@ -652,10 +885,10 @@ var AWSLambdaSubscriber = class {
 };
 
 //#endregion
-exports.AWSLambdaFunction = require_AWSScheduledFunction.AWSLambdaFunction;
+exports.AWSLambdaFunction = AWSLambdaFunction;
 exports.AWSLambdaQueue = AWSLambdaQueue;
 exports.AWSLambdaSubscriber = AWSLambdaSubscriber;
-exports.AWSScheduledFunction = require_AWSScheduledFunction.AWSScheduledFunction;
+exports.AWSScheduledFunction = AWSScheduledFunction;
 exports.AmazonApiGatewayV1Endpoint = AmazonApiGatewayV1Endpoint;
 exports.AmazonApiGatewayV2Endpoint = AmazonApiGatewayV2Endpoint;
 //# sourceMappingURL=aws.cjs.map