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

package/dist/object-storage.d.cts

@@ -1,15 +1,13 @@
-import { Construct } from "./construct-interface-D9d4Gm4p.cjs";
+import { n as Construct } from "./construct-interface-B1AfqRl4.cjs";
 import { Service } from "@geekmidas/services";
 import { ConstructName, Declaration } from "@geekmidas/manifest";
 import { StorageClient } from "@geekmidas/storage";
-
 //#region src/object-storage.d.ts
-
-interface ObjectStorageOptions {
+export interface ObjectStorageOptions {
   /** Keep previous versions of an object. */
   versioned?: boolean;
 }
-declare class ObjectStorage<TName extends string = string> implements Construct<TName, StorageClient> {
+export declare class ObjectStorage<TName extends string = string> implements Construct<TName, StorageClient> {
   private readonly options;
   readonly id: TName;
   readonly service: Service<Uncapitalize<TName>, StorageClient>;
@@ -30,7 +28,5 @@ declare class ObjectStorage<TName extends string = string> implements Construct<
    */
   private connect;
 }
-//# sourceMappingURL=object-storage.d.ts.map
 //#endregion
-export { ObjectStorage, ObjectStorageOptions };
 //# sourceMappingURL=object-storage.d.cts.map

package/dist/object-storage.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"object-storage.d.cts","names":[],"sources":["../src/object-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BwC,UATvB,oBAAA,CASuB;EAAK;EAAN,SAAS,CAAA,EAAA,OAAA;;AAU5B,cAdP,aAcO,CAAA,cAAA,MAAA,GAAA,MAAA,CAAA,YAbR,SAaQ,CAbE,KAaF,EAbS,aAaT,CAAA,CAAA;EAAK,iBAAnB,OAAA;EAAa,SACS,EAAA,EAZd,KAYc;EAAyB,SAgBzC,OAAA,EA3BO,OA2BP,CA3Be,YA2Bf,CA3B4B,KA2B5B,CAAA,EA3BoC,aA2BpC,CAAA;EAAW;AA9BF;;;;;kBAaf,cAAc,kBACQ;aAgBhB"}
+{"version":3,"file":"object-storage.d.cts","names":[],"sources":["../src/object-storage.ts"],"mappings":";;;;;iBAoBiB;;EAEhB;;qBAGY,cAAc,0CACf,UAAU,OAAO;mBAcV;WAZT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ;;;;;;mBAO9B;EAEjB,YACC,IAAI,cAAc,QACD,UAAS;EAgB3B,WAAW;;;;;;;;UAkBG"}

package/dist/object-storage.d.mts

@@ -1,15 +1,13 @@
-import { Construct } from "./construct-interface-g5GM5pwR.mjs";
+import { n as Construct } from "./construct-interface-ZvYQbivO.mjs";
 import { ConstructName, Declaration } from "@geekmidas/manifest";
 import { StorageClient } from "@geekmidas/storage";
 import { Service } from "@geekmidas/services";
-
 //#region src/object-storage.d.ts
-
-interface ObjectStorageOptions {
+export interface ObjectStorageOptions {
   /** Keep previous versions of an object. */
   versioned?: boolean;
 }
-declare class ObjectStorage<TName extends string = string> implements Construct<TName, StorageClient> {
+export declare class ObjectStorage<TName extends string = string> implements Construct<TName, StorageClient> {
   private readonly options;
   readonly id: TName;
   readonly service: Service<Uncapitalize<TName>, StorageClient>;
@@ -30,7 +28,5 @@ declare class ObjectStorage<TName extends string = string> implements Construct<
    */
   private connect;
 }
-//# sourceMappingURL=object-storage.d.ts.map
 //#endregion
-export { ObjectStorage, ObjectStorageOptions };
 //# sourceMappingURL=object-storage.d.mts.map

package/dist/object-storage.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"object-storage.d.mts","names":[],"sources":["../src/object-storage.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BwC,UATvB,oBAAA,CASuB;EAAK;EAAN,SAAS,CAAA,EAAA,OAAA;;AAU5B,cAdP,aAcO,CAAA,cAAA,MAAA,GAAA,MAAA,CAAA,YAbR,SAaQ,CAbE,KAaF,EAbS,aAaT,CAAA,CAAA;EAAK,iBAAnB,OAAA;EAAa,SACS,EAAA,EAZd,KAYc;EAAyB,SAgBzC,OAAA,EA3BO,OA2BP,CA3Be,YA2Bf,CA3B4B,KA2B5B,CAAA,EA3BoC,aA2BpC,CAAA;EAAW;AA9BF;;;;;kBAaf,cAAc,kBACQ;aAgBhB"}
+{"version":3,"file":"object-storage.d.mts","names":[],"sources":["../src/object-storage.ts"],"mappings":";;;;;iBAoBiB;;EAEhB;;qBAGY,cAAc,0CACf,UAAU,OAAO;mBAcV;WAZT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ;;;;;;mBAO9B;EAEjB,YACC,IAAI,cAAc,QACD,UAAS;EAgB3B,WAAW;;;;;;;;UAkBG"}

package/dist/object-storage.mjs

@@ -1,8 +1,16 @@
 import { canonicalId, provideKey, serviceKey } from "@geekmidas/manifest";
 import { createStorageClient } from "@geekmidas/storage";
-
 //#region src/object-storage.ts
+/**
+* `ObjectStorage` — a declared bucket.
+*
+* Where the three packages meet: it implements the construct contract, derives
+* its env key through `@geekmidas/manifest`, and hands back a
+* `@geekmidas/storage` client. It names no cloud — `--target=aws` fills the
+* injected URL with S3's values, local dev with MinIO's.
+*/
 var ObjectStorage = class {
+	options;
 	id;
 	service;
 	/**
@@ -18,7 +26,7 @@ var ObjectStorage = class {
 		this.keys = { url: provideKey(canonical, "url") };
 		this.service = {
 			serviceName: serviceKey(canonical),
-			register: (options$1) => this.connect(options$1)
+			register: (options) => this.connect(options)
 		};
 	}
 	declare() {
@@ -41,7 +49,7 @@ var ObjectStorage = class {
 		return createStorageClient(url);
 	}
 };
-
 //#endregion
 export { ObjectStorage };
+
 //# sourceMappingURL=object-storage.mjs.map

package/dist/object-storage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"object-storage.mjs","names":["id: ConstructName<TName>","options: ObjectStorageOptions","options"],"sources":["../src/object-storage.ts"],"sourcesContent":["/**\n * `ObjectStorage` — a declared bucket.\n *\n * Where the three packages meet: it implements the construct contract, derives\n * its env key through `@geekmidas/manifest`, and hands back a\n * `@geekmidas/storage` client. It names no cloud — `--target=aws` fills the\n * injected URL with S3's values, local dev with MinIO's.\n */\n\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { Service, ServiceRegisterOptions } from '@geekmidas/services';\nimport { createStorageClient, type StorageClient } from '@geekmidas/storage';\nimport type { Construct } from './construct-interface';\n\nexport interface ObjectStorageOptions {\n\t/** Keep previous versions of an object. */\n\tversioned?: boolean;\n}\n\nexport class ObjectStorage<TName extends string = string>\n\timplements Construct<TName, StorageClient>\n{\n\treadonly id: TName;\n\treadonly service: Service<Uncapitalize<TName>, StorageClient>;\n\n\t/**\n\t * Declared once and read by both `declare()` and `connect()`, so the key the\n\t * build publishes and the key the client reads cannot drift — the whole point\n\t * of the construct owning both faces.\n\t */\n\tprivate readonly keys: { url: string };\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly options: ObjectStorageOptions = {},\n\t) {\n\t\t// Canonicalises, so `uploads` and `Uploads` are one construct rather than\n\t\t// two that collide. Throws on anything that cannot become a valid id.\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.keys = { url: provideKey(canonical, 'url') };\n\n\t\t// A field, not a getter: consumers cache services by object identity.\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(canonical) as Uncapitalize<TName>,\n\t\t\tregister: (options) => this.connect(options),\n\t\t};\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'objects',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.keys.url],\n\t\t\t\t...(this.options.versioned ? { versioned: true } : {}),\n\t\t\t},\n\t\t];\n\t}\n\n\t/**\n\t * Builds the client from the single URL the adapter supplied.\n\t *\n\t * The URL's scheme selects the driver, so this construct imports no provider\n\t * and an app that never touches S3 never resolves the AWS SDK. Whoever\n\t * assembles the application registers the drivers its target needs.\n\t */\n\tprivate async connect({\n\t\tenvParser,\n\t}: ServiceRegisterOptions): Promise<StorageClient> {\n\t\tconst { url } = envParser\n\t\t\t.create((get) => ({ url: get(this.keys.url).string() }))\n\t\t\t.parse();\n\n\t\treturn createStorageClient(url);\n\t}\n}\n"],"mappings":";;;;AAyBA,IAAa,gBAAb,MAEA;CACC,AAAS;CACT,AAAS;;;;;;CAOT,AAAiB;CAEjB,YACCA,IACiBC,UAAgC,CAAE,GAClD;EADgB;EAIjB,MAAM,YAAY,YAAY,GAAa;AAE3C,OAAK,KAAK;AACV,OAAK,OAAO,EAAE,KAAK,WAAW,WAAW,MAAM,CAAE;AAGjD,OAAK,UAAU;GACd,aAAa,WAAW,UAAU;GAClC,UAAU,CAACC,cAAY,KAAK,QAAQA,UAAQ;EAC5C;CACD;CAED,UAAyB;AACxB,SAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,KAAK,GAAI;GACzB,GAAI,KAAK,QAAQ,YAAY,EAAE,WAAW,KAAM,IAAG,CAAE;EACrD,CACD;CACD;;;;;;;;CASD,MAAc,QAAQ,EACrB,WACwB,EAA0B;EAClD,MAAM,EAAE,KAAK,GAAG,UACd,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAE,GAAE,CACvD,OAAO;AAET,SAAO,oBAAoB,IAAI;CAC/B;AACD"}
+{"version":3,"file":"object-storage.mjs","names":[],"sources":["../src/object-storage.ts"],"sourcesContent":["/**\n * `ObjectStorage` — a declared bucket.\n *\n * Where the three packages meet: it implements the construct contract, derives\n * its env key through `@geekmidas/manifest`, and hands back a\n * `@geekmidas/storage` client. It names no cloud — `--target=aws` fills the\n * injected URL with S3's values, local dev with MinIO's.\n */\n\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { Service, ServiceRegisterOptions } from '@geekmidas/services';\nimport { createStorageClient, type StorageClient } from '@geekmidas/storage';\nimport type { Construct } from './construct-interface';\n\nexport interface ObjectStorageOptions {\n\t/** Keep previous versions of an object. */\n\tversioned?: boolean;\n}\n\nexport class ObjectStorage<TName extends string = string>\n\timplements Construct<TName, StorageClient>\n{\n\treadonly id: TName;\n\treadonly service: Service<Uncapitalize<TName>, StorageClient>;\n\n\t/**\n\t * Declared once and read by both `declare()` and `connect()`, so the key the\n\t * build publishes and the key the client reads cannot drift — the whole point\n\t * of the construct owning both faces.\n\t */\n\tprivate readonly keys: { url: string };\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly options: ObjectStorageOptions = {},\n\t) {\n\t\t// Canonicalises, so `uploads` and `Uploads` are one construct rather than\n\t\t// two that collide. Throws on anything that cannot become a valid id.\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.keys = { url: provideKey(canonical, 'url') };\n\n\t\t// A field, not a getter: consumers cache services by object identity.\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(canonical) as Uncapitalize<TName>,\n\t\t\tregister: (options) => this.connect(options),\n\t\t};\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'objects',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.keys.url],\n\t\t\t\t...(this.options.versioned ? { versioned: true } : {}),\n\t\t\t},\n\t\t];\n\t}\n\n\t/**\n\t * Builds the client from the single URL the adapter supplied.\n\t *\n\t * The URL's scheme selects the driver, so this construct imports no provider\n\t * and an app that never touches S3 never resolves the AWS SDK. Whoever\n\t * assembles the application registers the drivers its target needs.\n\t */\n\tprivate async connect({\n\t\tenvParser,\n\t}: ServiceRegisterOptions): Promise<StorageClient> {\n\t\tconst { url } = envParser\n\t\t\t.create((get) => ({ url: get(this.keys.url).string() }))\n\t\t\t.parse();\n\n\t\treturn createStorageClient(url);\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAyBA,IAAa,gBAAb,MAEA;CAamB;CAZlB;CACA;;;;;;CAOA;CAEA,YACC,IACA,UAAiD,CAAC,GACjD;EADgB,KAAA,UAAA;EAIjB,MAAM,YAAY,YAAY,EAAY;EAE1C,KAAK,KAAK;EACV,KAAK,OAAO,EAAE,KAAK,WAAW,WAAW,KAAK,EAAE;EAGhD,KAAK,UAAU;GACd,aAAa,WAAW,SAAS;GACjC,WAAW,YAAY,KAAK,QAAQ,OAAO;EAC5C;CACD;CAEA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,KAAK,GAAG;GACxB,GAAI,KAAK,QAAQ,YAAY,EAAE,WAAW,KAAK,IAAI,CAAC;EACrD,CACD;CACD;;;;;;;;CASA,MAAc,QAAQ,EACrB,aACkD;EAClD,MAAM,EAAE,QAAQ,UACd,QAAQ,SAAS,EAAE,KAAK,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACvD,MAAM;EAER,OAAO,oBAAoB,GAAG;CAC/B;AACD"}

package/dist/queue/index.cjs

@@ -1,189 +1,6 @@
-const require_chunk = require('../chunk-DWy1uDak.cjs');
-const require_construct_interface = require('../construct-interface-BfjcOD_E.cjs');
-const require_Construct = require('../Construct-CyS3RpTL.cjs');
-const require_clone = require('../clone-Dy0cR2SZ.cjs');
-const __geekmidas_manifest = require_chunk.__toESM(require("@geekmidas/manifest"));
-const __geekmidas_logger_console = require_chunk.__toESM(require("@geekmidas/logger/console"));
-const __geekmidas_events = require_chunk.__toESM(require("@geekmidas/events"));
-
-//#region src/queue/Queue.ts
-/**
-* 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.
-*
-* The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
-* that any endpoint/function drops into `.services([...])` to send messages.
-*/
-var Queue = class extends require_Construct.Construct {
-	__IS_QUEUE__ = true;
-	static isQueue(obj) {
-		return Boolean(obj && obj.__IS_QUEUE__ === true && obj.type === require_Construct.ConstructType.Queue);
-	}
-	/**
-	* 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.
-	*/
-	id;
-	/**
-	* 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.
-	*/
-	connectionKey;
-	constructor(name, handler, messageSchema, timeout = 3e4, services = [], logger = __geekmidas_logger_console.DEFAULT_LOGGER, batchSize, fifo, constructs = []) {
-		super(require_Construct.ConstructType.Queue, logger, services, [], void 0, void 0, timeout, void 0, void 0, constructs);
-		this.name = name;
-		this.handler = handler;
-		this.messageSchema = messageSchema;
-		this.timeout = timeout;
-		this.services = services;
-		this.logger = logger;
-		this.batchSize = batchSize;
-		this.fifo = fifo;
-		this.id = (0, __geekmidas_manifest.canonicalId)(name);
-		this.connectionKey = (0, __geekmidas_manifest.provideKey)(this.id, "publisherConnectionString");
-	}
-	/**
-	* 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() {
-		return [{
-			kind: "queue",
-			id: this.id,
-			provides: [this.connectionKey],
-			...this.fifo ? { fifo: true } : {},
-			worker: {
-				id: `${this.id}Worker`,
-				handler: `${this.id}.handler`,
-				dependencies: []
-			}
-		}];
-	}
-	/**
-	* 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() {
-		const { register } = this.publisher;
-		return {
-			serviceName: (0, __geekmidas_manifest.serviceKey)(this.id),
-			register
-		};
-	}
-	get publisher() {
-		const envVar = this.connectionKey;
-		return {
-			serviceName: `${this.name}Publisher`,
-			async register({ envParser }) {
-				const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
-				return __geekmidas_events.Publisher.fromConnectionString(connectionString);
-			}
-		};
-	}
-};
-
-//#endregion
-//#region src/queue/QueueBuilder.ts
-/**
-* Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
-* Services are an array (sniffed for required env vars); `message` is the typed
-* job payload; `handle` is the single consumer. The queue name is captured as a
-* literal so `queue.publisher` is typed to `{ 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 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 Error("Queue requires a name — call .queue(name) before .handle().");
-		if (!this._messageSchema) throw new Error("Queue requires a message schema — call .message(schema) before .handle().");
-		const queue = new Queue(this._name, fn, this._messageSchema, this._timeout, this._services, this._logger, this._batchSize, this._fifo, this._constructs);
-		return queue;
-	}
-};
-
-//#endregion
-//#region src/queue/index.ts
-const q = new QueueBuilder();
-
-//#endregion
-exports.Queue = Queue;
-exports.QueueBuilder = QueueBuilder;
-exports.q = q;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_Queue = require("../Queue-BhuofM3k.cjs");
+const require_QueueBuilder = require("../QueueBuilder-DdU2klPu.cjs");
+exports.Queue = require_Queue.Queue;
+exports.QueueNeedsMessage = require_QueueBuilder.QueueNeedsMessage;
+exports.QueueNeedsName = require_QueueBuilder.QueueNeedsName;

package/dist/queue/index.d.cts

@@ -1,60 +1,3 @@
-import "../Construct-C0ijr2qp.cjs";
-import { Consumable, ServicesOf } from "../construct-interface-D9d4Gm4p.cjs";
-import { Queue, QueueContext, QueueHandler, QueueMessage } from "../Queue-D7ZuwBhy.cjs";
-import * as _geekmidas_logger12 from "@geekmidas/logger";
-import { Logger } from "@geekmidas/logger";
-import { Service } from "@geekmidas/services";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
-//#region src/queue/QueueBuilder.d.ts
-
-/**
- * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
- * Services are an array (sniffed for required env vars); `message` is the typed
- * job payload; `handle` is the single consumer. The queue name is captured as a
- * literal so `queue.publisher` is typed to `{ 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 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>;
-}
-//# sourceMappingURL=QueueBuilder.d.ts.map
-//#endregion
-//#region src/queue/index.d.ts
-declare const q: QueueBuilder<string, undefined, [], _geekmidas_logger12.Logger>;
-//# sourceMappingURL=index.d.ts.map
-
-//#endregion
-export { Queue, QueueBuilder, QueueContext, QueueHandler, QueueMessage, q };
-//# sourceMappingURL=index.d.cts.map
+import { i as QueueMessage, n as QueueContext, r as QueueHandler, t as Queue } from "../Queue-HPyi0e1i.cjs";
+import { n as QueueNeedsMessage, r as QueueNeedsName } from "../QueueBuilder-OSi6LkV9.cjs";
+export { Queue, type QueueContext, type QueueHandler, type QueueMessage, QueueNeedsMessage, QueueNeedsName };

package/dist/queue/index.d.mts

@@ -1,60 +1,3 @@
-import "../Construct-Ct8nalEi.mjs";
-import { Consumable, ServicesOf } from "../construct-interface-g5GM5pwR.mjs";
-import { Queue, QueueContext, QueueHandler, QueueMessage } from "../Queue-gVGfi2Yk.mjs";
-import { Service } from "@geekmidas/services";
-import * as _geekmidas_logger12 from "@geekmidas/logger";
-import { Logger } from "@geekmidas/logger";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
-//#region src/queue/QueueBuilder.d.ts
-
-/**
- * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
- * Services are an array (sniffed for required env vars); `message` is the typed
- * job payload; `handle` is the single consumer. The queue name is captured as a
- * literal so `queue.publisher` is typed to `{ 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 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>;
-}
-//# sourceMappingURL=QueueBuilder.d.ts.map
-//#endregion
-//#region src/queue/index.d.ts
-declare const q: QueueBuilder<string, undefined, [], _geekmidas_logger12.Logger>;
-//# sourceMappingURL=index.d.ts.map
-
-//#endregion
-export { Queue, QueueBuilder, QueueContext, QueueHandler, QueueMessage, q };
-//# sourceMappingURL=index.d.mts.map
+import { i as QueueMessage, n as QueueContext, r as QueueHandler, t as Queue } from "../Queue-DlsHRzUp.mjs";
+import { n as QueueNeedsMessage, r as QueueNeedsName } from "../QueueBuilder-Cx9lKC5d.mjs";
+export { Queue, type QueueContext, type QueueHandler, type QueueMessage, QueueNeedsMessage, QueueNeedsName };

package/dist/queue/index.mjs

@@ -1,186 +1,3 @@
-import { Construct, ConstructType } from "../Construct-BD5neF7w.mjs";
-import { idsOf, servicesOf } from "../construct-interface-Z4CpS8tK.mjs";
-import { cloneWith } from "../clone-DblgEZZa.mjs";
-import { canonicalId, provideKey, serviceKey } from "@geekmidas/manifest";
-import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
-import { Publisher } from "@geekmidas/events";
-
-//#region src/queue/Queue.ts
-/**
-* 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.
-*
-* The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
-* that any endpoint/function drops into `.services([...])` to send messages.
-*/
-var Queue = class extends Construct {
-	__IS_QUEUE__ = true;
-	static isQueue(obj) {
-		return Boolean(obj && obj.__IS_QUEUE__ === true && obj.type === ConstructType.Queue);
-	}
-	/**
-	* 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.
-	*/
-	id;
-	/**
-	* 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.
-	*/
-	connectionKey;
-	constructor(name, handler, messageSchema, timeout = 3e4, services = [], logger = DEFAULT_LOGGER, batchSize, fifo, constructs = []) {
-		super(ConstructType.Queue, logger, services, [], void 0, void 0, timeout, void 0, void 0, constructs);
-		this.name = name;
-		this.handler = handler;
-		this.messageSchema = messageSchema;
-		this.timeout = timeout;
-		this.services = services;
-		this.logger = logger;
-		this.batchSize = batchSize;
-		this.fifo = fifo;
-		this.id = canonicalId(name);
-		this.connectionKey = provideKey(this.id, "publisherConnectionString");
-	}
-	/**
-	* 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() {
-		return [{
-			kind: "queue",
-			id: this.id,
-			provides: [this.connectionKey],
-			...this.fifo ? { fifo: true } : {},
-			worker: {
-				id: `${this.id}Worker`,
-				handler: `${this.id}.handler`,
-				dependencies: []
-			}
-		}];
-	}
-	/**
-	* 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() {
-		const { register } = this.publisher;
-		return {
-			serviceName: serviceKey(this.id),
-			register
-		};
-	}
-	get publisher() {
-		const envVar = this.connectionKey;
-		return {
-			serviceName: `${this.name}Publisher`,
-			async register({ envParser }) {
-				const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
-				return Publisher.fromConnectionString(connectionString);
-			}
-		};
-	}
-};
-
-//#endregion
-//#region src/queue/QueueBuilder.ts
-/**
-* Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
-* Services are an array (sniffed for required env vars); `message` is the typed
-* job payload; `handle` is the single consumer. The queue name is captured as a
-* literal so `queue.publisher` is typed to `{ 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 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 Error("Queue requires a name — call .queue(name) before .handle().");
-		if (!this._messageSchema) throw new Error("Queue requires a message schema — call .message(schema) before .handle().");
-		const queue = new Queue(this._name, fn, this._messageSchema, this._timeout, this._services, this._logger, this._batchSize, this._fifo, this._constructs);
-		return queue;
-	}
-};
-
-//#endregion
-//#region src/queue/index.ts
-const q = new QueueBuilder();
-
-//#endregion
-export { Queue, QueueBuilder, q };
-//# sourceMappingURL=index.mjs.map
+import { t as Queue } from "../Queue-cmhqEBOB.mjs";
+import { n as QueueNeedsMessage, r as QueueNeedsName } from "../QueueBuilder-DXu1qxT1.mjs";
+export { Queue, QueueNeedsMessage, QueueNeedsName };