@stacksjs/cron 0.70.72 → 0.70.74

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { parseCron } from './parser';
 //   parse('0 0 * * *')          → next midnight UTC
 //   parse('@hourly')            → next hour
 //   parse('0,15,30,45 * * * *') → next 15-min mark
-export declare function parse(expression: string, relativeDate?: Date | number): Date | null;
+export declare function parse(expression: string, relativeDate?: Date | number, options?: import('./parser').ParseCronOptions): Date | null;
 /**
  * Register an OS-level cron job that persists across process restarts.
  *

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-var g={"@yearly":"0 0 1 1 *","@annually":"0 0 1 1 *","@monthly":"0 0 1 * *","@weekly":"0 0 * * 0","@daily":"0 0 * * *","@midnight":"0 0 * * *","@hourly":"0 * * * *"},w={jan:1,feb:2,mar:3,apr:4,may:5,jun:6,jul:7,aug:8,sep:9,oct:10,nov:11,dec:12,january:1,february:2,march:3,april:4,june:6,july:7,august:8,september:9,october:10,november:11,december:12},M={sun:0,mon:1,tue:2,wed:3,thu:4,fri:5,sat:6,sunday:0,monday:1,tuesday:2,wednesday:3,thursday:4,friday:5,saturday:6},S=new Set;function D(q,b){if(S.has(q))return;S.add(q),console.warn(`[cron] 6-field cron expression '${q}' has seconds='${b}' \u2014 the parser is 5-field only. `+"Seconds field IGNORED. For second-precision use the scheduler's '.everySecond()' instead.")}function y(q,b){return q.replace(/[a-z]+/gi,(V)=>{let X=b[V.toLowerCase()];if(X===void 0)throw Error(`Invalid cron value: ${V}`);return String(X)})}function U(q,b,V,X){let _=X?y(q,X):q,Q=new Set;for(let H of _.split(",")){let $=H.match(/^(.+)\/(\d+)$/),R,Z=1;if($){if(R=$[1]??"",Z=Number.parseInt($[2]??"",10),Z<=0)throw Error(`Invalid step: ${Z}`)}else R=H;if(R==="*")for(let C=b;C<=V;C+=Z)Q.add(C);else if(R.includes("-")){let[C,J]=R.split("-"),K=Number.parseInt(C??"",10),Y=Number.parseInt(J??"",10);if(Number.isNaN(K)||Number.isNaN(Y))throw Error(`Invalid range: ${R}`);if(K<b||Y>V)throw Error(`Range out of bounds: ${R} (${b}-${V})`);for(let j=K;j<=Y;j+=Z)Q.add(j)}else{let C=Number.parseInt(R,10);if(Number.isNaN(C))throw Error(`Invalid cron value: ${R}`);if(C<b||C>V)throw Error(`Value out of range: ${C} (${b}-${V})`);Q.add(C)}}return Q}function P(q,b,V={}){let X=q.trim(),Q=(g[X.toLowerCase()]??X).split(/\s+/).filter(Boolean);if(Q.length===6){let L=Q[0];if(L!=="0"&&L!=="*")D(q,L);Q=Q.slice(1)}if(Q.length!==5)throw Error(`Invalid cron expression: expected 5 fields (or 6 with leading seconds), got ${Q.length}`);let[H,$,R,Z,C]=Q,J=U(H,0,59),K=U($,0,23),Y=U(R,1,31),j=U(Z,1,12,w),E=U(C,0,7,M);if(E.has(7))E.add(0),E.delete(7);let k=R==="*",z=C==="*",I=b instanceof Date?b.getTime():typeof b==="number"?b:Date.now();if(Number.isNaN(I)||!Number.isFinite(I))throw Error("Invalid date");let A=V.tz,T=A?x(A):(L)=>({year:L.getUTCFullYear(),month:L.getUTCMonth()+1,day:L.getUTCDate(),hour:L.getUTCHours(),minute:L.getUTCMinutes(),dow:L.getUTCDay()}),G=new Date(I);G.setUTCSeconds(0,0),G.setUTCMinutes(G.getUTCMinutes()+1);let W=G.getTime()+126230400000;while(G.getTime()<W){let L=T(G);if(!j.has(L.month)){G.setUTCMonth(G.getUTCMonth()+1,1),G.setUTCHours(0,0,0,0);continue}let N=Y.has(L.day),O=E.has(L.dow),B;if(k&&z)B=!0;else if(k)B=O;else if(z)B=N;else B=N||O;if(!B){G.setUTCDate(G.getUTCDate()+1),G.setUTCHours(0,0,0,0);continue}if(!K.has(L.hour)){G.setUTCHours(G.getUTCHours()+1,0,0,0);continue}if(!J.has(L.minute)){G.setUTCMinutes(G.getUTCMinutes()+1,0,0);continue}return new Date(G.getTime())}return null}function x(q){let b=new Intl.DateTimeFormat("en-US",{timeZone:q,hourCycle:"h23",year:"numeric",month:"numeric",day:"numeric",hour:"numeric",minute:"numeric",weekday:"short"}),V={Sun:0,Mon:1,Tue:2,Wed:3,Thu:4,Fri:5,Sat:6};return(X)=>{let _=b.formatToParts(X),Q=0,H=0,$=0,R=0,Z=0,C=0;for(let J of _)if(J.type==="year")Q=Number.parseInt(J.value,10);else if(J.type==="month")H=Number.parseInt(J.value,10);else if(J.type==="day")$=Number.parseInt(J.value,10);else if(J.type==="hour")R=Number.parseInt(J.value,10)%24;else if(J.type==="minute")Z=Number.parseInt(J.value,10);else if(J.type==="weekday")C=V[J.value]??0;return{year:Q,month:H,day:$,hour:R,minute:Z,dow:C}}}function v(q,b){if(typeof Bun<"u"&&Bun.cron?.parse)return Bun.cron.parse(q,b);return P(q,b)}async function f(q,b,V){if(typeof Bun>"u"||!Bun.cron)throw Error("Bun.cron is not available. OS-level cron requires a Bun version with native cron support.");await Bun.cron(q,b,V)}async function c(q){if(typeof Bun>"u"||!Bun.cron?.remove)throw Error("Bun.cron is not available. OS-level cron requires a Bun version with native cron support.");await Bun.cron.remove(q)}export{c as remove,f as register,P as parseCron,v as parse};
+var g={"@yearly":"0 0 1 1 *","@annually":"0 0 1 1 *","@monthly":"0 0 1 * *","@weekly":"0 0 * * 0","@daily":"0 0 * * *","@midnight":"0 0 * * *","@hourly":"0 * * * *"},w={jan:1,feb:2,mar:3,apr:4,may:5,jun:6,jul:7,aug:8,sep:9,oct:10,nov:11,dec:12,january:1,february:2,march:3,april:4,june:6,july:7,august:8,september:9,october:10,november:11,december:12},M={sun:0,mon:1,tue:2,wed:3,thu:4,fri:5,sat:6,sunday:0,monday:1,tuesday:2,wednesday:3,thursday:4,friday:5,saturday:6},S=new Set;function D(q,b){if(S.has(q))return;S.add(q),console.warn(`[cron] 6-field cron expression '${q}' has seconds='${b}' \u2014 the parser is 5-field only. `+"Seconds field IGNORED. For second-precision use the scheduler's '.everySecond()' instead.")}function y(q,b){return q.replace(/[a-z]+/gi,(J)=>{let X=b[J.toLowerCase()];if(X===void 0)throw Error(`Invalid cron value: ${J}`);return String(X)})}function U(q,b,J,X){let _=X?y(q,X):q,R=new Set;for(let H of _.split(",")){let $=H.match(/^(.+)\/(\d+)$/),V,Z=1;if($){if(V=$[1]??"",Z=Number.parseInt($[2]??"",10),Z<=0)throw Error(`Invalid step: ${Z}`)}else V=H;if(V==="*")for(let C=b;C<=J;C+=Z)R.add(C);else if(V.includes("-")){let[C,L]=V.split("-"),K=Number.parseInt(C??"",10),Y=Number.parseInt(L??"",10);if(Number.isNaN(K)||Number.isNaN(Y))throw Error(`Invalid range: ${V}`);if(K<b||Y>J)throw Error(`Range out of bounds: ${V} (${b}-${J})`);for(let j=K;j<=Y;j+=Z)R.add(j)}else{let C=Number.parseInt(V,10);if(Number.isNaN(C))throw Error(`Invalid cron value: ${V}`);if(C<b||C>J)throw Error(`Value out of range: ${C} (${b}-${J})`);R.add(C)}}return R}function P(q,b,J={}){let X=q.trim(),R=(g[X.toLowerCase()]??X).split(/\s+/).filter(Boolean);if(R.length===6){let Q=R[0];if(Q!=="0"&&Q!=="*")D(q,Q);R=R.slice(1)}if(R.length!==5)throw Error(`Invalid cron expression: expected 5 fields (or 6 with leading seconds), got ${R.length}`);let[H,$,V,Z,C]=R,L=U(H,0,59),K=U($,0,23),Y=U(V,1,31),j=U(Z,1,12,w),E=U(C,0,7,M);if(E.has(7))E.add(0),E.delete(7);let k=V==="*",z=C==="*",I=b instanceof Date?b.getTime():typeof b==="number"?b:Date.now();if(Number.isNaN(I)||!Number.isFinite(I))throw Error("Invalid date");let A=J.tz,T=A?x(A):(Q)=>({year:Q.getUTCFullYear(),month:Q.getUTCMonth()+1,day:Q.getUTCDate(),hour:Q.getUTCHours(),minute:Q.getUTCMinutes(),dow:Q.getUTCDay()}),G=new Date(I);G.setUTCSeconds(0,0),G.setUTCMinutes(G.getUTCMinutes()+1);let W=G.getTime()+126230400000;while(G.getTime()<W){let Q=T(G);if(!j.has(Q.month)){G.setUTCMonth(G.getUTCMonth()+1,1),G.setUTCHours(0,0,0,0);continue}let N=Y.has(Q.day),O=E.has(Q.dow),B;if(k&&z)B=!0;else if(k)B=O;else if(z)B=N;else B=N||O;if(!B){G.setUTCDate(G.getUTCDate()+1),G.setUTCHours(0,0,0,0);continue}if(!K.has(Q.hour)){G.setUTCHours(G.getUTCHours()+1,0,0,0);continue}if(!L.has(Q.minute)){G.setUTCMinutes(G.getUTCMinutes()+1,0,0);continue}return new Date(G.getTime())}return null}function x(q){let b=new Intl.DateTimeFormat("en-US",{timeZone:q,hourCycle:"h23",year:"numeric",month:"numeric",day:"numeric",hour:"numeric",minute:"numeric",weekday:"short"}),J={Sun:0,Mon:1,Tue:2,Wed:3,Thu:4,Fri:5,Sat:6};return(X)=>{let _=b.formatToParts(X),R=0,H=0,$=0,V=0,Z=0,C=0;for(let L of _)if(L.type==="year")R=Number.parseInt(L.value,10);else if(L.type==="month")H=Number.parseInt(L.value,10);else if(L.type==="day")$=Number.parseInt(L.value,10);else if(L.type==="hour")V=Number.parseInt(L.value,10)%24;else if(L.type==="minute")Z=Number.parseInt(L.value,10);else if(L.type==="weekday")C=J[L.value]??0;return{year:R,month:H,day:$,hour:V,minute:Z,dow:C}}}function v(q,b,J={}){if(typeof Bun<"u"&&Bun.cron?.parse)return Bun.cron.parse(q,b);return P(q,b,J)}async function f(q,b,J){if(typeof Bun>"u"||!Bun.cron)throw Error("Bun.cron is not available. OS-level cron requires a Bun version with native cron support.");await Bun.cron(q,b,J)}async function c(q){if(typeof Bun>"u"||!Bun.cron?.remove)throw Error("Bun.cron is not available. OS-level cron requires a Bun version with native cron support.");await Bun.cron.remove(q)}export{c as remove,f as register,P as parseCron,v as parse};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/cron",
   "type": "module",
-  "version": "0.70.72",
+  "version": "0.70.74",
   "description": "The Stacks cron.",
   "author": "Chris Breuer",
   "contributors": [
@@ -52,6 +52,6 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "better-dx": "^0.2.12"
+    "better-dx": "^0.2.16"
   }
 }