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

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

@@ -94,6 +94,19 @@ const snifferContext = {
 var Construct = class {
 	/** Database service for this construct (used by Endpoint for RLS/audit context) */
 	databaseService;
+	/**
+	* The deploy unit that runs this, by construct id.
+	*
+	* 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
+	* carried rather than configured.
+	*
+	* Undefined for a construct built from a free-standing builder, which is
+	* still how `c`, `s` and `f` work.
+	*/
+	owner;
 	constructor(type, logger, services, events = [], publisherService, outputSchema, timeout, memorySize, auditorStorageService, constructs = []) {
 		this.type = type;
 		this.logger = logger;
@@ -206,4 +219,4 @@ async function sniffService(service) {
 
 //#endregion
 export { Construct, ConstructType, __commonJS, __toESM, sniffService, snifferContext };
-//# sourceMappingURL=Construct-CdhThxDI.mjs.map
+//# sourceMappingURL=Construct-BD5neF7w.mjs.map

package/dist/Construct-BD5neF7w.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-BD5neF7w.mjs","names":["compact","snifferContext: ServiceContext","type: ConstructType","logger: TLogger","services: TServices","events: MappedEvent<T, any>[]","publisherService?: Service<TServiceName, T>","outputSchema?: OutSchema","timeout?: number","memorySize?: number","auditorStorageService?: Service<\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditStorage\n\t\t>","constructs: string[]","opts: { markOptional?: boolean }","services: Service[]","service: Service"],"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.endpoints` — 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-WhCXIOPV.d.cts → Construct-C0ijr2qp.d.cts}

@@ -37,6 +37,19 @@ declare abstract class Construct<TLogger extends Logger = Logger, TServiceName e
   readonly constructs: string[];
   /** Database service for this construct (used by Endpoint for RLS/audit context) */
   databaseService?: Service<TDatabaseServiceName, TDatabase>;
+  /**
+   * The deploy unit that runs this, by construct id.
+   *
+   * 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
+   * 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,
   /**
    * The constructs this one declared an edge to, by id.
@@ -101,4 +114,4 @@ declare enum ConstructType {
 declare function sniffService(service: Service): Promise<SniffResult>;
 //#endregion
 export { Construct, ConstructType, sniffService, snifferContext };
-//# sourceMappingURL=Construct-WhCXIOPV.d.cts.map
+//# sourceMappingURL=Construct-C0ijr2qp.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-C0ijr2qp.d.cts","names":[],"sources":["../src/Construct.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAS8D;AAuC9D;;;cAtBM,cAuBoB,EAvBJ,cAuBI;AAEf,uBAHW,SAGX,CAAA,gBAFM,MAEN,GAFe,MAEf,EAAA,qBAAA,MAAA,GAAA,MAAA,EAAA,UAAA,cAAA,CAAA,GAAA,CAAA,GAAA,SAAA,GAAA,SAAA,EAAA,kBACQ,gBADR,GAAA,SAAA,GAAA,SAAA,EAAA,kBAEQ,OAFR,EAAA,GAAA,EAAA,EAAA,iCAAA,MAAA,GAAA,MAAA,EAAA,sBAIY,YAJZ,GAAA,SAAA,GAAA,SAAA,EAAA,6BAAA,MAAA,GAAA,MAAA,EAAA,YAAA,OAAA,CAAA,CAAA;EAAc,SACN,IAAA,EAyBK,aAzBL;EAAgB,SAChB,MAAA,EAyBO,OAzBP;EAAO,SAEH,QAAA,EAwBK,SAxBL;EAAY,SAsBX,MAAA,EAGE,WAHF,CAGc,CAHd,EAAA,GAAA,CAAA,EAAA;EAAa,SACX,gBAAA,CAAA,EAGW,OAHX,CAGmB,YAHnB,EAGiC,CAHjC,CAAA,GAAA,SAAA;EAAO,YACL,CAAA,EAGJ,SAHI,GAAA,SAAA;EAAS,SACC,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAC,SAAb,UAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAW,SACQ,qBAAA,CAAA,EAIH,OAJG,CAK1C,wBAL0C,EAM1C,aAN0C,CAAA,GAAA,SAAA;EAAY;;;;;;;;;;EAJpB,SACX,UAAA,EAAA,MAAA,EAAA;EAAO;EACI,eACC,CAAA,EApBZ,OAoBY,CApBJ,oBAoBI,EApBkB,SAoBlB,CAAA;EAAC;;;;;;;;;AA+C5B;AAiEX;AAuBA;EAAkC,KAAA,CAAA,EAAA,MAAA;EAAA,WAAU,CAAA,IAAA,EA1IpB,aA0IoB,EAAA,MAAA,EAzIlB,OAyIkB,EAAA,QAAA,EAxIhB,SAwIgB,EAAA,MAAA,CAAA,EAvIlB,WAuIkB,CAvIN,CAuIM,EAAA,GAAA,CAAA,EAAA,EAAA,gBAAA,CAAA,EAtIP,OAsIO,CAtIC,YAsID,EAtIe,CAsIf,CAAA,GAAA,SAAA,EAAA,YAAA,CAAA,EArIpB,SAqIoB,GAAA,SAAA,EAAA,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA,EAAA,UAAA,CAAA,EAAA,MAAA,GAAA,SAAA,EAAA,qBAAA,CAAA,EAlIF,OAkIE,CAjIzC,wBAiIyC,EAhIzC,aAgIyC,CAAA,GAAA,SAAA;EAAO;;AAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAxFzD;;aAiEQ,aAAA;;;;;;;;;;;;;;;;;;;;;;iBAuBU,YAAA,UAAsB,UAAU,QAAQ"}

package/dist/{Construct-B-xc0SE9.d.mts → Construct-Ct8nalEi.d.mts}

@@ -37,6 +37,19 @@ declare abstract class Construct<TLogger extends Logger = Logger, TServiceName e
   readonly constructs: string[];
   /** Database service for this construct (used by Endpoint for RLS/audit context) */
   databaseService?: Service<TDatabaseServiceName, TDatabase>;
+  /**
+   * The deploy unit that runs this, by construct id.
+   *
+   * 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
+   * 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,
   /**
    * The constructs this one declared an edge to, by id.
@@ -101,4 +114,4 @@ declare enum ConstructType {
 declare function sniffService(service: Service): Promise<SniffResult>;
 //#endregion
 export { Construct, ConstructType, sniffService, snifferContext };
-//# sourceMappingURL=Construct-B-xc0SE9.d.mts.map
+//# sourceMappingURL=Construct-Ct8nalEi.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-Ct8nalEi.d.mts","names":[],"sources":["../src/Construct.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAS8D;AAuC9D;;;cAtBM,cAuBoB,EAvBJ,cAuBI;AAEf,uBAHW,SAGX,CAAA,gBAFM,MAEN,GAFe,MAEf,EAAA,qBAAA,MAAA,GAAA,MAAA,EAAA,UAAA,cAAA,CAAA,GAAA,CAAA,GAAA,SAAA,GAAA,SAAA,EAAA,kBACQ,gBADR,GAAA,SAAA,GAAA,SAAA,EAAA,kBAEQ,OAFR,EAAA,GAAA,EAAA,EAAA,iCAAA,MAAA,GAAA,MAAA,EAAA,sBAIY,YAJZ,GAAA,SAAA,GAAA,SAAA,EAAA,6BAAA,MAAA,GAAA,MAAA,EAAA,YAAA,OAAA,CAAA,CAAA;EAAc,SACN,IAAA,EAyBK,aAzBL;EAAgB,SAChB,MAAA,EAyBO,OAzBP;EAAO,SAEH,QAAA,EAwBK,SAxBL;EAAY,SAsBX,MAAA,EAGE,WAHF,CAGc,CAHd,EAAA,GAAA,CAAA,EAAA;EAAa,SACX,gBAAA,CAAA,EAGW,OAHX,CAGmB,YAHnB,EAGiC,CAHjC,CAAA,GAAA,SAAA;EAAO,YACL,CAAA,EAGJ,SAHI,GAAA,SAAA;EAAS,SACC,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAC,SAAb,UAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAW,SACQ,qBAAA,CAAA,EAIH,OAJG,CAK1C,wBAL0C,EAM1C,aAN0C,CAAA,GAAA,SAAA;EAAY;;;;;;;;;;EAJpB,SACX,UAAA,EAAA,MAAA,EAAA;EAAO;EACI,eACC,CAAA,EApBZ,OAoBY,CApBJ,oBAoBI,EApBkB,SAoBlB,CAAA;EAAC;;;;;;;;;AA+C5B;AAiEX;AAuBA;EAAkC,KAAA,CAAA,EAAA,MAAA;EAAA,WAAU,CAAA,IAAA,EA1IpB,aA0IoB,EAAA,MAAA,EAzIlB,OAyIkB,EAAA,QAAA,EAxIhB,SAwIgB,EAAA,MAAA,CAAA,EAvIlB,WAuIkB,CAvIN,CAuIM,EAAA,GAAA,CAAA,EAAA,EAAA,gBAAA,CAAA,EAtIP,OAsIO,CAtIC,YAsID,EAtIe,CAsIf,CAAA,GAAA,SAAA,EAAA,YAAA,CAAA,EArIpB,SAqIoB,GAAA,SAAA,EAAA,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA,EAAA,UAAA,CAAA,EAAA,MAAA,GAAA,SAAA,EAAA,qBAAA,CAAA,EAlIF,OAkIE,CAjIzC,wBAiIyC,EAhIzC,aAgIyC,CAAA,GAAA,SAAA;EAAO;;AAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAxFzD;;aAiEQ,aAAA;;;;;;;;;;;;;;;;;;;;;;iBAuBU,YAAA,UAAsB,UAAU,QAAQ"}

package/dist/{Construct-roId57cU.cjs → Construct-CyS3RpTL.cjs}

@@ -69,6 +69,19 @@ const snifferContext = {
 var Construct = class {
 	/** Database service for this construct (used by Endpoint for RLS/audit context) */
 	databaseService;
+	/**
+	* The deploy unit that runs this, by construct id.
+	*
+	* 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
+	* carried rather than configured.
+	*
+	* Undefined for a construct built from a free-standing builder, which is
+	* still how `c`, `s` and `f` work.
+	*/
+	owner;
 	constructor(type, logger, services, events = [], publisherService, outputSchema, timeout, memorySize, auditorStorageService, constructs = []) {
 		this.type = type;
 		this.logger = logger;
@@ -204,4 +217,4 @@ Object.defineProperty(exports, 'snifferContext', {
     return snifferContext;
   }
 });
-//# sourceMappingURL=Construct-roId57cU.cjs.map
+//# sourceMappingURL=Construct-CyS3RpTL.cjs.map

package/dist/Construct-CyS3RpTL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Construct-CyS3RpTL.cjs","names":["compact","snifferContext: ServiceContext","type: ConstructType","logger: TLogger","services: TServices","events: MappedEvent<T, any>[]","publisherService?: Service<TServiceName, T>","outputSchema?: OutSchema","timeout?: number","memorySize?: number","auditorStorageService?: Service<\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditStorage\n\t\t>","constructs: string[]","opts: { markOptional?: boolean }","services: Service[]","service: Service","SnifferEnvironmentParser"],"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.endpoints` — 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBA,SAASA,UAAQ,OAAO;EACtB,IAAI,QAAQ,IACR,SAAS,QAAQ,MAAM,SAAS,GAChC,WAAW,GACX,SAAS,CAAE;AAEf,SAAO,EAAE,QAAQ,QAAQ;GACvB,IAAI,QAAQ,MAAM;AAClB,OAAI,MACF,QAAO,cAAc;EAExB;AACD,SAAO;CACR;AAED,QAAO,UAAUA;;;;;;ACvBjB,MAAM,kCAAkB,IAAI;;;;;;;AAW5B,MAAMC,iBAAiC;CACtC,YAAY;AAEX,SAAO;GACN,OAAO,MAAM,CAAE;GACf,MAAM,MAAM,CAAE;GACd,MAAM,MAAM,CAAE;GACd,OAAO,MAAM,CAAE;GACf,OAAO,MAAM,eAAe,WAAW;EACvC;CACD;CACD,eAAe;AACd,SAAO;CACP;CACD,sBAAsB;AACrB,SAAO,KAAK,KAAK;CACjB;CACD,aAAa;AACZ,SAAO;CACP;AACD;AAED,IAAsB,YAAtB,MAUE;;CAED,AAAO;;;;;;;;;;;;;CAcP,AAAO;CAEP,YACiBC,MACAC,QACAC,UACAC,SAAgC,CAAE,GAClCC,kBACTC,cACSC,SACAC,YACAC,uBAcAC,aAAuB,CAAE,GACxC;EAvBe;EACA;EACA;EACA;EACA;EACT;EACS;EACA;EACA;EAcA;CACb;;;;;;;;;;;;;;;;;;;;;;;;CAyBJ,MAAM,eACLC,OAAmC,CAAE,GACjB;EACpB,MAAM,EAAE,eAAe,OAAO,GAAG;EACjC,MAAM,0BAAU,IAAI;EACpB,MAAM,+BAAe,IAAI;EACzB,MAAMC,WAAsB,2BAAQ;GACnC,GAAG,KAAK;GACR,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;EACL,EAAC;AAEF,MAAI;AACH,QAAK,MAAM,WAAW,UAAU;AAE/B,QAAI,gBAAgB,IAAI,QAAQ,EAAE;KACjC,MAAM,SAAS,gBAAgB,IAAI,QAAQ;AAC3C,YAAO,QAAQ,QAAQ,CAAC,MAAM,QAAQ,IAAI,EAAE,CAAC;AAC7C,YAAO,gBAAgB,QAAQ,CAAC,MAAM,aAAa,IAAI,EAAE,CAAC;AAC1D;IACA;IAGD,MAAM,SAAS,MAAM,aAAa,QAAQ;AAG1C,QAAI,OAAO,MACV,MAAK,OAAO,KACX;KAAE,OAAO,OAAO,MAAM;KAAS,SAAS,QAAQ;IAAa,GAC7D,oEACA;AAEF,QAAI,OAAO,oBAAoB,SAAS,EACvC,MAAK,OAAO,KACX;KACC,QAAQ,OAAO,oBAAoB,IAAI,CAAC,MAAM,EAAE,QAAQ;KACxD,SAAS,QAAQ;IACjB,GACD,8DACA;AAIF,oBAAgB,IAAI,SAAS;KAC5B,SAAS,OAAO;KAChB,iBAAiB,OAAO;IACxB,EAAC;AACF,WAAO,QAAQ,QAAQ,CAAC,MAAM,QAAQ,IAAI,EAAE,CAAC;AAC7C,WAAO,gBAAgB,QAAQ,CAAC,MAAM,aAAa,IAAI,EAAE,CAAC;GAC1D;GAED,MAAM,SAAS,MAAM,KAAK,QAAQ,CAAC,MAAM;AACzC,QAAK,gBAAgB,aAAa,SAAS,EAAG,QAAO;AACrD,UAAO,OAAO,IAAI,CAAC,MAAO,aAAa,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAG;EAC7D,SAAQ,OAAO;AACf,QAAK,OAAO,MACX,EAAE,MAAO,GACT,wDACA;AAED,UAAO,CAAE;EACT;CACD;AACD;AAED,IAAY,0DAAL;AACN;AACA;AACA;AACA;AACA;AACA;;AACA;;;;;;;;;;;;;;;AAgBD,eAAsB,aAAaC,SAAwC;CAC1E,MAAM,UAAU,IAAIC;AAEpB,QAAO,uDAAuB,SAAS,MACtC,QAAQ,SAAS;EAChB,WAAW;EACX,SAAS;CACT,EAAC,CACF;AACD"}

package/dist/Cron-ByxdOfpE.d.mts

@@ -0,0 +1,31 @@
+import { Function, FunctionHandler } from "./index-CubPzHd9.mjs";
+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;
+  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>,
+  /**
+   * The construct ids `.dependsOn()` named — last, so no existing positional
+   * argument moves.
+   */
+  constructs?: string[]);
+  get schedule(): ScheduleExpression | undefined;
+}
+type RateExpression = `rate(${string})`;
+type CronMinute = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
+type CronHour = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
+type CronDay = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
+type CronMonth = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'JAN' | 'FEB' | 'MAR' | 'APR' | 'MAY' | 'JUN' | 'JUL' | 'AUG' | 'SEP' | 'OCT' | 'NOV' | 'DEC' | string;
+type CronWeekday = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | `${string}-${string}` | string;
+type CronExpression = `cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;
+type ScheduleExpression = RateExpression | CronExpression;
+//#endregion
+export { Cron, CronExpression, RateExpression, ScheduleExpression };
+//# sourceMappingURL=Cron-ByxdOfpE.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Cron-ByxdOfpE.d.mts","names":[],"sources":["../src/crons/Cron.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAUa,oBACG,oEACG,gCACF,SAAS,0BACP,kEACM,8KAIf,SACT,QACA,WACA,SACA,WACA,iBACA,+CAGA,WACA,sBACA,kCACA,gBAAgB,QAAQ,WAAW,SAAS,WAAW;wBAahC;EAlCX,OAAI,MAAA,CAAA,GAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAuBgB,IAvBhB,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;EAAA,WAAA,CAAA,EAAA,EAgCX,eAhCW,CAgCK,MAhCL,EAgCa,SAhCb,EAgCwB,OAhCxB,EAgCiC,SAhCjC,EAgC4C,SAhC5C,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAkCO,kBAlCP,GAAA,SAAA,EAAA,KAAA,CAAA,EAmCP,MAnCO,EAAA,YAAA,CAAA,EAoCA,SApCA,EAAA,QAAA,CAAA,EAqCL,SArCK,EAAA,MAAA,CAAA,EAsCN,OAtCM,EAAA,gBAAA,CAAA,EAuCI,OAvCJ,CAuCY,0BAvCZ,EAuCwC,eAvCxC,CAAA,EAAA,MAAA,CAAA,EAAA,GAAA,EAAA,EAAA,UAAA,CAAA,EAAA,MAAA,EAAA,eAAA,CAAA,EA0CG,OA1CH,CA0CW,oBA1CX,EA0CiC,SA1CjC,CAAA;EAAA;;;;EAGe,UACb,CAAA,EAAA,MAAA,EAAA;EAAgB,IACV,QAAA,CAAA,CAAA,EA6DR,kBA7DQ,GAAA,SAAA;;AAMxB,KA4DW,cAAA,GA5DX,QAAA,MAAA,GAAA;KA8DI,UAAA,GA7DJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;KAuEI,QAAA,GAtEJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;KAgFI,OAAA,GA/EJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;KAyFI,SAAA,GAxFJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,MAAA;KA6GI,WAAA,GA1GJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;AACA,KA0HW,cAAA,GA1HX,QA2HQ,UA3HR,IA2HsB,QA3HtB,IA2HkC,OA3HlC,IA2H6C,SA3H7C,IA2H0D,WA3H1D,GAAA;AACA,KA4HW,kBAAA,GAAqB,cA5HhC,GA4HiD,cA5HjD"}

package/dist/Cron-Wqh464aO.d.cts

@@ -0,0 +1,31 @@
+import { Function, FunctionHandler } from "./index-JSf9xNIJ.cjs";
+import { EventPublisher } from "@geekmidas/events";
+import { Logger } from "@geekmidas/logger";
+import { ComposableStandardSchema } from "@geekmidas/schema";
+import { Service } from "@geekmidas/services";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { AuditableAction } from "@geekmidas/audit";
+
+//#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;
+  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>,
+  /**
+   * The construct ids `.dependsOn()` named — last, so no existing positional
+   * argument moves.
+   */
+  constructs?: string[]);
+  get schedule(): ScheduleExpression | undefined;
+}
+type RateExpression = `rate(${string})`;
+type CronMinute = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
+type CronHour = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
+type CronDay = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
+type CronMonth = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'JAN' | 'FEB' | 'MAR' | 'APR' | 'MAY' | 'JUN' | 'JUL' | 'AUG' | 'SEP' | 'OCT' | 'NOV' | 'DEC' | string;
+type CronWeekday = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | `${string}-${string}` | string;
+type CronExpression = `cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;
+type ScheduleExpression = RateExpression | CronExpression;
+//#endregion
+export { Cron, CronExpression, RateExpression, ScheduleExpression };
+//# sourceMappingURL=Cron-Wqh464aO.d.cts.map

package/dist/Cron-Wqh464aO.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cron-Wqh464aO.d.cts","names":[],"sources":["../src/crons/Cron.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAUa,oBACG,oEACG,gCACF,SAAS,0BACP,kEACM,8KAIf,SACT,QACA,WACA,SACA,WACA,iBACA,+CAGA,WACA,sBACA,kCACA,gBAAgB,QAAQ,WAAW,SAAS,WAAW;wBAahC;EAlCX,OAAI,MAAA,CAAA,GAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAuBgB,IAvBhB,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;EAAA,WAAA,CAAA,EAAA,EAgCX,eAhCW,CAgCK,MAhCL,EAgCa,SAhCb,EAgCwB,OAhCxB,EAgCiC,SAhCjC,EAgC4C,SAhC5C,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAkCO,kBAlCP,GAAA,SAAA,EAAA,KAAA,CAAA,EAmCP,MAnCO,EAAA,YAAA,CAAA,EAoCA,SApCA,EAAA,QAAA,CAAA,EAqCL,SArCK,EAAA,MAAA,CAAA,EAsCN,OAtCM,EAAA,gBAAA,CAAA,EAuCI,OAvCJ,CAuCY,0BAvCZ,EAuCwC,eAvCxC,CAAA,EAAA,MAAA,CAAA,EAAA,GAAA,EAAA,EAAA,UAAA,CAAA,EAAA,MAAA,EAAA,eAAA,CAAA,EA0CG,OA1CH,CA0CW,oBA1CX,EA0CiC,SA1CjC,CAAA;EAAA;;;;EAGe,UACb,CAAA,EAAA,MAAA,EAAA;EAAgB,IACV,QAAA,CAAA,CAAA,EA6DR,kBA7DQ,GAAA,SAAA;;AAMxB,KA4DW,cAAA,GA5DX,QAAA,MAAA,GAAA;KA8DI,UAAA,GA7DJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;KAuEI,QAAA,GAtEJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;KAgFI,OAAA,GA/EJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;KAyFI,SAAA,GAxFJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,MAAA;KA6GI,WAAA,GA1GJ,GAAA,GAAA,MAAA,GAAA,GAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,KAAA,MAAA,EAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,GAAA,MAAA,IAAA,MAAA,EAAA,GAAA,MAAA;AACA,KA0HW,cAAA,GA1HX,QA2HQ,UA3HR,IA2HsB,QA3HtB,IA2HkC,OA3HlC,IA2H6C,SA3H7C,IA2H0D,WA3H1D,GAAA;AACA,KA4HW,kBAAA,GAAqB,cA5HhC,GA4HiD,cA5HjD"}

package/dist/CronBuilder-BL0AP6fs.d.mts

@@ -0,0 +1,44 @@
+import { FunctionBuilder, FunctionHandler } from "./index-CubPzHd9.mjs";
+import { Consumable, ServicesOf } from "./construct-interface-g5GM5pwR.mjs";
+import { Cron, ScheduleExpression } from "./Cron-ByxdOfpE.mjs";
+import { Service } from "@geekmidas/services";
+import { EventPublisher } from "@geekmidas/events";
+import { Logger } from "@geekmidas/logger";
+import { ComposableStandardSchema } from "@geekmidas/schema";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/crons/CronBuilder.d.ts
+declare class CronBuilder<TInput extends ComposableStandardSchema, 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 FunctionBuilder<TInput, OutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName> {
+  private _schedule?;
+  constructor();
+  memorySize(memorySize: number): this;
+  schedule(_expression: ScheduleExpression): CronBuilder<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  input<T extends ComposableStandardSchema>(schema: T): CronBuilder<T, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  output<T extends StandardSchemaV1>(schema: T): CronBuilder<TInput, TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): CronBuilder<TInput, [...TServices, ...ServicesOf<T>], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  services<T extends Service[]>(services: T): CronBuilder<TInput, [...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  logger<T extends Logger>(logger: T): CronBuilder<TInput, TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  publisher<T extends EventPublisher<any>, TName extends string>(publisher: Service<TName, T>): CronBuilder<TInput, TServices, TLogger, OutSchema, T, TName, TDatabase, TDatabaseServiceName>;
+  /**
+   * Set the database service for this cron job.
+   * The database will be available in the handler context as `db`.
+   */
+  database<T, TName extends string>(source: Consumable<TName, T> | Service<TName, T>): CronBuilder<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, T, TName>;
+  handle(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>): Cron<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+}
+//# sourceMappingURL=CronBuilder.d.ts.map
+
+//#endregion
+export { CronBuilder };
+//# sourceMappingURL=CronBuilder-BL0AP6fs.d.mts.map

package/dist/CronBuilder-BL0AP6fs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronBuilder-BL0AP6fs.d.mts","names":[],"sources":["../src/crons/CronBuilder.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/CronBuilder-BmABazzH.mjs

@@ -0,0 +1,84 @@
+import { ConstructType, __toESM } from "./Construct-BD5neF7w.mjs";
+import { idsOf, serviceOf, servicesOf } from "./construct-interface-Z4CpS8tK.mjs";
+import { Function, FunctionBuilder, require_lodash } from "./functions-Cxbo-pEd.mjs";
+import { cloneWith } from "./clone-DblgEZZa.mjs";
+
+//#region src/crons/Cron.ts
+var Cron = class extends Function {
+	static isCron(obj) {
+		return Boolean(obj && obj.__IS_FUNCTION__ === true && obj.type === ConstructType.Cron);
+	}
+	constructor(fn, timeout, _schedule, input, outputSchema, services = [], logger, publisherService, events = [], memorySize, databaseService, constructs = []) {
+		super(fn, timeout, ConstructType.Cron, input, outputSchema, services, logger, publisherService, events, memorySize, void 0, databaseService, constructs);
+		this._schedule = _schedule;
+	}
+	get schedule() {
+		return this._schedule;
+	}
+};
+
+//#endregion
+//#region src/crons/CronBuilder.ts
+var import_lodash = __toESM(require_lodash(), 1);
+var CronBuilder = class extends FunctionBuilder {
+	_schedule;
+	constructor() {
+		super(ConstructType.Cron);
+	}
+	memorySize(memorySize) {
+		return cloneWith(this, { _memorySize: memorySize });
+	}
+	schedule(_expression) {
+		return cloneWith(this, { _schedule: _expression });
+	}
+	input(schema) {
+		return cloneWith(this, { inputSchema: schema });
+	}
+	output(schema) {
+		return cloneWith(this, { outputSchema: schema });
+	}
+	/**
+	* Depend on constructs — a database, a bucket, a mail sender, a queue, a
+	* topic.
+	*
+	* It records the edge and dissolves each construct's client into the
+	* handler's service record under the construct's own id, so
+	* `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+	*
+	* Constructs only. A `Service` does not match the shape, which is what keeps
+	* env sniffing confined to `.services()` and the explicit lift.
+	*/
+	dependsOn(constructs) {
+		const services = servicesOf(constructs);
+		return cloneWith(this, {
+			_services: (0, import_lodash.default)([...this._services, ...services], (s) => s.serviceName),
+			_constructs: idsOf(constructs, this._constructs)
+		});
+	}
+	services(services) {
+		return cloneWith(this, { _services: (0, import_lodash.default)([...this._services, ...services], (s) => s.serviceName) });
+	}
+	logger(logger) {
+		return cloneWith(this, { _logger: logger });
+	}
+	publisher(publisher) {
+		return cloneWith(this, { _publisher: publisher });
+	}
+	/**
+	* Set the database service for this cron job.
+	* The database will be available in the handler context as `db`.
+	*/
+	database(source) {
+		const service = serviceOf(source);
+		return cloneWith(this, { _databaseService: service });
+	}
+	handle(fn) {
+		const cron = new Cron(fn, this._timeout, this._schedule, this.inputSchema, this.outputSchema, this._services, this._logger, this._publisher, this._events, this._memorySize, this._databaseService, this._constructs);
+		cron.owner = this._owner;
+		return cron;
+	}
+};
+
+//#endregion
+export { Cron, CronBuilder };
+//# sourceMappingURL=CronBuilder-BmABazzH.mjs.map

package/dist/CronBuilder-BmABazzH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronBuilder-BmABazzH.mjs","names":["obj: any","fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>","timeout?: number","_schedule?: ScheduleExpression","input?: TInput","outputSchema?: OutSchema","services: TServices","logger?: TLogger","publisherService?: Service<TEventPublisherServiceName, TEventPublisher>","events: any[]","memorySize?: number","databaseService?: Service<TDatabaseServiceName, TDatabase>","constructs: string[]","memorySize: number","_expression: ScheduleExpression","schema: T","constructs: T","s: Service","services: T","logger: T","publisher: Service<TName, T>","source: Consumable<TName, T> | Service<TName, T>","fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>"],"sources":["../src/crons/Cron.ts","../src/crons/CronBuilder.ts"],"sourcesContent":["import type { AuditableAction } from '@geekmidas/audit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport { ConstructType } from '../Construct';\nimport { Function, type FunctionHandler } from '../functions';\n\nexport class Cron<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends Function<\n\tTInput,\n\tTServices,\n\tTLogger,\n\tOutSchema,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName,\n\tAuditableAction<string, unknown>,\n\tFunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>\n> {\n\tstatic isCron(obj: any): obj is Cron<any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as Function).__IS_FUNCTION__ === true &&\n\t\t\t\tobj.type === ConstructType.Cron,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t\ttimeout?: number,\n\t\tprotected _schedule?: ScheduleExpression,\n\t\tinput?: TInput,\n\t\toutputSchema?: OutSchema,\n\t\tservices: TServices = [] as unknown as TServices,\n\t\tlogger?: TLogger,\n\t\tpublisherService?: Service<TEventPublisherServiceName, TEventPublisher>,\n\t\tevents: any[] = [],\n\t\tmemorySize?: number,\n\t\tdatabaseService?: Service<TDatabaseServiceName, TDatabase>,\n\t\t/**\n\t\t * The construct ids `.dependsOn()` named — last, so no existing positional\n\t\t * argument moves.\n\t\t */\n\t\tconstructs: string[] = [],\n\t) {\n\t\tsuper(\n\t\t\tfn,\n\t\t\ttimeout,\n\t\t\tConstructType.Cron,\n\t\t\tinput,\n\t\t\toutputSchema,\n\t\t\tservices,\n\t\t\tlogger,\n\t\t\tpublisherService,\n\t\t\tevents,\n\t\t\tmemorySize,\n\t\t\tundefined, // auditorStorageService\n\t\t\tdatabaseService,\n\t\t\tconstructs,\n\t\t);\n\t}\n\n\tget schedule(): ScheduleExpression | undefined {\n\t\treturn this._schedule;\n\t}\n}\n\nexport type RateExpression = `rate(${string})`;\n\ntype CronMinute =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| `${number},${number}`\n\t| string; // Allow more complex patterns\n\ntype CronHour =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| `${number},${number}`\n\t| string; // Allow more complex patterns\n\ntype CronDay =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| `${number},${number}`\n\t| string; // Allow more complex patterns\n\ntype CronMonth =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| 'JAN'\n\t| 'FEB'\n\t| 'MAR'\n\t| 'APR'\n\t| 'MAY'\n\t| 'JUN'\n\t| 'JUL'\n\t| 'AUG'\n\t| 'SEP'\n\t| 'OCT'\n\t| 'NOV'\n\t| 'DEC'\n\t| string; // Allow more complex patterns\n\ntype CronWeekday =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| 'SUN'\n\t| 'MON'\n\t| 'TUE'\n\t| 'WED'\n\t| 'THU'\n\t| 'FRI'\n\t| 'SAT'\n\t| `${string}-${string}` // Allow patterns like MON-FRI\n\t| string; // Allow more complex patterns\n\nexport type CronExpression =\n\t`cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;\n\nexport type ScheduleExpression = RateExpression | CronExpression;\n","import type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport uniqBy from 'lodash.uniqby';\nimport { ConstructType } from '../Construct';\nimport { cloneWith } from '../clone';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tserviceOf,\n\tservicesOf,\n} from '../construct-interface';\nimport { FunctionBuilder, type FunctionHandler } from '../functions';\nimport { Cron, type ScheduleExpression } from './Cron';\n\nexport class CronBuilder<\n\tTInput extends ComposableStandardSchema,\n\tTServices extends Service[],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends FunctionBuilder<\n\tTInput,\n\tOutSchema,\n\tTServices,\n\tTLogger,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName\n> {\n\tprivate _schedule?: ScheduleExpression;\n\n\tconstructor() {\n\t\tsuper(ConstructType.Cron);\n\t}\n\n\toverride memorySize(memorySize: number): this {\n\t\treturn cloneWith(this, { _memorySize: memorySize });\n\t}\n\n\tschedule(\n\t\t_expression: ScheduleExpression,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, { _schedule: _expression });\n\t}\n\n\toverride input<T extends ComposableStandardSchema>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tT,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\tinputSchema: schema as unknown as TInput,\n\t\t}) as unknown as CronBuilder<\n\t\t\tT,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride output<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tT,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\toverride dependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\t// Both halves of the edge, from one call and one clone: the services the\n\t\t// handler runs with, and the ids the manifest records. Recording them\n\t\t// separately is what let them drift apart.\n\t\t//\n\t\t// `servicesOf` is the half that validates, so it runs first — recording\n\t\t// ids ahead of it left a caught `NotAConstruct` with `undefined` already\n\t\t// on a `string[]`.\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s: Service) => s.serviceName,\n\t\t\t),\n\t\t\t_constructs: idsOf(constructs, this._constructs),\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride services<T extends Service[]>(\n\t\tservices: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s) => s.serviceName,\n\t\t\t) as TServices,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride logger<T extends Logger>(\n\t\tlogger: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tT,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride publisher<T extends EventPublisher<any>, TName extends string>(\n\t\tpublisher: Service<TName, T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tT,\n\t\tTName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_publisher: publisher as unknown as Service<\n\t\t\t\tTEventPublisherServiceName,\n\t\t\t\tTEventPublisher\n\t\t\t>,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tT,\n\t\t\tTName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Set the database service for this cron job.\n\t * The database will be available in the handler context as `db`.\n\t */\n\toverride database<T, TName extends string>(\n\t\tsource: Consumable<TName, T> | Service<TName, T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tT,\n\t\tTName\n\t> {\n\t\tconst service = serviceOf(source);\n\n\t\treturn cloneWith(this, {\n\t\t\t_databaseService: service as unknown as Service<\n\t\t\t\tTDatabaseServiceName,\n\t\t\t\tTDatabase\n\t\t\t>,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tT,\n\t\t\tTName\n\t\t>;\n\t}\n\n\toverride handle(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t): Cron<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tconst cron = new Cron(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._schedule,\n\t\t\tthis.inputSchema,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._publisher,\n\t\t\tthis._events,\n\t\t\tthis._memorySize,\n\t\t\tthis._databaseService,\n\t\t\tthis._constructs,\n\t\t);\n\n\t\t// Which process runs it. Carried from the factory rather than inferred\n\t\t// from the directory the file happens to sit in.\n\t\tcron.owner = this._owner;\n\n\t\t// No reset. `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base — `const fn = f.logger(log).timeout(60_000)` — keeps\n\t\t// its configuration for every construct built from it. The reset that\n\t\t// used to be here wiped the base on first use, which made a base usable\n\t\t// exactly once, and quietly reverted the logger to the default.\n\n\t\treturn cron;\n\t}\n}\n"],"mappings":";;;;;;AAUA,IAAa,OAAb,cASU,SAaR;CACD,OAAO,OAAOA,KAA2C;AACxD,SAAO,QACN,OACE,IAAiB,oBAAoB,QACtC,IAAI,SAAS,cAAc,KAC5B;CACD;CAED,YACCC,IACAC,SACUC,WACVC,OACAC,cACAC,WAAsB,CAAE,GACxBC,QACAC,kBACAC,SAAgB,CAAE,GAClBC,YACAC,iBAKAC,aAAuB,CAAE,GACxB;AACD,QACC,IACA,SACA,cAAc,MACd,OACA,cACA,UACA,QACA,kBACA,QACA,oBAEA,iBACA,WACA;EA7BS;CA8BV;CAED,IAAI,WAA2C;AAC9C,SAAO,KAAK;CACZ;AACD;;;;;AC7DD,IAAa,cAAb,cASU,gBAWR;CACD,AAAQ;CAER,cAAc;AACb,QAAM,cAAc,KAAK;CACzB;CAED,AAAS,WAAWC,YAA0B;AAC7C,SAAO,UAAU,MAAM,EAAE,aAAa,WAAY,EAAC;CACnD;CAED,SACCC,aAUC;AACD,SAAO,UAAU,MAAM,EAAE,WAAW,YAAa,EAAC;CAClD;CAED,AAAS,MACRC,QAUC;AACD,SAAO,UAAU,MAAM,EACtB,aAAa,OACb,EAAC;CAUF;CAED,AAAS,OACRA,QAUC;AACD,SAAO,UAAU,MAAM,EACtB,cAAc,OACd,EAAC;CAUF;;;;;;;;;;;;CAaD,AAAS,UACRC,YAUC;EAQD,MAAM,WAAW,WAAW,WAAW;AAEvC,SAAO,UAAU,MAAM;GACtB,WAAW,2BACV,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,GAChC,CAACC,MAAe,EAAE,YAClB;GACD,aAAa,MAAM,YAAY,KAAK,YAAY;EAChD,EAAC;CAUF;CAED,AAAS,SACRC,UAUC;AACD,SAAO,UAAU,MAAM,EACtB,WAAW,2BACV,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,GAChC,CAAC,MAAM,EAAE,YACT,CACD,EAAC;CAUF;CAED,AAAS,OACRC,QAUC;AACD,SAAO,UAAU,MAAM,EACtB,SAAS,OACT,EAAC;CAUF;CAED,AAAS,UACRC,WAUC;AACD,SAAO,UAAU,MAAM,EACtB,YAAY,UAIZ,EAAC;CAUF;;;;;CAMD,AAAS,SACRC,QAUC;EACD,MAAM,UAAU,UAAU,OAAO;AAEjC,SAAO,UAAU,MAAM,EACtB,kBAAkB,QAIlB,EAAC;CAUF;CAED,AAAS,OACRC,IAUC;EACD,MAAM,OAAO,IAAI,KAChB,IACA,KAAK,UACL,KAAK,WACL,KAAK,aACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,SACL,KAAK,aACL,KAAK,kBACL,KAAK;AAKN,OAAK,QAAQ,KAAK;AAQlB,SAAO;CACP;AACD"}

package/dist/CronBuilder-BqpEzMPQ.d.cts

@@ -0,0 +1,44 @@
+import { FunctionBuilder, FunctionHandler } from "./index-JSf9xNIJ.cjs";
+import { Consumable, ServicesOf } from "./construct-interface-D9d4Gm4p.cjs";
+import { Cron, ScheduleExpression } from "./Cron-Wqh464aO.cjs";
+import { EventPublisher } from "@geekmidas/events";
+import { Logger } from "@geekmidas/logger";
+import { ComposableStandardSchema } from "@geekmidas/schema";
+import { Service } from "@geekmidas/services";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/crons/CronBuilder.d.ts
+declare class CronBuilder<TInput extends ComposableStandardSchema, 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 FunctionBuilder<TInput, OutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName> {
+  private _schedule?;
+  constructor();
+  memorySize(memorySize: number): this;
+  schedule(_expression: ScheduleExpression): CronBuilder<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  input<T extends ComposableStandardSchema>(schema: T): CronBuilder<T, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  output<T extends StandardSchemaV1>(schema: T): CronBuilder<TInput, TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): CronBuilder<TInput, [...TServices, ...ServicesOf<T>], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  services<T extends Service[]>(services: T): CronBuilder<TInput, [...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  logger<T extends Logger>(logger: T): CronBuilder<TInput, TServices, T, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+  publisher<T extends EventPublisher<any>, TName extends string>(publisher: Service<TName, T>): CronBuilder<TInput, TServices, TLogger, OutSchema, T, TName, TDatabase, TDatabaseServiceName>;
+  /**
+   * Set the database service for this cron job.
+   * The database will be available in the handler context as `db`.
+   */
+  database<T, TName extends string>(source: Consumable<TName, T> | Service<TName, T>): CronBuilder<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, T, TName>;
+  handle(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>): Cron<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
+}
+//# sourceMappingURL=CronBuilder.d.ts.map
+
+//#endregion
+export { CronBuilder };
+//# sourceMappingURL=CronBuilder-BqpEzMPQ.d.cts.map

package/dist/CronBuilder-BqpEzMPQ.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronBuilder-BqpEzMPQ.d.cts","names":[],"sources":["../src/crons/CronBuilder.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAkBa,2BACG,4CACG,2BACF,SAAS,0BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;EAnBY,WAAA,CAAA;EAAW,UAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAA,QACR,CAAA,WAAA,EA+BD,kBA/BC,CAAA,EAgCZ,WAhCY,CAiCd,MAjCc,EAkCd,SAlCc,EAmCd,OAnCc,EAoCd,SApCc,EAqCd,eArCc,EAsCd,0BAtCc,EAuCd,SAvCc,EAwCd,oBAxCc,CAAA;EAAwB,KACrB,CAAA,UA4CO,wBA5CP,CAAA,CAAA,MAAA,EA6CT,CA7CS,CAAA,EA8Cf,WA9Ce,CA+CjB,CA/CiB,EAgDjB,SAhDiB,EAiDjB,OAjDiB,EAkDjB,SAlDiB,EAmDjB,eAnDiB,EAoDjB,0BApDiB,EAqDjB,SArDiB,EAsDjB,oBAtDiB,CAAA;EAAO,MACT,CAAA,UAqEU,gBArEV,CAAA,CAAA,MAAA,EAsEP,CAtEO,CAAA,EAuEb,WAvEa,CAwEf,MAxEe,EAyEf,SAzEe,EA0Ef,OA1Ee,EA2Ef,CA3Ee,EA4Ef,eA5Ee,EA6Ef,0BA7Ee,EA8Ef,SA9Ee,EA+Ef,oBA/Ee,CAAA;EAAM;;;;;;;;;;;EAgBF,SAaN,CAAA,gBAAA,SA6E8B,UA7E9B,EAAA,CAAA,CAAA,UAAA,EA8ED,CA9EC,CAAA,EA+EX,WA/EW,CAgFb,MAhFa,EAAA,CAEb,GA+EI,SA/EJ,EACA,GA8EkB,UA9ElB,CA8E6B,CA9E7B,CAAA,CAAS,EA+ET,OA9EA,EA+EA,SA/EA,EAgFA,eAhFA,EAiFA,0BAjFA,EAkFA,SAlFA,EAmFA,oBAnFA,CAAA;EAAO,QACP,CAAA,UA+G2B,OA/G3B,EAAA,CAAA,CAAA,QAAA,EAgHU,CAhHV,CAAA,EAiHE,WAjHF,CAkHA,MAlHA,EAAA,CACA,GAkHI,SAlHJ,EACA,GAiHkB,CAjHlB,CAA0B,EAkH1B,OAjHA,EAkHA,SAlHA,EAmHA,eAnHA,EAoHA,0BApHA,EAqHA,SArHA,EAsHA,oBAtHA,CAAA;EAAS,MACT,CAAA,UAwIyB,MAxIzB,CAAA,CAAA,MAAA,EAyIQ,CAzIR,CAAA,EA0IE,WA1IF,CA2IA,MA3IA,EA4IA,SA5IA,EA6IA,CA7IA,EA8IA,SA9IA,EA+IA,eA/IA,EAgJA,0BAhJA,EAiJA,SAjJA,EAkJA,oBAlJA,CAAA;EAAoB,SARlB,CAAA,UA0K0B,cA1K1B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EA2KS,OA3KT,CA2KiB,KA3KjB,EA2KwB,CA3KxB,CAAA,CAAA,EA4KA,WA5KA,CA6KF,MA7KE,EA8KF,SA9KE,EA+KF,OA/KE,EAgLF,SAhLE,EAiLF,CAjLE,EAkLF,KAlLE,EAmLF,SAnLE,EAoLF,oBApLE,CAAA;EAAW;;;;EAiBJ,QACT,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,MAAA,EA0LQ,UA1LR,CA0LmB,KA1LnB,EA0L0B,CA1L1B,CAAA,GA0L+B,OA1L/B,CA0LuC,KA1LvC,EA0L8C,CA1L9C,CAAA,CAAA,EA2LE,WA3LF,CA4LA,MA5LA,EA6LA,SA7LA,EA8LA,OA9LA,EA+LA,SA/LA,EAgMA,eAhMA,EAiMA,0BAjMA,EAkMA,CAlMA,EAmMA,KAnMA,CAAA;EAAO,MACP,CAAA,EAAA,EAwNI,eAxNJ,CAwNoB,MAxNpB,EAwN4B,SAxN5B,EAwNuC,OAxNvC,EAwNgD,SAxNhD,EAwN2D,SAxN3D,CAAA,CAAA,EAyNE,IAzNF,CA0NA,MA1NA,EA2NA,SA3NA,EA4NA,OA5NA,EA6NA,SA7NA,EA8NA,eA9NA,EA+NA,0BA/NA,EAgOA,SAhOA,EAiOA,oBAjOA,CAAA"}

package/dist/CronBuilder-CkXPJiGO.cjs

@@ -0,0 +1,96 @@
+const require_chunk = require('./chunk-DWy1uDak.cjs');
+const require_construct_interface = require('./construct-interface-BfjcOD_E.cjs');
+const require_Construct = require('./Construct-CyS3RpTL.cjs');
+const require_functions = require('./functions-Bd3TPxid.cjs');
+const require_clone = require('./clone-Dy0cR2SZ.cjs');
+
+//#region src/crons/Cron.ts
+var Cron = class extends require_functions.Function {
+	static isCron(obj) {
+		return Boolean(obj && obj.__IS_FUNCTION__ === true && obj.type === require_Construct.ConstructType.Cron);
+	}
+	constructor(fn, timeout, _schedule, input, outputSchema, services = [], logger, publisherService, events = [], memorySize, databaseService, constructs = []) {
+		super(fn, timeout, require_Construct.ConstructType.Cron, input, outputSchema, services, logger, publisherService, events, memorySize, void 0, databaseService, constructs);
+		this._schedule = _schedule;
+	}
+	get schedule() {
+		return this._schedule;
+	}
+};
+
+//#endregion
+//#region src/crons/CronBuilder.ts
+var import_lodash = require_chunk.__toESM(require_functions.require_lodash(), 1);
+var CronBuilder = class extends require_functions.FunctionBuilder {
+	_schedule;
+	constructor() {
+		super(require_Construct.ConstructType.Cron);
+	}
+	memorySize(memorySize) {
+		return require_clone.cloneWith(this, { _memorySize: memorySize });
+	}
+	schedule(_expression) {
+		return require_clone.cloneWith(this, { _schedule: _expression });
+	}
+	input(schema) {
+		return require_clone.cloneWith(this, { inputSchema: schema });
+	}
+	output(schema) {
+		return require_clone.cloneWith(this, { outputSchema: schema });
+	}
+	/**
+	* Depend on constructs — a database, a bucket, a mail sender, a queue, a
+	* topic.
+	*
+	* It records the edge and dissolves each construct's client into the
+	* handler's service record under the construct's own id, so
+	* `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+	*
+	* Constructs only. A `Service` does not match the shape, which is what keeps
+	* env sniffing confined to `.services()` and the explicit lift.
+	*/
+	dependsOn(constructs) {
+		const services = require_construct_interface.servicesOf(constructs);
+		return require_clone.cloneWith(this, {
+			_services: (0, import_lodash.default)([...this._services, ...services], (s) => s.serviceName),
+			_constructs: require_construct_interface.idsOf(constructs, this._constructs)
+		});
+	}
+	services(services) {
+		return require_clone.cloneWith(this, { _services: (0, import_lodash.default)([...this._services, ...services], (s) => s.serviceName) });
+	}
+	logger(logger) {
+		return require_clone.cloneWith(this, { _logger: logger });
+	}
+	publisher(publisher) {
+		return require_clone.cloneWith(this, { _publisher: publisher });
+	}
+	/**
+	* Set the database service for this cron job.
+	* The database will be available in the handler context as `db`.
+	*/
+	database(source) {
+		const service = require_construct_interface.serviceOf(source);
+		return require_clone.cloneWith(this, { _databaseService: service });
+	}
+	handle(fn) {
+		const cron = new Cron(fn, this._timeout, this._schedule, this.inputSchema, this.outputSchema, this._services, this._logger, this._publisher, this._events, this._memorySize, this._databaseService, this._constructs);
+		cron.owner = this._owner;
+		return cron;
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'Cron', {
+  enumerable: true,
+  get: function () {
+    return Cron;
+  }
+});
+Object.defineProperty(exports, 'CronBuilder', {
+  enumerable: true,
+  get: function () {
+    return CronBuilder;
+  }
+});
+//# sourceMappingURL=CronBuilder-CkXPJiGO.cjs.map