@geekmidas/constructs 10.0.0-alpha.0 → 10.0.0-alpha.2

package/dist/subscribers/index.d.cts

@@ -1,61 +1,12 @@
-import "../Construct-WhCXIOPV.cjs";
-import { Consumable, ServicesOf } from "../construct-interface-D2nNkHUN.cjs";
-import { Subscriber, SubscriberHandler } from "../Subscriber-DVQowdyj.cjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-Ohx9dvWr.cjs";
-import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
-import * as _geekmidas_logger19 from "@geekmidas/logger";
-import { Logger } from "@geekmidas/logger";
-import { Service } from "@geekmidas/services";
-import { StandardSchemaV1 } from "@standard-schema/spec";
+import "../Construct-C0ijr2qp.cjs";
+import "../construct-interface-D9d4Gm4p.cjs";
+import { Subscriber } from "../Subscriber-2mEi0ImH.cjs";
+import "../Topic-19QeHBIR.cjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-waNhzjSM.cjs";
+import * as _geekmidas_logger24 from "@geekmidas/logger";
 
-//#region src/subscribers/SubscriberBuilder.d.ts
-declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TSubscribedEvents extends any[] = []> {
-  private _subscribedEvents;
-  private _timeout?;
-  private outputSchema?;
-  private _services;
-  /** The construct ids `.dependsOn()` named — what the manifest records. */
-  _constructs: string[];
-  private _logger;
-  private _publisher?;
-  private _topicName?;
-  constructor();
-  /**
-   * Bind this subscriber to a {@link Topic} — the preferred way to type and wire
-   * a fan-out consumer. It supplies the subscribable event types (and their
-   * payloads) from the topic's contract and records the binding for the manifest,
-   * so infra wires the SNS subscription.
-   *
-   * Prefer this over typing via a hand-written publisher service: a consumer does
-   * not publish, so binding a topic does *not* require the topic's publisher
-   * connection string (least privilege). Use `.publisher(...)` only when the
-   * subscriber actually publishes follow-up events.
-   */
-  topic<TName extends string, TEvents extends TopicEvents>(topic: Topic<TName, TEvents>): SubscriberBuilder<TServices, TLogger, OutSchema, EventPublisher<TopicMessage<TEvents>>, TEventPublisherServiceName, TSubscribedEvents>;
-  timeout(timeout: number): this;
-  output<T extends StandardSchemaV1>(schema: T): SubscriberBuilder<TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  /**
-   * 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): SubscriberBuilder<[...TServices, ...ServicesOf<T>], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  services<T extends Service[]>(services: T): SubscriberBuilder<[...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  logger<T extends Logger>(logger: T): SubscriberBuilder<TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  publisher<T extends EventPublisher<any>, TName extends string>(publisher: Service<TName, T>): SubscriberBuilder<TServices, TLogger, OutSchema, T, TName, TSubscribedEvents>;
-  subscribe<TEvent extends (TEventPublisher extends EventPublisher<any> ? ExtractPublisherMessage<TEventPublisher>['type'] | ExtractPublisherMessage<TEventPublisher>['type'][] : never)>(event: TEvent): SubscriberBuilder<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TEvent extends any[] ? [...TSubscribedEvents, ...TEvent] : [...TSubscribedEvents, TEvent]>;
-  handle(fn: SubscriberHandler<TEventPublisher, TSubscribedEvents, TServices, TLogger, OutSchema>): Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-}
-//# sourceMappingURL=SubscriberBuilder.d.ts.map
-//#endregion
 //#region src/subscribers/index.d.ts
-declare const s: SubscriberBuilder<[], _geekmidas_logger19.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger24.Logger, undefined, undefined, string, []>;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion

package/dist/subscribers/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAKa,GAAC,sBAA0B,mBAAA,CAA1B,MAAA"}

package/dist/subscribers/index.d.mts

@@ -1,61 +1,12 @@
-import "../Construct-B-xc0SE9.mjs";
-import { Consumable, ServicesOf } from "../construct-interface-BqwRNYA2.mjs";
-import { Subscriber, SubscriberHandler } from "../Subscriber-4rBJgDKI.mjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-cmy2jOUy.mjs";
-import { Service } from "@geekmidas/services";
-import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
-import * as _geekmidas_logger16 from "@geekmidas/logger";
-import { Logger } from "@geekmidas/logger";
-import { StandardSchemaV1 } from "@standard-schema/spec";
+import "../Construct-Ct8nalEi.mjs";
+import "../construct-interface-g5GM5pwR.mjs";
+import { Subscriber } from "../Subscriber-xTJ9ayPN.mjs";
+import "../Topic-DuFeqkBh.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-Dptmo-1A.mjs";
+import * as _geekmidas_logger25 from "@geekmidas/logger";
 
-//#region src/subscribers/SubscriberBuilder.d.ts
-declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TSubscribedEvents extends any[] = []> {
-  private _subscribedEvents;
-  private _timeout?;
-  private outputSchema?;
-  private _services;
-  /** The construct ids `.dependsOn()` named — what the manifest records. */
-  _constructs: string[];
-  private _logger;
-  private _publisher?;
-  private _topicName?;
-  constructor();
-  /**
-   * Bind this subscriber to a {@link Topic} — the preferred way to type and wire
-   * a fan-out consumer. It supplies the subscribable event types (and their
-   * payloads) from the topic's contract and records the binding for the manifest,
-   * so infra wires the SNS subscription.
-   *
-   * Prefer this over typing via a hand-written publisher service: a consumer does
-   * not publish, so binding a topic does *not* require the topic's publisher
-   * connection string (least privilege). Use `.publisher(...)` only when the
-   * subscriber actually publishes follow-up events.
-   */
-  topic<TName extends string, TEvents extends TopicEvents>(topic: Topic<TName, TEvents>): SubscriberBuilder<TServices, TLogger, OutSchema, EventPublisher<TopicMessage<TEvents>>, TEventPublisherServiceName, TSubscribedEvents>;
-  timeout(timeout: number): this;
-  output<T extends StandardSchemaV1>(schema: T): SubscriberBuilder<TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  /**
-   * 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): SubscriberBuilder<[...TServices, ...ServicesOf<T>], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  services<T extends Service[]>(services: T): SubscriberBuilder<[...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  logger<T extends Logger>(logger: T): SubscriberBuilder<TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-  publisher<T extends EventPublisher<any>, TName extends string>(publisher: Service<TName, T>): SubscriberBuilder<TServices, TLogger, OutSchema, T, TName, TSubscribedEvents>;
-  subscribe<TEvent extends (TEventPublisher extends EventPublisher<any> ? ExtractPublisherMessage<TEventPublisher>['type'] | ExtractPublisherMessage<TEventPublisher>['type'][] : never)>(event: TEvent): SubscriberBuilder<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TEvent extends any[] ? [...TSubscribedEvents, ...TEvent] : [...TSubscribedEvents, TEvent]>;
-  handle(fn: SubscriberHandler<TEventPublisher, TSubscribedEvents, TServices, TLogger, OutSchema>): Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
-}
-//# sourceMappingURL=SubscriberBuilder.d.ts.map
-//#endregion
 //#region src/subscribers/index.d.ts
-declare const s: SubscriberBuilder<[], _geekmidas_logger16.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger25.Logger, undefined, undefined, string, []>;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion

package/dist/subscribers/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAKa,GAAC,sBAA0B,mBAAA,CAA1B,MAAA"}

package/dist/subscribers/index.mjs

@@ -1,103 +1,8 @@
-import { Construct, ConstructType } from "../Construct-HmWM6YYu.mjs";
-import { idsOf, servicesOf } from "../construct-interface-Z4CpS8tK.mjs";
-import { cloneWith } from "../clone-DblgEZZa.mjs";
-import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
+import "../Construct-BD5neF7w.mjs";
+import "../construct-interface-Z4CpS8tK.mjs";
+import "../clone-DblgEZZa.mjs";
+import { Subscriber, SubscriberBuilder } from "../SubscriberBuilder-BjkbeT9l.mjs";
 
-//#region src/subscribers/Subscriber.ts
-var Subscriber = class extends Construct {
-	__IS_SUBSCRIBER__ = true;
-	static isSubscriber(obj) {
-		return Boolean(obj && obj.__IS_SUBSCRIBER__ === true && obj.type === ConstructType.Subscriber);
-	}
-	constructor(handler, timeout = 3e4, _subscribedEvents, outputSchema, services = [], logger = DEFAULT_LOGGER, publisherService, topicName, constructs = []) {
-		super(ConstructType.Subscriber, logger, services, [], publisherService, outputSchema, timeout, void 0, void 0, constructs);
-		this.handler = handler;
-		this.timeout = timeout;
-		this._subscribedEvents = _subscribedEvents;
-		this.outputSchema = outputSchema;
-		this.services = services;
-		this.logger = logger;
-		this.publisherService = publisherService;
-		this.topicName = topicName;
-	}
-	get subscribedEvents() {
-		return this._subscribedEvents;
-	}
-};
-
-//#endregion
-//#region src/subscribers/SubscriberBuilder.ts
-var SubscriberBuilder = class {
-	_subscribedEvents = [];
-	_timeout;
-	outputSchema;
-	_services = [];
-	/** The construct ids `.dependsOn()` named — what the manifest records. */
-	_constructs = [];
-	_logger = DEFAULT_LOGGER;
-	_publisher;
-	_topicName;
-	constructor() {
-		this._timeout = 3e4;
-	}
-	/**
-	* Bind this subscriber to a {@link Topic} — the preferred way to type and wire
-	* a fan-out consumer. It supplies the subscribable event types (and their
-	* payloads) from the topic's contract and records the binding for the manifest,
-	* so infra wires the SNS subscription.
-	*
-	* Prefer this over typing via a hand-written publisher service: a consumer does
-	* not publish, so binding a topic does *not* require the topic's publisher
-	* connection string (least privilege). Use `.publisher(...)` only when the
-	* subscriber actually publishes follow-up events.
-	*/
-	topic(topic) {
-		return cloneWith(this, { _topicName: topic.name });
-	}
-	timeout(timeout) {
-		return cloneWith(this, { _timeout: timeout });
-	}
-	output(schema) {
-		return cloneWith(this, { outputSchema: schema });
-	}
-	/**
-	* 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 });
-	}
-	publisher(publisher) {
-		return cloneWith(this, { _publisher: publisher });
-	}
-	subscribe(event) {
-		const eventsToAdd = Array.isArray(event) ? event : [event];
-		return cloneWith(this, { _subscribedEvents: [...this._subscribedEvents, ...eventsToAdd] });
-	}
-	handle(fn) {
-		const subscriber = new Subscriber(fn, this._timeout, this._subscribedEvents, this.outputSchema, this._services, this._logger, this._publisher, this._topicName, this._constructs);
-		return subscriber;
-	}
-};
-
-//#endregion
 //#region src/subscribers/index.ts
 const s = new SubscriberBuilder();
 

package/dist/subscribers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["obj: any","handler: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>","timeout: number","_subscribedEvents?: TSubscribedEvents","outputSchema?: OutSchema","services: TServices","logger: TLogger","publisherService?: Service<\n\t\t\tTEventPublisherServiceName,\n\t\t\tTEventPublisher\n\t\t>","topicName?: string","constructs: string[]","topic: Topic<TName, TEvents>","timeout: number","schema: T","constructs: T","services: T","logger: T","publisher: Service<TName, T>","event: TEvent","fn: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>"],"sources":["../../src/subscribers/Subscriber.ts","../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":["import type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\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// Helper type to extract payload types for subscribed events\ntype ExtractEventPayloads<\n\tTPublisher extends EventPublisher<any> | undefined,\n\tTEventTypes extends any[],\n> = TPublisher extends EventPublisher<any>\n\t? Extract<ExtractPublisherMessage<TPublisher>, { type: TEventTypes[number] }>\n\t: never;\n\nexport class Subscriber<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends\n\t\tExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][],\n> extends Construct<\n\tTLogger,\n\tTEventPublisherServiceName,\n\tTEventPublisher,\n\tOutSchema,\n\tTServices\n> {\n\t__IS_SUBSCRIBER__ = true;\n\n\tstatic isSubscriber(\n\t\tobj: any,\n\t): obj is Subscriber<any, any, any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\tobj.__IS_SUBSCRIBER__ === true &&\n\t\t\t\tobj.type === ConstructType.Subscriber,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tpublic readonly handler: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>,\n\t\tpublic override readonly timeout: number = 30000,\n\t\tprotected _subscribedEvents?: TSubscribedEvents,\n\t\tpublic override readonly outputSchema?: OutSchema,\n\t\tpublic override readonly services: TServices = [] as unknown as TServices,\n\t\tpublic override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,\n\t\tpublic override readonly publisherService?: Service<\n\t\t\tTEventPublisherServiceName,\n\t\t\tTEventPublisher\n\t\t>,\n\t\t/**\n\t\t * The name of the {@link Topic} this subscriber binds to (via\n\t\t * `s.topic(topic)`), recorded for the manifest so infra wires the SNS\n\t\t * subscription. Undefined when the subscriber's events are typed from a\n\t\t * (hand-written) publisher instead.\n\t\t */\n\t\tpublic readonly topicName?: string,\n\t\t/**\n\t\t * The construct ids `.dependsOn()` named — last, so no existing positional\n\t\t * argument moves.\n\t\t */\n\t\tconstructs: string[] = [],\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Subscriber,\n\t\t\tlogger,\n\t\t\tservices,\n\t\t\t[],\n\t\t\tpublisherService,\n\t\t\toutputSchema,\n\t\t\ttimeout,\n\t\t\tundefined, // memorySize\n\t\t\tundefined, // auditorStorageService\n\t\t\tconstructs,\n\t\t);\n\t}\n\n\tget subscribedEvents(): TSubscribedEvents | undefined {\n\t\treturn this._subscribedEvents;\n\t}\n}\n\n// Handler type for subscribers that receives an array of events\nexport type SubscriberHandler<\n\tTEventPublisher extends EventPublisher<any> | undefined,\n\tTSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n> = (\n\tctx: SubscriberContext<\n\t\tTEventPublisher,\n\t\tTSubscribedEvents,\n\t\tTServices,\n\t\tTLogger\n\t>,\n) => OutSchema extends StandardSchemaV1\n\t? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>>\n\t: any | Promise<any>;\n\n// Context type for subscriber handlers\nexport type SubscriberContext<\n\tTEventPublisher extends EventPublisher<any> | undefined,\n\tTSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = {\n\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n};\n","import type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport 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 type { Topic, TopicEvents, TopicMessage } from '../topic/Topic';\nimport { Subscriber, type SubscriberHandler } from './Subscriber';\n\nexport class SubscriberBuilder<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends any[] = [],\n> {\n\tprivate _subscribedEvents: TSubscribedEvents = [] as any;\n\tprivate _timeout?: number;\n\tprivate outputSchema?: OutSchema;\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;\n\tprivate _publisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\tprivate _topicName?: string;\n\n\tconstructor() {\n\t\tthis._timeout = 30000; // Default timeout\n\t}\n\n\t/**\n\t * Bind this subscriber to a {@link Topic} — the preferred way to type and wire\n\t * a fan-out consumer. It supplies the subscribable event types (and their\n\t * payloads) from the topic's contract and records the binding for the manifest,\n\t * so infra wires the SNS subscription.\n\t *\n\t * Prefer this over typing via a hand-written publisher service: a consumer does\n\t * not publish, so binding a topic does *not* require the topic's publisher\n\t * connection string (least privilege). Use `.publisher(...)` only when the\n\t * subscriber actually publishes follow-up events.\n\t */\n\ttopic<TName extends string, TEvents extends TopicEvents>(\n\t\ttopic: Topic<TName, TEvents>,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tEventPublisher<TopicMessage<TEvents>>,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_topicName: topic.name,\n\t\t}) as unknown as SubscriberBuilder<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tEventPublisher<TopicMessage<TEvents>>,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\toutput<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as any;\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): SubscriberBuilder<\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\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 SubscriberBuilder<\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>;\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): SubscriberBuilder<\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as any,\n\t\t}) as any;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, { _logger: logger as unknown as TLogger }) as any;\n\t}\n\n\tpublisher<T extends EventPublisher<any>, TName extends string>(\n\t\tpublisher: Service<TName, T>,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tT,\n\t\tTName,\n\t\tTSubscribedEvents\n\t> {\n\t\treturn cloneWith(this, { _publisher: publisher as any }) as any;\n\t}\n\n\tsubscribe<\n\t\tTEvent extends TEventPublisher extends EventPublisher<any>\n\t\t\t?\n\t\t\t\t\t| ExtractPublisherMessage<TEventPublisher>['type']\n\t\t\t\t\t| ExtractPublisherMessage<TEventPublisher>['type'][]\n\t\t\t: never,\n\t>(\n\t\tevent: TEvent,\n\t): SubscriberBuilder<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTEvent extends any[]\n\t\t\t? [...TSubscribedEvents, ...TEvent]\n\t\t\t: [...TSubscribedEvents, TEvent]\n\t> {\n\t\tconst eventsToAdd = Array.isArray(event) ? event : [event];\n\t\treturn cloneWith(this, {\n\t\t\t_subscribedEvents: [...this._subscribedEvents, ...eventsToAdd] as any,\n\t\t}) as any;\n\t}\n\n\thandle(\n\t\tfn: SubscriberHandler<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema\n\t\t>,\n\t): Subscriber<\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTSubscribedEvents\n\t> {\n\t\tconst subscriber = new Subscriber(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._subscribedEvents,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._publisher,\n\t\t\tthis._topicName,\n\t\t\tthis._constructs,\n\t\t);\n\n\t\t// No reset: `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base stays usable for the next subscriber.\n\t\treturn subscriber;\n\t}\n}\n","import { SubscriberBuilder } from './SubscriberBuilder';\n\nexport { Subscriber } from './Subscriber';\nexport { SubscriberBuilder };\n\nexport const s = new SubscriberBuilder();\n"],"mappings":";;;;;;AAmBA,IAAa,aAAb,cAQU,UAMR;CACD,oBAAoB;CAEpB,OAAO,aACNA,KACkD;AAClD,SAAO,QACN,OACC,IAAI,sBAAsB,QAC1B,IAAI,SAAS,cAAc,WAC5B;CACD;CAED,YACiBC,SAOSC,UAAkB,KACjCC,mBACeC,cACAC,WAAsB,CAAE,GACxBC,SAAkB,gBAClBC,kBAUTC,WAKhBC,aAAuB,CAAE,GACxB;AACD,QACC,cAAc,YACd,QACA,UACA,CAAE,GACF,kBACA,cACA,yBAGA,WACA;EAxCe;EAOS;EACf;EACe;EACA;EACA;EACA;EAUT;CAmBhB;CAED,IAAI,mBAAkD;AACrD,SAAO,KAAK;CACZ;AACD;;;;AC3ED,IAAa,oBAAb,MAOE;CACD,AAAQ,oBAAuC,CAAE;CACjD,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;;CAEjC,AAAO,cAAwB,CAAE;CACjC,AAAQ,UAAmB;CAC3B,AAAQ;CACR,AAAQ;CAER,cAAc;AACb,OAAK,WAAW;CAChB;;;;;;;;;;;;CAaD,MACCC,OAQC;AACD,SAAO,UAAU,MAAM,EACtB,YAAY,MAAM,KAClB,EAAC;CAQF;CAED,QAAQC,SAAuB;AAC9B,SAAO,UAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;CAED,OACCC,QAQC;AACD,SAAO,UAAU,MAAM,EACtB,cAAc,OACd,EAAC;CACF;;;;;;;;;;;;CAaD,UACCC,YAQC;EAQD,MAAM,WAAW,WAAW,WAAW;AAEvC,SAAO,UAAU,MAAM;GACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS;GAC3C,aAAa,MAAM,YAAY,KAAK,YAAY;EAChD,EAAC;CAQF;CAED,SACCC,UAQC;AACD,SAAO,UAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CACF;CAED,OACCC,QAQC;AACD,SAAO,UAAU,MAAM,EAAE,SAAS,OAA8B,EAAC;CACjE;CAED,UACCC,WAQC;AACD,SAAO,UAAU,MAAM,EAAE,YAAY,UAAkB,EAAC;CACxD;CAED,UAOCC,OAUC;EACD,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,KAAM;AAC1D,SAAO,UAAU,MAAM,EACtB,mBAAmB,CAAC,GAAG,KAAK,mBAAmB,GAAG,WAAY,EAC9D,EAAC;CACF;CAED,OACCC,IAcC;EACD,MAAM,aAAa,IAAI,WACtB,IACA,KAAK,UACL,KAAK,mBACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,YACL,KAAK;AAKN,SAAO;CACP;AACD;;;;ACnOD,MAAa,IAAI,IAAI"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscribers/index.ts"],"sourcesContent":["import { SubscriberBuilder } from './SubscriberBuilder';\n\nexport { Subscriber } from './Subscriber';\nexport { SubscriberBuilder };\n\nexport const s = new SubscriberBuilder();\n"],"mappings":";;;;;;AAKA,MAAa,IAAI,IAAI"}

package/dist/topic/index.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-DWy1uDak.cjs');
-const require_Construct = require('../Construct-roId57cU.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"));

package/dist/topic/index.d.cts

@@ -1,5 +1,5 @@
-import "../Construct-WhCXIOPV.cjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-Ohx9dvWr.cjs";
+import "../Construct-C0ijr2qp.cjs";
+import { Topic, TopicEvents, TopicMessage } from "../Topic-19QeHBIR.cjs";
 import { Logger } from "@geekmidas/logger";
 
 //#region src/topic/TopicBuilder.d.ts

package/dist/topic/index.d.mts

@@ -1,5 +1,5 @@
-import "../Construct-B-xc0SE9.mjs";
-import { Topic, TopicEvents, TopicMessage } from "../Topic-cmy2jOUy.mjs";
+import "../Construct-Ct8nalEi.mjs";
+import { Topic, TopicEvents, TopicMessage } from "../Topic-DuFeqkBh.mjs";
 import { Logger } from "@geekmidas/logger";
 
 //#region src/topic/TopicBuilder.d.ts

package/dist/topic/index.mjs

@@ -1,4 +1,4 @@
-import { Construct, ConstructType } from "../Construct-HmWM6YYu.mjs";
+import { Construct, ConstructType } from "../Construct-BD5neF7w.mjs";
 import { cloneWith } from "../clone-DblgEZZa.mjs";
 import { canonicalId, provideKey, serviceKey } from "@geekmidas/manifest";
 import { DEFAULT_LOGGER } from "@geekmidas/logger/console";

package/dist/worker.cjs

@@ -0,0 +1,91 @@
+const require_chunk = require('./chunk-DWy1uDak.cjs');
+const require_construct_interface = require('./construct-interface-BfjcOD_E.cjs');
+require('./Construct-CyS3RpTL.cjs');
+const require_functions = require('./functions-Bd3TPxid.cjs');
+require('./clone-Dy0cR2SZ.cjs');
+const require_surfaceEnv = require('./surfaceEnv-BFXEms2f.cjs');
+const require_CronBuilder = require('./CronBuilder-CkXPJiGO.cjs');
+const require_SubscriberBuilder = require('./SubscriberBuilder-4OPehf2R.cjs');
+const __geekmidas_manifest = require_chunk.__toESM(require("@geekmidas/manifest"));
+const __geekmidas_logger_console = require_chunk.__toESM(require("@geekmidas/logger/console"));
+
+//#region src/worker.ts
+var Worker = class Worker {
+	id;
+	/** Always defined — the worker's own, or the console logger. */
+	logger;
+	/** Always defined, and normally the default. */
+	envParser;
+	constructor(id, config = {}, dependencies = []) {
+		this.config = config;
+		this.dependencies = dependencies;
+		const canonical = (0, __geekmidas_manifest.canonicalId)(id);
+		this.id = canonical;
+		this.logger = config.logger ?? __geekmidas_logger_console.DEFAULT_LOGGER;
+		this.envParser = require_surfaceEnv.envParserFor(config.envParser ? {
+			id: canonical,
+			envParser: config.envParser
+		} : void 0);
+	}
+	/**
+	* This worker's cron factory, carrying its logger.
+	*
+	* `export const c = crons.logger(logger)` written once and hung off the
+	* thing that runs it, so a cron file opens with the schedule rather than
+	* with an import of a logger it has to know the path to.
+	*/
+	get crons() {
+		return this.own(new require_CronBuilder.CronBuilder().logger(this.logger));
+	}
+	/**
+	* This worker's subscriber factory, carrying its logger.
+	*
+	* Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed
+	* from the publisher's message union, so there is nothing to spell twice.
+	*/
+	get subscribers() {
+		return this.own(new require_SubscriberBuilder.SubscriberBuilder().logger(this.logger));
+	}
+	/** This worker's function factory, carrying its logger. */
+	get functions() {
+		return this.own(new require_functions.FunctionBuilder().logger(this.logger));
+	}
+	/**
+	* Sugar for the common case, the way `api.get()` is for `api.endpoints`.
+	*
+	* @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
+	*/
+	cron(schedule) {
+		return this.crons.schedule(schedule);
+	}
+	/**
+	* Resources and surfaces this worker calls.
+	*
+	* Not `.dependsOn()`: this records the edge that derives the worker's
+	* environment and its access, the same distinction `RestApi.calls()` draws.
+	*/
+	calls(constructs) {
+		return new Worker(this.id, this.config, [...this.dependencies, ...constructs.map(require_construct_interface.edgeTo)]);
+	}
+	/**
+	* Stamps this worker's id onto a builder, so everything built from it says
+	* which process runs it.
+	*/
+	own(builder) {
+		builder._owner = this.id;
+		return builder;
+	}
+	declare() {
+		return [{
+			kind: "worker",
+			id: this.id,
+			...this.config.app ? { app: this.config.app } : {},
+			...this.dependencies.length ? { dependencies: this.dependencies } : {},
+			provides: []
+		}];
+	}
+};
+
+//#endregion
+exports.Worker = Worker;
+//# sourceMappingURL=worker.cjs.map

package/dist/worker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.cjs","names":["id: ConstructName<TName>","config: WorkerConfig","dependencies: readonly Dependency[]","DEFAULT_LOGGER","CronBuilder","SubscriberBuilder","FunctionBuilder","schedule: ScheduleExpression","constructs: readonly Declarable[]","edgeTo","builder: T"],"sources":["../src/worker.ts"],"sourcesContent":["/**\n * A process with no port.\n *\n * `RestApi` is the process that answers HTTP. This is the one that does not —\n * the thing that runs a schedule, drains a queue, consumes a topic. Until it\n * existed, those had nowhere to say they belonged: a cron declared a schedule\n * and nothing else, and which container ran it was decided by the directory the\n * file sat in. A glob owned it.\n *\n * The cost of that shows up in the scaffolds. `gkm init --template worker` —\n * a project that is background jobs and nothing else — declared\n * `new RestApi('Api', { defaultAuthorizer: 'none', logger })`: an HTTP surface\n * with no HTTP on it, written because it was the only construct that made an\n * app exist and the only way to get a logger into the generated runtime.\n *\n * It takes no authorizer, and that is the tell that these are two constructs\n * rather than one with a flag: a `RestApi` needs one because an HTTP surface\n * can ship open by omission, and nothing reaches a worker from outside.\n *\n * @example\n * ```ts\n * // constructs/worker.ts\n * import { Worker } from '@geekmidas/constructs/worker';\n * import { logger } from './logger.js';\n *\n * export const worker = new Worker('Worker', { logger }).calls([database]);\n *\n * // crons/cleanup.ts\n * import { worker } from '@acme/constructs/worker.js';\n *\n * export const cleanup = worker\n *   .cron('rate(1 day)')\n *   .handle(async ({ logger }) => { … });\n * ```\n */\n\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype AppSpec,\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\ttype Dependency,\n} from '@geekmidas/manifest';\nimport { type Declarable, edgeTo } from './construct-interface';\nimport type { ScheduleExpression } from './crons/Cron';\nimport { CronBuilder } from './crons/CronBuilder';\nimport { envParserFor } from './endpoints/surfaceEnv';\nimport { FunctionBuilder } from './functions/FunctionBuilder';\nimport { SubscriberBuilder } from './subscribers/SubscriberBuilder';\n\nexport interface WorkerConfig {\n\t/**\n\t * Where its source lives and how it is run.\n\t *\n\t * Normally omitted, like every other app's: `Worker` means `apps/worker`\n\t * where that directory exists and the project root otherwise. Write one only\n\t * for a layout that genuinely differs.\n\t */\n\tapp?: AppSpec;\n\t/**\n\t * The logger everything built from this worker runs with.\n\t *\n\t * The actual logger, not a path to one — the same reason `RestApi` takes\n\t * one. Every cron and subscriber in a scaffolded project used to open with\n\t * `import { logger } from '…/constructs/logger.js'`, which is the line this\n\t * removes.\n\t */\n\tlogger?: Logger;\n\t/**\n\t * The environment parser everything built from this worker runs with.\n\t *\n\t * Defaults to `process.env` merged with the credentials `gkm dev` injected,\n\t * which is what an application's own `config/env.ts` always was.\n\t */\n\tenvParser?: EnvironmentParser<{}>;\n}\n\nexport class Worker<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\n\t/** Always defined — the worker's own, or the console logger. */\n\treadonly logger: Logger;\n\n\t/** Always defined, and normally the default. */\n\treadonly envParser: EnvironmentParser<{}>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly config: WorkerConfig = {},\n\t\t/** Internal: how `.calls()` carries edges into the copy it returns. */\n\t\tprivate readonly dependencies: readonly Dependency[] = [],\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.logger = config.logger ?? DEFAULT_LOGGER;\n\t\tthis.envParser = envParserFor(\n\t\t\tconfig.envParser\n\t\t\t\t? { id: canonical, envParser: config.envParser }\n\t\t\t\t: undefined,\n\t\t);\n\t}\n\n\t/**\n\t * This worker's cron factory, carrying its logger.\n\t *\n\t * `export const c = crons.logger(logger)` written once and hung off the\n\t * thing that runs it, so a cron file opens with the schedule rather than\n\t * with an import of a logger it has to know the path to.\n\t */\n\tget crons() {\n\t\treturn this.own(new CronBuilder().logger(this.logger));\n\t}\n\n\t/**\n\t * This worker's subscriber factory, carrying its logger.\n\t *\n\t * Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed\n\t * from the publisher's message union, so there is nothing to spell twice.\n\t */\n\tget subscribers() {\n\t\treturn this.own(new SubscriberBuilder().logger(this.logger));\n\t}\n\n\t/** This worker's function factory, carrying its logger. */\n\tget functions() {\n\t\treturn this.own(new FunctionBuilder().logger(this.logger));\n\t}\n\n\t/**\n\t * Sugar for the common case, the way `api.get()` is for `api.endpoints`.\n\t *\n\t * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`\n\t */\n\tcron(schedule: ScheduleExpression) {\n\t\treturn this.crons.schedule(schedule);\n\t}\n\n\t/**\n\t * Resources and surfaces this worker calls.\n\t *\n\t * Not `.dependsOn()`: this records the edge that derives the worker's\n\t * environment and its access, the same distinction `RestApi.calls()` draws.\n\t */\n\tcalls(constructs: readonly Declarable[]): Worker<TName> {\n\t\treturn new Worker<TName>(this.id as ConstructName<TName>, this.config, [\n\t\t\t...this.dependencies,\n\t\t\t...constructs.map(edgeTo),\n\t\t]);\n\t}\n\n\t/**\n\t * Stamps this worker's id onto a builder, so everything built from it says\n\t * which process runs it.\n\t */\n\tprivate own<T extends { _owner?: string }>(builder: T): T {\n\t\tbuilder._owner = this.id;\n\n\t\treturn builder;\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'worker',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.config.app ? { app: this.config.app } : {}),\n\t\t\t\t...(this.dependencies.length\n\t\t\t\t\t? { dependencies: this.dependencies }\n\t\t\t\t\t: {}),\n\t\t\t\t// Nothing calls a worker, so it publishes no address.\n\t\t\t\tprovides: [],\n\t\t\t},\n\t\t];\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAgFA,IAAa,SAAb,MAAa,OAEb;CACC,AAAS;;CAGT,AAAS;;CAGT,AAAS;CAET,YACCA,IACiBC,SAAuB,CAAE,GAEzBC,eAAsC,CAAE,GACxD;EAHgB;EAEA;EAEjB,MAAM,YAAY,sCAAY,GAAa;AAE3C,OAAK,KAAK;AACV,OAAK,SAAS,OAAO,UAAUC;AAC/B,OAAK,YAAY,gCAChB,OAAO,YACJ;GAAE,IAAI;GAAW,WAAW,OAAO;EAAW,WAEjD;CACD;;;;;;;;CASD,IAAI,QAAQ;AACX,SAAO,KAAK,IAAI,IAAIC,kCAAc,OAAO,KAAK,OAAO,CAAC;CACtD;;;;;;;CAQD,IAAI,cAAc;AACjB,SAAO,KAAK,IAAI,IAAIC,8CAAoB,OAAO,KAAK,OAAO,CAAC;CAC5D;;CAGD,IAAI,YAAY;AACf,SAAO,KAAK,IAAI,IAAIC,oCAAkB,OAAO,KAAK,OAAO,CAAC;CAC1D;;;;;;CAOD,KAAKC,UAA8B;AAClC,SAAO,KAAK,MAAM,SAAS,SAAS;CACpC;;;;;;;CAQD,MAAMC,YAAkD;AACvD,SAAO,IAAI,OAAc,KAAK,IAA4B,KAAK,QAAQ,CACtE,GAAG,KAAK,cACR,GAAG,WAAW,IAAIC,mCAAO,AACzB;CACD;;;;;CAMD,AAAQ,IAAmCC,SAAe;AACzD,UAAQ,SAAS,KAAK;AAEtB,SAAO;CACP;CAED,UAAyB;AACxB,SAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,OAAO,MAAM,EAAE,KAAK,KAAK,OAAO,IAAK,IAAG,CAAE;GACnD,GAAI,KAAK,aAAa,SACnB,EAAE,cAAc,KAAK,aAAc,IACnC,CAAE;GAEL,UAAU,CAAE;EACZ,CACD;CACD;AACD"}

package/dist/worker.d.cts

@@ -0,0 +1,95 @@
+import "./Construct-C0ijr2qp.cjs";
+import { FunctionBuilder } from "./index-JSf9xNIJ.cjs";
+import { Declarable } from "./construct-interface-D9d4Gm4p.cjs";
+import { ScheduleExpression } from "./Cron-Wqh464aO.cjs";
+import "./Subscriber-2mEi0ImH.cjs";
+import { CronBuilder } from "./CronBuilder-BqpEzMPQ.cjs";
+import "./Topic-19QeHBIR.cjs";
+import { SubscriberBuilder } from "./SubscriberBuilder-waNhzjSM.cjs";
+import { EnvironmentParser } from "@geekmidas/envkit";
+import { Logger } from "@geekmidas/logger";
+import * as _geekmidas_schema12 from "@geekmidas/schema";
+import * as _geekmidas_services13 from "@geekmidas/services";
+import * as _geekmidas_audit15 from "@geekmidas/audit";
+import { AppSpec, ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
+
+//#region src/worker.d.ts
+
+interface WorkerConfig {
+  /**
+   * Where its source lives and how it is run.
+   *
+   * Normally omitted, like every other app's: `Worker` means `apps/worker`
+   * where that directory exists and the project root otherwise. Write one only
+   * for a layout that genuinely differs.
+   */
+  app?: AppSpec;
+  /**
+   * The logger everything built from this worker runs with.
+   *
+   * The actual logger, not a path to one — the same reason `RestApi` takes
+   * one. Every cron and subscriber in a scaffolded project used to open with
+   * `import { logger } from '…/constructs/logger.js'`, which is the line this
+   * removes.
+   */
+  logger?: Logger;
+  /**
+   * The environment parser everything built from this worker runs with.
+   *
+   * Defaults to `process.env` merged with the credentials `gkm dev` injected,
+   * which is what an application's own `config/env.ts` always was.
+   */
+  envParser?: EnvironmentParser<{}>;
+}
+declare class Worker<TName extends string = string> implements Declarable<TName> {
+  private readonly config;
+  /** Internal: how `.calls()` carries edges into the copy it returns. */
+  private readonly dependencies;
+  readonly id: TName;
+  /** Always defined — the worker's own, or the console logger. */
+  readonly logger: Logger;
+  /** Always defined, and normally the default. */
+  readonly envParser: EnvironmentParser<{}>;
+  constructor(id: ConstructName<TName>, config?: WorkerConfig, /** Internal: how `.calls()` carries edges into the copy it returns. */
+  dependencies?: readonly Dependency[]);
+  /**
+   * This worker's cron factory, carrying its logger.
+   *
+   * `export const c = crons.logger(logger)` written once and hung off the
+   * thing that runs it, so a cron file opens with the schedule rather than
+   * with an import of a logger it has to know the path to.
+   */
+  get crons(): CronBuilder<_geekmidas_schema12.ComposableStandardSchema, _geekmidas_services13.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  /**
+   * This worker's subscriber factory, carrying its logger.
+   *
+   * Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed
+   * from the publisher's message union, so there is nothing to spell twice.
+   */
+  get subscribers(): SubscriberBuilder<[], Logger, undefined, undefined, string, []>;
+  /** This worker's function factory, carrying its logger. */
+  get functions(): FunctionBuilder<_geekmidas_schema12.ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, _geekmidas_audit15.AuditableAction<string, unknown>>;
+  /**
+   * Sugar for the common case, the way `api.get()` is for `api.endpoints`.
+   *
+   * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
+   */
+  cron(schedule: ScheduleExpression): CronBuilder<_geekmidas_schema12.ComposableStandardSchema, _geekmidas_services13.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  /**
+   * Resources and surfaces this worker calls.
+   *
+   * Not `.dependsOn()`: this records the edge that derives the worker's
+   * environment and its access, the same distinction `RestApi.calls()` draws.
+   */
+  calls(constructs: readonly Declarable[]): Worker<TName>;
+  /**
+   * Stamps this worker's id onto a builder, so everything built from it says
+   * which process runs it.
+   */
+  private own;
+  declare(): Declaration[];
+}
+//# sourceMappingURL=worker.d.ts.map
+//#endregion
+export { Worker, WorkerConfig };
+//# sourceMappingURL=worker.d.cts.map

package/dist/worker.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.cts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AA2IkC,UAtFjB,YAAA,CAsFiB;EAAA;;;;;;;EA2BX,GArFX,CAAA,EApBL,OAoBK;EAAU;;;;;;;;WAXZ;;;;;;;cAOG;;cAGA,iDACD,WAAW;;;;eAET;;mBAGI;;sBAGG;kBAGf,cAAc,iBACO;0BAEe;;;;;;;;eAoBhC,YApB0C,mBAAA,CAoB1C,wBAAA,EAAA,qBAAA,CAAA,4BAAA;;;;;;;qBAUM,sBAAA;;mBAKF,gBALE,mBAAA,CAKF,wBAAA,iBAAA,iEAAA,kBAAA,CAAA;;;;;;iBASE,qBAAkB,YAAA,mBAAA,CAAA,wBAAA,EAAA,qBAAA,CAAA,4BAAA;;;;;;;6BAUN,eAAe,OAAO;;;;;;aAiBtC"}

package/dist/worker.d.mts

@@ -0,0 +1,95 @@
+import "./Construct-Ct8nalEi.mjs";
+import { FunctionBuilder } from "./index-CubPzHd9.mjs";
+import { Declarable } from "./construct-interface-g5GM5pwR.mjs";
+import { ScheduleExpression } from "./Cron-ByxdOfpE.mjs";
+import "./Subscriber-xTJ9ayPN.mjs";
+import { CronBuilder } from "./CronBuilder-BL0AP6fs.mjs";
+import "./Topic-DuFeqkBh.mjs";
+import { SubscriberBuilder } from "./SubscriberBuilder-Dptmo-1A.mjs";
+import { AppSpec, ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
+import { EnvironmentParser } from "@geekmidas/envkit";
+import * as _geekmidas_services13 from "@geekmidas/services";
+import * as _geekmidas_audit15 from "@geekmidas/audit";
+import { Logger } from "@geekmidas/logger";
+import * as _geekmidas_schema12 from "@geekmidas/schema";
+
+//#region src/worker.d.ts
+
+interface WorkerConfig {
+  /**
+   * Where its source lives and how it is run.
+   *
+   * Normally omitted, like every other app's: `Worker` means `apps/worker`
+   * where that directory exists and the project root otherwise. Write one only
+   * for a layout that genuinely differs.
+   */
+  app?: AppSpec;
+  /**
+   * The logger everything built from this worker runs with.
+   *
+   * The actual logger, not a path to one — the same reason `RestApi` takes
+   * one. Every cron and subscriber in a scaffolded project used to open with
+   * `import { logger } from '…/constructs/logger.js'`, which is the line this
+   * removes.
+   */
+  logger?: Logger;
+  /**
+   * The environment parser everything built from this worker runs with.
+   *
+   * Defaults to `process.env` merged with the credentials `gkm dev` injected,
+   * which is what an application's own `config/env.ts` always was.
+   */
+  envParser?: EnvironmentParser<{}>;
+}
+declare class Worker<TName extends string = string> implements Declarable<TName> {
+  private readonly config;
+  /** Internal: how `.calls()` carries edges into the copy it returns. */
+  private readonly dependencies;
+  readonly id: TName;
+  /** Always defined — the worker's own, or the console logger. */
+  readonly logger: Logger;
+  /** Always defined, and normally the default. */
+  readonly envParser: EnvironmentParser<{}>;
+  constructor(id: ConstructName<TName>, config?: WorkerConfig, /** Internal: how `.calls()` carries edges into the copy it returns. */
+  dependencies?: readonly Dependency[]);
+  /**
+   * This worker's cron factory, carrying its logger.
+   *
+   * `export const c = crons.logger(logger)` written once and hung off the
+   * thing that runs it, so a cron file opens with the schedule rather than
+   * with an import of a logger it has to know the path to.
+   */
+  get crons(): CronBuilder<_geekmidas_schema12.ComposableStandardSchema, _geekmidas_services13.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  /**
+   * This worker's subscriber factory, carrying its logger.
+   *
+   * Chain `.publisher(…)` before `.subscribe([…])`: the event names are typed
+   * from the publisher's message union, so there is nothing to spell twice.
+   */
+  get subscribers(): SubscriberBuilder<[], Logger, undefined, undefined, string, []>;
+  /** This worker's function factory, carrying its logger. */
+  get functions(): FunctionBuilder<_geekmidas_schema12.ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, _geekmidas_audit15.AuditableAction<string, unknown>>;
+  /**
+   * Sugar for the common case, the way `api.get()` is for `api.endpoints`.
+   *
+   * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
+   */
+  cron(schedule: ScheduleExpression): CronBuilder<_geekmidas_schema12.ComposableStandardSchema, _geekmidas_services13.Service<string, unknown>[], Logger, undefined, undefined, string, undefined, string>;
+  /**
+   * Resources and surfaces this worker calls.
+   *
+   * Not `.dependsOn()`: this records the edge that derives the worker's
+   * environment and its access, the same distinction `RestApi.calls()` draws.
+   */
+  calls(constructs: readonly Declarable[]): Worker<TName>;
+  /**
+   * Stamps this worker's id onto a builder, so everything built from it says
+   * which process runs it.
+   */
+  private own;
+  declare(): Declaration[];
+}
+//# sourceMappingURL=worker.d.ts.map
+//#endregion
+export { Worker, WorkerConfig };
+//# sourceMappingURL=worker.d.mts.map