ts-fsrs 3.0.1 → 3.0.2

package/dist/default.js

@@ -29,7 +29,7 @@ exports.default_w = exports.envParams.FSRS_W || [
     0.34, 1.26, 0.29, 2.61,
 ];
 exports.default_enable_fuzz = exports.envParams.FSRS_ENABLE_FUZZ || false;
-exports.FSRSVersion = "3.0.1";
+exports.FSRSVersion = "3.0.2";
 const generatorParameters = (props) => {
     return {
         request_retention: props?.request_retention || exports.default_request_retention,

package/dist/fsrs.d.ts

@@ -6,6 +6,10 @@ export declare class FSRS {
     private readonly intervalModifier;
     private seed?;
     constructor(param: Partial<FSRSParameters>);
+    preProcess(card: Card, now: Date): {
+        card: Card;
+        now: Date;
+    };
     repeat: (card: Card, now: Date) => {
         1: {
             card: Card;

package/dist/fsrs.js

@@ -19,12 +19,20 @@ class FSRS {
         // The formula used is : I(r,s)=9 \cdot  s \cdot (\frac{1}{r}-1)
         this.intervalModifier = 9 * (1 / this.param.request_retention - 1);
     }
-    repeat = (card, now) => {
+    preProcess(card, now) {
         card = {
             ...card,
+            state: (0, help_1.fixState)(card.state),
+            due: (0, help_1.fixDate)(card.due),
             last_review: card.last_review ? (0, help_1.fixDate)(card.last_review) : undefined,
         };
         now = (0, help_1.fixDate)(now);
+        return { card, now };
+    }
+    repeat = (card, now) => {
+        const process = this.preProcess(card, now);
+        card = process.card;
+        now = process.now;
         card.elapsed_days =
             card.state === models_1.State.New ? 0 : now.diff(card.last_review, "days"); //相距时间
         card.last_review = now; // 上次复习时间
@@ -68,6 +76,9 @@ class FSRS {
         return s.record_log(card, now);
     };
     get_retrievability = (card, now) => {
+        const process = this.preProcess(card, now);
+        card = process.card;
+        now = process.now;
         if (card.state !== models_1.State.Review) {
             return undefined;
         }

package/dist/help.d.ts

@@ -1,4 +1,5 @@
 import type { int, unit } from "./type";
+import { Rating, State } from "./models";
 declare global {
     export interface Date {
         scheduler(t: int, isDay?: boolean): Date;
@@ -12,3 +13,5 @@ export declare function date_diff(now: Date, pre: Date, unit: unit): number;
 export declare function formatDate(date: Date): string;
 export declare function show_diff_message(due: Date, last_review: Date, unit?: boolean, timeUnit?: string[]): string;
 export declare function fixDate(value: unknown): Date;
+export declare function fixState(value: unknown): State;
+export declare function fixRating(value: unknown): Rating;

package/dist/help.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fixDate = exports.show_diff_message = exports.formatDate = exports.date_diff = exports.date_scheduler = void 0;
+exports.fixRating = exports.fixState = exports.fixDate = exports.show_diff_message = exports.formatDate = exports.date_diff = exports.date_scheduler = void 0;
+const models_1 = require("./models");
 Date.prototype.scheduler = function (t, isDay) {
     return date_scheduler(this, t, isDay);
 };
@@ -25,6 +26,9 @@ function date_scheduler(now, t, isDay) {
 }
 exports.date_scheduler = date_scheduler;
 function date_diff(now, pre, unit) {
+    if (!now || !pre) {
+        throw new Error("Invalid date");
+    }
     const diff = now.getTime() - pre.getTime();
     let r = 0;
     switch (unit) {
@@ -92,3 +96,23 @@ function fixDate(value) {
     throw new Error(`Invalid date:[${value}]`);
 }
 exports.fixDate = fixDate;
+function fixState(value) {
+    if (typeof value === "string") {
+        return models_1.State[value];
+    }
+    else if (typeof value === "number") {
+        return value;
+    }
+    throw new Error(`Invalid state:[${value}]`);
+}
+exports.fixState = fixState;
+function fixRating(value) {
+    if (typeof value === "string") {
+        return models_1.Rating[value];
+    }
+    else if (typeof value === "number") {
+        return value;
+    }
+    throw new Error(`Invalid rating:[${value}]`);
+}
+exports.fixRating = fixRating;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-fsrs",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "ts-fsrs is a TypeScript package used to implement the Free Spaced Repetition Scheduler (FSRS) algorithm. It helps developers apply FSRS to their flashcard applications, thereby improving the user learning experience.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",