@geekmidas/constructs 3.0.7 → 3.0.9

package/dist/subscribers/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["SubscriberBuilder"],"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,IAAIA"}
+{"version":3,"file":"index.cjs","names":["DEFAULT_LOGGER","ConsoleLogger","Construct","obj: any","ConstructType","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>","DEFAULT_LOGGER","timeout: number","schema: 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 { ConsoleLogger } 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\nconst DEFAULT_LOGGER = new ConsoleLogger() as any;\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) {\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);\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 { 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\tprivate _logger: TLogger = DEFAULT_LOGGER;\n\tprivate _publisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\n\tconstructor() {\n\t\tthis._timeout = 30000; // Default timeout\n\t}\n\n\ttimeout(timeout: number): this {\n\t\tthis._timeout = timeout;\n\t\treturn this;\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\tthis.outputSchema = schema as unknown as OutSchema;\n\t\treturn this as any;\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\tthis._services = [...this._services, ...services] as any;\n\t\treturn this 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\tthis._logger = logger as unknown as TLogger;\n\t\treturn this 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\tthis._publisher = publisher as any;\n\t\treturn this 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\tthis._subscribedEvents = [...this._subscribedEvents, ...eventsToAdd] as any;\n\t\treturn this 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);\n\n\t\t// Reset builder state after creating the subscriber to prevent pollution\n\t\tthis._services = [] as Service[] as TServices;\n\t\tthis._logger = DEFAULT_LOGGER;\n\t\tthis._publisher = undefined;\n\t\tthis._subscribedEvents = [] as any;\n\t\tthis._timeout = 30000; // Reset to default\n\t\tthis.outputSchema = undefined;\n\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":";;;;AAWA,MAAMA,mBAAiB,IAAIC;AAU3B,IAAa,aAAb,cAQUC,4BAMR;CACD,oBAAoB;CAEpB,OAAO,aACNC,KACkD;AAClD,SAAO,QACN,OACC,IAAI,sBAAsB,QAC1B,IAAI,SAASC,gCAAc,WAC5B;CACD;CAED,YACiBC,SAOSC,UAAkB,KACjCC,mBACeC,cACAC,WAAsB,CAAE,GACxBC,SAAkBV,kBAClBW,kBAIxB;AACD,QACCP,gCAAc,YACd,QACA,UACA,CAAE,GACF,kBACA,aACA;EAxBe;EAOS;EACf;EACe;EACA;EACA;EACA;CAazB;CAED,IAAI,mBAAkD;AACrD,SAAO,KAAK;CACZ;AACD;;;;ACrED,IAAa,oBAAb,MAOE;CACD,AAAQ,oBAAuC,CAAE;CACjD,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmBQ;CAC3B,AAAQ;CAER,cAAc;AACb,OAAK,WAAW;CAChB;CAED,QAAQC,SAAuB;AAC9B,OAAK,WAAW;AAChB,SAAO;CACP;CAED,OACCC,QAQC;AACD,OAAK,eAAe;AACpB,SAAO;CACP;CAED,SACCC,UAQC;AACD,OAAK,YAAY,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS;AACjD,SAAO;CACP;CAED,OACCC,QAQC;AACD,OAAK,UAAU;AACf,SAAO;CACP;CAED,UACCC,WAQC;AACD,OAAK,aAAa;AAClB,SAAO;CACP;CAED,UAOCC,OAUC;EACD,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,KAAM;AAC1D,OAAK,oBAAoB,CAAC,GAAG,KAAK,mBAAmB,GAAG,WAAY;AACpE,SAAO;CACP;CAED,OACCC,IAcC;EACD,MAAM,aAAa,IAAI,WACtB,IACA,KAAK,UACL,KAAK,mBACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK;AAIN,OAAK,YAAY,CAAE;AACnB,OAAK,UAAUP;AACf,OAAK;AACL,OAAK,oBAAoB,CAAE;AAC3B,OAAK,WAAW;AAChB,OAAK;AAEL,SAAO;CACP;AACD;;;;AChJD,MAAa,IAAI,IAAI"}

package/dist/subscribers/index.d.cts

@@ -1,10 +1,32 @@
-import "../Construct-CX7HyFfT.cjs";
-import { Subscriber } from "../Subscriber-1rDE7HuM.cjs";
-import { SubscriberBuilder } from "../SubscriberBuilder-Be7WBbCL.cjs";
-import * as _geekmidas_logger10 from "@geekmidas/logger";
+import "../Construct-CXqvzglu.cjs";
+import { Subscriber, SubscriberHandler } from "../Subscriber-D8WkA8np.cjs";
+import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import * as _geekmidas_logger8 from "@geekmidas/logger";
+import { Logger } from "@geekmidas/logger";
+import { Service } from "@geekmidas/services";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
+//#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;
+  private _logger;
+  private _publisher?;
+  constructor();
+  timeout(timeout: number): this;
+  output<T extends StandardSchemaV1>(schema: T): SubscriberBuilder<TServices, TLogger, T, 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_logger10.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger8.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/index.ts"],"sourcesContent":[],"mappings":";;;;;;cAKa,GAAC,sBAA0B,mBAAA,CAA1B,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAUa,oCACM,gCACF,SAAS,0BACP,kEACM;;;;EAJZ,QAAA,SAAA;EAAiB,QAAA,OAAA;EAAA,QACX,UAAA;EAAO,WACT,CAAA;EAAM,OAAG,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAM,MACb,CAAA,UAqBD,gBArBC,CAAA,CAAA,MAAA,EAsBT,CAtBS,CAAA,EAuBf,iBAvBe,CAwBjB,SAxBiB,EAyBjB,OAzBiB,EA0BjB,CA1BiB,EA2BjB,eA3BiB,EA4BjB,0BA5BiB,EA6BjB,iBA7BiB,CAAA;EAAgB,QACV,CAAA,UAkCL,OAlCK,EAAA,CAAA,CAAA,QAAA,EAmCb,CAnCa,CAAA,EAoCrB,iBApCqB,CAAA,CAoBP,GAiBZ,SAjBY,EACR,GAgBU,CAhBV,CAAC,EAiBT,OAfA,EAgBA,SAhBA,EAiBA,eAjBA,EAkBA,0BAlBA,EAmBA,iBAnBA,CAAA;EAAS,MACT,CAAA,UAwBgB,MAxBhB,CAAA,CAAA,MAAA,EAyBQ,CAzBR,CAAA,EA0BE,iBA1BF,CA2BA,SA3BA,EA4BA,CA5BA,EA6BA,SA7BA,EA8BA,eA9BA,EA+BA,0BA/BA,EAgCA,iBAhCA,CAAA;EAAO,SACP,CAAA,UAqCmB,cArCnB,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAsCW,OAtCX,CAsCmB,KAtCnB,EAsC0B,CAtC1B,CAAA,CAAA,EAuCE,iBAvCF,CAwCA,SAxCA,EAyCA,OAzCA,EA0CA,SA1CA,EA2CA,CA3CA,EA4CA,KA5CA,EA6CA,iBA7CA,CAAA;EAAC,SACD,CAAA,gBAmDe,eAnDf,SAmDuC,cAnDvC,CAAA,GAAA,CAAA,GAqDK,uBArDL,CAqD6B,eArD7B,CAAA,CAAA,MAAA,CAAA,GAsDK,uBAtDL,CAsD6B,eAtD7B,CAAA,CAAA,MAAA,CAAA,EAAA,GAAA,KAAA,EAAA,CAAA,KAAA,EAyDO,MAzDP,CAAA,EA0DE,iBA1DF,CA2DA,SA3DA,EA4DA,OA5DA,EA6DA,SA7DA,EA8DA,eA9DA,EA+DA,0BA/DA,EAgEA,MAhEA,SAAA,GAAA,EAAA,GAAA,CAAA,GAiEO,iBAjEP,EAAA,GAiE6B,MAjE7B,CAAA,GAAA,CAAA,GAkEO,iBAlEP,EAkE0B,MAlE1B,CAAA,CAAA;EAAe,MACf,CAAA,EAAA,EAyEI,iBAzEJ,CA0EC,eA1ED,EA2EC,iBA3ED,EA4EC,SA5ED,EA6EC,OA7ED,EA8EC,SA9ED,CAAA,CAAA,EAgFE,UAhFF,CAiFA,SAjFA,EAkFA,OAlFA,EAmFA,SAnFA,EAoFA,eApFA,EAqFA,0BArFA,EAsFA,iBAtFA,CAAA;;;;;cCpCW,GAAC,sBAA0B,kBAAA,CAA1B,MAAA"}

package/dist/subscribers/index.d.mts

@@ -1,10 +1,31 @@
-import "../Construct-BjpXFNxy.mjs";
-import { Subscriber } from "../Subscriber-9ObcUdcC.mjs";
-import { SubscriberBuilder } from "../SubscriberBuilder-DsfIkgTF.mjs";
-import * as _geekmidas_logger10 from "@geekmidas/logger";
+import "../Construct-D0n7QTaI.mjs";
+import { Subscriber, SubscriberHandler } from "../Subscriber-Tft61-YG.mjs";
+import { Service } from "@geekmidas/services";
+import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import { Logger as Logger$1 } from "@geekmidas/logger";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
+//#region src/subscribers/SubscriberBuilder.d.ts
+declare class SubscriberBuilder<TServices extends Service[] = [], TLogger extends Logger$1 = Logger$1, 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;
+  private _logger;
+  private _publisher?;
+  constructor();
+  timeout(timeout: number): this;
+  output<T extends StandardSchemaV1>(schema: T): SubscriberBuilder<TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
+  services<T extends Service[]>(services: T): SubscriberBuilder<[...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>;
+  logger<T extends Logger$1>(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_logger10.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], 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/index.ts"],"sourcesContent":[],"mappings":";;;;;;cAKa,GAAC,sBAA0B,mBAAA,CAA1B,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/SubscriberBuilder.ts","../../src/subscribers/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAUa,oCACM,gCACF,WAAS,4BACP,kEACM;;;EAJZ,QAAA,YAAiB;EAAA,QAAA,SAAA;EAAA,QACX,OAAA;EAAO,QACT,UAAA;EAAM,WAAG,CAAA;EAAM,OACb,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAgB,MACV,CAAA,UAoBP,gBApBO,CAAA,CAAA,MAAA,EAqBf,CArBe,CAAA,EAsBrB,iBAtBqB,CAuBvB,SAvBuB,EAwBvB,OAxBuB,EAyBvB,CAzBuB,EA0BvB,eA1BuB,EA2BvB,0BA3BuB,EA4BvB,iBA5BuB,CAAA;EAAc,QAoBrB,CAAA,UAcE,OAdF,EAAA,CAAA,CAAA,QAAA,EAeN,CAfM,CAAA,EAgBd,iBAhBc,CAAA,CACR,GAgBJ,SAhBI,EAER,GAckB,CAdlB,CAAS,EAeT,OAdA,EAeA,SAfA,EAgBA,eAhBA,EAiBA,0BAjBA,EAkBA,iBAlBA,CAAA;EAAO,MACP,CAAA,UAuBgB,QAvBhB,CAAA,CAAA,MAAA,EAwBQ,CAxBR,CAAA,EAyBE,iBAzBF,CA0BA,SA1BA,EA2BA,CA3BA,EA4BA,SA5BA,EA6BA,eA7BA,EA8BA,0BA9BA,EA+BA,iBA/BA,CAAA;EAAC,SACD,CAAA,UAoCmB,cApCnB,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAqCW,OArCX,CAqCmB,KArCnB,EAqC0B,CArC1B,CAAA,CAAA,EAsCE,iBAtCF,CAuCA,SAvCA,EAwCA,OAxCA,EAyCA,SAzCA,EA0CA,CA1CA,EA2CA,KA3CA,EA4CA,iBA5CA,CAAA;EAAe,SACf,CAAA,gBAkDe,eAlDf,SAkDuC,cAlDvC,CAAA,GAAA,CAAA,GAoDK,uBApDL,CAoD6B,eApD7B,CAAA,CAAA,MAAA,CAAA,GAqDK,uBArDL,CAqD6B,eArD7B,CAAA,CAAA,MAAA,CAAA,EAAA,GAAA,KAAA,EAAA,CAAA,KAAA,EAwDO,MAxDP,CAAA,EAyDE,iBAzDF,CA0DA,SA1DA,EA2DA,OA3DA,EA4DA,SA5DA,EA6DA,eA7DA,EA8DA,0BA9DA,EA+DA,MA/DA,SAAA,GAAA,EAAA,GAAA,CAAA,GAgEO,iBAhEP,EAAA,GAgE6B,MAhE7B,CAAA,GAAA,CAAA,GAiEO,iBAjEP,EAiE0B,MAjE1B,CAAA,CAAA;EAA0B,MAC1B,CAAA,EAAA,EAwEI,iBAxEJ,CAyEC,eAzED,EA0EC,iBA1ED,EA2EC,SA3ED,EA4EC,OA5ED,EA6EC,SA7ED,CAAA,CAAA,EA+EE,UA/EF,CAgFA,SAhFA,EAiFA,OAjFA,EAkFA,SAlFA,EAmFA,eAnFA,EAoFA,0BApFA,EAqFA,iBArFA,CAAA;;;;;cCrCW,GAAC,sBAAA"}

package/dist/subscribers/index.mjs

@@ -1,7 +1,78 @@
-import "../Construct-CQ9zV58W.mjs";
-import { Subscriber } from "../Subscriber-BH76wgkL.mjs";
-import { SubscriberBuilder } from "../SubscriberBuilder-B4md5wzs.mjs";
+import { Construct, ConstructType } from "../Construct-CdJY2DJS.mjs";
+import { ConsoleLogger, DEFAULT_LOGGER } from "@geekmidas/logger/console";
 
+//#region src/subscribers/Subscriber.ts
+const DEFAULT_LOGGER$1 = new ConsoleLogger();
+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$1, publisherService) {
+		super(ConstructType.Subscriber, logger, services, [], publisherService, outputSchema);
+		this.handler = handler;
+		this.timeout = timeout;
+		this._subscribedEvents = _subscribedEvents;
+		this.outputSchema = outputSchema;
+		this.services = services;
+		this.logger = logger;
+		this.publisherService = publisherService;
+	}
+	get subscribedEvents() {
+		return this._subscribedEvents;
+	}
+};
+
+//#endregion
+//#region src/subscribers/SubscriberBuilder.ts
+var SubscriberBuilder = class {
+	_subscribedEvents = [];
+	_timeout;
+	outputSchema;
+	_services = [];
+	_logger = DEFAULT_LOGGER;
+	_publisher;
+	constructor() {
+		this._timeout = 3e4;
+	}
+	timeout(timeout) {
+		this._timeout = timeout;
+		return this;
+	}
+	output(schema) {
+		this.outputSchema = schema;
+		return this;
+	}
+	services(services) {
+		this._services = [...this._services, ...services];
+		return this;
+	}
+	logger(logger) {
+		this._logger = logger;
+		return this;
+	}
+	publisher(publisher) {
+		this._publisher = publisher;
+		return this;
+	}
+	subscribe(event) {
+		const eventsToAdd = Array.isArray(event) ? event : [event];
+		this._subscribedEvents = [...this._subscribedEvents, ...eventsToAdd];
+		return this;
+	}
+	handle(fn) {
+		const subscriber = new Subscriber(fn, this._timeout, this._subscribedEvents, this.outputSchema, this._services, this._logger, this._publisher);
+		this._services = [];
+		this._logger = DEFAULT_LOGGER;
+		this._publisher = void 0;
+		this._subscribedEvents = [];
+		this._timeout = 3e4;
+		this.outputSchema = void 0;
+		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":[],"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"}
+{"version":3,"file":"index.mjs","names":["DEFAULT_LOGGER","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>","timeout: number","schema: 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 { ConsoleLogger } 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\nconst DEFAULT_LOGGER = new ConsoleLogger() as any;\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) {\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);\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 { 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\tprivate _logger: TLogger = DEFAULT_LOGGER;\n\tprivate _publisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\n\tconstructor() {\n\t\tthis._timeout = 30000; // Default timeout\n\t}\n\n\ttimeout(timeout: number): this {\n\t\tthis._timeout = timeout;\n\t\treturn this;\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\tthis.outputSchema = schema as unknown as OutSchema;\n\t\treturn this as any;\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\tthis._services = [...this._services, ...services] as any;\n\t\treturn this 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\tthis._logger = logger as unknown as TLogger;\n\t\treturn this 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\tthis._publisher = publisher as any;\n\t\treturn this 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\tthis._subscribedEvents = [...this._subscribedEvents, ...eventsToAdd] as any;\n\t\treturn this 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);\n\n\t\t// Reset builder state after creating the subscriber to prevent pollution\n\t\tthis._services = [] as Service[] as TServices;\n\t\tthis._logger = DEFAULT_LOGGER;\n\t\tthis._publisher = undefined;\n\t\tthis._subscribedEvents = [] as any;\n\t\tthis._timeout = 30000; // Reset to default\n\t\tthis.outputSchema = undefined;\n\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":";;;;AAWA,MAAMA,mBAAiB,IAAI;AAU3B,IAAa,aAAb,cAQU,UAMR;CACD,oBAAoB;CAEpB,OAAO,aACNC,KACkD;AAClD,SAAO,QACN,OACC,IAAI,sBAAsB,QAC1B,IAAI,SAAS,cAAc,WAC5B;CACD;CAED,YACiBC,SAOSC,UAAkB,KACjCC,mBACeC,cACAC,WAAsB,CAAE,GACxBC,SAAkBP,kBAClBQ,kBAIxB;AACD,QACC,cAAc,YACd,QACA,UACA,CAAE,GACF,kBACA,aACA;EAxBe;EAOS;EACf;EACe;EACA;EACA;EACA;CAazB;CAED,IAAI,mBAAkD;AACrD,SAAO,KAAK;CACZ;AACD;;;;ACrED,IAAa,oBAAb,MAOE;CACD,AAAQ,oBAAuC,CAAE;CACjD,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmB;CAC3B,AAAQ;CAER,cAAc;AACb,OAAK,WAAW;CAChB;CAED,QAAQC,SAAuB;AAC9B,OAAK,WAAW;AAChB,SAAO;CACP;CAED,OACCC,QAQC;AACD,OAAK,eAAe;AACpB,SAAO;CACP;CAED,SACCC,UAQC;AACD,OAAK,YAAY,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS;AACjD,SAAO;CACP;CAED,OACCC,QAQC;AACD,OAAK,UAAU;AACf,SAAO;CACP;CAED,UACCC,WAQC;AACD,OAAK,aAAa;AAClB,SAAO;CACP;CAED,UAOCC,OAUC;EACD,MAAM,cAAc,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,KAAM;AAC1D,OAAK,oBAAoB,CAAC,GAAG,KAAK,mBAAmB,GAAG,WAAY;AACpE,SAAO;CACP;CAED,OACCC,IAcC;EACD,MAAM,aAAa,IAAI,WACtB,IACA,KAAK,UACL,KAAK,mBACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK;AAIN,OAAK,YAAY,CAAE;AACnB,OAAK,UAAU;AACf,OAAK;AACL,OAAK,oBAAoB,CAAE;AAC3B,OAAK,WAAW;AAChB,OAAK;AAEL,SAAO;CACP;AACD;;;;AChJD,MAAa,IAAI,IAAI"}

package/dist/{telemetry-BTaiRqPo.d.cts → telemetry-Bt0vK4ma.d.cts}

@@ -92,4 +92,4 @@ interface Telemetry {
 //# sourceMappingURL=telemetry.d.ts.map
 //#endregion
 export { Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
-//# sourceMappingURL=telemetry-BTaiRqPo.d.cts.map
+//# sourceMappingURL=telemetry-Bt0vK4ma.d.cts.map

package/dist/{telemetry-BJo1gcV1.d.mts.map → telemetry-Bt0vK4ma.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"telemetry-BJo1gcV1.d.mts","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6FmB,UAlFF,gBAAA,CAkFE;EAAgB;;;EAQgB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;UAhFlC,gBAAA;;;;;;;;WASP;;;;;UAMO,iBAAA;;;;;;;;;;;;YAcN;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM,SAAA;;;;;;;0BAOQ,mBAAmB;;;;;;;oBAQzB,4BAA4B;;;;;;;sBAQ1B,yBAAyB"}
+{"version":3,"file":"telemetry-Bt0vK4ma.d.cts","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6FmB,UAlFF,gBAAA,CAkFE;EAAgB;;;EAQgB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;UAhFlC,gBAAA;;;;;;;;WASP;;;;;UAMO,iBAAA;;;;;;;;;;;;YAcN;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM,SAAA;;;;;;;0BAOQ,mBAAmB;;;;;;;oBAQzB,4BAA4B;;;;;;;sBAQ1B,yBAAyB"}

package/dist/{telemetry-BJo1gcV1.d.mts → telemetry-COvVBKBM.d.mts}

@@ -92,4 +92,4 @@ interface Telemetry {
 //# sourceMappingURL=telemetry.d.ts.map
 //#endregion
 export { Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
-//# sourceMappingURL=telemetry-BJo1gcV1.d.mts.map
+//# sourceMappingURL=telemetry-COvVBKBM.d.mts.map

package/dist/{telemetry-BTaiRqPo.d.cts.map → telemetry-COvVBKBM.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"telemetry-BTaiRqPo.d.cts","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6FmB,UAlFF,gBAAA,CAkFE;EAAgB;;;EAQgB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;UAhFlC,gBAAA;;;;;;;;WASP;;;;;UAMO,iBAAA;;;;;;;;;;;;YAcN;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM,SAAA;;;;;;;0BAOQ,mBAAmB;;;;;;;oBAQzB,4BAA4B;;;;;;;sBAQ1B,yBAAyB"}
+{"version":3,"file":"telemetry-COvVBKBM.d.mts","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6FmB,UAlFF,gBAAA,CAkFE;EAAgB;;;EAQgB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;UAhFlC,gBAAA;;;;;;;;WASP;;;;;UAMO,iBAAA;;;;;;;;;;;;YAcN;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM,SAAA;;;;;;;0BAOQ,mBAAmB;;;;;;;oBAQzB,4BAA4B;;;;;;;sBAQ1B,yBAAyB"}

package/dist/{types-B5H3piDg.d.cts → types-B8YlI4cx.d.cts}

@@ -6,4 +6,4 @@ type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
 
 //#endregion
 export { HttpMethod, LowerHttpMethod, RemoveUndefined };
-//# sourceMappingURL=types-B5H3piDg.d.cts.map
+//# sourceMappingURL=types-B8YlI4cx.d.cts.map

package/dist/{types-B5H3piDg.d.cts.map → types-B8YlI4cx.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-B5H3piDg.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,6BAAA,MACC,CADD,IACM,CADS,CACP,CADO,CAAA,SAAA,SAAA,GAAA,KAAA,GACwB,CADxB,GAC4B,CAD5B,CAC8B,CAD9B,CAAA,EAAA;AACd,KAGD,UAAA,GAHC,KAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,QAAA,GAAA,SAAA;AAAK,KAWN,eAXM,CAAA,UAWoB,UAXpB,CAAA,GAWkC,SAXlC,CAW4C,CAX5C,CAAA"}
+{"version":3,"file":"types-B8YlI4cx.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,6BAAA,MACC,CADD,IACM,CADS,CACP,CADO,CAAA,SAAA,SAAA,GAAA,KAAA,GACwB,CADxB,GAC4B,CAD5B,CAC8B,CAD9B,CAAA,EAAA;AACd,KAGD,UAAA,GAHC,KAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,QAAA,GAAA,SAAA;AAAK,KAWN,eAXM,CAAA,UAWoB,UAXpB,CAAA,GAWkC,SAXlC,CAW4C,CAX5C,CAAA"}

package/dist/{types-BqPOdHEm.d.mts → types-BA3eK4xj.d.mts}

@@ -6,4 +6,4 @@ type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
 
 //#endregion
 export { HttpMethod, LowerHttpMethod, RemoveUndefined };
-//# sourceMappingURL=types-BqPOdHEm.d.mts.map
+//# sourceMappingURL=types-BA3eK4xj.d.mts.map

package/dist/{types-BqPOdHEm.d.mts.map → types-BA3eK4xj.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-BqPOdHEm.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,6BAAA,MACC,CADD,IACM,CADS,CACP,CADO,CAAA,SAAA,SAAA,GAAA,KAAA,GACwB,CADxB,GAC4B,CAD5B,CAC8B,CAD9B,CAAA,EAAA;AACd,KAGD,UAAA,GAHC,KAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,QAAA,GAAA,SAAA;AAAK,KAWN,eAXM,CAAA,UAWoB,UAXpB,CAAA,GAWkC,SAXlC,CAW4C,CAX5C,CAAA"}
+{"version":3,"file":"types-BA3eK4xj.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,6BAAA,MACC,CADD,IACM,CADS,CACP,CADO,CAAA,SAAA,SAAA,GAAA,KAAA,GACwB,CADxB,GAC4B,CAD5B,CAC8B,CAD9B,CAAA,EAAA;AACd,KAGD,UAAA,GAHC,KAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,QAAA,GAAA,SAAA;AAAK,KAWN,eAXM,CAAA,UAWoB,UAXpB,CAAA,GAWkC,SAXlC,CAW4C,CAX5C,CAAA"}

package/dist/types.d.cts

@@ -1,2 +1,2 @@
-import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-B5H3piDg.cjs";
+import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-B8YlI4cx.cjs";
 export { HttpMethod, LowerHttpMethod, RemoveUndefined };

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-BqPOdHEm.mjs";
+import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-BA3eK4xj.mjs";
 export { HttpMethod, LowerHttpMethod, RemoveUndefined };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/constructs",
-  "version": "3.0.7",
+  "version": "3.0.9",
   "private": false,
   "type": "module",
   "exports": {
@@ -83,31 +83,31 @@
     "zod": "~4.1.13",
     "@geekmidas/audit": "^2.0.0",
     "@geekmidas/cache": "^1.1.0",
+    "@geekmidas/envkit": "^1.0.5",
     "@geekmidas/db": "^1.0.1",
-    "@geekmidas/envkit": "^1.0.4",
     "@geekmidas/errors": "^1.0.0",
     "@geekmidas/events": "^1.1.0",
-    "@geekmidas/logger": "^1.0.0",
+    "@geekmidas/logger": "^1.0.1",
     "@geekmidas/rate-limit": "^2.0.0",
-    "@geekmidas/schema": "^1.0.0",
     "@geekmidas/services": "^1.0.1",
-    "@geekmidas/testkit": "^1.0.5"
+    "@geekmidas/testkit": "^1.0.5",
+    "@geekmidas/schema": "^1.0.0"
   },
   "peerDependencies": {
     "@middy/core": ">=6.3.1",
     "@types/aws-lambda": ">=8.10.92",
     "hono": ">=4.8.2",
     "msw": ">=2.0.0",
-    "@geekmidas/db": "^1.0.1",
+    "@geekmidas/envkit": "^1.0.5",
+    "@geekmidas/errors": "^1.0.0",
     "@geekmidas/audit": "^2.0.0",
-    "@geekmidas/cache": "^1.1.0",
-    "@geekmidas/envkit": "^1.0.4",
+    "@geekmidas/logger": "^1.0.1",
     "@geekmidas/events": "^1.1.0",
-    "@geekmidas/logger": "^1.0.0",
-    "@geekmidas/errors": "^1.0.0",
-    "@geekmidas/rate-limit": "^2.0.0",
     "@geekmidas/schema": "^1.0.0",
-    "@geekmidas/services": "^1.0.1"
+    "@geekmidas/rate-limit": "^2.0.0",
+    "@geekmidas/services": "^1.0.1",
+    "@geekmidas/cache": "^1.1.0",
+    "@geekmidas/db": "^1.0.1"
   },
   "peerDependenciesMeta": {
     "@geekmidas/audit": {

package/src/Construct.ts

@@ -11,8 +11,12 @@ import type { StandardSchemaV1 } from '@standard-schema/spec';
 import compact from 'lodash.compact';
 
 // Cache for service environment variables to handle singleton services
-// Key: service class/constructor, Value: array of env var names
-const serviceEnvCache = new Map<Service, string[]>();
+// Stores both the full list and the optional subset so the same sniff result
+// can satisfy both getEnvironment() and getEnvironment({ markOptional: true }).
+const serviceEnvCache = new Map<
+	Service,
+	{ envVars: string[]; optionalEnvVars: string[] }
+>();
 
 /**
  * Noop context for environment sniffing.
@@ -80,6 +84,8 @@ export abstract class Construct<
 	 * Results are cached per service class to handle singleton patterns where
 	 * subsequent register() calls may short-circuit and not access env vars.
 	 *
+	 * @param markOptional - When true, optional vars (those accessed via `.optional()` or
+	 *   `.default()`) are suffixed with `?` in the returned array (e.g. `'PORT?'`).
 	 * @returns Promise that resolves to array of environment variable names, sorted alphabetically
 	 *
 	 * @example
@@ -89,11 +95,16 @@ export abstract class Construct<
 	 *   .get('/users')
 	 *   .handle(async () => []);
 	 *
-	 * const envVars = await endpoint.getEnvironment(); // ['AUTH_SECRET', 'DATABASE_URL']
+	 * await endpoint.getEnvironment();               // ['AUTH_SECRET', 'DATABASE_URL']
+	 * await endpoint.getEnvironment({ markOptional: true }); // ['AUTH_SECRET', 'DATABASE_URL', 'PORT?']
 	 * ```
 	 */
-	async getEnvironment(): Promise<string[]> {
+	async getEnvironment(
+		opts: { markOptional?: boolean } = {},
+	): Promise<string[]> {
+		const { markOptional = false } = opts;
 		const envVars = new Set<string>();
+		const optionalVars = new Set<string>();
 		const services: Service[] = compact([
 			...this.services,
 			this.publisherService,
@@ -107,7 +118,8 @@ export abstract class Construct<
 				// Check cache first - handles singleton services that short-circuit
 				if (serviceEnvCache.has(service)) {
 					const cached = serviceEnvCache.get(service)!;
-					cached.forEach((v) => envVars.add(v));
+					cached.envVars.forEach((v) => envVars.add(v));
+					cached.optionalEnvVars.forEach((v) => optionalVars.add(v));
 					continue;
 				}
 
@@ -131,12 +143,18 @@ export abstract class Construct<
 					);
 				}
 
-				// Cache and collect the env vars
-				serviceEnvCache.set(service, result.envVars);
+				// Cache and collect env vars (both required and optional)
+				serviceEnvCache.set(service, {
+					envVars: result.envVars,
+					optionalEnvVars: result.optionalEnvVars,
+				});
 				result.envVars.forEach((v) => envVars.add(v));
+				result.optionalEnvVars.forEach((v) => optionalVars.add(v));
 			}
 
-			return Array.from(envVars).sort();
+			const sorted = Array.from(envVars).sort();
+			if (!markOptional || optionalVars.size === 0) return sorted;
+			return sorted.map((v) => (optionalVars.has(v) ? `${v}?` : v));
 		} catch (error) {
 			this.logger.error(
 				{ error },

package/src/__tests__/Construct.environment.spec.ts

@@ -578,4 +578,127 @@ describe('Construct environment getter', () => {
 			expect(envVars).toEqual(['VAR_1', 'VAR_2', 'VAR_3']);
 		});
 	});
+
+	describe('markOptional option', () => {
+		const dbService = {
+			serviceName: 'db' as const,
+			register({ envParser }) {
+				return envParser
+					.create((get) => ({
+						url: get('DATABASE_URL').string(),
+						pool: get('DB_POOL_SIZE').string().transform(Number).default(10),
+					}))
+					.parse();
+			},
+		} satisfies Service<'db', any>;
+
+		const authService = {
+			serviceName: 'auth' as const,
+			register({ envParser }) {
+				return envParser
+					.create((get) => ({
+						secret: get('JWT_SECRET').string(),
+						ttl: get('JWT_TTL').string().optional(),
+					}))
+					.parse();
+			},
+		} satisfies Service<'auth', any>;
+
+		it('returns plain var names when markOptional is false (default)', async () => {
+			const fn = f
+				.services([dbService])
+				.handle(async () => ({ success: true }));
+
+			expect(await fn.getEnvironment()).toEqual([
+				'DATABASE_URL',
+				'DB_POOL_SIZE',
+			]);
+			expect(await fn.getEnvironment({ markOptional: false })).toEqual([
+				'DATABASE_URL',
+				'DB_POOL_SIZE',
+			]);
+		});
+
+		it('suffixes optional vars with ? when markOptional is true', async () => {
+			const fn = f
+				.services([dbService])
+				.handle(async () => ({ success: true }));
+
+			expect(await fn.getEnvironment({ markOptional: true })).toEqual([
+				'DATABASE_URL',
+				'DB_POOL_SIZE?',
+			]);
+		});
+
+		it('marks vars with .optional() as optional', async () => {
+			const fn = f
+				.services([authService])
+				.handle(async () => ({ success: true }));
+
+			expect(await fn.getEnvironment({ markOptional: true })).toEqual([
+				'JWT_SECRET',
+				'JWT_TTL?',
+			]);
+		});
+
+		it('marks optional vars across multiple services', async () => {
+			const fn = f
+				.services([dbService, authService])
+				.handle(async () => ({ success: true }));
+
+			expect(await fn.getEnvironment({ markOptional: true })).toEqual([
+				'DATABASE_URL',
+				'DB_POOL_SIZE?',
+				'JWT_SECRET',
+				'JWT_TTL?',
+			]);
+		});
+
+		it('works on Endpoint constructs', async () => {
+			const endpoint = e
+				.services([dbService])
+				.get('/users')
+				.handle(async () => []);
+
+			expect(await endpoint.getEnvironment({ markOptional: true })).toEqual([
+				'DATABASE_URL',
+				'DB_POOL_SIZE?',
+			]);
+		});
+
+		it('works on Cron constructs', async () => {
+			const cron = c
+				.schedule('rate(1 hour)')
+				.services([authService])
+				.handle(async () => {});
+
+			expect(await cron.getEnvironment({ markOptional: true })).toEqual([
+				'JWT_SECRET',
+				'JWT_TTL?',
+			]);
+		});
+
+		it('required-only vars have no ? suffix', async () => {
+			const requiredOnly = {
+				serviceName: 'required' as const,
+				register({ envParser }) {
+					return envParser
+						.create((get) => ({
+							a: get('VAR_A').string(),
+							b: get('VAR_B').string(),
+						}))
+						.parse();
+				},
+			} satisfies Service<'required', any>;
+
+			const fn = f
+				.services([requiredOnly])
+				.handle(async () => ({ success: true }));
+
+			expect(await fn.getEnvironment({ markOptional: true })).toEqual([
+				'VAR_A',
+				'VAR_B',
+			]);
+		});
+	});
 });

package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts

@@ -474,7 +474,15 @@ export abstract class AmazonApiGatewayEndpoint<
 		);
 
 		const { output, metadata } = result;
-		const body = output !== undefined ? JSON.stringify(output) : undefined;
+		const isJsonResponse = this.endpoint.responseType === 'application/json';
+		const body =
+			output === undefined
+				? undefined
+				: isJsonResponse
+					? JSON.stringify(output)
+					: typeof output === 'string'
+						? output
+						: String(output);
 
 		// Store response for middleware access
 		(event as any).__response = output;
@@ -485,9 +493,20 @@ export abstract class AmazonApiGatewayEndpoint<
 			body,
 		};
 
-		// Add custom headers
-		if (metadata.headers && Object.keys(metadata.headers).length > 0) {
-			lambdaResponse.headers = { ...metadata.headers };
+		// Compose headers. For non-JSON responseType, emit a default
+		// Content-Type header which metadata.headers (r.header()) can override.
+		const baseHeaders: Record<string, string> | undefined = isJsonResponse
+			? undefined
+			: { 'content-type': this.endpoint.responseType };
+
+		if (
+			baseHeaders ||
+			(metadata.headers && Object.keys(metadata.headers).length > 0)
+		) {
+			lambdaResponse.headers = {
+				...(baseHeaders ?? {}),
+				...(metadata.headers ?? {}),
+			};
 		}
 
 		// Format cookies as Set-Cookie headers

package/src/endpoints/Endpoint.ts

@@ -107,6 +107,12 @@ export class Endpoint<
 	tags?: string[];
 	/** The HTTP success status code to return (default: 200) */
 	public readonly status: SuccessStatus;
+	/**
+	 * Response content type for this endpoint. Defaults to `'application/json'`.
+	 * Non-JSON types cause adaptors to emit the body as-is with the declared
+	 * Content-Type header instead of JSON-serializing.
+	 */
+	public readonly responseType: string;
 	/** Default headers to apply to all responses */
 	public readonly defaultHeaders: Record<string, string> = {};
 	/** Function to extract session data from the request context */
@@ -465,7 +471,7 @@ export class Endpoint<
 			if (responseSchema) {
 				set(
 					operation,
-					['responses', '200', 'content', 'application/json', 'schema'],
+					['responses', '200', 'content', this.responseType, 'schema'],
 					responseSchema,
 				);
 			}
@@ -606,6 +612,7 @@ export class Endpoint<
 		databaseService,
 		rlsConfig,
 		rlsBypass,
+		responseType,
 	}: EndpointOptions<
 		TRoute,
 		TMethod,
@@ -642,6 +649,7 @@ export class Endpoint<
 		this.description = description;
 		this.tags = tags;
 		this.status = status;
+		this.responseType = responseType ?? 'application/json';
 		this.endpointFn = fn;
 
 		if (getSession) {
@@ -802,6 +810,11 @@ export interface EndpointOptions<
 	rlsConfig?: RlsConfig<TServices, TSession, TLogger>;
 	/** Whether to bypass RLS for this endpoint */
 	rlsBypass?: boolean;
+	/**
+	 * Response content type (e.g. `'application/json'`, `'text/html'`).
+	 * Defaults to `'application/json'` when omitted.
+	 */
+	responseType?: string;
 }
 
 /**