@geekmidas/constructs 10.0.0-alpha.38 → 10.0.0-alpha.39

package/README.md

@@ -33,14 +33,13 @@ import { RestApi } from '@geekmidas/constructs/rest-api';
 // returns. There is no free-standing `e` — an endpoint belongs to a surface.
 import { EndpointBuilder, EndpointFactory } from '@geekmidas/constructs/endpoints';
 
-// Functions
-import { f, FunctionBuilder } from '@geekmidas/constructs/functions';
+// The process with no port. Crons, topic subscribers, queues and functions
+// are built from it — `worker.cron(…)`, `worker.topic(…)`, `worker.queue(…)`,
+// `worker.input(…)` — and carry its logger.
+import { Worker } from '@geekmidas/constructs/worker';
 
-// Crons
-import { c, CronBuilder } from '@geekmidas/constructs/crons';
-
-// Subscribers
-import { s, SubscriberBuilder } from '@geekmidas/constructs/subscribers';
+// A declared event contract. Its publisher is its `service`.
+import { Topic } from '@geekmidas/constructs/topic';
 ```
 
 ## Quick Start
@@ -126,15 +125,31 @@ export const searchUsers = api
   });
 ```
 
+### The Worker
+
+Everything that is not an HTTP route is built from a `Worker`: the process
+that runs a schedule, drains a queue or consumes a topic. It takes no
+authorizer, because nothing reaches it from outside.
+
+```typescript
+// constructs/worker.ts
+import { Worker } from '@geekmidas/constructs/worker';
+import { database } from './database';
+import { logger } from './logger';
+
+// `.database(…)` is where a server target keeps cron schedules.
+export const worker = new Worker('Jobs', { logger }).database(database);
+```
+
 ### Cloud Functions
 
-Create serverless functions with input/output validation:
+Create functions with input/output validation:
 
 ```typescript
-import { f } from '@geekmidas/constructs/functions';
+import { worker } from '../constructs/worker';
 import { z } from 'zod';
 
-export const processOrder = f
+export const processOrder = worker
   .input(z.object({
     orderId: z.string(),
     items: z.array(z.object({
@@ -145,13 +160,12 @@ export const processOrder = f
   .output(z.object({
     orderId: z.string(),
     status: z.enum(['processing', 'completed', 'failed']),
-    processedAt: z.string().datetime()
+    processedAt: z.iso.datetime()
   }))
   .timeout(300000) // 5 minutes
   .handle(async ({ input, logger }) => {
     logger.info(`Processing order ${input.orderId}`);
 
-    // Process order logic
     for (const item of input.items) {
       logger.info(`Processing item ${item.id}, quantity: ${item.quantity}`);
     }
@@ -166,87 +180,99 @@ export const processOrder = f
 
 ### Scheduled Tasks (Crons)
 
-Define cron jobs with schedules:
-
 ```typescript
-import { cron } from '@geekmidas/constructs/crons';
+import { worker } from '../constructs/worker';
 
 // Daily report at 9 AM UTC
-export const dailyReport = cron
-  .schedule('cron(0 9 * * ? *)')
+export const dailyReport = worker
+  .cron('cron(0 9 * * ? *)')
   .timeout(600000) // 10 minutes
   .handle(async ({ logger }) => {
-    logger.info('Generating daily report');
-
-    const reportDate = new Date().toISOString().split('T')[0];
     const reportData = {
-      date: reportDate,
+      date: new Date().toISOString().split('T')[0],
       totalOrders: 150,
-      totalRevenue: 12500.00
     };
 
-    logger.info('Daily report generated', reportData);
+    logger.info(reportData, 'Daily report generated');
     return reportData;
   });
 
 // Hourly cleanup
-export const hourlyCleanup = cron
-  .schedule('rate(1 hour)')
-  .timeout(300000) // 5 minutes
-  .handle(async ({ logger }) => {
-    logger.info('Running hourly cleanup');
-
-    const itemsCleaned = 42;
-    logger.info(`Cleaned ${itemsCleaned} items`);
+export const hourlyCleanup = worker
+  .cron('rate(1 hour)')
+  .dependsOn([database])
+  .handle(async ({ services, logger }) => {
+    const result = await services.database
+      .deleteFrom('sessions')
+      .where('expires_at', '<', new Date())
+      .executeTakeFirst();
 
-    return { itemsCleaned };
+    logger.info({ deleted: Number(result.numDeletedRows) }, 'Cleaned up');
   });
 ```
 
-### Event Subscribers
+On AWS a cron is an EventBridge rule; on a server the worker schedules it in
+the database it was given.
+
+### Topics and Subscribers
 
-Handle events with type-safe message processing:
+A topic declares the event contract once. A subscriber binds to it from the
+worker and is typed by it:
 
 ```typescript
-import { SubscriberBuilder } from '@geekmidas/constructs/subscribers';
+// constructs/topics.ts
+import { Topic } from '@geekmidas/constructs/topic';
 import { z } from 'zod';
 
-export const userEventsSubscriber = new SubscriberBuilder()
-  .subscribe(['user.created', 'user.updated', 'user.deleted'])
-  .timeout(30000)
-  .output(z.object({
-    processed: z.number(),
-    success: z.boolean()
-  }))
-  .handle(async ({ events, logger }) => {
-    logger.info(
-      { eventCount: events.length },
-      'Processing user events'
-    );
+export const users = new Topic('Users', {
+  events: {
+    'user.created': z.object({ userId: z.string(), email: z.email() }),
+    'user.updated': z.object({ userId: z.string(), changes: z.array(z.string()) }),
+  },
+});
 
+// subscribers/userEvents.ts
+export const userEventsSubscriber = worker
+  .topic(users)
+  .subscribe(['user.created', 'user.updated'])
+  .handle(async ({ events, logger }) => {
     for (const event of events) {
-      try {
-        switch (event.type) {
-          case 'user.created':
-            logger.info({ userId: event.data.userId }, 'User created');
-            break;
-          case 'user.updated':
-            logger.info({ userId: event.data.userId }, 'User updated');
-            break;
-          case 'user.deleted':
-            logger.info({ userId: event.data.userId }, 'User deleted');
-            break;
-        }
-      } catch (error) {
-        logger.error({ error, event }, 'Failed to process event');
-        throw error;
-      }
+      // event.type narrows event.payload to that event's schema
+      logger.info({ type: event.type, userId: event.payload.userId }, 'User event');
     }
+  });
+```
 
-    return {
-      processed: events.length,
-      success: true
-    };
+A subscriber is bound, not handed a publisher. One that emits follow-ups
+depends on the topic it emits to: `.dependsOn([notifications])`.
+
+### Queues
+
+A queue and its one consumer are one construct. Producers send by depending on
+it:
+
+```typescript
+// queues/emails.ts
+export const emails = worker
+  .queue('Emails')
+  .message(z.object({ to: z.email(), template: z.enum(['welcome']) }))
+  .dependsOn([mail])
+  .handle(async ({ messages, services }) => {
+    for (const { to, template } of messages) {
+      await services.mail.sendTemplate(template, { to, subject: 'Welcome', props: {} });
+    }
+  });
+
+// endpoints/invites.ts
+export const invite = api
+  .post('/invites')
+  .body(z.object({ email: z.email() }))
+  .dependsOn([emails])
+  .handle(async ({ body, services }) => {
+    // `type` is the queue's name exactly as written
+    await services.emails.publish([
+      { type: 'Emails', payload: { to: body.email, template: 'welcome' } },
+    ]);
   });
 ```
 
@@ -344,99 +370,69 @@ export const getHealth = router
   .handle(async () => ({ status: 'ok' }));
 ```
 
-### Service Discovery
+### Dependencies
 
-Inject services into your constructs:
+`.dependsOn([...])` takes constructs. Each one's client lands in the handler's
+`services` under the construct's own id, and the edge is what the manifest
+records — so the environment, the runtime client and the cloud access all come
+from the one line:
 
 ```typescript
 import { api } from '../constructs/api';
-import type { Service } from '@geekmidas/services';
-import type { EnvironmentParser } from '@geekmidas/envkit';
-import { Kysely } from 'kysely';
+import { database } from '../constructs/database';
 import { z } from 'zod';
 
-// Define a database service
-const databaseService = {
-  serviceName: 'database' as const,
-  async register(envParser: EnvironmentParser<{}>) {
-    const config = envParser.create((get) => ({
-      url: get('DATABASE_URL').string()
-    })).parse();
-
-    const db = new Kysely({ /* config */ });
-    return db;
-  }
-} satisfies Service<'database', Kysely<Database>>;
-
-// Use service in endpoint
 export const getUserFromDb = api
   .get('/users/:id')
   .params(z.object({ id: z.string() }))
-  .services([databaseService])
+  .dependsOn([database])
   .handle(async ({ params, services }) => {
-    // services.database is fully typed
-    const user = await services.database
+    // services.database is a Kysely client typed by the construct's schema
+    return services.database
       .selectFrom('users')
       .where('id', '=', params.id)
       .selectAll()
       .executeTakeFirst();
-
-    return user;
   });
 ```
 
+A hand-written `Service` still works through `.services()` on every builder,
+for code that has not moved to a construct yet. It records no edge, so a deploy
+target cannot grant it anything.
+
 ### Event Publishing
 
-Publish events from any construct:
+An endpoint, function or cron publishes to a topic with `.event(topic, …)`,
+once its handler has succeeded:
 
 ```typescript
-import { api } from '../constructs/api';
-import type { Service } from '@geekmidas/services';
-import type { EventPublisher, PublishableMessage } from '@geekmidas/events';
-import { z } from 'zod';
+import { users } from '../constructs/topics';
 
-// Define event types
-type UserEvents =
-  | PublishableMessage<'user.created', { userId: string; email: string }>
-  | PublishableMessage<'user.updated', { userId: string }>;
-
-// Create event publisher service
-const userEventPublisher = {
-  serviceName: 'userEventPublisher' as const,
-  async register(envParser: EnvironmentParser<{}>) {
-    const config = envParser.create((get) => ({
-      publisherUrl: get('EVENT_PUBLISHER_URL').string()
-    })).parse();
-
-    const { Publisher } = await import('@geekmidas/events');
-    return Publisher.fromConnectionString<UserEvents>(config.publisherUrl);
-  }
-} satisfies Service<'userEventPublisher', EventPublisher<UserEvents>>;
-
-// Use in endpoint with event publishing
-export const createUser = api
+export const createUser = router
   .post('/users')
-  .body(z.object({
-    name: z.string(),
-    email: z.email()
-  }))
-  .publisher(userEventPublisher)
-  .event('user.created', (body, result) => ({
-    userId: result.id,
-    email: body.email
-  }))
-  .handle(async ({ body, publish }) => {
-    const user = {
-      id: crypto.randomUUID(),
-      name: body.name,
-      email: body.email
-    };
-
-    // Events are automatically published after successful execution
-    return user;
-  });
+  .body(z.object({ name: z.string(), email: z.email() }))
+  .output(z.object({ id: z.string(), name: z.string(), email: z.email() }))
+  .event(users, {
+    type: 'user.created',
+    payload: (user) => ({ userId: user.id, email: user.email }),
+    when: (user) => !user.email.endsWith('@example.com'), // optional
+  })
+  .handle(async ({ body }) => ({ id: crypto.randomUUID(), ...body }));
 ```
 
+- `type` is checked against the topic's events, and `payload` against that
+  event's schema.
+- `.event()` is repeatable across topics. Two calls to two topics publish to
+  each, every event through its own topic's publisher.
+- It also puts the topic's publisher in the handler as `services.users`, as
+  `.dependsOn([users])` would, for events the handler decides on:
+  `await services.users.publish([{ type: 'user.updated', payload }])`.
+- A failed publish is logged, never thrown — the handler already succeeded.
+
+The publisher reads `USERS_PUBLISHER_CONNECTION_STRING`, which only constructs
+that publish to the topic are given, and picks its transport from the protocol:
+`pgboss://` locally, `sns://` deployed.
+
 ### Database Context
 
 Inject a database instance directly into the handler context using `.database()`:
@@ -633,10 +629,11 @@ For complex scenarios, use `ctx.auditor` to record audits manually within your h
 
 ```typescript
 export const processOrder = api
-  .post('/orders')
-  .database(databaseService)
-  .services([paymentService])
+  .database(database)
   .auditor(auditStorageService)
+  .post('/orders')
+  // `payments` is an ExternalApi whose client has `charge()`
+  .dependsOn([payments])
   .actor(({ session }) => ({ id: session.userId, type: 'user' }))
   .handle(async ({ body, db, services, auditor }) => {
     // db is automatically the transaction when auditor uses KyselyAuditStorage
@@ -647,7 +644,7 @@ export const processOrder = api
       .executeTakeFirstOrThrow();
 
     // Manual audit for payment (external service call)
-    const payment = await services.payment.charge(order.total);
+    const payment = await services.payments.charge(order.total);
     auditor.audit('payment.processed', {
       orderId: order.id,
       amount: order.total,
@@ -1097,19 +1094,19 @@ Every construct has an async `getEnvironment()` method that returns the environm
 
 ```typescript
 import { api } from '../constructs/api';
-import { databaseService } from './services/database';
-import { cacheService } from './services/cache';
+import { cache } from '../constructs/cache';
+import { database } from '../constructs/database';
 
 const endpoint = api
   .get('/users')
-  .services([databaseService, cacheService])
+  .dependsOn([database, cache])
   .handle(async ({ services }) => {
     // Implementation
   });
 
 // Detect required environment variables
 const envVars = await endpoint.getEnvironment();
-// Returns: ['CACHE_URL', 'DATABASE_URL'] (sorted alphabetically)
+// Returns: ['DATABASE_URL', 'SESSIONS_URL'] (sorted alphabetically)
 ```
 
 ### How It Works
@@ -1197,33 +1194,37 @@ This manifest can then be used by infrastructure-as-code tools (Terraform, CDK,
 - **Deduplication**: Each variable listed once even if used by multiple services
 - **Sorted Output**: Variables always returned in alphabetical order
 - **Error Resilient**: Parse failures don't affect detection
-- **Publisher Support**: Detects variables from `.publisher()` services
+- **Topic Support**: A topic named by `.event(topic, …)` contributes its `<ID>_PUBLISHER_CONNECTION_STRING`
 
 ### Example with Multiple Services
 
 ```typescript
 import { api } from '../constructs/api';
-import { databaseService } from './services/database';
-import { cacheService } from './services/cache';
-import { emailService } from './services/email';
+import { cache } from '../constructs/cache';
+import { database } from '../constructs/database';
+import { mail } from '../constructs/email';
+import { users } from '../constructs/topics';
 
 const endpoint = api
   .post('/users')
-  .services([databaseService, cacheService, emailService])
+  .dependsOn([database, cache, mail])
+  .output(userSchema)
+  .event(users, {
+    type: 'user.created',
+    payload: (user) => ({ userId: user.id, email: user.email }),
+  })
   .handle(async ({ services }) => {
     // Create user
   });
 
-// Automatically detects all variables from all services
+// Detects the keys of every construct it names
 const envVars = await endpoint.getEnvironment();
 // Returns: [
-//   'CACHE_URL',
 //   'DATABASE_URL',
-//   'DATABASE_PORT',
-//   'SMTP_HOST',
-//   'SMTP_PORT',
-//   'SMTP_USER',
-//   'SMTP_PASS'
+//   'MAIL_FROM',
+//   'MAIL_URL',
+//   'SESSIONS_URL',
+//   'USERS_PUBLISHER_CONNECTION_STRING'
 // ]
 ```
 

package/dist/{Construct-Detz65RA.mjs → Construct-BO1X-kt9.mjs}

@@ -88,7 +88,6 @@ var Construct = class {
 	logger;
 	services;
 	events;
-	publisherService;
 	outputSchema;
 	timeout;
 	memorySize;
@@ -109,12 +108,11 @@ var Construct = class {
 	* still how `c`, `s` and `f` work.
 	*/
 	owner;
-	constructor(type, logger, services, events = [], publisherService, outputSchema, timeout, memorySize, auditorStorageService, constructs = []) {
+	constructor(type, logger, services, events = [], outputSchema, timeout, memorySize, auditorStorageService, constructs = []) {
 		this.type = type;
 		this.logger = logger;
 		this.services = services;
 		this.events = events;
-		this.publisherService = publisherService;
 		this.outputSchema = outputSchema;
 		this.timeout = timeout;
 		this.memorySize = memorySize;
@@ -150,8 +148,7 @@ var Construct = class {
 		const optionalVars = /* @__PURE__ */ new Set();
 		const services = (0, import_lodash_compact.default)([
 			...this.services,
-			this.publisherService,
-			this.publisherService,
+			...this.events.map(({ topic }) => topic),
 			this.auditorStorageService,
 			this.databaseService
 		]);
@@ -221,4 +218,4 @@ async function sniffService(service) {
 //#endregion
 export { __commonJSMin as a, snifferContext as i, ConstructType as n, __toESM as o, sniffService as r, Construct as t };
 
-//# sourceMappingURL=Construct-Detz65RA.mjs.map
+//# sourceMappingURL=Construct-BO1X-kt9.mjs.map

package/dist/Construct-BO1X-kt9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-BO1X-kt9.mjs","names":["compact"],"sources":["../../../node_modules/.pnpm/lodash.compact@3.0.1/node_modules/lodash.compact/index.js","../src/Construct.ts"],"sourcesContent":["/**\n * lodash 3.0.1 (Custom Build) <https://lodash.com/>\n * Build: `lodash modularize exports=\"npm\" -o ./`\n * Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/>\n * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>\n * Copyright 2009-2016 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors\n * Available under MIT license <https://lodash.com/license>\n */\n\n/**\n * Creates an array with all falsey values removed. The values `false`, `null`,\n * `0`, `\"\"`, `undefined`, and `NaN` are falsey.\n *\n * @static\n * @memberOf _\n * @category Array\n * @param {Array} array The array to compact.\n * @returns {Array} Returns the new array of filtered values.\n * @example\n *\n * _.compact([0, 1, false, 2, '', 3]);\n * // => [1, 2, 3]\n */\nfunction compact(array) {\n  var index = -1,\n      length = array ? array.length : 0,\n      resIndex = 0,\n      result = [];\n\n  while (++index < length) {\n    var value = array[index];\n    if (value) {\n      result[resIndex++] = value;\n    }\n  }\n  return result;\n}\n\nmodule.exports = compact;\n","import type { AuditStorage } from '@geekmidas/audit';\nimport {\n\tSnifferEnvironmentParser,\n\ttype SniffResult,\n\tsniffWithFireAndForget,\n} from '@geekmidas/envkit/sniffer';\nimport type { Logger } from '@geekmidas/logger';\nimport type { Service, ServiceContext } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport compact from 'lodash.compact';\nimport type { TopicEvent } from './publisher';\n\n// Cache for service environment variables to handle singleton services\n// Stores both the full list and the optional subset so the same sniff result\n// can satisfy both getEnvironment() and getEnvironment({ markOptional: true }).\nconst serviceEnvCache = new Map<\n\tService,\n\t{ envVars: string[]; optionalEnvVars: string[] }\n>();\n\n/**\n * Noop context for environment sniffing.\n * Used when calling service.register() to detect env vars without a real request.\n * Returns dummy values since services should only use context in instance methods,\n * not during registration.\n */\nconst snifferContext: ServiceContext = {\n\tgetLogger() {\n\t\t// Return a noop logger for sniffing - services shouldn't log during registration\n\t\treturn {\n\t\t\tdebug: () => {},\n\t\t\tinfo: () => {},\n\t\t\twarn: () => {},\n\t\t\terror: () => {},\n\t\t\tchild: () => snifferContext.getLogger(),\n\t\t} as unknown as Logger;\n\t},\n\tgetRequestId() {\n\t\treturn 'sniffer-context';\n\t},\n\tgetRequestStartTime() {\n\t\treturn Date.now();\n\t},\n\thasContext() {\n\t\treturn false;\n\t},\n};\n\nexport abstract class Construct<\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTAuditStorageServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTDatabaseServiceName extends string = string,\n\tTDatabase = unknown,\n> {\n\t/** Database service for this construct (used by Endpoint for RLS/audit context) */\n\tpublic databaseService?: Service<TDatabaseServiceName, TDatabase>;\n\n\t/**\n\t * The deploy unit that runs this, by construct id.\n\t *\n\t * What an endpoint's `surface` is to it, and for the same reason: something\n\t * has to say which process a runnable belongs to, and until this existed the\n\t * only thing that said so was the directory its file sat in. Set by the\n\t * factory it was built from — `worker.crons`, `api.get(…)` — so it is\n\t * carried rather than configured.\n\t *\n\t * Undefined for a construct built from a free-standing builder, which is\n\t * still how `c`, `s` and `f` work.\n\t */\n\tpublic owner?: string;\n\n\tconstructor(\n\t\tpublic readonly type: ConstructType,\n\t\tpublic readonly logger: TLogger,\n\t\tpublic readonly services: TServices,\n\t\t/**\n\t\t * What this construct publishes once its handler succeeds — each event\n\t\t * bound to its own topic, so a construct publishes to as many as it names.\n\t\t */\n\t\tpublic readonly events: TopicEvent[] = [],\n\t\tpublic outputSchema?: OutSchema,\n\t\tpublic readonly timeout?: number,\n\t\tpublic readonly memorySize?: number,\n\t\tpublic readonly auditorStorageService?: Service<\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditStorage\n\t\t>,\n\t\t/**\n\t\t * The constructs this one declared an edge to, by id.\n\t\t *\n\t\t * What the manifest records. `services` is the same information in the\n\t\t * form a handler runs with — clients, keyed by name — and an id cannot be\n\t\t * recovered from one of those reliably, so both are kept.\n\t\t *\n\t\t * Last in the list because every other parameter is positional and already\n\t\t * spoken for; a new one anywhere else silently rebinds existing callers.\n\t\t */\n\t\tpublic readonly constructs: string[] = [],\n\t) {}\n\n\t/**\n\t * Returns an array of environment variable names required by this construct's services.\n\t * This is determined by running a \"sniffer\" EnvironmentParser through each service's\n\t * register method to track which environment variables are accessed.\n\t *\n\t * Results are cached per service class to handle singleton patterns where\n\t * subsequent register() calls may short-circuit and not access env vars.\n\t *\n\t * @param markOptional - When true, optional vars (those accessed via `.optional()` or\n\t *   `.default()`) are suffixed with `?` in the returned array (e.g. `'PORT?'`).\n\t * @returns Promise that resolves to array of environment variable names, sorted alphabetically\n\t *\n\t * @example\n\t * ```typescript\n\t * const endpoint = e\n\t *   .services([databaseService, authService])\n\t *   .get('/users')\n\t *   .handle(async () => []);\n\t *\n\t * await endpoint.getEnvironment();               // ['AUTH_SECRET', 'DATABASE_URL']\n\t * await endpoint.getEnvironment({ markOptional: true }); // ['AUTH_SECRET', 'DATABASE_URL', 'PORT?']\n\t * ```\n\t */\n\tasync getEnvironment(\n\t\topts: { markOptional?: boolean } = {},\n\t): Promise<string[]> {\n\t\tconst { markOptional = false } = opts;\n\t\tconst envVars = new Set<string>();\n\t\tconst optionalVars = new Set<string>();\n\t\tconst services: Service[] = compact([\n\t\t\t...this.services,\n\t\t\t// Each topic an event names is a dependency like any other.\n\t\t\t...this.events.map(({ topic }) => topic),\n\t\t\tthis.auditorStorageService,\n\t\t\tthis.databaseService,\n\t\t]);\n\n\t\ttry {\n\t\t\tfor (const service of services) {\n\t\t\t\t// Check cache first - handles singleton services that short-circuit\n\t\t\t\tif (serviceEnvCache.has(service)) {\n\t\t\t\t\tconst cached = serviceEnvCache.get(service)!;\n\t\t\t\t\tcached.envVars.forEach((v) => envVars.add(v));\n\t\t\t\t\tcached.optionalEnvVars.forEach((v) => optionalVars.add(v));\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Use sniffService to properly handle all error scenarios\n\t\t\t\tconst result = await sniffService(service);\n\n\t\t\t\t// Log any issues for debugging\n\t\t\t\tif (result.error) {\n\t\t\t\t\tthis.logger.warn(\n\t\t\t\t\t\t{ error: result.error.message, service: service.serviceName },\n\t\t\t\t\t\t'Service threw error during env sniffing (env vars still captured)',\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (result.unhandledRejections.length > 0) {\n\t\t\t\t\tthis.logger.warn(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\terrors: result.unhandledRejections.map((e) => e.message),\n\t\t\t\t\t\t\tservice: service.serviceName,\n\t\t\t\t\t\t},\n\t\t\t\t\t\t'Fire-and-forget rejections during env sniffing (suppressed)',\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// Cache and collect env vars (both required and optional)\n\t\t\t\tserviceEnvCache.set(service, {\n\t\t\t\t\tenvVars: result.envVars,\n\t\t\t\t\toptionalEnvVars: result.optionalEnvVars,\n\t\t\t\t});\n\t\t\t\tresult.envVars.forEach((v) => envVars.add(v));\n\t\t\t\tresult.optionalEnvVars.forEach((v) => optionalVars.add(v));\n\t\t\t}\n\n\t\t\tconst sorted = Array.from(envVars).sort();\n\t\t\tif (!markOptional || optionalVars.size === 0) return sorted;\n\t\t\treturn sorted.map((v) => (optionalVars.has(v) ? `${v}?` : v));\n\t\t} catch (error) {\n\t\t\tthis.logger.error(\n\t\t\t\t{ error },\n\t\t\t\t'Error determining environment variables for construct',\n\t\t\t);\n\n\t\t\treturn [];\n\t\t}\n\t}\n}\n\nexport enum ConstructType {\n\tCron = 'dev.geekmidas.function.cron',\n\tEndpoint = 'dev.geekmidas.function.endpoint',\n\tFunction = 'dev.geekmidas.function.function',\n\tSubscriber = 'dev.geekmidas.function.subscriber',\n\tQueue = 'dev.geekmidas.function.queue',\n\tTopic = 'dev.geekmidas.resource.topic',\n}\n\n/**\n * Utility to test sniffing a service for environment variables.\n * Useful for debugging services that throw errors during sniffing.\n *\n * @example\n * ```typescript\n * import { sniffService } from '@geekmidas/constructs';\n * import { authService } from './services/AuthService';\n *\n * const result = await sniffService(authService);\n * console.log('Env vars:', result.envVars);\n * console.log('Error:', result.error);\n * ```\n */\nexport async function sniffService(service: Service): Promise<SniffResult> {\n\tconst sniffer = new SnifferEnvironmentParser();\n\n\treturn sniffWithFireAndForget(sniffer, () =>\n\t\tservice.register({\n\t\t\tenvParser: sniffer as any,\n\t\t\tcontext: snifferContext,\n\t\t}),\n\t);\n}\n\n// Export for testing\nexport { snifferContext };\n"],"x_google_ignoreList":[0],"mappings":"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"}