@geekmidas/constructs 10.0.0-alpha.4 → 10.0.0-alpha.40

package/dist/Queue-Ckmudcm8.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue-Ckmudcm8.cjs","names":["Construct","DEFAULT_LOGGER","canonicalId","provideKey","serviceKey","Publisher"],"sources":["../src/queue/Queue.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, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\n/**\n * The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.\n * The producer publishes this shape and the worker receives the `payload`s as\n * its `messages`. Typing `type` to the queue name keeps the publisher fully\n * typed and lets pg-boss (local) / SQS (deployed) route by name.\n */\nexport type QueueMessage<\n\tTName extends string,\n\tTMessage extends StandardSchemaV1,\n> = PublishableMessage<TName, InferStandardSchema<TMessage>>;\n\n/**\n * A queue worker — a point-to-point SQS-style queue and its single consumer.\n * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue\n * drains every message of its one `message` type. Build one from the worker\n * that runs it — `worker.queue('Emails').message(schema).handle(…)` — and\n * `gkm build` discovers it into the manifest's `queues` field.\n *\n * Producers send to it by depending on it: `.dependsOn([emails])` makes\n * `services.emails` the publisher.\n */\nexport class Queue<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> extends Construct<TLogger, undefined, TServices> {\n\t__IS_QUEUE__ = true;\n\n\tstatic isQueue(\n\t\tobj: unknown,\n\t): obj is Queue<string, StandardSchemaV1, Service[], Logger> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_QUEUE__?: boolean }).__IS_QUEUE__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Queue,\n\t\t);\n\t}\n\n\t/**\n\t * The canonical id this queue is declared under.\n\t *\n\t * Derived from the name rather than given separately, so `emails` and\n\t * `Emails` are one queue. The name stays what it was: it is the wire `type`\n\t * a producer sends and the worker subscribes to, and changing that would\n\t * silently orphan in-flight messages.\n\t */\n\treadonly id: string;\n\n\t/**\n\t * The queue as a dependency — what `.dependsOn([emails])` dissolves into,\n\t * reachable as `services.emails`.\n\t *\n\t * The producer: the queue's one consumer is the handler it was built with,\n\t * so the only thing another construct can want from a queue is to send to\n\t * it. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the transport\n\t * from its protocol — `pgboss://` locally, `sqs://` deployed. A field\n\t * assigned once, not a getter: services are cached by object identity.\n\t */\n\treadonly service: Service<\n\t\tUncapitalize<TName>,\n\t\tEventPublisher<QueueMessage<TName, TMessage>>\n\t>;\n\n\t/**\n\t * The producer's env key. Read by both {@link declare} and the service, so\n\t * what the target publishes and what the producer looks up cannot drift.\n\t */\n\tprivate readonly connectionKey: string;\n\n\tconstructor(\n\t\tpublic readonly name: TName,\n\t\tpublic readonly handler: QueueHandler<TMessage, TServices, TLogger>,\n\t\tpublic readonly messageSchema: TMessage,\n\t\tpublic override readonly timeout: number = 30000,\n\t\tpublic override readonly services: TServices = [] as unknown as TServices,\n\t\tpublic override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,\n\t\t/** SQS event-source batch size (deployed). */\n\t\tpublic readonly batchSize?: number,\n\t\t/** Whether the queue is FIFO (deployed). */\n\t\tpublic readonly fifo?: boolean,\n\t\t/**\n\t\t * The construct ids the *worker* `.dependsOn()` named — last, so no\n\t\t * existing positional argument moves.\n\t\t */\n\t\tconstructs: string[] = [],\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Queue,\n\t\t\tlogger,\n\t\t\tservices,\n\t\t\t[],\n\t\t\tundefined,\n\t\t\ttimeout,\n\t\t\tundefined, // memorySize\n\t\t\tundefined, // auditorStorageService\n\t\t\tconstructs,\n\t\t);\n\n\t\tthis.id = canonicalId(name);\n\t\tthis.connectionKey = provideKey(this.id, 'publisherConnectionString');\n\n\t\tconst envVar = this.connectionKey;\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(this.id) as Uncapitalize<TName>,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({ connectionString: get(envVar).string() }))\n\t\t\t\t\t.parse();\n\n\t\t\t\treturn Publisher.fromConnectionString<QueueMessage<TName, TMessage>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * What this queue is in the manifest.\n\t *\n\t * A queue is a resource, not a handler: the worker is reached *through* it,\n\t * so the declaration carries the producer's key and nothing about the code\n\t * that drains it. The local target reads this to know which broker has to be\n\t * running and what connection string to inject.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'queue',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.connectionKey],\n\t\t\t\t...(this.fifo ? { fifo: true } : {}),\n\t\t\t\t// Nested rather than a sibling node, because position carries the\n\t\t\t\t// trigger: this handler is reached by messages on this queue and\n\t\t\t\t// by nothing else, so there is no `trigger` field to keep in step.\n\t\t\t\t//\n\t\t\t\t// `handler` is the export name; which directory the build wrote it\n\t\t\t\t// to is the target's business, and a path with a cloud in it does\n\t\t\t\t// not belong in a neutral declaration.\n\t\t\t\tworker: {\n\t\t\t\t\tid: `${this.id}Worker`,\n\t\t\t\t\thandler: `${this.id}.handler`,\n\t\t\t\t\t// Filled by the build from what the worker declared. Empty is a\n\t\t\t\t\t// stated gap, not a claim that it reaches nothing.\n\t\t\t\t\tdependencies: [],\n\t\t\t\t},\n\t\t\t},\n\t\t];\n\t}\n}\n\n/** The context a queue handler receives — a batch of typed messages. */\nexport type QueueContext<\n\tTMessage extends StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = {\n\tmessages: InferStandardSchema<TMessage>[];\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n};\n\nexport type QueueHandler<\n\tTMessage extends StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = (\n\tctx: QueueContext<TMessage, TServices, TLogger>,\n) => unknown | Promise<unknown>;\n"],"mappings":";;;;;;;;;;;;;;;AAwCA,IAAa,QAAb,cAKUA,kBAAAA,UAAyC;CA6CjC;CACA;CACA;CACS;CACA;CACA;CAET;CAEA;CArDjB,eAAe;CAEf,OAAO,QACN,KAC4D;EAC5D,OAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAAA,8BACrB;CACD;;;;;;;;;CAUA;;;;;;;;;;;CAYA;;;;;CASA;CAEA,YACC,MACA,SACA,eACA,UAA2C,KAC3C,WAA+C,CAAC,GAChD,SAA2CC,0BAAAA,gBAE3C,WAEA,MAKA,aAAuB,CAAC,GACvB;EACD,MAAA,gCAEC,QACA,UACA,CAAC,GACD,KAAA,GACA,SACA,KAAA,GACA,KAAA,GACA,UACD;EA1BgB,KAAA,OAAA;EACA,KAAA,UAAA;EACA,KAAA,gBAAA;EACS,KAAA,UAAA;EACA,KAAA,WAAA;EACA,KAAA,SAAA;EAET,KAAA,YAAA;EAEA,KAAA,OAAA;EAmBhB,KAAK,MAAA,GAAKC,oBAAAA,YAAAA,CAAY,IAAI;EAC1B,KAAK,iBAAA,GAAgBC,oBAAAA,WAAAA,CAAW,KAAK,IAAI,2BAA2B;EAEpE,MAAM,SAAS,KAAK;EACpB,KAAK,UAAU;GACd,cAAA,GAAaC,oBAAAA,WAAAA,CAAW,KAAK,EAAE;GAC/B,MAAM,SAAS,EAAE,aAAa;IAC7B,MAAM,EAAE,qBAAqB,UAC3B,QAAQ,SAAS,EAAE,kBAAkB,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAC7D,MAAM;IAER,OAAOC,kBAAAA,UAAU,qBAChB,gBACD;GACD;EACD;CACD;;;;;;;;;CAUA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,aAAa;GAC7B,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;GAQlC,QAAQ;IACP,IAAI,GAAG,KAAK,GAAG;IACf,SAAS,GAAG,KAAK,GAAG;IAGpB,cAAc,CAAC;GAChB;EACD,CACD;CACD;AACD"}

package/dist/{Queue-D7ZuwBhy.d.cts → Queue-CpQIGB_2.d.cts}

@@ -1,13 +1,11 @@
-import { Construct } from "./Construct-C0ijr2qp.cjs";
-import { EventPublisher, PublishableMessage } from "@geekmidas/events";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
+import { t as Construct } from "./Construct-BQALFCh2.cjs";
 import { Logger } from "@geekmidas/logger";
 import { InferStandardSchema } from "@geekmidas/schema";
 import { Service, ServiceRecord } from "@geekmidas/services";
-import { StandardSchemaV1 } from "@standard-schema/spec";
+import { EventPublisher, PublishableMessage } from "@geekmidas/events";
 import { Declaration } from "@geekmidas/manifest";
-
 //#region src/queue/Queue.d.ts
-
 /**
  * The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.
  * The producer publishes this shape and the worker receives the `payload`s as
@@ -18,13 +16,14 @@ type QueueMessage<TName extends string, TMessage extends StandardSchemaV1> = Pub
 /**
  * A queue worker — a point-to-point SQS-style queue and its single consumer.
  * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue
- * drains every message of its one `message` type. Build one with `q` (see
- * `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.
+ * drains every message of its one `message` type. Build one from the worker
+ * that runs it — `worker.queue('Emails').message(schema).handle(…)` — and
+ * `gkm build` discovers it into the manifest's `queues` field.
  *
- * The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
- * that any endpoint/function drops into `.services([...])` to send messages.
+ * Producers send to it by depending on it: `.dependsOn([emails])` makes
+ * `services.emails` the publisher.
  */
-declare class Queue<TName extends string = string, TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> extends Construct<TLogger, string, undefined, undefined, TServices> {
+declare class Queue<TName extends string = string, TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> extends Construct<TLogger, undefined, TServices> {
   readonly name: TName;
   readonly handler: QueueHandler<TMessage, TServices, TLogger>;
   readonly messageSchema: TMessage;
@@ -47,13 +46,25 @@ declare class Queue<TName extends string = string, TMessage extends StandardSche
    */
   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.
+   * The queue as a dependency — what `.dependsOn([emails])` dissolves into,
+   * reachable as `services.emails`.
+   *
+   * The producer: the queue's one consumer is the handler it was built with,
+   * so the only thing another construct can want from a queue is to send to
+   * it. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the transport
+   * from its protocol — `pgboss://` locally, `sqs://` deployed. A field
+   * assigned once, not a getter: services are cached by object identity.
+   */
+  readonly service: Service<Uncapitalize<TName>, EventPublisher<QueueMessage<TName, TMessage>>>;
+  /**
+   * The producer's env key. Read by both {@link declare} and the service, 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). */
+  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,
   /**
    * The construct ids the *worker* `.dependsOn()` named — last, so no
@@ -69,28 +80,6 @@ declare class Queue<TName extends string = string, TMessage extends StandardSche
    * 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
-   * then calls `services.<name>Publisher.publish([{ type, payload }])`.
-   *
-   * It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from
-   * the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same
-   * code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,
-   * `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. */
 type QueueContext<TMessage extends StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> = {
@@ -99,7 +88,6 @@ type QueueContext<TMessage extends StandardSchemaV1, TServices extends Service[]
   logger: TLogger;
 };
 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-D7ZuwBhy.d.cts.map
+export { QueueMessage as i, QueueContext as n, QueueHandler as r, Queue as t };
+//# sourceMappingURL=Queue-CpQIGB_2.d.cts.map

package/dist/Queue-CpQIGB_2.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue-CpQIGB_2.d.cts","names":[],"sources":["../src/queue/Queue.ts"],"mappings":";;;;;;;;;;;;;;KAyBY,aACX,sBACA,iBAAiB,oBACd,mBAAmB,OAAO,oBAAoB;;;;;;;;;;;cAYrC,MACZ,+BACA,iBAAiB,mBAAmB,kBACpC,kBAAkB,gBAClB,gBAAgB,SAAS,gBAChB,UAAU,oBAAoB;WA6CtB,MAAM;WACN,SAAS,aAAa,UAAU,WAAW;WAC3C,eAAe;WACN;WACA,UAAU;WACV,QAAQ;;WAEjB;;WAEA;EArDjB;SAEO,QACN,eACE,OAAO,cAAc,kBAAkB,WAAW;;;;;;;;;WAgB5C;;;;;;;;;;;WAYA,SAAS,QACjB,aAAa,QACb,eAAe,aAAa,OAAO;;;;;mBAOnB;EAEjB,YACiB,MAAM,OACN,SAAS,aAAa,UAAU,WAAW,UAC3C,eAAe,UACN,kBACA,WAAU,WACV,SAAQ,SAEjB;;EAAA,gCAEA;;EAAA,4BAKhB;;;;;EAAA;;;;;;;;;EAwCD,WAAW;;;KA2BA,aACX,iBAAiB,kBACjB,kBAAkB,gBAClB,gBAAgB,SAAS;EAEzB,UAAU,oBAAoB;EAC9B,UAAU,cAAc;EACxB,QAAQ;;KAGG,aACX,iBAAiB,kBACjB,kBAAkB,gBAClB,gBAAgB,SAAS,WAEzB,KAAK,aAAa,UAAU,WAAW,uBACzB"}

package/dist/{Queue-gVGfi2Yk.d.mts → Queue-YmvN2vEP.d.mts}

@@ -1,13 +1,11 @@
-import { Construct } from "./Construct-Ct8nalEi.mjs";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
+import { t as Construct } from "./Construct-QXnl3VqT.mjs";
 import { Declaration } from "@geekmidas/manifest";
-import { Service, ServiceRecord } from "@geekmidas/services";
 import { EventPublisher, PublishableMessage } from "@geekmidas/events";
+import { Service, ServiceRecord } from "@geekmidas/services";
 import { Logger } from "@geekmidas/logger";
 import { InferStandardSchema } from "@geekmidas/schema";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
 //#region src/queue/Queue.d.ts
-
 /**
  * The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.
  * The producer publishes this shape and the worker receives the `payload`s as
@@ -18,13 +16,14 @@ type QueueMessage<TName extends string, TMessage extends StandardSchemaV1> = Pub
 /**
  * A queue worker — a point-to-point SQS-style queue and its single consumer.
  * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue
- * drains every message of its one `message` type. Build one with `q` (see
- * `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.
+ * drains every message of its one `message` type. Build one from the worker
+ * that runs it — `worker.queue('Emails').message(schema).handle(…)` — and
+ * `gkm build` discovers it into the manifest's `queues` field.
  *
- * The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
- * that any endpoint/function drops into `.services([...])` to send messages.
+ * Producers send to it by depending on it: `.dependsOn([emails])` makes
+ * `services.emails` the publisher.
  */
-declare class Queue<TName extends string = string, TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> extends Construct<TLogger, string, undefined, undefined, TServices> {
+declare class Queue<TName extends string = string, TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> extends Construct<TLogger, undefined, TServices> {
   readonly name: TName;
   readonly handler: QueueHandler<TMessage, TServices, TLogger>;
   readonly messageSchema: TMessage;
@@ -47,13 +46,25 @@ declare class Queue<TName extends string = string, TMessage extends StandardSche
    */
   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.
+   * The queue as a dependency — what `.dependsOn([emails])` dissolves into,
+   * reachable as `services.emails`.
+   *
+   * The producer: the queue's one consumer is the handler it was built with,
+   * so the only thing another construct can want from a queue is to send to
+   * it. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the transport
+   * from its protocol — `pgboss://` locally, `sqs://` deployed. A field
+   * assigned once, not a getter: services are cached by object identity.
+   */
+  readonly service: Service<Uncapitalize<TName>, EventPublisher<QueueMessage<TName, TMessage>>>;
+  /**
+   * The producer's env key. Read by both {@link declare} and the service, 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). */
+  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,
   /**
    * The construct ids the *worker* `.dependsOn()` named — last, so no
@@ -69,28 +80,6 @@ declare class Queue<TName extends string = string, TMessage extends StandardSche
    * 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
-   * then calls `services.<name>Publisher.publish([{ type, payload }])`.
-   *
-   * It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from
-   * the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same
-   * code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,
-   * `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. */
 type QueueContext<TMessage extends StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> = {
@@ -99,7 +88,6 @@ type QueueContext<TMessage extends StandardSchemaV1, TServices extends Service[]
   logger: TLogger;
 };
 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-gVGfi2Yk.d.mts.map
+export { QueueMessage as i, QueueContext as n, QueueHandler as r, Queue as t };
+//# sourceMappingURL=Queue-YmvN2vEP.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Queue-YmvN2vEP.d.mts","names":[],"sources":["../src/queue/Queue.ts"],"mappings":";;;;;;;;;;;;;;KAyBY,aACX,sBACA,iBAAiB,oBACd,mBAAmB,OAAO,oBAAoB;;;;;;;;;;;cAYrC,MACZ,+BACA,iBAAiB,mBAAmB,kBACpC,kBAAkB,gBAClB,gBAAgB,SAAS,gBAChB,UAAU,oBAAoB;WA6CtB,MAAM;WACN,SAAS,aAAa,UAAU,WAAW;WAC3C,eAAe;WACN;WACA,UAAU;WACV,QAAQ;;WAEjB;;WAEA;EArDjB;SAEO,QACN,eACE,OAAO,cAAc,kBAAkB,WAAW;;;;;;;;;WAgB5C;;;;;;;;;;;WAYA,SAAS,QACjB,aAAa,QACb,eAAe,aAAa,OAAO;;;;;mBAOnB;EAEjB,YACiB,MAAM,OACN,SAAS,aAAa,UAAU,WAAW,UAC3C,eAAe,UACN,kBACA,WAAU,WACV,SAAQ,SAEjB;;EAAA,gCAEA;;EAAA,4BAKhB;;;;;EAAA;;;;;;;;;EAwCD,WAAW;;;KA2BA,aACX,iBAAiB,kBACjB,kBAAkB,gBAClB,gBAAgB,SAAS;EAEzB,UAAU,oBAAoB;EAC9B,UAAU,cAAc;EACxB,QAAQ;;KAGG,aACX,iBAAiB,kBACjB,kBAAkB,gBAClB,gBAAgB,SAAS,WAEzB,KAAK,aAAa,UAAU,WAAW,uBACzB"}

package/dist/QueueBuilder-CJNcv4dy.cjs

@@ -0,0 +1,112 @@
+const require_construct_interface = require("./construct-interface.cjs");
+const require_clone = require("./clone-UGJpvQnL.cjs");
+const require_Queue = require("./Queue-Ckmudcm8.cjs");
+let _geekmidas_logger_console = require("@geekmidas/logger/console");
+//#region src/queue/QueueBuilder.ts
+/**
+* Builds a {@link Queue} and its one consumer. Reached through
+* `worker.queue('orders')`, never constructed by hand: the worker stamps itself
+* as the owner. `message` is the typed job payload and `handle` the consumer.
+* The queue name is captured as a literal so `queue.service` publishes
+* `{ type: '<name>', payload }`.
+*/
+var QueueBuilder = class {
+	_name;
+	_messageSchema;
+	_timeout = 3e4;
+	_batchSize;
+	_fifo;
+	_services = [];
+	/** The construct ids `.dependsOn()` named — what the manifest records. */
+	_constructs = [];
+	_logger = _geekmidas_logger_console.DEFAULT_LOGGER;
+	/** The worker that runs this queue's consumer — stamped by `worker.queue()`. */
+	_owner;
+	/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */
+	queue(name) {
+		return require_clone.cloneWith(this, { _name: name });
+	}
+	timeout(timeout) {
+		return require_clone.cloneWith(this, { _timeout: timeout });
+	}
+	/** SQS event-source batch size (deployed). */
+	batchSize(batchSize) {
+		return require_clone.cloneWith(this, { _batchSize: batchSize });
+	}
+	/** Mark the queue as FIFO (deployed). */
+	fifo(fifo = true) {
+		return require_clone.cloneWith(this, { _fifo: fifo });
+	}
+	/**
+	* Depend on constructs — a database, a bucket, a mail sender, a queue, a
+	* topic.
+	*
+	* It records the edge and dissolves each construct's client into the
+	* handler's service record under the construct's own id, so
+	* `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+	*
+	* Constructs only. A `Service` does not match the shape, which is what keeps
+	* env sniffing confined to `.services()` and the explicit lift.
+	*/
+	dependsOn(constructs) {
+		const services = require_construct_interface.servicesOf(constructs);
+		return require_clone.cloneWith(this, {
+			_services: [...this._services, ...services],
+			_constructs: require_construct_interface.idsOf(constructs, this._constructs)
+		});
+	}
+	services(services) {
+		return require_clone.cloneWith(this, { _services: [...this._services, ...services] });
+	}
+	logger(logger) {
+		return require_clone.cloneWith(this, { _logger: logger });
+	}
+	/** The typed message (job) payload the queue carries. */
+	message(schema) {
+		return require_clone.cloneWith(this, { _messageSchema: schema });
+	}
+	handle(fn) {
+		if (!this._name) throw new QueueNeedsName();
+		if (!this._messageSchema) throw new QueueNeedsMessage(this._name);
+		const queue = new require_Queue.Queue(this._name, fn, this._messageSchema, this._timeout, this._services, this._logger, this._batchSize, this._fifo, this._constructs);
+		queue.owner = this._owner;
+		return queue;
+	}
+};
+/** A queue built without a name — only reachable by building one by hand. */
+var QueueNeedsName = class extends Error {
+	constructor() {
+		super("A queue needs a name: build it from a worker, worker.queue('Emails').");
+		this.name = "QueueNeedsName";
+	}
+};
+/** A queue whose message was never described. */
+var QueueNeedsMessage = class extends Error {
+	queue;
+	constructor(queue) {
+		super(`Queue '${queue}' has no message: call .message(schema) before .handle(), so its producers and its consumer agree on what it carries.`);
+		this.queue = queue;
+		this.name = "QueueNeedsMessage";
+	}
+};
+//#endregion
+Object.defineProperty(exports, "QueueBuilder", {
+	enumerable: true,
+	get: function() {
+		return QueueBuilder;
+	}
+});
+Object.defineProperty(exports, "QueueNeedsMessage", {
+	enumerable: true,
+	get: function() {
+		return QueueNeedsMessage;
+	}
+});
+Object.defineProperty(exports, "QueueNeedsName", {
+	enumerable: true,
+	get: function() {
+		return QueueNeedsName;
+	}
+});
+
+//# sourceMappingURL=QueueBuilder-CJNcv4dy.cjs.map

package/dist/QueueBuilder-CJNcv4dy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueBuilder-CJNcv4dy.cjs","names":["DEFAULT_LOGGER","cloneWith","servicesOf","idsOf","Queue"],"sources":["../src/queue/QueueBuilder.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tservicesOf,\n} from '../construct-interface';\nimport { Queue, type QueueHandler } from './Queue';\n\n/**\n * Builds a {@link Queue} and its one consumer. Reached through\n * `worker.queue('orders')`, never constructed by hand: the worker stamps itself\n * as the owner. `message` is the typed job payload and `handle` the consumer.\n * The queue name is captured as a literal so `queue.service` publishes\n * `{ type: '<name>', payload }`.\n */\nexport class QueueBuilder<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tprivate _name?: string;\n\tprivate _messageSchema?: TMessage;\n\tprivate _timeout = 30000;\n\tprivate _batchSize?: number;\n\tprivate _fifo?: boolean;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\t/** The construct ids `.dependsOn()` named — what the manifest records. */\n\tpublic _constructs: string[] = [];\n\tprivate _logger: TLogger = DEFAULT_LOGGER as TLogger;\n\t/** The worker that runs this queue's consumer — stamped by `worker.queue()`. */\n\tpublic _owner?: string;\n\n\t/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */\n\tqueue<T extends string>(\n\t\tname: T,\n\t): QueueBuilder<T, TMessage, TServices, TLogger> {\n\t\treturn cloneWith(this, { _name: name }) as unknown as QueueBuilder<\n\t\t\tT,\n\t\t\tTMessage,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\t/** SQS event-source batch size (deployed). */\n\tbatchSize(batchSize: number): this {\n\t\treturn cloneWith(this, { _batchSize: batchSize });\n\t}\n\n\t/** Mark the queue as FIFO (deployed). */\n\tfifo(fifo = true): this {\n\t\treturn cloneWith(this, { _fifo: fifo });\n\t}\n\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\tdependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...ServicesOf<T>], TLogger> {\n\t\t// Both halves of the edge, from one call and one clone: the services the\n\t\t// handler runs with, and the ids the manifest records. Recording them\n\t\t// separately is what let them drift apart.\n\t\t//\n\t\t// `servicesOf` is the half that validates, so it runs first — recording\n\t\t// ids ahead of it left a caught `NotAConstruct` with `undefined` already\n\t\t// on a `string[]`.\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services],\n\t\t\t_constructs: idsOf(constructs, this._constructs),\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as unknown as TServices,\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): QueueBuilder<TName, TMessage, TServices, T> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;\n\t}\n\n\t/** The typed message (job) payload the queue carries. */\n\tmessage<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): QueueBuilder<TName, T, TServices, TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_messageSchema: schema as unknown as TMessage,\n\t\t}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;\n\t}\n\n\thandle(\n\t\tfn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,\n\t): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {\n\t\tif (!this._name) throw new QueueNeedsName();\n\t\tif (!this._messageSchema) throw new QueueNeedsMessage(this._name);\n\n\t\tconst queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(\n\t\t\tthis._name as TName,\n\t\t\tfn,\n\t\t\tthis._messageSchema as NonNullable<TMessage>,\n\t\t\tthis._timeout,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._batchSize,\n\t\t\tthis._fifo,\n\t\t\tthis._constructs,\n\t\t);\n\t\t// Which process runs the consumer: the worker it was built from.\n\t\tqueue.owner = this._owner;\n\n\t\t// No reset. `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base — `const fn = f.logger(log).timeout(60_000)` — keeps\n\t\t// its configuration for every construct built from it. The reset that\n\t\t// used to be here wiped the base on first use, which made a base usable\n\t\t// exactly once, and quietly reverted the logger to the default.\n\n\t\treturn queue;\n\t}\n}\n\n/** A queue built without a name — only reachable by building one by hand. */\nexport class QueueNeedsName extends Error {\n\tconstructor() {\n\t\tsuper(\n\t\t\t\"A queue needs a name: build it from a worker, worker.queue('Emails').\",\n\t\t);\n\t\tthis.name = 'QueueNeedsName';\n\t}\n}\n\n/** A queue whose message was never described. */\nexport class QueueNeedsMessage extends Error {\n\tconstructor(readonly queue: string) {\n\t\tsuper(\n\t\t\t`Queue '${queue}' has no message: call .message(schema) before .handle(), ` +\n\t\t\t\t'so its producers and its consumer agree on what it carries.',\n\t\t);\n\t\tthis.name = 'QueueNeedsMessage';\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,IAAa,eAAb,MAKE;CACD;CACA;CACA,WAAmB;CACnB;CACA;CACA,YAA+B,CAAC;;CAEhC,cAA+B,CAAC;CAChC,UAA2BA,0BAAAA;;CAE3B;;CAGA,MACC,MACgD;EAChD,OAAOC,cAAAA,UAAU,MAAM,EAAE,OAAO,KAAK,CAAC;CAMvC;CAEA,QAAQ,SAAuB;EAC9B,OAAOA,cAAAA,UAAU,MAAM,EAAE,UAAU,QAAQ,CAAC;CAC7C;;CAGA,UAAU,WAAyB;EAClC,OAAOA,cAAAA,UAAU,MAAM,EAAE,YAAY,UAAU,CAAC;CACjD;;CAGA,KAAK,OAAO,MAAY;EACvB,OAAOA,cAAAA,UAAU,MAAM,EAAE,OAAO,KAAK,CAAC;CACvC;;;;;;;;;;;;CAaA,UACC,YAC2E;EAQ3E,MAAM,WAAWC,4BAAAA,WAAW,UAAU;EAEtC,OAAOD,cAAAA,UAAU,MAAM;GACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAQ;GAC1C,aAAaE,4BAAAA,MAAM,YAAY,KAAK,WAAW;EAChD,CAAC;CAMF;CAEA,SACC,UAC+D;EAC/D,OAAOF,cAAAA,UAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAQ,EAC3C,CAAC;CAMF;CAEA,OACC,QAC8C;EAC9C,OAAOA,cAAAA,UAAU,MAAM,EACtB,SAAS,OACV,CAAC;CACF;;CAGA,QACC,QAC6C;EAC7C,OAAOA,cAAAA,UAAU,MAAM,EACtB,gBAAgB,OACjB,CAAC;CACF;CAEA,OACC,IAC0D;EAC1D,IAAI,CAAC,KAAK,OAAO,MAAM,IAAI,eAAe;EAC1C,IAAI,CAAC,KAAK,gBAAgB,MAAM,IAAI,kBAAkB,KAAK,KAAK;EAEhE,MAAM,QAAQ,IAAIG,cAAAA,MACjB,KAAK,OACL,IACA,KAAK,gBACL,KAAK,UACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,OACL,KAAK,WACN;EAEA,MAAM,QAAQ,KAAK;EAQnB,OAAO;CACR;AACD;;AAGA,IAAa,iBAAb,cAAoC,MAAM;CACzC,cAAc;EACb,MACC,uEACD;EACA,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,OAAwB;EACnC,MACC,UAAU,MAAM,sHAEjB;EAJoB,KAAA,QAAA;EAKpB,KAAK,OAAO;CACb;AACD"}

package/dist/QueueBuilder-CM0WUxfw.d.mts

@@ -0,0 +1,62 @@
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
+import { c as ServicesOf, r as Consumable } from "./construct-interface-_3zgxzXl.mjs";
+import { r as QueueHandler, t as Queue } from "./Queue-YmvN2vEP.mjs";
+import { Service } from "@geekmidas/services";
+import { Logger } from "@geekmidas/logger";
+//#region src/queue/QueueBuilder.d.ts
+/**
+ * Builds a {@link Queue} and its one consumer. Reached through
+ * `worker.queue('orders')`, never constructed by hand: the worker stamps itself
+ * as the owner. `message` is the typed job payload and `handle` the consumer.
+ * The queue name is captured as a literal so `queue.service` publishes
+ * `{ type: '<name>', payload }`.
+ */
+declare class QueueBuilder<TName extends string = string, TMessage extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger> {
+  private _name?;
+  private _messageSchema?;
+  private _timeout;
+  private _batchSize?;
+  private _fifo?;
+  private _services;
+  /** The construct ids `.dependsOn()` named — what the manifest records. */
+  _constructs: string[];
+  private _logger;
+  /** The worker that runs this queue's consumer — stamped by `worker.queue()`. */
+  _owner?: string;
+  /** The queue name — drives the infra queue and its `<NAME>_*` env vars. */
+  queue<T extends string>(name: T): QueueBuilder<T, TMessage, TServices, TLogger>;
+  timeout(timeout: number): this;
+  /** SQS event-source batch size (deployed). */
+  batchSize(batchSize: number): this;
+  /** Mark the queue as FIFO (deployed). */
+  fifo(fifo?: boolean): this;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): QueueBuilder<TName, TMessage, [...TServices, ...ServicesOf<T>], TLogger>;
+  services<T extends Service[]>(services: T): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger>;
+  logger<T extends Logger>(logger: T): QueueBuilder<TName, TMessage, TServices, T>;
+  /** The typed message (job) payload the queue carries. */
+  message<T extends StandardSchemaV1>(schema: T): QueueBuilder<TName, T, TServices, TLogger>;
+  handle(fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>): Queue<TName, NonNullable<TMessage>, TServices, TLogger>;
+}
+/** A queue built without a name — only reachable by building one by hand. */
+declare class QueueNeedsName extends Error {
+  constructor();
+}
+/** A queue whose message was never described. */
+declare class QueueNeedsMessage extends Error {
+  readonly queue: string;
+  constructor(queue: string);
+}
+//#endregion
+export { QueueNeedsMessage as n, QueueNeedsName as r, QueueBuilder as t };
+//# sourceMappingURL=QueueBuilder-CM0WUxfw.d.mts.map

package/dist/QueueBuilder-CM0WUxfw.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueBuilder-CM0WUxfw.d.mts","names":[],"sources":["../src/queue/QueueBuilder.ts"],"mappings":";;;;;;;;;;;;;cAoBa,aACZ,+BACA,iBAAiB,0CACjB,kBAAkB,gBAClB,gBAAgB,SAAS;UAEjB;UACA;UACA;UACA;UACA;UACA;;EAED;UACC;;EAED;;EAGP,MAAM,kBACL,MAAM,IACJ,aAAa,GAAG,UAAU,WAAW;EASxC,QAAQ;;EAKR,UAAU;;EAKV,KAAK;;;;;;;;;;;;EAeL,gBAAgB,mBAAmB,cAClC,YAAY,IACV,aAAa,OAAO,cAAc,cAAc,WAAW,KAAK;EAqBnE,SAAS,UAAU,WAClB,UAAU,IACR,aAAa,OAAO,cAAc,cAAc,IAAI;EAWvD,OAAO,UAAU,QAChB,QAAQ,IACN,aAAa,OAAO,UAAU,WAAW;;EAO5C,QAAQ,UAAU,kBACjB,QAAQ,IACN,aAAa,OAAO,GAAG,WAAW;EAMrC,OACC,IAAI,aAAa,YAAY,WAAW,WAAW,WACjD,MAAM,OAAO,YAAY,WAAW,WAAW;;;cA6BtC,uBAAuB;EACnC;;;cASY,0BAA0B;WACjB;EAArB,YAAqB"}

package/dist/QueueBuilder-XEnnOWGe.d.cts

@@ -0,0 +1,62 @@
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
+import { c as ServicesOf, r as Consumable } from "./construct-interface-_xi4BPN8.cjs";
+import { r as QueueHandler, t as Queue } from "./Queue-CpQIGB_2.cjs";
+import { Logger } from "@geekmidas/logger";
+import { Service } from "@geekmidas/services";
+//#region src/queue/QueueBuilder.d.ts
+/**
+ * Builds a {@link Queue} and its one consumer. Reached through
+ * `worker.queue('orders')`, never constructed by hand: the worker stamps itself
+ * as the owner. `message` is the typed job payload and `handle` the consumer.
+ * The queue name is captured as a literal so `queue.service` publishes
+ * `{ type: '<name>', payload }`.
+ */
+declare class QueueBuilder<TName extends string = string, TMessage extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger> {
+  private _name?;
+  private _messageSchema?;
+  private _timeout;
+  private _batchSize?;
+  private _fifo?;
+  private _services;
+  /** The construct ids `.dependsOn()` named — what the manifest records. */
+  _constructs: string[];
+  private _logger;
+  /** The worker that runs this queue's consumer — stamped by `worker.queue()`. */
+  _owner?: string;
+  /** The queue name — drives the infra queue and its `<NAME>_*` env vars. */
+  queue<T extends string>(name: T): QueueBuilder<T, TMessage, TServices, TLogger>;
+  timeout(timeout: number): this;
+  /** SQS event-source batch size (deployed). */
+  batchSize(batchSize: number): this;
+  /** Mark the queue as FIFO (deployed). */
+  fifo(fifo?: boolean): this;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): QueueBuilder<TName, TMessage, [...TServices, ...ServicesOf<T>], TLogger>;
+  services<T extends Service[]>(services: T): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger>;
+  logger<T extends Logger>(logger: T): QueueBuilder<TName, TMessage, TServices, T>;
+  /** The typed message (job) payload the queue carries. */
+  message<T extends StandardSchemaV1>(schema: T): QueueBuilder<TName, T, TServices, TLogger>;
+  handle(fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>): Queue<TName, NonNullable<TMessage>, TServices, TLogger>;
+}
+/** A queue built without a name — only reachable by building one by hand. */
+declare class QueueNeedsName extends Error {
+  constructor();
+}
+/** A queue whose message was never described. */
+declare class QueueNeedsMessage extends Error {
+  readonly queue: string;
+  constructor(queue: string);
+}
+//#endregion
+export { QueueNeedsMessage as n, QueueNeedsName as r, QueueBuilder as t };
+//# sourceMappingURL=QueueBuilder-XEnnOWGe.d.cts.map

package/dist/QueueBuilder-XEnnOWGe.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueBuilder-XEnnOWGe.d.cts","names":[],"sources":["../src/queue/QueueBuilder.ts"],"mappings":";;;;;;;;;;;;;cAoBa,aACZ,+BACA,iBAAiB,0CACjB,kBAAkB,gBAClB,gBAAgB,SAAS;UAEjB;UACA;UACA;UACA;UACA;UACA;;EAED;UACC;;EAED;;EAGP,MAAM,kBACL,MAAM,IACJ,aAAa,GAAG,UAAU,WAAW;EASxC,QAAQ;;EAKR,UAAU;;EAKV,KAAK;;;;;;;;;;;;EAeL,gBAAgB,mBAAmB,cAClC,YAAY,IACV,aAAa,OAAO,cAAc,cAAc,WAAW,KAAK;EAqBnE,SAAS,UAAU,WAClB,UAAU,IACR,aAAa,OAAO,cAAc,cAAc,IAAI;EAWvD,OAAO,UAAU,QAChB,QAAQ,IACN,aAAa,OAAO,UAAU,WAAW;;EAO5C,QAAQ,UAAU,kBACjB,QAAQ,IACN,aAAa,OAAO,GAAG,WAAW;EAMrC,OACC,IAAI,aAAa,YAAY,WAAW,WAAW,WACjD,MAAM,OAAO,YAAY,WAAW,WAAW;;;cA6BtC,uBAAuB;EACnC;;;cASY,0BAA0B;WACjB;EAArB,YAAqB"}

package/dist/QueueBuilder-XuPKZwKH.mjs

@@ -0,0 +1,95 @@
+import { idsOf, servicesOf } from "./construct-interface.mjs";
+import { t as cloneWith } from "./clone-EKNovYHu.mjs";
+import { t as Queue } from "./Queue-C1uDgjxt.mjs";
+import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
+//#region src/queue/QueueBuilder.ts
+/**
+* Builds a {@link Queue} and its one consumer. Reached through
+* `worker.queue('orders')`, never constructed by hand: the worker stamps itself
+* as the owner. `message` is the typed job payload and `handle` the consumer.
+* The queue name is captured as a literal so `queue.service` publishes
+* `{ type: '<name>', payload }`.
+*/
+var QueueBuilder = class {
+	_name;
+	_messageSchema;
+	_timeout = 3e4;
+	_batchSize;
+	_fifo;
+	_services = [];
+	/** The construct ids `.dependsOn()` named — what the manifest records. */
+	_constructs = [];
+	_logger = DEFAULT_LOGGER;
+	/** The worker that runs this queue's consumer — stamped by `worker.queue()`. */
+	_owner;
+	/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */
+	queue(name) {
+		return cloneWith(this, { _name: name });
+	}
+	timeout(timeout) {
+		return cloneWith(this, { _timeout: timeout });
+	}
+	/** SQS event-source batch size (deployed). */
+	batchSize(batchSize) {
+		return cloneWith(this, { _batchSize: batchSize });
+	}
+	/** Mark the queue as FIFO (deployed). */
+	fifo(fifo = true) {
+		return cloneWith(this, { _fifo: fifo });
+	}
+	/**
+	* Depend on constructs — a database, a bucket, a mail sender, a queue, a
+	* topic.
+	*
+	* It records the edge and dissolves each construct's client into the
+	* handler's service record under the construct's own id, so
+	* `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+	*
+	* Constructs only. A `Service` does not match the shape, which is what keeps
+	* env sniffing confined to `.services()` and the explicit lift.
+	*/
+	dependsOn(constructs) {
+		const services = servicesOf(constructs);
+		return cloneWith(this, {
+			_services: [...this._services, ...services],
+			_constructs: idsOf(constructs, this._constructs)
+		});
+	}
+	services(services) {
+		return cloneWith(this, { _services: [...this._services, ...services] });
+	}
+	logger(logger) {
+		return cloneWith(this, { _logger: logger });
+	}
+	/** The typed message (job) payload the queue carries. */
+	message(schema) {
+		return cloneWith(this, { _messageSchema: schema });
+	}
+	handle(fn) {
+		if (!this._name) throw new QueueNeedsName();
+		if (!this._messageSchema) throw new QueueNeedsMessage(this._name);
+		const queue = new Queue(this._name, fn, this._messageSchema, this._timeout, this._services, this._logger, this._batchSize, this._fifo, this._constructs);
+		queue.owner = this._owner;
+		return queue;
+	}
+};
+/** A queue built without a name — only reachable by building one by hand. */
+var QueueNeedsName = class extends Error {
+	constructor() {
+		super("A queue needs a name: build it from a worker, worker.queue('Emails').");
+		this.name = "QueueNeedsName";
+	}
+};
+/** A queue whose message was never described. */
+var QueueNeedsMessage = class extends Error {
+	queue;
+	constructor(queue) {
+		super(`Queue '${queue}' has no message: call .message(schema) before .handle(), so its producers and its consumer agree on what it carries.`);
+		this.queue = queue;
+		this.name = "QueueNeedsMessage";
+	}
+};
+//#endregion
+export { QueueNeedsMessage as n, QueueNeedsName as r, QueueBuilder as t };
+
+//# sourceMappingURL=QueueBuilder-XuPKZwKH.mjs.map

package/dist/QueueBuilder-XuPKZwKH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueBuilder-XuPKZwKH.mjs","names":[],"sources":["../src/queue/QueueBuilder.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tservicesOf,\n} from '../construct-interface';\nimport { Queue, type QueueHandler } from './Queue';\n\n/**\n * Builds a {@link Queue} and its one consumer. Reached through\n * `worker.queue('orders')`, never constructed by hand: the worker stamps itself\n * as the owner. `message` is the typed job payload and `handle` the consumer.\n * The queue name is captured as a literal so `queue.service` publishes\n * `{ type: '<name>', payload }`.\n */\nexport class QueueBuilder<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tprivate _name?: string;\n\tprivate _messageSchema?: TMessage;\n\tprivate _timeout = 30000;\n\tprivate _batchSize?: number;\n\tprivate _fifo?: boolean;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\t/** The construct ids `.dependsOn()` named — what the manifest records. */\n\tpublic _constructs: string[] = [];\n\tprivate _logger: TLogger = DEFAULT_LOGGER as TLogger;\n\t/** The worker that runs this queue's consumer — stamped by `worker.queue()`. */\n\tpublic _owner?: string;\n\n\t/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */\n\tqueue<T extends string>(\n\t\tname: T,\n\t): QueueBuilder<T, TMessage, TServices, TLogger> {\n\t\treturn cloneWith(this, { _name: name }) as unknown as QueueBuilder<\n\t\t\tT,\n\t\t\tTMessage,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\t/** SQS event-source batch size (deployed). */\n\tbatchSize(batchSize: number): this {\n\t\treturn cloneWith(this, { _batchSize: batchSize });\n\t}\n\n\t/** Mark the queue as FIFO (deployed). */\n\tfifo(fifo = true): this {\n\t\treturn cloneWith(this, { _fifo: fifo });\n\t}\n\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\tdependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...ServicesOf<T>], TLogger> {\n\t\t// Both halves of the edge, from one call and one clone: the services the\n\t\t// handler runs with, and the ids the manifest records. Recording them\n\t\t// separately is what let them drift apart.\n\t\t//\n\t\t// `servicesOf` is the half that validates, so it runs first — recording\n\t\t// ids ahead of it left a caught `NotAConstruct` with `undefined` already\n\t\t// on a `string[]`.\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services],\n\t\t\t_constructs: idsOf(constructs, this._constructs),\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as unknown as TServices,\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): QueueBuilder<TName, TMessage, TServices, T> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;\n\t}\n\n\t/** The typed message (job) payload the queue carries. */\n\tmessage<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): QueueBuilder<TName, T, TServices, TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_messageSchema: schema as unknown as TMessage,\n\t\t}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;\n\t}\n\n\thandle(\n\t\tfn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,\n\t): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {\n\t\tif (!this._name) throw new QueueNeedsName();\n\t\tif (!this._messageSchema) throw new QueueNeedsMessage(this._name);\n\n\t\tconst queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(\n\t\t\tthis._name as TName,\n\t\t\tfn,\n\t\t\tthis._messageSchema as NonNullable<TMessage>,\n\t\t\tthis._timeout,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._batchSize,\n\t\t\tthis._fifo,\n\t\t\tthis._constructs,\n\t\t);\n\t\t// Which process runs the consumer: the worker it was built from.\n\t\tqueue.owner = this._owner;\n\n\t\t// No reset. `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base — `const fn = f.logger(log).timeout(60_000)` — keeps\n\t\t// its configuration for every construct built from it. The reset that\n\t\t// used to be here wiped the base on first use, which made a base usable\n\t\t// exactly once, and quietly reverted the logger to the default.\n\n\t\treturn queue;\n\t}\n}\n\n/** A queue built without a name — only reachable by building one by hand. */\nexport class QueueNeedsName extends Error {\n\tconstructor() {\n\t\tsuper(\n\t\t\t\"A queue needs a name: build it from a worker, worker.queue('Emails').\",\n\t\t);\n\t\tthis.name = 'QueueNeedsName';\n\t}\n}\n\n/** A queue whose message was never described. */\nexport class QueueNeedsMessage extends Error {\n\tconstructor(readonly queue: string) {\n\t\tsuper(\n\t\t\t`Queue '${queue}' has no message: call .message(schema) before .handle(), ` +\n\t\t\t\t'so its producers and its consumer agree on what it carries.',\n\t\t);\n\t\tthis.name = 'QueueNeedsMessage';\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,IAAa,eAAb,MAKE;CACD;CACA;CACA,WAAmB;CACnB;CACA;CACA,YAA+B,CAAC;;CAEhC,cAA+B,CAAC;CAChC,UAA2B;;CAE3B;;CAGA,MACC,MACgD;EAChD,OAAO,UAAU,MAAM,EAAE,OAAO,KAAK,CAAC;CAMvC;CAEA,QAAQ,SAAuB;EAC9B,OAAO,UAAU,MAAM,EAAE,UAAU,QAAQ,CAAC;CAC7C;;CAGA,UAAU,WAAyB;EAClC,OAAO,UAAU,MAAM,EAAE,YAAY,UAAU,CAAC;CACjD;;CAGA,KAAK,OAAO,MAAY;EACvB,OAAO,UAAU,MAAM,EAAE,OAAO,KAAK,CAAC;CACvC;;;;;;;;;;;;CAaA,UACC,YAC2E;EAQ3E,MAAM,WAAW,WAAW,UAAU;EAEtC,OAAO,UAAU,MAAM;GACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAQ;GAC1C,aAAa,MAAM,YAAY,KAAK,WAAW;EAChD,CAAC;CAMF;CAEA,SACC,UAC+D;EAC/D,OAAO,UAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAQ,EAC3C,CAAC;CAMF;CAEA,OACC,QAC8C;EAC9C,OAAO,UAAU,MAAM,EACtB,SAAS,OACV,CAAC;CACF;;CAGA,QACC,QAC6C;EAC7C,OAAO,UAAU,MAAM,EACtB,gBAAgB,OACjB,CAAC;CACF;CAEA,OACC,IAC0D;EAC1D,IAAI,CAAC,KAAK,OAAO,MAAM,IAAI,eAAe;EAC1C,IAAI,CAAC,KAAK,gBAAgB,MAAM,IAAI,kBAAkB,KAAK,KAAK;EAEhE,MAAM,QAAQ,IAAI,MACjB,KAAK,OACL,IACA,KAAK,gBACL,KAAK,UACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,OACL,KAAK,WACN;EAEA,MAAM,QAAQ,KAAK;EAQnB,OAAO;CACR;AACD;;AAGA,IAAa,iBAAb,cAAoC,MAAM;CACzC,cAAc;EACb,MACC,uEACD;EACA,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,OAAwB;EACnC,MACC,UAAU,MAAM,sHAEjB;EAJoB,KAAA,QAAA;EAKpB,KAAK,OAAO;CACb;AACD"}