@geekmidas/constructs 10.0.0-alpha.20 → 10.0.0-alpha.22

package/dist/Topic-BaNCgP61.cjs

@@ -0,0 +1,107 @@
+const require_Construct = require("./Construct-yG9Sw-5p.cjs");
+let _geekmidas_manifest = require("@geekmidas/manifest");
+let _geekmidas_logger_console = require("@geekmidas/logger/console");
+let _geekmidas_events = 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 {
+	name;
+	eventSchemas;
+	__IS_TOPIC__ = true;
+	static isTopic(obj) {
+		return Boolean(obj && obj.__IS_TOPIC__ === true && obj.type === "dev.geekmidas.resource.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("dev.geekmidas.resource.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
+Object.defineProperty(exports, "Topic", {
+	enumerable: true,
+	get: function() {
+		return Topic;
+	}
+});
+
+//# sourceMappingURL=Topic-BaNCgP61.cjs.map

package/dist/Topic-BaNCgP61.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Topic-BaNCgP61.cjs","names":["Construct","DEFAULT_LOGGER","canonicalId","provideKey","serviceKey","Publisher"],"sources":["../src/topic/Topic.ts"],"sourcesContent":["import {\n\ttype EventPublisher,\n\ttype EventPublisherConnectionString,\n\ttype PublishableMessage,\n\tPublisher,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\tcanonicalId,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\n/** A topic's event contract — a map of event type → payload schema. */\nexport type TopicEvents = Record<string, StandardSchemaV1>;\n\n/**\n * The union of wire messages a topic carries, derived from its event map:\n * `{ type: 'user.created'; payload: … } | { type: 'user.updated'; payload: … }`.\n */\nexport type TopicMessage<TEvents extends TopicEvents> = {\n\t[K in keyof TEvents & string]: PublishableMessage<\n\t\tK,\n\t\tInferStandardSchema<TEvents[K]>\n\t>;\n}[keyof TEvents & string];\n\n/**\n * A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a\n * topic is a *resource* owned by no single handler: it declares the event\n * contract, derives a typed producer (`topic.publisher`), and any number of\n * subscribers (`s.topic(topic)`) bind to it. `gkm build` discovers it into the\n * manifest's `topics` field; infra provisions an SNS topic.\n *\n * This replaces hand-writing a publisher `Service`: the publisher is *derived*\n * from the declared event contract, the same way `Queue` derives its publisher.\n */\nexport class Topic<\n\tTName extends string = string,\n\tTEvents extends TopicEvents = TopicEvents,\n> extends Construct {\n\t__IS_TOPIC__ = true;\n\n\tstatic isTopic(obj: unknown): obj is Topic<string, TopicEvents> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_TOPIC__?: boolean }).__IS_TOPIC__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Topic,\n\t\t);\n\t}\n\n\t/**\n\t * The canonical id this topic is declared under.\n\t *\n\t * Derived from the name, so `users` and `Users` are one topic. The name is\n\t * left alone: subscribers bind to it and it is what the broker routes on.\n\t */\n\treadonly id: string;\n\n\t/**\n\t * The producer's env key, read by both {@link declare} and\n\t * {@link publisher} so the two cannot drift.\n\t */\n\tprivate readonly connectionKey: string;\n\n\tconstructor(\n\t\tpublic readonly name: TName,\n\t\t/**\n\t\t * The event contract — a map of event type → payload schema. Named\n\t\t * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,\n\t\t * which is the array of `MappedEvent`s a construct *publishes*.\n\t\t */\n\t\tpublic readonly eventSchemas: TEvents,\n\t\tlogger: Logger = DEFAULT_LOGGER,\n\t) {\n\t\tsuper(ConstructType.Topic, logger, [], []);\n\n\t\tthis.id = canonicalId(name);\n\t\tthis.connectionKey = provideKey(this.id, 'publisherConnectionString');\n\t}\n\n\t/**\n\t * What this topic is in the manifest.\n\t *\n\t * Only the producer's key: a subscriber is *bound* to a topic rather than\n\t * depending on it, so the binding is an edge the deploy target reads and not\n\t * an env key anyone can hold. Locally both sides meet on the same broker.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'topic',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.connectionKey],\n\t\t\t\t// The contract this topic carries. Structural: which events exist\n\t\t\t\t// is a fact about the application, and a subscriber binding to one\n\t\t\t\t// that does not is a mistake worth catching at build.\n\t\t\t\tevents: this.eventTypes,\n\t\t\t\t// Bound rather than declared here — a subscriber names the topic,\n\t\t\t\t// not the other way round — so the build fills these from what it\n\t\t\t\t// found. Nested when it does, because position is the trigger.\n\t\t\t\tsubscribers: [],\n\t\t\t},\n\t\t];\n\t}\n\n\t/** The event type names this topic carries. */\n\tget eventTypes(): (keyof TEvents & string)[] {\n\t\treturn Object.keys(this.eventSchemas) as (keyof TEvents & string)[];\n\t}\n\n\t/**\n\t * The producer side — a `Service` exposing an `EventPublisher` typed to the\n\t * union of this topic's events. Inject via `.publisher(topic.publisher)` (for\n\t * declarative `.event(...)`) or `.services([topic.publisher])` (to publish\n\t * imperatively). Reads `<NAME>_PUBLISHER_CONNECTION_STRING` and selects the\n\t * transport from the URL protocol — `pgboss://` locally, `sns://` deployed.\n\t *\n\t * Because it's a `Service`, the connection-string requirement is sniffed into\n\t * the manifest of whatever construct injects it (least-privilege linking).\n\t */\n\t/**\n\t * The topic as a dependency — what `.dependsOn([users])` dissolves into,\n\t * reachable as `services.users`.\n\t *\n\t * It is the producer, because publishing is the only thing depending on a\n\t * topic can mean: a subscriber *binds* with `s.topic(…)` instead, and is\n\t * deliberately never handed this. {@link publisher} is the same service\n\t * under its older `<name>Publisher` key.\n\t */\n\tget service(): Service<\n\t\tUncapitalize<TName>,\n\t\tEventPublisher<TopicMessage<TEvents>>\n\t> {\n\t\tconst { register } = this.publisher;\n\n\t\treturn {\n\t\t\tserviceName: serviceKey(this.id) as Uncapitalize<TName>,\n\t\t\tregister,\n\t\t};\n\t}\n\n\tget publisher(): Service<\n\t\t`${TName}Publisher`,\n\t\tEventPublisher<TopicMessage<TEvents>>\n\t> {\n\t\tconst envVar = this.connectionKey;\n\t\treturn {\n\t\t\tserviceName: `${this.name}Publisher`,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({\n\t\t\t\t\t\tconnectionString: get(envVar).string(),\n\t\t\t\t\t}))\n\t\t\t\t\t.parse();\n\n\t\t\t\treturn Publisher.fromConnectionString<TopicMessage<TEvents>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AA2CA,IAAa,QAAb,cAGUA,kBAAAA,UAAU;CA0BF;CAMA;CA/BjB,eAAe;CAEf,OAAO,QAAQ,KAAiD;EAC/D,OAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAAA,8BACrB;CACD;;;;;;;CAQA;;;;;CAMA;CAEA,YACC,MAMA,cACA,SAAiBC,0BAAAA,gBAChB;EACD,MAAA,gCAA2B,QAAQ,CAAC,GAAG,CAAC,CAAC;EATzB,KAAA,OAAA;EAMA,KAAA,eAAA;EAKhB,KAAK,MAAA,GAAKC,oBAAAA,YAAAA,CAAY,IAAI;EAC1B,KAAK,iBAAA,GAAgBC,oBAAAA,WAAAA,CAAW,KAAK,IAAI,2BAA2B;CACrE;;;;;;;;CASA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,aAAa;GAI7B,QAAQ,KAAK;GAIb,aAAa,CAAC;EACf,CACD;CACD;;CAGA,IAAI,aAAyC;EAC5C,OAAO,OAAO,KAAK,KAAK,YAAY;CACrC;;;;;;;;;;;;;;;;;;;;CAqBA,IAAI,UAGF;EACD,MAAM,EAAE,aAAa,KAAK;EAE1B,OAAO;GACN,cAAA,GAAaC,oBAAAA,WAAAA,CAAW,KAAK,EAAE;GAC/B;EACD;CACD;CAEA,IAAI,YAGF;EACD,MAAM,SAAS,KAAK;EACpB,OAAO;GACN,aAAa,GAAG,KAAK,KAAK;GAC1B,MAAM,SAAS,EAAE,aAAa;IAC7B,MAAM,EAAE,qBAAqB,UAC3B,QAAQ,SAAS,EACjB,kBAAkB,IAAI,MAAM,CAAC,CAAC,OAAO,EACtC,EAAE,CAAC,CACF,MAAM;IAER,OAAOC,kBAAAA,UAAU,qBAChB,gBACD;GACD;EACD;CACD;AACD"}

package/dist/Topic-QqnO_6Dl.mjs

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

package/dist/Topic-QqnO_6Dl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Topic-QqnO_6Dl.mjs","names":[],"sources":["../src/topic/Topic.ts"],"sourcesContent":["import {\n\ttype EventPublisher,\n\ttype EventPublisherConnectionString,\n\ttype PublishableMessage,\n\tPublisher,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\tcanonicalId,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\n/** A topic's event contract — a map of event type → payload schema. */\nexport type TopicEvents = Record<string, StandardSchemaV1>;\n\n/**\n * The union of wire messages a topic carries, derived from its event map:\n * `{ type: 'user.created'; payload: … } | { type: 'user.updated'; payload: … }`.\n */\nexport type TopicMessage<TEvents extends TopicEvents> = {\n\t[K in keyof TEvents & string]: PublishableMessage<\n\t\tK,\n\t\tInferStandardSchema<TEvents[K]>\n\t>;\n}[keyof TEvents & string];\n\n/**\n * A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a\n * topic is a *resource* owned by no single handler: it declares the event\n * contract, derives a typed producer (`topic.publisher`), and any number of\n * subscribers (`s.topic(topic)`) bind to it. `gkm build` discovers it into the\n * manifest's `topics` field; infra provisions an SNS topic.\n *\n * This replaces hand-writing a publisher `Service`: the publisher is *derived*\n * from the declared event contract, the same way `Queue` derives its publisher.\n */\nexport class Topic<\n\tTName extends string = string,\n\tTEvents extends TopicEvents = TopicEvents,\n> extends Construct {\n\t__IS_TOPIC__ = true;\n\n\tstatic isTopic(obj: unknown): obj is Topic<string, TopicEvents> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_TOPIC__?: boolean }).__IS_TOPIC__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Topic,\n\t\t);\n\t}\n\n\t/**\n\t * The canonical id this topic is declared under.\n\t *\n\t * Derived from the name, so `users` and `Users` are one topic. The name is\n\t * left alone: subscribers bind to it and it is what the broker routes on.\n\t */\n\treadonly id: string;\n\n\t/**\n\t * The producer's env key, read by both {@link declare} and\n\t * {@link publisher} so the two cannot drift.\n\t */\n\tprivate readonly connectionKey: string;\n\n\tconstructor(\n\t\tpublic readonly name: TName,\n\t\t/**\n\t\t * The event contract — a map of event type → payload schema. Named\n\t\t * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,\n\t\t * which is the array of `MappedEvent`s a construct *publishes*.\n\t\t */\n\t\tpublic readonly eventSchemas: TEvents,\n\t\tlogger: Logger = DEFAULT_LOGGER,\n\t) {\n\t\tsuper(ConstructType.Topic, logger, [], []);\n\n\t\tthis.id = canonicalId(name);\n\t\tthis.connectionKey = provideKey(this.id, 'publisherConnectionString');\n\t}\n\n\t/**\n\t * What this topic is in the manifest.\n\t *\n\t * Only the producer's key: a subscriber is *bound* to a topic rather than\n\t * depending on it, so the binding is an edge the deploy target reads and not\n\t * an env key anyone can hold. Locally both sides meet on the same broker.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'topic',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.connectionKey],\n\t\t\t\t// The contract this topic carries. Structural: which events exist\n\t\t\t\t// is a fact about the application, and a subscriber binding to one\n\t\t\t\t// that does not is a mistake worth catching at build.\n\t\t\t\tevents: this.eventTypes,\n\t\t\t\t// Bound rather than declared here — a subscriber names the topic,\n\t\t\t\t// not the other way round — so the build fills these from what it\n\t\t\t\t// found. Nested when it does, because position is the trigger.\n\t\t\t\tsubscribers: [],\n\t\t\t},\n\t\t];\n\t}\n\n\t/** The event type names this topic carries. */\n\tget eventTypes(): (keyof TEvents & string)[] {\n\t\treturn Object.keys(this.eventSchemas) as (keyof TEvents & string)[];\n\t}\n\n\t/**\n\t * The producer side — a `Service` exposing an `EventPublisher` typed to the\n\t * union of this topic's events. Inject via `.publisher(topic.publisher)` (for\n\t * declarative `.event(...)`) or `.services([topic.publisher])` (to publish\n\t * imperatively). Reads `<NAME>_PUBLISHER_CONNECTION_STRING` and selects the\n\t * transport from the URL protocol — `pgboss://` locally, `sns://` deployed.\n\t *\n\t * Because it's a `Service`, the connection-string requirement is sniffed into\n\t * the manifest of whatever construct injects it (least-privilege linking).\n\t */\n\t/**\n\t * The topic as a dependency — what `.dependsOn([users])` dissolves into,\n\t * reachable as `services.users`.\n\t *\n\t * It is the producer, because publishing is the only thing depending on a\n\t * topic can mean: a subscriber *binds* with `s.topic(…)` instead, and is\n\t * deliberately never handed this. {@link publisher} is the same service\n\t * under its older `<name>Publisher` key.\n\t */\n\tget service(): Service<\n\t\tUncapitalize<TName>,\n\t\tEventPublisher<TopicMessage<TEvents>>\n\t> {\n\t\tconst { register } = this.publisher;\n\n\t\treturn {\n\t\t\tserviceName: serviceKey(this.id) as Uncapitalize<TName>,\n\t\t\tregister,\n\t\t};\n\t}\n\n\tget publisher(): Service<\n\t\t`${TName}Publisher`,\n\t\tEventPublisher<TopicMessage<TEvents>>\n\t> {\n\t\tconst envVar = this.connectionKey;\n\t\treturn {\n\t\t\tserviceName: `${this.name}Publisher`,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({\n\t\t\t\t\t\tconnectionString: get(envVar).string(),\n\t\t\t\t\t}))\n\t\t\t\t\t.parse();\n\n\t\t\t\treturn Publisher.fromConnectionString<TopicMessage<TEvents>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AA2CA,IAAa,QAAb,cAGU,UAAU;CA0BF;CAMA;CA/BjB,eAAe;CAEf,OAAO,QAAQ,KAAiD;EAC/D,OAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAAA,8BACrB;CACD;;;;;;;CAQA;;;;;CAMA;CAEA,YACC,MAMA,cACA,SAAiB,gBAChB;EACD,MAAA,gCAA2B,QAAQ,CAAC,GAAG,CAAC,CAAC;EATzB,KAAA,OAAA;EAMA,KAAA,eAAA;EAKhB,KAAK,KAAK,YAAY,IAAI;EAC1B,KAAK,gBAAgB,WAAW,KAAK,IAAI,2BAA2B;CACrE;;;;;;;;CASA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,aAAa;GAI7B,QAAQ,KAAK;GAIb,aAAa,CAAC;EACf,CACD;CACD;;CAGA,IAAI,aAAyC;EAC5C,OAAO,OAAO,KAAK,KAAK,YAAY;CACrC;;;;;;;;;;;;;;;;;;;;CAqBA,IAAI,UAGF;EACD,MAAM,EAAE,aAAa,KAAK;EAE1B,OAAO;GACN,aAAa,WAAW,KAAK,EAAE;GAC/B;EACD;CACD;CAEA,IAAI,YAGF;EACD,MAAM,SAAS,KAAK;EACpB,OAAO;GACN,aAAa,GAAG,KAAK,KAAK;GAC1B,MAAM,SAAS,EAAE,aAAa;IAC7B,MAAM,EAAE,qBAAqB,UAC3B,QAAQ,SAAS,EACjB,kBAAkB,IAAI,MAAM,CAAC,CAAC,OAAO,EACtC,EAAE,CAAC,CACF,MAAM;IAER,OAAO,UAAU,qBAChB,gBACD;GACD;EACD;CACD;AACD"}

package/dist/adaptors/aws.d.cts

@@ -3,7 +3,7 @@ import { a as FunctionHandler, r as Function$1 } from "../index-nBQT1tAh.cjs";
 import { t as Cron } from "../Cron-Bdcg9OAL.cjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.cjs";
 import { t as Telemetry } from "../telemetry-DGcFlVpB.cjs";
-import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-DbYQJgb-.cjs";
+import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-CjvraSfp.cjs";
 import { t as Queue } from "../Queue-Bhzi2WQC.cjs";
 import { t as Subscriber } from "../Subscriber-DQCaiOXF.cjs";
 import { EnvironmentParser } from "@geekmidas/envkit";

package/dist/adaptors/aws.d.mts

@@ -3,7 +3,7 @@ import { a as FunctionHandler, r as Function$1 } from "../index-DU3Twmwh.mjs";
 import { t as Cron } from "../Cron-AYpQq725.mjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.mjs";
 import { t as Telemetry } from "../telemetry-DGcFlVpB.mjs";
-import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-BxkRWQ8G.mjs";
+import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-Bmi2-PBN.mjs";
 import { t as Queue } from "../Queue-BoUA-e83.mjs";
 import { t as Subscriber } from "../Subscriber-CIO3pwji.mjs";
 import { EnvironmentParser } from "@geekmidas/envkit";

package/dist/adaptors/hono.d.cts

@@ -1,6 +1,6 @@
 import { t as StandardSchemaV1 } from "../index-CeEtxDmK.cjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.cjs";
-import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-DbYQJgb-.cjs";
+import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-CjvraSfp.cjs";
 import { EnvironmentParser } from "@geekmidas/envkit";
 import { EventPublisher } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";

package/dist/adaptors/hono.d.mts

@@ -1,6 +1,6 @@
 import { t as StandardSchemaV1 } from "../index-CeEtxDmK.mjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.mjs";
-import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-BxkRWQ8G.mjs";
+import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-Bmi2-PBN.mjs";
 import { EnvironmentParser } from "@geekmidas/envkit";
 import { EventPublisher } from "@geekmidas/events";
 import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";

package/dist/adaptors/testing.cjs

@@ -1,22 +1,31 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_auth = require("../auth.cjs");
 const require_functions = require("../functions-VnOTEp74.cjs");
 const require_Endpoint = require("../Endpoint-CtiPUpRX.cjs");
+const require_email = require("../email.cjs");
+const require_database_kysely = require("../database/kysely.cjs");
 const require_lazyAccessors = require("../lazyAccessors-Dx9NLwJZ.cjs");
+const require_Queue = require("../Queue-BB2-DgqJ.cjs");
+const require_Topic = require("../Topic-BaNCgP61.cjs");
 const require_HonoEndpointAdaptor = require("../HonoEndpointAdaptor-C9aivwKl.cjs");
 const require_processAudits = require("../processAudits-D_2W5x8k.cjs");
+let _geekmidas_manifest = require("@geekmidas/manifest");
 let _geekmidas_errors = require("@geekmidas/errors");
 let _geekmidas_envkit = require("@geekmidas/envkit");
 let _geekmidas_services = require("@geekmidas/services");
 let hono = require("hono");
 let _geekmidas_audit = require("@geekmidas/audit");
+let _geekmidas_testkit_context = require("@geekmidas/testkit/context");
 let msw = require("msw");
+let node_crypto = require("node:crypto");
+let _geekmidas_testkit_browser = require("@geekmidas/testkit/browser");
+let _geekmidas_testkit_mailbox = require("@geekmidas/testkit/mailbox");
+let _geekmidas_testkit_transactions = require("@geekmidas/testkit/transactions");
+let msw_node = require("msw/node");
+let vitest = require("vitest");
+let node_fs = require("node:fs");
+let node_url = require("node:url");
 //#region src/endpoints/MswEndpointAdaptor.ts
-/**
-* Header used to identify which test context a request belongs to.
-* Each concurrent test registers its own context (services, db transaction, etc.)
-* and the MSW handler looks it up by this header value.
-*/
-const TEST_CONTEXT_HEADER = "x-test-context-id";
 const MSW_HTTP_METHODS = [
 	"get",
 	"post",
@@ -84,11 +93,11 @@ function createMswHandlers(endpoints, options) {
 		const mswUrl = `${baseURL}${endpoint.route}`;
 		const mswMethod = msw.http[method];
 		handlers.push(mswMethod(mswUrl, async ({ request }) => {
-			const contextId = request.headers.get(TEST_CONTEXT_HEADER);
+			const contextId = request.headers.get(_geekmidas_testkit_context.TEST_CONTEXT_HEADER);
 			const ctx = contextId ? contexts.get(contextId) : void 0;
 			if (!ctx) return new Response(JSON.stringify({
 				error: "Missing or unknown test context ID",
-				hint: `Set the '${TEST_CONTEXT_HEADER}' header to a registered context ID`
+				hint: `Set the '${_geekmidas_testkit_context.TEST_CONTEXT_HEADER}' header to a registered context ID`
 			}), {
 				status: 500,
 				headers: { "content-type": "application/json" }
@@ -411,11 +420,308 @@ var TestSubscriberAdaptor = class TestSubscriberAdaptor {
 	}
 };
 //#endregion
-exports.TEST_CONTEXT_HEADER = TEST_CONTEXT_HEADER;
+//#region src/testing/manifest.ts
+/**
+* The test manifest: what `gkm test` knows about an app, written down for the
+* suite it starts.
+*
+* `gkm test` discovers the constructs, reconciles the test stage and resolves
+* its environment — then, until this existed, threw all of it away and left a
+* test to declare it again by hand. The manifest keeps it: which construct and
+* endpoint is exported where, and the environment the test stage resolved,
+* under the keys the constructs themselves derive. A feature test is built from
+* it, so nothing a test says can drift from what the app declares.
+*/
+/** The environment variable `gkm test` names the manifest in. */
+const TEST_MANIFEST_ENV = "GKM_TEST_MANIFEST";
+/**
+* Read a test manifest: from a path, a `file:` URL, or — given nothing — the
+* one `gkm test` named in `GKM_TEST_MANIFEST`.
+*/
+function loadTestManifest(from) {
+	const location = from ?? process.env["GKM_TEST_MANIFEST"];
+	if (!location) throw new NoTestManifest();
+	const path = location instanceof URL || location.startsWith("file:") ? (0, node_url.fileURLToPath)(location) : location;
+	return JSON.parse((0, node_fs.readFileSync)(path, "utf-8"));
+}
+/** A feature test ran without a manifest to build itself from. */
+var NoTestManifest = class extends Error {
+	constructor() {
+		super(`No test manifest: run the suite with \`gkm test\`, which writes one and names it in ${TEST_MANIFEST_ENV}.`);
+		this.name = "NoTestManifest";
+	}
+};
+//#endregion
+//#region src/testing/featureTest.ts
+/**
+* `featureTest`: an app, driven the way it runs deployed.
+*
+* A browser signs in and calls the API; the API calls the auth server; each
+* over its URL, each database in its own transaction. Nothing runs as a server:
+* every URL an app's constructs answer on is served in-process through MSW,
+* from the real handler, for the test that made the request. Everything else
+* with a real local equivalent — Postgres, Mailpit, MinIO — is used directly.
+*
+* It is built from the test manifest `gkm test` writes — the constructs and
+* endpoints the app exports, and the environment the test stage resolved — so
+* a test declares none of it. `gkm test` also generates the configured `it`
+* and a `Browser` with a typed client per surface:
+*
+* ```ts
+* import { it } from '#test';
+*
+* it('shows the signed-in user their profile', async ({ browser, mailbox }) => {
+*   await browser.auth.signIn.magicLink({ email: 'ada@shop.test' });
+*   await browser.visit((await mailbox('ada@shop.test').last()).link!);
+*   expect(await browser.api.get('/profile')).toMatchObject({ email: 'ada@shop.test' });
+* });
+* ```
+*/
+/** Every test in flight in this process, by id. */
+const contexts = /* @__PURE__ */ new Map();
+/** Databases already resolving to test transactions — patched once each. */
+const bound = /* @__PURE__ */ new WeakSet();
+function featureTest(options = {}) {
+	const manifest = options.manifest ?? loadTestManifest();
+	const BrowserClass = options.browser ?? _geekmidas_testkit_browser.Browser;
+	let app;
+	let network;
+	let restoreFetch = () => {};
+	(0, vitest.beforeAll)(async () => {
+		app = await load(manifest, options.database);
+		for (const database of app.databases) bindToTests(database);
+		network = (0, msw_node.setupServer)(...surfaceHandlers(app.endpoints, manifest.env), ...app.auths.map((auth) => authHandler(auth, manifest.env, app.envParser)));
+		network.listen({ onUnhandledRequest(request, print) {
+			if (isLocal(new URL(request.url))) return;
+			print.error();
+		} });
+		restoreFetch = (0, _geekmidas_testkit_context.installContextFetch)();
+	});
+	(0, vitest.afterAll)(() => {
+		restoreFetch();
+		network?.close();
+	});
+	const run = (fn) => async () => {
+		const id = (0, node_crypto.randomUUID)();
+		const state = {
+			transactions: new _geekmidas_testkit_transactions.TransactionRegistry(),
+			discovery: new _geekmidas_services.ServiceDiscovery(app.envParser),
+			surfaces: /* @__PURE__ */ new Map(),
+			auth: /* @__PURE__ */ new Map(),
+			addresses: /* @__PURE__ */ new Set(),
+			published: /* @__PURE__ */ new Map()
+		};
+		contexts.set(id, state);
+		await state.discovery.register(recorders(app.channels, state));
+		try {
+			await (0, _geekmidas_testkit_context.runInTestContext)(id, async () => {
+				const browser = new BrowserClass();
+				const restore = browser.install();
+				try {
+					await fn({
+						browser,
+						db: app.database ? await state.transactions.get(app.database.id, urlOf(app.database, app.envParser)) : void 0,
+						mailbox: (address) => {
+							if (!app.readMail) throw new NoInbox();
+							state.addresses.add(address);
+							return app.readMail(address);
+						},
+						published: (channel) => [...state.published.get(channel.id) ?? []],
+						subscriber: (subscriber) => new TestSubscriberAdaptor(subscriber, state.discovery),
+						queue: (queue) => new TestQueueAdaptor(queue, state.discovery)
+					});
+				} finally {
+					restore();
+				}
+			});
+		} finally {
+			contexts.delete(id);
+			await Promise.all([state.transactions.rollbackAll(), ...[...state.addresses].map((address) => app.readMail?.(address).clear())]);
+		}
+	};
+	const it = ((name, fn, timeout) => (0, vitest.test)(name, run(fn), timeout));
+	it.only = (name, fn, timeout) => vitest.test.only(name, run(fn), timeout);
+	it.skip = (name, fn, timeout) => vitest.test.skip(name, run(fn), timeout);
+	return it;
+}
+/**
+* Import what the manifest points at.
+*
+* The same modules the app runs, so a construct here *is* the app's construct —
+* the one its endpoints were built from — never a copy declared again.
+*/
+async function load(manifest, database) {
+	const envParser = new _geekmidas_envkit.EnvironmentParser({ ...manifest.env });
+	const imported = async ({ file, export: name }) => (await import(file))[name];
+	const constructs = await Promise.all(Object.values(manifest.constructs).map(({ source }) => imported(source)));
+	const endpoints = (await Promise.all(manifest.endpoints.map(({ source }) => imported(source)))).filter((value) => require_Endpoint.Endpoint.isEndpoint(value));
+	const unique = (values) => [...new Set(values)];
+	const databases = unique(constructs.filter((value) => value instanceof require_database_kysely.KyselyDatabase));
+	const auths = unique(constructs.filter((value) => value instanceof require_auth.BetterAuth));
+	const emails = unique(constructs.filter((value) => value instanceof require_email.Email));
+	const channels = unique(constructs.filter((value) => value instanceof require_Topic.Topic || value instanceof require_Queue.Queue));
+	const inbox = emails.map((email) => manifest.env[(0, _geekmidas_manifest.provideKey)(email.id, "inboxUrl")]).find(Boolean);
+	return {
+		envParser,
+		endpoints,
+		databases,
+		auths,
+		emails,
+		channels,
+		database: databaseOf(databases, endpoints, database),
+		...inbox ? { readMail: (0, _geekmidas_testkit_mailbox.createMailbox)({ inbox }) } : {}
+	};
+}
+/**
+* A publisher that records rather than sends, under every name a topic or
+* queue is injected by — `users`, and the older `usersPublisher`.
+*/
+function recorders(channels, state) {
+	return channels.flatMap((channel) => {
+		const publisher = { async publish(messages) {
+			state.published.set(channel.id, [...state.published.get(channel.id) ?? [], ...messages.map(({ type, payload }) => ({
+				type,
+				payload
+			}))]);
+		} };
+		return [channel.service.serviceName, channel.publisher.serviceName].map((serviceName) => ({
+			serviceName,
+			register: () => publisher
+		}));
+	});
+}
+/**
+* The database a test sees as `db`: the one named, or else the one the
+* endpoints were given with `.database()` — found by the service they hold,
+* which is the construct's own.
+*/
+function databaseOf(databases, endpoints, named) {
+	if (named) {
+		const found = databases.find(({ id }) => id === named);
+		if (!found) throw new UnknownDatabase(named, databases.map(({ id }) => id));
+		return found;
+	}
+	const services = new Set(endpoints.map((e) => e.databaseService).filter(Boolean));
+	return databases.find((database) => services.has(database.service));
+}
+/**
+* Make a database resolve, inside a test, to that test's transaction.
+*
+* Everything reaches a database through its service — an endpoint through
+* service discovery, the auth server through its tenant directly — so this is
+* the one place a test's connection can be handed over. Outside a test it is
+* the database it always was.
+*/
+function bindToTests(database) {
+	if (bound.has(database)) return;
+	bound.add(database);
+	const service = database.service;
+	const register = service.register;
+	service.register = (options) => {
+		const context = (0, _geekmidas_testkit_context.currentTestContext)();
+		const state = context && contexts.get(context.id);
+		if (!state) return register(options);
+		return state.transactions.get(database.id, urlOf(database, options.envParser));
+	};
+}
+function urlOf(database, envParser) {
+	return envParser.create((get) => ({ url: get((0, _geekmidas_manifest.provideKey)(database.id, "url")).string() })).parse().url;
+}
+/** Each surface's endpoints, served at its URL for the test that asked. */
+function surfaceHandlers(endpoints, env) {
+	const bySurface = /* @__PURE__ */ new Map();
+	for (const endpoint of endpoints) {
+		const surface = endpoint.surface?.id;
+		if (!surface) continue;
+		bySurface.set(surface, [...bySurface.get(surface) ?? [], endpoint]);
+	}
+	return [...bySurface].flatMap(([surface, served]) => {
+		const base = env[(0, _geekmidas_manifest.provideKey)(surface, "url")];
+		if (!base) return [];
+		return msw.http.all(`${trim(base)}/*`, ({ request }) => serve(request, async (state) => {
+			let app = state.surfaces.get(surface);
+			if (!app) {
+				app = Promise.resolve().then(() => {
+					const hono$1 = new hono.Hono();
+					require_HonoEndpointAdaptor.HonoEndpoint.addRoutes(served, state.discovery, hono$1);
+					return hono$1;
+				});
+				state.surfaces.set(surface, app);
+			}
+			return (await app).fetch(request);
+		}));
+	});
+}
+/** An auth server, served at its URL, on the transaction of the test that asked. */
+function authHandler(auth, env, envParser) {
+	const base = trim(env[(0, _geekmidas_manifest.provideKey)(auth.id, "url")] ?? "");
+	return msw.http.all(`${base}/*`, ({ request }) => serve(request, async (state) => {
+		let app = state.auth.get(auth);
+		if (!app) {
+			app = auth.server({
+				envParser,
+				context: _geekmidas_services.serviceContext
+			}).then(({ app }) => app);
+			state.auth.set(auth, app);
+		}
+		return (await app).fetch(request);
+	}));
+}
+/** Handle a request as the server side of the test it was made for. */
+async function serve(request, handle) {
+	const id = (0, _geekmidas_testkit_context.testContextOf)(request);
+	const state = id ? contexts.get(id) : void 0;
+	if (!id || !state) throw new UnknownTestContext(request.url, id);
+	return (0, _geekmidas_testkit_context.runAsServer)(id, () => handle(state));
+}
+function trim(url) {
+	return url.replace(/\/$/, "");
+}
+function isLocal(url) {
+	return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname.endsWith(".localhost");
+}
+/** A request reached an in-process server without a test to belong to. */
+var UnknownTestContext = class extends Error {
+	url;
+	id;
+	constructor(url, id) {
+		super(id ? `${url} was requested for test ${id}, which is not running. A request that outlives its test — an un-awaited call — lands here.` : `${url} was requested outside any test. Make the request inside a featureTest, so it reaches that test's transactions.`);
+		this.url = url;
+		this.id = id;
+		this.name = "UnknownTestContext";
+	}
+};
+/** `mailbox` was used in an app that declares no Email construct. */
+var NoInbox = class extends Error {
+	constructor() {
+		super("mailbox() reads the inbox of the app's Email construct, and none was found in featureTest's modules — or `gkm test` did not inject its <ID>_INBOX_URL.");
+		this.name = "NoInbox";
+	}
+};
+/** `featureTest({ database })` named a database the app does not declare. */
+var UnknownDatabase = class extends Error {
+	id;
+	declared;
+	constructor(id, declared) {
+		super(`featureTest was asked for the database '${id}', and the app declares ${declared.length ? declared.map((d) => `'${d}'`).join(", ") : "none"}.`);
+		this.id = id;
+		this.declared = declared;
+		this.name = "UnknownDatabase";
+	}
+};
+//#endregion
+exports.NoInbox = NoInbox;
+exports.NoTestManifest = NoTestManifest;
+exports.TEST_CONTEXT_HEADER = _geekmidas_testkit_context.TEST_CONTEXT_HEADER;
+exports.TEST_MANIFEST_ENV = TEST_MANIFEST_ENV;
 exports.TestEndpointAdaptor = TestEndpointAdaptor;
 exports.TestFunctionAdaptor = TestFunctionAdaptor;
 exports.TestQueueAdaptor = TestQueueAdaptor;
 exports.TestSubscriberAdaptor = TestSubscriberAdaptor;
+exports.UnknownDatabase = UnknownDatabase;
+exports.UnknownTestContext = UnknownTestContext;
 exports.createMswHandlers = createMswHandlers;
+exports.featureTest = featureTest;
+exports.loadTestManifest = loadTestManifest;
 
 //# sourceMappingURL=testing.cjs.map