@geekmidas/constructs 10.0.0-alpha.12 → 10.0.0-alpha.120

package/dist/crons/index.mjs

@@ -1,9 +1,127 @@
-import "../Construct-BD5neF7w.mjs";
-import "../construct-interface-Z4CpS8tK.mjs";
-import "../functions-14lpEFL4.mjs";
-import "../clone-DblgEZZa.mjs";
-import { Cron, CronBuilder } from "../CronBuilder-CYKT5RiO.mjs";
-
+import { a as publishEvents } from "../functions-CTI-hDem.mjs";
+import { n as Cron, t as CronBuilder } from "../CronBuilder-D3sF9tS_.mjs";
+import { runWithRequestContext } from "@geekmidas/services";
+import { ROOT_CONTEXT, SpanKind, SpanStatusCode, context, trace } from "@opentelemetry/api";
+import { CronExpressionParser } from "cron-parser";
+//#region src/crons/inProcess.ts
+/**
+* The longest delay a timer takes. Node clamps anything longer to 1ms, so a
+* monthly cron would fire at once and then every millisecond.
+*/
+const MAX_DELAY = 2 ** 31 - 1;
+/**
+* Run `fire` on a cron expression, in this process, by timer.
+*
+* For the one process that has no broker to keep a schedule: `gkm dev` on a
+* target whose crons are infrastructure once deployed — an EventBridge rule on
+* AWS. Deployed, a timer is the wrong tool: each replica would fire every job
+* once, and nothing would say so. That is why a server schedules through
+* pg-boss, and why this is never what a deployed process does.
+*
+* In UTC, as the deployed schedule is. The next firing is worked out from the
+* clock after each run rather than read off a sequence, so a run that outlasts
+* its interval skips what it overran instead of firing them back to back.
+*/
+function scheduleInProcess(expression, fire) {
+	CronExpressionParser.parse(expression, { tz: "UTC" });
+	let timer;
+	let stopped = false;
+	const arm = (at) => {
+		if (stopped) return;
+		const delay = at - Date.now();
+		timer = setTimeout(async () => {
+			if (Date.now() < at) return arm(at);
+			await fire();
+			arm(nextAfter(expression, /* @__PURE__ */ new Date()));
+		}, Math.min(Math.max(delay, 0), MAX_DELAY));
+		timer.unref?.();
+	};
+	arm(nextAfter(expression, /* @__PURE__ */ new Date()));
+	return { stop() {
+		stopped = true;
+		clearTimeout(timer);
+	} };
+}
+function nextAfter(expression, from) {
+	return CronExpressionParser.parse(expression, {
+		tz: "UTC",
+		currentDate: from
+	}).next().getTime();
+}
+//#endregion
+//#region src/crons/runCron.ts
+/**
+* Run a cron once, in this process: what an EventBridge rule's invocation does
+* on Lambda, for a server that schedules its own.
+*
+* The same steps as the Lambda adaptor — its services, its worker's database
+* as `db`, an auditor when it declared one, its output parsed, its events
+* published — because a cron that ran differently on a server than deployed
+* would pass locally and fail where it matters. Services come through the
+* discovery, which keeps one instance of each, so running every minute does not
+* reconnect a database every minute.
+*
+* Each run is a trace of its own: a root span, `cron <name>`, whatever was
+* active when the timer or the broker fired it.
+*/
+async function runCron(cron, serviceDiscovery, name) {
+	const span = trace.getTracer("@geekmidas/constructs").startSpan(`cron ${name ?? cron.schedule ?? "manual"}`, {
+		kind: SpanKind.INTERNAL,
+		attributes: {
+			...name && { "gkm.cron.name": name },
+			...cron.schedule && { "gkm.cron.schedule": cron.schedule }
+		}
+	}, ROOT_CONTEXT);
+	return context.with(trace.setSpan(ROOT_CONTEXT, span), async () => {
+		try {
+			return await run(cron, serviceDiscovery);
+		} catch (error) {
+			if (error instanceof Error) span.recordException(error);
+			span.setStatus({ code: SpanStatusCode.ERROR });
+			throw error;
+		} finally {
+			span.end();
+		}
+	});
+}
+async function run(cron, serviceDiscovery) {
+	const services = cron.services.length > 0 ? await serviceDiscovery.register(cron.services) : {};
+	const db = cron.databaseService ? (await serviceDiscovery.register([cron.databaseService]))[cron.databaseService.serviceName] : void 0;
+	let auditor;
+	if (cron.auditorStorageService) {
+		const { DefaultAuditor } = await import("@geekmidas/audit");
+		const storage = (await serviceDiscovery.register([cron.auditorStorageService]))[cron.auditorStorageService.serviceName];
+		auditor = new DefaultAuditor({
+			actor: {
+				id: "system",
+				type: "system"
+			},
+			storage,
+			metadata: { function: cron.type }
+		});
+	}
+	const logger = cron.logger;
+	const requestId = `cron-${Date.now()}`;
+	return runWithRequestContext({
+		logger,
+		requestId,
+		startTime: Date.now(),
+		operation: `cron ${cron.schedule ?? "manual"}`
+	}, async () => {
+		const response = await cron.fn({
+			input: void 0,
+			services,
+			logger,
+			db,
+			auditor
+		});
+		const output = await cron.parseOutput(response);
+		await auditor?.flush();
+		await publishEvents(logger, serviceDiscovery, cron.events, output);
+		return output;
+	});
+}
+//#endregion
 //#region src/crons/schedule.ts
 /**
 * A schedule a cron runner can take, as standard five-field cron.
@@ -24,6 +142,7 @@ import { Cron, CronBuilder } from "../CronBuilder-CYKT5RiO.mjs";
 * adjusted by the framework is a bug nobody goes looking for.
 */
 var UnrepresentableSchedule = class extends Error {
+	schedule;
 	constructor(schedule, reason) {
 		super(`\`${schedule}\` has no exact cron equivalent: ${reason}.\n\nCron says *when*, not *how often*, so an interval is only exact when it divides its unit evenly.
 Write the schedule you mean instead — \`cron(0 */6 * * *)\` for every sixth hour, say — or pick an interval that divides: minutes into 60, hours into 24.`);
@@ -66,7 +185,7 @@ function toCronExpression(schedule) {
 			throw new UnrepresentableSchedule(schedule, "day-of-month restarts every month, so no multi-day interval is even");
 	}
 }
-
 //#endregion
-export { Cron, CronBuilder, UnrepresentableSchedule, toCronExpression };
+export { Cron, CronBuilder, UnrepresentableSchedule, runCron, scheduleInProcess, toCronExpression };
+
 //# sourceMappingURL=index.mjs.map

package/dist/crons/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["schedule: string","reason: string","schedule: ScheduleExpression"],"sources":["../../src/crons/schedule.ts"],"sourcesContent":["import type { ScheduleExpression } from './Cron';\n\n/**\n * A schedule a cron runner can take, as standard five-field cron.\n *\n * `ScheduleExpression` has two spellings. `cron(m h dom mon dow)` is already\n * five-field cron and unwraps; `rate(n unit)` is an interval, and an interval\n * is not a schedule — it says how often, where cron says when.\n *\n * Most intervals still have an exact cron equivalent, because they divide their\n * unit evenly: `rate(5 minutes)` is every fifth minute of every hour, and that\n * is `*​/5 * * * *` precisely. `rate(7 hours)` has none. There is no cron field\n * that means \"every seven hours\" — `*​/7` in the hour field fires at 0, 7, 14\n * and 21 and then starts over at midnight, so the gap between the last firing\n * of one day and the first of the next is three hours rather than seven.\n *\n * Those are refused rather than rounded. A job that runs at the wrong hour is\n * far harder to notice than one that refused to build, and a schedule quietly\n * adjusted by the framework is a bug nobody goes looking for.\n */\nexport class UnrepresentableSchedule extends Error {\n\tconstructor(\n\t\treadonly schedule: string,\n\t\treason: string,\n\t) {\n\t\tsuper(\n\t\t\t`\\`${schedule}\\` has no exact cron equivalent: ${reason}.\\n\\n` +\n\t\t\t\t'Cron says *when*, not *how often*, so an interval is only exact when ' +\n\t\t\t\t'it divides its unit evenly.\\n' +\n\t\t\t\t'Write the schedule you mean instead — `cron(0 */6 * * *)` for every ' +\n\t\t\t\t'sixth hour, say — or pick an interval that divides: minutes into 60, ' +\n\t\t\t\t'hours into 24.',\n\t\t);\n\t\tthis.name = 'UnrepresentableSchedule';\n\t}\n}\n\n/** Units `rate(…)` accepts, singular or plural. */\nconst UNITS = ['minute', 'hour', 'day'] as const;\ntype Unit = (typeof UNITS)[number];\n\n/**\n * Standard five-field cron for a schedule expression.\n *\n * @throws {UnrepresentableSchedule} when a `rate(…)` has no exact equivalent.\n */\nexport function toCronExpression(schedule: ScheduleExpression): string {\n\tconst cron = /^cron\\((.+)\\)$/.exec(schedule);\n\tif (cron?.[1]) return cron[1].trim();\n\n\tconst rate = /^rate\\(\\s*(\\d+)\\s+(\\w+?)s?\\s*\\)$/.exec(schedule);\n\tif (!rate) {\n\t\tthrow new UnrepresentableSchedule(\n\t\t\tschedule,\n\t\t\t'it is neither `cron(…)` nor `rate(n unit)`',\n\t\t);\n\t}\n\n\tconst every = Number(rate[1]);\n\tconst unit = rate[2] as Unit;\n\t/* c8 ignore next */ if (!unit)\n\t\tthrow new UnrepresentableSchedule(schedule, 'no unit');\n\n\tif (!UNITS.includes(unit)) {\n\t\tthrow new UnrepresentableSchedule(\n\t\t\tschedule,\n\t\t\t`\\`${unit}\\` is not one of ${UNITS.join(', ')}`,\n\t\t);\n\t}\n\n\tif (every < 1) {\n\t\tthrow new UnrepresentableSchedule(\n\t\t\tschedule,\n\t\t\t'an interval must be at least 1',\n\t\t);\n\t}\n\n\tswitch (unit) {\n\t\tcase 'minute':\n\t\t\tif (every === 1) return '* * * * *';\n\t\t\tif (60 % every !== 0) {\n\t\t\t\tthrow new UnrepresentableSchedule(\n\t\t\t\t\tschedule,\n\t\t\t\t\t`${every} does not divide 60, so the interval would reset at the top of each hour`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn `*/${every} * * * *`;\n\n\t\tcase 'hour':\n\t\t\tif (every === 1) return '0 * * * *';\n\t\t\tif (24 % every !== 0) {\n\t\t\t\tthrow new UnrepresentableSchedule(\n\t\t\t\t\tschedule,\n\t\t\t\t\t`${every} does not divide 24, so the interval would reset at midnight`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn `0 */${every} * * *`;\n\n\t\tcase 'day':\n\t\t\tif (every === 1) return '0 0 * * *';\n\t\t\t// `*/n` in day-of-month restarts on the 1st, so a 2-day interval fires\n\t\t\t// on the 1st and 3rd of a 31-day month and then again on the 1st — one\n\t\t\t// day later, not two. No month length makes that come out even.\n\t\t\tthrow new UnrepresentableSchedule(\n\t\t\t\tschedule,\n\t\t\t\t'day-of-month restarts every month, so no multi-day interval is even',\n\t\t\t);\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,0BAAb,cAA6C,MAAM;CAClD,YACUA,UACTC,QACC;AACD,SACE,IAAI,SAAS,mCAAmC,OAAO;2JAMxD;EAVQ;AAWT,OAAK,OAAO;CACZ;AACD;;AAGD,MAAM,QAAQ;CAAC;CAAU;CAAQ;AAAM;;;;;;AAQvC,SAAgB,iBAAiBC,UAAsC;CACtE,MAAM,OAAO,iBAAiB,KAAK,SAAS;AAC5C,KAAI,OAAO,GAAI,QAAO,KAAK,GAAG,MAAM;CAEpC,MAAM,OAAO,mCAAmC,KAAK,SAAS;AAC9D,MAAK,KACJ,OAAM,IAAI,wBACT,UACA;CAIF,MAAM,QAAQ,OAAO,KAAK,GAAG;CAC7B,MAAM,OAAO,KAAK;qBACG,MAAK,KACzB,OAAM,IAAI,wBAAwB,UAAU;AAE7C,MAAK,MAAM,SAAS,KAAK,CACxB,OAAM,IAAI,wBACT,WACC,IAAI,KAAK,mBAAmB,MAAM,KAAK,KAAK,CAAC;AAIhD,KAAI,QAAQ,EACX,OAAM,IAAI,wBACT,UACA;AAIF,SAAQ,MAAR;EACC,KAAK;AACJ,OAAI,UAAU,EAAG,QAAO;AACxB,OAAI,KAAK,UAAU,EAClB,OAAM,IAAI,wBACT,WACC,EAAE,MAAM;AAGX,WAAQ,IAAI,MAAM;EAEnB,KAAK;AACJ,OAAI,UAAU,EAAG,QAAO;AACxB,OAAI,KAAK,UAAU,EAClB,OAAM,IAAI,wBACT,WACC,EAAE,MAAM;AAGX,WAAQ,MAAM,MAAM;EAErB,KAAK;AACJ,OAAI,UAAU,EAAG,QAAO;AAIxB,SAAM,IAAI,wBACT,UACA;CAEF;AACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/crons/inProcess.ts","../../src/crons/runCron.ts","../../src/crons/schedule.ts"],"sourcesContent":["import { CronExpressionParser } from 'cron-parser';\n\n/**\n * The longest delay a timer takes. Node clamps anything longer to 1ms, so a\n * monthly cron would fire at once and then every millisecond.\n */\nconst MAX_DELAY = 2 ** 31 - 1;\n\n/** A schedule that is running, and the way to stop it. */\nexport interface InProcessSchedule {\n\tstop(): void;\n}\n\n/**\n * Run `fire` on a cron expression, in this process, by timer.\n *\n * For the one process that has no broker to keep a schedule: `gkm dev` on a\n * target whose crons are infrastructure once deployed — an EventBridge rule on\n * AWS. Deployed, a timer is the wrong tool: each replica would fire every job\n * once, and nothing would say so. That is why a server schedules through\n * pg-boss, and why this is never what a deployed process does.\n *\n * In UTC, as the deployed schedule is. The next firing is worked out from the\n * clock after each run rather than read off a sequence, so a run that outlasts\n * its interval skips what it overran instead of firing them back to back.\n */\nexport function scheduleInProcess(\n\texpression: string,\n\tfire: () => Promise<unknown> | unknown,\n): InProcessSchedule {\n\t// Parsed once up front, so a bad expression throws here — to the caller\n\t// scheduling it — rather than inside a timer.\n\tCronExpressionParser.parse(expression, { tz: 'UTC' });\n\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tlet stopped = false;\n\n\tconst arm = (at: number) => {\n\t\tif (stopped) return;\n\t\tconst delay = at - Date.now();\n\t\ttimer = setTimeout(\n\t\t\tasync () => {\n\t\t\t\tif (Date.now() < at) return arm(at);\n\t\t\t\tawait fire();\n\t\t\t\tarm(nextAfter(expression, new Date()));\n\t\t\t},\n\t\t\tMath.min(Math.max(delay, 0), MAX_DELAY),\n\t\t);\n\t\t// The server keeps the process alive; a schedule alone should not.\n\t\ttimer.unref?.();\n\t};\n\n\tarm(nextAfter(expression, new Date()));\n\n\treturn {\n\t\tstop() {\n\t\t\tstopped = true;\n\t\t\tclearTimeout(timer);\n\t\t},\n\t};\n}\n\nfunction nextAfter(expression: string, from: Date): number {\n\treturn CronExpressionParser.parse(expression, {\n\t\ttz: 'UTC',\n\t\tcurrentDate: from,\n\t})\n\t\t.next()\n\t\t.getTime();\n}\n","import type { AuditStorage } from '@geekmidas/audit';\nimport {\n\trunWithRequestContext,\n\ttype ServiceDiscovery,\n} from '@geekmidas/services';\nimport {\n\tcontext,\n\tROOT_CONTEXT,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\nimport { publishEvents } from '../publisher';\nimport type { Cron } from './Cron';\n\n/**\n * Run a cron once, in this process: what an EventBridge rule's invocation does\n * on Lambda, for a server that schedules its own.\n *\n * The same steps as the Lambda adaptor — its services, its worker's database\n * as `db`, an auditor when it declared one, its output parsed, its events\n * published — because a cron that ran differently on a server than deployed\n * would pass locally and fail where it matters. Services come through the\n * discovery, which keeps one instance of each, so running every minute does not\n * reconnect a database every minute.\n *\n * Each run is a trace of its own: a root span, `cron <name>`, whatever was\n * active when the timer or the broker fired it.\n */\nexport async function runCron(\n\tcron: Cron<any, any, any, any, any, any>,\n\tserviceDiscovery: ServiceDiscovery<any>,\n\t/** The cron's export name, for its span. */\n\tname?: string,\n): Promise<unknown> {\n\tconst span = trace.getTracer('@geekmidas/constructs').startSpan(\n\t\t`cron ${name ?? cron.schedule ?? 'manual'}`,\n\t\t{\n\t\t\tkind: SpanKind.INTERNAL,\n\t\t\tattributes: {\n\t\t\t\t...(name && { 'gkm.cron.name': name }),\n\t\t\t\t...(cron.schedule && { 'gkm.cron.schedule': cron.schedule }),\n\t\t\t},\n\t\t},\n\t\tROOT_CONTEXT,\n\t);\n\n\treturn context.with(trace.setSpan(ROOT_CONTEXT, span), async () => {\n\t\ttry {\n\t\t\treturn await run(cron, serviceDiscovery);\n\t\t} catch (error) {\n\t\t\tif (error instanceof Error) span.recordException(error);\n\t\t\tspan.setStatus({ code: SpanStatusCode.ERROR });\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tspan.end();\n\t\t}\n\t});\n}\n\nasync function run(\n\tcron: Cron<any, any, any, any, any, any>,\n\tserviceDiscovery: ServiceDiscovery<any>,\n): Promise<unknown> {\n\tconst services =\n\t\tcron.services.length > 0\n\t\t\t? await serviceDiscovery.register(cron.services)\n\t\t\t: {};\n\n\tconst db = cron.databaseService\n\t\t? (await serviceDiscovery.register([cron.databaseService]))[\n\t\t\t\tcron.databaseService.serviceName\n\t\t\t]\n\t\t: undefined;\n\n\t// Only imported for a cron that audits: `@geekmidas/audit` is optional.\n\tlet auditor: { flush(): Promise<void> } | undefined;\n\tif (cron.auditorStorageService) {\n\t\tconst { DefaultAuditor } = await import('@geekmidas/audit');\n\t\tconst registered: Record<string, unknown> = await serviceDiscovery.register(\n\t\t\t[cron.auditorStorageService],\n\t\t);\n\t\tconst storage = registered[\n\t\t\tcron.auditorStorageService.serviceName\n\t\t] as AuditStorage;\n\t\tauditor = new DefaultAuditor({\n\t\t\tactor: { id: 'system', type: 'system' },\n\t\t\tstorage,\n\t\t\tmetadata: { function: cron.type },\n\t\t});\n\t}\n\n\tconst logger = cron.logger;\n\tconst requestId = `cron-${Date.now()}`;\n\n\treturn runWithRequestContext(\n\t\t{\n\t\t\tlogger,\n\t\t\trequestId,\n\t\t\tstartTime: Date.now(),\n\t\t\toperation: `cron ${cron.schedule ?? 'manual'}`,\n\t\t},\n\t\tasync () => {\n\t\t\tconst response = await cron.fn({\n\t\t\t\tinput: undefined,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t\tdb,\n\t\t\t\tauditor,\n\t\t\t} as any);\n\t\t\tconst output = await cron.parseOutput(response);\n\n\t\t\tawait auditor?.flush();\n\t\t\t// The cron's output schema is erased by the `any` it is typed with here.\n\t\t\tawait publishEvents(\n\t\t\t\tlogger,\n\t\t\t\tserviceDiscovery,\n\t\t\t\tcron.events,\n\t\t\t\toutput as never,\n\t\t\t);\n\n\t\t\treturn output;\n\t\t},\n\t);\n}\n","import type { ScheduleExpression } from './Cron';\n\n/**\n * A schedule a cron runner can take, as standard five-field cron.\n *\n * `ScheduleExpression` has two spellings. `cron(m h dom mon dow)` is already\n * five-field cron and unwraps; `rate(n unit)` is an interval, and an interval\n * is not a schedule — it says how often, where cron says when.\n *\n * Most intervals still have an exact cron equivalent, because they divide their\n * unit evenly: `rate(5 minutes)` is every fifth minute of every hour, and that\n * is `*​/5 * * * *` precisely. `rate(7 hours)` has none. There is no cron field\n * that means \"every seven hours\" — `*​/7` in the hour field fires at 0, 7, 14\n * and 21 and then starts over at midnight, so the gap between the last firing\n * of one day and the first of the next is three hours rather than seven.\n *\n * Those are refused rather than rounded. A job that runs at the wrong hour is\n * far harder to notice than one that refused to build, and a schedule quietly\n * adjusted by the framework is a bug nobody goes looking for.\n */\nexport class UnrepresentableSchedule extends Error {\n\tconstructor(\n\t\treadonly schedule: string,\n\t\treason: string,\n\t) {\n\t\tsuper(\n\t\t\t`\\`${schedule}\\` has no exact cron equivalent: ${reason}.\\n\\n` +\n\t\t\t\t'Cron says *when*, not *how often*, so an interval is only exact when ' +\n\t\t\t\t'it divides its unit evenly.\\n' +\n\t\t\t\t'Write the schedule you mean instead — `cron(0 */6 * * *)` for every ' +\n\t\t\t\t'sixth hour, say — or pick an interval that divides: minutes into 60, ' +\n\t\t\t\t'hours into 24.',\n\t\t);\n\t\tthis.name = 'UnrepresentableSchedule';\n\t}\n}\n\n/** Units `rate(…)` accepts, singular or plural. */\nconst UNITS = ['minute', 'hour', 'day'] as const;\ntype Unit = (typeof UNITS)[number];\n\n/**\n * Standard five-field cron for a schedule expression.\n *\n * @throws {UnrepresentableSchedule} when a `rate(…)` has no exact equivalent.\n */\nexport function toCronExpression(schedule: ScheduleExpression): string {\n\tconst cron = /^cron\\((.+)\\)$/.exec(schedule);\n\tif (cron?.[1]) return cron[1].trim();\n\n\tconst rate = /^rate\\(\\s*(\\d+)\\s+(\\w+?)s?\\s*\\)$/.exec(schedule);\n\tif (!rate) {\n\t\tthrow new UnrepresentableSchedule(\n\t\t\tschedule,\n\t\t\t'it is neither `cron(…)` nor `rate(n unit)`',\n\t\t);\n\t}\n\n\tconst every = Number(rate[1]);\n\tconst unit = rate[2] as Unit;\n\t/* c8 ignore next */ if (!unit)\n\t\tthrow new UnrepresentableSchedule(schedule, 'no unit');\n\n\tif (!UNITS.includes(unit)) {\n\t\tthrow new UnrepresentableSchedule(\n\t\t\tschedule,\n\t\t\t`\\`${unit}\\` is not one of ${UNITS.join(', ')}`,\n\t\t);\n\t}\n\n\tif (every < 1) {\n\t\tthrow new UnrepresentableSchedule(\n\t\t\tschedule,\n\t\t\t'an interval must be at least 1',\n\t\t);\n\t}\n\n\tswitch (unit) {\n\t\tcase 'minute':\n\t\t\tif (every === 1) return '* * * * *';\n\t\t\tif (60 % every !== 0) {\n\t\t\t\tthrow new UnrepresentableSchedule(\n\t\t\t\t\tschedule,\n\t\t\t\t\t`${every} does not divide 60, so the interval would reset at the top of each hour`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn `*/${every} * * * *`;\n\n\t\tcase 'hour':\n\t\t\tif (every === 1) return '0 * * * *';\n\t\t\tif (24 % every !== 0) {\n\t\t\t\tthrow new UnrepresentableSchedule(\n\t\t\t\t\tschedule,\n\t\t\t\t\t`${every} does not divide 24, so the interval would reset at midnight`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn `0 */${every} * * *`;\n\n\t\tcase 'day':\n\t\t\tif (every === 1) return '0 0 * * *';\n\t\t\t// `*/n` in day-of-month restarts on the 1st, so a 2-day interval fires\n\t\t\t// on the 1st and 3rd of a 31-day month and then again on the 1st — one\n\t\t\t// day later, not two. No month length makes that come out even.\n\t\t\tthrow new UnrepresentableSchedule(\n\t\t\t\tschedule,\n\t\t\t\t'day-of-month restarts every month, so no multi-day interval is even',\n\t\t\t);\n\t}\n}\n"],"mappings":"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"}

package/dist/database/kysely.cjs

@@ -1,181 +1,4 @@
-const require_chunk = require('../chunk-DWy1uDak.cjs');
-const require_cache = require('../cache-3WSvAulx.cjs');
-const __geekmidas_manifest = require_chunk.__toESM(require("@geekmidas/manifest"));
-const kysely = require_chunk.__toESM(require("kysely"));
-const pg = require_chunk.__toESM(require("pg"));
-
-//#region src/database/kysely.ts
-/** The schema a database uses when it does not say otherwise. */
-const DEFAULT_SCHEMA = "app";
-/**
-* @typeParam DB - the database's schema.
-* @typeParam TName - the canonical id. TypeScript has no partial
-* type-argument inference, so `new KyselyDatabase<OrdersDB>('orders')` leaves
-* this at its default and the service key widens to `string`. `db` still types
-* through `.database()`, which infers from the service.
-*/
-var KyselyDatabase = class KyselyDatabase {
-	id;
-	service;
-	/**
-	* Declared once and read by both `declare()` and `connect()`, so the key the
-	* build publishes and the key the client reads cannot drift.
-	*/
-	config;
-	schemaName;
-	roles;
-	version;
-	derivedFrom;
-	constructor(id, options = {}, derivedFrom) {
-		this.options = options;
-		const canonical = (0, __geekmidas_manifest.canonicalId)(id);
-		this.id = canonical;
-		this.config = {
-			url: (0, __geekmidas_manifest.provideKey)(canonical, "url"),
-			ownerUrl: (0, __geekmidas_manifest.provideKey)(canonical, "ownerUrl")
-		};
-		this.schemaName = options.schema ?? DEFAULT_SCHEMA;
-		this.roles = options.roles ?? true;
-		this.version = options.version ?? __geekmidas_manifest.DEFAULT_POSTGRES_VERSION;
-		this.derivedFrom = derivedFrom;
-		this.service = {
-			serviceName: (0, __geekmidas_manifest.serviceKey)(canonical),
-			register: (registerOptions) => this.connect(registerOptions)
-		};
-	}
-	declare() {
-		if (this.derivedFrom) {
-			const { kind, of, schema } = this.derivedFrom;
-			return [kind === "database-schema" ? {
-				kind,
-				id: this.id,
-				of,
-				schema: schema ?? this.schemaName,
-				provides: [this.config.url]
-			} : {
-				kind,
-				id: this.id,
-				of,
-				provides: [this.config.url]
-			}];
-		}
-		return [{
-			kind: "database",
-			id: this.id,
-			engine: "postgres",
-			schema: this.schemaName,
-			version: this.version,
-			provides: [this.config.url],
-			...this.roles ? {} : { roles: false }
-		}];
-	}
-	/**
-	* A read-only endpoint on this database.
-	*
-	* Read-only is enforced by the reader role's grants rather than by which
-	* endpoint it resolves to, so falling back to the writer where no replica
-	* exists is safe rather than a silently writable connection behind a name
-	* that says reader. There is no `writer()`: the database *is* the writer, so
-	* a replica can never be reached by accident.
-	*
-	* The return type is narrower than this class on purpose — see
-	* {@link ReadOnlyDatabase}.
-	*/
-	reader() {
-		return new KyselyDatabase(`${this.id}Reader`, this.options, {
-			kind: "database-reader",
-			of: this.id
-		});
-	}
-	/**
-	* A cache that lives in this database.
-	*
-	* The same strengthening `schema()` is over a second database: `new
-	* Cache('Sessions')` says the app caches and leaves where to the deployment,
-	* while this says it caches *here* — which is a fact about the application
-	* and so belongs in its code.
-	*
-	* What it buys beyond being explicit: the table's schema and the role that
-	* reaches it come from this database rather than from a second convention,
-	* and the backend no longer has to guess which database "the database" meant
-	* when an app declares two.
-	*
-	* A cache is not a `KyselyDatabase`, so this returns a `Cache` — the client
-	* is a key/value store, not a query builder, and typing it as the parent
-	* would be a convenience that lies.
-	*/
-	cache(id = `${this.id}Cache`, options = {}) {
-		return new require_cache.Cache(id, {
-			of: this.id,
-			...options.table ? { table: options.table } : {}
-		});
-	}
-	/**
-	* A second schema in this database, with its own role(s) and its own URL —
-	* so this database's role holds no grant on those tables at all.
-	*
-	* Typed separately because a tenant has its own tables: the point is that
-	* `auth.selectFrom('sessions')` type-checks and
-	* `orders.selectFrom('sessions')` does not.
-	*/
-	schema(id, options = {}) {
-		return new KyselyDatabase(id, options, {
-			kind: "database-schema",
-			of: this.id,
-			schema: options.schema ?? id.toLowerCase()
-		});
-	}
-	/**
-	* A connection as the *owner* role — the one that may create, alter and drop.
-	*
-	* A `Service` rather than part of the construct, and deliberately so: a
-	* construct is what `.dependsOn()` accepts, and nothing should be able to
-	* depend on this. A migrator asks for it by name; a handler cannot ask at
-	* all, which is the security property the role split exists for.
-	*
-	* Falls back to the runtime URL where no owner URL was published — the
-	* `roles: false` downgrade, where there is only one credential and it is the
-	* cluster master's.
-	*/
-	get owner() {
-		return {
-			serviceName: `${(0, __geekmidas_manifest.serviceKey)(this.id)}Owner`,
-			register: (options) => this.connect(options, { owner: true })
-		};
-	}
-	async connect(options, as = {}) {
-		const { url, ownerUrl } = options.envParser.create((get) => ({
-			url: get(this.config.url).string(),
-			ownerUrl: get(this.config.ownerUrl).string().optional()
-		})).parse();
-		const { schema: _schema, roles: _roles,...kysely$1 } = this.options;
-		return new kysely.Kysely({
-			...kysely$1,
-			dialect: new kysely.PostgresDialect({ pool: pool(as.owner ? ownerUrl ?? url : url) })
-		});
-	}
-};
-/**
-* A pool for one URL, with its schema actually on the search path.
-*
-* `?search_path=` is not a libpq parameter — a URL carrying it connects
-* happily and then resolves every unqualified name against `public`, which is
-* how a schema tenant silently writes its tables into the database it was
-* separated from. Postgres takes it as a startup option instead, so the URL
-* keeps the readable form the target derives and this turns it into the thing
-* the server understands.
-*/
-function pool(url) {
-	const parsed = new URL(url);
-	const searchPath = parsed.searchParams.get("search_path");
-	if (!searchPath) return new pg.default.Pool({ connectionString: url });
-	parsed.searchParams.delete("search_path");
-	return new pg.default.Pool({
-		connectionString: parsed.toString(),
-		options: `-c search_path=${searchPath}`
-	});
-}
-
-//#endregion
-exports.KyselyDatabase = KyselyDatabase;
-//# sourceMappingURL=kysely.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_kysely = require("../kysely-CukArHJ0.cjs");
+exports.KyselyDatabase = require_kysely.KyselyDatabase;
+exports.closeDatabasePools = require_kysely.closeDatabasePools;

package/dist/database/kysely.d.cts

@@ -1,152 +1,2 @@
-import { Construct } from "../construct-interface-D9d4Gm4p.cjs";
-import { Cache } from "../cache-BtZY_tHe.cjs";
-import { Service } from "@geekmidas/services";
-import { ConstructName, Declaration, PostgresVersion } from "@geekmidas/manifest";
-import { Kysely, KyselyConfig } from "kysely";
-
-//#region src/database/kysely.d.ts
-
-/**
- * Everything Kysely takes, plus what this construct declares.
- *
- * `dialect` is omitted because the construct owns it — it is built from the one
- * URL the adapter supplied, which is the whole point of the construct. The rest
- * of `KyselyConfig` (`plugins`, `log`) is the app's business and passes
- * straight through, so anything Kysely adds later arrives without being
- * tracked here.
- */
-interface KyselyDatabaseOptions extends Omit<KyselyConfig, 'dialect'> {
-  /**
-   * The schema, pinned on both roles' `search_path`.
-   *
-   * Defaults to `app` — the role the schema plays, rather than a restatement
-   * of the database's own name, which reads correctly beside `auth` and
-   * `pgboss` and keeps the application off `public`.
-   */
-  schema?: string;
-  /**
-   * Provision the owner/runtime role split. Defaults to on.
-   *
-   * Off falls back to the cluster's master credential in both URLs, giving up
-   * the DDL/DML split and putting credentials that can drop a table into the
-   * function's environment. A deliberate downgrade, not a default.
-   */
-  roles?: boolean;
-  /**
-   * The Postgres major version to provision.
-   *
-   * Declared here so one statement reaches both targets. It was previously
-   * set in two unrelated places — a container tag locally, nothing at all on
-   * AWS (so Aurora chose) — which is how local came to run 18 while deployed
-   * ran 17.7 with nothing recording the difference.
-   *
-   * Defaults to {@link DEFAULT_POSTGRES_VERSION}.
-   */
-  version?: PostgresVersion;
-}
-/** What makes a construct derived rather than a database in its own right. */
-interface DerivedFrom {
-  kind: 'database-reader' | 'database-schema';
-  of: string;
-  schema?: string;
-}
-/**
- * @typeParam DB - the database's schema.
- * @typeParam TName - the canonical id. TypeScript has no partial
- * type-argument inference, so `new KyselyDatabase<OrdersDB>('orders')` leaves
- * this at its default and the service key widens to `string`. `db` still types
- * through `.database()`, which infers from the service.
- */
-declare class KyselyDatabase<DB = unknown, TName extends string = string> implements Construct<TName, Kysely<DB>> {
-  private readonly options;
-  readonly id: TName;
-  readonly service: Service<Uncapitalize<TName>, Kysely<DB>>;
-  /**
-   * Declared once and read by both `declare()` and `connect()`, so the key the
-   * build publishes and the key the client reads cannot drift.
-   */
-  private readonly config;
-  private readonly schemaName;
-  private readonly roles;
-  private readonly version;
-  private readonly derivedFrom?;
-  constructor(id: ConstructName<TName>, options?: KyselyDatabaseOptions, derivedFrom?: DerivedFrom);
-  declare(): Declaration[];
-  /**
-   * A read-only endpoint on this database.
-   *
-   * Read-only is enforced by the reader role's grants rather than by which
-   * endpoint it resolves to, so falling back to the writer where no replica
-   * exists is safe rather than a silently writable connection behind a name
-   * that says reader. There is no `writer()`: the database *is* the writer, so
-   * a replica can never be reached by accident.
-   *
-   * The return type is narrower than this class on purpose — see
-   * {@link ReadOnlyDatabase}.
-   */
-  reader(): ReadOnlyDatabase<DB, `${TName}Reader`>;
-  /**
-   * A cache that lives in this database.
-   *
-   * The same strengthening `schema()` is over a second database: `new
-   * Cache('Sessions')` says the app caches and leaves where to the deployment,
-   * while this says it caches *here* — which is a fact about the application
-   * and so belongs in its code.
-   *
-   * What it buys beyond being explicit: the table's schema and the role that
-   * reaches it come from this database rather than from a second convention,
-   * and the backend no longer has to guess which database "the database" meant
-   * when an app declares two.
-   *
-   * A cache is not a `KyselyDatabase`, so this returns a `Cache` — the client
-   * is a key/value store, not a query builder, and typing it as the parent
-   * would be a convenience that lies.
-   */
-  cache<TCache extends string = `${TName}Cache`>(id?: ConstructName<TCache>, options?: {
-    table?: string;
-  }): Cache<TCache>;
-  /**
-   * A second schema in this database, with its own role(s) and its own URL —
-   * so this database's role holds no grant on those tables at all.
-   *
-   * Typed separately because a tenant has its own tables: the point is that
-   * `auth.selectFrom('sessions')` type-checks and
-   * `orders.selectFrom('sessions')` does not.
-   */
-  schema<TenantDB, TTenant extends string>(id: ConstructName<TTenant>, options?: KyselyDatabaseOptions): KyselyDatabase<TenantDB, TTenant>;
-  /**
-   * A connection as the *owner* role — the one that may create, alter and drop.
-   *
-   * A `Service` rather than part of the construct, and deliberately so: a
-   * construct is what `.dependsOn()` accepts, and nothing should be able to
-   * depend on this. A migrator asks for it by name; a handler cannot ask at
-   * all, which is the security property the role split exists for.
-   *
-   * Falls back to the runtime URL where no owner URL was published — the
-   * `roles: false` downgrade, where there is only one credential and it is the
-   * cluster master's.
-   */
-  get owner(): Service<`${Uncapitalize<TName>}Owner`, Kysely<DB>>;
-  private connect;
-}
-/**
- * A database you may read through, and derive nothing from.
- *
- * A reader is terminal in the graph, and this is that fact in the type system.
- * `DERIVES_FROM` gives `cache` and `database-schema` no `database-reader`
- * parent, and there is no reader of a reader — so `orders.reader().cache(…)`
- * has always been illegal, but it type-checked and failed later at
- * `assertDerivations`. That is a long way round to learn that a read-only
- * endpoint cannot own a table something writes to.
- *
- * Omitting the three deriving methods rather than making them throw keeps the
- * failure where it costs least: the editor, on the line that wrote it.
- *
- * The result is deliberately not assignable back to `KyselyDatabase` — a
- * reader is not one, and anything that genuinely needs the writer should say
- * so.
- */
-type ReadOnlyDatabase<DB, TName extends string> = Omit<KyselyDatabase<DB, TName>, 'reader' | 'cache' | 'schema'>;
-//#endregion
-export { KyselyDatabase, KyselyDatabaseOptions, ReadOnlyDatabase };
-//# sourceMappingURL=kysely.d.cts.map
+import { a as closeDatabasePools, i as ReadOnlyDatabase, n as KyselyDatabaseOptions, r as PostgresRuntime, t as KyselyDatabase } from "../kysely-BHYV-WC-.cjs";
+export { KyselyDatabase, KyselyDatabaseOptions, PostgresRuntime, ReadOnlyDatabase, closeDatabasePools };