@vue-skuilder/db 0.1.29 → 0.1.30

package/dist/{contentSource-DfBbaLA-.d.cts → contentSource-B7nXusjk.d.cts}

@@ -742,10 +742,15 @@ type NavigatorConstructor = new (user: UserDBInterface, course: CourseDBInterfac
  * Call this to make a navigator available for instantiation by
  * ContentNavigator.create() without relying on dynamic imports.
  *
- * @param implementingClass - The class name (e.g., 'elo', 'hierarchyDefinition')
+ * Passing a `role` is optional for built-in navigators (whose roles are in
+ * the hardcoded `NavigatorRoles` record), but **required** for consumer-
+ * defined navigators that need to participate in pipeline assembly.
+ *
+ * @param implementingClass - The class name (e.g., 'elo', 'letterGatingFilter')
  * @param constructor - The navigator class constructor
+ * @param role - Optional pipeline role (GENERATOR or FILTER)
  */
-declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor): void;
+declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor, role?: NavigatorRole): void;
 /**
  * Get a navigator constructor from the registry.
  *
@@ -760,6 +765,13 @@ declare function getRegisteredNavigator(implementingClass: string): NavigatorCon
  * @returns true if registered, false otherwise
  */
 declare function hasRegisteredNavigator(implementingClass: string): boolean;
+/**
+ * Get the registered role for a navigator, if one was provided at registration.
+ *
+ * @param implementingClass - The class name to look up
+ * @returns The role, or undefined if not registered or no role was specified
+ */
+declare function getRegisteredNavigatorRole(implementingClass: string): NavigatorRole | undefined;
 /**
  * Get all registered navigator names.
  * Useful for debugging and testing.
@@ -925,7 +937,10 @@ declare function isGenerator(impl: string): boolean;
 /**
  * Check if a navigator implementation is a filter.
  *
- * @param impl - Navigator implementation name (e.g., 'elo', 'hierarchyDefinition')
+ * Checks the built-in NavigatorRoles enum first, then falls back to the
+ * navigator registry for consumer-registered navigators.
+ *
+ * @param impl - Navigator implementation name (e.g., 'elo', 'letterGatingFilter')
  * @returns true if the navigator is a filter, false otherwise
  */
 declare function isFilter(impl: string): boolean;
@@ -1084,4 +1099,4 @@ interface StudyContentSource {
 }
 declare function getStudySource(source: ContentSourceID, user: UserDBInterface): Promise<StudyContentSource>;
 
-export { isGenerator as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorNames as Q, initializeNavigatorRegistry as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, type StrategyContribution as V, type WeightedCard as W, getCardOrigin as X, Navigators as Y, NavigatorRole as Z, NavigatorRoles as _, type UserDBReader as a, isFilter as a0, type LearnableWeight as a1, type OrchestrationContext as a2, computeDeviation as a3, computeSpread as a4, computeEffectiveWeight as a5, createOrchestrationContext as a6, type DocumentUpdater as a7, newInterval as a8, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };
+export { NavigatorRoles as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorRole as Q, getRegisteredNavigatorNames as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, initializeNavigatorRegistry as V, type WeightedCard as W, type StrategyContribution as X, getCardOrigin as Y, Navigators as Z, NavigatorRole as _, type UserDBReader as a, isGenerator as a0, isFilter as a1, type LearnableWeight as a2, type OrchestrationContext as a3, computeDeviation as a4, computeSpread as a5, computeEffectiveWeight as a6, createOrchestrationContext as a7, type DocumentUpdater as a8, newInterval as a9, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };

package/dist/{contentSource-BmnmvH8C.d.ts → contentSource-ygoFw9oV.d.ts}

@@ -742,10 +742,15 @@ type NavigatorConstructor = new (user: UserDBInterface, course: CourseDBInterfac
  * Call this to make a navigator available for instantiation by
  * ContentNavigator.create() without relying on dynamic imports.
  *
- * @param implementingClass - The class name (e.g., 'elo', 'hierarchyDefinition')
+ * Passing a `role` is optional for built-in navigators (whose roles are in
+ * the hardcoded `NavigatorRoles` record), but **required** for consumer-
+ * defined navigators that need to participate in pipeline assembly.
+ *
+ * @param implementingClass - The class name (e.g., 'elo', 'letterGatingFilter')
  * @param constructor - The navigator class constructor
+ * @param role - Optional pipeline role (GENERATOR or FILTER)
  */
-declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor): void;
+declare function registerNavigator(implementingClass: string, constructor: NavigatorConstructor, role?: NavigatorRole): void;
 /**
  * Get a navigator constructor from the registry.
  *
@@ -760,6 +765,13 @@ declare function getRegisteredNavigator(implementingClass: string): NavigatorCon
  * @returns true if registered, false otherwise
  */
 declare function hasRegisteredNavigator(implementingClass: string): boolean;
+/**
+ * Get the registered role for a navigator, if one was provided at registration.
+ *
+ * @param implementingClass - The class name to look up
+ * @returns The role, or undefined if not registered or no role was specified
+ */
+declare function getRegisteredNavigatorRole(implementingClass: string): NavigatorRole | undefined;
 /**
  * Get all registered navigator names.
  * Useful for debugging and testing.
@@ -925,7 +937,10 @@ declare function isGenerator(impl: string): boolean;
 /**
  * Check if a navigator implementation is a filter.
  *
- * @param impl - Navigator implementation name (e.g., 'elo', 'hierarchyDefinition')
+ * Checks the built-in NavigatorRoles enum first, then falls back to the
+ * navigator registry for consumer-registered navigators.
+ *
+ * @param impl - Navigator implementation name (e.g., 'elo', 'letterGatingFilter')
  * @returns true if the navigator is a filter, false otherwise
  */
 declare function isFilter(impl: string): boolean;
@@ -1084,4 +1099,4 @@ interface StudyContentSource {
 }
 declare function getStudySource(source: ContentSourceID, user: UserDBInterface): Promise<StudyContentSource>;
 
-export { isGenerator as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorNames as Q, initializeNavigatorRegistry as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, type StrategyContribution as V, type WeightedCard as W, getCardOrigin as X, Navigators as Y, NavigatorRole as Z, NavigatorRoles as _, type UserDBReader as a, isFilter as a0, type LearnableWeight as a1, type OrchestrationContext as a2, computeDeviation as a3, computeSpread as a4, computeEffectiveWeight as a5, createOrchestrationContext as a6, type DocumentUpdater as a7, newInterval as a8, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };
+export { NavigatorRoles as $, type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type UserOutcomeRecord as L, registerNavigator as M, type NavigatorConstructor as N, getRegisteredNavigator as O, hasRegisteredNavigator as P, getRegisteredNavigatorRole as Q, getRegisteredNavigatorNames as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, initializeNavigatorRegistry as V, type WeightedCard as W, type StrategyContribution as X, getCardOrigin as Y, Navigators as Z, NavigatorRole as _, type UserDBReader as a, isGenerator as a0, isFilter as a1, type LearnableWeight as a2, type OrchestrationContext as a3, computeDeviation as a4, computeSpread as a5, computeEffectiveWeight as a6, createOrchestrationContext as a7, type DocumentUpdater as a8, newInterval as a9, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };

package/dist/core/index.d.cts

@@ -1,6 +1,6 @@
-import { a1 as LearnableWeight, L as UserOutcomeRecord, a2 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, V as StrategyContribution } from '../contentSource-DfBbaLA-.cjs';
-export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, Z as NavigatorRole, _ as NavigatorRoles, Y as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a3 as computeDeviation, a5 as computeEffectiveWeight, a4 as computeSpread, a6 as createOrchestrationContext, X as getCardOrigin, O as getRegisteredNavigator, Q as getRegisteredNavigatorNames, r as getStudySource, P as hasRegisteredNavigator, R as initializeNavigatorRegistry, a0 as isFilter, $ as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-DfBbaLA-.cjs';
-export { D as DataLayerProvider } from '../dataLayerProvider-BeRXVMs5.cjs';
+import { a2 as LearnableWeight, L as UserOutcomeRecord, a3 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, X as StrategyContribution } from '../contentSource-B7nXusjk.cjs';
+export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, _ as NavigatorRole, $ as NavigatorRoles, Z as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a4 as computeDeviation, a6 as computeEffectiveWeight, a5 as computeSpread, a7 as createOrchestrationContext, Y as getCardOrigin, O as getRegisteredNavigator, R as getRegisteredNavigatorNames, Q as getRegisteredNavigatorRole, r as getStudySource, P as hasRegisteredNavigator, V as initializeNavigatorRegistry, a1 as isFilter, a0 as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-B7nXusjk.cjs';
+export { D as DataLayerProvider } from '../dataLayerProvider-BW7HvkMt.cjs';
 import { D as DocType, i as QuestionRecord, b as DocTypePrefixes, C as CardHistory, c as CardRecord } from '../types-legacy-JXDxinpU.cjs';
 export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from '../types-legacy-JXDxinpU.cjs';
 import { DataShape, ParsedCard } from '@vue-skuilder/common';

package/dist/core/index.d.ts

@@ -1,6 +1,6 @@
-import { a1 as LearnableWeight, L as UserOutcomeRecord, a2 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, V as StrategyContribution } from '../contentSource-BmnmvH8C.js';
-export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, Z as NavigatorRole, _ as NavigatorRoles, Y as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a3 as computeDeviation, a5 as computeEffectiveWeight, a4 as computeSpread, a6 as createOrchestrationContext, X as getCardOrigin, O as getRegisteredNavigator, Q as getRegisteredNavigatorNames, r as getStudySource, P as hasRegisteredNavigator, R as initializeNavigatorRegistry, a0 as isFilter, $ as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-BmnmvH8C.js';
-export { D as DataLayerProvider } from '../dataLayerProvider-CG9GfaAY.js';
+import { a2 as LearnableWeight, L as UserOutcomeRecord, a3 as OrchestrationContext, W as WeightedCard, U as UserDBInterface, C as CourseDBInterface, X as StrategyContribution } from '../contentSource-ygoFw9oV.js';
+export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, s as CourseRegistrationDoc, b as CoursesDBInterface, N as NavigatorConstructor, _ as NavigatorRole, $ as NavigatorRoles, Z as Navigators, j as ScheduledCard, H as SessionTrackingData, i as StudentClassroomDBInterface, h as StudyContentSource, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, a4 as computeDeviation, a6 as computeEffectiveWeight, a5 as computeSpread, a7 as createOrchestrationContext, Y as getCardOrigin, O as getRegisteredNavigator, R as getRegisteredNavigatorNames, Q as getRegisteredNavigatorRole, r as getStudySource, P as hasRegisteredNavigator, V as initializeNavigatorRegistry, a1 as isFilter, a0 as isGenerator, p as isReview, M as registerNavigator } from '../contentSource-ygoFw9oV.js';
+export { D as DataLayerProvider } from '../dataLayerProvider-BfXUVDuG.js';
 import { D as DocType, i as QuestionRecord, b as DocTypePrefixes, C as CardHistory, c as CardRecord } from '../types-legacy-JXDxinpU.js';
 export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from '../types-legacy-JXDxinpU.js';
 import { DataShape, ParsedCard } from '@vue-skuilder/common';

package/dist/core/index.js

@@ -3180,6 +3180,7 @@ __export(navigators_exports, {
   getCardOrigin: () => getCardOrigin,
   getRegisteredNavigator: () => getRegisteredNavigator,
   getRegisteredNavigatorNames: () => getRegisteredNavigatorNames,
+  getRegisteredNavigatorRole: () => getRegisteredNavigatorRole,
   hasRegisteredNavigator: () => hasRegisteredNavigator,
   initializeNavigatorRegistry: () => initializeNavigatorRegistry,
   isFilter: () => isFilter,
@@ -3188,16 +3189,19 @@ __export(navigators_exports, {
   pipelineDebugAPI: () => pipelineDebugAPI,
   registerNavigator: () => registerNavigator
 });
-function registerNavigator(implementingClass, constructor) {
-  navigatorRegistry.set(implementingClass, constructor);
-  logger.debug(`[NavigatorRegistry] Registered: ${implementingClass}`);
+function registerNavigator(implementingClass, constructor, role) {
+  navigatorRegistry.set(implementingClass, { constructor, role });
+  logger.debug(`[NavigatorRegistry] Registered: ${implementingClass}${role ? ` (${role})` : ""}`);
 }
 function getRegisteredNavigator(implementingClass) {
-  return navigatorRegistry.get(implementingClass);
+  return navigatorRegistry.get(implementingClass)?.constructor;
 }
 function hasRegisteredNavigator(implementingClass) {
   return navigatorRegistry.has(implementingClass);
 }
+function getRegisteredNavigatorRole(implementingClass) {
+  return navigatorRegistry.get(implementingClass)?.role;
+}
 function getRegisteredNavigatorNames() {
   return Array.from(navigatorRegistry.keys());
 }
@@ -3243,10 +3247,12 @@ function getCardOrigin(card) {
   return "new";
 }
 function isGenerator(impl) {
-  return NavigatorRoles[impl] === "generator" /* GENERATOR */;
+  if (NavigatorRoles[impl] === "generator" /* GENERATOR */) return true;
+  return getRegisteredNavigatorRole(impl) === "generator" /* GENERATOR */;
 }
 function isFilter(impl) {
-  return NavigatorRoles[impl] === "filter" /* FILTER */;
+  if (NavigatorRoles[impl] === "filter" /* FILTER */) return true;
+  return getRegisteredNavigatorRole(impl) === "filter" /* FILTER */;
 }
 var navigatorRegistry, Navigators, NavigatorRole, NavigatorRoles, ContentNavigator;
 var init_navigators = __esm({
@@ -6159,6 +6165,7 @@ __export(core_exports, {
   getDefaultLearnableWeight: () => getDefaultLearnableWeight,
   getRegisteredNavigator: () => getRegisteredNavigator,
   getRegisteredNavigatorNames: () => getRegisteredNavigatorNames,
+  getRegisteredNavigatorRole: () => getRegisteredNavigatorRole,
   getStudySource: () => getStudySource,
   hasRegisteredNavigator: () => hasRegisteredNavigator,
   importParsedCards: () => importParsedCards,
@@ -6223,6 +6230,7 @@ init_core();
   getDefaultLearnableWeight,
   getRegisteredNavigator,
   getRegisteredNavigatorNames,
+  getRegisteredNavigatorRole,
   getStudySource,
   hasRegisteredNavigator,
   importParsedCards,