@contractspec/module.learning-journey 1.57.0 → 1.58.0

package/dist/engines/streak.d.ts

@@ -1,100 +1,97 @@
-//#region src/engines/streak.d.ts
 /**
  * Streak Tracking Engine
  *
  * Manages daily learning streaks with timezone support and freeze protection.
  */
-interface StreakState {
-  /** Current streak days */
-  currentStreak: number;
-  /** Longest streak ever */
-  longestStreak: number;
-  /** Last activity timestamp */
-  lastActivityAt: Date | null;
-  /** Last activity date (YYYY-MM-DD) */
-  lastActivityDate: string | null;
-  /** Available streak freezes */
-  freezesRemaining: number;
-  /** When a freeze was last used */
-  freezeUsedAt: Date | null;
+export interface StreakState {
+    /** Current streak days */
+    currentStreak: number;
+    /** Longest streak ever */
+    longestStreak: number;
+    /** Last activity timestamp */
+    lastActivityAt: Date | null;
+    /** Last activity date (YYYY-MM-DD) */
+    lastActivityDate: string | null;
+    /** Available streak freezes */
+    freezesRemaining: number;
+    /** When a freeze was last used */
+    freezeUsedAt: Date | null;
 }
-interface StreakUpdateResult {
-  /** Updated streak state */
-  state: StreakState;
-  /** Whether streak was maintained */
-  streakMaintained: boolean;
-  /** Whether streak was lost */
-  streakLost: boolean;
-  /** Whether a freeze was used */
-  freezeUsed: boolean;
-  /** Whether this activity started a new streak */
-  newStreak: boolean;
-  /** Days missed (if streak was lost) */
-  daysMissed: number;
+export interface StreakUpdateResult {
+    /** Updated streak state */
+    state: StreakState;
+    /** Whether streak was maintained */
+    streakMaintained: boolean;
+    /** Whether streak was lost */
+    streakLost: boolean;
+    /** Whether a freeze was used */
+    freezeUsed: boolean;
+    /** Whether this activity started a new streak */
+    newStreak: boolean;
+    /** Days missed (if streak was lost) */
+    daysMissed: number;
 }
-interface StreakConfig {
-  /** Timezone for the user */
-  timezone: string;
-  /** How many streak freezes to give per month */
-  freezesPerMonth: number;
-  /** Maximum freezes that can be accumulated */
-  maxFreezes: number;
-  /** Grace period in hours after midnight */
-  gracePeriodHours: number;
+export interface StreakConfig {
+    /** Timezone for the user */
+    timezone: string;
+    /** How many streak freezes to give per month */
+    freezesPerMonth: number;
+    /** Maximum freezes that can be accumulated */
+    maxFreezes: number;
+    /** Grace period in hours after midnight */
+    gracePeriodHours: number;
 }
-declare const DEFAULT_STREAK_CONFIG: StreakConfig;
-declare class StreakEngine {
-  private config;
-  constructor(config?: Partial<StreakConfig>);
-  /**
-   * Update streak based on new activity.
-   */
-  update(state: StreakState, now?: Date): StreakUpdateResult;
-  /**
-   * Check streak status without recording activity.
-   */
-  checkStatus(state: StreakState, now?: Date): {
-    isActive: boolean;
-    willExpireAt: Date | null;
-    canUseFreeze: boolean;
-    daysUntilExpiry: number;
-  };
-  /**
-   * Manually use a freeze to protect streak.
-   */
-  useFreeze(state: StreakState, now?: Date): StreakState | null;
-  /**
-   * Award monthly freezes.
-   */
-  awardMonthlyFreezes(state: StreakState): StreakState;
-  /**
-   * Get initial streak state.
-   */
-  getInitialState(): StreakState;
-  /**
-   * Calculate streak milestones.
-   */
-  getMilestones(currentStreak: number): {
-    achieved: number[];
-    next: number | null;
-  };
-  /**
-   * Get date string in YYYY-MM-DD format.
-   */
-  private getDateString;
-  /**
-   * Get number of days between two date strings.
-   */
-  private getDaysBetween;
-  /**
-   * Add days to a date.
-   */
-  private addDays;
+export declare const DEFAULT_STREAK_CONFIG: StreakConfig;
+export declare class StreakEngine {
+    private config;
+    constructor(config?: Partial<StreakConfig>);
+    /**
+     * Update streak based on new activity.
+     */
+    update(state: StreakState, now?: Date): StreakUpdateResult;
+    /**
+     * Check streak status without recording activity.
+     */
+    checkStatus(state: StreakState, now?: Date): {
+        isActive: boolean;
+        willExpireAt: Date | null;
+        canUseFreeze: boolean;
+        daysUntilExpiry: number;
+    };
+    /**
+     * Manually use a freeze to protect streak.
+     */
+    useFreeze(state: StreakState, now?: Date): StreakState | null;
+    /**
+     * Award monthly freezes.
+     */
+    awardMonthlyFreezes(state: StreakState): StreakState;
+    /**
+     * Get initial streak state.
+     */
+    getInitialState(): StreakState;
+    /**
+     * Calculate streak milestones.
+     */
+    getMilestones(currentStreak: number): {
+        achieved: number[];
+        next: number | null;
+    };
+    /**
+     * Get date string in YYYY-MM-DD format.
+     */
+    private getDateString;
+    /**
+     * Get number of days between two date strings.
+     */
+    private getDaysBetween;
+    /**
+     * Add days to a date.
+     */
+    private addDays;
 }
 /**
  * Default streak engine instance.
  */
-declare const streakEngine: StreakEngine;
-//#endregion
-export { DEFAULT_STREAK_CONFIG, StreakConfig, StreakEngine, StreakState, StreakUpdateResult, streakEngine };
+export declare const streakEngine: StreakEngine;
 //# sourceMappingURL=streak.d.ts.map

package/dist/engines/streak.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streak.d.ts","names":[],"sources":["../../src/engines/streak.ts"],"mappings":";;AAQA;;;;UAAiB,WAAA;EAIf;EAFA,aAAA;EAIgB;EAFhB,aAAA;EAMA;EAJA,cAAA,EAAgB,IAAA;EAMF;EAJd,gBAAA;EAIkB;EAFlB,gBAAA;EAKiC;EAHjC,YAAA,EAAc,IAAA;AAAA;AAAA,UAGC,kBAAA;EAER;EAAP,KAAA,EAAO,WAAA;EAIP;EAFA,gBAAA;EAMA;EAJA,UAAA;EAMU;EAJV,UAAA;EAOe;EALf,SAAA;;EAEA,UAAA;AAAA;AAAA,UAGe,YAAA;EAMf;EAJA,QAAA;EAMgB;EAJhB,eAAA;EASW;EAPX,UAAA;;EAEA,gBAAA;AAAA;AAAA,cAKW,qBAAA,EAAuB,YAAA;AAAA,cASvB,YAAA;EAAA,QACH,MAAA;cAEI,MAAA,GAAQ,OAAA,CAAQ,YAAA;EAAR;;;EAOpB,MAAA,CAAO,KAAA,EAAO,WAAA,EAAa,GAAA,GAAK,IAAA,GAAoB,kBAAA;EAmF3C;;;EADT,WAAA,CACE,KAAA,EAAO,WAAA,EACP,GAAA,GAAK,IAAA;IAEL,QAAA;IACA,YAAA,EAAc,IAAA;IACd,YAAA;IACA,eAAA;EAAA;EAkF4B;;;EA5B9B,SAAA,CAAU,KAAA,EAAO,WAAA,EAAa,GAAA,GAAK,IAAA,GAAoB,WAAA;EAtJnC;;;EAqKpB,mBAAA,CAAoB,KAAA,EAAO,WAAA,GAAc,WAAA;EA9J3B;;;EA2Kd,eAAA,CAAA,GAAmB,WAAA;EA3KiC;;;EAyLpD,aAAA,CAAc,aAAA;IACZ,QAAA;IACA,IAAA;EAAA;EApGA;;;EAAA,QAiHM,aAAA;EAzDR;;;EAAA,QAoEQ,cAAA;EApEsB;;;EAAA,QA8EtB,OAAA;AAAA;;;;cAQG,YAAA,EAAY,YAAA"}
+{"version":3,"file":"streak.d.ts","sourceRoot":"","sources":["../../src/engines/streak.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAC;AAIF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAE,IAAiB,GAAG,kBAAkB;IA+EtE;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,GAAG,GAAE,IAAiB,GACrB;QACD,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;KACzB;IAkDD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAE,IAAiB,GAAG,WAAW,GAAG,IAAI;IAYzE;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAUpD;;OAEG;IACH,eAAe,IAAI,WAAW;IAW9B;;OAEG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB;IASD;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,OAAO;CAGhB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/engines/streak.js

@@ -1,194 +1,160 @@
-//#region src/engines/streak.ts
-const DEFAULT_STREAK_CONFIG = {
-	timezone: "UTC",
-	freezesPerMonth: 2,
-	maxFreezes: 5,
-	gracePeriodHours: 4
+// @bun
+// src/engines/streak.ts
+var DEFAULT_STREAK_CONFIG = {
+  timezone: "UTC",
+  freezesPerMonth: 2,
+  maxFreezes: 5,
+  gracePeriodHours: 4
 };
-var StreakEngine = class {
-	config;
-	constructor(config = {}) {
-		this.config = {
-			...DEFAULT_STREAK_CONFIG,
-			...config
-		};
-	}
-	/**
-	* Update streak based on new activity.
-	*/
-	update(state, now = /* @__PURE__ */ new Date()) {
-		const todayDate = this.getDateString(now);
-		const result = {
-			state: { ...state },
-			streakMaintained: false,
-			streakLost: false,
-			freezeUsed: false,
-			newStreak: false,
-			daysMissed: 0
-		};
-		if (!state.lastActivityDate) {
-			result.state.currentStreak = 1;
-			result.state.longestStreak = Math.max(1, state.longestStreak);
-			result.state.lastActivityAt = now;
-			result.state.lastActivityDate = todayDate;
-			result.newStreak = true;
-			result.streakMaintained = true;
-			return result;
-		}
-		if (state.lastActivityDate === todayDate) {
-			result.state.lastActivityAt = now;
-			result.streakMaintained = true;
-			return result;
-		}
-		const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
-		if (daysSinceActivity === 1) {
-			result.state.currentStreak = state.currentStreak + 1;
-			result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
-			result.state.lastActivityAt = now;
-			result.state.lastActivityDate = todayDate;
-			result.streakMaintained = true;
-			return result;
-		}
-		result.daysMissed = daysSinceActivity - 1;
-		const freezesNeeded = result.daysMissed;
-		if (freezesNeeded <= state.freezesRemaining) {
-			result.state.freezesRemaining = state.freezesRemaining - freezesNeeded;
-			result.state.freezeUsedAt = now;
-			result.state.currentStreak = state.currentStreak + 1;
-			result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
-			result.state.lastActivityAt = now;
-			result.state.lastActivityDate = todayDate;
-			result.freezeUsed = true;
-			result.streakMaintained = true;
-			return result;
-		}
-		result.streakLost = true;
-		result.state.currentStreak = 1;
-		result.state.lastActivityAt = now;
-		result.state.lastActivityDate = todayDate;
-		result.newStreak = true;
-		return result;
-	}
-	/**
-	* Check streak status without recording activity.
-	*/
-	checkStatus(state, now = /* @__PURE__ */ new Date()) {
-		if (!state.lastActivityDate) return {
-			isActive: false,
-			willExpireAt: null,
-			canUseFreeze: false,
-			daysUntilExpiry: 0
-		};
-		const todayDate = this.getDateString(now);
-		const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
-		if (daysSinceActivity === 0) {
-			const tomorrow = this.addDays(now, 1);
-			tomorrow.setHours(23, 59, 59, 999);
-			return {
-				isActive: true,
-				willExpireAt: tomorrow,
-				canUseFreeze: state.freezesRemaining > 0,
-				daysUntilExpiry: 1
-			};
-		}
-		if (daysSinceActivity === 1) {
-			const endOfDay = new Date(now);
-			endOfDay.setHours(23 + this.config.gracePeriodHours, 59, 59, 999);
-			return {
-				isActive: true,
-				willExpireAt: endOfDay,
-				canUseFreeze: state.freezesRemaining > 0,
-				daysUntilExpiry: 0
-			};
-		}
-		const missedDays = daysSinceActivity - 1;
-		return {
-			isActive: missedDays <= state.freezesRemaining,
-			willExpireAt: null,
-			canUseFreeze: missedDays <= state.freezesRemaining,
-			daysUntilExpiry: -missedDays
-		};
-	}
-	/**
-	* Manually use a freeze to protect streak.
-	*/
-	useFreeze(state, now = /* @__PURE__ */ new Date()) {
-		if (state.freezesRemaining <= 0) return null;
-		return {
-			...state,
-			freezesRemaining: state.freezesRemaining - 1,
-			freezeUsedAt: now
-		};
-	}
-	/**
-	* Award monthly freezes.
-	*/
-	awardMonthlyFreezes(state) {
-		return {
-			...state,
-			freezesRemaining: Math.min(state.freezesRemaining + this.config.freezesPerMonth, this.config.maxFreezes)
-		};
-	}
-	/**
-	* Get initial streak state.
-	*/
-	getInitialState() {
-		return {
-			currentStreak: 0,
-			longestStreak: 0,
-			lastActivityAt: null,
-			lastActivityDate: null,
-			freezesRemaining: this.config.freezesPerMonth,
-			freezeUsedAt: null
-		};
-	}
-	/**
-	* Calculate streak milestones.
-	*/
-	getMilestones(currentStreak) {
-		const milestones = [
-			3,
-			7,
-			14,
-			30,
-			60,
-			90,
-			180,
-			365,
-			500,
-			1e3
-		];
-		return {
-			achieved: milestones.filter((m) => currentStreak >= m),
-			next: milestones.find((m) => currentStreak < m) ?? null
-		};
-	}
-	/**
-	* Get date string in YYYY-MM-DD format.
-	*/
-	getDateString(date) {
-		return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
-	}
-	/**
-	* Get number of days between two date strings.
-	*/
-	getDaysBetween(dateStr1, dateStr2) {
-		const date1 = new Date(dateStr1);
-		const diffTime = new Date(dateStr2).getTime() - date1.getTime();
-		return Math.floor(diffTime / (1e3 * 60 * 60 * 24));
-	}
-	/**
-	* Add days to a date.
-	*/
-	addDays(date, days) {
-		return new Date(date.getTime() + days * 24 * 60 * 60 * 1e3);
-	}
-};
-/**
-* Default streak engine instance.
-*/
-const streakEngine = new StreakEngine();
 
-//#endregion
-export { DEFAULT_STREAK_CONFIG, StreakEngine, streakEngine };
-//# sourceMappingURL=streak.js.map
+class StreakEngine {
+  config;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_STREAK_CONFIG, ...config };
+  }
+  update(state, now = new Date) {
+    const todayDate = this.getDateString(now);
+    const result = {
+      state: { ...state },
+      streakMaintained: false,
+      streakLost: false,
+      freezeUsed: false,
+      newStreak: false,
+      daysMissed: 0
+    };
+    if (!state.lastActivityDate) {
+      result.state.currentStreak = 1;
+      result.state.longestStreak = Math.max(1, state.longestStreak);
+      result.state.lastActivityAt = now;
+      result.state.lastActivityDate = todayDate;
+      result.newStreak = true;
+      result.streakMaintained = true;
+      return result;
+    }
+    if (state.lastActivityDate === todayDate) {
+      result.state.lastActivityAt = now;
+      result.streakMaintained = true;
+      return result;
+    }
+    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
+    if (daysSinceActivity === 1) {
+      result.state.currentStreak = state.currentStreak + 1;
+      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
+      result.state.lastActivityAt = now;
+      result.state.lastActivityDate = todayDate;
+      result.streakMaintained = true;
+      return result;
+    }
+    result.daysMissed = daysSinceActivity - 1;
+    const freezesNeeded = result.daysMissed;
+    if (freezesNeeded <= state.freezesRemaining) {
+      result.state.freezesRemaining = state.freezesRemaining - freezesNeeded;
+      result.state.freezeUsedAt = now;
+      result.state.currentStreak = state.currentStreak + 1;
+      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
+      result.state.lastActivityAt = now;
+      result.state.lastActivityDate = todayDate;
+      result.freezeUsed = true;
+      result.streakMaintained = true;
+      return result;
+    }
+    result.streakLost = true;
+    result.state.currentStreak = 1;
+    result.state.lastActivityAt = now;
+    result.state.lastActivityDate = todayDate;
+    result.newStreak = true;
+    return result;
+  }
+  checkStatus(state, now = new Date) {
+    if (!state.lastActivityDate) {
+      return {
+        isActive: false,
+        willExpireAt: null,
+        canUseFreeze: false,
+        daysUntilExpiry: 0
+      };
+    }
+    const todayDate = this.getDateString(now);
+    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
+    if (daysSinceActivity === 0) {
+      const tomorrow = this.addDays(now, 1);
+      tomorrow.setHours(23, 59, 59, 999);
+      return {
+        isActive: true,
+        willExpireAt: tomorrow,
+        canUseFreeze: state.freezesRemaining > 0,
+        daysUntilExpiry: 1
+      };
+    }
+    if (daysSinceActivity === 1) {
+      const endOfDay = new Date(now);
+      endOfDay.setHours(23 + this.config.gracePeriodHours, 59, 59, 999);
+      return {
+        isActive: true,
+        willExpireAt: endOfDay,
+        canUseFreeze: state.freezesRemaining > 0,
+        daysUntilExpiry: 0
+      };
+    }
+    const missedDays = daysSinceActivity - 1;
+    return {
+      isActive: missedDays <= state.freezesRemaining,
+      willExpireAt: null,
+      canUseFreeze: missedDays <= state.freezesRemaining,
+      daysUntilExpiry: -missedDays
+    };
+  }
+  useFreeze(state, now = new Date) {
+    if (state.freezesRemaining <= 0) {
+      return null;
+    }
+    return {
+      ...state,
+      freezesRemaining: state.freezesRemaining - 1,
+      freezeUsedAt: now
+    };
+  }
+  awardMonthlyFreezes(state) {
+    return {
+      ...state,
+      freezesRemaining: Math.min(state.freezesRemaining + this.config.freezesPerMonth, this.config.maxFreezes)
+    };
+  }
+  getInitialState() {
+    return {
+      currentStreak: 0,
+      longestStreak: 0,
+      lastActivityAt: null,
+      lastActivityDate: null,
+      freezesRemaining: this.config.freezesPerMonth,
+      freezeUsedAt: null
+    };
+  }
+  getMilestones(currentStreak) {
+    const milestones = [3, 7, 14, 30, 60, 90, 180, 365, 500, 1000];
+    const achieved = milestones.filter((m) => currentStreak >= m);
+    const next = milestones.find((m) => currentStreak < m) ?? null;
+    return { achieved, next };
+  }
+  getDateString(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+  }
+  getDaysBetween(dateStr1, dateStr2) {
+    const date1 = new Date(dateStr1);
+    const date2 = new Date(dateStr2);
+    const diffTime = date2.getTime() - date1.getTime();
+    return Math.floor(diffTime / (1000 * 60 * 60 * 24));
+  }
+  addDays(date, days) {
+    return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
+  }
+}
+var streakEngine = new StreakEngine;
+export {
+  streakEngine,
+  StreakEngine,
+  DEFAULT_STREAK_CONFIG
+};