@geekmidas/constructs 10.0.0-alpha.3 → 10.0.0-alpha.31

package/README.md

@@ -26,7 +26,7 @@ pnpm add @geekmidas/constructs
 
 ```typescript
 // The HTTP surface. Endpoints are built from it — `api.get(…)`, or
-// `api.endpoints` for a branch that a group of endpoints shares.
+// `api.database(db)` for a branch that a group of endpoints shares.
 import { RestApi } from '@geekmidas/constructs/rest-api';
 
 // Endpoint internals: the factory a surface hands you, and the builder it
@@ -57,6 +57,7 @@ import { RestApi } from '@geekmidas/constructs/rest-api';
 import { logger } from './logger';
 
 export const api = new RestApi('Api', {
+  path: 'apps/api',
   // Required, and `'none'` is a valid answer that has to be typed out. An API
   // that ships open because a field was left off is the one default worth
   // refusing to have.
@@ -288,7 +289,7 @@ For custom authentication methods, use `.securitySchemes()` on the surface's fac
 ```typescript
 import { api } from '../constructs/api';
 
-const router = api.endpoints
+const router = api
   .securitySchemes({
     // Custom OAuth2 with specific flows
     oauth2: {
@@ -327,7 +328,7 @@ Set a default authorizer for every endpoint built from one branch:
 // A branch of the surface's factory, with a default every endpoint on it
 // inherits. (The surface's own `default` does the same thing for every
 // endpoint it serves — this narrows it for one group.)
-const router = api.endpoints.authorizer('jwt');
+const router = api.authorizer('jwt');
 
 // Protected by default
 export const getProfile = router
@@ -907,6 +908,54 @@ export const sendMessage = api
   });
 ```
 
+## Feature Tests
+
+A feature test drives an app the way it runs deployed: a browser signs in and
+calls the API, the API asks the auth server who is calling, each over its URL,
+and every database is in its own transaction, rolled back after the test.
+Nothing runs as a server — each URL an app's constructs answer on is served
+in-process through MSW, from the real handler, for the test that made the
+request. Postgres, Mailpit and MinIO are the real local ones `gkm test` starts.
+
+Nothing is declared in test code. `gkm test` writes `.gkm/test/` into each app:
+
+- `manifest.json` — which construct and endpoint is exported where, and the
+  test stage's environment, keyed as the constructs derive their keys;
+- `clients/<surface>.ts` — each surface's typed client, from the same generator
+  `gkm build` uses;
+- `index.ts` — a `Browser` with a client per surface (`Api` → `browser.api`)
+  and per auth server (`browser.auth`, its better-auth plugins paired with
+  their client plugins), and the configured `it`.
+
+Map it once in the app's `package.json` — `"imports": { "#test":
+"./.gkm/test/index.ts" }` — and a test is:
+
+```typescript
+import { it } from '#test';
+
+it('shows the signed-in user their profile', async ({ browser, mailbox }) => {
+  await browser.auth.signIn.magicLink({ email: 'ada@shop.test' });
+  await browser.visit((await mailbox('ada@shop.test').last()).link!);
+
+  expect(await browser.api.get('/profile')).toMatchObject({ email: 'ada@shop.test' });
+});
+```
+
+- **`browser`** — already the global `fetch`; its cookie jar follows the
+  browser's rules, so a session cookie set for the wrong domain never reaches
+  the API.
+- **`db`** — the transaction of the database the endpoints name, typed by its
+  schema.
+- **`mailbox(address)`** — the mail actually sent, read from Mailpit.
+- **`published(topic | queue)`** — what the test published or enqueued.
+  Nothing is delivered: a subscriber or a worker is run on its own with
+  **`subscriber(s).invoke({ events })`** / **`queue(q).invoke({ messages })`**,
+  on the test's services and transactions.
+- Each database construct — the app's and each schema tenant — gets its own
+  transaction on its own connection, as deployed.
+- A request that belongs to no running test is refused with
+  `UnknownTestContext` rather than reaching another test's data.
+
 ## AWS Lambda Adapters
 
 Deploy your constructs to AWS Lambda:

package/dist/{Construct-Ct8nalEi.d.mts → Construct-DTqYvkPG.d.cts}

@@ -1,12 +1,10 @@
-import { SniffResult } from "@geekmidas/envkit/sniffer";
-import { Service, ServiceContext } from "@geekmidas/services";
-import { AuditStorage } from "@geekmidas/audit";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
 import { EventPublisher, MappedEvent } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
+import { Service, ServiceContext } from "@geekmidas/services";
+import { AuditStorage } from "@geekmidas/audit";
+import { SniffResult } from "@geekmidas/envkit/sniffer";
 //#region src/Construct.d.ts
-
 /**
  * Noop context for environment sniffing.
  * Used when calling service.register() to detect env vars without a real request.
@@ -19,11 +17,11 @@ declare abstract class Construct<TLogger extends Logger = Logger, TServiceName e
   readonly logger: TLogger;
   readonly services: TServices;
   readonly events: MappedEvent<T, any>[];
-  readonly publisherService?: Service<TServiceName, T> | undefined;
+  readonly publisherService?: Service<TServiceName, T>;
   outputSchema?: OutSchema | undefined;
   readonly timeout?: number | undefined;
   readonly memorySize?: number | undefined;
-  readonly auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage> | undefined;
+  readonly auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>;
   /**
    * The constructs this one declared an edge to, by id.
    *
@@ -43,14 +41,14 @@ declare abstract class Construct<TLogger extends Logger = Logger, TServiceName e
    * What an endpoint's `surface` is to it, and for the same reason: something
    * has to say which process a runnable belongs to, and until this existed the
    * only thing that said so was the directory its file sat in. Set by the
-   * factory it was built from — `worker.crons`, `api.endpoints` — so it is
+   * factory it was built from — `worker.crons`, `api.get(…)` — so it is
    * carried rather than configured.
    *
    * Undefined for a construct built from a free-standing builder, which is
    * still how `c`, `s` and `f` work.
    */
   owner?: string;
-  constructor(type: ConstructType, logger: TLogger, services: TServices, events?: MappedEvent<T, any>[], publisherService?: Service<TServiceName, T> | undefined, outputSchema?: OutSchema | undefined, timeout?: number | undefined, memorySize?: number | undefined, auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage> | undefined,
+  constructor(type: ConstructType, logger: TLogger, services: TServices, events?: MappedEvent<T, any>[], publisherService?: Service<TServiceName, T>, outputSchema?: OutSchema | undefined, timeout?: number | undefined, memorySize?: number | undefined, auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>,
   /**
    * The constructs this one declared an edge to, by id.
    *
@@ -95,7 +93,7 @@ declare enum ConstructType {
   Function = "dev.geekmidas.function.function",
   Subscriber = "dev.geekmidas.function.subscriber",
   Queue = "dev.geekmidas.function.queue",
-  Topic = "dev.geekmidas.resource.topic",
+  Topic = "dev.geekmidas.resource.topic"
 }
 /**
  * Utility to test sniffing a service for environment variables.
@@ -113,5 +111,5 @@ declare enum ConstructType {
  */
 declare function sniffService(service: Service): Promise<SniffResult>;
 //#endregion
-export { Construct, ConstructType, sniffService, snifferContext };
-//# sourceMappingURL=Construct-Ct8nalEi.d.mts.map
+export { snifferContext as i, ConstructType as n, sniffService as r, Construct as t };
+//# sourceMappingURL=Construct-DTqYvkPG.d.cts.map

package/dist/Construct-DTqYvkPG.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-DTqYvkPG.d.cts","names":[],"sources":["../src/Construct.ts"],"mappings":";;;;;;;;;;;;;cA0BM,gBAAgB;uBAsBA,UACrB,gBAAgB,SAAS,QACzB,sCACA,UAAU,6CACV,kBAAkB,0CAClB,kBAAkB,gBAClB,kDACA,sBAAsB,sCACtB,8CACA;WAoBiB,MAAM;WACN,QAAQ;WACR,UAAU;WACV,QAAQ,YAAY;WACpB,mBAAmB,QAAQ,cAAc;EAClD,eAAe;WACN;WACA;WACA,wBAAwB,QACvC,0BACA;;;;;;;;;;;WAYe;;EAvCV,kBAAkB,QAAQ,sBAAsB;;;;;;;;;;;;;EAchD;EAEP,YACiB,MAAM,eACN,QAAQ,SACR,UAAU,WACV,SAAQ,YAAY,WACpB,mBAAmB,QAAQ,cAAc,IAClD,eAAe,uBACN,8BACA,iCACA,wBAAwB,QACvC,0BACA,gBAYe;;;;;;;;;;;EAAA;;;;;;;;;;;;;;;;;;;;;;;;EA0BX,eACL;IAAQ;MACN;;aAiEQ;EACX;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;;;;iBAiBqB,aAAa,SAAS,UAAU,QAAQ"}

package/dist/{Construct-BD5neF7w.mjs → Construct-Detz65RA.mjs}

@@ -1,15 +1,12 @@
 import { SnifferEnvironmentParser, sniffWithFireAndForget } from "@geekmidas/envkit/sniffer";
-
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function() {
-	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -20,14 +17,13 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
-
 //#endregion
-//#region ../../node_modules/.pnpm/lodash.compact@3.0.1/node_modules/lodash.compact/index.js
-var require_lodash = __commonJS({ "../../node_modules/.pnpm/lodash.compact@3.0.1/node_modules/lodash.compact/index.js"(exports, module) {
+//#region src/Construct.ts
+var import_lodash_compact = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
 	/**
 	* lodash 3.0.1 (Custom Build) <https://lodash.com/>
 	* Build: `lodash modularize exports="npm" -o ./`
@@ -50,7 +46,7 @@ var require_lodash = __commonJS({ "../../node_modules/.pnpm/lodash.compact@3.0.1
 	* _.compact([0, 1, false, 2, '', 3]);
 	* // => [1, 2, 3]
 	*/
-	function compact$1(array) {
+	function compact(array) {
 		var index = -1, length = array ? array.length : 0, resIndex = 0, result = [];
 		while (++index < length) {
 			var value = array[index];
@@ -58,12 +54,8 @@ var require_lodash = __commonJS({ "../../node_modules/.pnpm/lodash.compact@3.0.1
 		}
 		return result;
 	}
-	module.exports = compact$1;
-} });
-
-//#endregion
-//#region src/Construct.ts
-var import_lodash = __toESM(require_lodash(), 1);
+	module.exports = compact;
+})))(), 1);
 const serviceEnvCache = /* @__PURE__ */ new Map();
 /**
 * Noop context for environment sniffing.
@@ -92,6 +84,16 @@ const snifferContext = {
 	}
 };
 var Construct = class {
+	type;
+	logger;
+	services;
+	events;
+	publisherService;
+	outputSchema;
+	timeout;
+	memorySize;
+	auditorStorageService;
+	constructs;
 	/** Database service for this construct (used by Endpoint for RLS/audit context) */
 	databaseService;
 	/**
@@ -100,7 +102,7 @@ var Construct = class {
 	* What an endpoint's `surface` is to it, and for the same reason: something
 	* has to say which process a runnable belongs to, and until this existed the
 	* only thing that said so was the directory its file sat in. Set by the
-	* factory it was built from — `worker.crons`, `api.endpoints` — so it is
+	* factory it was built from — `worker.crons`, `api.get(…)` — so it is
 	* carried rather than configured.
 	*
 	* Undefined for a construct built from a free-standing builder, which is
@@ -146,7 +148,7 @@ var Construct = class {
 		const { markOptional = false } = opts;
 		const envVars = /* @__PURE__ */ new Set();
 		const optionalVars = /* @__PURE__ */ new Set();
-		const services = (0, import_lodash.default)([
+		const services = (0, import_lodash_compact.default)([
 			...this.services,
 			this.publisherService,
 			this.publisherService,
@@ -186,14 +188,14 @@ var Construct = class {
 		}
 	}
 };
-let ConstructType = /* @__PURE__ */ function(ConstructType$1) {
-	ConstructType$1["Cron"] = "dev.geekmidas.function.cron";
-	ConstructType$1["Endpoint"] = "dev.geekmidas.function.endpoint";
-	ConstructType$1["Function"] = "dev.geekmidas.function.function";
-	ConstructType$1["Subscriber"] = "dev.geekmidas.function.subscriber";
-	ConstructType$1["Queue"] = "dev.geekmidas.function.queue";
-	ConstructType$1["Topic"] = "dev.geekmidas.resource.topic";
-	return ConstructType$1;
+let ConstructType = /* @__PURE__ */ function(ConstructType) {
+	ConstructType["Cron"] = "dev.geekmidas.function.cron";
+	ConstructType["Endpoint"] = "dev.geekmidas.function.endpoint";
+	ConstructType["Function"] = "dev.geekmidas.function.function";
+	ConstructType["Subscriber"] = "dev.geekmidas.function.subscriber";
+	ConstructType["Queue"] = "dev.geekmidas.function.queue";
+	ConstructType["Topic"] = "dev.geekmidas.resource.topic";
+	return ConstructType;
 }({});
 /**
 * Utility to test sniffing a service for environment variables.
@@ -216,7 +218,7 @@ async function sniffService(service) {
 		context: snifferContext
 	}));
 }
-
 //#endregion
-export { Construct, ConstructType, __commonJS, __toESM, sniffService, snifferContext };
-//# sourceMappingURL=Construct-BD5neF7w.mjs.map
+export { __commonJSMin as a, snifferContext as i, ConstructType as n, __toESM as o, sniffService as r, Construct as t };
+
+//# sourceMappingURL=Construct-Detz65RA.mjs.map

package/dist/Construct-Detz65RA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-Detz65RA.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 { EventPublisher, MappedEvent } from '@geekmidas/events';\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';\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\tTServiceName extends string = string,\n\tT extends EventPublisher<any> | undefined = undefined,\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\tpublic readonly events: MappedEvent<T, any>[] = [],\n\t\tpublic readonly publisherService?: Service<TServiceName, T>,\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\tthis.publisherService,\n\t\t\tthis.publisherService,\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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"}

package/dist/{Construct-C0ijr2qp.d.cts → Construct-pVadmURD.d.mts}

@@ -1,12 +1,10 @@
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
+import { SniffResult } from "@geekmidas/envkit/sniffer";
 import { EventPublisher, MappedEvent } from "@geekmidas/events";
-import { Logger } from "@geekmidas/logger";
 import { Service, ServiceContext } from "@geekmidas/services";
-import { StandardSchemaV1 } from "@standard-schema/spec";
 import { AuditStorage } from "@geekmidas/audit";
-import { SniffResult } from "@geekmidas/envkit/sniffer";
-
+import { Logger } from "@geekmidas/logger";
 //#region src/Construct.d.ts
-
 /**
  * Noop context for environment sniffing.
  * Used when calling service.register() to detect env vars without a real request.
@@ -19,11 +17,11 @@ declare abstract class Construct<TLogger extends Logger = Logger, TServiceName e
   readonly logger: TLogger;
   readonly services: TServices;
   readonly events: MappedEvent<T, any>[];
-  readonly publisherService?: Service<TServiceName, T> | undefined;
+  readonly publisherService?: Service<TServiceName, T>;
   outputSchema?: OutSchema | undefined;
   readonly timeout?: number | undefined;
   readonly memorySize?: number | undefined;
-  readonly auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage> | undefined;
+  readonly auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>;
   /**
    * The constructs this one declared an edge to, by id.
    *
@@ -43,14 +41,14 @@ declare abstract class Construct<TLogger extends Logger = Logger, TServiceName e
    * What an endpoint's `surface` is to it, and for the same reason: something
    * has to say which process a runnable belongs to, and until this existed the
    * only thing that said so was the directory its file sat in. Set by the
-   * factory it was built from — `worker.crons`, `api.endpoints` — so it is
+   * factory it was built from — `worker.crons`, `api.get(…)` — so it is
    * carried rather than configured.
    *
    * Undefined for a construct built from a free-standing builder, which is
    * still how `c`, `s` and `f` work.
    */
   owner?: string;
-  constructor(type: ConstructType, logger: TLogger, services: TServices, events?: MappedEvent<T, any>[], publisherService?: Service<TServiceName, T> | undefined, outputSchema?: OutSchema | undefined, timeout?: number | undefined, memorySize?: number | undefined, auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage> | undefined,
+  constructor(type: ConstructType, logger: TLogger, services: TServices, events?: MappedEvent<T, any>[], publisherService?: Service<TServiceName, T>, outputSchema?: OutSchema | undefined, timeout?: number | undefined, memorySize?: number | undefined, auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>,
   /**
    * The constructs this one declared an edge to, by id.
    *
@@ -95,7 +93,7 @@ declare enum ConstructType {
   Function = "dev.geekmidas.function.function",
   Subscriber = "dev.geekmidas.function.subscriber",
   Queue = "dev.geekmidas.function.queue",
-  Topic = "dev.geekmidas.resource.topic",
+  Topic = "dev.geekmidas.resource.topic"
 }
 /**
  * Utility to test sniffing a service for environment variables.
@@ -113,5 +111,5 @@ declare enum ConstructType {
  */
 declare function sniffService(service: Service): Promise<SniffResult>;
 //#endregion
-export { Construct, ConstructType, sniffService, snifferContext };
-//# sourceMappingURL=Construct-C0ijr2qp.d.cts.map
+export { snifferContext as i, ConstructType as n, sniffService as r, Construct as t };
+//# sourceMappingURL=Construct-pVadmURD.d.mts.map

package/dist/Construct-pVadmURD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-pVadmURD.d.mts","names":[],"sources":["../src/Construct.ts"],"mappings":";;;;;;;;;;;;;cA0BM,gBAAgB;uBAsBA,UACrB,gBAAgB,SAAS,QACzB,sCACA,UAAU,6CACV,kBAAkB,0CAClB,kBAAkB,gBAClB,kDACA,sBAAsB,sCACtB,8CACA;WAoBiB,MAAM;WACN,QAAQ;WACR,UAAU;WACV,QAAQ,YAAY;WACpB,mBAAmB,QAAQ,cAAc;EAClD,eAAe;WACN;WACA;WACA,wBAAwB,QACvC,0BACA;;;;;;;;;;;WAYe;;EAvCV,kBAAkB,QAAQ,sBAAsB;;;;;;;;;;;;;EAchD;EAEP,YACiB,MAAM,eACN,QAAQ,SACR,UAAU,WACV,SAAQ,YAAY,WACpB,mBAAmB,QAAQ,cAAc,IAClD,eAAe,uBACN,8BACA,iCACA,wBAAwB,QACvC,0BACA,gBAYe;;;;;;;;;;;EAAA;;;;;;;;;;;;;;;;;;;;;;;;EA0BX,eACL;IAAQ;MACN;;aAiEQ;EACX;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;;;;iBAiBqB,aAAa,SAAS,UAAU,QAAQ"}

package/dist/{Construct-CyS3RpTL.cjs → Construct-yG9Sw-5p.cjs}

@@ -1,8 +1,7 @@
-const require_chunk = require('./chunk-DWy1uDak.cjs');
-const __geekmidas_envkit_sniffer = require_chunk.__toESM(require("@geekmidas/envkit/sniffer"));
-
+const require_rolldown_runtime = require("./rolldown-runtime-y5ARvAq5.cjs");
+let _geekmidas_envkit_sniffer = require("@geekmidas/envkit/sniffer");
 //#region ../../node_modules/.pnpm/lodash.compact@3.0.1/node_modules/lodash.compact/index.js
-var require_lodash = require_chunk.__commonJS({ "../../node_modules/.pnpm/lodash.compact@3.0.1/node_modules/lodash.compact/index.js"(exports, module) {
+var require_lodash_compact = /* @__PURE__ */ require_rolldown_runtime.__commonJSMin(((exports, module) => {
 	/**
 	* lodash 3.0.1 (Custom Build) <https://lodash.com/>
 	* Build: `lodash modularize exports="npm" -o ./`
@@ -25,7 +24,7 @@ var require_lodash = require_chunk.__commonJS({ "../../node_modules/.pnpm/lodash
 	* _.compact([0, 1, false, 2, '', 3]);
 	* // => [1, 2, 3]
 	*/
-	function compact$1(array) {
+	function compact(array) {
 		var index = -1, length = array ? array.length : 0, resIndex = 0, result = [];
 		while (++index < length) {
 			var value = array[index];
@@ -33,12 +32,11 @@ var require_lodash = require_chunk.__commonJS({ "../../node_modules/.pnpm/lodash
 		}
 		return result;
 	}
-	module.exports = compact$1;
-} });
-
+	module.exports = compact;
+}));
 //#endregion
 //#region src/Construct.ts
-var import_lodash = require_chunk.__toESM(require_lodash(), 1);
+var import_lodash_compact = /* @__PURE__ */ require_rolldown_runtime.__toESM(require_lodash_compact(), 1);
 const serviceEnvCache = /* @__PURE__ */ new Map();
 /**
 * Noop context for environment sniffing.
@@ -67,6 +65,16 @@ const snifferContext = {
 	}
 };
 var Construct = class {
+	type;
+	logger;
+	services;
+	events;
+	publisherService;
+	outputSchema;
+	timeout;
+	memorySize;
+	auditorStorageService;
+	constructs;
 	/** Database service for this construct (used by Endpoint for RLS/audit context) */
 	databaseService;
 	/**
@@ -75,7 +83,7 @@ var Construct = class {
 	* What an endpoint's `surface` is to it, and for the same reason: something
 	* has to say which process a runnable belongs to, and until this existed the
 	* only thing that said so was the directory its file sat in. Set by the
-	* factory it was built from — `worker.crons`, `api.endpoints` — so it is
+	* factory it was built from — `worker.crons`, `api.get(…)` — so it is
 	* carried rather than configured.
 	*
 	* Undefined for a construct built from a free-standing builder, which is
@@ -121,7 +129,7 @@ var Construct = class {
 		const { markOptional = false } = opts;
 		const envVars = /* @__PURE__ */ new Set();
 		const optionalVars = /* @__PURE__ */ new Set();
-		const services = (0, import_lodash.default)([
+		const services = (0, import_lodash_compact.default)([
 			...this.services,
 			this.publisherService,
 			this.publisherService,
@@ -161,14 +169,14 @@ var Construct = class {
 		}
 	}
 };
-let ConstructType = /* @__PURE__ */ function(ConstructType$1) {
-	ConstructType$1["Cron"] = "dev.geekmidas.function.cron";
-	ConstructType$1["Endpoint"] = "dev.geekmidas.function.endpoint";
-	ConstructType$1["Function"] = "dev.geekmidas.function.function";
-	ConstructType$1["Subscriber"] = "dev.geekmidas.function.subscriber";
-	ConstructType$1["Queue"] = "dev.geekmidas.function.queue";
-	ConstructType$1["Topic"] = "dev.geekmidas.resource.topic";
-	return ConstructType$1;
+let ConstructType = /* @__PURE__ */ function(ConstructType) {
+	ConstructType["Cron"] = "dev.geekmidas.function.cron";
+	ConstructType["Endpoint"] = "dev.geekmidas.function.endpoint";
+	ConstructType["Function"] = "dev.geekmidas.function.function";
+	ConstructType["Subscriber"] = "dev.geekmidas.function.subscriber";
+	ConstructType["Queue"] = "dev.geekmidas.function.queue";
+	ConstructType["Topic"] = "dev.geekmidas.resource.topic";
+	return ConstructType;
 }({});
 /**
 * Utility to test sniffing a service for environment variables.
@@ -185,36 +193,36 @@ let ConstructType = /* @__PURE__ */ function(ConstructType$1) {
 * ```
 */
 async function sniffService(service) {
-	const sniffer = new __geekmidas_envkit_sniffer.SnifferEnvironmentParser();
-	return (0, __geekmidas_envkit_sniffer.sniffWithFireAndForget)(sniffer, () => service.register({
+	const sniffer = new _geekmidas_envkit_sniffer.SnifferEnvironmentParser();
+	return (0, _geekmidas_envkit_sniffer.sniffWithFireAndForget)(sniffer, () => service.register({
 		envParser: sniffer,
 		context: snifferContext
 	}));
 }
-
 //#endregion
-Object.defineProperty(exports, 'Construct', {
-  enumerable: true,
-  get: function () {
-    return Construct;
-  }
+Object.defineProperty(exports, "Construct", {
+	enumerable: true,
+	get: function() {
+		return Construct;
+	}
 });
-Object.defineProperty(exports, 'ConstructType', {
-  enumerable: true,
-  get: function () {
-    return ConstructType;
-  }
+Object.defineProperty(exports, "ConstructType", {
+	enumerable: true,
+	get: function() {
+		return ConstructType;
+	}
 });
-Object.defineProperty(exports, 'sniffService', {
-  enumerable: true,
-  get: function () {
-    return sniffService;
-  }
+Object.defineProperty(exports, "sniffService", {
+	enumerable: true,
+	get: function() {
+		return sniffService;
+	}
 });
-Object.defineProperty(exports, 'snifferContext', {
-  enumerable: true,
-  get: function () {
-    return snifferContext;
-  }
+Object.defineProperty(exports, "snifferContext", {
+	enumerable: true,
+	get: function() {
+		return snifferContext;
+	}
 });
-//# sourceMappingURL=Construct-CyS3RpTL.cjs.map
+
+//# sourceMappingURL=Construct-yG9Sw-5p.cjs.map

package/dist/Construct-yG9Sw-5p.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-yG9Sw-5p.cjs","names":["compact","SnifferEnvironmentParser","sniffWithFireAndForget"],"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 { EventPublisher, MappedEvent } from '@geekmidas/events';\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';\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\tTServiceName extends string = string,\n\tT extends EventPublisher<any> | undefined = undefined,\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\tpublic readonly events: MappedEvent<T, any>[] = [],\n\t\tpublic readonly publisherService?: Service<TServiceName, T>,\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\tthis.publisherService,\n\t\t\tthis.publisherService,\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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"}

package/dist/{Cron-ByxdOfpE.d.mts → Cron-B_iuyNxr.d.mts}

@@ -1,14 +1,25 @@
-import { Function, FunctionHandler } from "./index-CubPzHd9.mjs";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
+import { a as FunctionHandler, r as Function } from "./index-yb3fXNyH.mjs";
+import { EventPublisher } from "@geekmidas/events";
 import { Service } from "@geekmidas/services";
 import { AuditableAction } from "@geekmidas/audit";
-import { EventPublisher } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { ComposableStandardSchema } from "@geekmidas/schema";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
 //#region src/crons/Cron.d.ts
 declare class Cron<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string> extends Function<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>, FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>> {
   protected _schedule?: ScheduleExpression | undefined;
+  /**
+   * Where this cron's schedule lives when a server runs it.
+   *
+   * Carried from the worker that built it, which declared it once with
+   * `.database(db)`. Unread on AWS, where the schedule is an EventBridge rule
+   * and nothing in this process fires anything.
+   *
+   * A service rather than the construct, because what reads it is service
+   * discovery in the generated server — which registers services, and failed
+   * on the construct with `service.register is not a function`.
+   */
+  scheduleStore?: Service<string, unknown>;
   static isCron(obj: any): obj is Cron<any, any, any, any>;
   constructor(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>, timeout?: number, _schedule?: ScheduleExpression | undefined, input?: TInput, outputSchema?: OutSchema, services?: TServices, logger?: TLogger, publisherService?: Service<TEventPublisherServiceName, TEventPublisher>, events?: any[], memorySize?: number, databaseService?: Service<TDatabaseServiceName, TDatabase>,
   /**
@@ -27,5 +38,5 @@ type CronWeekday = '*' | number | `${number}` | `${number}-${number}` | `${numbe
 type CronExpression = `cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;
 type ScheduleExpression = RateExpression | CronExpression;
 //#endregion
-export { Cron, CronExpression, RateExpression, ScheduleExpression };
-//# sourceMappingURL=Cron-ByxdOfpE.d.mts.map
+export { ScheduleExpression as i, CronExpression as n, RateExpression as r, Cron as t };
+//# sourceMappingURL=Cron-B_iuyNxr.d.mts.map

package/dist/Cron-B_iuyNxr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cron-B_iuyNxr.d.mts","names":[],"sources":["../src/crons/Cron.ts"],"mappings":";;;;;;;;cAUa,KACZ,eAAe,kDACf,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,wBAAwB,6CACxB,oDACA,uBACA,sDACS,SACT,QACA,WACA,SACA,WACA,iBACA,+CAGA,WACA,sBACA,kCACA,gBAAgB,QAAQ,WAAW,SAAS,WAAW;YA0B5C,YAAY;;;;;;;;;;;;EAbvB,gBAAgB;SAET,OAAO,WAAW,OAAO;EAQhC,YACC,IAAI,gBAAgB,QAAQ,WAAW,SAAS,WAAW,YAC3D,kBACU,YAAY,gCACtB,QAAQ,QACR,eAAe,WACf,WAAU,WACV,SAAS,SACT,mBAAmB,QAAQ,4BAA4B,kBACvD,gBACA,qBACA,kBAAkB,QAAQ,sBAAsB,YAKhD;;;;;EAAA;MAmBG,YAAY;;KAKL;KAEP;KAUA;KAUA;KAUA;KAqBA;KAiBO,yBACH,cAAc,YAAY,WAAW,aAAa;KAE/C,qBAAqB,iBAAiB"}