@vue-skuilder/db 0.1.21 → 0.1.23

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, h as StudyContentSource } from './contentSource-DsJadoBU.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, f as ContentNavigator, q as ContentSourceID, C as CourseDBInterface, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, j as ScheduledCard, H as SessionTrackingData, L as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, 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, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './contentSource-DsJadoBU.cjs';
+import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, h as StudyContentSource, C as CourseDBInterface } from './contentSource-DsJadoBU.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, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, j as ScheduledCard, H as SessionTrackingData, L as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, 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, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './contentSource-DsJadoBU.cjs';
 import { D as DataLayerProvider } from './dataLayerProvider-CHYrQ5pB.cjs';
 import { C as CardHistory, c as CardRecord } from './types-legacy-DDY4N-Uq.cjs';
 export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, i as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-DDY4N-Uq.cjs';
 import { Loggable } from './core/index.cjs';
 export { BulkCardProcessorConfig, CardFilter, CardFilterFactory, CardGenerator, CardGeneratorFactory, FilterContext, GeneratorContext, ImportResult, StrategyStateDoc, StrategyStateId, areQuestionRecords, buildStrategyStateId, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.cjs';
-import { TagFilter } from '@vue-skuilder/common';
+import { TagFilter, DataShape, CourseConfig } from '@vue-skuilder/common';
 import { S as StaticCourseManifest } from './types-Bn0itutr.cjs';
 export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-Bn0itutr.cjs';
 import { F as FileSystemAdapter } from './index-B_j6u5E4.cjs';
@@ -529,6 +529,119 @@ declare class CourseLookup {
     static isCourse(courseID: string): Promise<boolean>;
 }
 
+/**
+ * Interface for custom questions data structure returned by allCustomQuestions()
+ */
+interface CustomQuestionsData {
+    courses: {
+        name: string;
+    }[];
+    questionClasses: {
+        name: string;
+        dataShapes?: DataShape[];
+        views?: {
+            name?: string;
+        }[];
+        seedData?: unknown[];
+    }[];
+    dataShapes: DataShape[];
+    views: {
+        name?: string;
+    }[];
+    meta: {
+        questionCount: number;
+        dataShapeCount: number;
+        viewCount: number;
+        courseCount: number;
+        packageName: string;
+        sourceDirectory: string;
+    };
+}
+/**
+ * Interface for processed question data for registration
+ */
+interface ProcessedQuestionData {
+    name: string;
+    course: string;
+    questionClass: {
+        name: string;
+        dataShapes?: DataShape[];
+        views?: {
+            name?: string;
+        }[];
+        seedData?: unknown[];
+    };
+    dataShapes: DataShape[];
+    views: {
+        name?: string;
+    }[];
+}
+/**
+ * Interface for processed data shape for registration
+ */
+interface ProcessedDataShape {
+    name: string;
+    course: string;
+    dataShape: DataShape;
+}
+/**
+ * Check if a data shape is already registered in the course config with valid schema
+ */
+declare function isDataShapeRegistered(dataShape: ProcessedDataShape, courseConfig: CourseConfig): boolean;
+declare function isDataShapeSchemaAvailable(dataShape: ProcessedDataShape, courseConfig: CourseConfig): boolean;
+/**
+ * Check if a question type is already registered in the course config
+ */
+declare function isQuestionTypeRegistered(question: ProcessedQuestionData, courseConfig: CourseConfig): boolean;
+/**
+ * Process custom questions data into registration-ready format
+ */
+declare function processCustomQuestionsData(customQuestions: CustomQuestionsData): {
+    dataShapes: ProcessedDataShape[];
+    questions: ProcessedQuestionData[];
+};
+/**
+ * Register a data shape in the course config
+ */
+declare function registerDataShape(dataShape: ProcessedDataShape, courseConfig: CourseConfig): boolean;
+/**
+ * Register a question type in the course config
+ */
+declare function registerQuestionType(question: ProcessedQuestionData, courseConfig: CourseConfig): boolean;
+/**
+ * Register seed data for a question type
+ *
+ * @param question - The processed question data
+ * @param courseDB - The course database interface
+ * @param username - The username to attribute seed data to
+ */
+declare function registerSeedData(question: ProcessedQuestionData, courseDB: CourseDBInterface, username: string): Promise<void>;
+/**
+ * Register BlanksCard (markdown fillIn) question type specifically
+ */
+declare function registerBlanksCard(BlanksCard: {
+    name: string;
+    views?: {
+        name?: string;
+    }[];
+}, BlanksCardDataShapes: DataShape[], courseConfig: CourseConfig, courseDB: CourseDBInterface, username?: string): Promise<{
+    success: boolean;
+    errorMessage?: string;
+}>;
+/**
+ * Main function to register all custom question types and data shapes
+ *
+ * @param customQuestions - The custom questions data from allCustomQuestions()
+ * @param courseConfig - The course configuration object
+ * @param courseDB - The course database interface
+ * @param username - The username to attribute seed data to
+ */
+declare function registerCustomQuestionTypes(customQuestions: CustomQuestionsData, courseConfig: CourseConfig, courseDB: CourseDBInterface, username?: string): Promise<{
+    success: boolean;
+    registeredCount: number;
+    errorMessage?: string;
+}>;
+
 declare const NOT_SET: "NOT_SET";
 interface DBEnv {
     COUCHDB_SERVER_URL: string;
@@ -585,4 +698,4 @@ interface CouchDbUserDoc extends PouchDB.Authentication.User {
     entitlements: UserEntitlements;
 }
 
-export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseLookup, CourseRegistrationDoc, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, QuotaRoundRobinMixer, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SourceBatch, type SourceMixer, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, validateMigration, validateStaticCourse };
+export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseDBInterface, CourseLookup, CourseRegistrationDoc, type CustomQuestionsData, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, type ProcessedDataShape, type ProcessedQuestionData, QuotaRoundRobinMixer, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SourceBatch, type SourceMixer, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, isDataShapeRegistered, isDataShapeSchemaAvailable, isQuestionTypeRegistered, processCustomQuestionsData, registerBlanksCard, registerCustomQuestionTypes, registerDataShape, registerQuestionType, registerSeedData, validateMigration, validateStaticCourse };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, h as StudyContentSource } from './contentSource-BP9hznNV.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, f as ContentNavigator, q as ContentSourceID, C as CourseDBInterface, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, j as ScheduledCard, H as SessionTrackingData, L as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, 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, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './contentSource-BP9hznNV.js';
+import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, h as StudyContentSource, C as CourseDBInterface } from './contentSource-BP9hznNV.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, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, j as ScheduledCard, H as SessionTrackingData, L as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, 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, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './contentSource-BP9hznNV.js';
 import { D as DataLayerProvider } from './dataLayerProvider-MDTxXq2l.js';
 import { C as CardHistory, c as CardRecord } from './types-legacy-DDY4N-Uq.js';
 export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, i as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-DDY4N-Uq.js';
 import { Loggable } from './core/index.js';
 export { BulkCardProcessorConfig, CardFilter, CardFilterFactory, CardGenerator, CardGeneratorFactory, FilterContext, GeneratorContext, ImportResult, StrategyStateDoc, StrategyStateId, areQuestionRecords, buildStrategyStateId, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.js';
-import { TagFilter } from '@vue-skuilder/common';
+import { TagFilter, DataShape, CourseConfig } from '@vue-skuilder/common';
 import { S as StaticCourseManifest } from './types-DQaXnuoc.js';
 export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-DQaXnuoc.js';
 import { F as FileSystemAdapter } from './index-Dj0SEgk3.js';
@@ -529,6 +529,119 @@ declare class CourseLookup {
     static isCourse(courseID: string): Promise<boolean>;
 }
 
+/**
+ * Interface for custom questions data structure returned by allCustomQuestions()
+ */
+interface CustomQuestionsData {
+    courses: {
+        name: string;
+    }[];
+    questionClasses: {
+        name: string;
+        dataShapes?: DataShape[];
+        views?: {
+            name?: string;
+        }[];
+        seedData?: unknown[];
+    }[];
+    dataShapes: DataShape[];
+    views: {
+        name?: string;
+    }[];
+    meta: {
+        questionCount: number;
+        dataShapeCount: number;
+        viewCount: number;
+        courseCount: number;
+        packageName: string;
+        sourceDirectory: string;
+    };
+}
+/**
+ * Interface for processed question data for registration
+ */
+interface ProcessedQuestionData {
+    name: string;
+    course: string;
+    questionClass: {
+        name: string;
+        dataShapes?: DataShape[];
+        views?: {
+            name?: string;
+        }[];
+        seedData?: unknown[];
+    };
+    dataShapes: DataShape[];
+    views: {
+        name?: string;
+    }[];
+}
+/**
+ * Interface for processed data shape for registration
+ */
+interface ProcessedDataShape {
+    name: string;
+    course: string;
+    dataShape: DataShape;
+}
+/**
+ * Check if a data shape is already registered in the course config with valid schema
+ */
+declare function isDataShapeRegistered(dataShape: ProcessedDataShape, courseConfig: CourseConfig): boolean;
+declare function isDataShapeSchemaAvailable(dataShape: ProcessedDataShape, courseConfig: CourseConfig): boolean;
+/**
+ * Check if a question type is already registered in the course config
+ */
+declare function isQuestionTypeRegistered(question: ProcessedQuestionData, courseConfig: CourseConfig): boolean;
+/**
+ * Process custom questions data into registration-ready format
+ */
+declare function processCustomQuestionsData(customQuestions: CustomQuestionsData): {
+    dataShapes: ProcessedDataShape[];
+    questions: ProcessedQuestionData[];
+};
+/**
+ * Register a data shape in the course config
+ */
+declare function registerDataShape(dataShape: ProcessedDataShape, courseConfig: CourseConfig): boolean;
+/**
+ * Register a question type in the course config
+ */
+declare function registerQuestionType(question: ProcessedQuestionData, courseConfig: CourseConfig): boolean;
+/**
+ * Register seed data for a question type
+ *
+ * @param question - The processed question data
+ * @param courseDB - The course database interface
+ * @param username - The username to attribute seed data to
+ */
+declare function registerSeedData(question: ProcessedQuestionData, courseDB: CourseDBInterface, username: string): Promise<void>;
+/**
+ * Register BlanksCard (markdown fillIn) question type specifically
+ */
+declare function registerBlanksCard(BlanksCard: {
+    name: string;
+    views?: {
+        name?: string;
+    }[];
+}, BlanksCardDataShapes: DataShape[], courseConfig: CourseConfig, courseDB: CourseDBInterface, username?: string): Promise<{
+    success: boolean;
+    errorMessage?: string;
+}>;
+/**
+ * Main function to register all custom question types and data shapes
+ *
+ * @param customQuestions - The custom questions data from allCustomQuestions()
+ * @param courseConfig - The course configuration object
+ * @param courseDB - The course database interface
+ * @param username - The username to attribute seed data to
+ */
+declare function registerCustomQuestionTypes(customQuestions: CustomQuestionsData, courseConfig: CourseConfig, courseDB: CourseDBInterface, username?: string): Promise<{
+    success: boolean;
+    registeredCount: number;
+    errorMessage?: string;
+}>;
+
 declare const NOT_SET: "NOT_SET";
 interface DBEnv {
     COUCHDB_SERVER_URL: string;
@@ -585,4 +698,4 @@ interface CouchDbUserDoc extends PouchDB.Authentication.User {
     entitlements: UserEntitlements;
 }
 
-export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseLookup, CourseRegistrationDoc, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, QuotaRoundRobinMixer, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SourceBatch, type SourceMixer, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, validateMigration, validateStaticCourse };
+export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseDBInterface, CourseLookup, CourseRegistrationDoc, type CustomQuestionsData, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, type ProcessedDataShape, type ProcessedQuestionData, QuotaRoundRobinMixer, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SourceBatch, type SourceMixer, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, isDataShapeRegistered, isDataShapeSchemaAvailable, isQuestionTypeRegistered, processCustomQuestionsData, registerBlanksCard, registerCustomQuestionTypes, registerDataShape, registerQuestionType, registerSeedData, validateMigration, validateStaticCourse };

package/dist/index.js

@@ -5758,13 +5758,22 @@ __export(index_exports, {
   importParsedCards: () => importParsedCards,
   initializeDataDirectory: () => initializeDataDirectory,
   initializeDataLayer: () => initializeDataLayer,
+  isDataShapeRegistered: () => isDataShapeRegistered,
+  isDataShapeSchemaAvailable: () => isDataShapeSchemaAvailable,
   isFilter: () => isFilter,
   isGenerator: () => isGenerator,
   isQuestionRecord: () => isQuestionRecord,
+  isQuestionTypeRegistered: () => isQuestionTypeRegistered,
   isReview: () => isReview,
   log: () => log,
   newInterval: () => newInterval,
   parseCardHistoryID: () => parseCardHistoryID,
+  processCustomQuestionsData: () => processCustomQuestionsData,
+  registerBlanksCard: () => registerBlanksCard,
+  registerCustomQuestionTypes: () => registerCustomQuestionTypes,
+  registerDataShape: () => registerDataShape,
+  registerQuestionType: () => registerQuestionType,
+  registerSeedData: () => registerSeedData,
   validateMigration: () => validateMigration,
   validateProcessorConfig: () => validateProcessorConfig,
   validateStaticCourse: () => validateStaticCourse
@@ -5773,6 +5782,251 @@ module.exports = __toCommonJS(index_exports);
 init_core();
 init_courseLookupDB();
 
+// src/courseConfigRegistration.ts
+var import_common19 = require("@vue-skuilder/common");
+init_logger();
+function isDataShapeRegistered(dataShape, courseConfig) {
+  const namespacedName = import_common19.NameSpacer.getDataShapeString({
+    dataShape: dataShape.name,
+    course: dataShape.course
+  });
+  const existingDataShape = courseConfig.dataShapes.find((ds) => ds.name === namespacedName);
+  return existingDataShape !== void 0;
+}
+function isDataShapeSchemaAvailable(dataShape, courseConfig) {
+  const namespacedName = import_common19.NameSpacer.getDataShapeString({
+    dataShape: dataShape.name,
+    course: dataShape.course
+  });
+  const existingDataShape = courseConfig.dataShapes.find((ds) => ds.name === namespacedName);
+  return existingDataShape !== void 0 && existingDataShape.serializedZodSchema !== void 0;
+}
+function isQuestionTypeRegistered(question, courseConfig) {
+  const namespacedName = import_common19.NameSpacer.getQuestionString({
+    course: question.course,
+    questionType: question.name
+  });
+  return courseConfig.questionTypes.some((qt) => qt.name === namespacedName);
+}
+function processCustomQuestionsData(customQuestions) {
+  const processedDataShapes = [];
+  const processedQuestions = [];
+  const courseNames = customQuestions.courses.map((course) => course.name);
+  customQuestions.questionClasses.forEach((questionClass) => {
+    const courseName = courseNames.length > 0 ? courseNames[0] : customQuestions.meta.packageName;
+    if (questionClass.dataShapes && Array.isArray(questionClass.dataShapes)) {
+      questionClass.dataShapes.forEach((dataShape) => {
+        processedDataShapes.push({
+          name: dataShape.name,
+          course: courseName,
+          dataShape
+        });
+      });
+    }
+    processedQuestions.push({
+      name: questionClass.name,
+      course: courseName,
+      questionClass,
+      dataShapes: questionClass.dataShapes || [],
+      views: questionClass.views || []
+    });
+  });
+  return { dataShapes: processedDataShapes, questions: processedQuestions };
+}
+function registerDataShape(dataShape, courseConfig) {
+  const namespacedName = import_common19.NameSpacer.getDataShapeString({
+    dataShape: dataShape.name,
+    course: dataShape.course
+  });
+  let serializedZodSchema;
+  try {
+    serializedZodSchema = (0, import_common19.toZodJSON)(dataShape.dataShape);
+  } catch (error) {
+    logger.warn(`Failed to generate schema for ${namespacedName}:`, error);
+    serializedZodSchema = void 0;
+  }
+  const existingIndex = courseConfig.dataShapes.findIndex((ds) => ds.name === namespacedName);
+  if (existingIndex !== -1) {
+    const existingDataShape = courseConfig.dataShapes[existingIndex];
+    if (existingDataShape.serializedZodSchema === serializedZodSchema) {
+      logger.info(
+        `DataShape '${dataShape.name}' from '${dataShape.course}' already registered with identical schema`
+      );
+      return false;
+    }
+    if (existingDataShape.serializedZodSchema) {
+      logger.info(
+        `DataShape '${dataShape.name}' from '${dataShape.course}' schema has changed, updating...`
+      );
+    } else {
+      logger.info(
+        `DataShape '${dataShape.name}' from '${dataShape.course}' already registered, but with no schema. Adding schema to existing entry`
+      );
+    }
+    courseConfig.dataShapes[existingIndex] = {
+      name: namespacedName,
+      questionTypes: existingDataShape.questionTypes,
+      // Preserve existing question type associations
+      serializedZodSchema
+    };
+    logger.info(`Updated DataShape: ${namespacedName}`);
+    return true;
+  }
+  courseConfig.dataShapes.push({
+    name: namespacedName,
+    questionTypes: [],
+    serializedZodSchema
+  });
+  logger.info(`Registered DataShape: ${namespacedName}`);
+  return true;
+}
+function registerQuestionType(question, courseConfig) {
+  if (isQuestionTypeRegistered(question, courseConfig)) {
+    logger.info(`QuestionType '${question.name}' from '${question.course}' already registered`);
+    return false;
+  }
+  const namespacedQuestionName = import_common19.NameSpacer.getQuestionString({
+    course: question.course,
+    questionType: question.name
+  });
+  const viewList = question.views.map((view) => {
+    if (view.name) {
+      return view.name;
+    } else {
+      return "unnamedComponent";
+    }
+  });
+  const dataShapeList = question.dataShapes.map(
+    (dataShape) => import_common19.NameSpacer.getDataShapeString({
+      course: question.course,
+      dataShape: dataShape.name
+    })
+  );
+  courseConfig.questionTypes.push({
+    name: namespacedQuestionName,
+    viewList,
+    dataShapeList
+  });
+  question.dataShapes.forEach((dataShape) => {
+    const namespacedDataShapeName = import_common19.NameSpacer.getDataShapeString({
+      course: question.course,
+      dataShape: dataShape.name
+    });
+    for (const ds of courseConfig.dataShapes) {
+      if (ds.name === namespacedDataShapeName) {
+        ds.questionTypes.push(namespacedQuestionName);
+      }
+    }
+  });
+  logger.info(`Registered QuestionType: ${namespacedQuestionName}`);
+  return true;
+}
+async function registerSeedData(question, courseDB, username) {
+  if (question.questionClass.seedData && Array.isArray(question.questionClass.seedData)) {
+    logger.info(`Registering seed data for question: ${question.name}`);
+    try {
+      const seedDataPromises = question.questionClass.seedData.filter(() => question.dataShapes.length > 0).map(
+        (seedDataItem) => courseDB.addNote(
+          question.course,
+          question.dataShapes[0],
+          seedDataItem,
+          username,
+          []
+        )
+      );
+      await Promise.all(seedDataPromises);
+      logger.info(`Seed data registered for question: ${question.name}`);
+    } catch (error) {
+      logger.warn(
+        `Failed to register seed data for question '${question.name}': ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+}
+async function registerBlanksCard(BlanksCard, BlanksCardDataShapes, courseConfig, courseDB, username) {
+  try {
+    logger.info("Registering BlanksCard data shapes and question type...");
+    let registeredCount = 0;
+    const courseName = "default";
+    for (const dataShapeClass of BlanksCardDataShapes) {
+      const processedDataShape = {
+        name: dataShapeClass.name,
+        course: courseName,
+        dataShape: dataShapeClass
+      };
+      if (registerDataShape(processedDataShape, courseConfig)) {
+        registeredCount++;
+      }
+    }
+    const processedQuestion = {
+      name: BlanksCard.name,
+      course: courseName,
+      questionClass: {
+        name: BlanksCard.name,
+        dataShapes: BlanksCardDataShapes,
+        views: BlanksCard.views || []
+      },
+      dataShapes: BlanksCardDataShapes,
+      views: BlanksCard.views || []
+    };
+    if (registerQuestionType(processedQuestion, courseConfig)) {
+      registeredCount++;
+    }
+    logger.info("Updating course configuration with BlanksCard...");
+    const updateResult = await courseDB.updateCourseConfig(courseConfig);
+    if (!updateResult.ok) {
+      throw new Error(`Failed to update course config: ${JSON.stringify(updateResult)}`);
+    }
+    if (username) {
+      await registerSeedData(processedQuestion, courseDB, username);
+    }
+    logger.info(`BlanksCard registration complete: ${registeredCount} items registered`);
+    return { success: true };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    logger.error(`BlanksCard registration failed: ${errorMessage}`);
+    return { success: false, errorMessage };
+  }
+}
+async function registerCustomQuestionTypes(customQuestions, courseConfig, courseDB, username) {
+  try {
+    logger.info("Beginning custom question registration");
+    logger.info(`Processing ${customQuestions.questionClasses.length} question classes`);
+    const { dataShapes, questions } = processCustomQuestionsData(customQuestions);
+    logger.info(`Found ${dataShapes.length} data shapes and ${questions.length} questions`);
+    let registeredCount = 0;
+    logger.info("Registering data shapes...");
+    for (const dataShape of dataShapes) {
+      if (registerDataShape(dataShape, courseConfig)) {
+        registeredCount++;
+      }
+    }
+    logger.info("Registering question types...");
+    for (const question of questions) {
+      if (registerQuestionType(question, courseConfig)) {
+        registeredCount++;
+      }
+    }
+    logger.info("Updating course configuration...");
+    const updateResult = await courseDB.updateCourseConfig(courseConfig);
+    if (!updateResult.ok) {
+      throw new Error(`Failed to update course config: ${JSON.stringify(updateResult)}`);
+    }
+    if (username) {
+      logger.info("Registering seed data...");
+      for (const question of questions) {
+        await registerSeedData(question, courseDB, username);
+      }
+    }
+    logger.info(`Custom question registration complete: ${registeredCount} items registered`);
+    return { success: true, registeredCount };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    logger.error(`Custom question registration failed: ${errorMessage}`);
+    return { success: false, registeredCount: 0, errorMessage };
+  }
+}
+
 // src/study/services/SrsService.ts
 var import_moment8 = __toESM(require("moment"), 1);
 init_couch();
@@ -5883,7 +6137,7 @@ var SrsService = class {
 };
 
 // src/study/services/EloService.ts
-var import_common19 = require("@vue-skuilder/common");
+var import_common20 = require("@vue-skuilder/common");
 init_logger();
 var EloService = class {
   dataLayer;
@@ -5906,10 +6160,10 @@ var EloService = class {
       logger.warn(`k value interpretation not currently implemented`);
     }
     const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
-    const userElo = (0, import_common19.toCourseElo)(userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo);
+    const userElo = (0, import_common20.toCourseElo)(userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo);
     const cardElo = (await courseDB.getCardEloData([currentCard.card.card_id]))[0];
     if (cardElo && userElo) {
-      const eloUpdate = (0, import_common19.adjustCourseScores)(userElo, cardElo, userScore);
+      const eloUpdate = (0, import_common20.adjustCourseScores)(userElo, cardElo, userScore);
       userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo = eloUpdate.userElo;
       const results = await Promise.allSettled([
         this.user.updateUserElo(course_id, eloUpdate.userElo),
@@ -6111,7 +6365,7 @@ var ResponseProcessor = class {
 };
 
 // src/study/services/CardHydrationService.ts
-var import_common20 = require("@vue-skuilder/common");
+var import_common21 = require("@vue-skuilder/common");
 init_logger();
 function parseAudioURIs(data) {
   if (typeof data !== "string") return [];
@@ -6246,8 +6500,8 @@ var CardHydrationService = class {
     try {
       const courseDB = this.getCourseDB(item.courseID);
       const cardData = await courseDB.getCourseDoc(item.cardID);
-      if (!(0, import_common20.isCourseElo)(cardData.elo)) {
-        cardData.elo = (0, import_common20.toCourseElo)(cardData.elo);
+      if (!(0, import_common21.isCourseElo)(cardData.elo)) {
+        cardData.elo = (0, import_common21.toCourseElo)(cardData.elo);
       }
       const view = this.getViewComponent(cardData.id_view);
       const dataDocs = await Promise.all(
@@ -6271,7 +6525,7 @@ var CardHydrationService = class {
         );
         await Promise.allSettled(uniqueAudioUrls.map(prefetchAudio));
       }
-      const data = dataDocs.map(import_common20.displayableDataToViewData).reverse();
+      const data = dataDocs.map(import_common21.displayableDataToViewData).reverse();
       this.hydratedCards.set(item.cardID, {
         item,
         view,
@@ -8219,13 +8473,22 @@ init_factory();
   importParsedCards,
   initializeDataDirectory,
   initializeDataLayer,
+  isDataShapeRegistered,
+  isDataShapeSchemaAvailable,
   isFilter,
   isGenerator,
   isQuestionRecord,
+  isQuestionTypeRegistered,
   isReview,
   log,
   newInterval,
   parseCardHistoryID,
+  processCustomQuestionsData,
+  registerBlanksCard,
+  registerCustomQuestionTypes,
+  registerDataShape,
+  registerQuestionType,
+  registerSeedData,
   validateMigration,
   validateProcessorConfig,
   validateStaticCourse