fatigue-kit 0.0.0-stage → 0.2.0

package/dist/index.cjs

@@ -0,0 +1,334 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkK7E4LWULcjs = require('./chunk-K7E4LWUL.cjs');
+
+
+var _chunkNBDAXDB6cjs = require('./chunk-NBDAXDB6.cjs');
+
+// 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 : _chunkNBDAXDB6cjs.memoryAdapter.call(void 0, );
+  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) => _chunkK7E4LWULcjs.decodeRecord.call(void 0, 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;
+      _chunkK7E4LWULcjs.pruneRecord.call(void 0, record, keepFrom(compiled, now), maxHits);
+      storage.set(storageKey(key), _chunkK7E4LWULcjs.encodeRecord.call(void 0, 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 ? _chunkK7E4LWULcjs.decodeRecord.call(void 0, 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), _chunkK7E4LWULcjs.encodeRecord.call(void 0, { v: _chunkK7E4LWULcjs.RECORD_VERSION, hits, lifetime }));
+  };
+  return { tryConsume, peek, reset, exportRecord, importRecord };
+}
+
+
+
+
+exports.RECORD_VERSION = _chunkK7E4LWULcjs.RECORD_VERSION; exports.createFatigue = createFatigue; exports.memoryAdapter = _chunkNBDAXDB6cjs.memoryAdapter;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/fatigue-kit/fatigue-kit/dist/index.cjs","../src/calendar.ts","../src/duration.ts","../src/engine.ts"],"names":["_a"],"mappings":"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","file":"/home/runner/work/fatigue-kit/fatigue-kit/dist/index.cjs","sourcesContent":[null,"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"]}

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+export { memoryAdapter } from './adapters/memory.cjs';
+import { F as FatigueOptions, a as Fatigue } from './types-hDxN5bc3.cjs';
+export { C as CalendarRule, b as Clock, c as ConsumeResult, d as CooldownRule, D as Duration, e as FatigueRecord, f as FatigueRule, L as LifetimeRule, g as SlidingWindowRule, S as SyncStorage } from './types-hDxN5bc3.cjs';
+
+/**
+ * Create a fatigue (frequency capping) instance.
+ *
+ * ```ts
+ * const fatigue = createFatigue({ storage: localStorageAdapter() })
+ * const { allowed } = fatigue.tryConsume('popup', [{ max: 1, every: 'day' }])
+ * ```
+ */
+declare function createFatigue(options?: FatigueOptions): Fatigue;
+
+declare const RECORD_VERSION = 1;
+
+export { Fatigue, FatigueOptions, RECORD_VERSION, createFatigue };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { memoryAdapter } from './adapters/memory.js';
+import { F as FatigueOptions, a as Fatigue } from './types-hDxN5bc3.js';
+export { C as CalendarRule, b as Clock, c as ConsumeResult, d as CooldownRule, D as Duration, e as FatigueRecord, f as FatigueRule, L as LifetimeRule, g as SlidingWindowRule, S as SyncStorage } from './types-hDxN5bc3.js';
+
+/**
+ * Create a fatigue (frequency capping) instance.
+ *
+ * ```ts
+ * const fatigue = createFatigue({ storage: localStorageAdapter() })
+ * const { allowed } = fatigue.tryConsume('popup', [{ max: 1, every: 'day' }])
+ * ```
+ */
+declare function createFatigue(options?: FatigueOptions): Fatigue;
+
+declare const RECORD_VERSION = 1;
+
+export { Fatigue, FatigueOptions, RECORD_VERSION, createFatigue };