@geekmidas/constructs 10.0.0-alpha.37 → 10.0.0-alpha.39

package/dist/Topic-Ct3Le8Wt.mjs

@@ -1,103 +0,0 @@
-import { t as Construct } from "./Construct-Detz65RA.mjs";
-import { derivedFrom } from "./construct-interface.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 derivedFrom({
-			serviceName: `${this.name}Publisher`,
-			async register({ envParser }) {
-				const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
-				return Publisher.fromConnectionString(connectionString);
-			}
-		}, this);
-	}
-};
-//#endregion
-export { Topic as t };
-
-//# sourceMappingURL=Topic-Ct3Le8Wt.mjs.map

package/dist/Topic-Ct3Le8Wt.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Topic-Ct3Le8Wt.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';\nimport { derivedFrom } from '../construct-interface';\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\t// Marked with this construct, so whatever it is injected into records an\n\t\t// edge to it — and is given this construct's connection string.\n\t\treturn derivedFrom(\n\t\t\t{\n\t\t\t\tserviceName: `${this.name}Publisher`,\n\t\t\t\tasync register({ envParser }) {\n\t\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t\t.create((get) => ({\n\t\t\t\t\t\t\tconnectionString: get(envVar).string(),\n\t\t\t\t\t\t}))\n\t\t\t\t\t\t.parse();\n\n\t\t\t\t\treturn Publisher.fromConnectionString<TopicMessage<TEvents>>(\n\t\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t},\n\t\t\tthis,\n\t\t);\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA4CA,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;EAGpB,OAAO,YACN;GACC,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,GACA,IACD;CACD;AACD"}

package/dist/Topic-D5rlM9wS.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Topic-D5rlM9wS.cjs","names":["Construct","DEFAULT_LOGGER","canonicalId","provideKey","serviceKey","derivedFrom","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';\nimport { derivedFrom } from '../construct-interface';\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\t// Marked with this construct, so whatever it is injected into records an\n\t\t// edge to it — and is given this construct's connection string.\n\t\treturn derivedFrom(\n\t\t\t{\n\t\t\t\tserviceName: `${this.name}Publisher`,\n\t\t\t\tasync register({ envParser }) {\n\t\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t\t.create((get) => ({\n\t\t\t\t\t\t\tconnectionString: get(envVar).string(),\n\t\t\t\t\t\t}))\n\t\t\t\t\t\t.parse();\n\n\t\t\t\t\treturn Publisher.fromConnectionString<TopicMessage<TEvents>>(\n\t\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t},\n\t\t\tthis,\n\t\t);\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA4CA,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;EAGpB,OAAOC,4BAAAA,YACN;GACC,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,GACA,IACD;CACD;AACD"}

package/dist/Topic-D6blllEn.d.cts

@@ -1,89 +0,0 @@
-import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
-import { t as Construct } from "./Construct-DTqYvkPG.cjs";
-import { EventPublisher, PublishableMessage } from "@geekmidas/events";
-import { Logger } from "@geekmidas/logger";
-import { InferStandardSchema } from "@geekmidas/schema";
-import { Service } from "@geekmidas/services";
-import { Declaration } from "@geekmidas/manifest";
-//#region src/topic/Topic.d.ts
-/** A topic's event contract — a map of event type → payload schema. */
-type TopicEvents = Record<string, StandardSchemaV1>;
-/**
- * The union of wire messages a topic carries, derived from its event map:
- * `{ type: 'user.created'; payload: … } | { type: 'user.updated'; payload: … }`.
- */
-type TopicMessage<TEvents extends TopicEvents> = { [K in keyof TEvents & string]: PublishableMessage<K, InferStandardSchema<TEvents[K]>>; }[keyof TEvents & string];
-/**
- * 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.
- */
-declare class Topic<TName extends string = string, TEvents extends TopicEvents = TopicEvents> extends Construct {
-  readonly name: TName;
-  /**
-   * The event contract — a map of event type → payload schema. Named
-   * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,
-   * which is the array of `MappedEvent`s a construct *publishes*.
-   */
-  readonly eventSchemas: TEvents;
-  __IS_TOPIC__: boolean;
-  static isTopic(obj: unknown): obj is Topic<string, TopicEvents>;
-  /**
-   * 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.
-   */
-  readonly id: string;
-  /**
-   * The producer's env key, read by both {@link declare} and
-   * {@link publisher} so the two cannot drift.
-   */
-  private readonly connectionKey;
-  constructor(name: TName,
-  /**
-   * The event contract — a map of event type → payload schema. Named
-   * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,
-   * which is the array of `MappedEvent`s a construct *publishes*.
-   */
-  eventSchemas: TEvents, logger?: Logger);
-  /**
-   * 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(): Declaration[];
-  /** The event type names this topic carries. */
-  get eventTypes(): (keyof TEvents & string)[];
-  /**
-   * 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(): Service<Uncapitalize<TName>, EventPublisher<TopicMessage<TEvents>>>;
-  get publisher(): Service<`${TName}Publisher`, EventPublisher<TopicMessage<TEvents>>>;
-}
-//#endregion
-export { TopicEvents as n, TopicMessage as r, Topic as t };
-//# sourceMappingURL=Topic-D6blllEn.d.cts.map

package/dist/Topic-D6blllEn.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Topic-D6blllEn.d.cts","names":[],"sources":["../src/topic/Topic.ts"],"mappings":";;;;;;;;;KAqBY,cAAc,eAAe;;;;;KAM7B,aAAa,gBAAgB,kBACvC,WAAW,mBAAmB,mBAC9B,GACA,oBAAoB,QAAQ,cAEtB;;;;;;;;;;;cAYK,MACZ,+BACA,gBAAgB,cAAc,qBACrB;WA0BQ,MAAM;;;;;;WAMN,cAAc;EA/B/B;SAEO,QAAQ,eAAe,OAAO,cAAc;;;;;;;WAc1C;;;;;mBAMQ;EAEjB,YACiB,MAAM,OAMN;;;;;;EAAA,cAAc,SAC9B,SAAQ;;;;;;;;EAeT,WAAW;;MAmBP,qBAAqB;;;;;;;;;;;;;;;;;;;;MAuBrB,WAAW,QACd,aAAa,QACb,eAAe,aAAa;MAUzB,aAAa,WACb,kBACH,eAAe,aAAa"}

package/dist/Topic-DVvheJ_-.d.mts

@@ -1,89 +0,0 @@
-import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
-import { t as Construct } from "./Construct-pVadmURD.mjs";
-import { Declaration } from "@geekmidas/manifest";
-import { EventPublisher, PublishableMessage } from "@geekmidas/events";
-import { Service } from "@geekmidas/services";
-import { Logger } from "@geekmidas/logger";
-import { InferStandardSchema } from "@geekmidas/schema";
-//#region src/topic/Topic.d.ts
-/** A topic's event contract — a map of event type → payload schema. */
-type TopicEvents = Record<string, StandardSchemaV1>;
-/**
- * The union of wire messages a topic carries, derived from its event map:
- * `{ type: 'user.created'; payload: … } | { type: 'user.updated'; payload: … }`.
- */
-type TopicMessage<TEvents extends TopicEvents> = { [K in keyof TEvents & string]: PublishableMessage<K, InferStandardSchema<TEvents[K]>>; }[keyof TEvents & string];
-/**
- * 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.
- */
-declare class Topic<TName extends string = string, TEvents extends TopicEvents = TopicEvents> extends Construct {
-  readonly name: TName;
-  /**
-   * The event contract — a map of event type → payload schema. Named
-   * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,
-   * which is the array of `MappedEvent`s a construct *publishes*.
-   */
-  readonly eventSchemas: TEvents;
-  __IS_TOPIC__: boolean;
-  static isTopic(obj: unknown): obj is Topic<string, TopicEvents>;
-  /**
-   * 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.
-   */
-  readonly id: string;
-  /**
-   * The producer's env key, read by both {@link declare} and
-   * {@link publisher} so the two cannot drift.
-   */
-  private readonly connectionKey;
-  constructor(name: TName,
-  /**
-   * The event contract — a map of event type → payload schema. Named
-   * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,
-   * which is the array of `MappedEvent`s a construct *publishes*.
-   */
-  eventSchemas: TEvents, logger?: Logger);
-  /**
-   * 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(): Declaration[];
-  /** The event type names this topic carries. */
-  get eventTypes(): (keyof TEvents & string)[];
-  /**
-   * 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(): Service<Uncapitalize<TName>, EventPublisher<TopicMessage<TEvents>>>;
-  get publisher(): Service<`${TName}Publisher`, EventPublisher<TopicMessage<TEvents>>>;
-}
-//#endregion
-export { TopicEvents as n, TopicMessage as r, Topic as t };
-//# sourceMappingURL=Topic-DVvheJ_-.d.mts.map

package/dist/Topic-DVvheJ_-.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Topic-DVvheJ_-.d.mts","names":[],"sources":["../src/topic/Topic.ts"],"mappings":";;;;;;;;;KAqBY,cAAc,eAAe;;;;;KAM7B,aAAa,gBAAgB,kBACvC,WAAW,mBAAmB,mBAC9B,GACA,oBAAoB,QAAQ,cAEtB;;;;;;;;;;;cAYK,MACZ,+BACA,gBAAgB,cAAc,qBACrB;WA0BQ,MAAM;;;;;;WAMN,cAAc;EA/B/B;SAEO,QAAQ,eAAe,OAAO,cAAc;;;;;;;WAc1C;;;;;mBAMQ;EAEjB,YACiB,MAAM,OAMN;;;;;;EAAA,cAAc,SAC9B,SAAQ;;;;;;;;EAeT,WAAW;;MAmBP,qBAAqB;;;;;;;;;;;;;;;;;;;;MAuBrB,WAAW,QACd,aAAa,QACb,eAAe,aAAa;MAUzB,aAAa,WACb,kBACH,eAAe,aAAa"}