@read-frog/api-contract 0.18.1 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@read-frog/api-contract",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@orpc/contract": "^1.15.2",
-    "@read-frog/definitions": "0.7.0",
+    "@read-frog/definitions": "0.8.0",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/contracts/srs.ts

@@ -8,6 +8,8 @@ import {
   srsListCardRevlogsOutputSchema,
   srsListUnreadOptimizerResultsInputSchema,
   srsListUnreadOptimizerResultsOutputSchema,
+  srsRecentNotebaseScheduleStatusStatsInputSchema,
+  srsRecentNotebaseScheduleStatusStatsOutputSchema,
   srsReviewInputSchema,
   srsReviewOutputSchema,
   srsRollbackReviewInputSchema,
@@ -32,6 +34,17 @@ export const srsContract = {
     .errors(pickPublicErrorMap("NOTEBASE_NOT_FOUND"))
     .input(srsScheduleStatusStatsInputSchema)
     .output(srsScheduleStatusStatsOutputSchema),
+  recentNotebaseScheduleStatusStats: oc
+    .route({
+      method: "GET",
+      path: "/srs/schedule-status-stats/recent",
+      summary: "Get study queue counts of the most recently used notebase",
+      description:
+        "Picks the owned notebase with the latest review or content edit (notes, fields or templates) and returns its study queue counts in the supplied timezone.",
+      tags: ["SRS"],
+    })
+    .input(srsRecentNotebaseScheduleStatusStatsInputSchema)
+    .output(srsRecentNotebaseScheduleStatusStatsOutputSchema),
   listUnreadOptimizerResults: oc
     .route({
       method: "GET",

package/src/schemas/notebase.ts

@@ -2,6 +2,7 @@ import { deletionResultSchema } from "./resource-mutation";
 import {
   notebaseColumnConfigSchema,
   schedulingParamsShape,
+  srsModelVersionSchema,
   srsWeightsSchema,
 } from "@read-frog/definitions";
 import { z } from "zod";
@@ -38,6 +39,8 @@ export const notebaseSchema = z.object({
   srsLeechThreshold: schedulingParamsShape.leechThreshold,
   srsEnableFuzz: schedulingParamsShape.enableFuzz,
   srsWeights: srsWeightsSchema.nullable(),
+  // Selects the scheduler/curve; read-only, changed only by the FSRS-7 migration.
+  srsModelVersion: srsModelVersionSchema,
   createdAt: z.date(),
   updatedAt: z.date(),
 });

package/src/schemas/srs.ts

@@ -3,6 +3,7 @@ import {
   activeScheduleStatusSchema,
   cardStateSchema,
   fsrsReviewLogSnapshotSchema,
+  fsrsMemoryStateSchema,
   reviewRatingSchema,
   scheduleStatusSchema,
   schedulingParamsSchema,
@@ -11,6 +12,7 @@ import {
 } from "@read-frog/definitions";
 import { z } from "zod";
 import { cardSchema } from "./card";
+import { notebaseSummarySchema } from "./notebase";
 import { timezoneSchema } from "./timezone";
 
 export { reviewRatingSchema, schedulingParamsSchema, SRS_REVIEW_DURATION_MS_MAX };
@@ -73,6 +75,26 @@ export type SrsScheduleStatusStatsInput = z.infer<typeof srsScheduleStatusStatsI
 export const srsScheduleStatusStatsOutputSchema = z.record(z.uuid(), srsScheduleStatusStatsSchema);
 export type SrsScheduleStatusStatsOutput = z.infer<typeof srsScheduleStatusStatsOutputSchema>;
 
+export const srsRecentNotebaseScheduleStatusStatsInputSchema = z
+  .object({
+    timezone: timezoneSchema,
+  })
+  .strict();
+export type SrsRecentNotebaseScheduleStatusStatsInput = z.infer<
+  typeof srsRecentNotebaseScheduleStatusStatsInputSchema
+>;
+
+/** Null when the user has no notebase yet. */
+export const srsRecentNotebaseScheduleStatusStatsOutputSchema = z
+  .object({
+    notebase: notebaseSummarySchema,
+    stats: srsScheduleStatusStatsSchema,
+  })
+  .nullable();
+export type SrsRecentNotebaseScheduleStatusStatsOutput = z.infer<
+  typeof srsRecentNotebaseScheduleStatusStatsOutputSchema
+>;
+
 export const srsManualCardStatusInputSchema = z
   .object({
     cardId: z.uuid(),
@@ -95,7 +117,9 @@ export const srsRevlogSchema = z.object({
   state: cardStateSchema,
   stability: z.number(),
   afterScheduleStatus: scheduleStatusSchema,
-  afterStability: z.number(),
+  afterMemoryState: fsrsMemoryStateSchema,
+  retentionDays90: z.number().nonnegative(),
+  afterRetentionDays90: z.number().nonnegative(),
   reviewedAt: z.coerce.date(),
   durationMs: z.number().int(),
   fsrsReviewLogSnapshot: fsrsReviewLogSnapshotSchema,