oqronkit 0.0.1-alpha.1

package/dist/cron.js

@@ -0,0 +1,215 @@
+'use strict';
+
+require('crypto');
+require('url');
+require('find-up');
+var zod = require('zod');
+var eventemitter3 = require('eventemitter3');
+require('voltlog-io');
+require('better-sqlite3');
+var _cronParser = require('cron-parser');
+require('rrule');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var _cronParser__default = /*#__PURE__*/_interopDefault(_cronParser);
+
+// src/scheduler/cron-engine.ts
+var isIOqronAdapter = (val) => {
+  if (!val || typeof val !== "object") return false;
+  return typeof val.upsertSchedule === "function" && typeof val.getDueSchedules === "function";
+};
+var isILockAdapter = (val) => {
+  if (!val || typeof val !== "object") return false;
+  return typeof val.acquire === "function" && typeof val.renew === "function";
+};
+zod.z.object({
+  project: zod.z.string().optional(),
+  environment: zod.z.string().default("development"),
+  // Infrastructure — Union of explicit DI or declarative config
+  db: zod.z.union([
+    zod.z.custom(
+      isIOqronAdapter,
+      "db must be an instance of IOqronAdapter"
+    ),
+    zod.z.object({
+      adapter: zod.z.enum([
+        "sqlite",
+        "memory",
+        "postgres",
+        "mysql",
+        "mongodb",
+        "redis"
+      ]),
+      url: zod.z.string().optional(),
+      poolMin: zod.z.number().default(2),
+      poolMax: zod.z.number().default(10),
+      tablePrefix: zod.z.string().default("chrono_"),
+      migrations: zod.z.union([zod.z.enum(["auto", "manual"]), zod.z.literal(false)]).default("auto"),
+      ssl: zod.z.boolean().default(false)
+    })
+  ]).optional(),
+  lock: zod.z.union([
+    zod.z.custom(
+      isILockAdapter,
+      "lock must be an instance of ILockAdapter"
+    ),
+    zod.z.object({
+      adapter: zod.z.enum(["db", "memory", "redis"]),
+      url: zod.z.string().optional(),
+      ttl: zod.z.number().default(3e4),
+      retryDelay: zod.z.number().default(200),
+      retryCount: zod.z.number().default(5)
+    })
+  ]).optional(),
+  broker: zod.z.any().optional(),
+  // Modules
+  modules: zod.z.array(
+    zod.z.enum([
+      "cron",
+      "scheduler",
+      "queue",
+      "workflow",
+      "batch",
+      "webhook",
+      "pipeline"
+    ])
+  ).default([]),
+  // Module-specific configs
+  cron: zod.z.object({
+    enable: zod.z.boolean().default(true),
+    timezone: zod.z.string().optional(),
+    tickInterval: zod.z.number().default(1e3),
+    missedFirePolicy: zod.z.enum(["skip", "run-once", "run-all"]).default("run-once"),
+    maxConcurrentJobs: zod.z.number().default(5),
+    leaderElection: zod.z.boolean().default(true),
+    keepJobHistory: zod.z.union([zod.z.boolean(), zod.z.number()]).default(true),
+    keepFailedJobHistory: zod.z.union([zod.z.boolean(), zod.z.number()]).default(true)
+  }).default({}),
+  scheduler: zod.z.object({
+    enable: zod.z.boolean().default(true),
+    tickInterval: zod.z.number().default(1e3),
+    keepJobHistory: zod.z.union([zod.z.boolean(), zod.z.number()]).default(true),
+    keepFailedJobHistory: zod.z.union([zod.z.boolean(), zod.z.number()]).default(true)
+  }).default({}),
+  // Auto-discovery directory
+  jobsDir: zod.z.string().default("./src/jobs"),
+  // Global tags
+  tags: zod.z.array(zod.z.string()).default([]),
+  // Worker
+  worker: zod.z.object({
+    concurrency: zod.z.number().default(50),
+    gracefulShutdownMs: zod.z.number().default(3e4)
+  }).default({ concurrency: 50, gracefulShutdownMs: 3e4 }),
+  // Logger (voltlog-io config or false to disable)
+  logger: zod.z.union([
+    zod.z.literal(false),
+    zod.z.object({
+      enabled: zod.z.boolean().default(true),
+      level: zod.z.string().default("info"),
+      prettify: zod.z.boolean().default(false),
+      showMetadata: zod.z.boolean().default(true),
+      redact: zod.z.array(zod.z.string()).default([])
+    })
+  ]).default({
+    enabled: true,
+    level: "info",
+    prettify: false,
+    showMetadata: true,
+    redact: []
+  }),
+  // Telemetry
+  telemetry: zod.z.object({
+    prometheus: zod.z.object({
+      enabled: zod.z.boolean().default(false),
+      path: zod.z.string().default("/metrics")
+    }).default({}),
+    opentelemetry: zod.z.object({
+      enabled: zod.z.boolean().default(false)
+    }).default({})
+  }).default({}),
+  // Shutdown
+  shutdown: zod.z.object({
+    enabled: zod.z.boolean().default(true),
+    timeout: zod.z.number().default(3e4),
+    signals: zod.z.array(zod.z.string()).default(["SIGINT", "SIGTERM"])
+  }).default({})
+});
+var OqronEventBusClass = class _OqronEventBusClass extends eventemitter3.EventEmitter {
+  static _instance;
+  static getInstance() {
+    if (!_OqronEventBusClass._instance) {
+      _OqronEventBusClass._instance = new _OqronEventBusClass();
+    }
+    return _OqronEventBusClass._instance;
+  }
+};
+OqronEventBusClass.getInstance();
+_cronParser__default.default.default ?? _cronParser__default.default;
+_cronParser__default.default.default ?? _cronParser__default.default;
+
+// src/scheduler/registry.ts
+var GLOBAL_KEY = "__oqronkit_pending_crons__";
+function _getPending() {
+  if (!globalThis[GLOBAL_KEY]) {
+    globalThis[GLOBAL_KEY] = [];
+  }
+  return globalThis[GLOBAL_KEY];
+}
+function _registerCron(def) {
+  _getPending().push(def);
+}
+
+// src/scheduler/define-cron.ts
+var cronParser3 = _cronParser__default.default.default ?? _cronParser__default.default;
+function everyToIntervalMs(every) {
+  let ms = 0;
+  if (every.seconds) ms += every.seconds * 1e3;
+  if (every.minutes) ms += every.minutes * 6e4;
+  if (every.hours) ms += every.hours * 36e5;
+  if (ms <= 0)
+    throw new Error(
+      "[OqronKit] `every` config must resolve to a positive interval"
+    );
+  return ms;
+}
+var cron = (options) => {
+  let expression;
+  let intervalMs;
+  if ("expression" in options && options.expression) {
+    try {
+      cronParser3.parseExpression(options.expression, { tz: options.timezone });
+    } catch {
+      throw new Error(
+        `[OqronKit] Invalid cron expression for "${options.name}": "${options.expression}"`
+      );
+    }
+    expression = options.expression;
+  } else if ("every" in options && options.every) {
+    intervalMs = everyToIntervalMs(options.every);
+  } else {
+    throw new Error(
+      `[OqronKit] Cron "${options.name}" must specify either "expression" or "every"`
+    );
+  }
+  const def = {
+    name: options.name,
+    expression,
+    intervalMs,
+    timezone: options.timezone,
+    missedFire: options.missedFire ?? "skip",
+    overlap: options.overlap ?? "skip",
+    guaranteedWorker: options.guaranteedWorker ?? false,
+    heartbeatMs: options.heartbeatMs,
+    lockTtlMs: options.lockTtlMs,
+    timeout: options.timeout,
+    tags: options.tags ?? [],
+    handler: options.handler,
+    hooks: options.hooks,
+    retries: options.retries
+  };
+  _registerCron(def);
+  return def;
+};
+
+exports.cron = cron;

package/dist/cron.mjs

@@ -0,0 +1 @@
+export { cron } from './chunk-PLN5A6LU.mjs';

package/dist/db/adapters/memory.adapter.d.ts

@@ -0,0 +1,25 @@
+import type { CronDefinition, JobRecord } from "../../core/types/cron.types.js";
+import type { IOqronAdapter } from "../../core/types/db.types.js";
+import type { ScheduleDefinition } from "../../core/types/scheduler.types.js";
+export declare class MemoryOqronAdapter implements IOqronAdapter {
+    private schedules;
+    private jobs;
+    upsertSchedule(def: CronDefinition | ScheduleDefinition): Promise<void>;
+    getDueSchedules(now: Date, limit: number, prefix?: string): Promise<Pick<CronDefinition | ScheduleDefinition, "name">[]>;
+    getSchedules(prefix?: string): Promise<Array<{
+        name: string;
+        lastRunAt: Date | null;
+        nextRunAt: Date | null;
+    }>>;
+    updateNextRun(scheduleId: string, nextRunAt: Date | null): Promise<void>;
+    recordExecution(job: JobRecord): Promise<void>;
+    updateJobProgress(id: string, progressPercent: number, progressLabel?: string): Promise<void>;
+    getExecutions(scheduleId: string, opts: {
+        limit: number;
+        offset: number;
+    }): Promise<JobRecord[]>;
+    getActiveJobs(): Promise<JobRecord[]>;
+    cleanOldExecutions(before: Date): Promise<number>;
+    pruneHistoryForSchedule(scheduleId: string, keepJobHistory: number | boolean, keepFailedJobHistory: number | boolean): Promise<void>;
+}
+//# sourceMappingURL=memory.adapter.d.ts.map

package/dist/db/adapters/memory.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.adapter.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/memory.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAQ9E,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,IAAI,CAAgC;IAEtC,cAAc,CAClB,GAAG,EAAE,cAAc,GAAG,kBAAkB,GACvC,OAAO,CAAC,IAAI,CAAC;IAUV,eAAe,CACnB,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,kBAAkB,EAAE,MAAM,CAAC,EAAE,CAAC;IAYzD,YAAY,CAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CACR,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CACxE;IAcK,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,IAAI,GAAG,IAAI,GACrB,OAAO,CAAC,IAAI,CAAC;IAOV,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9C,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAQV,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,SAAS,EAAE,CAAC;IAOjB,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIrC,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjD,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,OAAO,EAChC,oBAAoB,EAAE,MAAM,GAAG,OAAO,GACrC,OAAO,CAAC,IAAI,CAAC;CA8BjB"}

package/dist/db/adapters/namespaced.adapter.d.ts

@@ -0,0 +1,26 @@
+import type { CronDefinition, IOqronAdapter, JobRecord, ScheduleDefinition } from "../../core/index.js";
+export declare class NamespacedOqronAdapter implements IOqronAdapter {
+    private readonly base;
+    private readonly prefix;
+    constructor(base: IOqronAdapter, project?: string, environment?: string);
+    private ns;
+    private un;
+    upsertSchedule(def: CronDefinition | ScheduleDefinition): Promise<void>;
+    getDueSchedules(now: Date, limit: number, prefix?: string): Promise<Pick<CronDefinition | ScheduleDefinition, "name">[]>;
+    getSchedules(prefix?: string): Promise<Array<{
+        name: string;
+        lastRunAt: Date | null;
+        nextRunAt: Date | null;
+    }>>;
+    updateNextRun(scheduleId: string, nextRunAt: Date | null): Promise<void>;
+    recordExecution(job: JobRecord): Promise<void>;
+    updateJobProgress(id: string, progressPercent: number, progressLabel?: string): Promise<void>;
+    getExecutions(scheduleId: string, opts: {
+        limit: number;
+        offset: number;
+    }): Promise<JobRecord[]>;
+    getActiveJobs(): Promise<JobRecord[]>;
+    cleanOldExecutions(before: Date): Promise<number>;
+    pruneHistoryForSchedule(scheduleId: string, keepJobHistory: number | boolean, keepFailedJobHistory: number | boolean): Promise<void>;
+}
+//# sourceMappingURL=namespaced.adapter.d.ts.map

package/dist/db/adapters/namespaced.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaced.adapter.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/namespaced.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,sBAAuB,YAAW,aAAa;IAIxD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,IAAI,EAAE,aAAa,EACpC,OAAO,GAAE,MAAkB,EAC3B,WAAW,GAAE,MAAsB;IAKrC,OAAO,CAAC,EAAE;IAIV,OAAO,CAAC,EAAE;IAIJ,cAAc,CAClB,GAAG,EAAE,cAAc,GAAG,kBAAkB,GACvC,OAAO,CAAC,IAAI,CAAC;IAIV,eAAe,CACnB,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,kBAAkB,EAAE,MAAM,CAAC,EAAE,CAAC;IAQzD,YAAY,CAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CACR,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CACxE;IAWK,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,IAAI,GAAG,IAAI,GACrB,OAAO,CAAC,IAAI,CAAC;IAIV,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAIV,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,SAAS,EAAE,CAAC;IAQjB,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAUrC,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjD,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,OAAO,EAChC,oBAAoB,EAAE,MAAM,GAAG,OAAO,GACrC,OAAO,CAAC,IAAI,CAAC;CAOjB"}

package/dist/db/adapters/sqlite.adapter.d.ts

@@ -0,0 +1,30 @@
+import Database from "better-sqlite3";
+import type { CronDefinition, IOqronAdapter, JobRecord, ScheduleDefinition } from "../../core/index.js";
+export declare class SqliteAdapter implements IOqronAdapter {
+    private readonly db;
+    /**
+     * @param dbOrPath - Either a `better-sqlite3` Database instance (for testing with `:memory:`)
+     *                   or a file path string. Defaults to `"oqron.sqlite"`.
+     */
+    constructor(dbOrPath?: Database.Database | string);
+    /** Create tables if they don't exist */
+    migrate(): void;
+    upsertSchedule(def: CronDefinition | ScheduleDefinition): Promise<void>;
+    getDueSchedules(now: Date, limit: number, prefix?: string): Promise<Pick<CronDefinition, "name">[]>;
+    getSchedules(prefix?: string): Promise<Array<{
+        name: string;
+        lastRunAt: Date | null;
+        nextRunAt: Date | null;
+    }>>;
+    updateNextRun(scheduleId: string, nextRunAt: Date | null): Promise<void>;
+    updateJobProgress(id: string, progressPercent: number, progressLabel?: string): Promise<void>;
+    recordExecution(job: JobRecord): Promise<void>;
+    getExecutions(scheduleId: string, opts: {
+        limit: number;
+        offset: number;
+    }): Promise<JobRecord[]>;
+    getActiveJobs(): Promise<JobRecord[]>;
+    cleanOldExecutions(before: Date): Promise<number>;
+    pruneHistoryForSchedule(scheduleId: string, keepJobHistory: number | boolean, keepFailedJobHistory: number | boolean): Promise<void>;
+}
+//# sourceMappingURL=sqlite.adapter.d.ts.map

package/dist/db/adapters/sqlite.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.adapter.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/sqlite.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IAEvC;;;OAGG;gBACS,QAAQ,GAAE,QAAQ,CAAC,QAAQ,GAAG,MAAuB;IAYjE,wCAAwC;IACxC,OAAO,IAAI,IAAI;IA8DT,cAAc,CAClB,GAAG,EAAE,cAAc,GAAG,kBAAkB,GACvC,OAAO,CAAC,IAAI,CAAC;IA4CV,eAAe,CACnB,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;IAepC,YAAY,CAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CACR,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CACxE;IAqBK,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,IAAI,GAAG,IAAI,GACrB,OAAO,CAAC,IAAI,CAAC;IAMV,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAQV,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC9C,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,SAAS,EAAE,CAAC;IAqCjB,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAmCrC,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAOjD,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,OAAO,EAChC,oBAAoB,EAAE,MAAM,GAAG,OAAO,GACrC,OAAO,CAAC,IAAI,CAAC;CAmCjB"}

package/dist/db/index.d.ts

@@ -0,0 +1,4 @@
+export { MemoryOqronAdapter } from "./adapters/memory.adapter.js";
+export { NamespacedOqronAdapter } from "./adapters/namespaced.adapter.js";
+export { SqliteAdapter } from "./adapters/sqlite.adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}