@vue-skuilder/db 0.1.6 → 0.1.8-0

package/dist/index-CLL31bEy.d.ts

@@ -0,0 +1,137 @@
+import { P as PackerConfig, a as PackedCourseData, S as StaticCourseManifest } from './types-BefDGkKa.js';
+
+/**
+ * Abstraction for file system operations needed by the migrator.
+ * This allows dependency injection of file system operations,
+ * avoiding bundling issues with Node.js fs module.
+ */
+interface FileSystemAdapter {
+    /**
+     * Read a text file and return its contents as a string
+     */
+    readFile(filePath: string): Promise<string>;
+    /**
+     * Read a binary file and return its contents as a Buffer
+     */
+    readBinary(filePath: string): Promise<Buffer>;
+    /**
+     * Check if a file or directory exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Get file/directory statistics
+     */
+    stat(filePath: string): Promise<FileStats>;
+    /**
+     * Write text data to a file
+     */
+    writeFile(filePath: string, data: string | Buffer): Promise<void>;
+    /**
+     * Write JSON data to a file with formatting
+     */
+    writeJson(filePath: string, data: any, options?: {
+        spaces?: number;
+    }): Promise<void>;
+    /**
+     * Ensure a directory exists, creating it and parent directories if needed
+     */
+    ensureDir(dirPath: string): Promise<void>;
+    /**
+     * Join path segments into a complete path
+     */
+    joinPath(...segments: string[]): string;
+    /**
+     * Get the directory name of a path
+     */
+    dirname(filePath: string): string;
+    /**
+     * Check if a path is absolute
+     */
+    isAbsolute(filePath: string): boolean;
+}
+interface FileStats {
+    isDirectory(): boolean;
+    isFile(): boolean;
+    size: number;
+}
+/**
+ * Error thrown when file system operations fail
+ */
+declare class FileSystemError extends Error {
+    readonly operation: string;
+    readonly filePath: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, operation: string, filePath: string, cause?: Error | undefined);
+}
+
+declare class CouchDBToStaticPacker {
+    private config;
+    private sourceDB;
+    constructor(config?: Partial<PackerConfig>);
+    /**
+     * Pack a CouchDB course database into static data structures
+     */
+    packCourse(sourceDB: PouchDB.Database, courseId: string): Promise<PackedCourseData>;
+    /**
+     * Pack a CouchDB course database and write the static files to disk
+     */
+    packCourseToFiles(sourceDB: PouchDB.Database, courseId: string, outputDir: string, fsAdapter: FileSystemAdapter): Promise<{
+        manifest: StaticCourseManifest;
+        filesWritten: number;
+        attachmentsFound: number;
+    }>;
+    /**
+     * Write packed course data to files using FileSystemAdapter
+     */
+    private writePackedDataToFiles;
+    private extractCourseConfig;
+    private extractDesignDocs;
+    private extractDocumentsByType;
+    private createChunks;
+    private prepareChunkData;
+    private buildIndices;
+    private buildEloIndex;
+    private buildTagIndex;
+    /**
+     * Build view index by querying CouchDB views directly instead of parsing map functions
+     */
+    private buildViewIndex;
+    /**
+     * Format CouchDB view results for static consumption
+     */
+    private formatViewResults;
+    /**
+     * Format ELO view results - convert to sorted array format
+     */
+    private formatEloViewIndex;
+    /**
+     * Format tags view results - convert to tag mapping format
+     */
+    private formatTagsViewIndex;
+    /**
+     * Format inexperience view results - convert to experience-based format
+     */
+    private formatInexperienceViewIndex;
+    /**
+     * Format generic view results - fallback for unknown views
+     */
+    private formatGenericViewIndex;
+    /**
+     * Extract all attachments from documents and download binary data
+     */
+    private extractAllAttachments;
+    /**
+     * Extract attachments for a single document
+     */
+    private extractDocumentAttachments;
+    /**
+     * Transform attachment stubs to include file paths
+     */
+    private transformAttachmentStubs;
+    /**
+     * Get file extension from content type
+     */
+    private getFileExtension;
+}
+
+export { CouchDBToStaticPacker as C, type FileSystemAdapter as F, type FileStats as a, FileSystemError as b };

package/dist/index-CUNnL38E.d.mts

@@ -0,0 +1,137 @@
+import { P as PackerConfig, a as PackedCourseData, S as StaticCourseManifest } from './types-DC-ckZug.mjs';
+
+/**
+ * Abstraction for file system operations needed by the migrator.
+ * This allows dependency injection of file system operations,
+ * avoiding bundling issues with Node.js fs module.
+ */
+interface FileSystemAdapter {
+    /**
+     * Read a text file and return its contents as a string
+     */
+    readFile(filePath: string): Promise<string>;
+    /**
+     * Read a binary file and return its contents as a Buffer
+     */
+    readBinary(filePath: string): Promise<Buffer>;
+    /**
+     * Check if a file or directory exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Get file/directory statistics
+     */
+    stat(filePath: string): Promise<FileStats>;
+    /**
+     * Write text data to a file
+     */
+    writeFile(filePath: string, data: string | Buffer): Promise<void>;
+    /**
+     * Write JSON data to a file with formatting
+     */
+    writeJson(filePath: string, data: any, options?: {
+        spaces?: number;
+    }): Promise<void>;
+    /**
+     * Ensure a directory exists, creating it and parent directories if needed
+     */
+    ensureDir(dirPath: string): Promise<void>;
+    /**
+     * Join path segments into a complete path
+     */
+    joinPath(...segments: string[]): string;
+    /**
+     * Get the directory name of a path
+     */
+    dirname(filePath: string): string;
+    /**
+     * Check if a path is absolute
+     */
+    isAbsolute(filePath: string): boolean;
+}
+interface FileStats {
+    isDirectory(): boolean;
+    isFile(): boolean;
+    size: number;
+}
+/**
+ * Error thrown when file system operations fail
+ */
+declare class FileSystemError extends Error {
+    readonly operation: string;
+    readonly filePath: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, operation: string, filePath: string, cause?: Error | undefined);
+}
+
+declare class CouchDBToStaticPacker {
+    private config;
+    private sourceDB;
+    constructor(config?: Partial<PackerConfig>);
+    /**
+     * Pack a CouchDB course database into static data structures
+     */
+    packCourse(sourceDB: PouchDB.Database, courseId: string): Promise<PackedCourseData>;
+    /**
+     * Pack a CouchDB course database and write the static files to disk
+     */
+    packCourseToFiles(sourceDB: PouchDB.Database, courseId: string, outputDir: string, fsAdapter: FileSystemAdapter): Promise<{
+        manifest: StaticCourseManifest;
+        filesWritten: number;
+        attachmentsFound: number;
+    }>;
+    /**
+     * Write packed course data to files using FileSystemAdapter
+     */
+    private writePackedDataToFiles;
+    private extractCourseConfig;
+    private extractDesignDocs;
+    private extractDocumentsByType;
+    private createChunks;
+    private prepareChunkData;
+    private buildIndices;
+    private buildEloIndex;
+    private buildTagIndex;
+    /**
+     * Build view index by querying CouchDB views directly instead of parsing map functions
+     */
+    private buildViewIndex;
+    /**
+     * Format CouchDB view results for static consumption
+     */
+    private formatViewResults;
+    /**
+     * Format ELO view results - convert to sorted array format
+     */
+    private formatEloViewIndex;
+    /**
+     * Format tags view results - convert to tag mapping format
+     */
+    private formatTagsViewIndex;
+    /**
+     * Format inexperience view results - convert to experience-based format
+     */
+    private formatInexperienceViewIndex;
+    /**
+     * Format generic view results - fallback for unknown views
+     */
+    private formatGenericViewIndex;
+    /**
+     * Extract all attachments from documents and download binary data
+     */
+    private extractAllAttachments;
+    /**
+     * Extract attachments for a single document
+     */
+    private extractDocumentAttachments;
+    /**
+     * Transform attachment stubs to include file paths
+     */
+    private transformAttachmentStubs;
+    /**
+     * Get file extension from content type
+     */
+    private getFileExtension;
+}
+
+export { CouchDBToStaticPacker as C, type FileSystemAdapter as F, type FileStats as a, FileSystemError as b };

package/dist/index.d.mts

@@ -1,16 +1,199 @@
-import { S as StudySessionItem, c as StudyContentSource } from './userDB-31gsvxyd.mjs';
-export { y as ActivityRecord, A as AdminDBInterface, h as AssignedCard, e as AssignedContent, g as AssignedCourse, f as AssignedTag, b as ClassroomDBInterface, v as ClassroomRegistration, u as ClassroomRegistrationDesignation, w as ClassroomRegistrationDoc, o as ContentSourceID, C as CourseDBInterface, q as CourseInfo, z as CourseRegistration, B as CourseRegistrationDoc, a as CoursesDBInterface, E as DocumentUpdater, D as ScheduledCard, d as StudentClassroomDBInterface, i as StudySessionFailedItem, j as StudySessionFailedNewItem, k as StudySessionFailedReviewItem, l as StudySessionNewItem, m as StudySessionReviewItem, T as TeacherClassroomDBInterface, x as UserConfig, s as UserCourseSetting, r as UserCourseSettings, U as UserDBInterface, t as UsrCrsDataInterface, p as getStudySource, n as isReview, F as newInterval } from './userDB-31gsvxyd.mjs';
-import { D as DataLayerProvider } from './dataLayerProvider-BZmLyBVw.mjs';
-import { C as CardRecord } from './types-legacy-WPe8CtO-.mjs';
-export { b as CardData, g as CardHistory, c as CourseListData, e as DataShapeData, d as DisplayableData, D as DocType, F as Field, G as GuestUsername, Q as QuestionData, h as QuestionRecord, S as SkuilderCourseData, T as Tag, a as TagStub, f as cardHistoryPrefix, l as log } from './types-legacy-WPe8CtO-.mjs';
+import { j as StudySessionItem, h as StudyContentSource } from './userDB-C33Hzjgn.mjs';
+export { B as ActivityRecord, A as AdminDBInterface, s as AssignedCard, g as AssignedContent, r as AssignedCourse, q as AssignedTag, b as ClassroomDBInterface, x as ClassroomRegistration, w as ClassroomRegistrationDesignation, y as ClassroomRegistrationDoc, o as ContentSourceID, C as CourseDBInterface, c as CourseInfo, E as CourseRegistration, F as CourseRegistrationDoc, a as CoursesDBInterface, G as DocumentUpdater, f as ScheduledCard, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, S as StudySessionNewItem, e as StudySessionReviewItem, T as TeacherClassroomDBInterface, z as UserConfig, u as UserCourseSetting, t as UserCourseSettings, U as UserDBInterface, v as UsrCrsDataInterface, p as getStudySource, n as isReview, H as newInterval } from './userDB-C33Hzjgn.mjs';
+import { D as DataLayerProvider } from './dataLayerProvider-BInqI_RF.mjs';
+import { C as CardRecord } from './types-legacy-Birv-Jx6.mjs';
+export { b as CardData, g as CardHistory, c as CourseListData, e as DataShapeData, d as DisplayableData, D as DocType, f as DocTypePrefixes, F as Field, G as GuestUsername, Q as QuestionData, h as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-Birv-Jx6.mjs';
 import { Loggable } from './core/index.mjs';
 export { BulkCardProcessorConfig, ContentNavigator, ImportResult, Navigators, areQuestionRecords, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.mjs';
-import { S as StaticCourseManifest } from './types-DPRvCrIk.mjs';
-export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-DPRvCrIk.mjs';
-export { CouchDBToStaticPacker } from './util/packer/index.mjs';
+import { S as StaticCourseManifest } from './types-DC-ckZug.mjs';
+export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-DC-ckZug.mjs';
+import { F as FileSystemAdapter } from './index-CUNnL38E.mjs';
+export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-CUNnL38E.mjs';
 import '@vue-skuilder/common';
 import 'moment';
 
+interface MigrationOptions {
+    chunkBatchSize: number;
+    validateRoundTrip: boolean;
+    cleanupOnFailure: boolean;
+    timeout: number;
+}
+interface MigrationResult {
+    success: boolean;
+    documentsRestored: number;
+    attachmentsRestored: number;
+    designDocsRestored: number;
+    courseConfigRestored: number;
+    errors: string[];
+    warnings: string[];
+    migrationTime: number;
+    tempDatabaseName?: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    documentCountMatch: boolean;
+    attachmentIntegrity: boolean;
+    viewFunctionality: boolean;
+    issues: ValidationIssue[];
+}
+interface ValidationIssue {
+    type: 'error' | 'warning';
+    category: 'documents' | 'attachments' | 'views' | 'metadata' | 'course_config';
+    message: string;
+    details?: any;
+}
+interface DocumentCounts {
+    [docType: string]: number;
+}
+interface RestoreProgress {
+    phase: 'manifest' | 'design_docs' | 'course_config' | 'documents' | 'attachments' | 'validation';
+    current: number;
+    total: number;
+    message: string;
+}
+interface StaticCourseValidation {
+    valid: boolean;
+    manifestExists: boolean;
+    chunksExist: boolean;
+    attachmentsExist: boolean;
+    errors: string[];
+    warnings: string[];
+    courseId?: string;
+    courseName?: string;
+}
+interface AggregatedDocument {
+    _id: string;
+    _attachments?: Record<string, any>;
+    docType: string;
+    [key: string]: any;
+}
+interface AttachmentUploadResult {
+    success: boolean;
+    attachmentName: string;
+    docId: string;
+    error?: string;
+}
+declare const DEFAULT_MIGRATION_OPTIONS: MigrationOptions;
+
+declare class StaticToCouchDBMigrator {
+    private options;
+    private progressCallback?;
+    private fs?;
+    constructor(options?: Partial<MigrationOptions>, fileSystemAdapter?: FileSystemAdapter);
+    /**
+     * Set a progress callback to receive updates during migration
+     */
+    setProgressCallback(callback: (progress: RestoreProgress) => void): void;
+    /**
+     * Migrate a static course to CouchDB
+     */
+    migrateCourse(staticPath: string, targetDB: PouchDB.Database): Promise<MigrationResult>;
+    /**
+     * Load and parse the manifest file
+     */
+    private loadManifest;
+    /**
+     * Restore design documents to CouchDB
+     */
+    private restoreDesignDocuments;
+    /**
+     * Aggregate documents from all chunks
+     */
+    private aggregateDocuments;
+    /**
+     * Load documents from a single chunk file
+     */
+    private loadChunk;
+    /**
+     * Upload documents to CouchDB in batches
+     */
+    private uploadDocuments;
+    /**
+     * Upload attachments from filesystem to CouchDB
+     */
+    private uploadAttachments;
+    /**
+     * Upload a single attachment file
+     */
+    private uploadSingleAttachment;
+    /**
+     * Restore CourseConfig document from manifest
+     */
+    private restoreCourseConfig;
+    /**
+     * Calculate expected document counts from manifest
+     */
+    private calculateExpectedCounts;
+    /**
+     * Clean up database after failed migration
+     */
+    private cleanupFailedMigration;
+    /**
+     * Report progress to callback if available
+     */
+    private reportProgress;
+    /**
+     * Check if a path is a local file path (vs URL)
+     */
+    private isLocalPath;
+}
+
+/**
+ * Validate that a static course directory contains all required files
+ */
+declare function validateStaticCourse(staticPath: string, fs?: FileSystemAdapter): Promise<StaticCourseValidation>;
+/**
+ * Validate the result of a migration by checking document counts and integrity
+ */
+declare function validateMigration(targetDB: PouchDB.Database, expectedCounts: DocumentCounts, manifest: StaticCourseManifest): Promise<ValidationResult>;
+
+/**
+ * Get the application data directory for the current platform
+ * Uses ~/.tuilder as requested by user for simplicity
+ */
+declare function getAppDataDirectory(): string;
+/**
+ * Ensure the application data directory exists
+ * Creates directory recursively if it doesn't exist
+ */
+declare function ensureAppDataDirectory(): Promise<string>;
+/**
+ * Get the full path for a PouchDB database file
+ * @param dbName - The database name (e.g., 'userdb-Colin')
+ */
+declare function getDbPath(dbName: string): string;
+/**
+ * Initialize data directory for PouchDB usage
+ * Should be called once at application startup
+ */
+declare function initializeDataDirectory(): Promise<void>;
+
+/**
+ * Initialize TUI logging - redirect console logs to file in Node.js
+ */
+declare function initializeTuiLogging(): void;
+/**
+ * Get the current log file path (for debugging)
+ */
+declare function getLogFilePath(): string | null;
+/**
+ * Show user-facing message (always visible in TUI)
+ */
+declare function showUserMessage(message: string): void;
+/**
+ * Show user-facing error (always visible in TUI)
+ */
+declare function showUserError(message: string): void;
+/**
+ * Logger object with standard log levels
+ */
+declare const logger: {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+};
+
 interface StudySessionRecord {
     card: {
         course_id: string;
@@ -95,6 +278,14 @@ declare class CourseLookup {
      * @returns
      */
     static add(courseName: string): Promise<string>;
+    /**
+     * Adds a new course to the lookup database with a specific courseID
+     * @param courseId The specific course ID to use
+     * @param courseName The course name
+     * @param disambiguator Optional disambiguator
+     * @returns Promise<void>
+     */
+    static addWithId(courseId: string, courseName: string, disambiguator?: string): Promise<void>;
     /**
      * Removes a course from the index
      * @param courseID
@@ -139,4 +330,4 @@ declare function getDataLayer(): DataLayerProvider;
  */
 declare function _resetDataLayer(): Promise<void>;
 
-export { CardRecord, CourseLookup, type DataLayerConfig, DataLayerProvider, ENV, Loggable, SessionController, StaticCourseManifest, StudyContentSource, StudySessionItem, type StudySessionRecord, _resetDataLayer, getDataLayer, initializeDataLayer };
+export { type AggregatedDocument, type AttachmentUploadResult, CardRecord, CourseLookup, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, type RestoreProgress, SessionController, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, type ValidationIssue, type ValidationResult, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, getLogFilePath, initializeDataDirectory, initializeDataLayer, initializeTuiLogging, logger, showUserError, showUserMessage, validateMigration, validateStaticCourse };