@geekmidas/constructs 9.0.2 → 10.0.0-alpha.0

package/dist/{Queue-HBDf0fqz.d.mts → Queue-DpUeqdC8.d.mts}

@@ -1,4 +1,5 @@
-import { Construct } from "./Construct-DCMuYOox.mjs";
+import { Construct } from "./Construct-B-xc0SE9.mjs";
+import { Declaration } from "@geekmidas/manifest";
 import { Service, ServiceRecord } from "@geekmidas/services";
 import { EventPublisher, PublishableMessage } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
@@ -36,9 +37,38 @@ declare class Queue<TName extends string = string, TMessage extends StandardSche
   readonly fifo?: boolean | undefined;
   __IS_QUEUE__: boolean;
   static isQueue(obj: unknown): obj is Queue<string, StandardSchemaV1, Service[], Logger>;
+  /**
+   * The canonical id this queue is declared under.
+   *
+   * Derived from the name rather than given separately, so `emails` and
+   * `Emails` are one queue. The name stays what it was: it is the wire `type`
+   * a producer sends and the worker subscribes to, and changing that would
+   * silently orphan in-flight messages.
+   */
+  readonly id: string;
+  /**
+   * The producer's env key. Read by both {@link declare} and
+   * {@link publisher}, so what the target publishes and what the producer
+   * looks up cannot drift.
+   */
+  private readonly connectionKey;
   constructor(name: TName, handler: QueueHandler<TMessage, TServices, TLogger>, messageSchema: TMessage, timeout?: number, services?: TServices, logger?: TLogger, /** SQS event-source batch size (deployed). */
   batchSize?: number | undefined, /** Whether the queue is FIFO (deployed). */
-  fifo?: boolean | undefined);
+  fifo?: boolean | undefined,
+  /**
+   * The construct ids the *worker* `.dependsOn()` named — last, so no
+   * existing positional argument moves.
+   */
+  constructs?: string[]);
+  /**
+   * What this queue is in the manifest.
+   *
+   * A queue is a resource, not a handler: the worker is reached *through* it,
+   * so the declaration carries the producer's key and nothing about the code
+   * that drains it. The local target reads this to know which broker has to be
+   * running and what connection string to inject.
+   */
+  declare(): Declaration[];
   /**
    * The producer side — a `Service` exposing an `EventPublisher` typed to this
    * queue's message. Inject it via `.services([queue.publisher])`; the handler
@@ -50,6 +80,16 @@ declare class Queue<TName extends string = string, TMessage extends StandardSche
    * `Construct.getEnvironment()` sniffs it, so the env requirement flows into
    * the manifest and infra links exactly this queue with least privilege.
    */
+  /**
+   * The queue as a dependency — what `.dependsOn([emailsQueue])` dissolves
+   * into, reachable as `services.emails`.
+   *
+   * It is the producer: a consumer is the worker written right here, so the
+   * only thing another construct can want from a queue is the ability to send
+   * to it. {@link publisher} is the same service under its older
+   * `<name>Publisher` key, kept for `.services([queue.publisher])`.
+   */
+  get service(): Service<Uncapitalize<TName>, EventPublisher<QueueMessage<TName, TMessage>>>;
   get publisher(): Service<`${TName}Publisher`, EventPublisher<QueueMessage<TName, TMessage>>>;
 }
 /** The context a queue handler receives — a batch of typed messages. */
@@ -60,7 +100,6 @@ type QueueContext<TMessage extends StandardSchemaV1, TServices extends Service[]
 };
 type QueueHandler<TMessage extends StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> = (ctx: QueueContext<TMessage, TServices, TLogger>) => unknown | Promise<unknown>;
 //# sourceMappingURL=Queue.d.ts.map
-
 //#endregion
 export { Queue, QueueContext, QueueHandler, QueueMessage };
-//# sourceMappingURL=Queue-HBDf0fqz.d.mts.map
+//# sourceMappingURL=Queue-DpUeqdC8.d.mts.map

package/dist/Queue-DpUeqdC8.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue-DpUeqdC8.d.mts","names":[],"sources":["../src/queue/Queue.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;AAyBA;;;;AAGkD,KAHtC,YAGsC,CAAA,cAAA,MAAA,EAAA,iBADhC,gBACgC,CAAA,GAA9C,kBAA8C,CAA3B,KAA2B,EAApB,mBAAoB,CAAA,QAAA,CAAA,CAAA;;;AAA5B;AAWtB;;;;;;AAI0B,cAJb,KAIa,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,iBAFR,gBAEQ,GAFW,gBAEX,EAAA,kBADP,OACO,EAAA,GAAA,EAAA,EAAA,gBAAT,MAAS,GAAA,MAAA,CAAA,SAChB,SADgB,CACN,OADM,EAAA,MAAA,EAAA,SAAA,EAAA,SAAA,EACiC,SADjC,CAAA,CAAA;EAAM,SACZ,IAAA,EA+BI,KA/BJ;EAAO,SAAgC,OAAA,EAgChC,YAhCgC,CAgCnB,QAhCmB,EAgCT,SAhCS,EAgCE,OAhCF,CAAA;EAAS,SA+B5C,aAAA,EAES,QAFT;EAAK,SACW,OAAA,EAAA,MAAA;EAAQ,SAAE,QAAA,EAGb,SAHa;EAAS,SAAE,MAAA,EAI1B,OAJ0B;EAAO;EAA7B,SACN,SAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAQ;EAEK,SACX,IAAA,CAAA,EAAA,OAAA,GAAA,SAAA;EAAO,YA/BjB,EAAA,OAAA;EAAgB,OAAE,OAAA,CAAA,GAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAhC,KAAgC,CAAA,MAAA,EAAlB,gBAAkB,EAAA,OAAA,EAAA,EAAW,MAAX,CAAA;EAAO;;;;;;;;EA4BT,SAEJ,EAAA,EAAA,MAAA;EAAsC;;;;;EAoFxC,iBAAE,aAAA;EAAQ,WAA5B,CAAA,IAAA,EAxFO,KAwFP,EAAA,OAAA,EAvFU,YAuFV,CAvFuB,QAuFvB,EAvFiC,SAuFjC,EAvF4C,OAuF5C,CAAA,EAAA,aAAA,EAtFgB,QAsFhB,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EApFoB,SAoFpB,EAAA,MAAA,CAAA,EAnFkB,OAmFlB,EAAY;EAAb,SAFA,CAAA,EAAA,MAAA,GAAA,SAAA,EAAO;EAab,IACoB,CAAA,EAAA,OAAA,GAAA,SAAA;EAAK;;;;EAFV,UAjIf,CAAA,EAAA,MAAA,EAAA;EAAS;AAwJnB;;;;;;;EAKuC,OAA5B,CAAA,CAAA,EArFC,WAqFD,EAAA;EAAmB;;;AAEd;AAGhB;;;;;;;EAK2B;;;;AACL;;;;;iBAnDN,QACd,aAAa,QACb,eAAe,aAAa,OAAO;mBAUnB,WACb,kBACH,eAAe,aAAa,OAAO;;;KAqBzB,8BACM,oCACC,gCACF,SAAS;YAEf,oBAAoB;YACpB,cAAc;UAChB;;KAGG,8BACM,oCACC,gCACF,SAAS,gBAEpB,aAAa,UAAU,WAAW,uBACzB"}

package/dist/{Subscriber-B69ngPwl.d.cts → Subscriber-4rBJgDKI.d.mts}

@@ -1,8 +1,8 @@
-import { Construct } from "./Construct-_1wX7p_Y.cjs";
+import { Construct } from "./Construct-B-xc0SE9.mjs";
+import { Service, ServiceRecord } from "@geekmidas/services";
 import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { InferStandardSchema } from "@geekmidas/schema";
-import { Service, ServiceRecord } from "@geekmidas/services";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/subscribers/Subscriber.d.ts
@@ -33,7 +33,12 @@ declare class Subscriber<TServices extends Service[] = [], TLogger extends Logge
    * subscription. Undefined when the subscriber's events are typed from a
    * (hand-written) publisher instead.
    */
-  topicName?: string | undefined);
+  topicName?: string | undefined,
+  /**
+   * The construct ids `.dependsOn()` named — last, so no existing positional
+   * argument moves.
+   */
+  constructs?: string[]);
   get subscribedEvents(): TSubscribedEvents | undefined;
 }
 type SubscriberHandler<TEventPublisher extends EventPublisher<any> | undefined, TSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][], TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined> = (ctx: SubscriberContext<TEventPublisher, TSubscribedEvents, TServices, TLogger>) => OutSchema extends StandardSchemaV1 ? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>> : any | Promise<any>;
@@ -44,4 +49,4 @@ type SubscriberContext<TEventPublisher extends EventPublisher<any> | undefined,
 };
 //#endregion
 export { Subscriber, SubscriberHandler };
-//# sourceMappingURL=Subscriber-B69ngPwl.d.cts.map
+//# sourceMappingURL=Subscriber-4rBJgDKI.d.mts.map

package/dist/{Subscriber-B69ngPwl.d.cts.map → Subscriber-4rBJgDKI.d.mts.map}

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

package/dist/{Subscriber-D8Xm-86W.d.mts → Subscriber-DVQowdyj.d.cts}

@@ -1,8 +1,8 @@
-import { Construct } from "./Construct-DCMuYOox.mjs";
-import { Service, ServiceRecord } from "@geekmidas/services";
+import { Construct } from "./Construct-WhCXIOPV.cjs";
 import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { InferStandardSchema } from "@geekmidas/schema";
+import { Service, ServiceRecord } from "@geekmidas/services";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/subscribers/Subscriber.d.ts
@@ -16,7 +16,7 @@ declare class Subscriber<TServices extends Service[] = [], TLogger extends Logge
   readonly outputSchema?: OutSchema | undefined;
   readonly services: TServices;
   readonly logger: TLogger;
-  readonly publisherService?: Service<TEventPublisherServiceName, TEventPublisher>;
+  readonly publisherService?: Service<TEventPublisherServiceName, TEventPublisher> | undefined;
   /**
    * The name of the {@link Topic} this subscriber binds to (via
    * `s.topic(topic)`), recorded for the manifest so infra wires the SNS
@@ -26,14 +26,19 @@ declare class Subscriber<TServices extends Service[] = [], TLogger extends Logge
   readonly topicName?: string | undefined;
   __IS_SUBSCRIBER__: boolean;
   static isSubscriber(obj: any): obj is Subscriber<any, any, any, any, any, any>;
-  constructor(handler: SubscriberHandler<TEventPublisher, TSubscribedEvents, TServices, TLogger, OutSchema>, timeout?: number, _subscribedEvents?: TSubscribedEvents | undefined, outputSchema?: OutSchema | undefined, services?: TServices, logger?: TLogger, publisherService?: Service<TEventPublisherServiceName, TEventPublisher>,
+  constructor(handler: SubscriberHandler<TEventPublisher, TSubscribedEvents, TServices, TLogger, OutSchema>, timeout?: number, _subscribedEvents?: TSubscribedEvents | undefined, outputSchema?: OutSchema | undefined, services?: TServices, logger?: TLogger, publisherService?: Service<TEventPublisherServiceName, TEventPublisher> | undefined,
   /**
    * The name of the {@link Topic} this subscriber binds to (via
    * `s.topic(topic)`), recorded for the manifest so infra wires the SNS
    * subscription. Undefined when the subscriber's events are typed from a
    * (hand-written) publisher instead.
    */
-  topicName?: string | undefined);
+  topicName?: string | undefined,
+  /**
+   * The construct ids `.dependsOn()` named — last, so no existing positional
+   * argument moves.
+   */
+  constructs?: string[]);
   get subscribedEvents(): TSubscribedEvents | undefined;
 }
 type SubscriberHandler<TEventPublisher extends EventPublisher<any> | undefined, TSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][], TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined> = (ctx: SubscriberContext<TEventPublisher, TSubscribedEvents, TServices, TLogger>) => OutSchema extends StandardSchemaV1 ? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>> : any | Promise<any>;
@@ -44,4 +49,4 @@ type SubscriberContext<TEventPublisher extends EventPublisher<any> | undefined,
 };
 //#endregion
 export { Subscriber, SubscriberHandler };
-//# sourceMappingURL=Subscriber-D8Xm-86W.d.mts.map
+//# sourceMappingURL=Subscriber-DVQowdyj.d.cts.map

package/dist/Subscriber-DVQowdyj.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Subscriber-DVQowdyj.d.cts","names":[],"sources":["../src/subscribers/Subscriber.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAYK,wCACe,8DAEhB,mBAAmB,sBACpB,QAAQ,wBAAwB;QAAqB;AAPA,CAAA,CAAA,GAGnD,KAAA;AAAoB,cAOZ,UAPY,CAAA,kBAQN,OARM,EAAA,GAAA,EAAA,EAAA,gBASR,MATQ,GASC,MATD,EAAA,kBAUN,gBAVM,GAAA,SAAA,GAAA,SAAA,EAAA,wBAWA,cAXA,CAAA,GAAA,CAAA,GAAA,SAAA,GAAA,SAAA,EAAA,mCAAA,MAAA,GAAA,MAAA,EAAA,0BAcvB,uBAduB,CAcC,eAdD,CAAA,CAAA,MAAA,CAAA,EAAA,GAc8B,uBAd9B,CAcsD,eAdtD,CAAA,CAAA,MAAA,CAAA,EAAA,CAAA,SAef,SAfe,CAgBxB,OAhBwB,EAiBxB,0BAjBwB,EAkBxB,eAlBwB,EAmBxB,SAnBwB,EAoBxB,SApBwB,CAAA,CAAA;EAAA,SACL,OAAA,EAkCO,iBAlCP,CAmCjB,eAnCiB,EAoCjB,iBApCiB,EAqCjB,SArCiB,EAsCjB,OAtCiB,EAuCjB,SAvCiB,CAAA;EAAc,SAE9B,OAAA,EAAA,MAAA;EAAU,UAAS,iBAAA,CAAA,EAwCS,iBAxCT,GAAA,SAAA;EAAc,SACF,YAAA,CAAA,EAwCO,SAxCP,GAAA,SAAA;EAAU,SAAlC,QAAA,EAyC0B,SAzC1B;EAAuB,SAAsB,MAAA,EA0CrB,OA1CqB;EAAW,SAAhE,gBAAA,CAAA,EA2C2C,OA3C3C,CA4CA,0BA5CA,EA6CA,eA7CA,CAAA,GAAA,SAAA;EAAO;AAGV;;;;;EAEgC,SACb,SAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAgB,iBACV,EAAA,OAAA;EAAc,OAGb,YAAA,CAAA,GAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAYf,UAZe,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;EAAe,WAAvC,CAAA,OAAA,EAqByB,iBArBzB,CAsBC,eAtBD,EAuBC,iBAvBD,EAwBC,SAxBD,EAyBC,OAzBD,EA0BC,SA1BD,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,iBAAA,CAAA,EA6B8B,iBA7B9B,GAAA,SAAA,EAAA,YAAA,CAAA,EA8BwC,SA9BxC,GAAA,SAAA,EAAA,QAAA,CAAA,EA+BmC,SA/BnC,EAAA,MAAA,CAAA,EAgCiC,OAhCjC,EAAA,gBAAA,CAAA,EAiC4C,OAjC5C,CAkCC,0BAlCD,EAmCC,eAnCD,CAAA,GAAA,SAAA;EAAuB;;;;;;EAKf,SACT,CAAA,EAAA,MAAA,GAAA,SAAA;EAAS;;;;EAmBA,UACP,CAAA,EAAA,MAAA,EAAA;EAAS,IALe,gBAAA,CAAA,CAAA,EA2CF,iBA3CE,GAAA,SAAA;;AASe,KAwC9B,iBAxC8B,CAAA,wBAyCjB,cAzCiB,CAAA,GAAA,CAAA,GAAA,SAAA,EAAA,0BA0Cf,uBA1Ce,CA0CS,eA1CT,CAAA,CAAA,MAAA,CAAA,EAAA,EAAA,kBA2CvB,OA3CuB,EAAA,GAAA,EAAA,EAAA,gBA4CzB,MA5CyB,GA4ChB,MA5CgB,EAAA,kBA6CvB,gBA7CuB,GAAA,SAAA,GAAA,SAAA,CAAA,GAAA,CAAA,GAAA,EA+CpC,iBA/CoC,CAgDxC,eAhDwC,EAiDxC,iBAjDwC,EAkDxC,SAlDwC,EAmDxC,OAnDwC,CAAA,EAAA,GAqDrC,SArDqC,SAqDnB,gBArDmB,GAsDvC,mBAtDuC,CAsDnB,SAtDmB,CAAA,GAsDN,OAtDM,CAsDE,mBAtDF,CAsDsB,SAtDtB,CAAA,CAAA,GAAA,GAAA,GAuDjC,OAvDiC,CAAA,GAAA,CAAA;AACL,KAyDzB,iBAzDyB,CAAA,wBA0DZ,cA1DY,CAAA,GAAA,CAAA,GAAA,SAAA,EAAA,0BA2DV,uBA3DU,CA2Dc,eA3Dd,CAAA,CAAA,MAAA,CAAA,EAAA,EAAA,kBA4DlB,OA5DkB,EAAA,GAAA,EAAA,EAAA,gBA6DpB,MA7DoB,GA6DX,MA7DW,CAAA,GAAA;EAAS,MACX,EA8D1B,oBA9D0B,CA8DL,eA9DK,EA8DY,iBA9DZ,CAAA,EAAA;EAAO,QAEvC,EA6DQ,aA7DR,CA6DsB,SA7DtB,CAAA;EAA0B,MAC1B,EA6DM,OA7DN;CAAe"}

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

@@ -1,9 +1,10 @@
-import { Construct } from "./Construct-_1wX7p_Y.cjs";
+import { Construct } from "./Construct-WhCXIOPV.cjs";
 import { EventPublisher, PublishableMessage } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { InferStandardSchema } from "@geekmidas/schema";
 import { Service } from "@geekmidas/services";
 import { StandardSchemaV1 } from "@standard-schema/spec";
+import { Declaration } from "@geekmidas/manifest";
 
 //#region src/topic/Topic.d.ts
 /** A topic's event contract — a map of event type → payload schema. */
@@ -33,6 +34,18 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
   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
@@ -40,6 +53,14 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
    * 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)[];
   /**
@@ -52,9 +73,19 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
    * 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>>>;
 }
 //# sourceMappingURL=Topic.d.ts.map
 //#endregion
 export { Topic, TopicEvents, TopicMessage };
-//# sourceMappingURL=Topic-C5ZMfveW.d.cts.map
+//# sourceMappingURL=Topic-Ohx9dvWr.d.cts.map

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

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

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

@@ -1,4 +1,5 @@
-import { Construct } from "./Construct-DCMuYOox.mjs";
+import { Construct } from "./Construct-B-xc0SE9.mjs";
+import { Declaration } from "@geekmidas/manifest";
 import { Service } from "@geekmidas/services";
 import { EventPublisher, PublishableMessage } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
@@ -33,6 +34,18 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
   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
@@ -40,6 +53,14 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
    * 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)[];
   /**
@@ -52,9 +73,19 @@ declare class Topic<TName extends string = string, TEvents extends TopicEvents =
    * 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>>>;
 }
 //# sourceMappingURL=Topic.d.ts.map
 //#endregion
 export { Topic, TopicEvents, TopicMessage };
-//# sourceMappingURL=Topic-DT10AqHk.d.mts.map
+//# sourceMappingURL=Topic-cmy2jOUy.d.mts.map

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

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

package/dist/adaptors/aws.cjs

@@ -1,23 +1,38 @@
-const require_Construct = require('../Construct-vXMZJgRp.cjs');
-require('../functions-C8i1kCMM.cjs');
-const require_publisher = require('../publisher-lFQleddL.cjs');
-const require_AWSScheduledFunction = require('../AWSScheduledFunction-DbkDr8CA.cjs');
-const require_lazyAccessors = require('../lazyAccessors-DmTG8sQH.cjs');
-const require_processAudits = require('../processAudits-CKjjivyz.cjs');
-const __geekmidas_errors = require_Construct.__toESM(require("@geekmidas/errors"));
-const __geekmidas_services = require_Construct.__toESM(require("@geekmidas/services"));
-const __middy_core = require_Construct.__toESM(require("@middy/core"));
-const __geekmidas_db_rls = require_Construct.__toESM(require("@geekmidas/db/rls"));
-const qs = require_Construct.__toESM(require("qs"));
+const require_chunk = require('../chunk-DWy1uDak.cjs');
+require('../construct-interface-BfjcOD_E.cjs');
+require('../Construct-roId57cU.cjs');
+require('../functions-DukjG8ov.cjs');
+require('../clone-Dy0cR2SZ.cjs');
+const require_Endpoint = require('../Endpoint-BBkV6l0k.cjs');
+const require_surfaceEnv = require('../surfaceEnv-BFXEms2f.cjs');
+const require_publisher = require('../publisher-CqGsXB2X.cjs');
+const require_AWSScheduledFunction = require('../AWSScheduledFunction-qu4ieRZR.cjs');
+const require_processAudits = require('../processAudits-Bc8rz6Ev.cjs');
+const require_lazyAccessors = require('../lazyAccessors-DrJj8NpA.cjs');
+const __geekmidas_errors = require_chunk.__toESM(require("@geekmidas/errors"));
+const __geekmidas_services = require_chunk.__toESM(require("@geekmidas/services"));
+const __middy_core = require_chunk.__toESM(require("@middy/core"));
+const __geekmidas_db_rls = require_chunk.__toESM(require("@geekmidas/db/rls"));
+const qs = require_chunk.__toESM(require("qs"));
 
 //#region src/endpoints/AmazonApiGatewayEndpointAdaptor.ts
-var import_lodash = require_Construct.__toESM(require_lazyAccessors.require_lodash(), 1);
+var import_lodash = require_chunk.__toESM(require_Endpoint.require_lodash(), 1);
 var AmazonApiGatewayEndpoint = class {
 	options;
-	constructor(envParser, endpoint, options = {}) {
-		this.envParser = envParser;
+	/**
+	* The parser this adaptor discovers services with.
+	*
+	* Taken from the endpoint's surface rather than handed in. An endpoint built
+	* with `api.get()` carries its API, and the API carries the parser — so a
+	* generated handler is `new AmazonApiGatewayV2Endpoint(endpoint)` with no
+	* import written for it, which is the whole reason the surface is the
+	* factory.
+	*/
+	envParser;
+	constructor(endpoint, options = {}) {
 		this.endpoint = endpoint;
 		this.options = options;
+		this.envParser = require_surfaceEnv.envParserFor(endpoint.surface);
 	}
 	error() {
 		return { onError: (req) => {
@@ -46,14 +61,14 @@ var AmazonApiGatewayEndpoint = class {
 	}
 	getCookies(e) {
 		const headers = e.headers;
-		return require_lazyAccessors.Endpoint.createCookies(headers?.cookie);
+		return require_Endpoint.Endpoint.createCookies(headers?.cookie);
 	}
 	input() {
 		return { before: async (req) => {
 			try {
 				const { body, query, params } = this.getInput(req.event);
 				const headers = req.event.headers;
-				const header = require_lazyAccessors.Endpoint.createHeaders(headers);
+				const header = require_Endpoint.Endpoint.createHeaders(headers);
 				const cookie = this.getCookies(req.event);
 				(0, import_lodash.default)(req.event, "body", await this.endpoint.parseInput(body, "body"));
 				(0, import_lodash.default)(req.event, "query", await this.endpoint.parseInput(query, "query"));
@@ -136,7 +151,7 @@ var AmazonApiGatewayEndpoint = class {
 			const event = req.event;
 			const response = event.__response;
 			const statusCode = req.response?.statusCode ?? this.endpoint.status;
-			if (require_lazyAccessors.Endpoint.isSuccessStatus(statusCode)) {
+			if (require_Endpoint.Endpoint.isSuccessStatus(statusCode)) {
 				const logger = event.logger;
 				const serviceDiscovery = __geekmidas_services.ServiceDiscovery.getInstance(this.envParser);
 				await require_publisher.publishConstructEvents(this.endpoint, response, serviceDiscovery, logger);
@@ -168,7 +183,7 @@ var AmazonApiGatewayEndpoint = class {
 			const sameDatabase = auditContext?.storage?.databaseServiceName && auditContext.storage.databaseServiceName === this.endpoint.databaseService?.serviceName;
 			const baseDb = sameDatabase ? auditor?.getTransaction?.() ?? rawDb : rawDb;
 			const executeHandler = async (db) => {
-				const responseBuilder = new require_lazyAccessors.ResponseBuilder();
+				const responseBuilder = new require_Endpoint.ResponseBuilder();
 				const response = await this.endpoint.handler({
 					header: event.header,
 					cookie: event.cookie,
@@ -181,7 +196,7 @@ var AmazonApiGatewayEndpoint = class {
 				}, responseBuilder);
 				let data = response;
 				let metadata$1 = responseBuilder.getMetadata();
-				if (require_lazyAccessors.Endpoint.hasMetadata(response)) {
+				if (require_Endpoint.Endpoint.hasMetadata(response)) {
 					data = response.data;
 					metadata$1 = response.metadata;
 				}
@@ -221,7 +236,7 @@ var AmazonApiGatewayEndpoint = class {
 		};
 		if (metadata.cookies && metadata.cookies.size > 0) {
 			const setCookieHeaders = [];
-			for (const [name, { value, options }] of metadata.cookies) setCookieHeaders.push(require_lazyAccessors.Endpoint.formatCookieHeader(name, value, options));
+			for (const [name, { value, options }] of metadata.cookies) setCookieHeaders.push(require_Endpoint.Endpoint.formatCookieHeader(name, value, options));
 			if (setCookieHeaders.length > 0) lambdaResponse.multiValueHeaders = {
 				...lambdaResponse.multiValueHeaders,
 				"Set-Cookie": setCookieHeaders
@@ -326,9 +341,8 @@ var AmazonApiGatewayV1Endpoint = class extends AmazonApiGatewayEndpoint {
 			}
 		};
 	}
-	constructor(envParser, endpoint, options = {}) {
-		super(envParser, endpoint, options);
-		this.envParser = envParser;
+	constructor(endpoint, options = {}) {
+		super(endpoint, options);
 		this.endpoint = endpoint;
 	}
 };
@@ -362,9 +376,8 @@ var AmazonApiGatewayV2Endpoint = class extends AmazonApiGatewayEndpoint {
 			}
 		};
 	}
-	constructor(envParser, endpoint, options = {}) {
-		super(envParser, endpoint, options);
-		this.envParser = envParser;
+	constructor(endpoint, options = {}) {
+		super(endpoint, options);
 		this.endpoint = endpoint;
 	}
 };