@getstrata/core 0.5.90 → 0.5.91

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @getstrata/core changelog
 
+## 0.5.91
+
+- `Schedule.command()` accepts any expression `Bun.cron.parse` understands. `dueTasks()` uses the next fire time in the current minute instead of a `*/N` whitelist.
+- `Factory.create()` persists `make()` through subclass `persist()` and strips a placeholder `id` of `0`. No states, sequences, or relationships.
+
 ## 0.5.90
 
 - **Breaking identity defaults:** `appKeyPrefix()` is `strata` and `appDisplayName()` is `Strata` when `APP_KEY_PREFIX` / `APP_NAME` are unset (were `workhub` / `WorkHub`). WorkHub pins those env vars.

package/README.md

@@ -82,7 +82,7 @@ import type { Migration } from "@getstrata/core/database/migrations/types";
 Package name: **`@getstrata/core`** (npm org [`@getstrata`](https://www.npmjs.com/org/getstrata)).
 
 1. Add `NPM_TOKEN` to GitHub repository secrets.
-2. Tag a release: `git tag v0.5.95 && git push origin v0.5.95`
+2. Tag a release: `git tag v0.5.96 && git push origin v0.5.96`
 3. [Release workflow](../../.github/workflows/release.yml) builds and runs `npm publish --access public`.
 
 Previously published as `@eyk-workhub/framework@0.1.0`, deprecated in favor of this package.

package/dist/core/database/factory.d.ts

@@ -2,5 +2,8 @@ declare class Factory<TRecord extends object> {
     constructor();
     protected definition(): TRecord;
     make(overrides?: Partial<TRecord>): TRecord;
+    create(overrides?: Partial<TRecord>): Promise<TRecord>;
+    protected insertable(record: TRecord): Partial<TRecord>;
+    protected persist(_values: Partial<TRecord>): Promise<TRecord>;
 }
 export { Factory };

package/dist/core/scheduler/osCron.d.ts

@@ -7,8 +7,10 @@ interface InProcessCronJob {
     unref(): InProcessCronJob;
 }
 declare function parseScheduleExpression(expression: string, from?: Date): Date | null;
+declare function isScheduleExpressionDue(expression: string, now?: Date): boolean;
+declare function assertScheduleExpression(expression: string): void;
 declare function registerInProcessScheduleRunner(run: () => void | Promise<void>, expression?: string): InProcessCronJob;
 declare function installOsScheduleRunner(workerScriptPath: string, expression?: string, title?: string): Promise<void>;
 declare function uninstallOsScheduleRunner(title?: string): Promise<void>;
 export type { InProcessCronJob };
-export { DEFAULT_SCHEDULE_RUN_EXPRESSION, installOsScheduleRunner, OS_CRON_JOB_TITLE, parseScheduleExpression, registerInProcessScheduleRunner, uninstallOsScheduleRunner, };
+export { assertScheduleExpression, DEFAULT_SCHEDULE_RUN_EXPRESSION, installOsScheduleRunner, isScheduleExpressionDue, OS_CRON_JOB_TITLE, parseScheduleExpression, registerInProcessScheduleRunner, uninstallOsScheduleRunner, };

package/dist/entries/database/factory.js

@@ -11,6 +11,19 @@ class Factory {
       ...overrides
     };
   }
+  async create(overrides = {}) {
+    return this.persist(this.insertable(this.make(overrides)));
+  }
+  insertable(record) {
+    const values = { ...record };
+    if (values.id === 0 || values.id === undefined || values.id === null) {
+      delete values.id;
+    }
+    return values;
+  }
+  persist(_values) {
+    throw new Error("Factory.persist() must be implemented to use create().");
+  }
 }
 export {
   Factory

package/dist/entries/scheduler/osCron.js

@@ -5,6 +5,30 @@ var OS_CRON_JOB_TITLE = "getstrata-schedule-run";
 function parseScheduleExpression(expression, from = new Date) {
   return Bun.cron.parse(expression, from);
 }
+function minuteWindow(now) {
+  const start = new Date(now);
+  start.setSeconds(0, 0);
+  return { start, end: new Date(start.getTime() + 60000) };
+}
+function isScheduleExpressionDue(expression, now = new Date) {
+  const { start, end } = minuteWindow(now);
+  const next = parseScheduleExpression(expression, new Date(start.getTime() - 1));
+  if (!next) {
+    return false;
+  }
+  const timestamp = next.getTime();
+  return timestamp >= start.getTime() && timestamp < end.getTime();
+}
+function assertScheduleExpression(expression) {
+  try {
+    const next = parseScheduleExpression(expression);
+    if (!(next instanceof Date) || Number.isNaN(next.getTime())) {
+      throw new Error("unparsable");
+    }
+  } catch {
+    throw new Error(`Unsupported schedule expression "${expression}".`);
+  }
+}
 function registerInProcessScheduleRunner(run, expression = DEFAULT_SCHEDULE_RUN_EXPRESSION) {
   const register = Bun.cron;
   return register(expression, async () => {
@@ -20,7 +44,9 @@ async function uninstallOsScheduleRunner(title = OS_CRON_JOB_TITLE) {
 export {
   DEFAULT_SCHEDULE_RUN_EXPRESSION,
   OS_CRON_JOB_TITLE,
+  assertScheduleExpression,
   installOsScheduleRunner,
+  isScheduleExpressionDue,
   parseScheduleExpression,
   registerInProcessScheduleRunner,
   uninstallOsScheduleRunner

package/dist/entries/scheduler/schedule.js

@@ -1,34 +1,57 @@
 // @bun
-// ../../src/core/scheduler/schedule.ts
-function isSupportedScheduleExpression(expression) {
-  if (expression === "* * * * *") {
-    return true;
+// ../../src/core/scheduler/osCron.ts
+var DEFAULT_SCHEDULE_RUN_EXPRESSION = "* * * * *";
+var OS_CRON_JOB_TITLE = "getstrata-schedule-run";
+function parseScheduleExpression(expression, from = new Date) {
+  return Bun.cron.parse(expression, from);
+}
+function minuteWindow(now) {
+  const start = new Date(now);
+  start.setSeconds(0, 0);
+  return { start, end: new Date(start.getTime() + 60000) };
+}
+function isScheduleExpressionDue(expression, now = new Date) {
+  const { start, end } = minuteWindow(now);
+  const next = parseScheduleExpression(expression, new Date(start.getTime() - 1));
+  if (!next) {
+    return false;
+  }
+  const timestamp = next.getTime();
+  return timestamp >= start.getTime() && timestamp < end.getTime();
+}
+function assertScheduleExpression(expression) {
+  try {
+    const next = parseScheduleExpression(expression);
+    if (!(next instanceof Date) || Number.isNaN(next.getTime())) {
+      throw new Error("unparsable");
+    }
+  } catch {
+    throw new Error(`Unsupported schedule expression "${expression}".`);
   }
-  return /^(\*\/\d+)( \*){4}$/.test(expression);
+}
+function registerInProcessScheduleRunner(run, expression = DEFAULT_SCHEDULE_RUN_EXPRESSION) {
+  const register = Bun.cron;
+  return register(expression, async () => {
+    await run();
+  }).unref();
+}
+async function installOsScheduleRunner(workerScriptPath, expression = DEFAULT_SCHEDULE_RUN_EXPRESSION, title = OS_CRON_JOB_TITLE) {
+  await Bun.cron(workerScriptPath, expression, title);
+}
+async function uninstallOsScheduleRunner(title = OS_CRON_JOB_TITLE) {
+  await Bun.cron.remove(title);
 }
 
+// ../../src/core/scheduler/schedule.ts
 class Schedule {
   tasks = [];
   command(expression, name, run) {
-    if (!isSupportedScheduleExpression(expression)) {
-      throw new Error(`Unsupported schedule expression "${expression}". Only "* * * * *" and "*/N * * * *" are implemented.`);
-    }
+    assertScheduleExpression(expression);
     this.tasks.push({ expression, name, run });
     return this;
   }
   dueTasks(now = new Date) {
-    const minute = now.getMinutes();
-    return this.tasks.filter((task) => {
-      if (task.expression === "* * * * *") {
-        return true;
-      }
-      const intervalMatch = task.expression.match(/^\*\/(\d+)(?: \*){4}$/);
-      if (intervalMatch) {
-        const interval = Number.parseInt(intervalMatch[1] ?? "", 10);
-        return Number.isInteger(interval) && interval > 0 && minute % interval === 0;
-      }
-      return false;
-    });
+    return this.tasks.filter((task) => isScheduleExpressionDue(task.expression, now));
   }
   tasksList() {
     return [...this.tasks];

package/dist/index.js

@@ -6556,36 +6556,45 @@ async function collectQueueMetrics() {
     failedCount
   };
 }
-// ../../src/core/scheduler/schedule.ts
-function isSupportedScheduleExpression(expression) {
-  if (expression === "* * * * *") {
-    return true;
+// ../../src/core/scheduler/osCron.ts
+function parseScheduleExpression(expression, from = new Date) {
+  return Bun.cron.parse(expression, from);
+}
+function minuteWindow(now) {
+  const start = new Date(now);
+  start.setSeconds(0, 0);
+  return { start, end: new Date(start.getTime() + 60000) };
+}
+function isScheduleExpressionDue(expression, now = new Date) {
+  const { start, end } = minuteWindow(now);
+  const next = parseScheduleExpression(expression, new Date(start.getTime() - 1));
+  if (!next) {
+    return false;
+  }
+  const timestamp = next.getTime();
+  return timestamp >= start.getTime() && timestamp < end.getTime();
+}
+function assertScheduleExpression(expression) {
+  try {
+    const next = parseScheduleExpression(expression);
+    if (!(next instanceof Date) || Number.isNaN(next.getTime())) {
+      throw new Error("unparsable");
+    }
+  } catch {
+    throw new Error(`Unsupported schedule expression "${expression}".`);
   }
-  return /^(\*\/\d+)( \*){4}$/.test(expression);
 }
 
+// ../../src/core/scheduler/schedule.ts
 class Schedule {
   tasks = [];
   command(expression, name, run) {
-    if (!isSupportedScheduleExpression(expression)) {
-      throw new Error(`Unsupported schedule expression "${expression}". Only "* * * * *" and "*/N * * * *" are implemented.`);
-    }
+    assertScheduleExpression(expression);
     this.tasks.push({ expression, name, run });
     return this;
   }
   dueTasks(now = new Date) {
-    const minute = now.getMinutes();
-    return this.tasks.filter((task) => {
-      if (task.expression === "* * * * *") {
-        return true;
-      }
-      const intervalMatch = task.expression.match(/^\*\/(\d+)(?: \*){4}$/);
-      if (intervalMatch) {
-        const interval = Number.parseInt(intervalMatch[1] ?? "", 10);
-        return Number.isInteger(interval) && interval > 0 && minute % interval === 0;
-      }
-      return false;
-    });
+    return this.tasks.filter((task) => isScheduleExpressionDue(task.expression, now));
   }
   tasksList() {
     return [...this.tasks];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/core",
-  "version": "0.5.90",
+  "version": "0.5.91",
   "description": "Strata — Laravel-inspired Bun framework public API",
   "type": "module",
   "license": "MIT",