@vue-skuilder/db 0.1.16 → 0.1.18

package/dist/{dataLayerProvider-BV5iZqt_.d.ts → dataLayerProvider-CZxC9GtB.d.ts}

@@ -1,4 +1,4 @@
-import { U as UserDBInterface, a as UserDBReader, C as CourseDBInterface, b as CoursesDBInterface, c as ClassroomDBInterface, A as AdminDBInterface } from './userDB-DNa0XPtn.js';
+import { U as UserDBInterface, a as UserDBReader, C as CourseDBInterface, b as CoursesDBInterface, c as ClassroomDBInterface, A as AdminDBInterface } from './classroomDB-BgfrVb8d.js';
 
 /**
  * Main factory interface for data access

package/dist/{dataLayerProvider-VlngD19_.d.mts → dataLayerProvider-D6PoCwS6.d.cts}

@@ -1,4 +1,4 @@
-import { U as UserDBInterface, a as UserDBReader, C as CourseDBInterface, b as CoursesDBInterface, c as ClassroomDBInterface, A as AdminDBInterface } from './userDB-BqwxtJ_7.mjs';
+import { U as UserDBInterface, a as UserDBReader, C as CourseDBInterface, b as CoursesDBInterface, c as ClassroomDBInterface, A as AdminDBInterface } from './classroomDB-CTOenngH.cjs';
 
 /**
  * Main factory interface for data access

package/dist/impl/couch/{index.d.mts → index.d.cts}

@@ -1,10 +1,10 @@
-import { T as TagStub, a as Tag, S as SkuilderCourseData, Q as QualifiedCardID } from '../../types-legacy-6ettoclI.mjs';
+import { T as TagStub, a as Tag, S as SkuilderCourseData, Q as QualifiedCardID } from '../../types-legacy-6ettoclI.cjs';
 import { Moment } from 'moment';
-import { A as AdminDBInterface, h as AssignedContent, i as StudyContentSource, j as StudentClassroomDBInterface, U as UserDBInterface, f as StudySessionReviewItem, g as ScheduledCard, S as StudySessionNewItem, T as TeacherClassroomDBInterface, b as CoursesDBInterface, C as CourseDBInterface, d as CourseInfo, D as DataLayerResult, e as ContentNavigationStrategyData, k as StudySessionItem } from '../../userDB-BqwxtJ_7.mjs';
-export { p as ContentSourceID, l as StudySessionFailedItem, m as StudySessionFailedNewItem, n as StudySessionFailedReviewItem, q as getStudySource, o as isReview } from '../../userDB-BqwxtJ_7.mjs';
+import { A as AdminDBInterface, h as AssignedContent, i as StudyContentSource, j as StudentClassroomDBInterface, U as UserDBInterface, f as StudySessionReviewItem, g as ScheduledCard, S as StudySessionNewItem, W as WeightedCard, T as TeacherClassroomDBInterface, b as CoursesDBInterface, C as CourseDBInterface, d as CourseInfo, D as DataLayerResult, e as ContentNavigationStrategyData, k as ContentNavigator, l as StudySessionItem } from '../../classroomDB-CTOenngH.cjs';
+export { q as ContentSourceID, m as StudySessionFailedItem, n as StudySessionFailedNewItem, o as StudySessionFailedReviewItem, r as getStudySource, p as isReview } from '../../classroomDB-CTOenngH.cjs';
 import * as _vue_skuilder_common from '@vue-skuilder/common';
 import { ClassroomConfig, DataShape, CourseElo, CourseConfig as CourseConfig$1 } from '@vue-skuilder/common';
-import { S as SyncStrategy, A as AccountCreationResult, a as AuthenticationResult } from '../../SyncStrategy-CyATpyLQ.mjs';
+import { S as SyncStrategy, A as AccountCreationResult, a as AuthenticationResult } from '../../SyncStrategy-CyATpyLQ.cjs';
 
 type NamespacedDatashape = string;
 interface DataShape55 {
@@ -88,6 +88,17 @@ declare class StudentClassroomDB extends ClassroomDBBase implements StudyContent
     setChangeFcn(f: (value: unknown) => object): void;
     getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
     getNewCards(): Promise<StudySessionNewItem[]>;
+    /**
+     * Get cards with suitability scores for presentation.
+     *
+     * This implementation wraps the legacy getNewCards/getPendingReviews methods,
+     * assigning score=1.0 to all cards. StudentClassroomDB does not currently
+     * support pluggable navigation strategies.
+     *
+     * @param limit - Maximum number of cards to return
+     * @returns Cards sorted by score descending (all scores = 1.0)
+     */
+    getWeightedCards(limit: number): Promise<WeightedCard[]>;
 }
 /**
  * Interface for managing a classroom.
@@ -195,9 +206,39 @@ declare class CourseDB implements StudyContentSource, CourseDBInterface {
     getAllNavigationStrategies(): Promise<ContentNavigationStrategyData[]>;
     addNavigationStrategy(data: ContentNavigationStrategyData): Promise<void>;
     updateNavigationStrategy(id: string, data: ContentNavigationStrategyData): Promise<void>;
-    surfaceNavigationStrategy(): Promise<ContentNavigationStrategyData>;
+    /**
+     * Creates an instantiated navigator for this course.
+     *
+     * Handles multiple generators by wrapping them in CompositeGenerator.
+     * This is the preferred method for getting a ready-to-use navigator.
+     *
+     * @param user - User database interface
+     * @returns Instantiated ContentNavigator ready for use
+     */
+    createNavigator(user: UserDBInterface): Promise<ContentNavigator>;
+    private makeDefaultEloStrategy;
+    private makeDefaultSrsStrategy;
+    /**
+     * Creates the default navigation pipeline for courses with no configured strategies.
+     *
+     * Default: Pipeline(Composite(ELO, SRS), [eloDistanceFilter])
+     * - ELO generator: scores new cards by skill proximity
+     * - SRS generator: scores reviews by overdueness and interval recency
+     * - ELO distance filter: penalizes cards far from user's current level
+     */
+    private createDefaultPipeline;
     getNewCards(limit?: number): Promise<StudySessionNewItem[]>;
     getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
+    /**
+     * Get cards with suitability scores for presentation.
+     *
+     * This is the PRIMARY API for content sources going forward. Delegates to the
+     * course's configured NavigationStrategy to get scored candidates.
+     *
+     * @param limit - Maximum number of cards to return
+     * @returns Cards sorted by score descending
+     */
+    getWeightedCards(limit: number): Promise<WeightedCard[]>;
     getCardsCenteredAtELO(options?: {
         limit: number;
         elo: 'user' | 'random' | number;

package/dist/impl/couch/index.d.ts

@@ -1,7 +1,7 @@
 import { T as TagStub, a as Tag, S as SkuilderCourseData, Q as QualifiedCardID } from '../../types-legacy-6ettoclI.js';
 import { Moment } from 'moment';
-import { A as AdminDBInterface, h as AssignedContent, i as StudyContentSource, j as StudentClassroomDBInterface, U as UserDBInterface, f as StudySessionReviewItem, g as ScheduledCard, S as StudySessionNewItem, T as TeacherClassroomDBInterface, b as CoursesDBInterface, C as CourseDBInterface, d as CourseInfo, D as DataLayerResult, e as ContentNavigationStrategyData, k as StudySessionItem } from '../../userDB-DNa0XPtn.js';
-export { p as ContentSourceID, l as StudySessionFailedItem, m as StudySessionFailedNewItem, n as StudySessionFailedReviewItem, q as getStudySource, o as isReview } from '../../userDB-DNa0XPtn.js';
+import { A as AdminDBInterface, h as AssignedContent, i as StudyContentSource, j as StudentClassroomDBInterface, U as UserDBInterface, f as StudySessionReviewItem, g as ScheduledCard, S as StudySessionNewItem, W as WeightedCard, T as TeacherClassroomDBInterface, b as CoursesDBInterface, C as CourseDBInterface, d as CourseInfo, D as DataLayerResult, e as ContentNavigationStrategyData, k as ContentNavigator, l as StudySessionItem } from '../../classroomDB-BgfrVb8d.js';
+export { q as ContentSourceID, m as StudySessionFailedItem, n as StudySessionFailedNewItem, o as StudySessionFailedReviewItem, r as getStudySource, p as isReview } from '../../classroomDB-BgfrVb8d.js';
 import * as _vue_skuilder_common from '@vue-skuilder/common';
 import { ClassroomConfig, DataShape, CourseElo, CourseConfig as CourseConfig$1 } from '@vue-skuilder/common';
 import { S as SyncStrategy, A as AccountCreationResult, a as AuthenticationResult } from '../../SyncStrategy-CyATpyLQ.js';
@@ -88,6 +88,17 @@ declare class StudentClassroomDB extends ClassroomDBBase implements StudyContent
     setChangeFcn(f: (value: unknown) => object): void;
     getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
     getNewCards(): Promise<StudySessionNewItem[]>;
+    /**
+     * Get cards with suitability scores for presentation.
+     *
+     * This implementation wraps the legacy getNewCards/getPendingReviews methods,
+     * assigning score=1.0 to all cards. StudentClassroomDB does not currently
+     * support pluggable navigation strategies.
+     *
+     * @param limit - Maximum number of cards to return
+     * @returns Cards sorted by score descending (all scores = 1.0)
+     */
+    getWeightedCards(limit: number): Promise<WeightedCard[]>;
 }
 /**
  * Interface for managing a classroom.
@@ -195,9 +206,39 @@ declare class CourseDB implements StudyContentSource, CourseDBInterface {
     getAllNavigationStrategies(): Promise<ContentNavigationStrategyData[]>;
     addNavigationStrategy(data: ContentNavigationStrategyData): Promise<void>;
     updateNavigationStrategy(id: string, data: ContentNavigationStrategyData): Promise<void>;
-    surfaceNavigationStrategy(): Promise<ContentNavigationStrategyData>;
+    /**
+     * Creates an instantiated navigator for this course.
+     *
+     * Handles multiple generators by wrapping them in CompositeGenerator.
+     * This is the preferred method for getting a ready-to-use navigator.
+     *
+     * @param user - User database interface
+     * @returns Instantiated ContentNavigator ready for use
+     */
+    createNavigator(user: UserDBInterface): Promise<ContentNavigator>;
+    private makeDefaultEloStrategy;
+    private makeDefaultSrsStrategy;
+    /**
+     * Creates the default navigation pipeline for courses with no configured strategies.
+     *
+     * Default: Pipeline(Composite(ELO, SRS), [eloDistanceFilter])
+     * - ELO generator: scores new cards by skill proximity
+     * - SRS generator: scores reviews by overdueness and interval recency
+     * - ELO distance filter: penalizes cards far from user's current level
+     */
+    private createDefaultPipeline;
     getNewCards(limit?: number): Promise<StudySessionNewItem[]>;
     getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
+    /**
+     * Get cards with suitability scores for presentation.
+     *
+     * This is the PRIMARY API for content sources going forward. Delegates to the
+     * course's configured NavigationStrategy to get scored candidates.
+     *
+     * @param limit - Maximum number of cards to return
+     * @returns Cards sorted by score descending
+     */
+    getWeightedCards(limit: number): Promise<WeightedCard[]>;
     getCardsCenteredAtELO(options?: {
         limit: number;
         elo: 'user' | 'random' | number;