@tinyrack/tinyauth-server 0.0.14 → 0.0.15

package/dist/entrypoints/database/sqlite/sqlite.d.ts

@@ -1,6 +1,10 @@
+import { type Options } from '@mikro-orm/core';
 import type { DatabaseConfig } from '../../../lib/config/index.ts';
-export declare function sqlite(database: {
+type SqliteDatabaseConfig = {
     path: string;
     test: boolean;
-}): DatabaseConfig;
+    debug?: Options['debug'];
+};
+export declare function sqlite(database: SqliteDatabaseConfig): DatabaseConfig;
+export {};
 //# sourceMappingURL=sqlite.d.ts.map

package/dist/entrypoints/database/sqlite/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../src/entrypoints/database/sqlite/sqlite.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,wBAAgB,MAAM,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,cAAc,CA0BjB"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../src/entrypoints/database/sqlite/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B,CAAC;AAEF,wBAAgB,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,cAAc,CA0BrE"}

package/dist/entrypoints/database/sqlite/sqlite.js

@@ -19,7 +19,7 @@ export function sqlite(database) {
                 migrations: {
                     migrationsList: SQLITE_MIGRATIONS,
                 },
-                debug: false,
+                debug: database.debug ?? false,
             });
         },
         initialize: async (orm) => {

package/dist/entrypoints/database/sqlite/sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../../src/entrypoints/database/sqlite/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,iBAAiB,MAAM,yBAAyB,CAAC;AAExD,MAAM,UAAU,MAAM,CAAC,QAGtB;IACC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAE1D,OAAO;QACL,kBAAkB,EAAE,KAAK,IAAI,EAAE;YAC7B,OAAO,YAAY,CAAC;gBAClB,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,MAAM;gBACd,aAAa,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC;gBAC5C,iBAAiB,EAAE,iBAAiB;gBACpC,QAAQ,EAAE,CAAC,GAAG,mBAAmB,EAAE,CAAC;gBACpC,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;gBACnC,UAAU,EAAE;oBACV,cAAc,EAAE,iBAAiB;iBAClC;gBACD,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,GAAa,EAAE,EAAE;YAClC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../../src/entrypoints/database/sqlite/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+B,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,iBAAiB,MAAM,yBAAyB,CAAC;AAQxD,MAAM,UAAU,MAAM,CAAC,QAA8B;IACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAE1D,OAAO;QACL,kBAAkB,EAAE,KAAK,IAAI,EAAE;YAC7B,OAAO,YAAY,CAAC;gBAClB,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,MAAM;gBACd,aAAa,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC;gBAC5C,iBAAiB,EAAE,iBAAiB;gBACpC,QAAQ,EAAE,CAAC,GAAG,mBAAmB,EAAE,CAAC;gBACpC,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;gBACnC,UAAU,EAAE;oBACV,cAAc,EAAE,iBAAiB;iBAClC;gBACD,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,KAAK;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,GAAa,EAAE,EAAE;YAClC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/entrypoints/scheduler/cron.d.ts

@@ -0,0 +1,3 @@
+export declare function validateCronExpression(expression: string): string;
+export declare function getNextCronRunAt(expression: string, from: Date): Date;
+//# sourceMappingURL=cron.d.ts.map

package/dist/entrypoints/scheduler/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/cron.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAgBjE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAcrE"}

package/dist/entrypoints/scheduler/cron.js

@@ -0,0 +1,34 @@
+import { Cron } from 'croner';
+export function validateCronExpression(expression) {
+    let job;
+    try {
+        job = new Cron(expression, { paused: true });
+        const nextRunAt = job.nextRun(new Date()) ?? null;
+        if (!nextRunAt) {
+            throw new Error('Cron expression has no future run');
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid cron expression "${expression}": ${message}`);
+    }
+    finally {
+        job?.stop();
+    }
+    return expression;
+}
+export function getNextCronRunAt(expression, from) {
+    let job;
+    try {
+        job = new Cron(expression, { paused: true });
+        const nextRunAt = job.nextRun(from) ?? null;
+        if (!nextRunAt) {
+            throw new Error(`Cron expression has no future run: ${expression}`);
+        }
+        return nextRunAt;
+    }
+    finally {
+        job?.stop();
+    }
+}
+//# sourceMappingURL=cron.js.map

package/dist/entrypoints/scheduler/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/cron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,IAAI,GAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,MAAM,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;YAAS,CAAC;QACT,GAAG,EAAE,IAAI,EAAE,CAAC;IACd,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,IAAU;IAC7D,IAAI,GAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QAE5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,GAAG,EAAE,IAAI,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/entrypoints/scheduler/croner.d.ts

@@ -1,6 +1,6 @@
 import type { SchedulerConfig } from '../../lib/config/index.ts';
 export interface CronerSchedulerOptions {
-    cron?: string | undefined;
+    cleanupCron?: string | undefined;
 }
 export declare function croner(options?: CronerSchedulerOptions): SchedulerConfig;
 //# sourceMappingURL=croner.d.ts.map

package/dist/entrypoints/scheduler/croner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"croner.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/croner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAqB5E"}
+{"version":3,"file":"croner.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/croner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,2BAA2B,CAAC;AAKnC,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAgD5E"}

package/dist/entrypoints/scheduler/croner.js

@@ -1,18 +1,38 @@
 import { Cron } from 'croner';
+import { validateCronExpression } from "./cron.js";
 const DEFAULT_CRON = '0 2 * * *';
 export function croner(options = {}) {
-    const cron = options.cron ?? DEFAULT_CRON;
+    const cleanupCron = validateCronExpression(options.cleanupCron ?? DEFAULT_CRON);
     return {
-        start({ runCleanup }) {
-            const job = new Cron(cron, async () => {
-                await runCleanup();
-            });
+        cleanupCron,
+        start({ scheduledJobs, logger }) {
+            const cronJobs = scheduledJobs.map((job) => new Cron(job.schedule.expression, async () => {
+                try {
+                    await job.handler({ logger });
+                }
+                catch (err) {
+                    logger?.error({ err, jobId: job.id }, 'Scheduled job failed');
+                }
+            }));
             const handle = {
                 stop() {
-                    job.stop();
+                    for (const cronJob of cronJobs) {
+                        cronJob.stop();
+                    }
                 },
                 getNextRunAt() {
-                    return job.nextRun() ?? null;
+                    const nextRuns = cronJobs
+                        .map((cronJob) => cronJob.nextRun() ?? null)
+                        .filter((nextRun) => nextRun !== null);
+                    return nextRuns.reduce((earliest, nextRun) => {
+                        if (!earliest || nextRun.getTime() < earliest.getTime()) {
+                            return nextRun;
+                        }
+                        return earliest;
+                    }, null);
+                },
+                async enqueue() {
+                    throw new Error('Background jobs require a durable scheduler backend');
                 },
             };
             return handle;

package/dist/entrypoints/scheduler/croner.js.map

@@ -1 +1 @@
-{"version":3,"file":"croner.js","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/croner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAM9B,MAAM,YAAY,GAAG,WAAW,CAAC;AAMjC,MAAM,UAAU,MAAM,CAAC,UAAkC,EAAE;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAE1C,OAAO;QACL,KAAK,CAAC,EAAE,UAAU,EAAE;YAClB,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;gBACpC,MAAM,UAAU,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAoB;gBAC9B,IAAI;oBACF,GAAG,CAAC,IAAI,EAAE,CAAC;gBACb,CAAC;gBACD,YAAY;oBACV,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC;gBAC/B,CAAC;aACF,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"croner.js","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/croner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAK9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,YAAY,GAAG,WAAW,CAAC;AAMjC,MAAM,UAAU,MAAM,CAAC,UAAkC,EAAE;IACzD,MAAM,WAAW,GAAG,sBAAsB,CACxC,OAAO,CAAC,WAAW,IAAI,YAAY,CACpC,CAAC;IAEF,OAAO;QACL,WAAW;QACX,KAAK,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE;YAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CACN,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;gBAC3C,IAAI,CAAC;oBACH,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,sBAAsB,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC,CAAC,CACL,CAAC;YAEF,MAAM,MAAM,GAAoB;gBAC9B,IAAI;oBACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;wBAC/B,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,CAAC;gBACH,CAAC;gBACD,YAAY;oBACV,MAAM,QAAQ,GAAG,QAAQ;yBACtB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC;yBAC3C,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;oBAEzC,OAAO,QAAQ,CAAC,MAAM,CAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;wBACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;4BACxD,OAAO,OAAO,CAAC;wBACjB,CAAC;wBAED,OAAO,QAAQ,CAAC;oBAClB,CAAC,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;gBACD,KAAK,CAAC,OAAO;oBACX,MAAM,IAAI,KAAK,CACb,qDAAqD,CACtD,CAAC;gBACJ,CAAC;aACF,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/entrypoints/scheduler/database.d.ts

@@ -0,0 +1,38 @@
+import type { SchedulerConfig, SchedulerConfigResolver } from '../../lib/config/index.ts';
+import type { MikroService } from '../../services/mikro.service.ts';
+import { type AcquiredBackgroundJob, type AcquiredSchedulerJob, type BackgroundJobCompletionInput, type BackgroundJobEnqueueInput, type BackgroundJobFailureCompletionInput, type DistributedBackgroundJobStore, type DistributedSchedulerStore, type PersistedSchedulerJobDefinition, type SchedulerCompletionInput, type SchedulerFailureCompletionInput } from './distributed-runner.ts';
+export interface DatabaseSchedulerOptions {
+    cleanupCron?: string | undefined;
+    pollIntervalMs?: number | undefined;
+    lockTtlMs?: number | undefined;
+    backgroundRetryDelayMs?: number | undefined;
+    backgroundMaxAttempts?: number | undefined;
+    backgroundRetentionMs?: number | undefined;
+    instanceId?: string | undefined;
+}
+export interface BoundDatabaseSchedulerOptions extends DatabaseSchedulerOptions {
+    mikro: MikroService;
+}
+export declare class DatabaseSchedulerStore implements DistributedSchedulerStore {
+    private readonly mikro;
+    constructor(mikro: MikroService);
+    reconcileJobs(jobs: readonly PersistedSchedulerJobDefinition[], now: Date): Promise<void>;
+    acquireDueJob(now: Date, lockedUntil: Date, instanceId: string): Promise<AcquiredSchedulerJob | null>;
+    renewLease(jobId: string, instanceId: string, lockedUntil: Date, now: Date): Promise<boolean>;
+    completeJobSuccess(input: SchedulerCompletionInput): Promise<boolean>;
+    completeJobFailure(input: SchedulerFailureCompletionInput): Promise<boolean>;
+    findNextRunAt(): Promise<Date | null>;
+}
+export declare class DatabaseBackgroundJobStore implements DistributedBackgroundJobStore {
+    private readonly mikro;
+    constructor(mikro: MikroService);
+    enqueue(input: BackgroundJobEnqueueInput): Promise<string>;
+    acquireDueJob(now: Date, lockedUntil: Date, instanceId: string): Promise<AcquiredBackgroundJob | null>;
+    renewLease(id: string, instanceId: string, lockedUntil: Date, now: Date): Promise<boolean>;
+    completeJobSuccess(input: BackgroundJobCompletionInput): Promise<boolean>;
+    completeJobFailure(input: BackgroundJobFailureCompletionInput): Promise<boolean>;
+    cleanupCompletedJobs(before: Date): Promise<number>;
+}
+export declare function database(options: BoundDatabaseSchedulerOptions): SchedulerConfig;
+export declare function database(options?: DatabaseSchedulerOptions): SchedulerConfigResolver;
+//# sourceMappingURL=database.d.ts.map

package/dist/entrypoints/scheduler/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/scheduler/database.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,eAAe,EACf,uBAAuB,EAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,mCAAmC,EAExC,KAAK,6BAA6B,EAElC,KAAK,yBAAyB,EAE9B,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACrC,MAAM,yBAAyB,CAAC;AAWjC,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,6BACf,SAAQ,wBAAwB;IAChC,KAAK,EAAE,YAAY,CAAC;CACrB;AAkKD,qBAAa,sBAAuB,YAAW,yBAAyB;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,KAAK,EAAE,YAAY;IAIzB,aAAa,CACjB,IAAI,EAAE,SAAS,+BAA+B,EAAE,EAChD,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,IAAI,CAAC;IAkCV,aAAa,CACjB,GAAG,EAAE,IAAI,EACT,WAAW,EAAE,IAAI,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAmDjC,UAAU,CACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,EACjB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,OAAO,CAAC;IAeb,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBrE,kBAAkB,CACtB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,OAAO,CAAC;IAwBb,aAAa,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CAU5C;AAED,qBAAa,0BACX,YAAW,6BAA6B;IAExC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,KAAK,EAAE,YAAY;IAIzB,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB1D,aAAa,CACjB,GAAG,EAAE,IAAI,EACT,WAAW,EAAE,IAAI,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAqGlC,UAAU,CACd,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,EACjB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,OAAO,CAAC;IAgBb,kBAAkB,CACtB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,OAAO,CAAC;IAqBb,kBAAkB,CACtB,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,OAAO,CAAC;IAwBb,oBAAoB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAS1D;AA2DD,wBAAgB,QAAQ,CACtB,OAAO,EAAE,6BAA6B,GACrC,eAAe,CAAC;AACnB,wBAAgB,QAAQ,CACtB,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAAC"}

package/dist/entrypoints/scheduler/database.js

@@ -0,0 +1,444 @@
+import os from 'node:os';
+import { BackgroundJobEntitySchema } from "../../entities/background-job.entity.js";
+import { SchedulerJobEntitySchema } from "../../entities/scheduler-job.entity.js";
+import { validateCronExpression } from "./cron.js";
+import { DistributedBackgroundJobRunner, DistributedSchedulerRunner, getDistributedSchedulerNextRunAt, } from "./distributed-runner.js";
+const DEFAULT_CLEANUP_CRON = '0 2 * * *';
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const DEFAULT_LOCK_TTL_MS = 60000;
+const DEFAULT_BACKGROUND_RETRY_DELAY_MS = 1000;
+const DEFAULT_BACKGROUND_MAX_ATTEMPTS = 3;
+const DEFAULT_BACKGROUND_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
+const MAX_ERROR_LENGTH = 2000;
+const JSON_SAFE_PAYLOAD_ERROR = 'Background job payload must be JSON-safe';
+function createInstanceId(instanceId) {
+    return instanceId ?? `${os.hostname()}:${process.pid}:${crypto.randomUUID()}`;
+}
+function resolvePositiveNumber(name, value, defaultValue) {
+    const resolved = value ?? defaultValue;
+    if (!Number.isFinite(resolved) || resolved <= 0) {
+        throw new Error(`${name} must be a positive number`);
+    }
+    return resolved;
+}
+function resolvePositiveInteger(name, value, defaultValue) {
+    const resolved = resolvePositiveNumber(name, value, defaultValue);
+    if (!Number.isInteger(resolved)) {
+        throw new Error(`${name} must be a positive integer`);
+    }
+    return resolved;
+}
+function errorToMessage(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return message.slice(0, MAX_ERROR_LENGTH);
+}
+function validateJsonSafePayload(value, path, seen) {
+    if (value === null) {
+        return;
+    }
+    switch (typeof value) {
+        case 'boolean':
+        case 'string':
+            return;
+        case 'number':
+            if (!Number.isFinite(value)) {
+                throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path} must be finite`);
+            }
+            return;
+        case 'undefined':
+            throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path} is undefined`);
+        case 'bigint':
+        case 'function':
+        case 'symbol':
+            throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path} has unsupported type ${typeof value}`);
+    }
+    if (seen.has(value)) {
+        throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path} contains a cycle`);
+    }
+    if (Object.hasOwn(value, 'toJSON')) {
+        throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path} must not define toJSON`);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) &&
+        prototype !== Object.prototype &&
+        prototype !== null) {
+        throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path} must be a plain object`);
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            if (!(index in value)) {
+                throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: ${path}[${index}] is undefined`);
+            }
+            validateJsonSafePayload(value[index], `${path}[${index}]`, seen);
+        }
+    }
+    else {
+        for (const [key, child] of Object.entries(value)) {
+            validateJsonSafePayload(child, `${path}.${key}`, seen);
+        }
+    }
+    seen.delete(value);
+}
+function stringifyJsonSafePayload(payload) {
+    validateJsonSafePayload(payload, 'payload', new WeakSet());
+    const serialized = JSON.stringify(payload);
+    if (serialized === undefined) {
+        throw new Error(`${JSON_SAFE_PAYLOAD_ERROR}: payload is undefined`);
+    }
+    return serialized;
+}
+function resolveOptions(options) {
+    return {
+        cleanupCron: validateCronExpression(options.cleanupCron ?? DEFAULT_CLEANUP_CRON),
+        pollIntervalMs: resolvePositiveNumber('pollIntervalMs', options.pollIntervalMs, DEFAULT_POLL_INTERVAL_MS),
+        lockTtlMs: resolvePositiveNumber('lockTtlMs', options.lockTtlMs, DEFAULT_LOCK_TTL_MS),
+        backgroundRetryDelayMs: resolvePositiveNumber('backgroundRetryDelayMs', options.backgroundRetryDelayMs, DEFAULT_BACKGROUND_RETRY_DELAY_MS),
+        backgroundMaxAttempts: resolvePositiveInteger('backgroundMaxAttempts', options.backgroundMaxAttempts, DEFAULT_BACKGROUND_MAX_ATTEMPTS),
+        backgroundRetentionMs: resolvePositiveNumber('backgroundRetentionMs', options.backgroundRetentionMs, DEFAULT_BACKGROUND_RETENTION_MS),
+        instanceId: createInstanceId(options.instanceId),
+    };
+}
+export class DatabaseSchedulerStore {
+    mikro;
+    constructor(mikro) {
+        this.mikro = mikro;
+    }
+    async reconcileJobs(jobs, now) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(SchedulerJobEntitySchema);
+        const jobIds = jobs.map((job) => job.id);
+        for (const job of jobs) {
+            const existing = await repo.findOne({ id: job.id });
+            const nextRunAt = getDistributedSchedulerNextRunAt(job.cron, now);
+            const shouldResetNextRunAt = !existing?.nextRunAt || existing.cron !== job.cron;
+            await em.upsert(SchedulerJobEntitySchema, {
+                id: job.id,
+                name: job.name,
+                enabled: true,
+                cron: job.cron,
+                nextRunAt: shouldResetNextRunAt ? nextRunAt : existing.nextRunAt,
+                created_at: now,
+                updated_at: now,
+            }, {
+                onConflictFields: ['id'],
+                onConflictAction: 'merge',
+                onConflictExcludeFields: ['id', 'created_at'],
+            });
+        }
+        const staleJobFilter = jobIds.length > 0 ? { id: { $nin: jobIds } } : {};
+        await repo.nativeUpdate(staleJobFilter, { enabled: false });
+    }
+    async acquireDueJob(now, lockedUntil, instanceId) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(SchedulerJobEntitySchema);
+        const seenCandidateIds = [];
+        const eligibleFilter = {
+            enabled: true,
+            nextRunAt: { $lte: now },
+            $or: [{ lockedUntil: null }, { lockedUntil: { $lte: now } }],
+        };
+        while (true) {
+            const candidateFilter = {
+                ...eligibleFilter,
+                ...(seenCandidateIds.length > 0
+                    ? { id: { $nin: seenCandidateIds } }
+                    : {}),
+            };
+            const candidate = await repo.findOne(candidateFilter, {
+                orderBy: { nextRunAt: 'ASC' },
+            });
+            if (!candidate) {
+                return null;
+            }
+            const updated = await repo.nativeUpdate({
+                id: candidate.id,
+                ...eligibleFilter,
+            }, {
+                lockedBy: instanceId,
+                lockedUntil,
+                lastRunAt: now,
+            });
+            if (updated !== 1) {
+                seenCandidateIds.push(candidate.id);
+                continue;
+            }
+            return {
+                id: candidate.id,
+                cron: candidate.cron,
+                runCount: candidate.runCount,
+                failureCount: candidate.failureCount,
+            };
+        }
+    }
+    async renewLease(jobId, instanceId, lockedUntil, now) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(SchedulerJobEntitySchema);
+        const updated = await repo.nativeUpdate({
+            id: jobId,
+            lockedBy: instanceId,
+            lockedUntil: { $gt: now, $lt: lockedUntil },
+        }, { lockedUntil });
+        return updated === 1;
+    }
+    async completeJobSuccess(input) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(SchedulerJobEntitySchema);
+        const updated = await repo.nativeUpdate({
+            id: input.jobId,
+            cron: input.cron,
+            lockedBy: input.instanceId,
+            lockedUntil: { $gt: input.now },
+        }, {
+            lockedBy: null,
+            lockedUntil: null,
+            nextRunAt: input.nextRunAt,
+            runCount: input.runCount,
+            lastSuccessAt: input.now,
+        });
+        return updated === 1;
+    }
+    async completeJobFailure(input) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(SchedulerJobEntitySchema);
+        const updated = await repo.nativeUpdate({
+            id: input.jobId,
+            cron: input.cron,
+            lockedBy: input.instanceId,
+            lockedUntil: { $gt: input.now },
+        }, {
+            lockedBy: null,
+            lockedUntil: null,
+            nextRunAt: input.nextRunAt,
+            runCount: input.runCount,
+            lastErrorAt: input.now,
+            lastError: input.error,
+            failureCount: input.failureCount,
+        });
+        return updated === 1;
+    }
+    async findNextRunAt() {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(SchedulerJobEntitySchema);
+        const next = await repo.findOne({ enabled: true, nextRunAt: { $ne: null } }, { orderBy: { nextRunAt: 'ASC' } });
+        return next?.nextRunAt ?? null;
+    }
+}
+export class DatabaseBackgroundJobStore {
+    mikro;
+    constructor(mikro) {
+        this.mikro = mikro;
+    }
+    async enqueue(input) {
+        const em = this.mikro.em.fork();
+        const id = crypto.randomUUID();
+        const job = em.create(BackgroundJobEntitySchema, {
+            id,
+            jobId: input.jobId,
+            payload: stringifyJsonSafePayload(input.payload),
+            status: 'pending',
+            availableAt: input.availableAt,
+            lockedBy: null,
+            lockedUntil: null,
+            attemptCount: 0,
+            maxAttempts: input.maxAttempts,
+            lastError: null,
+            completedAt: null,
+            created_at: input.now,
+            updated_at: input.now,
+        });
+        em.persist(job);
+        await em.flush();
+        return id;
+    }
+    async acquireDueJob(now, lockedUntil, instanceId) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(BackgroundJobEntitySchema);
+        const seenCandidateIds = [];
+        const eligibleFilter = {
+            $or: [
+                {
+                    status: 'pending',
+                    availableAt: { $lte: now },
+                },
+                {
+                    status: 'running',
+                    lockedUntil: { $lte: now },
+                },
+            ],
+        };
+        while (true) {
+            const candidateFilter = {
+                ...eligibleFilter,
+                ...(seenCandidateIds.length > 0
+                    ? { id: { $nin: seenCandidateIds } }
+                    : {}),
+            };
+            const candidate = await repo.findOne(candidateFilter, {
+                orderBy: { availableAt: 'ASC' },
+            });
+            if (!candidate) {
+                return null;
+            }
+            if (candidate.status === 'running' &&
+                candidate.attemptCount >= candidate.maxAttempts) {
+                await repo.nativeUpdate({ id: candidate.id, ...eligibleFilter }, {
+                    status: 'failed',
+                    availableAt: now,
+                    lockedBy: null,
+                    lockedUntil: null,
+                    lastError: 'Background job exceeded maximum attempts',
+                    completedAt: now,
+                });
+                continue;
+            }
+            const attemptCount = candidate.attemptCount + 1;
+            const updated = await repo.nativeUpdate({ id: candidate.id, ...eligibleFilter }, {
+                status: 'running',
+                lockedBy: instanceId,
+                lockedUntil,
+                attemptCount,
+            });
+            if (updated !== 1) {
+                seenCandidateIds.push(candidate.id);
+                continue;
+            }
+            let payload;
+            try {
+                payload = JSON.parse(candidate.payload);
+            }
+            catch (err) {
+                await repo.nativeUpdate({
+                    id: candidate.id,
+                    lockedBy: instanceId,
+                    status: 'running',
+                    lockedUntil: { $gt: now },
+                }, {
+                    status: 'failed',
+                    availableAt: now,
+                    lockedBy: null,
+                    lockedUntil: null,
+                    attemptCount,
+                    lastError: errorToMessage(err),
+                    completedAt: now,
+                });
+                continue;
+            }
+            return {
+                id: candidate.id,
+                jobId: candidate.jobId,
+                payload,
+                attemptCount,
+                maxAttempts: candidate.maxAttempts,
+            };
+        }
+    }
+    async renewLease(id, instanceId, lockedUntil, now) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(BackgroundJobEntitySchema);
+        const updated = await repo.nativeUpdate({
+            id,
+            lockedBy: instanceId,
+            status: 'running',
+            lockedUntil: { $gt: now, $lt: lockedUntil },
+        }, { lockedUntil });
+        return updated === 1;
+    }
+    async completeJobSuccess(input) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(BackgroundJobEntitySchema);
+        const updated = await repo.nativeUpdate({
+            id: input.id,
+            lockedBy: input.instanceId,
+            status: 'running',
+            lockedUntil: { $gt: input.now },
+        }, {
+            status: 'succeeded',
+            lockedBy: null,
+            lockedUntil: null,
+            completedAt: input.now,
+        });
+        return updated === 1;
+    }
+    async completeJobFailure(input) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(BackgroundJobEntitySchema);
+        const updated = await repo.nativeUpdate({
+            id: input.id,
+            lockedBy: input.instanceId,
+            status: 'running',
+            lockedUntil: { $gt: input.now },
+        }, {
+            status: input.retryAt ? 'pending' : 'failed',
+            availableAt: input.retryAt ?? input.now,
+            lockedBy: null,
+            lockedUntil: null,
+            attemptCount: input.attemptCount,
+            lastError: input.error,
+            completedAt: input.retryAt ? null : input.now,
+        });
+        return updated === 1;
+    }
+    async cleanupCompletedJobs(before) {
+        const em = this.mikro.em.fork();
+        const repo = em.getRepository(BackgroundJobEntitySchema);
+        return repo.nativeDelete({
+            status: { $in: ['succeeded', 'failed'] },
+            completedAt: { $lte: before },
+        });
+    }
+}
+function createDatabaseSchedulerConfig(options, mikro) {
+    return {
+        cleanupCron: options.cleanupCron,
+        async start({ scheduledJobs, backgroundJobs, logger }) {
+            const scheduledRunner = new DistributedSchedulerRunner({
+                name: 'Database',
+                pollIntervalMs: options.pollIntervalMs,
+                lockTtlMs: options.lockTtlMs,
+                instanceId: options.instanceId,
+                jobs: scheduledJobs,
+                logger,
+                store: new DatabaseSchedulerStore(mikro),
+            });
+            const backgroundRunner = new DistributedBackgroundJobRunner({
+                name: 'Database',
+                pollIntervalMs: options.pollIntervalMs,
+                lockTtlMs: options.lockTtlMs,
+                retryDelayMs: options.backgroundRetryDelayMs,
+                maxAttempts: options.backgroundMaxAttempts,
+                retentionMs: options.backgroundRetentionMs,
+                instanceId: options.instanceId,
+                jobs: backgroundJobs,
+                logger,
+                store: new DatabaseBackgroundJobStore(mikro),
+            });
+            const scheduledHandle = await scheduledRunner.start();
+            const backgroundHandle = backgroundRunner.start();
+            return {
+                stop: async () => {
+                    await backgroundHandle.stop();
+                    await scheduledHandle.stop();
+                },
+                getNextRunAt: () => scheduledHandle.getNextRunAt?.() ?? null,
+                enqueue: async (enqueueOptions) => {
+                    if (!backgroundHandle.enqueue) {
+                        throw new Error('Background jobs require a durable scheduler backend');
+                    }
+                    return backgroundHandle.enqueue(enqueueOptions);
+                },
+            };
+        },
+    };
+}
+function hasBoundMikro(options) {
+    return 'mikro' in options;
+}
+export function database(options = {}) {
+    const resolved = resolveOptions(options);
+    if (hasBoundMikro(options)) {
+        return createDatabaseSchedulerConfig(resolved, options.mikro);
+    }
+    return ({ mikro }) => createDatabaseSchedulerConfig(resolved, mikro);
+}
+//# sourceMappingURL=database.js.map