@geekmidas/constructs 10.0.0-alpha.11 → 10.0.0-alpha.111

package/dist/subscribers/index.mjs

@@ -1,6 +1,116 @@
-import "../Construct-BD5neF7w.mjs";
-import "../construct-interface-Z4CpS8tK.mjs";
-import "../clone-DblgEZZa.mjs";
-import { Subscriber, SubscriberBuilder } from "../SubscriberBuilder-BjkbeT9l.mjs";
+import { n as Subscriber, t as SubscriberBuilder } from "../SubscriberBuilder-DRXfxWn_.mjs";
+import { n as subscribedEvents, r as subscriberContext, t as runSubscriber } from "../runSubscriber-BHvJ8POr.mjs";
+import { carrierFromAttributes, consumeTraced } from "@geekmidas/events";
+import { runWithRequestContext } from "@geekmidas/services";
+import { wrapError } from "@geekmidas/errors";
+import { confirmSnsSubscription, toSnsEvent, verifySnsMessage } from "@geekmidas/events/sns";
+//#region src/subscribers/SnsPushSubscriberAdaptor.ts
+/**
+* A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
+* poller.
+*
+* The notification is read as the Lambda event SNS would have invoked a
+* function with, and run through the same parsing, services and handler as the
+* Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
+* server serving this route has no reason to install `@middy/core`.
+*/
+var SnsPushSubscriberAdaptor = class {
+	envParser;
+	subscriber;
+	options;
+	constructor(envParser, subscriber, options) {
+		this.envParser = envParser;
+		this.subscriber = subscriber;
+		this.options = options;
+	}
+	async handle(body) {
+		const message = body;
+		if (typeof message?.Type !== "string" || !message.TopicArn) return refuse(400, "not an SNS message");
+		if (message.TopicArn !== this.options.topicArn) return refuse(403, `not subscribed to ${message.TopicArn}`);
+		if (this.options.verify) try {
+			await verifySnsMessage(message);
+		} catch (error) {
+			this.subscriber.logger.warn({
+				err: error,
+				topicArn: message.TopicArn
+			}, "Refused an SNS message that did not verify");
+			return refuse(403, error.name);
+		}
+		switch (message.Type) {
+			case "SubscriptionConfirmation":
+				await confirmSnsSubscription(this.options.emulatorEndpoint && message.SubscribeURL ? {
+					...message,
+					SubscribeURL: throughEndpoint(message.SubscribeURL, this.options.emulatorEndpoint)
+				} : message);
+				this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
+				return {
+					status: 200,
+					body: { status: "confirmed" }
+				};
+			case "Notification": try {
+				await this.notify(message);
+				return {
+					status: 200,
+					body: { status: "ok" }
+				};
+			} catch (error) {
+				return refuse(500, error.name);
+			}
+			default: return {
+				status: 200,
+				body: { status: "ignored" }
+			};
+		}
+	}
+	async notify(message) {
+		const requestId = message.MessageId;
+		const logger = this.subscriber.logger.child({ requestId });
+		await runWithRequestContext({
+			logger,
+			requestId,
+			startTime: Date.now(),
+			operation: `subscriber ${this.subscriber.topicName ?? "sns"}`
+		}, () => consumeTraced({
+			system: "aws_sns",
+			destination: this.subscriber.topicName ?? message.TopicArn.split(":").pop() ?? message.TopicArn,
+			type: message.MessageAttributes?.type?.Value,
+			messageId: message.MessageId
+		}, carrierFromAttributes(message.MessageAttributes), () => this.run(message, logger)));
+	}
+	async run(message, logger) {
+		try {
+			const { services, db } = await subscriberContext(this.subscriber, this.envParser);
+			const events = subscribedEvents(this.subscriber, toSnsEvent(message), logger);
+			await runSubscriber(this.subscriber, {
+				events,
+				services,
+				logger,
+				db
+			});
+		} catch (error) {
+			logger.error(error, "Error processing subscriber");
+			throw wrapError(error);
+		}
+	}
+};
+/** `url`, sent to `endpoint`'s origin instead of its own. */
+function throughEndpoint(url, endpoint) {
+	const target = new URL(url);
+	const origin = new URL(endpoint);
+	target.protocol = origin.protocol;
+	target.host = origin.host;
+	return target.toString();
+}
+function refuse(status, error) {
+	return {
+		status,
+		body: {
+			status: "refused",
+			error
+		}
+	};
+}
+//#endregion
+export { SnsPushSubscriberAdaptor, Subscriber, SubscriberBuilder };
 
-export { Subscriber, SubscriberBuilder };
+//# sourceMappingURL=index.mjs.map

package/dist/subscribers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { wrapError } from '@geekmidas/errors';\nimport { carrierFromAttributes, consumeTraced } from '@geekmidas/events';\nimport {\n\tconfirmSnsSubscription,\n\ttype SnsHttpMessage,\n\ttoSnsEvent,\n\tverifySnsMessage,\n} from '@geekmidas/events/sns';\nimport { runWithRequestContext } from '@geekmidas/services';\nimport {\n\trunSubscriber,\n\tsubscribedEvents,\n\tsubscriberContext,\n} from './runSubscriber';\nimport type { Subscriber } from './Subscriber';\n\nexport interface SnsPushOptions {\n\t/** The topic this subscriber is subscribed to. Anything else is refused. */\n\ttopicArn: string;\n\t/**\n\t * Verify each message's signature. Off only against an emulator, which\n\t * signs nothing — decided by the connection string's endpoint, never by\n\t * anything the request says about itself.\n\t */\n\tverify: boolean;\n\t/**\n\t * The emulator's address, as this server was configured with it. An\n\t * emulator names itself in `SubscribeURL` by the port it listens on inside\n\t * its container, which is not the port published to the host — so against\n\t * one, the confirmation is sent here instead. From configuration, never\n\t * from the request.\n\t */\n\temulatorEndpoint?: string;\n}\n\n/** What to answer SNS with. A non-2xx tells SNS to retry. */\nexport interface SnsPushResponse {\n\tstatus: 200 | 400 | 403 | 500;\n\tbody: { status: string; error?: string };\n}\n\n/**\n * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a\n * poller.\n *\n * The notification is read as the Lambda event SNS would have invoked a\n * function with, and run through the same parsing, services and handler as the\n * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a\n * server serving this route has no reason to install `@middy/core`.\n */\nexport class SnsPushSubscriberAdaptor {\n\tconstructor(\n\t\tprivate readonly envParser: EnvironmentParser<{}>,\n\t\treadonly subscriber: Subscriber<any, any, any, any, any, any, any>,\n\t\tprivate readonly options: SnsPushOptions,\n\t) {}\n\n\tasync handle(body: unknown): Promise<SnsPushResponse> {\n\t\tconst message = body as SnsHttpMessage;\n\t\tif (typeof message?.Type !== 'string' || !message.TopicArn) {\n\t\t\treturn refuse(400, 'not an SNS message');\n\t\t}\n\t\t// Checked before the signature: a genuine message for another topic is\n\t\t// still not this subscriber's to confirm or to handle.\n\t\tif (message.TopicArn !== this.options.topicArn) {\n\t\t\treturn refuse(403, `not subscribed to ${message.TopicArn}`);\n\t\t}\n\n\t\tif (this.options.verify) {\n\t\t\ttry {\n\t\t\t\tawait verifySnsMessage(message);\n\t\t\t} catch (error) {\n\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t{ err: error, topicArn: message.TopicArn },\n\t\t\t\t\t'Refused an SNS message that did not verify',\n\t\t\t\t);\n\t\t\t\treturn refuse(403, (error as Error).name);\n\t\t\t}\n\t\t}\n\n\t\tswitch (message.Type) {\n\t\t\tcase 'SubscriptionConfirmation':\n\t\t\t\tawait confirmSnsSubscription(\n\t\t\t\t\tthis.options.emulatorEndpoint && message.SubscribeURL\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t...message,\n\t\t\t\t\t\t\t\tSubscribeURL: throughEndpoint(\n\t\t\t\t\t\t\t\t\tmessage.SubscribeURL,\n\t\t\t\t\t\t\t\t\tthis.options.emulatorEndpoint,\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: message,\n\t\t\t\t);\n\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t);\n\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\tcase 'Notification':\n\t\t\t\ttry {\n\t\t\t\t\tawait this.notify(message);\n\t\t\t\t\treturn { status: 200, body: { status: 'ok' } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Already logged. A 500 makes SNS retry, which is the point of\n\t\t\t\t\t// answering at all.\n\t\t\t\t\treturn refuse(500, (error as Error).name);\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn { status: 200, body: { status: 'ignored' } };\n\t\t}\n\t}\n\n\tprivate async notify(message: SnsHttpMessage): Promise<void> {\n\t\tconst requestId = message.MessageId;\n\t\tconst logger = this.subscriber.logger.child({ requestId });\n\n\t\tawait runWithRequestContext(\n\t\t\t{\n\t\t\t\tlogger,\n\t\t\t\trequestId,\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\toperation: `subscriber ${this.subscriber.topicName ?? 'sns'}`,\n\t\t\t},\n\t\t\t// A CONSUMER span, child of the publisher's: SNS hands the trace\n\t\t\t// context on in the message attributes it was published with.\n\t\t\t() =>\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{\n\t\t\t\t\t\tsystem: 'aws_sns',\n\t\t\t\t\t\tdestination:\n\t\t\t\t\t\t\tthis.subscriber.topicName ??\n\t\t\t\t\t\t\tmessage.TopicArn.split(':').pop() ??\n\t\t\t\t\t\t\tmessage.TopicArn,\n\t\t\t\t\t\ttype: message.MessageAttributes?.type?.Value,\n\t\t\t\t\t\tmessageId: message.MessageId,\n\t\t\t\t\t},\n\t\t\t\t\tcarrierFromAttributes(message.MessageAttributes),\n\t\t\t\t\t() => this.run(message, logger),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async run(\n\t\tmessage: SnsHttpMessage,\n\t\tlogger: Subscriber<any, any, any, any, any, any, any>['logger'],\n\t): Promise<void> {\n\t\ttry {\n\t\t\tconst { services, db } = await subscriberContext(\n\t\t\t\tthis.subscriber,\n\t\t\t\tthis.envParser,\n\t\t\t);\n\t\t\tconst events = subscribedEvents(\n\t\t\t\tthis.subscriber,\n\t\t\t\ttoSnsEvent(message),\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\tawait runSubscriber(this.subscriber, {\n\t\t\t\tevents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t\tdb,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tlogger.error(error as object, 'Error processing subscriber');\n\t\t\tthrow wrapError(error);\n\t\t}\n\t}\n}\n\n/** `url`, sent to `endpoint`'s origin instead of its own. */\nfunction throughEndpoint(url: string, endpoint: string): string {\n\tconst target = new URL(url);\n\tconst origin = new URL(endpoint);\n\ttarget.protocol = origin.protocol;\n\ttarget.host = origin.host;\n\treturn target.toString();\n}\n\nfunction refuse(\n\tstatus: SnsPushResponse['status'],\n\terror: string,\n): SnsPushResponse {\n\treturn { status, body: { status: 'refused', error } };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAmDA,IAAa,2BAAb,MAAsC;CAEnB;CACR;CACQ;CAHlB,YACC,WACA,YACA,SACC;EAHgB,KAAA,YAAA;EACR,KAAA,aAAA;EACQ,KAAA,UAAA;CACf;CAEH,MAAM,OAAO,MAAyC;EACrD,MAAM,UAAU;EAChB,IAAI,OAAO,SAAS,SAAS,YAAY,CAAC,QAAQ,UACjD,OAAO,OAAO,KAAK,oBAAoB;EAIxC,IAAI,QAAQ,aAAa,KAAK,QAAQ,UACrC,OAAO,OAAO,KAAK,qBAAqB,QAAQ,UAAU;EAG3D,IAAI,KAAK,QAAQ,QAChB,IAAI;GACH,MAAM,iBAAiB,OAAO;EAC/B,SAAS,OAAO;GACf,KAAK,WAAW,OAAO,KACtB;IAAE,KAAK;IAAO,UAAU,QAAQ;GAAS,GACzC,4CACD;GACA,OAAO,OAAO,KAAM,MAAgB,IAAI;EACzC;EAGD,QAAQ,QAAQ,MAAhB;GACC,KAAK;IACJ,MAAM,uBACL,KAAK,QAAQ,oBAAoB,QAAQ,eACtC;KACA,GAAG;KACH,cAAc,gBACb,QAAQ,cACR,KAAK,QAAQ,gBACd;IACD,IACC,OACJ;IACA,KAAK,WAAW,OAAO,KACtB,EAAE,UAAU,QAAQ,SAAS,GAC7B,4BACD;IACA,OAAO;KAAE,QAAQ;KAAK,MAAM,EAAE,QAAQ,YAAY;IAAE;GACrD,KAAK,gBACJ,IAAI;IACH,MAAM,KAAK,OAAO,OAAO;IACzB,OAAO;KAAE,QAAQ;KAAK,MAAM,EAAE,QAAQ,KAAK;IAAE;GAC9C,SAAS,OAAO;IAGf,OAAO,OAAO,KAAM,MAAgB,IAAI;GACzC;GACD,SACC,OAAO;IAAE,QAAQ;IAAK,MAAM,EAAE,QAAQ,UAAU;GAAE;EACpD;CACD;CAEA,MAAc,OAAO,SAAwC;EAC5D,MAAM,YAAY,QAAQ;EAC1B,MAAM,SAAS,KAAK,WAAW,OAAO,MAAM,EAAE,UAAU,CAAC;EAEzD,MAAM,sBACL;GACC;GACA;GACA,WAAW,KAAK,IAAI;GACpB,WAAW,cAAc,KAAK,WAAW,aAAa;EACvD,SAIC,cACC;GACC,QAAQ;GACR,aACC,KAAK,WAAW,aAChB,QAAQ,SAAS,MAAM,GAAG,CAAC,CAAC,IAAI,KAChC,QAAQ;GACT,MAAM,QAAQ,mBAAmB,MAAM;GACvC,WAAW,QAAQ;EACpB,GACA,sBAAsB,QAAQ,iBAAiB,SACzC,KAAK,IAAI,SAAS,MAAM,CAC/B,CACF;CACD;CAEA,MAAc,IACb,SACA,QACgB;EAChB,IAAI;GACH,MAAM,EAAE,UAAU,OAAO,MAAM,kBAC9B,KAAK,YACL,KAAK,SACN;GACA,MAAM,SAAS,iBACd,KAAK,YACL,WAAW,OAAO,GAClB,MACD;GACA,MAAM,cAAc,KAAK,YAAY;IACpC;IACA;IACA;IACA;GACD,CAAC;EACF,SAAS,OAAO;GACf,OAAO,MAAM,OAAiB,6BAA6B;GAC3D,MAAM,UAAU,KAAK;EACtB;CACD;AACD;;AAGA,SAAS,gBAAgB,KAAa,UAA0B;CAC/D,MAAM,SAAS,IAAI,IAAI,GAAG;CAC1B,MAAM,SAAS,IAAI,IAAI,QAAQ;CAC/B,OAAO,WAAW,OAAO;CACzB,OAAO,OAAO,OAAO;CACrB,OAAO,OAAO,SAAS;AACxB;AAEA,SAAS,OACR,QACA,OACkB;CAClB,OAAO;EAAE;EAAQ,MAAM;GAAE,QAAQ;GAAW;EAAM;CAAE;AACrD"}

package/dist/surfaceEnv-CNimK76p.cjs

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

package/dist/surfaceEnv-CNimK76p.cjs.map

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

package/dist/surfaceEnv-wMT5QzgZ.mjs

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

package/dist/surfaceEnv-wMT5QzgZ.mjs.map

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

package/dist/telemetry-B48RLjyk.d.cts

@@ -0,0 +1,40 @@
+import { i as Declarable } from "./construct-interface-B1AfqRl4.cjs";
+import { ConstructName, Declaration } from "@geekmidas/manifest";
+//#region src/telemetry.d.ts
+interface TelemetryConfig {
+  /**
+   * Request paths no span is recorded for, on every surface that uses this —
+   * health checks, by default the only noise worth naming. A trailing `*`
+   * matches a prefix. One route on one surface says so itself:
+   * `.telemetry({ ignore: true })`.
+   */
+  ignorePaths?: readonly string[];
+  /**
+   * Resource attributes every span and log record carries —
+   * `{ 'service.namespace': 'shop' }`. The service's name is not one of
+   * them: it is the app's, set per process.
+   */
+  attributes?: Readonly<Record<string, string>>;
+}
+declare class Telemetry<TName extends string = string> implements Declarable<TName> {
+  readonly id: TName;
+  readonly ignorePaths: readonly string[];
+  readonly attributes: Readonly<Record<string, string>>;
+  constructor(id: ConstructName<TName>, config?: TelemetryConfig);
+  /**
+   * One node, providing OpenTelemetry's own variables. No address of its
+   * own: where the telemetry goes is the deploy's, so it is resolved by the
+   * target for each stage, never declared here.
+   */
+  declare(): Declaration[];
+}
+/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */
+interface EndpointTelemetry {
+  /** Record no span for this route. */
+  ignore?: boolean;
+  /** Attributes this route's request span carries. */
+  attributes?: Readonly<Record<string, string>>;
+}
+//#endregion
+export { Telemetry as n, TelemetryConfig as r, EndpointTelemetry as t };
+//# sourceMappingURL=telemetry-B48RLjyk.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-B48RLjyk.d.cts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;UAkCiB;;;;;;;EAOhB;;;;;;EAMA,aAAa,SAAS;;cAGV,UAAU,0CACX,WAAW;WAEb,IAAI;WACJ;WACA,YAAY,SAAS;EAE9B,YAAY,IAAI,cAAc,QAAQ,SAAQ;;;;;;EAW9C,WAAW;;;UAgBK;;EAEhB;;EAEA,aAAa,SAAS"}

package/dist/telemetry-BEoBn6GO.d.mts

@@ -0,0 +1,40 @@
+import { i as Declarable } from "./construct-interface-ZvYQbivO.mjs";
+import { ConstructName, Declaration } from "@geekmidas/manifest";
+//#region src/telemetry.d.ts
+interface TelemetryConfig {
+  /**
+   * Request paths no span is recorded for, on every surface that uses this —
+   * health checks, by default the only noise worth naming. A trailing `*`
+   * matches a prefix. One route on one surface says so itself:
+   * `.telemetry({ ignore: true })`.
+   */
+  ignorePaths?: readonly string[];
+  /**
+   * Resource attributes every span and log record carries —
+   * `{ 'service.namespace': 'shop' }`. The service's name is not one of
+   * them: it is the app's, set per process.
+   */
+  attributes?: Readonly<Record<string, string>>;
+}
+declare class Telemetry<TName extends string = string> implements Declarable<TName> {
+  readonly id: TName;
+  readonly ignorePaths: readonly string[];
+  readonly attributes: Readonly<Record<string, string>>;
+  constructor(id: ConstructName<TName>, config?: TelemetryConfig);
+  /**
+   * One node, providing OpenTelemetry's own variables. No address of its
+   * own: where the telemetry goes is the deploy's, so it is resolved by the
+   * target for each stage, never declared here.
+   */
+  declare(): Declaration[];
+}
+/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */
+interface EndpointTelemetry {
+  /** Record no span for this route. */
+  ignore?: boolean;
+  /** Attributes this route's request span carries. */
+  attributes?: Readonly<Record<string, string>>;
+}
+//#endregion
+export { Telemetry as n, TelemetryConfig as r, EndpointTelemetry as t };
+//# sourceMappingURL=telemetry-BEoBn6GO.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-BEoBn6GO.d.mts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;UAkCiB;;;;;;;EAOhB;;;;;;EAMA,aAAa,SAAS;;cAGV,UAAU,0CACX,WAAW;WAEb,IAAI;WACJ;WACA,YAAY,SAAS;EAE9B,YAAY,IAAI,cAAc,QAAQ,SAAQ;;;;;;EAW9C,WAAW;;;UAgBK;;EAEhB;;EAEA,aAAa,SAAS"}

package/dist/telemetry.cjs

@@ -0,0 +1,56 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _geekmidas_manifest = require("@geekmidas/manifest");
+//#region src/telemetry.ts
+/**
+* `Telemetry` — what an application emits, declared.
+*
+* Traces and logs over OTLP, from every process that is given it. The
+* construct says *what* is emitted — which requests are noise, which
+* attributes every span carries — and never where it goes or how much of it:
+* the provider and the sample rate are the deploy's, per stage
+* (`deploy.telemetry` in `gkm.config.ts`), and locally `gkm dev` runs
+* OpenObserve and sends everything there.
+*
+* ```ts
+* export const telemetry = new Telemetry('Telemetry', {
+*   ignorePaths: ['/health', '/ready'],
+*   attributes: { 'service.namespace': 'shop' },
+* });
+*
+* // passed like the logger: a fact about the process
+* new RestApi('Api', { path: 'apps/api', defaultAuthorizer: 'none', telemetry });
+* new Worker('Jobs', { logger, telemetry });
+* ```
+*
+* Each process given it is an edge to this node, so the `OTEL_*` keys it
+* provides reach exactly those processes, and the build of each one fails
+* without the OpenTelemetry packages it needs.
+*/
+var Telemetry = class {
+	id;
+	ignorePaths;
+	attributes;
+	constructor(id, config = {}) {
+		this.id = (0, _geekmidas_manifest.canonicalId)(id);
+		this.ignorePaths = [...config.ignorePaths ?? []];
+		this.attributes = { ...config.attributes };
+	}
+	/**
+	* One node, providing OpenTelemetry's own variables. No address of its
+	* own: where the telemetry goes is the deploy's, so it is resolved by the
+	* target for each stage, never declared here.
+	*/
+	declare() {
+		return [{
+			kind: "telemetry",
+			id: this.id,
+			...this.ignorePaths.length ? { ignorePaths: this.ignorePaths } : {},
+			...Object.keys(this.attributes).length ? { attributes: this.attributes } : {},
+			provides: [..._geekmidas_manifest.TELEMETRY_KEYS]
+		}];
+	}
+};
+//#endregion
+exports.Telemetry = Telemetry;
+
+//# sourceMappingURL=telemetry.cjs.map

package/dist/telemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.cjs","names":["canonicalId","TELEMETRY_KEYS"],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * `Telemetry` — what an application emits, declared.\n *\n * Traces and logs over OTLP, from every process that is given it. The\n * construct says *what* is emitted — which requests are noise, which\n * attributes every span carries — and never where it goes or how much of it:\n * the provider and the sample rate are the deploy's, per stage\n * (`deploy.telemetry` in `gkm.config.ts`), and locally `gkm dev` runs\n * OpenObserve and sends everything there.\n *\n * ```ts\n * export const telemetry = new Telemetry('Telemetry', {\n *   ignorePaths: ['/health', '/ready'],\n *   attributes: { 'service.namespace': 'shop' },\n * });\n *\n * // passed like the logger: a fact about the process\n * new RestApi('Api', { path: 'apps/api', defaultAuthorizer: 'none', telemetry });\n * new Worker('Jobs', { logger, telemetry });\n * ```\n *\n * Each process given it is an edge to this node, so the `OTEL_*` keys it\n * provides reach exactly those processes, and the build of each one fails\n * without the OpenTelemetry packages it needs.\n */\n\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tTELEMETRY_KEYS,\n} from '@geekmidas/manifest';\nimport type { Declarable } from './construct-interface';\n\nexport interface TelemetryConfig {\n\t/**\n\t * Request paths no span is recorded for, on every surface that uses this —\n\t * health checks, by default the only noise worth naming. A trailing `*`\n\t * matches a prefix. One route on one surface says so itself:\n\t * `.telemetry({ ignore: true })`.\n\t */\n\tignorePaths?: readonly string[];\n\t/**\n\t * Resource attributes every span and log record carries —\n\t * `{ 'service.namespace': 'shop' }`. The service's name is not one of\n\t * them: it is the app's, set per process.\n\t */\n\tattributes?: Readonly<Record<string, string>>;\n}\n\nexport class Telemetry<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\treadonly ignorePaths: readonly string[];\n\treadonly attributes: Readonly<Record<string, string>>;\n\n\tconstructor(id: ConstructName<TName>, config: TelemetryConfig = {}) {\n\t\tthis.id = canonicalId(id as string) as TName;\n\t\tthis.ignorePaths = [...(config.ignorePaths ?? [])];\n\t\tthis.attributes = { ...config.attributes };\n\t}\n\n\t/**\n\t * One node, providing OpenTelemetry's own variables. No address of its\n\t * own: where the telemetry goes is the deploy's, so it is resolved by the\n\t * target for each stage, never declared here.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'telemetry',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.ignorePaths.length ? { ignorePaths: this.ignorePaths } : {}),\n\t\t\t\t...(Object.keys(this.attributes).length\n\t\t\t\t\t? { attributes: this.attributes }\n\t\t\t\t\t: {}),\n\t\t\t\tprovides: [...TELEMETRY_KEYS],\n\t\t\t},\n\t\t];\n\t}\n}\n\n/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */\nexport interface EndpointTelemetry {\n\t/** Record no span for this route. */\n\tignore?: boolean;\n\t/** Attributes this route's request span carries. */\n\tattributes?: Readonly<Record<string, string>>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,IAAa,YAAb,MAEA;CACC;CACA;CACA;CAEA,YAAY,IAA0B,SAA0B,CAAC,GAAG;EACnE,KAAK,MAAA,GAAKA,oBAAAA,YAAAA,CAAY,EAAY;EAClC,KAAK,cAAc,CAAC,GAAI,OAAO,eAAe,CAAC,CAAE;EACjD,KAAK,aAAa,EAAE,GAAG,OAAO,WAAW;CAC1C;;;;;;CAOA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,YAAY,SAAS,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;GACnE,GAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,SAC9B,EAAE,YAAY,KAAK,WAAW,IAC9B,CAAC;GACJ,UAAU,CAAC,GAAGC,oBAAAA,cAAc;EAC7B,CACD;CACD;AACD"}

package/dist/telemetry.d.cts

@@ -0,0 +1,2 @@
+import { n as Telemetry, r as TelemetryConfig, t as EndpointTelemetry } from "./telemetry-B48RLjyk.cjs";
+export { EndpointTelemetry, Telemetry, TelemetryConfig };

package/dist/telemetry.d.mts

@@ -0,0 +1,2 @@
+import { n as Telemetry, r as TelemetryConfig, t as EndpointTelemetry } from "./telemetry-BEoBn6GO.mjs";
+export { EndpointTelemetry, Telemetry, TelemetryConfig };

package/dist/telemetry.mjs

@@ -0,0 +1,55 @@
+import { TELEMETRY_KEYS, canonicalId } from "@geekmidas/manifest";
+//#region src/telemetry.ts
+/**
+* `Telemetry` — what an application emits, declared.
+*
+* Traces and logs over OTLP, from every process that is given it. The
+* construct says *what* is emitted — which requests are noise, which
+* attributes every span carries — and never where it goes or how much of it:
+* the provider and the sample rate are the deploy's, per stage
+* (`deploy.telemetry` in `gkm.config.ts`), and locally `gkm dev` runs
+* OpenObserve and sends everything there.
+*
+* ```ts
+* export const telemetry = new Telemetry('Telemetry', {
+*   ignorePaths: ['/health', '/ready'],
+*   attributes: { 'service.namespace': 'shop' },
+* });
+*
+* // passed like the logger: a fact about the process
+* new RestApi('Api', { path: 'apps/api', defaultAuthorizer: 'none', telemetry });
+* new Worker('Jobs', { logger, telemetry });
+* ```
+*
+* Each process given it is an edge to this node, so the `OTEL_*` keys it
+* provides reach exactly those processes, and the build of each one fails
+* without the OpenTelemetry packages it needs.
+*/
+var Telemetry = class {
+	id;
+	ignorePaths;
+	attributes;
+	constructor(id, config = {}) {
+		this.id = canonicalId(id);
+		this.ignorePaths = [...config.ignorePaths ?? []];
+		this.attributes = { ...config.attributes };
+	}
+	/**
+	* One node, providing OpenTelemetry's own variables. No address of its
+	* own: where the telemetry goes is the deploy's, so it is resolved by the
+	* target for each stage, never declared here.
+	*/
+	declare() {
+		return [{
+			kind: "telemetry",
+			id: this.id,
+			...this.ignorePaths.length ? { ignorePaths: this.ignorePaths } : {},
+			...Object.keys(this.attributes).length ? { attributes: this.attributes } : {},
+			provides: [...TELEMETRY_KEYS]
+		}];
+	}
+};
+//#endregion
+export { Telemetry };
+
+//# sourceMappingURL=telemetry.mjs.map

package/dist/telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.mjs","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * `Telemetry` — what an application emits, declared.\n *\n * Traces and logs over OTLP, from every process that is given it. The\n * construct says *what* is emitted — which requests are noise, which\n * attributes every span carries — and never where it goes or how much of it:\n * the provider and the sample rate are the deploy's, per stage\n * (`deploy.telemetry` in `gkm.config.ts`), and locally `gkm dev` runs\n * OpenObserve and sends everything there.\n *\n * ```ts\n * export const telemetry = new Telemetry('Telemetry', {\n *   ignorePaths: ['/health', '/ready'],\n *   attributes: { 'service.namespace': 'shop' },\n * });\n *\n * // passed like the logger: a fact about the process\n * new RestApi('Api', { path: 'apps/api', defaultAuthorizer: 'none', telemetry });\n * new Worker('Jobs', { logger, telemetry });\n * ```\n *\n * Each process given it is an edge to this node, so the `OTEL_*` keys it\n * provides reach exactly those processes, and the build of each one fails\n * without the OpenTelemetry packages it needs.\n */\n\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tTELEMETRY_KEYS,\n} from '@geekmidas/manifest';\nimport type { Declarable } from './construct-interface';\n\nexport interface TelemetryConfig {\n\t/**\n\t * Request paths no span is recorded for, on every surface that uses this —\n\t * health checks, by default the only noise worth naming. A trailing `*`\n\t * matches a prefix. One route on one surface says so itself:\n\t * `.telemetry({ ignore: true })`.\n\t */\n\tignorePaths?: readonly string[];\n\t/**\n\t * Resource attributes every span and log record carries —\n\t * `{ 'service.namespace': 'shop' }`. The service's name is not one of\n\t * them: it is the app's, set per process.\n\t */\n\tattributes?: Readonly<Record<string, string>>;\n}\n\nexport class Telemetry<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\treadonly ignorePaths: readonly string[];\n\treadonly attributes: Readonly<Record<string, string>>;\n\n\tconstructor(id: ConstructName<TName>, config: TelemetryConfig = {}) {\n\t\tthis.id = canonicalId(id as string) as TName;\n\t\tthis.ignorePaths = [...(config.ignorePaths ?? [])];\n\t\tthis.attributes = { ...config.attributes };\n\t}\n\n\t/**\n\t * One node, providing OpenTelemetry's own variables. No address of its\n\t * own: where the telemetry goes is the deploy's, so it is resolved by the\n\t * target for each stage, never declared here.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'telemetry',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.ignorePaths.length ? { ignorePaths: this.ignorePaths } : {}),\n\t\t\t\t...(Object.keys(this.attributes).length\n\t\t\t\t\t? { attributes: this.attributes }\n\t\t\t\t\t: {}),\n\t\t\t\tprovides: [...TELEMETRY_KEYS],\n\t\t\t},\n\t\t];\n\t}\n}\n\n/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */\nexport interface EndpointTelemetry {\n\t/** Record no span for this route. */\n\tignore?: boolean;\n\t/** Attributes this route's request span carries. */\n\tattributes?: Readonly<Record<string, string>>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,IAAa,YAAb,MAEA;CACC;CACA;CACA;CAEA,YAAY,IAA0B,SAA0B,CAAC,GAAG;EACnE,KAAK,KAAK,YAAY,EAAY;EAClC,KAAK,cAAc,CAAC,GAAI,OAAO,eAAe,CAAC,CAAE;EACjD,KAAK,aAAa,EAAE,GAAG,OAAO,WAAW;CAC1C;;;;;;CAOA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,YAAY,SAAS,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;GACnE,GAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,SAC9B,EAAE,YAAY,KAAK,WAAW,IAC9B,CAAC;GACJ,UAAU,CAAC,GAAG,cAAc;EAC7B,CACD;CACD;AACD"}

package/dist/topic/index.cjs

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

package/dist/topic/index.d.cts

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

package/dist/topic/index.d.mts

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