@geekmidas/constructs 0.0.1

package/dist/publisher-Bw4770Hi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher-Bw4770Hi.mjs","names":["logger: Logger","serviceDiscovery: ServiceDiscovery<any, any>","ev: MappedEvent<T, OutSchema>[]","response: InferStandardSchema<OutSchema>","publisherService: TPublisherService","events: MappedEvent<T, OutSchema>[]","construct: Construct<Logger, TServiceName, T, OutSchema, TServices>"],"sources":["../src/publisher.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { Construct } from './Construct';\n\nexport async function publishEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TPublisherService extends Service<TServiceName, T> | undefined = undefined,\n>(\n  logger: Logger,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  ev: MappedEvent<T, OutSchema>[] = [],\n  response: InferStandardSchema<OutSchema>,\n  publisherService: TPublisherService,\n) {\n  try {\n    if (!ev?.length) {\n      logger.debug('No events to publish');\n      return;\n    }\n    if (!publisherService) {\n      logger.warn('No publisher service available');\n      return;\n    }\n\n    const services = await serviceDiscovery.register([publisherService]);\n\n    const publisher = services[\n      publisherService.serviceName\n    ] as EventPublisher<any>;\n\n    const events: MappedEvent<T, OutSchema>[] = [];\n\n    for (const { when, payload, type, ...e } of ev) {\n      logger.debug({ event: type }, 'Processing event');\n      const resolvedPayload = await payload(response);\n      const event = {\n        ...e,\n        type,\n        payload: resolvedPayload,\n      };\n\n      if (!when || when(response as any)) {\n        events.push(event);\n      }\n    }\n\n    if (events.length) {\n      logger.debug({ eventCount: ev.length }, 'Publishing events');\n\n      await publisher.publish(events).catch((err) => {\n        logger.error(err, 'Failed to publish events');\n      });\n    }\n  } catch (error) {\n    logger.error(error as any, 'Something went wrong publishing events');\n  }\n}\n\nexport async function publishConstructEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TServices extends Service[] = [],\n>(\n  construct: Construct<Logger, TServiceName, T, OutSchema, TServices>,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: Logger = construct.logger,\n) {\n  return publishEvents(\n    logger,\n    serviceDiscovery,\n    construct.events,\n    response,\n    construct.publisherService,\n  );\n}\n"],"mappings":";AAQA,eAAsB,cAMpBA,QACAC,kBACAC,KAAkC,CAAE,GACpCC,UACAC,kBACA;AACA,KAAI;AACF,OAAK,IAAI,QAAQ;AACf,UAAO,MAAM,uBAAuB;AACpC;EACD;AACD,OAAK,kBAAkB;AACrB,UAAO,KAAK,iCAAiC;AAC7C;EACD;EAED,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAAC,gBAAiB,EAAC;EAEpE,MAAM,YAAY,SAChB,iBAAiB;EAGnB,MAAMC,SAAsC,CAAE;AAE9C,OAAK,MAAM,EAAE,MAAM,SAAS,KAAM,GAAG,GAAG,IAAI,IAAI;AAC9C,UAAO,MAAM,EAAE,OAAO,KAAM,GAAE,mBAAmB;GACjD,MAAM,kBAAkB,MAAM,QAAQ,SAAS;GAC/C,MAAM,QAAQ;IACZ,GAAG;IACH;IACA,SAAS;GACV;AAED,QAAK,QAAQ,KAAK,SAAgB,CAChC,QAAO,KAAK,MAAM;EAErB;AAED,MAAI,OAAO,QAAQ;AACjB,UAAO,MAAM,EAAE,YAAY,GAAG,OAAQ,GAAE,oBAAoB;AAE5D,SAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ;AAC7C,WAAO,MAAM,KAAK,2BAA2B;GAC9C,EAAC;EACH;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAc,yCAAyC;CACrE;AACF;AAED,eAAsB,uBAMpBC,WACAH,UACAF,kBACAD,SAAiB,UAAU,QAC3B;AACA,QAAO,cACL,QACA,kBACA,UAAU,QACV,UACA,UAAU,iBACX;AACF"}

package/dist/publisher-lFQleddL.cjs

@@ -0,0 +1,53 @@
+
+//#region src/publisher.ts
+async function publishEvents(logger, serviceDiscovery, ev = [], response, publisherService) {
+	try {
+		if (!ev?.length) {
+			logger.debug("No events to publish");
+			return;
+		}
+		if (!publisherService) {
+			logger.warn("No publisher service available");
+			return;
+		}
+		const services = await serviceDiscovery.register([publisherService]);
+		const publisher = services[publisherService.serviceName];
+		const events = [];
+		for (const { when, payload, type,...e } of ev) {
+			logger.debug({ event: type }, "Processing event");
+			const resolvedPayload = await payload(response);
+			const event = {
+				...e,
+				type,
+				payload: resolvedPayload
+			};
+			if (!when || when(response)) events.push(event);
+		}
+		if (events.length) {
+			logger.debug({ eventCount: ev.length }, "Publishing events");
+			await publisher.publish(events).catch((err) => {
+				logger.error(err, "Failed to publish events");
+			});
+		}
+	} catch (error) {
+		logger.error(error, "Something went wrong publishing events");
+	}
+}
+async function publishConstructEvents(construct, response, serviceDiscovery, logger = construct.logger) {
+	return publishEvents(logger, serviceDiscovery, construct.events, response, construct.publisherService);
+}
+
+//#endregion
+Object.defineProperty(exports, 'publishConstructEvents', {
+  enumerable: true,
+  get: function () {
+    return publishConstructEvents;
+  }
+});
+Object.defineProperty(exports, 'publishEvents', {
+  enumerable: true,
+  get: function () {
+    return publishEvents;
+  }
+});
+//# sourceMappingURL=publisher-lFQleddL.cjs.map

package/dist/publisher-lFQleddL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher-lFQleddL.cjs","names":["logger: Logger","serviceDiscovery: ServiceDiscovery<any, any>","ev: MappedEvent<T, OutSchema>[]","response: InferStandardSchema<OutSchema>","publisherService: TPublisherService","events: MappedEvent<T, OutSchema>[]","construct: Construct<Logger, TServiceName, T, OutSchema, TServices>"],"sources":["../src/publisher.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { Construct } from './Construct';\n\nexport async function publishEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TPublisherService extends Service<TServiceName, T> | undefined = undefined,\n>(\n  logger: Logger,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  ev: MappedEvent<T, OutSchema>[] = [],\n  response: InferStandardSchema<OutSchema>,\n  publisherService: TPublisherService,\n) {\n  try {\n    if (!ev?.length) {\n      logger.debug('No events to publish');\n      return;\n    }\n    if (!publisherService) {\n      logger.warn('No publisher service available');\n      return;\n    }\n\n    const services = await serviceDiscovery.register([publisherService]);\n\n    const publisher = services[\n      publisherService.serviceName\n    ] as EventPublisher<any>;\n\n    const events: MappedEvent<T, OutSchema>[] = [];\n\n    for (const { when, payload, type, ...e } of ev) {\n      logger.debug({ event: type }, 'Processing event');\n      const resolvedPayload = await payload(response);\n      const event = {\n        ...e,\n        type,\n        payload: resolvedPayload,\n      };\n\n      if (!when || when(response as any)) {\n        events.push(event);\n      }\n    }\n\n    if (events.length) {\n      logger.debug({ eventCount: ev.length }, 'Publishing events');\n\n      await publisher.publish(events).catch((err) => {\n        logger.error(err, 'Failed to publish events');\n      });\n    }\n  } catch (error) {\n    logger.error(error as any, 'Something went wrong publishing events');\n  }\n}\n\nexport async function publishConstructEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TServices extends Service[] = [],\n>(\n  construct: Construct<Logger, TServiceName, T, OutSchema, TServices>,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: Logger = construct.logger,\n) {\n  return publishEvents(\n    logger,\n    serviceDiscovery,\n    construct.events,\n    response,\n    construct.publisherService,\n  );\n}\n"],"mappings":";;AAQA,eAAsB,cAMpBA,QACAC,kBACAC,KAAkC,CAAE,GACpCC,UACAC,kBACA;AACA,KAAI;AACF,OAAK,IAAI,QAAQ;AACf,UAAO,MAAM,uBAAuB;AACpC;EACD;AACD,OAAK,kBAAkB;AACrB,UAAO,KAAK,iCAAiC;AAC7C;EACD;EAED,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAAC,gBAAiB,EAAC;EAEpE,MAAM,YAAY,SAChB,iBAAiB;EAGnB,MAAMC,SAAsC,CAAE;AAE9C,OAAK,MAAM,EAAE,MAAM,SAAS,KAAM,GAAG,GAAG,IAAI,IAAI;AAC9C,UAAO,MAAM,EAAE,OAAO,KAAM,GAAE,mBAAmB;GACjD,MAAM,kBAAkB,MAAM,QAAQ,SAAS;GAC/C,MAAM,QAAQ;IACZ,GAAG;IACH;IACA,SAAS;GACV;AAED,QAAK,QAAQ,KAAK,SAAgB,CAChC,QAAO,KAAK,MAAM;EAErB;AAED,MAAI,OAAO,QAAQ;AACjB,UAAO,MAAM,EAAE,YAAY,GAAG,OAAQ,GAAE,oBAAoB;AAE5D,SAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ;AAC7C,WAAO,MAAM,KAAK,2BAA2B;GAC9C,EAAC;EACH;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAc,yCAAyC;CACrE;AACF;AAED,eAAsB,uBAMpBC,WACAH,UACAF,kBACAD,SAAiB,UAAU,QAC3B;AACA,QAAO,cACL,QACA,kBACA,UAAU,QACV,UACA,UAAU,iBACX;AACF"}

package/dist/publisher.cjs

@@ -0,0 +1,4 @@
+const require_publisher = require('./publisher-lFQleddL.cjs');
+
+exports.publishConstructEvents = require_publisher.publishConstructEvents;
+exports.publishEvents = require_publisher.publishEvents;

package/dist/publisher.d.cts

@@ -0,0 +1,13 @@
+import { Construct } from "./Construct-Bm-PSO2V.cjs";
+import { EventPublisher, MappedEvent } from "@geekmidas/events";
+import { Logger } from "@geekmidas/logger";
+import { Service, ServiceDiscovery } from "@geekmidas/services";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { InferStandardSchema } from "@geekmidas/schema";
+
+//#region src/publisher.d.ts
+declare function publishEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TPublisherService extends Service<TServiceName, T> | undefined = undefined>(logger: Logger, serviceDiscovery: ServiceDiscovery<any, any>, ev: MappedEvent<T, OutSchema>[] | undefined, response: InferStandardSchema<OutSchema>, publisherService: TPublisherService): Promise<void>;
+declare function publishConstructEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TServices extends Service[] = []>(construct: Construct<Logger, TServiceName, T, OutSchema, TServices>, response: InferStandardSchema<OutSchema>, serviceDiscovery: ServiceDiscovery<any, any>, logger?: Logger): Promise<void>;
+//#endregion
+export { publishConstructEvents, publishEvents };
+//# sourceMappingURL=publisher.d.cts.map

package/dist/publisher.d.mts

@@ -0,0 +1,13 @@
+import { Construct } from "./Construct-DIguIyw4.mjs";
+import { Service, ServiceDiscovery } from "@geekmidas/services";
+import { EventPublisher, MappedEvent } from "@geekmidas/events";
+import { Logger } from "@geekmidas/logger";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { InferStandardSchema } from "@geekmidas/schema";
+
+//#region src/publisher.d.ts
+declare function publishEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TPublisherService extends Service<TServiceName, T> | undefined = undefined>(logger: Logger, serviceDiscovery: ServiceDiscovery<any, any>, ev: MappedEvent<T, OutSchema>[] | undefined, response: InferStandardSchema<OutSchema>, publisherService: TPublisherService): Promise<void>;
+declare function publishConstructEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TServices extends Service[] = []>(construct: Construct<Logger, TServiceName, T, OutSchema, TServices>, response: InferStandardSchema<OutSchema>, serviceDiscovery: ServiceDiscovery<any, any>, logger?: Logger): Promise<void>;
+//#endregion
+export { publishConstructEvents, publishEvents };
+//# sourceMappingURL=publisher.d.mts.map

package/dist/publisher.mjs

@@ -0,0 +1,3 @@
+import { publishConstructEvents, publishEvents } from "./publisher-Bw4770Hi.mjs";
+
+export { publishConstructEvents, publishEvents };

package/dist/subscribers/AWSLambdaSubscriberAdaptor.cjs

@@ -0,0 +1,3 @@
+const require_AWSLambdaSubscriberAdaptor = require('../AWSLambdaSubscriberAdaptor-CmPZ10JF.cjs');
+
+exports.AWSLambdaSubscriber = require_AWSLambdaSubscriberAdaptor.AWSLambdaSubscriber;

package/dist/subscribers/AWSLambdaSubscriberAdaptor.d.cts

@@ -0,0 +1,4 @@
+import "../Construct-Bm-PSO2V.cjs";
+import "../Subscriber-BoFm12i_.cjs";
+import { AWSLambdaHandler, AWSLambdaSubscriber } from "../AWSLambdaSubscriberAdaptor-QKVxR6qh.cjs";
+export { AWSLambdaHandler, AWSLambdaSubscriber };

package/dist/subscribers/AWSLambdaSubscriberAdaptor.d.mts

@@ -0,0 +1,4 @@
+import "../Construct-DIguIyw4.mjs";
+import "../Subscriber-THGsj7Iy.mjs";
+import { AWSLambdaHandler, AWSLambdaSubscriber } from "../AWSLambdaSubscriberAdaptor-C1wQuucQ.mjs";
+export { AWSLambdaHandler, AWSLambdaSubscriber };

package/dist/subscribers/AWSLambdaSubscriberAdaptor.mjs

@@ -0,0 +1,3 @@
+import { AWSLambdaSubscriber } from "../AWSLambdaSubscriberAdaptor-G8y3YkWj.mjs";
+
+export { AWSLambdaSubscriber };

package/dist/subscribers/Subscriber.cjs

@@ -0,0 +1,4 @@
+require('../Construct-BSEs6uwW.cjs');
+const require_Subscriber = require('../Subscriber-iMRFG7ba.cjs');
+
+exports.Subscriber = require_Subscriber.Subscriber;

package/dist/subscribers/Subscriber.d.cts

@@ -0,0 +1,3 @@
+import "../Construct-Bm-PSO2V.cjs";
+import { Subscriber, SubscriberContext, SubscriberHandler } from "../Subscriber-BoFm12i_.cjs";
+export { Subscriber, SubscriberContext, SubscriberHandler };

package/dist/subscribers/Subscriber.d.mts

@@ -0,0 +1,3 @@
+import "../Construct-DIguIyw4.mjs";
+import { Subscriber, SubscriberContext, SubscriberHandler } from "../Subscriber-THGsj7Iy.mjs";
+export { Subscriber, SubscriberContext, SubscriberHandler };

package/dist/subscribers/Subscriber.mjs

@@ -0,0 +1,4 @@
+import "../Construct-BbKCIPQm.mjs";
+import { Subscriber } from "../Subscriber-BwuCaC9G.mjs";
+
+export { Subscriber };

package/dist/subscribers/SubscriberBuilder.cjs

@@ -0,0 +1,5 @@
+require('../Construct-BSEs6uwW.cjs');
+require('../Subscriber-iMRFG7ba.cjs');
+const require_SubscriberBuilder = require('../SubscriberBuilder-wthr-FL9.cjs');
+
+exports.SubscriberBuilder = require_SubscriberBuilder.SubscriberBuilder;

package/dist/subscribers/SubscriberBuilder.d.cts

@@ -0,0 +1,4 @@
+import "../Construct-Bm-PSO2V.cjs";
+import "../Subscriber-BoFm12i_.cjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-DuIgxuzc.cjs";
+export { SubscriberBuilder };

package/dist/subscribers/SubscriberBuilder.d.mts

@@ -0,0 +1,4 @@
+import "../Construct-DIguIyw4.mjs";
+import "../Subscriber-THGsj7Iy.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-CiPxgnKT.mjs";
+export { SubscriberBuilder };

package/dist/subscribers/SubscriberBuilder.mjs

@@ -0,0 +1,5 @@
+import "../Construct-BbKCIPQm.mjs";
+import "../Subscriber-BwuCaC9G.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-Dhz0C_t-.mjs";
+
+export { SubscriberBuilder };

package/dist/subscribers/index.cjs

@@ -0,0 +1,12 @@
+require('../Construct-BSEs6uwW.cjs');
+const require_Subscriber = require('../Subscriber-iMRFG7ba.cjs');
+const require_SubscriberBuilder = require('../SubscriberBuilder-wthr-FL9.cjs');
+
+//#region src/subscribers/index.ts
+const s = new require_SubscriberBuilder.SubscriberBuilder();
+
+//#endregion
+exports.Subscriber = require_Subscriber.Subscriber;
+exports.SubscriberBuilder = require_SubscriberBuilder.SubscriberBuilder;
+exports.s = s;
+//# sourceMappingURL=index.cjs.map

package/dist/subscribers/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["SubscriberBuilder"],"sources":["../../src/subscribers/index.ts"],"sourcesContent":["import { SubscriberBuilder } from './SubscriberBuilder';\nexport { Subscriber } from './Subscriber';\nexport { SubscriberBuilder };\n\nexport const s = new SubscriberBuilder();\n"],"mappings":";;;;;AAIA,MAAa,IAAI,IAAIA"}

package/dist/subscribers/index.d.cts

@@ -0,0 +1,10 @@
+import "../Construct-Bm-PSO2V.cjs";
+import { Subscriber } from "../Subscriber-BoFm12i_.cjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-DuIgxuzc.cjs";
+import * as _geekmidas_logger8 from "@geekmidas/logger";
+
+//#region src/subscribers/index.d.ts
+declare const s: SubscriberBuilder<[], _geekmidas_logger8.Logger, undefined, undefined, string, []>;
+//#endregion
+export { Subscriber, SubscriberBuilder, s };
+//# sourceMappingURL=index.d.cts.map

package/dist/subscribers/index.d.mts

@@ -0,0 +1,10 @@
+import "../Construct-DIguIyw4.mjs";
+import { Subscriber } from "../Subscriber-THGsj7Iy.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-CiPxgnKT.mjs";
+import * as _geekmidas_logger1 from "@geekmidas/logger";
+
+//#region src/subscribers/index.d.ts
+declare const s: SubscriberBuilder<[], _geekmidas_logger1.Logger, undefined, undefined, string, []>;
+//#endregion
+export { Subscriber, SubscriberBuilder, s };
+//# sourceMappingURL=index.d.mts.map

package/dist/subscribers/index.mjs

@@ -0,0 +1,10 @@
+import "../Construct-BbKCIPQm.mjs";
+import { Subscriber } from "../Subscriber-BwuCaC9G.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-Dhz0C_t-.mjs";
+
+//#region src/subscribers/index.ts
+const s = new SubscriberBuilder();
+
+//#endregion
+export { Subscriber, SubscriberBuilder, s };
+//# sourceMappingURL=index.mjs.map

package/dist/subscribers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscribers/index.ts"],"sourcesContent":["import { SubscriberBuilder } from './SubscriberBuilder';\nexport { Subscriber } from './Subscriber';\nexport { SubscriberBuilder };\n\nexport const s = new SubscriberBuilder();\n"],"mappings":";;;;;AAIA,MAAa,IAAI,IAAI"}

package/dist/types-Bp9ysFXd.d.cts

@@ -0,0 +1,7 @@
+//#region src/types.d.ts
+type RemoveUndefined<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K] };
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
+type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
+//#endregion
+export { HttpMethod, LowerHttpMethod, RemoveUndefined };
+//# sourceMappingURL=types-Bp9ysFXd.d.cts.map

package/dist/types-DBKNYvsW.d.mts

@@ -0,0 +1,7 @@
+//#region src/types.d.ts
+type RemoveUndefined<T> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K] };
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
+type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
+//#endregion
+export { HttpMethod, LowerHttpMethod, RemoveUndefined };
+//# sourceMappingURL=types-DBKNYvsW.d.mts.map

package/dist/types.d.cts

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

package/dist/types.d.mts

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

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@geekmidas/constructs",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./endpoints": {
+      "types": "./dist/endpoints/index.d.ts",
+      "import": "./dist/endpoints/index.mjs",
+      "require": "./dist/endpoints/index.cjs"
+    },
+    "./functions": {
+      "types": "./dist/functions/index.d.ts",
+      "import": "./dist/functions/index.mjs",
+      "require": "./dist/functions/index.cjs"
+    },
+    "./crons": {
+      "types": "./dist/crons/index.d.ts",
+      "import": "./dist/crons/index.mjs",
+      "require": "./dist/crons/index.cjs"
+    },
+    "./subscribers": {
+      "types": "./dist/subscribers/index.d.ts",
+      "import": "./dist/subscribers/index.mjs",
+      "require": "./dist/subscribers/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./hono": {
+      "types": "./dist/adaptors/hono.d.ts",
+      "import": "./dist/adaptors/hono.mjs",
+      "require": "./dist/adaptors/hono.cjs"
+    },
+    "./aws": {
+      "types": "./dist/adaptors/aws.d.ts",
+      "import": "./dist/adaptors/aws.mjs",
+      "require": "./dist/adaptors/aws.cjs"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geekmidas/toolbox.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "lodash.pick": "~4.4.0",
+    "lodash.set": "~4.3.2",
+    "lodash.get": "~4.4.2",
+    "lodash.uniqby": "~4.7.0",
+    "lodash.compact": "~3.0.1",
+    "openapi-types": "~12.1.3",
+    "fast-glob": "~3.3.3",
+    "@geekmidas/services": "0.0.1",
+    "@geekmidas/logger": "0.0.1",
+    "@geekmidas/cache": "0.0.7",
+    "@geekmidas/rate-limit": "0.1.0",
+    "@geekmidas/schema": "0.0.1",
+    "@geekmidas/events": "0.0.1",
+    "@geekmidas/errors": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/lodash.pick": "~4.4.9",
+    "@types/lodash.set": "~4.3.9",
+    "@types/lodash.get": "~4.4.9",
+    "@types/lodash.uniqby": "~4.7.9",
+    "@types/lodash.compact": "~3.0.9",
+    "zod": "~4.1.12",
+    "@geekmidas/testkit": "0.0.16"
+  },
+  "peerDependencies": {
+    "@standard-schema/spec": ">=1.0.0",
+    "@middy/core": ">=6.3.1",
+    "@types/aws-lambda": ">=8.10.92",
+    "hono": ">=4.8.2",
+    "@geekmidas/envkit": "0.0.7"
+  },
+  "scripts": {
+    "ts": "tsc --noEmit --skipLibCheck src/**/*.ts"
+  }
+}

package/src/Construct.ts

@@ -0,0 +1,98 @@
+import { EnvironmentParser } from '@geekmidas/envkit';
+import type { EventPublisher, MappedEvent } from '@geekmidas/events';
+import type { Logger } from '@geekmidas/logger';
+import type { Service } from '@geekmidas/services';
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import compact from 'lodash.compact';
+
+export abstract class Construct<
+  TLogger extends Logger = Logger,
+  TServiceName extends string = string,
+  T extends EventPublisher<any> | undefined = undefined,
+  OutSchema extends StandardSchemaV1 | undefined = undefined,
+  TServices extends Service[] = [],
+> {
+  constructor(
+    public readonly type: ConstructType,
+    public readonly logger: TLogger,
+    public readonly services: TServices,
+    public readonly events: MappedEvent<T, any>[] = [],
+
+    public readonly publisherService?: Service<TServiceName, T>,
+    public outputSchema?: OutSchema,
+  ) {}
+
+  /**
+   * Returns an array of environment variable names required by this construct's services.
+   * This is determined by running a "sniffer" EnvironmentParser through each service's
+   * register method to track which environment variables are accessed.
+   *
+   * @returns Promise that resolves to array of environment variable names, sorted alphabetically
+   *
+   * @example
+   * ```typescript
+   * const endpoint = e
+   *   .services([databaseService, authService])
+   *   .get('/users')
+   *   .handle(async () => []);
+   *
+   * const envVars = await endpoint.getEnvironment(); // ['AUTH_SECRET', 'DATABASE_URL']
+   * ```
+   */
+  async getEnvironment(): Promise<string[]> {
+    const envVars = new Set<string>();
+    const sniffer = new EnvironmentParser({});
+    const services: Service[] = compact([
+      ...this.services,
+      this.publisherService,
+    ]);
+
+    try {
+      // Run each service's register method with the sniffer to track env var access
+      for (const service of services) {
+        try {
+          const config = service.register(sniffer);
+
+          // Await if it's a Promise (async services)
+          const resolvedConfig =
+            config && typeof config === 'object' && 'then' in config
+              ? await Promise.resolve(config)
+              : config;
+
+          // If register returns a ConfigParser, collect its env vars
+          if (
+            resolvedConfig &&
+            typeof resolvedConfig === 'object' &&
+            'getEnvironmentVariables' in resolvedConfig &&
+            typeof resolvedConfig.getEnvironmentVariables === 'function'
+          ) {
+            const vars = resolvedConfig.getEnvironmentVariables();
+            if (Array.isArray(vars)) {
+              vars.forEach((v: string) => envVars.add(v));
+            }
+          }
+        } catch (serviceError) {
+          // Service registration failed (e.g., missing env vars during .parse())
+          // But env vars were already tracked during .create(), so we continue
+          continue;
+        }
+      }
+
+      return Array.from(envVars).sort();
+    } catch (error) {
+      console.error(
+        'Error determining environment variables for construct:',
+        error,
+      );
+
+      return [];
+    }
+  }
+}
+
+export enum ConstructType {
+  Cron = 'dev.geekmidas.function.cron',
+  Endpoint = 'dev.geekmidas.function.endpoint',
+  Function = 'dev.geekmidas.function.function',
+  Subscriber = 'dev.geekmidas.function.subscriber',
+}