fatigue-kit 0.0.0-stage → 0.2.0

package/dist/index.js

@@ -0,0 +1,334 @@
+import {
+  RECORD_VERSION,
+  decodeRecord,
+  encodeRecord,
+  pruneRecord
+} from "./chunk-ZNIZLIUO.js";
+import {
+  memoryAdapter
+} from "./chunk-DM2CAKGU.js";
+
+// src/calendar.ts
+function parseCutoff(cutoff) {
+  if (cutoff === void 0) return 0;
+  const match = /^(\d{1,2}):(\d{2})$/.exec(cutoff.trim());
+  if (match === null || match[1] === void 0 || match[2] === void 0) {
+    throw new TypeError(`[fatigue-kit] invalid cutoff: "${cutoff}". Expected 'HH:mm'.`);
+  }
+  const hours = Number(match[1]);
+  const minutes = Number(match[2]);
+  if (hours > 23 || minutes > 59) {
+    throw new TypeError(
+      `[fatigue-kit] invalid cutoff: "${cutoff}". Hours must be 0-23, minutes 0-59.`
+    );
+  }
+  return hours * 60 + minutes;
+}
+function localMidnight(ts) {
+  const date = new Date(ts);
+  date.setHours(0, 0, 0, 0);
+  return date;
+}
+function naturalPeriodStart(ts, spec) {
+  switch (spec.every) {
+    case "day":
+      return localMidnight(ts).getTime();
+    case "week": {
+      const date = localMidnight(ts);
+      const offset = (date.getDay() - spec.weekStartsOn + 7) % 7;
+      date.setDate(date.getDate() - offset);
+      return date.getTime();
+    }
+    case "month": {
+      const date = new Date(ts);
+      return new Date(date.getFullYear(), date.getMonth(), 1).getTime();
+    }
+    case "year": {
+      const date = new Date(ts);
+      return new Date(date.getFullYear(), 0, 1).getTime();
+    }
+  }
+}
+function previousNaturalStart(naturalStart, spec) {
+  switch (spec.every) {
+    case "day": {
+      const date = new Date(naturalStart);
+      date.setDate(date.getDate() - 1);
+      return date.getTime();
+    }
+    case "week": {
+      const date = new Date(naturalStart);
+      date.setDate(date.getDate() - 7);
+      return date.getTime();
+    }
+    case "month": {
+      const date = new Date(naturalStart);
+      return new Date(date.getFullYear(), date.getMonth() - 1, 1).getTime();
+    }
+    case "year": {
+      const date = new Date(naturalStart);
+      return new Date(date.getFullYear() - 1, 0, 1).getTime();
+    }
+  }
+}
+function wallClockBoundary(midnight, cutoffMinutes) {
+  const date = new Date(midnight);
+  return new Date(
+    date.getFullYear(),
+    date.getMonth(),
+    date.getDate(),
+    Math.floor(cutoffMinutes / 60),
+    cutoffMinutes % 60
+  ).getTime();
+}
+function calendarPeriodStart(ts, spec) {
+  const natural = naturalPeriodStart(ts, spec);
+  const boundary = wallClockBoundary(natural, spec.cutoffMinutes);
+  if (boundary <= ts) return boundary;
+  return wallClockBoundary(previousNaturalStart(natural, spec), spec.cutoffMinutes);
+}
+var JUMP_MS = {
+  day: 12 * 36e5,
+  week: 8 * 864e5,
+  month: 8 * 864e5,
+  year: 32 * 864e5
+};
+function calendarNextPeriodStart(ts, spec) {
+  const jump = JUMP_MS[spec.every];
+  let cursor = ts;
+  for (let i = 0; i < 50; i++) {
+    cursor += jump;
+    const start = calendarPeriodStart(cursor, spec);
+    if (start > ts) return start;
+  }
+  throw new Error("[fatigue-kit] failed to compute the next calendar period");
+}
+
+// src/duration.ts
+var UNITS = {
+  s: 1e3,
+  m: 6e4,
+  h: 36e5,
+  d: 864e5
+};
+function parseDuration(duration) {
+  if (typeof duration === "number") {
+    if (!Number.isFinite(duration) || duration <= 0) {
+      throw new TypeError(`[fatigue-kit] invalid duration: ${duration}`);
+    }
+    return duration;
+  }
+  const match = /^(\d+(?:\.\d+)?)\s*([smhd])$/.exec(duration.trim());
+  if (match === null || match[1] === void 0 || match[2] === void 0) {
+    throw new TypeError(
+      `[fatigue-kit] invalid duration: "${duration}". Expected a positive number of ms, or '45s' / '30m' / '12h' / '7d'.`
+    );
+  }
+  const unitMs = UNITS[match[2]];
+  if (unitMs === void 0) {
+    throw new TypeError(`[fatigue-kit] invalid duration: "${duration}"`);
+  }
+  const ms = Number(match[1]) * unitMs;
+  if (!(ms > 0)) {
+    throw new TypeError(`[fatigue-kit] invalid duration: "${duration}"`);
+  }
+  return ms;
+}
+
+// src/engine.ts
+var DEFAULT_NAMESPACE = "fatigue-kit";
+var DEFAULT_MAX_HITS = 100;
+function assertNonEmpty(value, label) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`[fatigue-kit] ${label} must be a non-empty string`);
+  }
+}
+function requireMax(max) {
+  if (!Number.isInteger(max) || max < 1) {
+    throw new TypeError(`[fatigue-kit] rule "max" must be a positive integer, got ${max}`);
+  }
+}
+function compileRules(input) {
+  const list = Array.isArray(input) ? input : [input];
+  if (list.length === 0) {
+    throw new TypeError("[fatigue-kit] at least one rule is required");
+  }
+  return list.map((rule) => {
+    var _a;
+    if (rule === null || typeof rule !== "object") {
+      throw new TypeError(`[fatigue-kit] unknown rule: ${JSON.stringify(rule)}`);
+    }
+    if ("window" in rule) {
+      requireMax(rule.max);
+      return { kind: "sliding", rule, max: rule.max, windowMs: parseDuration(rule.window) };
+    }
+    if ("every" in rule) {
+      requireMax(rule.max);
+      if (rule.every !== "day" && rule.every !== "week" && rule.every !== "month" && rule.every !== "year") {
+        throw new TypeError(`[fatigue-kit] invalid "every": ${JSON.stringify(rule.every)}`);
+      }
+      return {
+        kind: "calendar",
+        rule,
+        max: rule.max,
+        spec: {
+          every: rule.every,
+          cutoffMinutes: parseCutoff(rule.cutoff),
+          weekStartsOn: (_a = rule.weekStartsOn) != null ? _a : 1
+        }
+      };
+    }
+    if ("cooldown" in rule) {
+      return { kind: "cooldown", rule, cooldownMs: parseDuration(rule.cooldown) };
+    }
+    if ("max" in rule) {
+      requireMax(rule.max);
+      return { kind: "lifetime", rule, max: rule.max };
+    }
+    throw new TypeError(`[fatigue-kit] unknown rule: ${JSON.stringify(rule)}`);
+  });
+}
+function outcomeFor(compiled, record, now) {
+  switch (compiled.kind) {
+    case "sliding": {
+      const from = now - compiled.windowMs;
+      let count = 0;
+      let oldest = Number.POSITIVE_INFINITY;
+      for (const hit of record.hits) {
+        if (hit > from) {
+          count++;
+          if (hit < oldest) oldest = hit;
+        }
+      }
+      const remaining = compiled.max - count;
+      return {
+        remaining,
+        nextAvailableAt: remaining <= 0 && oldest !== Number.POSITIVE_INFINITY ? oldest + compiled.windowMs : void 0
+      };
+    }
+    case "calendar": {
+      const start = calendarPeriodStart(now, compiled.spec);
+      let count = 0;
+      for (const hit of record.hits) {
+        if (hit >= start) count++;
+      }
+      const remaining = compiled.max - count;
+      return {
+        remaining,
+        nextAvailableAt: remaining <= 0 ? calendarNextPeriodStart(now, compiled.spec) : void 0
+      };
+    }
+    case "cooldown": {
+      const lastHit = record.hits.length > 0 ? record.hits[record.hits.length - 1] : void 0;
+      if (lastHit === void 0) return { remaining: Number.POSITIVE_INFINITY };
+      const readyAt = lastHit + compiled.cooldownMs;
+      return {
+        remaining: Number.POSITIVE_INFINITY,
+        nextAvailableAt: readyAt > now ? readyAt : void 0
+      };
+    }
+    case "lifetime": {
+      return { remaining: compiled.max - record.lifetime };
+    }
+  }
+}
+function evaluate(record, compiled, now) {
+  let remaining = Number.POSITIVE_INFINITY;
+  let nextAvailableAt;
+  let deniedBy;
+  for (const rule of compiled) {
+    const outcome = outcomeFor(rule, record, now);
+    if (Number.isFinite(outcome.remaining)) {
+      remaining = Math.min(remaining, outcome.remaining);
+    }
+    if (outcome.nextAvailableAt !== void 0 && (nextAvailableAt === void 0 || outcome.nextAvailableAt > nextAvailableAt)) {
+      nextAvailableAt = outcome.nextAvailableAt;
+    }
+    const ruleAllows = outcome.remaining > 0 && (outcome.nextAvailableAt === void 0 || outcome.nextAvailableAt <= now);
+    if (!ruleAllows) deniedBy != null ? deniedBy : deniedBy = rule.rule;
+  }
+  const result = {
+    allowed: deniedBy === void 0,
+    remaining: Math.max(0, remaining)
+  };
+  if (nextAvailableAt !== void 0) result.nextAvailableAt = nextAvailableAt;
+  if (deniedBy !== void 0) result.deniedBy = deniedBy;
+  return result;
+}
+function keepFrom(compiled, now) {
+  let keep = now;
+  for (const rule of compiled) {
+    if (rule.kind === "sliding") keep = Math.min(keep, now - rule.windowMs);
+    else if (rule.kind === "calendar") keep = Math.min(keep, calendarPeriodStart(now, rule.spec));
+    else if (rule.kind === "cooldown") keep = Math.min(keep, now - rule.cooldownMs);
+  }
+  return keep;
+}
+function createFatigue(options = {}) {
+  var _a, _b, _c, _d;
+  const storage = (_a = options.storage) != null ? _a : memoryAdapter();
+  const clock = (_b = options.clock) != null ? _b : { now: () => Date.now() };
+  const namespace = (_c = options.namespace) != null ? _c : DEFAULT_NAMESPACE;
+  const maxHits = (_d = options.maxHits) != null ? _d : DEFAULT_MAX_HITS;
+  assertNonEmpty(namespace, "namespace");
+  if (!Number.isInteger(maxHits) || maxHits < 1) {
+    throw new TypeError(`[fatigue-kit] maxHits must be a positive integer, got ${maxHits}`);
+  }
+  const storageKey = (key) => {
+    assertNonEmpty(key, "key");
+    return `${namespace}:${key}`;
+  };
+  const read = (key) => decodeRecord(storage.get(storageKey(key)));
+  const tryConsume = (key, rules) => {
+    const compiled = compileRules(rules);
+    const now = clock.now();
+    const record = read(key);
+    const result = evaluate(record, compiled, now);
+    if (result.allowed) {
+      if (Number.isFinite(result.remaining)) {
+        result.remaining = Math.max(0, result.remaining - 1);
+      }
+      record.hits.push(now);
+      record.lifetime += 1;
+      pruneRecord(record, keepFrom(compiled, now), maxHits);
+      storage.set(storageKey(key), encodeRecord(record));
+    }
+    return result;
+  };
+  const peek = (key, rules) => {
+    const compiled = compileRules(rules);
+    return evaluate(read(key), compiled, clock.now());
+  };
+  const reset = (key) => {
+    if (key !== void 0) {
+      storage.remove(storageKey(key));
+      return;
+    }
+    if (typeof storage.keys !== "function") {
+      throw new Error(
+        "[fatigue-kit] reset() without a key requires a storage adapter implementing keys()"
+      );
+    }
+    const prefix = `${namespace}:`;
+    for (const storedKey of storage.keys()) {
+      if (storedKey.startsWith(prefix)) storage.remove(storedKey);
+    }
+  };
+  const exportRecord = (key) => {
+    const raw = storage.get(storageKey(key));
+    return raw ? decodeRecord(raw) : null;
+  };
+  const importRecord = (key, record) => {
+    var _a2;
+    const hits = ((_a2 = record.hits) != null ? _a2 : []).filter((hit) => typeof hit === "number" && Number.isFinite(hit)).sort((a, b) => a - b);
+    const lifetime = typeof record.lifetime === "number" && Number.isFinite(record.lifetime) && record.lifetime >= 0 ? record.lifetime : hits.length;
+    storage.set(storageKey(key), encodeRecord({ v: RECORD_VERSION, hits, lifetime }));
+  };
+  return { tryConsume, peek, reset, exportRecord, importRecord };
+}
+export {
+  RECORD_VERSION,
+  createFatigue,
+  memoryAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/calendar.ts","../src/duration.ts","../src/engine.ts"],"sourcesContent":["export type CalendarEvery = 'day' | 'week' | 'month' | 'year'\n\nexport interface CalendarSpec {\n\tevery: CalendarEvery\n\tcutoffMinutes: number\n\tweekStartsOn: number\n}\n\n/** Parse a `'HH:mm'` cutoff into minutes after local midnight. Default (no cutoff) is `0`. */\nexport function parseCutoff(cutoff: string | undefined): number {\n\tif (cutoff === undefined) return 0\n\tconst match = /^(\\d{1,2}):(\\d{2})$/.exec(cutoff.trim())\n\tif (match === null || match[1] === undefined || match[2] === undefined) {\n\t\tthrow new TypeError(`[fatigue-kit] invalid cutoff: \"${cutoff}\". Expected 'HH:mm'.`)\n\t}\n\tconst hours = Number(match[1])\n\tconst minutes = Number(match[2])\n\tif (hours > 23 || minutes > 59) {\n\t\tthrow new TypeError(\n\t\t\t`[fatigue-kit] invalid cutoff: \"${cutoff}\". Hours must be 0-23, minutes 0-59.`,\n\t\t)\n\t}\n\treturn hours * 60 + minutes\n}\n\nfunction localMidnight(ts: number): Date {\n\tconst date = new Date(ts)\n\tdate.setHours(0, 0, 0, 0)\n\treturn date\n}\n\n/** Midnight-based start of the period containing `ts`, before applying the cutoff. */\nfunction naturalPeriodStart(ts: number, spec: CalendarSpec): number {\n\tswitch (spec.every) {\n\t\tcase 'day':\n\t\t\treturn localMidnight(ts).getTime()\n\t\tcase 'week': {\n\t\t\tconst date = localMidnight(ts)\n\t\t\tconst offset = (date.getDay() - spec.weekStartsOn + 7) % 7\n\t\t\tdate.setDate(date.getDate() - offset)\n\t\t\treturn date.getTime()\n\t\t}\n\t\tcase 'month': {\n\t\t\tconst date = new Date(ts)\n\t\t\treturn new Date(date.getFullYear(), date.getMonth(), 1).getTime()\n\t\t}\n\t\tcase 'year': {\n\t\t\tconst date = new Date(ts)\n\t\t\treturn new Date(date.getFullYear(), 0, 1).getTime()\n\t\t}\n\t}\n}\n\nfunction previousNaturalStart(naturalStart: number, spec: CalendarSpec): number {\n\tswitch (spec.every) {\n\t\tcase 'day': {\n\t\t\tconst date = new Date(naturalStart)\n\t\t\tdate.setDate(date.getDate() - 1)\n\t\t\treturn date.getTime()\n\t\t}\n\t\tcase 'week': {\n\t\t\tconst date = new Date(naturalStart)\n\t\t\tdate.setDate(date.getDate() - 7)\n\t\t\treturn date.getTime()\n\t\t}\n\t\tcase 'month': {\n\t\t\tconst date = new Date(naturalStart)\n\t\t\treturn new Date(date.getFullYear(), date.getMonth() - 1, 1).getTime()\n\t\t}\n\t\tcase 'year': {\n\t\t\tconst date = new Date(naturalStart)\n\t\t\treturn new Date(date.getFullYear() - 1, 0, 1).getTime()\n\t\t}\n\t}\n}\n\n/**\n * Local wall-clock time of `cutoffMinutes` past midnight, built from date\n * components. On DST transition days \"midnight epoch + fixed minutes\" would\n * land an hour off wall-clock time (e.g. after spring-forward a 04:00 cutoff\n * computed by addition would actually fire at 05:00), so the boundary must be\n * constructed, never added.\n */\nfunction wallClockBoundary(midnight: number, cutoffMinutes: number): number {\n\tconst date = new Date(midnight)\n\treturn new Date(\n\t\tdate.getFullYear(),\n\t\tdate.getMonth(),\n\t\tdate.getDate(),\n\t\tMath.floor(cutoffMinutes / 60),\n\t\tcutoffMinutes % 60,\n\t).getTime()\n}\n\n/**\n * Start of the calendar period containing `ts`, cutoff applied.\n * All arithmetic works on local date components (never `+ 24h`), so DST\n * transitions cannot shift a boundary.\n */\nexport function calendarPeriodStart(ts: number, spec: CalendarSpec): number {\n\tconst natural = naturalPeriodStart(ts, spec)\n\tconst boundary = wallClockBoundary(natural, spec.cutoffMinutes)\n\tif (boundary <= ts) return boundary\n\treturn wallClockBoundary(previousNaturalStart(natural, spec), spec.cutoffMinutes)\n}\n\n// Per-step cursors used to find the *next* boundary. Each jump is guaranteed to\n// be shorter than one period (so no period can be skipped) and long enough to\n// make progress; the loop simply walks forward until the boundary passes `ts`.\nconst JUMP_MS: Record<CalendarEvery, number> = {\n\tday: 12 * 3_600_000,\n\tweek: 8 * 86_400_000,\n\tmonth: 8 * 86_400_000,\n\tyear: 32 * 86_400_000,\n}\n\n/** Start of the calendar period following the one containing `ts`. Strictly greater than `ts`. */\nexport function calendarNextPeriodStart(ts: number, spec: CalendarSpec): number {\n\tconst jump = JUMP_MS[spec.every]\n\tlet cursor = ts\n\tfor (let i = 0; i < 50; i++) {\n\t\tcursor += jump\n\t\tconst start = calendarPeriodStart(cursor, spec)\n\t\tif (start > ts) return start\n\t}\n\tthrow new Error('[fatigue-kit] failed to compute the next calendar period')\n}\n","import type { Duration } from './types'\n\nconst UNITS: Record<string, number> = {\n\ts: 1_000,\n\tm: 60_000,\n\th: 3_600_000,\n\td: 86_400_000,\n}\n\n/** Parse a {@link Duration} into milliseconds. Throws `TypeError` on invalid input. */\nexport function parseDuration(duration: Duration): number {\n\tif (typeof duration === 'number') {\n\t\tif (!Number.isFinite(duration) || duration <= 0) {\n\t\t\tthrow new TypeError(`[fatigue-kit] invalid duration: ${duration}`)\n\t\t}\n\t\treturn duration\n\t}\n\tconst match = /^(\\d+(?:\\.\\d+)?)\\s*([smhd])$/.exec(duration.trim())\n\tif (match === null || match[1] === undefined || match[2] === undefined) {\n\t\tthrow new TypeError(\n\t\t\t`[fatigue-kit] invalid duration: \"${duration}\". Expected a positive number of ms, or '45s' / '30m' / '12h' / '7d'.`,\n\t\t)\n\t}\n\tconst unitMs = UNITS[match[2]]\n\tif (unitMs === undefined) {\n\t\tthrow new TypeError(`[fatigue-kit] invalid duration: \"${duration}\"`)\n\t}\n\tconst ms = Number(match[1]) * unitMs\n\tif (!(ms > 0)) {\n\t\tthrow new TypeError(`[fatigue-kit] invalid duration: \"${duration}\"`)\n\t}\n\treturn ms\n}\n","import { memoryAdapter } from './adapters/memory'\nimport {\n\ttype CalendarSpec,\n\tcalendarNextPeriodStart,\n\tcalendarPeriodStart,\n\tparseCutoff,\n} from './calendar'\nimport { parseDuration } from './duration'\nimport { decodeRecord, encodeRecord, pruneRecord, RECORD_VERSION } from './record'\nimport type {\n\tCalendarRule,\n\tClock,\n\tConsumeResult,\n\tCooldownRule,\n\tFatigue,\n\tFatigueOptions,\n\tFatigueRecord,\n\tFatigueRule,\n\tLifetimeRule,\n\tSlidingWindowRule,\n\tSyncStorage,\n} from './types'\n\nconst DEFAULT_NAMESPACE = 'fatigue-kit'\nconst DEFAULT_MAX_HITS = 100\n\n// Rules are compiled once per call so duration strings are parsed a single time.\ntype CompiledRule =\n\t| { kind: 'sliding'; rule: SlidingWindowRule; max: number; windowMs: number }\n\t| { kind: 'calendar'; rule: CalendarRule; max: number; spec: CalendarSpec }\n\t| { kind: 'cooldown'; rule: CooldownRule; cooldownMs: number }\n\t| { kind: 'lifetime'; rule: LifetimeRule; max: number }\n\ninterface RuleOutcome {\n\tremaining: number\n\tnextAvailableAt?: number\n}\n\nfunction assertNonEmpty(value: string, label: string): void {\n\tif (typeof value !== 'string' || value.length === 0) {\n\t\tthrow new TypeError(`[fatigue-kit] ${label} must be a non-empty string`)\n\t}\n}\n\nfunction requireMax(max: number): void {\n\tif (!Number.isInteger(max) || max < 1) {\n\t\tthrow new TypeError(`[fatigue-kit] rule \"max\" must be a positive integer, got ${max}`)\n\t}\n}\n\nfunction compileRules(input: FatigueRule | FatigueRule[]): CompiledRule[] {\n\tconst list = Array.isArray(input) ? input : [input]\n\tif (list.length === 0) {\n\t\tthrow new TypeError('[fatigue-kit] at least one rule is required')\n\t}\n\treturn list.map((rule): CompiledRule => {\n\t\tif (rule === null || typeof rule !== 'object') {\n\t\t\tthrow new TypeError(`[fatigue-kit] unknown rule: ${JSON.stringify(rule)}`)\n\t\t}\n\t\tif ('window' in rule) {\n\t\t\trequireMax(rule.max)\n\t\t\treturn { kind: 'sliding', rule, max: rule.max, windowMs: parseDuration(rule.window) }\n\t\t}\n\t\tif ('every' in rule) {\n\t\t\trequireMax(rule.max)\n\t\t\tif (\n\t\t\t\trule.every !== 'day' &&\n\t\t\t\trule.every !== 'week' &&\n\t\t\t\trule.every !== 'month' &&\n\t\t\t\trule.every !== 'year'\n\t\t\t) {\n\t\t\t\tthrow new TypeError(`[fatigue-kit] invalid \"every\": ${JSON.stringify(rule.every)}`)\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tkind: 'calendar',\n\t\t\t\trule,\n\t\t\t\tmax: rule.max,\n\t\t\t\tspec: {\n\t\t\t\t\tevery: rule.every,\n\t\t\t\t\tcutoffMinutes: parseCutoff(rule.cutoff),\n\t\t\t\t\tweekStartsOn: rule.weekStartsOn ?? 1,\n\t\t\t\t},\n\t\t\t}\n\t\t}\n\t\tif ('cooldown' in rule) {\n\t\t\treturn { kind: 'cooldown', rule, cooldownMs: parseDuration(rule.cooldown) }\n\t\t}\n\t\tif ('max' in rule) {\n\t\t\trequireMax(rule.max)\n\t\t\treturn { kind: 'lifetime', rule, max: rule.max }\n\t\t}\n\t\tthrow new TypeError(`[fatigue-kit] unknown rule: ${JSON.stringify(rule)}`)\n\t})\n}\n\nfunction outcomeFor(compiled: CompiledRule, record: FatigueRecord, now: number): RuleOutcome {\n\tswitch (compiled.kind) {\n\t\tcase 'sliding': {\n\t\t\tconst from = now - compiled.windowMs\n\t\t\tlet count = 0\n\t\t\tlet oldest = Number.POSITIVE_INFINITY\n\t\t\tfor (const hit of record.hits) {\n\t\t\t\tif (hit > from) {\n\t\t\t\t\tcount++\n\t\t\t\t\tif (hit < oldest) oldest = hit\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst remaining = compiled.max - count\n\t\t\treturn {\n\t\t\t\tremaining,\n\t\t\t\tnextAvailableAt:\n\t\t\t\t\tremaining <= 0 && oldest !== Number.POSITIVE_INFINITY\n\t\t\t\t\t\t? oldest + compiled.windowMs\n\t\t\t\t\t\t: undefined,\n\t\t\t}\n\t\t}\n\t\tcase 'calendar': {\n\t\t\tconst start = calendarPeriodStart(now, compiled.spec)\n\t\t\tlet count = 0\n\t\t\tfor (const hit of record.hits) {\n\t\t\t\tif (hit >= start) count++\n\t\t\t}\n\t\t\tconst remaining = compiled.max - count\n\t\t\treturn {\n\t\t\t\tremaining,\n\t\t\t\tnextAvailableAt: remaining <= 0 ? calendarNextPeriodStart(now, compiled.spec) : undefined,\n\t\t\t}\n\t\t}\n\t\tcase 'cooldown': {\n\t\t\tconst lastHit = record.hits.length > 0 ? record.hits[record.hits.length - 1] : undefined\n\t\t\tif (lastHit === undefined) return { remaining: Number.POSITIVE_INFINITY }\n\t\t\tconst readyAt = lastHit + compiled.cooldownMs\n\t\t\treturn {\n\t\t\t\tremaining: Number.POSITIVE_INFINITY,\n\t\t\t\tnextAvailableAt: readyAt > now ? readyAt : undefined,\n\t\t\t}\n\t\t}\n\t\tcase 'lifetime': {\n\t\t\treturn { remaining: compiled.max - record.lifetime }\n\t\t}\n\t}\n}\n\nfunction evaluate(record: FatigueRecord, compiled: CompiledRule[], now: number): ConsumeResult {\n\tlet remaining = Number.POSITIVE_INFINITY\n\tlet nextAvailableAt: number | undefined\n\tlet deniedBy: FatigueRule | undefined\n\tfor (const rule of compiled) {\n\t\tconst outcome = outcomeFor(rule, record, now)\n\t\tif (Number.isFinite(outcome.remaining)) {\n\t\t\tremaining = Math.min(remaining, outcome.remaining)\n\t\t}\n\t\tif (\n\t\t\toutcome.nextAvailableAt !== undefined &&\n\t\t\t(nextAvailableAt === undefined || outcome.nextAvailableAt > nextAvailableAt)\n\t\t) {\n\t\t\tnextAvailableAt = outcome.nextAvailableAt\n\t\t}\n\t\tconst ruleAllows =\n\t\t\toutcome.remaining > 0 &&\n\t\t\t(outcome.nextAvailableAt === undefined || outcome.nextAvailableAt <= now)\n\t\tif (!ruleAllows) deniedBy ??= rule.rule\n\t}\n\tconst result: ConsumeResult = {\n\t\tallowed: deniedBy === undefined,\n\t\tremaining: Math.max(0, remaining),\n\t}\n\tif (nextAvailableAt !== undefined) result.nextAvailableAt = nextAvailableAt\n\tif (deniedBy !== undefined) result.deniedBy = deniedBy\n\treturn result\n}\n\n/**\n * Oldest timestamp that still has to be kept to evaluate the rules. Used to\n * prune the hit list on write: anything older than this is dead weight, and the\n * `lifetime` counter keeps lifetime rules working regardless.\n */\nfunction keepFrom(compiled: CompiledRule[], now: number): number {\n\tlet keep = now\n\tfor (const rule of compiled) {\n\t\tif (rule.kind === 'sliding') keep = Math.min(keep, now - rule.windowMs)\n\t\telse if (rule.kind === 'calendar') keep = Math.min(keep, calendarPeriodStart(now, rule.spec))\n\t\telse if (rule.kind === 'cooldown') keep = Math.min(keep, now - rule.cooldownMs)\n\t}\n\treturn keep\n}\n\n/**\n * Create a fatigue (frequency capping) instance.\n *\n * ```ts\n * const fatigue = createFatigue({ storage: localStorageAdapter() })\n * const { allowed } = fatigue.tryConsume('popup', [{ max: 1, every: 'day' }])\n * ```\n */\nexport function createFatigue(options: FatigueOptions = {}): Fatigue {\n\tconst storage: SyncStorage = options.storage ?? memoryAdapter()\n\tconst clock: Clock = options.clock ?? { now: () => Date.now() }\n\tconst namespace = options.namespace ?? DEFAULT_NAMESPACE\n\tconst maxHits = options.maxHits ?? DEFAULT_MAX_HITS\n\tassertNonEmpty(namespace, 'namespace')\n\tif (!Number.isInteger(maxHits) || maxHits < 1) {\n\t\tthrow new TypeError(`[fatigue-kit] maxHits must be a positive integer, got ${maxHits}`)\n\t}\n\n\tconst storageKey = (key: string): string => {\n\t\tassertNonEmpty(key, 'key')\n\t\treturn `${namespace}:${key}`\n\t}\n\n\tconst read = (key: string): FatigueRecord => decodeRecord(storage.get(storageKey(key)))\n\n\tconst tryConsume = (key: string, rules: FatigueRule | FatigueRule[]): ConsumeResult => {\n\t\tconst compiled = compileRules(rules)\n\t\tconst now = clock.now()\n\t\tconst record = read(key)\n\t\tconst result = evaluate(record, compiled, now)\n\t\tif (result.allowed) {\n\t\t\t// `remaining` describes the state *after* the call, so `remaining === 0`\n\t\t\t// means \"this was the last allowed consumption\".\n\t\t\tif (Number.isFinite(result.remaining)) {\n\t\t\t\tresult.remaining = Math.max(0, result.remaining - 1)\n\t\t\t}\n\t\t\trecord.hits.push(now)\n\t\t\trecord.lifetime += 1\n\t\t\tpruneRecord(record, keepFrom(compiled, now), maxHits)\n\t\t\tstorage.set(storageKey(key), encodeRecord(record))\n\t\t}\n\t\treturn result\n\t}\n\n\tconst peek = (key: string, rules: FatigueRule | FatigueRule[]): ConsumeResult => {\n\t\tconst compiled = compileRules(rules)\n\t\treturn evaluate(read(key), compiled, clock.now())\n\t}\n\n\tconst reset = (key?: string): void => {\n\t\tif (key !== undefined) {\n\t\t\tstorage.remove(storageKey(key))\n\t\t\treturn\n\t\t}\n\t\tif (typeof storage.keys !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t'[fatigue-kit] reset() without a key requires a storage adapter implementing keys()',\n\t\t\t)\n\t\t}\n\t\tconst prefix = `${namespace}:`\n\t\tfor (const storedKey of storage.keys()) {\n\t\t\tif (storedKey.startsWith(prefix)) storage.remove(storedKey)\n\t\t}\n\t}\n\n\tconst exportRecord = (key: string): FatigueRecord | null => {\n\t\tconst raw = storage.get(storageKey(key))\n\t\treturn raw ? decodeRecord(raw) : null\n\t}\n\n\tconst importRecord = (key: string, record: Partial<FatigueRecord>): void => {\n\t\tconst hits = (record.hits ?? [])\n\t\t\t.filter((hit): hit is number => typeof hit === 'number' && Number.isFinite(hit))\n\t\t\t.sort((a, b) => a - b)\n\t\tconst lifetime =\n\t\t\ttypeof record.lifetime === 'number' &&\n\t\t\tNumber.isFinite(record.lifetime) &&\n\t\t\trecord.lifetime >= 0\n\t\t\t\t? record.lifetime\n\t\t\t\t: hits.length\n\t\tstorage.set(storageKey(key), encodeRecord({ v: RECORD_VERSION, hits, lifetime }))\n\t}\n\n\treturn { tryConsume, peek, reset, exportRecord, importRecord }\n}\n"],"mappings":"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","names":["_a"]}

package/dist/legacy.cjs

@@ -0,0 +1,45 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkK7E4LWULcjs = require('./chunk-K7E4LWUL.cjs');
+
+// src/legacy.ts
+var DAY_MS = 864e5;
+function migrateLegacyRecord(input) {
+  if (input === null || input === void 0) return null;
+  let raw = input;
+  if (typeof input === "string") {
+    try {
+      raw = JSON.parse(input);
+    } catch (e) {
+      return null;
+    }
+  }
+  if (raw === null || typeof raw !== "object") return null;
+  const candidate = raw;
+  const lastHit = parseLegacyDate(candidate.date);
+  if (lastHit === null) return null;
+  const record = _chunkK7E4LWULcjs.emptyRecord.call(void 0, );
+  record.hits = [lastHit];
+  record.lifetime = Math.max(0, numberOr(candidate.times, 0));
+  const durationDays = numberOr(candidate.duration, 0);
+  return { record, cooldownMs: durationDays > 0 ? durationDays * DAY_MS : null };
+}
+function parseLegacyDate(value) {
+  if (typeof value !== "string") return null;
+  const match = /^(\d{4})[/-](\d{1,2})[/-](\d{1,2})/.exec(value.trim());
+  if (match === null) {
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? null : parsed;
+  }
+  const [, year, month, day] = match;
+  if (year === void 0 || month === void 0 || day === void 0) return null;
+  return new Date(Number(year), Number(month) - 1, Number(day)).getTime();
+}
+function numberOr(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+
+
+
+exports.DAY_MS = DAY_MS; exports.migrateLegacyRecord = migrateLegacyRecord;
+//# sourceMappingURL=legacy.cjs.map

package/dist/legacy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/fatigue-kit/fatigue-kit/dist/legacy.cjs","../src/legacy.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACA;ACSO,IAAM,OAAA,EAAS,KAAA;AA4Bf,SAAS,mBAAA,CACf,KAAA,EAC8B;AAC9B,EAAA,GAAA,CAAI,MAAA,IAAU,KAAA,GAAQ,MAAA,IAAU,KAAA,CAAA,EAAW,OAAO,IAAA;AAClD,EAAA,IAAI,IAAA,EAAe,KAAA;AACnB,EAAA,GAAA,CAAI,OAAO,MAAA,IAAU,QAAA,EAAU;AAC9B,IAAA,IAAI;AACH,MAAA,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAAA,IACvB,EAAA,MAAA,CAAQ,CAAA,EAAA;AACP,MAAA,OAAO,IAAA;AAAA,IACR;AAAA,EACD;AACA,EAAA,GAAA,CAAI,IAAA,IAAQ,KAAA,GAAQ,OAAO,IAAA,IAAQ,QAAA,EAAU,OAAO,IAAA;AACpD,EAAA,MAAM,UAAA,EAAY,GAAA;AAClB,EAAA,MAAM,QAAA,EAAU,eAAA,CAAgB,SAAA,CAAU,IAAI,CAAA;AAC9C,EAAA,GAAA,CAAI,QAAA,IAAY,IAAA,EAAM,OAAO,IAAA;AAC7B,EAAA,MAAM,OAAA,EAAS,2CAAA,CAAY;AAC3B,EAAA,MAAA,CAAO,KAAA,EAAO,CAAC,OAAO,CAAA;AACtB,EAAA,MAAA,CAAO,SAAA,EAAW,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,QAAA,CAAS,SAAA,CAAU,KAAA,EAAO,CAAC,CAAC,CAAA;AAC1D,EAAA,MAAM,aAAA,EAAe,QAAA,CAAS,SAAA,CAAU,QAAA,EAAU,CAAC,CAAA;AACnD,EAAA,OAAO,EAAE,MAAA,EAAQ,UAAA,EAAY,aAAA,EAAe,EAAA,EAAI,aAAA,EAAe,OAAA,EAAS,KAAK,CAAA;AAC9E;AAEA,SAAS,eAAA,CAAgB,KAAA,EAA+B;AACvD,EAAA,GAAA,CAAI,OAAO,MAAA,IAAU,QAAA,EAAU,OAAO,IAAA;AACtC,EAAA,MAAM,MAAA,EAAQ,oCAAA,CAAqC,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA;AACpE,EAAA,GAAA,CAAI,MAAA,IAAU,IAAA,EAAM;AACnB,IAAA,MAAM,OAAA,EAAS,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC/B,IAAA,OAAO,MAAA,CAAO,KAAA,CAAM,MAAM,EAAA,EAAI,KAAA,EAAO,MAAA;AAAA,EACtC;AACA,EAAA,MAAM,CAAC,EAAE,IAAA,EAAM,KAAA,EAAO,GAAG,EAAA,EAAI,KAAA;AAC7B,EAAA,GAAA,CAAI,KAAA,IAAS,KAAA,EAAA,GAAa,MAAA,IAAU,KAAA,EAAA,GAAa,IAAA,IAAQ,KAAA,CAAA,EAAW,OAAO,IAAA;AAC3E,EAAA,OAAO,IAAI,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,EAAG,MAAA,CAAO,KAAK,EAAA,EAAI,CAAA,EAAG,MAAA,CAAO,GAAG,CAAC,CAAA,CAAE,OAAA,CAAQ,CAAA;AACvE;AAEA,SAAS,QAAA,CAAS,KAAA,EAAgB,QAAA,EAA0B;AAC3D,EAAA,OAAO,OAAO,MAAA,IAAU,SAAA,GAAY,MAAA,CAAO,QAAA,CAAS,KAAK,EAAA,EAAI,MAAA,EAAQ,QAAA;AACtE;ADtCA;AACE;AACA;AACF,2EAAC","file":"/home/runner/work/fatigue-kit/fatigue-kit/dist/legacy.cjs","sourcesContent":[null,"import { emptyRecord } from './record'\nimport type { FatigueRecord } from './types'\n\n/** Shape of the records written by the legacy internal FatigueManager. */\nexport interface LegacyFatigueRecord {\n\ttimes?: number\n\t/** `'YYYY/MM/DD'` (`'YYYY-MM-DD'` is tolerated too). */\n\tdate?: string\n\t/** Cooldown length in days. */\n\tduration?: number\n\ttodayCount?: number\n}\n\nexport const DAY_MS = 86_400_000\n\nexport interface MigratedLegacyRecord {\n\trecord: FatigueRecord\n\t/**\n\t * Cooldown in ms implied by the legacy `duration` field, or `null`.\n\t * Pass it as `{ cooldown: cooldownMs }` to keep the old behaviour.\n\t */\n\tcooldownMs: number | null\n}\n\n/**\n * Convert a legacy record (raw string or parsed object) into the fatigue-kit\n * format. Returns `null` when no usable `date` field exists.\n *\n * Approximation: legacy records only remember the last activity *day* plus an\n * aggregate `todayCount`, so the migrated record holds a single hit placed at\n * local midnight of that day; `times` maps to `lifetime`.\n *\n * ```ts\n * const migrated = migrateLegacyRecord(await storage.getItem(legacyKey))\n * if (migrated) {\n *   fatigue.importRecord(key, migrated.record)\n *   const rules = [{ max: 3, window: '7d' }]\n *   if (migrated.cooldownMs !== null) rules.push({ cooldown: migrated.cooldownMs })\n * }\n * ```\n */\nexport function migrateLegacyRecord(\n\tinput: string | LegacyFatigueRecord | null | undefined,\n): MigratedLegacyRecord | null {\n\tif (input === null || input === undefined) return null\n\tlet raw: unknown = input\n\tif (typeof input === 'string') {\n\t\ttry {\n\t\t\traw = JSON.parse(input)\n\t\t} catch {\n\t\t\treturn null\n\t\t}\n\t}\n\tif (raw === null || typeof raw !== 'object') return null\n\tconst candidate = raw as LegacyFatigueRecord\n\tconst lastHit = parseLegacyDate(candidate.date)\n\tif (lastHit === null) return null\n\tconst record = emptyRecord()\n\trecord.hits = [lastHit]\n\trecord.lifetime = Math.max(0, numberOr(candidate.times, 0))\n\tconst durationDays = numberOr(candidate.duration, 0)\n\treturn { record, cooldownMs: durationDays > 0 ? durationDays * DAY_MS : null }\n}\n\nfunction parseLegacyDate(value: unknown): number | null {\n\tif (typeof value !== 'string') return null\n\tconst match = /^(\\d{4})[/-](\\d{1,2})[/-](\\d{1,2})/.exec(value.trim())\n\tif (match === null) {\n\t\tconst parsed = Date.parse(value)\n\t\treturn Number.isNaN(parsed) ? null : parsed\n\t}\n\tconst [, year, month, day] = match\n\tif (year === undefined || month === undefined || day === undefined) return null\n\treturn new Date(Number(year), Number(month) - 1, Number(day)).getTime()\n}\n\nfunction numberOr(value: unknown, fallback: number): number {\n\treturn typeof value === 'number' && Number.isFinite(value) ? value : fallback\n}\n"]}

package/dist/legacy.d.cts

@@ -0,0 +1,40 @@
+import { e as FatigueRecord } from './types-hDxN5bc3.cjs';
+
+/** Shape of the records written by the legacy internal FatigueManager. */
+interface LegacyFatigueRecord {
+    times?: number;
+    /** `'YYYY/MM/DD'` (`'YYYY-MM-DD'` is tolerated too). */
+    date?: string;
+    /** Cooldown length in days. */
+    duration?: number;
+    todayCount?: number;
+}
+declare const DAY_MS = 86400000;
+interface MigratedLegacyRecord {
+    record: FatigueRecord;
+    /**
+     * Cooldown in ms implied by the legacy `duration` field, or `null`.
+     * Pass it as `{ cooldown: cooldownMs }` to keep the old behaviour.
+     */
+    cooldownMs: number | null;
+}
+/**
+ * Convert a legacy record (raw string or parsed object) into the fatigue-kit
+ * format. Returns `null` when no usable `date` field exists.
+ *
+ * Approximation: legacy records only remember the last activity *day* plus an
+ * aggregate `todayCount`, so the migrated record holds a single hit placed at
+ * local midnight of that day; `times` maps to `lifetime`.
+ *
+ * ```ts
+ * const migrated = migrateLegacyRecord(await storage.getItem(legacyKey))
+ * if (migrated) {
+ *   fatigue.importRecord(key, migrated.record)
+ *   const rules = [{ max: 3, window: '7d' }]
+ *   if (migrated.cooldownMs !== null) rules.push({ cooldown: migrated.cooldownMs })
+ * }
+ * ```
+ */
+declare function migrateLegacyRecord(input: string | LegacyFatigueRecord | null | undefined): MigratedLegacyRecord | null;
+
+export { DAY_MS, type LegacyFatigueRecord, type MigratedLegacyRecord, migrateLegacyRecord };

package/dist/legacy.d.ts

@@ -0,0 +1,40 @@
+import { e as FatigueRecord } from './types-hDxN5bc3.js';
+
+/** Shape of the records written by the legacy internal FatigueManager. */
+interface LegacyFatigueRecord {
+    times?: number;
+    /** `'YYYY/MM/DD'` (`'YYYY-MM-DD'` is tolerated too). */
+    date?: string;
+    /** Cooldown length in days. */
+    duration?: number;
+    todayCount?: number;
+}
+declare const DAY_MS = 86400000;
+interface MigratedLegacyRecord {
+    record: FatigueRecord;
+    /**
+     * Cooldown in ms implied by the legacy `duration` field, or `null`.
+     * Pass it as `{ cooldown: cooldownMs }` to keep the old behaviour.
+     */
+    cooldownMs: number | null;
+}
+/**
+ * Convert a legacy record (raw string or parsed object) into the fatigue-kit
+ * format. Returns `null` when no usable `date` field exists.
+ *
+ * Approximation: legacy records only remember the last activity *day* plus an
+ * aggregate `todayCount`, so the migrated record holds a single hit placed at
+ * local midnight of that day; `times` maps to `lifetime`.
+ *
+ * ```ts
+ * const migrated = migrateLegacyRecord(await storage.getItem(legacyKey))
+ * if (migrated) {
+ *   fatigue.importRecord(key, migrated.record)
+ *   const rules = [{ max: 3, window: '7d' }]
+ *   if (migrated.cooldownMs !== null) rules.push({ cooldown: migrated.cooldownMs })
+ * }
+ * ```
+ */
+declare function migrateLegacyRecord(input: string | LegacyFatigueRecord | null | undefined): MigratedLegacyRecord | null;
+
+export { DAY_MS, type LegacyFatigueRecord, type MigratedLegacyRecord, migrateLegacyRecord };

package/dist/legacy.js

@@ -0,0 +1,45 @@
+import {
+  emptyRecord
+} from "./chunk-ZNIZLIUO.js";
+
+// src/legacy.ts
+var DAY_MS = 864e5;
+function migrateLegacyRecord(input) {
+  if (input === null || input === void 0) return null;
+  let raw = input;
+  if (typeof input === "string") {
+    try {
+      raw = JSON.parse(input);
+    } catch (e) {
+      return null;
+    }
+  }
+  if (raw === null || typeof raw !== "object") return null;
+  const candidate = raw;
+  const lastHit = parseLegacyDate(candidate.date);
+  if (lastHit === null) return null;
+  const record = emptyRecord();
+  record.hits = [lastHit];
+  record.lifetime = Math.max(0, numberOr(candidate.times, 0));
+  const durationDays = numberOr(candidate.duration, 0);
+  return { record, cooldownMs: durationDays > 0 ? durationDays * DAY_MS : null };
+}
+function parseLegacyDate(value) {
+  if (typeof value !== "string") return null;
+  const match = /^(\d{4})[/-](\d{1,2})[/-](\d{1,2})/.exec(value.trim());
+  if (match === null) {
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? null : parsed;
+  }
+  const [, year, month, day] = match;
+  if (year === void 0 || month === void 0 || day === void 0) return null;
+  return new Date(Number(year), Number(month) - 1, Number(day)).getTime();
+}
+function numberOr(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+export {
+  DAY_MS,
+  migrateLegacyRecord
+};
+//# sourceMappingURL=legacy.js.map

package/dist/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/legacy.ts"],"sourcesContent":["import { emptyRecord } from './record'\nimport type { FatigueRecord } from './types'\n\n/** Shape of the records written by the legacy internal FatigueManager. */\nexport interface LegacyFatigueRecord {\n\ttimes?: number\n\t/** `'YYYY/MM/DD'` (`'YYYY-MM-DD'` is tolerated too). */\n\tdate?: string\n\t/** Cooldown length in days. */\n\tduration?: number\n\ttodayCount?: number\n}\n\nexport const DAY_MS = 86_400_000\n\nexport interface MigratedLegacyRecord {\n\trecord: FatigueRecord\n\t/**\n\t * Cooldown in ms implied by the legacy `duration` field, or `null`.\n\t * Pass it as `{ cooldown: cooldownMs }` to keep the old behaviour.\n\t */\n\tcooldownMs: number | null\n}\n\n/**\n * Convert a legacy record (raw string or parsed object) into the fatigue-kit\n * format. Returns `null` when no usable `date` field exists.\n *\n * Approximation: legacy records only remember the last activity *day* plus an\n * aggregate `todayCount`, so the migrated record holds a single hit placed at\n * local midnight of that day; `times` maps to `lifetime`.\n *\n * ```ts\n * const migrated = migrateLegacyRecord(await storage.getItem(legacyKey))\n * if (migrated) {\n *   fatigue.importRecord(key, migrated.record)\n *   const rules = [{ max: 3, window: '7d' }]\n *   if (migrated.cooldownMs !== null) rules.push({ cooldown: migrated.cooldownMs })\n * }\n * ```\n */\nexport function migrateLegacyRecord(\n\tinput: string | LegacyFatigueRecord | null | undefined,\n): MigratedLegacyRecord | null {\n\tif (input === null || input === undefined) return null\n\tlet raw: unknown = input\n\tif (typeof input === 'string') {\n\t\ttry {\n\t\t\traw = JSON.parse(input)\n\t\t} catch {\n\t\t\treturn null\n\t\t}\n\t}\n\tif (raw === null || typeof raw !== 'object') return null\n\tconst candidate = raw as LegacyFatigueRecord\n\tconst lastHit = parseLegacyDate(candidate.date)\n\tif (lastHit === null) return null\n\tconst record = emptyRecord()\n\trecord.hits = [lastHit]\n\trecord.lifetime = Math.max(0, numberOr(candidate.times, 0))\n\tconst durationDays = numberOr(candidate.duration, 0)\n\treturn { record, cooldownMs: durationDays > 0 ? durationDays * DAY_MS : null }\n}\n\nfunction parseLegacyDate(value: unknown): number | null {\n\tif (typeof value !== 'string') return null\n\tconst match = /^(\\d{4})[/-](\\d{1,2})[/-](\\d{1,2})/.exec(value.trim())\n\tif (match === null) {\n\t\tconst parsed = Date.parse(value)\n\t\treturn Number.isNaN(parsed) ? null : parsed\n\t}\n\tconst [, year, month, day] = match\n\tif (year === undefined || month === undefined || day === undefined) return null\n\treturn new Date(Number(year), Number(month) - 1, Number(day)).getTime()\n}\n\nfunction numberOr(value: unknown, fallback: number): number {\n\treturn typeof value === 'number' && Number.isFinite(value) ? value : fallback\n}\n"],"mappings":";;;;;AAaO,IAAM,SAAS;AA4Bf,SAAS,oBACf,OAC8B;AAC9B,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,MAAe;AACnB,MAAI,OAAO,UAAU,UAAU;AAC9B,QAAI;AACH,YAAM,KAAK,MAAM,KAAK;AAAA,IACvB,SAAQ;AACP,aAAO;AAAA,IACR;AAAA,EACD;AACA,MAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU,QAAO;AACpD,QAAM,YAAY;AAClB,QAAM,UAAU,gBAAgB,UAAU,IAAI;AAC9C,MAAI,YAAY,KAAM,QAAO;AAC7B,QAAM,SAAS,YAAY;AAC3B,SAAO,OAAO,CAAC,OAAO;AACtB,SAAO,WAAW,KAAK,IAAI,GAAG,SAAS,UAAU,OAAO,CAAC,CAAC;AAC1D,QAAM,eAAe,SAAS,UAAU,UAAU,CAAC;AACnD,SAAO,EAAE,QAAQ,YAAY,eAAe,IAAI,eAAe,SAAS,KAAK;AAC9E;AAEA,SAAS,gBAAgB,OAA+B;AACvD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,QAAQ,qCAAqC,KAAK,MAAM,KAAK,CAAC;AACpE,MAAI,UAAU,MAAM;AACnB,UAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,WAAO,OAAO,MAAM,MAAM,IAAI,OAAO;AAAA,EACtC;AACA,QAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI;AAC7B,MAAI,SAAS,UAAa,UAAU,UAAa,QAAQ,OAAW,QAAO;AAC3E,SAAO,IAAI,KAAK,OAAO,IAAI,GAAG,OAAO,KAAK,IAAI,GAAG,OAAO,GAAG,CAAC,EAAE,QAAQ;AACvE;AAEA,SAAS,SAAS,OAAgB,UAA0B;AAC3D,SAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ;AACtE;","names":[]}

package/dist/types-hDxN5bc3.d.cts

@@ -0,0 +1,89 @@
+/** Injectable clock so tests can freeze or accelerate time. */
+interface Clock {
+    now(): number;
+}
+/**
+ * Duration: a millisecond number, or a string like `'45s'`, `'30m'`, `'12h'`, `'7d'`.
+ */
+type Duration = number | string;
+/** At most `max` occurrences within a sliding window. */
+interface SlidingWindowRule {
+    max: number;
+    window: Duration;
+}
+/** At most `max` occurrences per calendar period, evaluated in device local time. */
+interface CalendarRule {
+    max: number;
+    every: 'day' | 'week' | 'month' | 'year';
+    /** Period boundary offset in local time, `'HH:mm'`. Default `'00:00'`. */
+    cutoff?: string;
+    /** First weekday: `0` = Sunday … `6` = Saturday. Default `1` (Monday). */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+}
+/** Two occurrences must be at least `cooldown` apart. */
+interface CooldownRule {
+    cooldown: Duration;
+}
+/** At most `max` occurrences, ever. */
+interface LifetimeRule {
+    max: number;
+}
+type FatigueRule = SlidingWindowRule | CalendarRule | CooldownRule | LifetimeRule;
+interface ConsumeResult {
+    allowed: boolean;
+    /**
+     * How many more times the key may be consumed under the strictest count-based
+     * rule. `Infinity` when no count-based rule applies (e.g. a cooldown-only key).
+     */
+    remaining: number;
+    /** Earliest timestamp (ms) at which the key may be consumed again. Absent while allowed. */
+    nextAvailableAt?: number;
+    /** The first rule that caused the denial. */
+    deniedBy?: FatigueRule;
+}
+/**
+ * A synchronous string key-value store. Every built-in adapter implements this,
+ * and so can yours — this is the only contract `createFatigue` relies on.
+ */
+interface SyncStorage {
+    get(key: string): string | null | undefined;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    /**
+     * Optional: list all keys known to this storage.
+     * Enables `fatigue.reset()` without a key.
+     */
+    keys?(): string[];
+}
+/** Serialized fatigue record. `hits` are ascending timestamps in ms. */
+interface FatigueRecord {
+    /** Record format version. */
+    v: number;
+    hits: number[];
+    /** Total consumption count, ever. Survives pruning. */
+    lifetime: number;
+}
+interface FatigueOptions {
+    /** Backing storage. Defaults to an in-memory store. */
+    storage?: SyncStorage;
+    /** Clock. Defaults to the real system time. */
+    clock?: Clock;
+    /** Prefix for storage keys. Default `'fatigue-kit'`. */
+    namespace?: string;
+    /** Maximum hits kept per record; older ones are pruned on write. Default `100`. */
+    maxHits?: number;
+}
+interface Fatigue {
+    /** Atomically check the rules and, when allowed, consume one occurrence. */
+    tryConsume(key: string, rules: FatigueRule | FatigueRule[]): ConsumeResult;
+    /** Check the rules without consuming. */
+    peek(key: string, rules: FatigueRule | FatigueRule[]): ConsumeResult;
+    /** Drop one key, or every key when omitted (requires `storage.keys`). */
+    reset(key?: string): void;
+    /** Read the raw record of a key. `null` when absent. */
+    exportRecord(key: string): FatigueRecord | null;
+    /** Overwrite the record of a key (used for migrations and debugging). */
+    importRecord(key: string, record: Partial<FatigueRecord>): void;
+}
+
+export type { CalendarRule as C, Duration as D, FatigueOptions as F, LifetimeRule as L, SyncStorage as S, Fatigue as a, Clock as b, ConsumeResult as c, CooldownRule as d, FatigueRecord as e, FatigueRule as f, SlidingWindowRule as g };