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

package/dist/crons/index.d.cts

@@ -1,52 +1,74 @@
-import "../Construct-WhCXIOPV.cjs";
-import { FunctionBuilder, FunctionHandler } from "../index-BTvozlUD.cjs";
-import { AWSScheduledFunction, Cron, CronExpression, RateExpression, ScheduleExpression } from "../AWSScheduledFunction-9bJS4WdJ.cjs";
-import { Consumable, ServicesOf } from "../construct-interface-D2nNkHUN.cjs";
-import { EventPublisher } from "@geekmidas/events";
-import * as _geekmidas_logger18 from "@geekmidas/logger";
-import { Logger } from "@geekmidas/logger";
-import * as _geekmidas_schema16 from "@geekmidas/schema";
-import { ComposableStandardSchema } from "@geekmidas/schema";
-import * as _geekmidas_services17 from "@geekmidas/services";
-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>;
+import { i as ScheduleExpression, n as CronExpression, r as RateExpression, t as Cron } from "../Cron-DI3nKoic.cjs";
+import { t as CronBuilder } from "../CronBuilder-g1lZLWyG.cjs";
+import { ServiceDiscovery } from "@geekmidas/services";
+//#region src/crons/inProcess.d.ts
+/** A schedule that is running, and the way to stop it. */
+interface InProcessSchedule {
+  stop(): void;
 }
-//# sourceMappingURL=CronBuilder.d.ts.map
+/**
+ * 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.
+ */
+export declare function scheduleInProcess(expression: string, fire: () => Promise<unknown> | unknown): InProcessSchedule;
 //#endregion
-//#region src/crons/index.d.ts
-declare const c: CronBuilder<_geekmidas_schema16.ComposableStandardSchema, _geekmidas_services17.Service<string, unknown>[], _geekmidas_logger18.Logger, undefined, undefined, string, undefined, string>;
-//# sourceMappingURL=index.d.ts.map
-
+//#region src/crons/runCron.d.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.
+ */
+export declare function runCron(cron: Cron<any, any, any, any, any, any>, serviceDiscovery: ServiceDiscovery<any>,
+/** The cron's export name, for its span. */
+name?: string): Promise<unknown>;
 //#endregion
-export { AWSScheduledFunction, Cron, CronBuilder, CronExpression, RateExpression, ScheduleExpression, c };
+//#region src/crons/schedule.d.ts
+/**
+ * A schedule a cron runner can take, as standard five-field cron.
+ *
+ * `ScheduleExpression` has two spellings. `cron(m h dom mon dow)` is already
+ * five-field cron and unwraps; `rate(n unit)` is an interval, and an interval
+ * is not a schedule — it says how often, where cron says when.
+ *
+ * Most intervals still have an exact cron equivalent, because they divide their
+ * unit evenly: `rate(5 minutes)` is every fifth minute of every hour, and that
+ * is `*​/5 * * * *` precisely. `rate(7 hours)` has none. There is no cron field
+ * that means "every seven hours" — `*​/7` in the hour field fires at 0, 7, 14
+ * and 21 and then starts over at midnight, so the gap between the last firing
+ * of one day and the first of the next is three hours rather than seven.
+ *
+ * Those are refused rather than rounded. A job that runs at the wrong hour is
+ * far harder to notice than one that refused to build, and a schedule quietly
+ * adjusted by the framework is a bug nobody goes looking for.
+ */
+export declare class UnrepresentableSchedule extends Error {
+  readonly schedule: string;
+  constructor(schedule: string, reason: string);
+}
+/**
+ * Standard five-field cron for a schedule expression.
+ *
+ * @throws {UnrepresentableSchedule} when a `rate(…)` has no exact equivalent.
+ */
+export declare function toCronExpression(schedule: ScheduleExpression): string;
+//#endregion
+export { Cron, CronBuilder, type CronExpression, type InProcessSchedule, type RateExpression, type ScheduleExpression };
 //# sourceMappingURL=index.d.cts.map

package/dist/crons/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;cAkBa,2BACG,4CACG,2BACF,SAAS,0BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;;;wBAac,qBACX,YACF,QACA,WACA,SACA,WACA,iBACA,4BACA,WACA;kBAKwB,kCAChB,IACN,YACF,GACA,WACA,SACA,WACA,iBACA,4BACA,WACA;EAxDW,MAAA,CAAA,UAwEc,gBAxEH,CAAA,CAAA,MAAA,EAyEd,CAzEc,CAAA,EA0EpB,WA1EoB,CA2EtB,MA3EsB,EA4EtB,SA5EsB,EA6EtB,OA7EsB,EA8EtB,CA9EsB,EA+EtB,eA/EsB,EAgFtB,0BAhFsB,EAiFtB,SAjFsB,EAkFtB,oBAlFsB,CAAA;EAAA;;;;;;;;;;;EAahB,SACP,CAAA,gBAAA,SA+F4C,UA/F5C,EAAA,CAAA,CAAA,UAAA,EAgGa,CAhGb,CAAA,EAiGG,WAjGH,CAkGC,MAlGD,EAAA,CACA,GAkGK,SAlGL,EAGA,GA+FmB,UA/FnB,CA+F8B,CA/F9B,CAAA,CAAS,EAgGR,OA/FD,EAgGC,SAhGD,EAiGC,eAjGD,EAkGC,0BAlGD,EAmGC,SAnGD,EAoGC,oBApGD,CAAA;EAAoB,QAaN,CAAA,UAoHc,OApHd,EAAA,CAAA,CAAA,QAAA,EAqHH,CArHG,CAAA,EAsHX,WAtHW,CAuHb,MAvHa,EAAA,CAEb,GAsHI,SAtHJ,EACA,GAqHkB,CArHlB,CAAS,EAsHT,OArHA,EAsHA,SAtHA,EAuHA,eAvHA,EAwHA,0BAxHA,EAyHA,SAzHA,EA0HA,oBA1HA,CAAA;EAAO,MACP,CAAA,UA4IyB,MA5IzB,CAAA,CAAA,MAAA,EA6IQ,CA7IR,CAAA,EA8IE,WA9IF,CA+IA,MA/IA,EAgJA,SAhJA,EAiJA,CAjJA,EAkJA,SAlJA,EAmJA,eAnJA,EAoJA,0BApJA,EAqJA,SArJA,EAsJA,oBAtJA,CAAA;EAAS,SACT,CAAA,UAqK4B,cArK5B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAsKW,OAtKX,CAsKmB,KAtKnB,EAsK0B,CAtK1B,CAAA,CAAA,EAuKE,WAvKF,CAwKA,MAxKA,EAyKA,SAzKA,EA0KA,OA1KA,EA2KA,SA3KA,EA4KA,CA5KA,EA6KA,KA7KA,EA8KA,SA9KA,EA+KA,oBA/KA,CAAA;EAAe;;;;EALF,QAaW,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,MAAA,EA+LhB,UA/LgB,CA+LL,KA/LK,EA+LE,CA/LF,CAAA,GA+LO,OA/LP,CA+Le,KA/Lf,EA+LsB,CA/LtB,CAAA,CAAA,EAgMtB,WAhMsB,CAiMxB,MAjMwB,EAkMxB,SAlMwB,EAmMxB,OAnMwB,EAoMxB,SApMwB,EAqMxB,eArMwB,EAsMxB,0BAtMwB,EAuMxB,CAvMwB,EAwMxB,KAxMwB,CAAA;EAAwB,MACxC,CAAA,EAAA,EA6NJ,eA7NI,CA6NY,MA7NZ,EA6NoB,SA7NpB,EA6N+B,OA7N/B,EA6NwC,SA7NxC,EA6NmD,SA7NnD,CAAA,CAAA,EA8NN,IA9NM,CA+NR,MA/NQ,EAgOR,SAhOQ,EAiOR,OAjOQ,EAkOR,SAlOQ,EAmOR,eAnOQ,EAoOR,0BApOQ,EAqOR,SArOQ,EAsOR,oBAtOQ,CAAA;;;;;cCtDG,GAAC,YAAoB,mBAAA,CAApB,wBAAA,EAAA,qBAAA,CAAA,4BAAA,mBAAA,CAAA,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/crons/inProcess.ts","../../src/crons/runCron.ts","../../src/crons/schedule.ts"],"mappings":";;;;;UASiB;EAChB;;;;;;;;;;;;;;;wBAgBe,kBACf,oBACA,YAAY,6BACV;;;;;;;;;;;;;;;;;wBCAmB,QACrB,MAAM,oCACN,kBAAkB,uBAElB;;AAAA,gBACE;;;;;;;;;;;;;;;;;;;;;qBCdU,gCAAgC;WAElC;EADV,YACU,kBACT;;;;;;;wBAuBc,iBAAiB,UAAU"}

package/dist/crons/index.d.mts

@@ -1,52 +1,74 @@
-import "../Construct-B-xc0SE9.mjs";
-import { FunctionBuilder, FunctionHandler } from "../index-L7pz0R0T.mjs";
-import { AWSScheduledFunction, Cron, CronExpression, RateExpression, ScheduleExpression } from "../AWSScheduledFunction-BO5iEMSh.mjs";
-import { Consumable, ServicesOf } from "../construct-interface-BqwRNYA2.mjs";
-import * as _geekmidas_services1 from "@geekmidas/services";
-import { Service } from "@geekmidas/services";
-import { EventPublisher } from "@geekmidas/events";
-import * as _geekmidas_logger2 from "@geekmidas/logger";
-import { Logger } from "@geekmidas/logger";
-import * as _geekmidas_schema0 from "@geekmidas/schema";
-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>;
+import { i as ScheduleExpression, n as CronExpression, r as RateExpression, t as Cron } from "../Cron-uYAHPnp7.mjs";
+import { t as CronBuilder } from "../CronBuilder-DaSUm2Na.mjs";
+import { ServiceDiscovery } from "@geekmidas/services";
+//#region src/crons/inProcess.d.ts
+/** A schedule that is running, and the way to stop it. */
+interface InProcessSchedule {
+  stop(): void;
 }
-//# sourceMappingURL=CronBuilder.d.ts.map
+/**
+ * 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.
+ */
+export declare function scheduleInProcess(expression: string, fire: () => Promise<unknown> | unknown): InProcessSchedule;
 //#endregion
-//#region src/crons/index.d.ts
-declare const c: CronBuilder<_geekmidas_schema0.ComposableStandardSchema, _geekmidas_services1.Service<string, unknown>[], _geekmidas_logger2.Logger, undefined, undefined, string, undefined, string>;
-//# sourceMappingURL=index.d.ts.map
-
+//#region src/crons/runCron.d.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.
+ */
+export declare function runCron(cron: Cron<any, any, any, any, any, any>, serviceDiscovery: ServiceDiscovery<any>,
+/** The cron's export name, for its span. */
+name?: string): Promise<unknown>;
 //#endregion
-export { AWSScheduledFunction, Cron, CronBuilder, CronExpression, RateExpression, ScheduleExpression, c };
+//#region src/crons/schedule.d.ts
+/**
+ * A schedule a cron runner can take, as standard five-field cron.
+ *
+ * `ScheduleExpression` has two spellings. `cron(m h dom mon dow)` is already
+ * five-field cron and unwraps; `rate(n unit)` is an interval, and an interval
+ * is not a schedule — it says how often, where cron says when.
+ *
+ * Most intervals still have an exact cron equivalent, because they divide their
+ * unit evenly: `rate(5 minutes)` is every fifth minute of every hour, and that
+ * is `*​/5 * * * *` precisely. `rate(7 hours)` has none. There is no cron field
+ * that means "every seven hours" — `*​/7` in the hour field fires at 0, 7, 14
+ * and 21 and then starts over at midnight, so the gap between the last firing
+ * of one day and the first of the next is three hours rather than seven.
+ *
+ * Those are refused rather than rounded. A job that runs at the wrong hour is
+ * far harder to notice than one that refused to build, and a schedule quietly
+ * adjusted by the framework is a bug nobody goes looking for.
+ */
+export declare class UnrepresentableSchedule extends Error {
+  readonly schedule: string;
+  constructor(schedule: string, reason: string);
+}
+/**
+ * Standard five-field cron for a schedule expression.
+ *
+ * @throws {UnrepresentableSchedule} when a `rate(…)` has no exact equivalent.
+ */
+export declare function toCronExpression(schedule: ScheduleExpression): string;
+//#endregion
+export { Cron, CronBuilder, type CronExpression, type InProcessSchedule, type RateExpression, type ScheduleExpression };
 //# sourceMappingURL=index.d.mts.map

package/dist/crons/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;cAkBa,2BACG,4CACG,2BACF,SAAS,0BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;;;wBAac,qBACX,YACF,QACA,WACA,SACA,WACA,iBACA,4BACA,WACA;kBAKwB,kCAChB,IACN,YACF,GACA,WACA,SACA,WACA,iBACA,4BACA,WACA;EAxDW,MAAA,CAAA,UAwEc,gBAxEH,CAAA,CAAA,MAAA,EAyEd,CAzEc,CAAA,EA0EpB,WA1EoB,CA2EtB,MA3EsB,EA4EtB,SA5EsB,EA6EtB,OA7EsB,EA8EtB,CA9EsB,EA+EtB,eA/EsB,EAgFtB,0BAhFsB,EAiFtB,SAjFsB,EAkFtB,oBAlFsB,CAAA;EAAA;;;;;;;;;;;EAahB,SACP,CAAA,gBAAA,SA+F4C,UA/F5C,EAAA,CAAA,CAAA,UAAA,EAgGa,CAhGb,CAAA,EAiGG,WAjGH,CAkGC,MAlGD,EAAA,CACA,GAkGK,SAlGL,EAGA,GA+FmB,UA/FnB,CA+F8B,CA/F9B,CAAA,CAAS,EAgGR,OA/FD,EAgGC,SAhGD,EAiGC,eAjGD,EAkGC,0BAlGD,EAmGC,SAnGD,EAoGC,oBApGD,CAAA;EAAoB,QAaN,CAAA,UAoHc,OApHd,EAAA,CAAA,CAAA,QAAA,EAqHH,CArHG,CAAA,EAsHX,WAtHW,CAuHb,MAvHa,EAAA,CAEb,GAsHI,SAtHJ,EACA,GAqHkB,CArHlB,CAAS,EAsHT,OArHA,EAsHA,SAtHA,EAuHA,eAvHA,EAwHA,0BAxHA,EAyHA,SAzHA,EA0HA,oBA1HA,CAAA;EAAO,MACP,CAAA,UA4IyB,MA5IzB,CAAA,CAAA,MAAA,EA6IQ,CA7IR,CAAA,EA8IE,WA9IF,CA+IA,MA/IA,EAgJA,SAhJA,EAiJA,CAjJA,EAkJA,SAlJA,EAmJA,eAnJA,EAoJA,0BApJA,EAqJA,SArJA,EAsJA,oBAtJA,CAAA;EAAS,SACT,CAAA,UAqK4B,cArK5B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAsKW,OAtKX,CAsKmB,KAtKnB,EAsK0B,CAtK1B,CAAA,CAAA,EAuKE,WAvKF,CAwKA,MAxKA,EAyKA,SAzKA,EA0KA,OA1KA,EA2KA,SA3KA,EA4KA,CA5KA,EA6KA,KA7KA,EA8KA,SA9KA,EA+KA,oBA/KA,CAAA;EAAe;;;;EALF,QAaW,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,MAAA,EA+LhB,UA/LgB,CA+LL,KA/LK,EA+LE,CA/LF,CAAA,GA+LO,OA/LP,CA+Le,KA/Lf,EA+LsB,CA/LtB,CAAA,CAAA,EAgMtB,WAhMsB,CAiMxB,MAjMwB,EAkMxB,SAlMwB,EAmMxB,OAnMwB,EAoMxB,SApMwB,EAqMxB,eArMwB,EAsMxB,0BAtMwB,EAuMxB,CAvMwB,EAwMxB,KAxMwB,CAAA;EAAwB,MACxC,CAAA,EAAA,EA6NJ,eA7NI,CA6NY,MA7NZ,EA6NoB,SA7NpB,EA6N+B,OA7N/B,EA6NwC,SA7NxC,EA6NmD,SA7NnD,CAAA,CAAA,EA8NN,IA9NM,CA+NR,MA/NQ,EAgOR,SAhOQ,EAiOR,OAjOQ,EAkOR,SAlOQ,EAmOR,eAnOQ,EAoOR,0BApOQ,EAqOR,SArOQ,EAsOR,oBAtOQ,CAAA;;;;;cCtDG,GAAC,YAAoB,kBAAA,CAApB,wBAAA,EAAA,oBAAA,CAAA,4BAAA,kBAAA,CAAA,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/crons/inProcess.ts","../../src/crons/runCron.ts","../../src/crons/schedule.ts"],"mappings":";;;;;UASiB;EAChB;;;;;;;;;;;;;;;wBAgBe,kBACf,oBACA,YAAY,6BACV;;;;;;;;;;;;;;;;;wBCAmB,QACrB,MAAM,oCACN,kBAAkB,uBAElB;;AAAA,gBACE;;;;;;;;;;;;;;;;;;;;;qBCdU,gCAAgC;WAElC;EADV,YACU,kBACT;;;;;;;wBAuBc,iBAAiB,UAAU"}

package/dist/crons/index.mjs

@@ -1,89 +1,191 @@
-import { ConstructType, __toESM } from "../Construct-CdhThxDI.mjs";
-import { idsOf, serviceOf, servicesOf } from "../construct-interface-Z4CpS8tK.mjs";
-import { Function, FunctionBuilder, require_lodash } from "../functions-Cpff1uZH.mjs";
-import { cloneWith } from "../clone-DblgEZZa.mjs";
-import "../publisher-CGEo8UKD.mjs";
-import { AWSScheduledFunction } from "../AWSScheduledFunction-BJjj8B5V.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;
-	}
-};
-
+import { a as publishEvents } from "../functions-BFizikJU.mjs";
+import { n as Cron, t as CronBuilder } from "../CronBuilder-Dmix_Pen.mjs";
+import { ROOT_CONTEXT, SpanKind, SpanStatusCode, context, trace } from "@opentelemetry/api";
+import { runWithRequestContext } from "@geekmidas/services";
+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/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)
+//#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 }
 		});
 	}
-	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);
-		return cron;
+	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.
+*
+* `ScheduleExpression` has two spellings. `cron(m h dom mon dow)` is already
+* five-field cron and unwraps; `rate(n unit)` is an interval, and an interval
+* is not a schedule — it says how often, where cron says when.
+*
+* Most intervals still have an exact cron equivalent, because they divide their
+* unit evenly: `rate(5 minutes)` is every fifth minute of every hour, and that
+* is `*​/5 * * * *` precisely. `rate(7 hours)` has none. There is no cron field
+* that means "every seven hours" — `*​/7` in the hour field fires at 0, 7, 14
+* and 21 and then starts over at midnight, so the gap between the last firing
+* of one day and the first of the next is three hours rather than seven.
+*
+* Those are refused rather than rounded. A job that runs at the wrong hour is
+* far harder to notice than one that refused to build, and a schedule quietly
+* 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.`);
+		this.schedule = schedule;
+		this.name = "UnrepresentableSchedule";
 	}
 };
-
+/** Units `rate(…)` accepts, singular or plural. */
+const UNITS = [
+	"minute",
+	"hour",
+	"day"
+];
+/**
+* Standard five-field cron for a schedule expression.
+*
+* @throws {UnrepresentableSchedule} when a `rate(…)` has no exact equivalent.
+*/
+function toCronExpression(schedule) {
+	const cron = /^cron\((.+)\)$/.exec(schedule);
+	if (cron?.[1]) return cron[1].trim();
+	const rate = /^rate\(\s*(\d+)\s+(\w+?)s?\s*\)$/.exec(schedule);
+	if (!rate) throw new UnrepresentableSchedule(schedule, "it is neither `cron(…)` nor `rate(n unit)`");
+	const every = Number(rate[1]);
+	const unit = rate[2];
+	/* c8 ignore next */ if (!unit) throw new UnrepresentableSchedule(schedule, "no unit");
+	if (!UNITS.includes(unit)) throw new UnrepresentableSchedule(schedule, `\`${unit}\` is not one of ${UNITS.join(", ")}`);
+	if (every < 1) throw new UnrepresentableSchedule(schedule, "an interval must be at least 1");
+	switch (unit) {
+		case "minute":
+			if (every === 1) return "* * * * *";
+			if (60 % every !== 0) throw new UnrepresentableSchedule(schedule, `${every} does not divide 60, so the interval would reset at the top of each hour`);
+			return `*/${every} * * * *`;
+		case "hour":
+			if (every === 1) return "0 * * * *";
+			if (24 % every !== 0) throw new UnrepresentableSchedule(schedule, `${every} does not divide 24, so the interval would reset at midnight`);
+			return `0 */${every} * * *`;
+		case "day":
+			if (every === 1) return "0 0 * * *";
+			throw new UnrepresentableSchedule(schedule, "day-of-month restarts every month, so no multi-day interval is even");
+	}
+}
 //#endregion
-//#region src/crons/index.ts
-const c = new CronBuilder();
+export { Cron, CronBuilder, UnrepresentableSchedule, runCron, scheduleInProcess, toCronExpression };
 
-//#endregion
-export { AWSScheduledFunction, Cron, CronBuilder, c };
 //# sourceMappingURL=index.mjs.map

package/dist/crons/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.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","../../src/crons/index.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// 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","export { AWSScheduledFunction } from './AWSScheduledFunction';\nexport {\n\tCron,\n\ttype CronExpression,\n\ttype RateExpression,\n\ttype ScheduleExpression,\n} from './Cron';\nexport { CronBuilder } from './CronBuilder';\n\nimport { CronBuilder } from './CronBuilder';\n\nexport const c = new CronBuilder();\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;AASN,SAAO;CACP;AACD;;;;ACrTD,MAAa,IAAI,IAAI"}
+{"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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"}