cronsmith 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fariz Prawira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,239 @@
+# cronsmith
+
+[![npm version](https://img.shields.io/npm/v/cronsmith.svg)](https://www.npmjs.com/package/cronsmith)
+[![npm downloads](https://img.shields.io/npm/dm/cronsmith.svg)](https://www.npmjs.com/package/cronsmith)
+![zero dependencies](https://img.shields.io/badge/dependencies-none-brightgreen)
+![types included](https://img.shields.io/badge/types-included-blue)
+[![license MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+Fluent, type-safe, zero-runtime-dependency cron expression builder for TypeScript and JavaScript. Works in Node, Deno, Bun, and the browser.
+
+- Fluent chainable API — `cron().every(5, 'minutes').toString()`
+- Type-safe inputs — `'monday'` autocompletes, `'Munday'` won't compile
+- Validates at the call site — `atHour(25)` throws immediately, not at 2 a.m. when your scheduler silently skips
+- Immutable builder — every method returns a new instance, safe to share and reuse
+- Zero runtime dependencies, ships with TypeScript types
+- Emits standard 5-field cron strings — pair it with any scheduler (`node-cron`, `croner`, system crontab)
+- Tiny surface area — one entry point, one error class, no hidden config
+
+```ts
+import { cron } from 'cronsmith';
+
+// Poll a flaky upstream every 5 minutes — one of the most common cron shapes.
+cron().every(5, 'minutes').toString();
+// → "*/5 * * * *"
+
+// Nightly database backup at 02:30 — single call sets both minute and hour.
+cron().at('02:30').toString();
+// → "30 2 * * *"
+
+// Send the Monday-morning digest. Weekdays use lowercase string literals.
+cron().on('monday').toString();
+// → "* * * * 1"
+
+// Run on the 1st and 15th — payroll, invoicing, mid-month reports.
+cron().dayOfMonth([1, 15]).toString();
+// → "* * 1,15 * *"
+
+// Quarterly cleanup job. Month names are typed literals, not magic numbers.
+cron().inMonth(['january', 'april', 'july', 'october']).toString();
+// → "* * * 1,4,7,10 *"
+
+// Business-hours window — pair with a minute selector to control firing rate.
+cron().betweenHours(9, 17).toString();
+// → "* 9-17 * * *"  (every minute, 09:00–17:59 — chain .every(15,'minutes') etc.)
+
+// Weekend-only batch job — Saturday and Sunday, leaves other fields wild.
+cron().onWeekends().toString();
+// → "* * * * 0,6"
+
+// Wrap-around weekend coverage: Friday through Sunday inclusive.
+cron().betweenDays('friday', 'sunday').toString();
+// → "* * * * 5,6,0"
+```
+
+## Install
+
+```sh
+npm install cronsmith
+# or
+pnpm add cronsmith
+# or
+yarn add cronsmith
+# or
+bun add cronsmith
+```
+
+Both ESM and CommonJS are shipped:
+
+```ts
+import { cron } from 'cronsmith';            // ESM / TypeScript
+const { cron } = require('cronsmith');       // CommonJS
+```
+
+Deno (via npm specifier):
+
+```ts
+import { cron } from 'npm:cronsmith';
+```
+
+Zero runtime dependencies. DevDeps (tsup, vitest, typescript) are not installed for consumers.
+
+## Why
+
+Writing `0 9 * * 1-5` by hand is error-prone and impossible to autocomplete. Cronsmith gives you typed inputs, throws on invalid values at the method call (not when your scheduler silently fails), and produces standard 5-field cron strings.
+
+## API
+
+`cron()` returns an immutable `CronBuilder`. Every method returns a new builder.
+
+### Steps and pins
+
+| Method | Example | Result | Reads as |
+|---|---|---|---|
+| `.everyMinute()` | `.everyMinute()` | `* * * * *` | Every minute, forever |
+| `.every(n, 'minutes')` | `.every(15, 'minutes')` | `*/15 * * * *` | Every 15 minutes |
+| `.every(n, 'hours')` | `.every(2, 'hours')` | `0 */2 * * *` | Once every 2 hours, on the hour |
+| `.every(n, 'days')` | `.every(3, 'days')` | `0 0 */3 * *` | Once a day at midnight, every 3rd day of the month |
+| `.every(n, 'months')` | `.every(2, 'months')` | `0 0 1 */2 *` | Once at midnight on the 1st, every 2nd month of the year |
+| `.atMinute(n)` | `.atMinute(30)` | `30 * * * *` | At minute 30 of every hour |
+| `.atMinute(n[])` | `.atMinute([0, 30])` | `0,30 * * * *` | At minute 0 and minute 30 of every hour |
+| `.atHour(n)` | `.atHour(9)` | `0 9 * * *` | Once a day at 09:00 |
+| `.atHour(n[])` | `.atHour([9, 17])` | `0 9,17 * * *` | Twice a day, at 09:00 and 17:00 |
+| `.at('HH:MM')` | `.at('09:30')` | `30 9 * * *` | Once a day at 09:30 |
+
+### Day / month / day-of-week
+
+| Method | Example | Result | Reads as |
+|---|---|---|---|
+| `.on(day)` | `.on('monday')` | `* * * * 1` | On Mondays |
+| `.on(day[])` | `.on(['monday', 'friday'])` | `* * * * 1,5` | On Mondays and Fridays |
+| `.onWeekdays()` | `.onWeekdays()` | `* * * * 1-5` | Monday through Friday |
+| `.onWeekends()` | `.onWeekends()` | `* * * * 0,6` | Saturday and Sunday |
+| `.dayOfMonth(n)` | `.dayOfMonth(1)` | `* * 1 * *` | On the 1st of every month |
+| `.dayOfMonth(n[])` | `.dayOfMonth([1, 15])` | `* * 1,15 * *` | On the 1st and 15th of every month |
+| `.inMonth(m)` | `.inMonth('june')` | `* * * 6 *` | In June |
+| `.inMonth(m[])` | `.inMonth(['january', 'july'])` | `* * * 1,7 *` | In January and July |
+
+### Ranges
+
+| Method | Example | Result | Reads as |
+|---|---|---|---|
+| `.betweenHours(from, to)` | `.betweenHours(9, 17)` | `* 9-17 * * *` | Hours 9 through 17 |
+| `.betweenDays(from, to)` | `.betweenDays('monday', 'friday')` | `* * * * 1-5` | Monday through Friday |
+| `.betweenMonths(from, to)` | `.betweenMonths('march', 'september')` | `* * * 3-9 *` | March through September |
+
+All three `between*` methods support wrap-around when the start is greater than the end:
+
+- `betweenHours(22, 2)` → `* 22,23,0,1,2 * * *` (overnight window)
+- `betweenDays('friday', 'sunday')` → `* * * * 5,6,0` (weekend straddling the week boundary)
+- `betweenMonths('november', 'february')` → `* * * 11,12,1,2 *` (winter straddling year-end)
+
+### Output
+
+| Method | Result | Reads as |
+|---|---|---|
+| `.toString()` | 5-field cron string | Render the builder as a cron expression you can paste into a scheduler |
+| `.toObject()` | `{ minute, hour, dayOfMonth, month, dayOfWeek }` | Get each field separately, useful for storing in a database or rendering in a UI |
+
+## Rules
+
+**Each field can only be set once.** Re-setting the same field throws `CronsmithError` with code `CONFLICTING_CALL`. To combine values, pass an array:
+
+```ts
+cron().on(['monday', 'friday']).toString();    // ✓ → "* * * * 1,5"
+cron().on('monday').on('friday').toString();   // ✗ throws
+```
+
+**Validation throws at the method call**, not at runtime. `cron().atHour(25)` throws immediately.
+
+**Names are case-insensitive.** TypeScript callers can pass lowercase (`'monday'`), Capitalize (`'Monday'`), or Uppercase (`'MONDAY'`) — all three are typed and autocomplete. At runtime, any case is normalized (`'mOnDaY'` works too, though you'd lose autocomplete on that one).
+
+**Sunday is 0** in output. Wrap-around ranges that cross Saturday→Sunday emit a comma list rather than `5-7`.
+
+**DOM and DOW combine with OR semantics.** This is standard Vixie cron behavior, not a Cronsmith choice:
+
+```ts
+cron().dayOfMonth(1).on('monday').toString();
+// → "* * 1 * 1"
+// Runs on every 1st AND every Monday — not "the 1st only if Monday."
+```
+
+**Pinning methods soft-default smaller fields.** Without this, `*` in the smaller fields would multiply firings by 60 / 1,440 / etc., which is almost never what "at 9 AM" or "every 3 days" means. Defaults are overridable in either call order.
+
+| Method | Pins | Smaller fields soft-defaulted to |
+|---|---|---|
+| `.atHour(...)` | hour | minute = 0 |
+| `.every(n, 'hours')` | hour | minute = 0 |
+| `.every(n, 'days')` | dayOfMonth | minute = 0, hour = 0 |
+| `.every(n, 'months')` | month | minute = 0, hour = 0, dayOfMonth = 1 |
+
+```ts
+cron().atHour(9).toString();                       // → "0 9 * * *"     (once a day at 09:00)
+cron().atMinute(30).atHour(9).toString();          // → "30 9 * * *"    (override, order-independent)
+
+cron().every(2, 'hours').toString();               // → "0 */2 * * *"   (12 firings a day)
+cron().every(3, 'days').toString();                // → "0 0 */3 * *"   (~10 firings a month, at midnight)
+cron().every(3, 'days').at('09:30').toString();    // → "30 9 */3 * *"  (override time, keep day step)
+cron().every(2, 'months').toString();              // → "0 0 1 */2 *"   (6 firings a year, on the 1st at midnight)
+```
+
+**Range and selector methods do not soft-default time.** `.betweenHours()`, `.betweenDays()`, `.betweenMonths()`, `.on()`, `.dayOfMonth()`, and `.inMonth()` only set their own field. Minute and hour stay `*` so they compose cleanly with `.every(N, 'minutes')` or `.atMinute(...)`:
+
+```ts
+cron().betweenHours(9, 17).toString();             // → "* 9-17 * * *"   (every minute, 9–17)
+cron().every(15, 'minutes').betweenHours(9, 17).toString();
+// → "*/15 9-17 * * *"  (the usual business-hours pattern)
+```
+
+**`.every(n, ...)` resets at the next-larger field boundary.** `*/n` in cron is calendar-aligned, not period-true. The step restarts when the next-larger field rolls over, so the gap between firings can be uneven:
+
+| Step | Aligns evenly when | Otherwise the gap shows up at |
+|---|---|---|
+| `every(n, 'minutes')` | `60 % n === 0` | the top of the next hour |
+| `every(n, 'hours')` | `24 % n === 0` | midnight (e.g. `every(5,'hours')` → 4-hour gap) |
+| `every(n, 'days')` | never (month lengths vary 28–31) | the 1st of each month |
+| `every(n, 'months')` | `12 % n === 0` | January (e.g. `every(5,'months')` → 2-month gap) |
+
+If you need a true fixed period, cron is the wrong tool — use a scheduler that tracks "last fired" timestamps.
+
+## What's not included
+
+- ❌ Natural language parsing
+- ❌ Job scheduling / execution (use `node-cron`, `croner`)
+- ❌ `cron.parse()`
+- ❌ Seconds, year, or Quartz `L`/`W`/`#`
+- ❌ Timezone handling (that's the scheduler's job)
+
+## Errors
+
+All validation errors are `CronsmithError` with a `code` field:
+
+```ts
+import { CronsmithError } from 'cronsmith';
+
+try {
+  cron().atHour(25);
+} catch (e) {
+  if (e instanceof CronsmithError && e.code === 'INVALID_HOUR') {
+    // ...
+  }
+}
+```
+
+Codes:
+
+- `INVALID_MINUTE` — minute value outside 0–59 (e.g. `.atMinute(60)`)
+- `INVALID_HOUR` — hour value outside 0–23 (e.g. `.atHour(25)`)
+- `INVALID_TIME` — malformed `HH:MM` string passed to `.at()` (e.g. `.at('9:00')` or `.at('25:00')`)
+- `INVALID_DAY_OF_MONTH` — day value outside 1–31 (e.g. `.dayOfMonth(32)`)
+- `INVALID_WEEKDAY` — unrecognized weekday name (e.g. `.on('funday')`)
+- `INVALID_MONTH` — unrecognized month name (e.g. `.inMonth('smarch')`)
+- `INVALID_STEP` — step value less than 1 or beyond the unit's max (e.g. `.every(0, 'hours')`, `.every(60, 'hours')`)
+- `INVALID_RANGE` — out-of-bounds value passed to a `between*()` method (e.g. `.betweenHours(9, 24)`)
+- `INVALID_UNIT` — unrecognized argument to `.every()` (e.g. `.every(5, 'seconds')`)
+- `CONFLICTING_CALL` — the same field was set twice (e.g. `.atMinute(5).atMinute(10)`); see Rules for how soft defaults interact with this
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,314 @@
+'use strict';
+
+// src/errors.ts
+var CronsmithError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "CronsmithError";
+    this.code = code;
+  }
+};
+
+// src/serializer.ts
+var serialize = (f) => `${f.minute} ${f.hour} ${f.dayOfMonth} ${f.month} ${f.dayOfWeek}`;
+var formatList = (values) => {
+  const sorted = [...new Set(values)].sort((a, b) => a - b);
+  return sorted.join(",");
+};
+var formatStep = (n) => n === 1 ? "*" : `*/${n}`;
+var formatRange = (start, end) => start === end ? String(start) : `${start}-${end}`;
+
+// src/constants.ts
+var WEEKDAYS = [
+  "sunday",
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday"
+];
+var WEEKDAY_TO_NUM = {
+  sunday: 0,
+  monday: 1,
+  tuesday: 2,
+  wednesday: 3,
+  thursday: 4,
+  friday: 5,
+  saturday: 6
+};
+var MONTHS = [
+  "january",
+  "february",
+  "march",
+  "april",
+  "may",
+  "june",
+  "july",
+  "august",
+  "september",
+  "october",
+  "november",
+  "december"
+];
+var MONTH_TO_NUM = {
+  january: 1,
+  february: 2,
+  march: 3,
+  april: 4,
+  may: 5,
+  june: 6,
+  july: 7,
+  august: 8,
+  september: 9,
+  october: 10,
+  november: 11,
+  december: 12
+};
+var FIELD_MAX = {
+  minutes: 59,
+  hours: 23,
+  days: 31,
+  months: 12
+};
+var TIME_UNITS = ["minutes", "hours", "days", "months"];
+
+// src/validators.ts
+var isInt = (n) => typeof n === "number" && Number.isInteger(n) && Number.isFinite(n);
+var assertMinute = (m) => {
+  if (!isInt(m) || m < 0 || m > 59) {
+    throw new CronsmithError("INVALID_MINUTE", `Invalid minute: ${m} (expected 0-59)`);
+  }
+};
+var assertHour = (h) => {
+  if (!isInt(h) || h < 0 || h > 23) {
+    throw new CronsmithError("INVALID_HOUR", `Invalid hour: ${h} (expected 0-23)`);
+  }
+};
+var assertDayOfMonth = (d) => {
+  if (!isInt(d) || d < 1 || d > 31) {
+    throw new CronsmithError("INVALID_DAY_OF_MONTH", `Invalid day of month: ${d} (expected 1-31)`);
+  }
+};
+var TIME_RE = /^([0-9]{2}):([0-9]{2})$/;
+var parseTime = (s) => {
+  const m = TIME_RE.exec(s);
+  if (!m) {
+    throw new CronsmithError(
+      "INVALID_TIME",
+      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`
+    );
+  }
+  const hour = Number(m[1]);
+  const minute = Number(m[2]);
+  if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+    throw new CronsmithError(
+      "INVALID_TIME",
+      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`
+    );
+  }
+  return { hour, minute };
+};
+var normalizeWeekday = (raw) => {
+  const lc = raw.toLowerCase();
+  if (!WEEKDAYS.includes(lc)) {
+    throw new CronsmithError(
+      "INVALID_WEEKDAY",
+      `Invalid weekday: '${raw}' (expected one of: ${WEEKDAYS.join(", ")})`
+    );
+  }
+  return lc;
+};
+var normalizeMonth = (raw) => {
+  const lc = raw.toLowerCase();
+  if (!MONTHS.includes(lc)) {
+    throw new CronsmithError(
+      "INVALID_MONTH",
+      `Invalid month: '${raw}' (expected one of: ${MONTHS.join(", ")})`
+    );
+  }
+  return lc;
+};
+var assertTimeUnit = (u) => {
+  if (!TIME_UNITS.includes(u)) {
+    throw new CronsmithError(
+      "INVALID_UNIT",
+      `Invalid time unit: '${u}' (expected one of: ${TIME_UNITS.join(", ")})`
+    );
+  }
+  return u;
+};
+var assertStep = (n, unit) => {
+  if (!isInt(n) || n < 1) {
+    throw new CronsmithError("INVALID_STEP", `Step must be >= 1, got ${n}`);
+  }
+  const max = FIELD_MAX[unit];
+  if (n > max) {
+    throw new CronsmithError(
+      "INVALID_STEP",
+      `Step ${n} exceeds max for ${unit} (${max})`
+    );
+  }
+};
+var assertHourRange = (start, end) => {
+  assertHour(start);
+  assertHour(end);
+};
+var weekdayNum = (w) => WEEKDAY_TO_NUM[w];
+var monthNum = (m) => MONTH_TO_NUM[m];
+
+// src/builder.ts
+var FRESH_FIELDS = {
+  minute: "*",
+  hour: "*",
+  dayOfMonth: "*",
+  month: "*",
+  dayOfWeek: "*"
+};
+var FRESH_TOUCHED = {
+  minute: "untouched",
+  hour: "untouched",
+  dayOfMonth: "untouched",
+  month: "untouched",
+  dayOfWeek: "untouched"
+};
+var FIELD_LABEL = {
+  minute: "minute",
+  hour: "hour",
+  dayOfMonth: "day-of-month",
+  month: "month",
+  dayOfWeek: "day-of-week"
+};
+var toList = (x) => Array.isArray(x) ? x : [x];
+var wrapList = (start, end, min, max) => {
+  const out = [];
+  for (let v = start; v <= max; v++) out.push(v);
+  for (let v = min; v <= end; v++) out.push(v);
+  return out;
+};
+var CronBuilder = class _CronBuilder {
+  fields;
+  touched;
+  constructor(fields = FRESH_FIELDS, touched = FRESH_TOUCHED) {
+    this.fields = fields;
+    this.touched = touched;
+  }
+  // hardKeys throw on conflict and become 'hard'; softPatch applies only to
+  // 'untouched' fields and becomes 'soft' (a later hard call overrides it
+  // silently). This is what makes pinning order-independent.
+  clone(patch, hardKeys, softPatch) {
+    for (const k of hardKeys) {
+      if (this.touched[k] === "hard") {
+        throw new CronsmithError(
+          "CONFLICTING_CALL",
+          `${FIELD_LABEL[k]} field has already been set. To combine values, pass an array (e.g. atMinute([5, 35])) instead of chaining.`
+        );
+      }
+    }
+    const nextFields = { ...this.fields, ...patch };
+    const nextTouched = { ...this.touched };
+    for (const k of hardKeys) nextTouched[k] = "hard";
+    if (softPatch) {
+      for (const k of Object.keys(softPatch)) {
+        if (this.touched[k] === "untouched") {
+          nextFields[k] = softPatch[k];
+          nextTouched[k] = "soft";
+        }
+      }
+    }
+    return new _CronBuilder(nextFields, nextTouched);
+  }
+  everyMinute() {
+    return this.clone({ minute: "*" }, ["minute"]);
+  }
+  // Soft-defaults below pin smaller fields so every(n, X) fires once per
+  // qualifying X instead of inheriting * from the unset fields.
+  every(n, unit) {
+    const u = assertTimeUnit(unit);
+    assertStep(n, u);
+    if (u === "minutes") return this.clone({ minute: formatStep(n) }, ["minute"]);
+    if (u === "hours") {
+      return this.clone({ hour: formatStep(n) }, ["hour"], { minute: "0" });
+    }
+    if (u === "days") {
+      return this.clone({ dayOfMonth: formatStep(n) }, ["dayOfMonth"], {
+        minute: "0",
+        hour: "0"
+      });
+    }
+    return this.clone({ month: formatStep(n) }, ["month"], {
+      minute: "0",
+      hour: "0",
+      dayOfMonth: "1"
+    });
+  }
+  atMinute(m) {
+    const list = toList(m);
+    for (const v of list) assertMinute(v);
+    return this.clone({ minute: formatList(list) }, ["minute"]);
+  }
+  atHour(h) {
+    const list = toList(h);
+    for (const v of list) assertHour(v);
+    return this.clone({ hour: formatList(list) }, ["hour"], { minute: "0" });
+  }
+  at(time) {
+    const { hour, minute } = parseTime(time);
+    return this.clone({ minute: String(minute), hour: String(hour) }, ["minute", "hour"]);
+  }
+  on(day) {
+    const nums = toList(day).map((d) => weekdayNum(normalizeWeekday(d)));
+    return this.clone({ dayOfWeek: formatList(nums) }, ["dayOfWeek"]);
+  }
+  onWeekdays() {
+    return this.clone({ dayOfWeek: "1-5" }, ["dayOfWeek"]);
+  }
+  onWeekends() {
+    return this.clone({ dayOfWeek: "0,6" }, ["dayOfWeek"]);
+  }
+  dayOfMonth(d) {
+    const list = toList(d);
+    for (const v of list) assertDayOfMonth(v);
+    return this.clone({ dayOfMonth: formatList(list) }, ["dayOfMonth"]);
+  }
+  inMonth(m) {
+    const nums = toList(m).map((x) => monthNum(normalizeMonth(x)));
+    return this.clone({ month: formatList(nums) }, ["month"]);
+  }
+  betweenHours(start, end) {
+    assertHourRange(start, end);
+    if (start <= end) return this.clone({ hour: formatRange(start, end) }, ["hour"]);
+    const hours = wrapList(start, end, 0, 23);
+    return this.clone({ hour: hours.join(",") }, ["hour"]);
+  }
+  betweenDays(start, end) {
+    const s = weekdayNum(normalizeWeekday(start));
+    const e = weekdayNum(normalizeWeekday(end));
+    if (s <= e) return this.clone({ dayOfWeek: formatRange(s, e) }, ["dayOfWeek"]);
+    const days = wrapList(s, e, 0, 6);
+    return this.clone({ dayOfWeek: days.join(",") }, ["dayOfWeek"]);
+  }
+  betweenMonths(start, end) {
+    const s = monthNum(normalizeMonth(start));
+    const e = monthNum(normalizeMonth(end));
+    if (s <= e) return this.clone({ month: formatRange(s, e) }, ["month"]);
+    const months = wrapList(s, e, 1, 12);
+    return this.clone({ month: months.join(",") }, ["month"]);
+  }
+  toString() {
+    return serialize(this.fields);
+  }
+  toObject() {
+    return { ...this.fields };
+  }
+};
+
+// src/index.ts
+var cron = () => new CronBuilder();
+
+exports.CronBuilder = CronBuilder;
+exports.CronsmithError = CronsmithError;
+exports.cron = cron;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/serializer.ts","../src/constants.ts","../src/validators.ts","../src/builder.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { CronErrorCode } from './types.js';\n\nexport class CronsmithError extends Error {\n  readonly code: CronErrorCode;\n\n  constructor(code: CronErrorCode, message: string) {\n    super(message);\n    this.name = 'CronsmithError';\n    this.code = code;\n  }\n}\n","import type { CronFields } from './types.js';\n\nexport const serialize = (f: CronFields): string =>\n  `${f.minute} ${f.hour} ${f.dayOfMonth} ${f.month} ${f.dayOfWeek}`;\n\nexport const formatList = (values: readonly number[]): string => {\n  const sorted = [...new Set(values)].sort((a, b) => a - b);\n  return sorted.join(',');\n};\n\nexport const formatStep = (n: number): string => (n === 1 ? '*' : `*/${n}`);\n\nexport const formatRange = (start: number, end: number): string =>\n  start === end ? String(start) : `${start}-${end}`;\n","import type { Month, TimeUnit, Weekday } from './types.js';\n\nexport const WEEKDAYS: readonly Weekday[] = [\n  'sunday',\n  'monday',\n  'tuesday',\n  'wednesday',\n  'thursday',\n  'friday',\n  'saturday',\n] as const;\n\nexport const WEEKDAY_TO_NUM: Record<Weekday, number> = {\n  sunday: 0,\n  monday: 1,\n  tuesday: 2,\n  wednesday: 3,\n  thursday: 4,\n  friday: 5,\n  saturday: 6,\n};\n\nexport const MONTHS: readonly Month[] = [\n  'january',\n  'february',\n  'march',\n  'april',\n  'may',\n  'june',\n  'july',\n  'august',\n  'september',\n  'october',\n  'november',\n  'december',\n] as const;\n\nexport const MONTH_TO_NUM: Record<Month, number> = {\n  january: 1,\n  february: 2,\n  march: 3,\n  april: 4,\n  may: 5,\n  june: 6,\n  july: 7,\n  august: 8,\n  september: 9,\n  october: 10,\n  november: 11,\n  december: 12,\n};\n\nexport const FIELD_MAX: Record<TimeUnit, number> = {\n  minutes: 59,\n  hours: 23,\n  days: 31,\n  months: 12,\n};\n\nexport const FIELD_MIN: Record<TimeUnit, number> = {\n  minutes: 0,\n  hours: 0,\n  days: 1,\n  months: 1,\n};\n\nexport const TIME_UNITS: readonly TimeUnit[] = ['minutes', 'hours', 'days', 'months'] as const;\n","import { FIELD_MAX, MONTH_TO_NUM, MONTHS, TIME_UNITS, WEEKDAY_TO_NUM, WEEKDAYS } from './constants.js';\nimport { CronsmithError } from './errors.js';\nimport type { Month, TimeUnit, Weekday } from './types.js';\n\nconst isInt = (n: unknown): n is number =>\n  typeof n === 'number' && Number.isInteger(n) && Number.isFinite(n);\n\nexport const assertMinute = (m: number): void => {\n  if (!isInt(m) || m < 0 || m > 59) {\n    throw new CronsmithError('INVALID_MINUTE', `Invalid minute: ${m} (expected 0-59)`);\n  }\n};\n\nexport const assertHour = (h: number): void => {\n  if (!isInt(h) || h < 0 || h > 23) {\n    throw new CronsmithError('INVALID_HOUR', `Invalid hour: ${h} (expected 0-23)`);\n  }\n};\n\nexport const assertDayOfMonth = (d: number): void => {\n  if (!isInt(d) || d < 1 || d > 31) {\n    throw new CronsmithError('INVALID_DAY_OF_MONTH', `Invalid day of month: ${d} (expected 1-31)`);\n  }\n};\n\nconst TIME_RE = /^([0-9]{2}):([0-9]{2})$/;\n\nexport const parseTime = (s: string): { hour: number; minute: number } => {\n  const m = TIME_RE.exec(s);\n  if (!m) {\n    throw new CronsmithError(\n      'INVALID_TIME',\n      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`,\n    );\n  }\n  const hour = Number(m[1]);\n  const minute = Number(m[2]);\n  if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {\n    throw new CronsmithError(\n      'INVALID_TIME',\n      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`,\n    );\n  }\n  return { hour, minute };\n};\n\nexport const normalizeWeekday = (raw: string): Weekday => {\n  const lc = raw.toLowerCase();\n  if (!(WEEKDAYS as readonly string[]).includes(lc)) {\n    throw new CronsmithError(\n      'INVALID_WEEKDAY',\n      `Invalid weekday: '${raw}' (expected one of: ${WEEKDAYS.join(', ')})`,\n    );\n  }\n  return lc as Weekday;\n};\n\nexport const normalizeMonth = (raw: string): Month => {\n  const lc = raw.toLowerCase();\n  if (!(MONTHS as readonly string[]).includes(lc)) {\n    throw new CronsmithError(\n      'INVALID_MONTH',\n      `Invalid month: '${raw}' (expected one of: ${MONTHS.join(', ')})`,\n    );\n  }\n  return lc as Month;\n};\n\nexport const assertTimeUnit = (u: string): TimeUnit => {\n  if (!(TIME_UNITS as readonly string[]).includes(u)) {\n    throw new CronsmithError(\n      'INVALID_UNIT',\n      `Invalid time unit: '${u}' (expected one of: ${TIME_UNITS.join(', ')})`,\n    );\n  }\n  return u as TimeUnit;\n};\n\nexport const assertStep = (n: number, unit: TimeUnit): void => {\n  if (!isInt(n) || n < 1) {\n    throw new CronsmithError('INVALID_STEP', `Step must be >= 1, got ${n}`);\n  }\n  const max = FIELD_MAX[unit];\n  if (n > max) {\n    throw new CronsmithError(\n      'INVALID_STEP',\n      `Step ${n} exceeds max for ${unit} (${max})`,\n    );\n  }\n};\n\nexport const assertHourRange = (start: number, end: number): void => {\n  assertHour(start);\n  assertHour(end);\n};\n\nexport const weekdayNum = (w: Weekday): number => WEEKDAY_TO_NUM[w];\nexport const monthNum = (m: Month): number => MONTH_TO_NUM[m];\n","import { CronsmithError } from './errors.js';\nimport { formatList, formatRange, formatStep, serialize } from './serializer.js';\nimport type { CronFields, MonthInput, TimeUnit, WeekdayInput } from './types.js';\nimport {\n  assertDayOfMonth,\n  assertHour,\n  assertHourRange,\n  assertMinute,\n  assertStep,\n  assertTimeUnit,\n  monthNum,\n  normalizeMonth,\n  normalizeWeekday,\n  parseTime,\n  weekdayNum,\n} from './validators.js';\n\ntype TouchState = 'hard' | 'soft' | 'untouched';\n\ntype Touched = {\n  minute: TouchState;\n  hour: TouchState;\n  dayOfMonth: TouchState;\n  month: TouchState;\n  dayOfWeek: TouchState;\n};\n\nconst FRESH_FIELDS: CronFields = {\n  minute: '*',\n  hour: '*',\n  dayOfMonth: '*',\n  month: '*',\n  dayOfWeek: '*',\n};\n\nconst FRESH_TOUCHED: Touched = {\n  minute: 'untouched',\n  hour: 'untouched',\n  dayOfMonth: 'untouched',\n  month: 'untouched',\n  dayOfWeek: 'untouched',\n};\n\nconst FIELD_LABEL: Record<keyof Touched, string> = {\n  minute: 'minute',\n  hour: 'hour',\n  dayOfMonth: 'day-of-month',\n  month: 'month',\n  dayOfWeek: 'day-of-week',\n};\n\nconst toList = <T>(x: T | readonly T[]): readonly T[] =>\n  Array.isArray(x) ? (x as readonly T[]) : [x as T];\n\nconst wrapList = (start: number, end: number, min: number, max: number): number[] => {\n  // Enumerate values from start..max then min..end. Used when a range wraps\n  // around the field boundary (e.g. Fri→Sun on weekdays, Nov→Feb on months).\n  const out: number[] = [];\n  for (let v = start; v <= max; v++) out.push(v);\n  for (let v = min; v <= end; v++) out.push(v);\n  return out;\n};\n\nexport class CronBuilder {\n  private readonly fields: CronFields;\n  private readonly touched: Touched;\n\n  constructor(fields: CronFields = FRESH_FIELDS, touched: Touched = FRESH_TOUCHED) {\n    this.fields = fields;\n    this.touched = touched;\n  }\n\n  // hardKeys throw on conflict and become 'hard'; softPatch applies only to\n  // 'untouched' fields and becomes 'soft' (a later hard call overrides it\n  // silently). This is what makes pinning order-independent.\n  private clone(\n    patch: Partial<CronFields>,\n    hardKeys: readonly (keyof Touched)[],\n    softPatch?: Partial<CronFields>,\n  ): CronBuilder {\n    for (const k of hardKeys) {\n      if (this.touched[k] === 'hard') {\n        throw new CronsmithError(\n          'CONFLICTING_CALL',\n          `${FIELD_LABEL[k]} field has already been set. To combine values, pass an array (e.g. atMinute([5, 35])) instead of chaining.`,\n        );\n      }\n    }\n    const nextFields: CronFields = { ...this.fields, ...patch };\n    const nextTouched: Touched = { ...this.touched };\n    for (const k of hardKeys) nextTouched[k] = 'hard';\n    if (softPatch) {\n      for (const k of Object.keys(softPatch) as (keyof CronFields)[]) {\n        if (this.touched[k] === 'untouched') {\n          nextFields[k] = softPatch[k]!;\n          nextTouched[k] = 'soft';\n        }\n      }\n    }\n    return new CronBuilder(nextFields, nextTouched);\n  }\n\n  everyMinute(): CronBuilder {\n    return this.clone({ minute: '*' }, ['minute']);\n  }\n\n  // Soft-defaults below pin smaller fields so every(n, X) fires once per\n  // qualifying X instead of inheriting * from the unset fields.\n  every(n: number, unit: TimeUnit): CronBuilder {\n    const u = assertTimeUnit(unit);\n    assertStep(n, u);\n    if (u === 'minutes') return this.clone({ minute: formatStep(n) }, ['minute']);\n    if (u === 'hours') {\n      return this.clone({ hour: formatStep(n) }, ['hour'], { minute: '0' });\n    }\n    if (u === 'days') {\n      return this.clone({ dayOfMonth: formatStep(n) }, ['dayOfMonth'], {\n        minute: '0',\n        hour: '0',\n      });\n    }\n    return this.clone({ month: formatStep(n) }, ['month'], {\n      minute: '0',\n      hour: '0',\n      dayOfMonth: '1',\n    });\n  }\n\n  atMinute(m: number | readonly number[]): CronBuilder {\n    const list = toList(m);\n    for (const v of list) assertMinute(v);\n    return this.clone({ minute: formatList(list) }, ['minute']);\n  }\n\n  atHour(h: number | readonly number[]): CronBuilder {\n    const list = toList(h);\n    for (const v of list) assertHour(v);\n    return this.clone({ hour: formatList(list) }, ['hour'], { minute: '0' });\n  }\n\n  at(time: string): CronBuilder {\n    const { hour, minute } = parseTime(time);\n    return this.clone({ minute: String(minute), hour: String(hour) }, ['minute', 'hour']);\n  }\n\n  on(day: WeekdayInput | readonly WeekdayInput[]): CronBuilder {\n    const nums = toList(day).map((d) => weekdayNum(normalizeWeekday(d)));\n    return this.clone({ dayOfWeek: formatList(nums) }, ['dayOfWeek']);\n  }\n\n  onWeekdays(): CronBuilder {\n    return this.clone({ dayOfWeek: '1-5' }, ['dayOfWeek']);\n  }\n\n  onWeekends(): CronBuilder {\n    return this.clone({ dayOfWeek: '0,6' }, ['dayOfWeek']);\n  }\n\n  dayOfMonth(d: number | readonly number[]): CronBuilder {\n    const list = toList(d);\n    for (const v of list) assertDayOfMonth(v);\n    return this.clone({ dayOfMonth: formatList(list) }, ['dayOfMonth']);\n  }\n\n  inMonth(m: MonthInput | readonly MonthInput[]): CronBuilder {\n    const nums = toList(m).map((x) => monthNum(normalizeMonth(x)));\n    return this.clone({ month: formatList(nums) }, ['month']);\n  }\n\n  betweenHours(start: number, end: number): CronBuilder {\n    assertHourRange(start, end);\n    if (start <= end) return this.clone({ hour: formatRange(start, end) }, ['hour']);\n    const hours = wrapList(start, end, 0, 23);\n    return this.clone({ hour: hours.join(',') }, ['hour']);\n  }\n\n  betweenDays(start: WeekdayInput, end: WeekdayInput): CronBuilder {\n    const s = weekdayNum(normalizeWeekday(start));\n    const e = weekdayNum(normalizeWeekday(end));\n    if (s <= e) return this.clone({ dayOfWeek: formatRange(s, e) }, ['dayOfWeek']);\n    const days = wrapList(s, e, 0, 6);\n    return this.clone({ dayOfWeek: days.join(',') }, ['dayOfWeek']);\n  }\n\n  betweenMonths(start: MonthInput, end: MonthInput): CronBuilder {\n    const s = monthNum(normalizeMonth(start));\n    const e = monthNum(normalizeMonth(end));\n    if (s <= e) return this.clone({ month: formatRange(s, e) }, ['month']);\n    const months = wrapList(s, e, 1, 12);\n    return this.clone({ month: months.join(',') }, ['month']);\n  }\n\n  toString(): string {\n    return serialize(this.fields);\n  }\n\n  toObject(): CronFields {\n    return { ...this.fields };\n  }\n}\n","import { CronBuilder } from './builder.js';\n\nexport const cron = (): CronBuilder => new CronBuilder();\n\nexport { CronBuilder } from './builder.js';\nexport { CronsmithError } from './errors.js';\nexport type {\n  CronErrorCode,\n  CronFields,\n  Month,\n  MonthInput,\n  TimeUnit,\n  Weekday,\n  WeekdayInput,\n} from './types.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+type Weekday = 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
+type WeekdayInput = Weekday | Capitalize<Weekday> | Uppercase<Weekday>;
+type Month = 'january' | 'february' | 'march' | 'april' | 'may' | 'june' | 'july' | 'august' | 'september' | 'october' | 'november' | 'december';
+type MonthInput = Month | Capitalize<Month> | Uppercase<Month>;
+type TimeUnit = 'minutes' | 'hours' | 'days' | 'months';
+type CronFields = {
+    minute: string;
+    hour: string;
+    dayOfMonth: string;
+    month: string;
+    dayOfWeek: string;
+};
+type CronErrorCode = 'INVALID_MINUTE' | 'INVALID_HOUR' | 'INVALID_TIME' | 'INVALID_DAY_OF_MONTH' | 'INVALID_WEEKDAY' | 'INVALID_MONTH' | 'INVALID_STEP' | 'INVALID_RANGE' | 'INVALID_UNIT' | 'CONFLICTING_CALL';
+
+type TouchState = 'hard' | 'soft' | 'untouched';
+type Touched = {
+    minute: TouchState;
+    hour: TouchState;
+    dayOfMonth: TouchState;
+    month: TouchState;
+    dayOfWeek: TouchState;
+};
+declare class CronBuilder {
+    private readonly fields;
+    private readonly touched;
+    constructor(fields?: CronFields, touched?: Touched);
+    private clone;
+    everyMinute(): CronBuilder;
+    every(n: number, unit: TimeUnit): CronBuilder;
+    atMinute(m: number | readonly number[]): CronBuilder;
+    atHour(h: number | readonly number[]): CronBuilder;
+    at(time: string): CronBuilder;
+    on(day: WeekdayInput | readonly WeekdayInput[]): CronBuilder;
+    onWeekdays(): CronBuilder;
+    onWeekends(): CronBuilder;
+    dayOfMonth(d: number | readonly number[]): CronBuilder;
+    inMonth(m: MonthInput | readonly MonthInput[]): CronBuilder;
+    betweenHours(start: number, end: number): CronBuilder;
+    betweenDays(start: WeekdayInput, end: WeekdayInput): CronBuilder;
+    betweenMonths(start: MonthInput, end: MonthInput): CronBuilder;
+    toString(): string;
+    toObject(): CronFields;
+}
+
+declare class CronsmithError extends Error {
+    readonly code: CronErrorCode;
+    constructor(code: CronErrorCode, message: string);
+}
+
+declare const cron: () => CronBuilder;
+
+export { CronBuilder, type CronErrorCode, type CronFields, CronsmithError, type Month, type MonthInput, type TimeUnit, type Weekday, type WeekdayInput, cron };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+type Weekday = 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
+type WeekdayInput = Weekday | Capitalize<Weekday> | Uppercase<Weekday>;
+type Month = 'january' | 'february' | 'march' | 'april' | 'may' | 'june' | 'july' | 'august' | 'september' | 'october' | 'november' | 'december';
+type MonthInput = Month | Capitalize<Month> | Uppercase<Month>;
+type TimeUnit = 'minutes' | 'hours' | 'days' | 'months';
+type CronFields = {
+    minute: string;
+    hour: string;
+    dayOfMonth: string;
+    month: string;
+    dayOfWeek: string;
+};
+type CronErrorCode = 'INVALID_MINUTE' | 'INVALID_HOUR' | 'INVALID_TIME' | 'INVALID_DAY_OF_MONTH' | 'INVALID_WEEKDAY' | 'INVALID_MONTH' | 'INVALID_STEP' | 'INVALID_RANGE' | 'INVALID_UNIT' | 'CONFLICTING_CALL';
+
+type TouchState = 'hard' | 'soft' | 'untouched';
+type Touched = {
+    minute: TouchState;
+    hour: TouchState;
+    dayOfMonth: TouchState;
+    month: TouchState;
+    dayOfWeek: TouchState;
+};
+declare class CronBuilder {
+    private readonly fields;
+    private readonly touched;
+    constructor(fields?: CronFields, touched?: Touched);
+    private clone;
+    everyMinute(): CronBuilder;
+    every(n: number, unit: TimeUnit): CronBuilder;
+    atMinute(m: number | readonly number[]): CronBuilder;
+    atHour(h: number | readonly number[]): CronBuilder;
+    at(time: string): CronBuilder;
+    on(day: WeekdayInput | readonly WeekdayInput[]): CronBuilder;
+    onWeekdays(): CronBuilder;
+    onWeekends(): CronBuilder;
+    dayOfMonth(d: number | readonly number[]): CronBuilder;
+    inMonth(m: MonthInput | readonly MonthInput[]): CronBuilder;
+    betweenHours(start: number, end: number): CronBuilder;
+    betweenDays(start: WeekdayInput, end: WeekdayInput): CronBuilder;
+    betweenMonths(start: MonthInput, end: MonthInput): CronBuilder;
+    toString(): string;
+    toObject(): CronFields;
+}
+
+declare class CronsmithError extends Error {
+    readonly code: CronErrorCode;
+    constructor(code: CronErrorCode, message: string);
+}
+
+declare const cron: () => CronBuilder;
+
+export { CronBuilder, type CronErrorCode, type CronFields, CronsmithError, type Month, type MonthInput, type TimeUnit, type Weekday, type WeekdayInput, cron };

package/dist/index.js

@@ -0,0 +1,310 @@
+// src/errors.ts
+var CronsmithError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "CronsmithError";
+    this.code = code;
+  }
+};
+
+// src/serializer.ts
+var serialize = (f) => `${f.minute} ${f.hour} ${f.dayOfMonth} ${f.month} ${f.dayOfWeek}`;
+var formatList = (values) => {
+  const sorted = [...new Set(values)].sort((a, b) => a - b);
+  return sorted.join(",");
+};
+var formatStep = (n) => n === 1 ? "*" : `*/${n}`;
+var formatRange = (start, end) => start === end ? String(start) : `${start}-${end}`;
+
+// src/constants.ts
+var WEEKDAYS = [
+  "sunday",
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday"
+];
+var WEEKDAY_TO_NUM = {
+  sunday: 0,
+  monday: 1,
+  tuesday: 2,
+  wednesday: 3,
+  thursday: 4,
+  friday: 5,
+  saturday: 6
+};
+var MONTHS = [
+  "january",
+  "february",
+  "march",
+  "april",
+  "may",
+  "june",
+  "july",
+  "august",
+  "september",
+  "october",
+  "november",
+  "december"
+];
+var MONTH_TO_NUM = {
+  january: 1,
+  february: 2,
+  march: 3,
+  april: 4,
+  may: 5,
+  june: 6,
+  july: 7,
+  august: 8,
+  september: 9,
+  october: 10,
+  november: 11,
+  december: 12
+};
+var FIELD_MAX = {
+  minutes: 59,
+  hours: 23,
+  days: 31,
+  months: 12
+};
+var TIME_UNITS = ["minutes", "hours", "days", "months"];
+
+// src/validators.ts
+var isInt = (n) => typeof n === "number" && Number.isInteger(n) && Number.isFinite(n);
+var assertMinute = (m) => {
+  if (!isInt(m) || m < 0 || m > 59) {
+    throw new CronsmithError("INVALID_MINUTE", `Invalid minute: ${m} (expected 0-59)`);
+  }
+};
+var assertHour = (h) => {
+  if (!isInt(h) || h < 0 || h > 23) {
+    throw new CronsmithError("INVALID_HOUR", `Invalid hour: ${h} (expected 0-23)`);
+  }
+};
+var assertDayOfMonth = (d) => {
+  if (!isInt(d) || d < 1 || d > 31) {
+    throw new CronsmithError("INVALID_DAY_OF_MONTH", `Invalid day of month: ${d} (expected 1-31)`);
+  }
+};
+var TIME_RE = /^([0-9]{2}):([0-9]{2})$/;
+var parseTime = (s) => {
+  const m = TIME_RE.exec(s);
+  if (!m) {
+    throw new CronsmithError(
+      "INVALID_TIME",
+      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`
+    );
+  }
+  const hour = Number(m[1]);
+  const minute = Number(m[2]);
+  if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+    throw new CronsmithError(
+      "INVALID_TIME",
+      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`
+    );
+  }
+  return { hour, minute };
+};
+var normalizeWeekday = (raw) => {
+  const lc = raw.toLowerCase();
+  if (!WEEKDAYS.includes(lc)) {
+    throw new CronsmithError(
+      "INVALID_WEEKDAY",
+      `Invalid weekday: '${raw}' (expected one of: ${WEEKDAYS.join(", ")})`
+    );
+  }
+  return lc;
+};
+var normalizeMonth = (raw) => {
+  const lc = raw.toLowerCase();
+  if (!MONTHS.includes(lc)) {
+    throw new CronsmithError(
+      "INVALID_MONTH",
+      `Invalid month: '${raw}' (expected one of: ${MONTHS.join(", ")})`
+    );
+  }
+  return lc;
+};
+var assertTimeUnit = (u) => {
+  if (!TIME_UNITS.includes(u)) {
+    throw new CronsmithError(
+      "INVALID_UNIT",
+      `Invalid time unit: '${u}' (expected one of: ${TIME_UNITS.join(", ")})`
+    );
+  }
+  return u;
+};
+var assertStep = (n, unit) => {
+  if (!isInt(n) || n < 1) {
+    throw new CronsmithError("INVALID_STEP", `Step must be >= 1, got ${n}`);
+  }
+  const max = FIELD_MAX[unit];
+  if (n > max) {
+    throw new CronsmithError(
+      "INVALID_STEP",
+      `Step ${n} exceeds max for ${unit} (${max})`
+    );
+  }
+};
+var assertHourRange = (start, end) => {
+  assertHour(start);
+  assertHour(end);
+};
+var weekdayNum = (w) => WEEKDAY_TO_NUM[w];
+var monthNum = (m) => MONTH_TO_NUM[m];
+
+// src/builder.ts
+var FRESH_FIELDS = {
+  minute: "*",
+  hour: "*",
+  dayOfMonth: "*",
+  month: "*",
+  dayOfWeek: "*"
+};
+var FRESH_TOUCHED = {
+  minute: "untouched",
+  hour: "untouched",
+  dayOfMonth: "untouched",
+  month: "untouched",
+  dayOfWeek: "untouched"
+};
+var FIELD_LABEL = {
+  minute: "minute",
+  hour: "hour",
+  dayOfMonth: "day-of-month",
+  month: "month",
+  dayOfWeek: "day-of-week"
+};
+var toList = (x) => Array.isArray(x) ? x : [x];
+var wrapList = (start, end, min, max) => {
+  const out = [];
+  for (let v = start; v <= max; v++) out.push(v);
+  for (let v = min; v <= end; v++) out.push(v);
+  return out;
+};
+var CronBuilder = class _CronBuilder {
+  fields;
+  touched;
+  constructor(fields = FRESH_FIELDS, touched = FRESH_TOUCHED) {
+    this.fields = fields;
+    this.touched = touched;
+  }
+  // hardKeys throw on conflict and become 'hard'; softPatch applies only to
+  // 'untouched' fields and becomes 'soft' (a later hard call overrides it
+  // silently). This is what makes pinning order-independent.
+  clone(patch, hardKeys, softPatch) {
+    for (const k of hardKeys) {
+      if (this.touched[k] === "hard") {
+        throw new CronsmithError(
+          "CONFLICTING_CALL",
+          `${FIELD_LABEL[k]} field has already been set. To combine values, pass an array (e.g. atMinute([5, 35])) instead of chaining.`
+        );
+      }
+    }
+    const nextFields = { ...this.fields, ...patch };
+    const nextTouched = { ...this.touched };
+    for (const k of hardKeys) nextTouched[k] = "hard";
+    if (softPatch) {
+      for (const k of Object.keys(softPatch)) {
+        if (this.touched[k] === "untouched") {
+          nextFields[k] = softPatch[k];
+          nextTouched[k] = "soft";
+        }
+      }
+    }
+    return new _CronBuilder(nextFields, nextTouched);
+  }
+  everyMinute() {
+    return this.clone({ minute: "*" }, ["minute"]);
+  }
+  // Soft-defaults below pin smaller fields so every(n, X) fires once per
+  // qualifying X instead of inheriting * from the unset fields.
+  every(n, unit) {
+    const u = assertTimeUnit(unit);
+    assertStep(n, u);
+    if (u === "minutes") return this.clone({ minute: formatStep(n) }, ["minute"]);
+    if (u === "hours") {
+      return this.clone({ hour: formatStep(n) }, ["hour"], { minute: "0" });
+    }
+    if (u === "days") {
+      return this.clone({ dayOfMonth: formatStep(n) }, ["dayOfMonth"], {
+        minute: "0",
+        hour: "0"
+      });
+    }
+    return this.clone({ month: formatStep(n) }, ["month"], {
+      minute: "0",
+      hour: "0",
+      dayOfMonth: "1"
+    });
+  }
+  atMinute(m) {
+    const list = toList(m);
+    for (const v of list) assertMinute(v);
+    return this.clone({ minute: formatList(list) }, ["minute"]);
+  }
+  atHour(h) {
+    const list = toList(h);
+    for (const v of list) assertHour(v);
+    return this.clone({ hour: formatList(list) }, ["hour"], { minute: "0" });
+  }
+  at(time) {
+    const { hour, minute } = parseTime(time);
+    return this.clone({ minute: String(minute), hour: String(hour) }, ["minute", "hour"]);
+  }
+  on(day) {
+    const nums = toList(day).map((d) => weekdayNum(normalizeWeekday(d)));
+    return this.clone({ dayOfWeek: formatList(nums) }, ["dayOfWeek"]);
+  }
+  onWeekdays() {
+    return this.clone({ dayOfWeek: "1-5" }, ["dayOfWeek"]);
+  }
+  onWeekends() {
+    return this.clone({ dayOfWeek: "0,6" }, ["dayOfWeek"]);
+  }
+  dayOfMonth(d) {
+    const list = toList(d);
+    for (const v of list) assertDayOfMonth(v);
+    return this.clone({ dayOfMonth: formatList(list) }, ["dayOfMonth"]);
+  }
+  inMonth(m) {
+    const nums = toList(m).map((x) => monthNum(normalizeMonth(x)));
+    return this.clone({ month: formatList(nums) }, ["month"]);
+  }
+  betweenHours(start, end) {
+    assertHourRange(start, end);
+    if (start <= end) return this.clone({ hour: formatRange(start, end) }, ["hour"]);
+    const hours = wrapList(start, end, 0, 23);
+    return this.clone({ hour: hours.join(",") }, ["hour"]);
+  }
+  betweenDays(start, end) {
+    const s = weekdayNum(normalizeWeekday(start));
+    const e = weekdayNum(normalizeWeekday(end));
+    if (s <= e) return this.clone({ dayOfWeek: formatRange(s, e) }, ["dayOfWeek"]);
+    const days = wrapList(s, e, 0, 6);
+    return this.clone({ dayOfWeek: days.join(",") }, ["dayOfWeek"]);
+  }
+  betweenMonths(start, end) {
+    const s = monthNum(normalizeMonth(start));
+    const e = monthNum(normalizeMonth(end));
+    if (s <= e) return this.clone({ month: formatRange(s, e) }, ["month"]);
+    const months = wrapList(s, e, 1, 12);
+    return this.clone({ month: months.join(",") }, ["month"]);
+  }
+  toString() {
+    return serialize(this.fields);
+  }
+  toObject() {
+    return { ...this.fields };
+  }
+};
+
+// src/index.ts
+var cron = () => new CronBuilder();
+
+export { CronBuilder, CronsmithError, cron };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/serializer.ts","../src/constants.ts","../src/validators.ts","../src/builder.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { CronErrorCode } from './types.js';\n\nexport class CronsmithError extends Error {\n  readonly code: CronErrorCode;\n\n  constructor(code: CronErrorCode, message: string) {\n    super(message);\n    this.name = 'CronsmithError';\n    this.code = code;\n  }\n}\n","import type { CronFields } from './types.js';\n\nexport const serialize = (f: CronFields): string =>\n  `${f.minute} ${f.hour} ${f.dayOfMonth} ${f.month} ${f.dayOfWeek}`;\n\nexport const formatList = (values: readonly number[]): string => {\n  const sorted = [...new Set(values)].sort((a, b) => a - b);\n  return sorted.join(',');\n};\n\nexport const formatStep = (n: number): string => (n === 1 ? '*' : `*/${n}`);\n\nexport const formatRange = (start: number, end: number): string =>\n  start === end ? String(start) : `${start}-${end}`;\n","import type { Month, TimeUnit, Weekday } from './types.js';\n\nexport const WEEKDAYS: readonly Weekday[] = [\n  'sunday',\n  'monday',\n  'tuesday',\n  'wednesday',\n  'thursday',\n  'friday',\n  'saturday',\n] as const;\n\nexport const WEEKDAY_TO_NUM: Record<Weekday, number> = {\n  sunday: 0,\n  monday: 1,\n  tuesday: 2,\n  wednesday: 3,\n  thursday: 4,\n  friday: 5,\n  saturday: 6,\n};\n\nexport const MONTHS: readonly Month[] = [\n  'january',\n  'february',\n  'march',\n  'april',\n  'may',\n  'june',\n  'july',\n  'august',\n  'september',\n  'october',\n  'november',\n  'december',\n] as const;\n\nexport const MONTH_TO_NUM: Record<Month, number> = {\n  january: 1,\n  february: 2,\n  march: 3,\n  april: 4,\n  may: 5,\n  june: 6,\n  july: 7,\n  august: 8,\n  september: 9,\n  october: 10,\n  november: 11,\n  december: 12,\n};\n\nexport const FIELD_MAX: Record<TimeUnit, number> = {\n  minutes: 59,\n  hours: 23,\n  days: 31,\n  months: 12,\n};\n\nexport const FIELD_MIN: Record<TimeUnit, number> = {\n  minutes: 0,\n  hours: 0,\n  days: 1,\n  months: 1,\n};\n\nexport const TIME_UNITS: readonly TimeUnit[] = ['minutes', 'hours', 'days', 'months'] as const;\n","import { FIELD_MAX, MONTH_TO_NUM, MONTHS, TIME_UNITS, WEEKDAY_TO_NUM, WEEKDAYS } from './constants.js';\nimport { CronsmithError } from './errors.js';\nimport type { Month, TimeUnit, Weekday } from './types.js';\n\nconst isInt = (n: unknown): n is number =>\n  typeof n === 'number' && Number.isInteger(n) && Number.isFinite(n);\n\nexport const assertMinute = (m: number): void => {\n  if (!isInt(m) || m < 0 || m > 59) {\n    throw new CronsmithError('INVALID_MINUTE', `Invalid minute: ${m} (expected 0-59)`);\n  }\n};\n\nexport const assertHour = (h: number): void => {\n  if (!isInt(h) || h < 0 || h > 23) {\n    throw new CronsmithError('INVALID_HOUR', `Invalid hour: ${h} (expected 0-23)`);\n  }\n};\n\nexport const assertDayOfMonth = (d: number): void => {\n  if (!isInt(d) || d < 1 || d > 31) {\n    throw new CronsmithError('INVALID_DAY_OF_MONTH', `Invalid day of month: ${d} (expected 1-31)`);\n  }\n};\n\nconst TIME_RE = /^([0-9]{2}):([0-9]{2})$/;\n\nexport const parseTime = (s: string): { hour: number; minute: number } => {\n  const m = TIME_RE.exec(s);\n  if (!m) {\n    throw new CronsmithError(\n      'INVALID_TIME',\n      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`,\n    );\n  }\n  const hour = Number(m[1]);\n  const minute = Number(m[2]);\n  if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {\n    throw new CronsmithError(\n      'INVALID_TIME',\n      `Invalid time: '${s}' (expected HH:MM, 00:00-23:59)`,\n    );\n  }\n  return { hour, minute };\n};\n\nexport const normalizeWeekday = (raw: string): Weekday => {\n  const lc = raw.toLowerCase();\n  if (!(WEEKDAYS as readonly string[]).includes(lc)) {\n    throw new CronsmithError(\n      'INVALID_WEEKDAY',\n      `Invalid weekday: '${raw}' (expected one of: ${WEEKDAYS.join(', ')})`,\n    );\n  }\n  return lc as Weekday;\n};\n\nexport const normalizeMonth = (raw: string): Month => {\n  const lc = raw.toLowerCase();\n  if (!(MONTHS as readonly string[]).includes(lc)) {\n    throw new CronsmithError(\n      'INVALID_MONTH',\n      `Invalid month: '${raw}' (expected one of: ${MONTHS.join(', ')})`,\n    );\n  }\n  return lc as Month;\n};\n\nexport const assertTimeUnit = (u: string): TimeUnit => {\n  if (!(TIME_UNITS as readonly string[]).includes(u)) {\n    throw new CronsmithError(\n      'INVALID_UNIT',\n      `Invalid time unit: '${u}' (expected one of: ${TIME_UNITS.join(', ')})`,\n    );\n  }\n  return u as TimeUnit;\n};\n\nexport const assertStep = (n: number, unit: TimeUnit): void => {\n  if (!isInt(n) || n < 1) {\n    throw new CronsmithError('INVALID_STEP', `Step must be >= 1, got ${n}`);\n  }\n  const max = FIELD_MAX[unit];\n  if (n > max) {\n    throw new CronsmithError(\n      'INVALID_STEP',\n      `Step ${n} exceeds max for ${unit} (${max})`,\n    );\n  }\n};\n\nexport const assertHourRange = (start: number, end: number): void => {\n  assertHour(start);\n  assertHour(end);\n};\n\nexport const weekdayNum = (w: Weekday): number => WEEKDAY_TO_NUM[w];\nexport const monthNum = (m: Month): number => MONTH_TO_NUM[m];\n","import { CronsmithError } from './errors.js';\nimport { formatList, formatRange, formatStep, serialize } from './serializer.js';\nimport type { CronFields, MonthInput, TimeUnit, WeekdayInput } from './types.js';\nimport {\n  assertDayOfMonth,\n  assertHour,\n  assertHourRange,\n  assertMinute,\n  assertStep,\n  assertTimeUnit,\n  monthNum,\n  normalizeMonth,\n  normalizeWeekday,\n  parseTime,\n  weekdayNum,\n} from './validators.js';\n\ntype TouchState = 'hard' | 'soft' | 'untouched';\n\ntype Touched = {\n  minute: TouchState;\n  hour: TouchState;\n  dayOfMonth: TouchState;\n  month: TouchState;\n  dayOfWeek: TouchState;\n};\n\nconst FRESH_FIELDS: CronFields = {\n  minute: '*',\n  hour: '*',\n  dayOfMonth: '*',\n  month: '*',\n  dayOfWeek: '*',\n};\n\nconst FRESH_TOUCHED: Touched = {\n  minute: 'untouched',\n  hour: 'untouched',\n  dayOfMonth: 'untouched',\n  month: 'untouched',\n  dayOfWeek: 'untouched',\n};\n\nconst FIELD_LABEL: Record<keyof Touched, string> = {\n  minute: 'minute',\n  hour: 'hour',\n  dayOfMonth: 'day-of-month',\n  month: 'month',\n  dayOfWeek: 'day-of-week',\n};\n\nconst toList = <T>(x: T | readonly T[]): readonly T[] =>\n  Array.isArray(x) ? (x as readonly T[]) : [x as T];\n\nconst wrapList = (start: number, end: number, min: number, max: number): number[] => {\n  // Enumerate values from start..max then min..end. Used when a range wraps\n  // around the field boundary (e.g. Fri→Sun on weekdays, Nov→Feb on months).\n  const out: number[] = [];\n  for (let v = start; v <= max; v++) out.push(v);\n  for (let v = min; v <= end; v++) out.push(v);\n  return out;\n};\n\nexport class CronBuilder {\n  private readonly fields: CronFields;\n  private readonly touched: Touched;\n\n  constructor(fields: CronFields = FRESH_FIELDS, touched: Touched = FRESH_TOUCHED) {\n    this.fields = fields;\n    this.touched = touched;\n  }\n\n  // hardKeys throw on conflict and become 'hard'; softPatch applies only to\n  // 'untouched' fields and becomes 'soft' (a later hard call overrides it\n  // silently). This is what makes pinning order-independent.\n  private clone(\n    patch: Partial<CronFields>,\n    hardKeys: readonly (keyof Touched)[],\n    softPatch?: Partial<CronFields>,\n  ): CronBuilder {\n    for (const k of hardKeys) {\n      if (this.touched[k] === 'hard') {\n        throw new CronsmithError(\n          'CONFLICTING_CALL',\n          `${FIELD_LABEL[k]} field has already been set. To combine values, pass an array (e.g. atMinute([5, 35])) instead of chaining.`,\n        );\n      }\n    }\n    const nextFields: CronFields = { ...this.fields, ...patch };\n    const nextTouched: Touched = { ...this.touched };\n    for (const k of hardKeys) nextTouched[k] = 'hard';\n    if (softPatch) {\n      for (const k of Object.keys(softPatch) as (keyof CronFields)[]) {\n        if (this.touched[k] === 'untouched') {\n          nextFields[k] = softPatch[k]!;\n          nextTouched[k] = 'soft';\n        }\n      }\n    }\n    return new CronBuilder(nextFields, nextTouched);\n  }\n\n  everyMinute(): CronBuilder {\n    return this.clone({ minute: '*' }, ['minute']);\n  }\n\n  // Soft-defaults below pin smaller fields so every(n, X) fires once per\n  // qualifying X instead of inheriting * from the unset fields.\n  every(n: number, unit: TimeUnit): CronBuilder {\n    const u = assertTimeUnit(unit);\n    assertStep(n, u);\n    if (u === 'minutes') return this.clone({ minute: formatStep(n) }, ['minute']);\n    if (u === 'hours') {\n      return this.clone({ hour: formatStep(n) }, ['hour'], { minute: '0' });\n    }\n    if (u === 'days') {\n      return this.clone({ dayOfMonth: formatStep(n) }, ['dayOfMonth'], {\n        minute: '0',\n        hour: '0',\n      });\n    }\n    return this.clone({ month: formatStep(n) }, ['month'], {\n      minute: '0',\n      hour: '0',\n      dayOfMonth: '1',\n    });\n  }\n\n  atMinute(m: number | readonly number[]): CronBuilder {\n    const list = toList(m);\n    for (const v of list) assertMinute(v);\n    return this.clone({ minute: formatList(list) }, ['minute']);\n  }\n\n  atHour(h: number | readonly number[]): CronBuilder {\n    const list = toList(h);\n    for (const v of list) assertHour(v);\n    return this.clone({ hour: formatList(list) }, ['hour'], { minute: '0' });\n  }\n\n  at(time: string): CronBuilder {\n    const { hour, minute } = parseTime(time);\n    return this.clone({ minute: String(minute), hour: String(hour) }, ['minute', 'hour']);\n  }\n\n  on(day: WeekdayInput | readonly WeekdayInput[]): CronBuilder {\n    const nums = toList(day).map((d) => weekdayNum(normalizeWeekday(d)));\n    return this.clone({ dayOfWeek: formatList(nums) }, ['dayOfWeek']);\n  }\n\n  onWeekdays(): CronBuilder {\n    return this.clone({ dayOfWeek: '1-5' }, ['dayOfWeek']);\n  }\n\n  onWeekends(): CronBuilder {\n    return this.clone({ dayOfWeek: '0,6' }, ['dayOfWeek']);\n  }\n\n  dayOfMonth(d: number | readonly number[]): CronBuilder {\n    const list = toList(d);\n    for (const v of list) assertDayOfMonth(v);\n    return this.clone({ dayOfMonth: formatList(list) }, ['dayOfMonth']);\n  }\n\n  inMonth(m: MonthInput | readonly MonthInput[]): CronBuilder {\n    const nums = toList(m).map((x) => monthNum(normalizeMonth(x)));\n    return this.clone({ month: formatList(nums) }, ['month']);\n  }\n\n  betweenHours(start: number, end: number): CronBuilder {\n    assertHourRange(start, end);\n    if (start <= end) return this.clone({ hour: formatRange(start, end) }, ['hour']);\n    const hours = wrapList(start, end, 0, 23);\n    return this.clone({ hour: hours.join(',') }, ['hour']);\n  }\n\n  betweenDays(start: WeekdayInput, end: WeekdayInput): CronBuilder {\n    const s = weekdayNum(normalizeWeekday(start));\n    const e = weekdayNum(normalizeWeekday(end));\n    if (s <= e) return this.clone({ dayOfWeek: formatRange(s, e) }, ['dayOfWeek']);\n    const days = wrapList(s, e, 0, 6);\n    return this.clone({ dayOfWeek: days.join(',') }, ['dayOfWeek']);\n  }\n\n  betweenMonths(start: MonthInput, end: MonthInput): CronBuilder {\n    const s = monthNum(normalizeMonth(start));\n    const e = monthNum(normalizeMonth(end));\n    if (s <= e) return this.clone({ month: formatRange(s, e) }, ['month']);\n    const months = wrapList(s, e, 1, 12);\n    return this.clone({ month: months.join(',') }, ['month']);\n  }\n\n  toString(): string {\n    return serialize(this.fields);\n  }\n\n  toObject(): CronFields {\n    return { ...this.fields };\n  }\n}\n","import { CronBuilder } from './builder.js';\n\nexport const cron = (): CronBuilder => new CronBuilder();\n\nexport { CronBuilder } from './builder.js';\nexport { CronsmithError } from './errors.js';\nexport type {\n  CronErrorCode,\n  CronFields,\n  Month,\n  MonthInput,\n  TimeUnit,\n  Weekday,\n  WeekdayInput,\n} from './types.js';\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "cronsmith",
+  "version": "0.1.0",
+  "description": "Fluent, type-safe, zero-runtime-dependency cron expression builder for TypeScript and JavaScript.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "verify": "npm run typecheck && npm test && npm run build",
+    "preversion": "npm run verify",
+    "postversion": "git push --follow-tags",
+    "prepublishOnly": "npm run verify"
+  },
+  "keywords": ["cron", "crontab", "scheduler", "builder", "fluent", "typescript"],
+  "author": "Fariz Prawira <farizprawira94@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FarizPrawira/cronsmith.git"
+  },
+  "bugs": {
+    "url": "https://github.com/FarizPrawira/cronsmith/issues"
+  },
+  "homepage": "https://github.com/FarizPrawira/cronsmith#readme",
+  "engines": { "node": ">=22" },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.0.0"
+  }
+}