@vue-skuilder/db 0.1.6 → 0.1.8-0

package/dist/util/packer/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/util/logger.ts","../../../src/util/packer/CouchDBToStaticPacker.ts"],"sourcesContent":["/**\n * Simple logging utility for @vue-skuilder/db package\n *\n * This utility provides environment-aware logging with ESLint suppressions\n * to resolve console statement violations while maintaining logging functionality.\n */\n\nconst isDevelopment = typeof process !== 'undefined' && process.env.NODE_ENV === 'development';\nconst _isBrowser = typeof window !== 'undefined';\n\nexport const logger = {\n  /**\n   * Debug-level logging - only shown in development\n   */\n  debug: (message: string, ...args: any[]): void => {\n    if (isDevelopment) {\n      // eslint-disable-next-line no-console\n      console.debug(`[DB:DEBUG] ${message}`, ...args);\n    }\n  },\n\n  /**\n   * Info-level logging - general information\n   */\n  info: (message: string, ...args: any[]): void => {\n    // eslint-disable-next-line no-console\n    console.info(`[DB:INFO] ${message}`, ...args);\n  },\n\n  /**\n   * Warning-level logging - potential issues\n   */\n  warn: (message: string, ...args: any[]): void => {\n    // eslint-disable-next-line no-console\n    console.warn(`[DB:WARN] ${message}`, ...args);\n  },\n\n  /**\n   * Error-level logging - serious problems\n   */\n  error: (message: string, ...args: any[]): void => {\n    // eslint-disable-next-line no-console\n    console.error(`[DB:ERROR] ${message}`, ...args);\n  },\n\n  /**\n   * Log function for backward compatibility with existing log() usage\n   */\n  log: (message: string, ...args: any[]): void => {\n    if (isDevelopment) {\n      // eslint-disable-next-line no-console\n      console.log(`[DB:LOG] ${message}`, ...args);\n    }\n  },\n};\n","// packages/db/src/util/packer/CouchDBToStaticPacker.ts\n\nimport { CardData, DocType, Tag } from '../../core/types/types-legacy';\nimport { logger } from '../logger';\n// CourseConfig interface - simplified for packer use\n\nimport { CourseConfig } from '@vue-skuilder/common';\nimport {\n  ChunkMetadata,\n  DesignDocument,\n  IndexMetadata,\n  PackedCourseData,\n  PackerConfig,\n  StaticCourseManifest,\n  AttachmentData,\n} from './types';\n\nexport class CouchDBToStaticPacker {\n  private config: PackerConfig;\n  private sourceDB: PouchDB.Database | null = null;\n\n  constructor(config: Partial<PackerConfig> = {}) {\n    this.config = {\n      chunkSize: 1000,\n      includeAttachments: true,\n      ...config,\n    };\n  }\n\n  /**\n   * Pack a CouchDB course database into static data structures\n   */\n  async packCourse(sourceDB: PouchDB.Database, courseId: string): Promise<PackedCourseData> {\n    logger.info(`Starting static pack for course: ${courseId}`);\n    this.sourceDB = sourceDB;\n\n    const manifest: StaticCourseManifest = {\n      version: '1.0.0',\n      courseId,\n      courseName: '',\n      courseConfig: null,\n      lastUpdated: new Date().toISOString(),\n      documentCount: 0,\n      chunks: [],\n      indices: [],\n      designDocs: [],\n    };\n\n    // 1. Extract course config\n    const courseConfig = await this.extractCourseConfig(sourceDB);\n    manifest.courseName = courseConfig.name;\n    manifest.courseConfig = courseConfig;\n\n    // 2. Extract and process design documents\n    manifest.designDocs = await this.extractDesignDocs(sourceDB);\n\n    // 3. Extract all documents by type and create chunks\n    const docsByType = await this.extractDocumentsByType(sourceDB);\n\n    // 4. Extract attachments if enabled\n    const attachments = new Map<string, AttachmentData>();\n    if (this.config.includeAttachments) {\n      await this.extractAllAttachments(docsByType, attachments);\n    }\n\n    // 5. Create chunks and prepare chunk data\n    const chunks = new Map<string, any[]>();\n    for (const [docType, docs] of Object.entries(docsByType)) {\n      const chunkMetadata = this.createChunks(docs, docType as DocType);\n      manifest.chunks.push(...chunkMetadata);\n      manifest.documentCount += docs.length;\n\n      // Prepare chunk data\n      this.prepareChunkData(chunkMetadata, docs, chunks);\n    }\n\n    // 6. Build indices\n    const indices = new Map<string, any>();\n    manifest.indices = await this.buildIndices(docsByType, manifest.designDocs, indices);\n\n    return {\n      manifest,\n      chunks,\n      indices,\n      attachments,\n    };\n  }\n\n  private async extractCourseConfig(db: PouchDB.Database): Promise<CourseConfig> {\n    try {\n      return await db.get<CourseConfig>('CourseConfig');\n    } catch (error) {\n      logger.error('Failed to extract course config:', error);\n      throw new Error('Course config not found');\n    }\n  }\n\n  private async extractDesignDocs(db: PouchDB.Database): Promise<DesignDocument[]> {\n    const result = await db.allDocs({\n      startkey: '_design/',\n      endkey: '_design/\\ufff0',\n      include_docs: true,\n    });\n\n    return result.rows.map((row) => ({\n      _id: row.id,\n      views: (row.doc as any).views || {},\n    }));\n  }\n\n  private async extractDocumentsByType(db: PouchDB.Database): Promise<Record<DocType, any[]>> {\n    const allDocs = await db.allDocs({ include_docs: true });\n    const docsByType: Record<string, any[]> = {};\n\n    for (const row of allDocs.rows) {\n      if (row.id.startsWith('_')) continue; // Skip design docs\n\n      const doc = row.doc as any;\n      if (doc.docType) {\n        if (!docsByType[doc.docType]) {\n          docsByType[doc.docType] = [];\n        }\n        docsByType[doc.docType].push(doc);\n      }\n    }\n\n    return docsByType as Record<DocType, any[]>;\n  }\n\n  private createChunks(docs: any[], docType: DocType): ChunkMetadata[] {\n    const chunks: ChunkMetadata[] = [];\n    const sortedDocs = docs.sort((a, b) => a._id.localeCompare(b._id));\n\n    for (let i = 0; i < sortedDocs.length; i += this.config.chunkSize) {\n      const chunk = sortedDocs.slice(i, i + this.config.chunkSize);\n      const chunkId = `${docType}-${String(Math.floor(i / this.config.chunkSize)).padStart(4, '0')}`;\n\n      chunks.push({\n        id: chunkId,\n        docType,\n        startKey: chunk[0]._id,\n        endKey: chunk[chunk.length - 1]._id,\n        documentCount: chunk.length,\n        path: `chunks/${chunkId}.json`,\n      });\n    }\n\n    return chunks;\n  }\n\n  private prepareChunkData(\n    chunkMetadata: ChunkMetadata[],\n    docs: any[],\n    chunks: Map<string, any[]>\n  ): void {\n    const sortedDocs = docs.sort((a, b) => a._id.localeCompare(b._id));\n\n    for (const chunk of chunkMetadata) {\n      const chunkDocs = sortedDocs.filter(\n        (doc) => doc._id >= chunk.startKey && doc._id <= chunk.endKey\n      );\n\n      // Clean documents for storage\n      const cleanedDocs = chunkDocs.map((doc) => {\n        const cleaned = { ...doc };\n        delete cleaned._rev; // Remove revision info\n        \n        if (this.config.includeAttachments && cleaned._attachments) {\n          // Transform attachment stubs to file paths\n          cleaned._attachments = this.transformAttachmentStubs(cleaned._attachments, cleaned._id);\n        } else if (!this.config.includeAttachments) {\n          delete cleaned._attachments;\n        }\n        \n        return cleaned;\n      });\n\n      chunks.set(chunk.id, cleanedDocs);\n    }\n  }\n\n  private async buildIndices(\n    docsByType: Record<DocType, any[]>,\n    designDocs: DesignDocument[],\n    indices: Map<string, any>\n  ): Promise<IndexMetadata[]> {\n    const indexMetadata: IndexMetadata[] = [];\n\n    // Build ELO index\n    if (docsByType[DocType.CARD]) {\n      const eloIndexMeta = await this.buildEloIndex(\n        docsByType[DocType.CARD] as CardData[],\n        indices\n      );\n      indexMetadata.push(eloIndexMeta);\n    }\n\n    // Build tag indices\n    if (docsByType[DocType.TAG]) {\n      const tagIndexMeta = await this.buildTagIndex(docsByType[DocType.TAG] as Tag[], indices);\n      indexMetadata.push(tagIndexMeta);\n    }\n\n    // Build indices from design documents using CouchDB view queries\n    for (const designDoc of designDocs) {\n      for (const [viewName, viewDef] of Object.entries(designDoc.views)) {\n        if (viewDef.map) {\n          logger.info(`Processing view: ${designDoc._id}/${viewName}`);\n          const indexMeta = await this.buildViewIndex(viewName, designDoc, indices);\n          if (indexMeta) {\n            indexMetadata.push(indexMeta);\n            logger.info(`Successfully built index: ${indexMeta.name}`);\n          } else {\n            logger.warn(`Skipped view index: ${designDoc._id}/${viewName}`);\n          }\n        }\n      }\n    }\n\n    return indexMetadata;\n  }\n\n  private async buildEloIndex(\n    cards: CardData[],\n    indices: Map<string, any>\n  ): Promise<IndexMetadata> {\n    // Build a B-tree like structure for ELO queries\n    const eloIndex: Array<{ elo: number; cardId: string }> = [];\n\n    for (const card of cards) {\n      if (card.elo?.global?.score) {\n        eloIndex.push({\n          elo: card.elo.global.score,\n          cardId: (card as any)._id,\n        });\n      }\n    }\n\n    // Sort by ELO for efficient range queries\n    eloIndex.sort((a, b) => a.elo - b.elo);\n\n    // Create buckets for faster lookup\n    const buckets: Record<number, string[]> = {};\n    const bucketSize = 50; // ELO points per bucket\n\n    for (const entry of eloIndex) {\n      const bucket = Math.floor(entry.elo / bucketSize) * bucketSize;\n      if (!buckets[bucket]) buckets[bucket] = [];\n      buckets[bucket].push(entry.cardId);\n    }\n\n    // Store the index data\n    indices.set('elo', {\n      sorted: eloIndex,\n      buckets: buckets,\n      stats: {\n        min: eloIndex[0]?.elo || 0,\n        max: eloIndex[eloIndex.length - 1]?.elo || 0,\n        count: eloIndex.length,\n      },\n    });\n\n    return {\n      name: 'elo',\n      type: 'btree',\n      path: 'indices/elo.json',\n    };\n  }\n\n  private async buildTagIndex(tags: Tag[], indices: Map<string, any>): Promise<IndexMetadata> {\n    // Build inverted index for tags\n    const tagIndex: Record<\n      string,\n      {\n        cardIds: string[];\n        snippet: string;\n        count: number;\n      }\n    > = {};\n\n    for (const tag of tags) {\n      tagIndex[tag.name] = {\n        cardIds: tag.taggedCards,\n        snippet: tag.snippet,\n        count: tag.taggedCards.length,\n      };\n    }\n\n    // Also build a reverse index (card -> tags)\n    const cardToTags: Record<string, string[]> = {};\n    for (const tag of tags) {\n      for (const cardId of tag.taggedCards) {\n        if (!cardToTags[cardId]) cardToTags[cardId] = [];\n        cardToTags[cardId].push(tag.name);\n      }\n    }\n\n    indices.set('tags', {\n      byTag: tagIndex,\n      byCard: cardToTags,\n    });\n\n    return {\n      name: 'tags',\n      type: 'hash',\n      path: 'indices/tags.json',\n    };\n  }\n\n  /**\n   * Build view index by querying CouchDB views directly instead of parsing map functions\n   */\n  private async buildViewIndex(\n    viewName: string,\n    designDoc: DesignDocument,\n    indices: Map<string, any>\n  ): Promise<IndexMetadata | null> {\n    if (!this.sourceDB) {\n      logger.error('Source database not available for view querying');\n      return null;\n    }\n\n    try {\n      const designDocId = designDoc._id; // e.g., \"_design/elo\"\n      const viewPath = `${designDocId}/${viewName}`;\n      \n      logger.info(`Querying CouchDB view: ${viewPath}`);\n      \n      // Query the view directly from CouchDB\n      const viewResults = await this.sourceDB.query(viewPath, {\n        include_docs: false,\n      });\n\n      if (!viewResults.rows || viewResults.rows.length === 0) {\n        logger.warn(`View ${viewPath} returned no results`);\n        return null;\n      }\n\n      logger.info(`Successfully queried view ${viewPath}: ${viewResults.rows.length} results`);\n\n      // Format the results for static consumption\n      const formattedResults = this.formatViewResults(viewName, viewResults.rows, designDoc);\n      \n      const indexName = `view-${designDoc._id.replace('_design/', '')}-${viewName}`;\n      indices.set(indexName, formattedResults);\n\n      return {\n        name: indexName,\n        type: 'view',\n        path: `indices/${indexName}.json`,\n      };\n    } catch (error) {\n      logger.error(`Failed to query view ${designDoc._id}/${viewName}:`, error);\n      // Return null to gracefully skip this view rather than failing the entire pack\n      return null;\n    }\n  }\n\n  /**\n   * Format CouchDB view results for static consumption\n   */\n  private formatViewResults(\n    viewName: string,\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    designDoc: DesignDocument\n  ): any {\n    const baseResult = {\n      type: 'couchdb-view',\n      viewName,\n      designDoc: designDoc._id,\n      results: viewRows,\n      metadata: {\n        resultCount: viewRows.length,\n        generatedAt: new Date().toISOString(),\n      },\n    };\n\n    // Apply view-specific formatting\n    switch (viewName) {\n      case 'elo':\n        return this.formatEloViewIndex(viewRows, baseResult);\n      case 'getTags':\n        return this.formatTagsViewIndex(viewRows, baseResult);\n      case 'cardsByInexperience':\n        return this.formatInexperienceViewIndex(viewRows, baseResult);\n      default:\n        return this.formatGenericViewIndex(viewRows, baseResult);\n    }\n  }\n\n  /**\n   * Format ELO view results - convert to sorted array format\n   */\n  private formatEloViewIndex(\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    // Sort by ELO score (key) for efficient range queries\n    const sortedResults = viewRows.sort((a, b) => {\n      if (typeof a.key === 'number' && typeof b.key === 'number') {\n        return a.key - b.key;\n      }\n      return 0;\n    });\n\n    return {\n      ...baseResult,\n      sorted: sortedResults,\n      stats: {\n        min: sortedResults[0]?.key || 0,\n        max: sortedResults[sortedResults.length - 1]?.key || 0,\n        count: sortedResults.length,\n      },\n    };\n  }\n\n  /**\n   * Format tags view results - convert to tag mapping format\n   */\n  private formatTagsViewIndex(\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    // Group by tag name (key)\n    const tagMap: Record<string, string[]> = {};\n    \n    for (const row of viewRows) {\n      const tagName = row.key;\n      if (typeof tagName === 'string') {\n        if (!tagMap[tagName]) {\n          tagMap[tagName] = [];\n        }\n        tagMap[tagName].push(row.id);\n      }\n    }\n\n    return {\n      ...baseResult,\n      byTag: tagMap,\n      tagCount: Object.keys(tagMap).length,\n    };\n  }\n\n  /**\n   * Format inexperience view results - convert to experience-based format\n   */\n  private formatInexperienceViewIndex(\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    // Sort by inexperience level (key) - lower numbers = less experience\n    const sortedResults = viewRows.sort((a, b) => {\n      if (typeof a.key === 'number' && typeof b.key === 'number') {\n        return a.key - b.key;\n      }\n      return 0;\n    });\n\n    return {\n      ...baseResult,\n      sorted: sortedResults,\n      stats: {\n        minInexperience: sortedResults[0]?.key || 0,\n        maxInexperience: sortedResults[sortedResults.length - 1]?.key || 0,\n        count: sortedResults.length,\n      },\n    };\n  }\n\n  /**\n   * Format generic view results - fallback for unknown views\n   */\n  private formatGenericViewIndex(\n    _viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    return {\n      ...baseResult,\n      // Keep results as-is for unknown view types\n    };\n  }\n\n  /**\n   * Extract all attachments from documents and download binary data\n   */\n  private async extractAllAttachments(\n    docsByType: Record<DocType, any[]>,\n    attachments: Map<string, AttachmentData>\n  ): Promise<void> {\n    logger.info('Extracting attachments...');\n    \n    const allDocs: any[] = [];\n    for (const docs of Object.values(docsByType)) {\n      allDocs.push(...docs);\n    }\n\n    const docsWithAttachments = allDocs.filter(doc => doc._attachments && Object.keys(doc._attachments).length > 0);\n    \n    if (docsWithAttachments.length === 0) {\n      logger.info('No attachments found');\n      return;\n    }\n\n    logger.info(`Found ${docsWithAttachments.length} documents with attachments`);\n\n    // Process attachments concurrently\n    const extractionPromises = docsWithAttachments.map(doc => \n      this.extractDocumentAttachments(doc, attachments)\n    );\n\n    await Promise.all(extractionPromises);\n    \n    logger.info(`Extracted ${attachments.size} attachment files`);\n  }\n\n  /**\n   * Extract attachments for a single document\n   */\n  private async extractDocumentAttachments(\n    doc: any,\n    attachments: Map<string, AttachmentData>\n  ): Promise<void> {\n    if (!doc._attachments || !this.sourceDB) {\n      return;\n    }\n\n    const docId = doc._id;\n    \n    for (const [attachmentName, metadata] of Object.entries(doc._attachments as Record<string, any>)) {\n      try {\n        // Download attachment binary data\n        const attachmentResponse = await this.sourceDB.getAttachment(docId, attachmentName);\n        \n        // Convert to buffer\n        let buffer: Buffer;\n        if (attachmentResponse instanceof ArrayBuffer) {\n          buffer = Buffer.from(attachmentResponse);\n        } else if (Buffer.isBuffer(attachmentResponse)) {\n          buffer = attachmentResponse;\n        } else {\n          // For browser environments, the response might be a Blob\n          const blob = attachmentResponse as Blob;\n          buffer = Buffer.from(await blob.arrayBuffer());\n        }\n\n        // Generate filename with proper extension\n        const extension = this.getFileExtension(metadata.content_type);\n        const filename = `${attachmentName}${extension}`;\n        const attachmentPath = `attachments/${docId}/${filename}`;\n        \n        // Store attachment data\n        attachments.set(attachmentPath, {\n          docId,\n          attachmentName,\n          filename,\n          path: attachmentPath,\n          contentType: metadata.content_type,\n          length: metadata.length || buffer.length,\n          digest: metadata.digest,\n          buffer,\n        });\n\n        logger.debug(`Extracted attachment: ${attachmentPath}`);\n      } catch (error) {\n        logger.error(`Failed to extract attachment ${docId}/${attachmentName}:`, error);\n        throw new Error(`Failed to extract attachment ${docId}/${attachmentName}: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * Transform attachment stubs to include file paths\n   */\n  private transformAttachmentStubs(\n    attachments: Record<string, any>,\n    docId: string\n  ): Record<string, any> {\n    const transformed: Record<string, any> = {};\n    \n    for (const [attachmentName, metadata] of Object.entries(attachments)) {\n      const extension = this.getFileExtension(metadata.content_type);\n      const filename = `${attachmentName}${extension}`;\n      const attachmentPath = `attachments/${docId}/${filename}`;\n      \n      transformed[attachmentName] = {\n        path: attachmentPath,\n        content_type: metadata.content_type,\n        length: metadata.length,\n        digest: metadata.digest,\n        stub: false, // No longer a stub - we have the actual file\n      };\n    }\n    \n    return transformed;\n  }\n\n  /**\n   * Get file extension from content type\n   */\n  private getFileExtension(contentType: string): string {\n    const extensionMap: Record<string, string> = {\n      'image/jpeg': '.jpg',\n      'image/jpg': '.jpg', \n      'image/png': '.png',\n      'image/gif': '.gif',\n      'image/webp': '.webp',\n      'audio/mpeg': '.mp3',\n      'audio/mp3': '.mp3',\n      'audio/wav': '.wav',\n      'audio/ogg': '.ogg',\n      'video/mp4': '.mp4',\n      'video/webm': '.webm',\n      'application/pdf': '.pdf',\n      'text/plain': '.txt',\n      'application/json': '.json',\n    };\n    \n    return extensionMap[contentType] || '';\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/util/logger.ts","../../../src/util/packer/CouchDBToStaticPacker.ts"],"sourcesContent":["/**\n * Simple logging utility for @vue-skuilder/db package\n *\n * This utility provides environment-aware logging with ESLint suppressions\n * to resolve console statement violations while maintaining logging functionality.\n */\n\nconst isDevelopment = typeof process !== 'undefined' && process.env.NODE_ENV === 'development';\nconst _isBrowser = typeof window !== 'undefined';\n\nexport const logger = {\n  /**\n   * Debug-level logging - only shown in development\n   */\n  debug: (message: string, ...args: any[]): void => {\n    if (isDevelopment) {\n      // eslint-disable-next-line no-console\n      console.debug(`[DB:DEBUG] ${message}`, ...args);\n    }\n  },\n\n  /**\n   * Info-level logging - general information\n   */\n  info: (message: string, ...args: any[]): void => {\n    // eslint-disable-next-line no-console\n    console.info(`[DB:INFO] ${message}`, ...args);\n  },\n\n  /**\n   * Warning-level logging - potential issues\n   */\n  warn: (message: string, ...args: any[]): void => {\n    // eslint-disable-next-line no-console\n    console.warn(`[DB:WARN] ${message}`, ...args);\n  },\n\n  /**\n   * Error-level logging - serious problems\n   */\n  error: (message: string, ...args: any[]): void => {\n    // eslint-disable-next-line no-console\n    console.error(`[DB:ERROR] ${message}`, ...args);\n  },\n\n  /**\n   * Log function for backward compatibility with existing log() usage\n   */\n  log: (message: string, ...args: any[]): void => {\n    if (isDevelopment) {\n      // eslint-disable-next-line no-console\n      console.log(`[DB:LOG] ${message}`, ...args);\n    }\n  },\n};\n","// packages/db/src/util/packer/CouchDBToStaticPacker.ts\n\nimport { CardData, DocType, Tag } from '../../core/types/types-legacy';\nimport { logger } from '../logger';\n// CourseConfig interface - simplified for packer use\n\nimport { CourseConfig } from '@vue-skuilder/common';\nimport {\n  ChunkMetadata,\n  DesignDocument,\n  IndexMetadata,\n  PackedCourseData,\n  PackerConfig,\n  StaticCourseManifest,\n  AttachmentData,\n} from './types';\nimport { FileSystemAdapter } from '../migrator/FileSystemAdapter';\n\nexport class CouchDBToStaticPacker {\n  private config: PackerConfig;\n  private sourceDB: PouchDB.Database | null = null;\n\n  constructor(config: Partial<PackerConfig> = {}) {\n    this.config = {\n      chunkSize: 1000,\n      includeAttachments: true,\n      ...config,\n    };\n  }\n\n  /**\n   * Pack a CouchDB course database into static data structures\n   */\n  async packCourse(sourceDB: PouchDB.Database, courseId: string): Promise<PackedCourseData> {\n    logger.info(`Starting static pack for course: ${courseId}`);\n    this.sourceDB = sourceDB;\n\n    const manifest: StaticCourseManifest = {\n      version: '1.0.0',\n      courseId,\n      courseName: '',\n      courseConfig: null,\n      lastUpdated: new Date().toISOString(),\n      documentCount: 0,\n      chunks: [],\n      indices: [],\n      designDocs: [],\n    };\n\n    // 1. Extract course config\n    const courseConfig = await this.extractCourseConfig(sourceDB);\n    manifest.courseName = courseConfig.name;\n    manifest.courseConfig = courseConfig;\n\n    // 2. Extract and process design documents\n    manifest.designDocs = await this.extractDesignDocs(sourceDB);\n\n    // 3. Extract all documents by type and create chunks\n    const docsByType = await this.extractDocumentsByType(sourceDB);\n\n    // 4. Extract attachments if enabled\n    const attachments = new Map<string, AttachmentData>();\n    if (this.config.includeAttachments) {\n      await this.extractAllAttachments(docsByType, attachments);\n    }\n\n    // 5. Create chunks and prepare chunk data\n    const chunks = new Map<string, any[]>();\n    for (const [docType, docs] of Object.entries(docsByType)) {\n      const chunkMetadata = this.createChunks(docs, docType as DocType);\n      manifest.chunks.push(...chunkMetadata);\n      manifest.documentCount += docs.length;\n\n      // Prepare chunk data\n      this.prepareChunkData(chunkMetadata, docs, chunks);\n    }\n\n    // 6. Build indices\n    const indices = new Map<string, any>();\n    manifest.indices = await this.buildIndices(docsByType, manifest.designDocs, indices);\n\n    return {\n      manifest,\n      chunks,\n      indices,\n      attachments,\n    };\n  }\n\n  /**\n   * Pack a CouchDB course database and write the static files to disk\n   */\n  async packCourseToFiles(\n    sourceDB: PouchDB.Database, \n    courseId: string, \n    outputDir: string, \n    fsAdapter: FileSystemAdapter\n  ): Promise<{ \n    manifest: StaticCourseManifest; \n    filesWritten: number; \n    attachmentsFound: number; \n  }> {\n    logger.info(`Packing course ${courseId} to files in ${outputDir}`);\n    \n    // First, pack the course data\n    const packedData = await this.packCourse(sourceDB, courseId);\n    \n    // Write the files using the FileSystemAdapter\n    const filesWritten = await this.writePackedDataToFiles(packedData, outputDir, fsAdapter);\n    \n    return {\n      manifest: packedData.manifest,\n      filesWritten,\n      attachmentsFound: packedData.attachments ? packedData.attachments.size : 0,\n    };\n  }\n\n  /**\n   * Write packed course data to files using FileSystemAdapter\n   */\n  private async writePackedDataToFiles(\n    packedData: PackedCourseData,\n    outputDir: string,\n    fsAdapter: FileSystemAdapter\n  ): Promise<number> {\n    let totalFiles = 0;\n    \n    // Ensure output directory exists\n    await fsAdapter.ensureDir(outputDir);\n    \n    // Write manifest\n    const manifestPath = fsAdapter.joinPath(outputDir, 'manifest.json');\n    await fsAdapter.writeJson(manifestPath, packedData.manifest, { spaces: 2 });\n    totalFiles++;\n    logger.info(`Wrote manifest: ${manifestPath}`);\n    \n    // Create subdirectories\n    const chunksDir = fsAdapter.joinPath(outputDir, 'chunks');\n    const indicesDir = fsAdapter.joinPath(outputDir, 'indices');\n    await fsAdapter.ensureDir(chunksDir);\n    await fsAdapter.ensureDir(indicesDir);\n    \n    // Write chunks\n    for (const [chunkId, chunkData] of packedData.chunks) {\n      const chunkPath = fsAdapter.joinPath(chunksDir, `${chunkId}.json`);\n      await fsAdapter.writeJson(chunkPath, chunkData);\n      totalFiles++;\n    }\n    logger.info(`Wrote ${packedData.chunks.size} chunk files`);\n    \n    // Write indices\n    for (const [indexName, indexData] of packedData.indices) {\n      const indexPath = fsAdapter.joinPath(indicesDir, `${indexName}.json`);\n      await fsAdapter.writeJson(indexPath, indexData, { spaces: 2 });\n      totalFiles++;\n    }\n    logger.info(`Wrote ${packedData.indices.size} index files`);\n    \n    // Write attachments\n    if (packedData.attachments && packedData.attachments.size > 0) {\n      for (const [attachmentPath, attachmentData] of packedData.attachments) {\n        const fullAttachmentPath = fsAdapter.joinPath(outputDir, attachmentPath);\n        \n        // Ensure attachment directory exists\n        const attachmentDir = fsAdapter.dirname(fullAttachmentPath);\n        await fsAdapter.ensureDir(attachmentDir);\n        \n        // Write binary file\n        await fsAdapter.writeFile(fullAttachmentPath, attachmentData.buffer);\n        totalFiles++;\n      }\n      logger.info(`Wrote ${packedData.attachments.size} attachment files`);\n    }\n    \n    return totalFiles;\n  }\n\n  private async extractCourseConfig(db: PouchDB.Database): Promise<CourseConfig> {\n    try {\n      return await db.get<CourseConfig>('CourseConfig');\n    } catch (error) {\n      logger.error('Failed to extract course config:', error);\n      throw new Error('Course config not found');\n    }\n  }\n\n  private async extractDesignDocs(db: PouchDB.Database): Promise<DesignDocument[]> {\n    const result = await db.allDocs({\n      startkey: '_design/',\n      endkey: '_design/\\ufff0',\n      include_docs: true,\n    });\n\n    return result.rows.map((row) => ({\n      _id: row.id,\n      views: (row.doc as any).views || {},\n    }));\n  }\n\n  private async extractDocumentsByType(db: PouchDB.Database): Promise<Record<DocType, any[]>> {\n    const allDocs = await db.allDocs({ include_docs: true });\n    const docsByType: Record<string, any[]> = {};\n\n    for (const row of allDocs.rows) {\n      if (row.id.startsWith('_')) continue; // Skip design docs\n\n      const doc = row.doc as any;\n      if (doc.docType) {\n        if (!docsByType[doc.docType]) {\n          docsByType[doc.docType] = [];\n        }\n        docsByType[doc.docType].push(doc);\n      }\n    }\n\n    return docsByType as Record<DocType, any[]>;\n  }\n\n  private createChunks(docs: any[], docType: DocType): ChunkMetadata[] {\n    const chunks: ChunkMetadata[] = [];\n    const sortedDocs = docs.sort((a, b) => a._id.localeCompare(b._id));\n\n    for (let i = 0; i < sortedDocs.length; i += this.config.chunkSize) {\n      const chunk = sortedDocs.slice(i, i + this.config.chunkSize);\n      const chunkId = `${docType}-${String(Math.floor(i / this.config.chunkSize)).padStart(4, '0')}`;\n\n      chunks.push({\n        id: chunkId,\n        docType,\n        startKey: chunk[0]._id,\n        endKey: chunk[chunk.length - 1]._id,\n        documentCount: chunk.length,\n        path: `chunks/${chunkId}.json`,\n      });\n    }\n\n    return chunks;\n  }\n\n  private prepareChunkData(\n    chunkMetadata: ChunkMetadata[],\n    docs: any[],\n    chunks: Map<string, any[]>\n  ): void {\n    const sortedDocs = docs.sort((a, b) => a._id.localeCompare(b._id));\n\n    for (const chunk of chunkMetadata) {\n      const chunkDocs = sortedDocs.filter(\n        (doc) => doc._id >= chunk.startKey && doc._id <= chunk.endKey\n      );\n\n      // Clean documents for storage\n      const cleanedDocs = chunkDocs.map((doc) => {\n        const cleaned = { ...doc };\n        delete cleaned._rev; // Remove revision info\n        \n        if (this.config.includeAttachments && cleaned._attachments) {\n          // Transform attachment stubs to file paths\n          cleaned._attachments = this.transformAttachmentStubs(cleaned._attachments, cleaned._id);\n        } else if (!this.config.includeAttachments) {\n          delete cleaned._attachments;\n        }\n        \n        return cleaned;\n      });\n\n      chunks.set(chunk.id, cleanedDocs);\n    }\n  }\n\n  private async buildIndices(\n    docsByType: Record<DocType, any[]>,\n    designDocs: DesignDocument[],\n    indices: Map<string, any>\n  ): Promise<IndexMetadata[]> {\n    const indexMetadata: IndexMetadata[] = [];\n\n    // Build ELO index\n    if (docsByType[DocType.CARD]) {\n      const eloIndexMeta = await this.buildEloIndex(\n        docsByType[DocType.CARD] as CardData[],\n        indices\n      );\n      indexMetadata.push(eloIndexMeta);\n    }\n\n    // Build tag indices\n    if (docsByType[DocType.TAG]) {\n      const tagIndexMeta = await this.buildTagIndex(docsByType[DocType.TAG] as Tag[], indices);\n      indexMetadata.push(tagIndexMeta);\n    }\n\n    // Build indices from design documents using CouchDB view queries\n    for (const designDoc of designDocs) {\n      for (const [viewName, viewDef] of Object.entries(designDoc.views)) {\n        if (viewDef.map) {\n          logger.info(`Processing view: ${designDoc._id}/${viewName}`);\n          const indexMeta = await this.buildViewIndex(viewName, designDoc, indices);\n          if (indexMeta) {\n            indexMetadata.push(indexMeta);\n            logger.info(`Successfully built index: ${indexMeta.name}`);\n          } else {\n            logger.warn(`Skipped view index: ${designDoc._id}/${viewName}`);\n          }\n        }\n      }\n    }\n\n    return indexMetadata;\n  }\n\n  private async buildEloIndex(\n    cards: CardData[],\n    indices: Map<string, any>\n  ): Promise<IndexMetadata> {\n    // Build a B-tree like structure for ELO queries\n    const eloIndex: Array<{ elo: number; cardId: string }> = [];\n\n    for (const card of cards) {\n      if (card.elo?.global?.score) {\n        eloIndex.push({\n          elo: card.elo.global.score,\n          cardId: (card as any)._id,\n        });\n      }\n    }\n\n    // Sort by ELO for efficient range queries\n    eloIndex.sort((a, b) => a.elo - b.elo);\n\n    // Create buckets for faster lookup\n    const buckets: Record<number, string[]> = {};\n    const bucketSize = 50; // ELO points per bucket\n\n    for (const entry of eloIndex) {\n      const bucket = Math.floor(entry.elo / bucketSize) * bucketSize;\n      if (!buckets[bucket]) buckets[bucket] = [];\n      buckets[bucket].push(entry.cardId);\n    }\n\n    // Store the index data\n    indices.set('elo', {\n      sorted: eloIndex,\n      buckets: buckets,\n      stats: {\n        min: eloIndex[0]?.elo || 0,\n        max: eloIndex[eloIndex.length - 1]?.elo || 0,\n        count: eloIndex.length,\n      },\n    });\n\n    return {\n      name: 'elo',\n      type: 'btree',\n      path: 'indices/elo.json',\n    };\n  }\n\n  private async buildTagIndex(tags: Tag[], indices: Map<string, any>): Promise<IndexMetadata> {\n    // Build inverted index for tags\n    const tagIndex: Record<\n      string,\n      {\n        cardIds: string[];\n        snippet: string;\n        count: number;\n      }\n    > = {};\n\n    for (const tag of tags) {\n      tagIndex[tag.name] = {\n        cardIds: tag.taggedCards,\n        snippet: tag.snippet,\n        count: tag.taggedCards.length,\n      };\n    }\n\n    // Also build a reverse index (card -> tags)\n    const cardToTags: Record<string, string[]> = {};\n    for (const tag of tags) {\n      for (const cardId of tag.taggedCards) {\n        if (!cardToTags[cardId]) cardToTags[cardId] = [];\n        cardToTags[cardId].push(tag.name);\n      }\n    }\n\n    indices.set('tags', {\n      byTag: tagIndex,\n      byCard: cardToTags,\n    });\n\n    return {\n      name: 'tags',\n      type: 'hash',\n      path: 'indices/tags.json',\n    };\n  }\n\n  /**\n   * Build view index by querying CouchDB views directly instead of parsing map functions\n   */\n  private async buildViewIndex(\n    viewName: string,\n    designDoc: DesignDocument,\n    indices: Map<string, any>\n  ): Promise<IndexMetadata | null> {\n    if (!this.sourceDB) {\n      logger.error('Source database not available for view querying');\n      return null;\n    }\n\n    try {\n      const designDocId = designDoc._id; // e.g., \"_design/elo\"\n      const designDocName = designDocId.replace('_design/', ''); // Extract just \"elo\"\n      const viewPath = `${designDocName}/${viewName}`;\n      \n      logger.info(`Querying CouchDB view: ${viewPath}`);\n      \n      // Query the view directly from CouchDB using PouchDB format: \"designDocName/viewName\"\n      const viewResults = await this.sourceDB.query(viewPath, {\n        include_docs: false,\n      });\n\n      if (!viewResults.rows || viewResults.rows.length === 0) {\n        logger.warn(`View ${viewPath} returned no results`);\n        return null;\n      }\n\n      logger.info(`Successfully queried view ${viewPath}: ${viewResults.rows.length} results`);\n\n      // Format the results for static consumption\n      const formattedResults = this.formatViewResults(viewName, viewResults.rows, designDoc);\n      \n      const indexName = `view-${designDoc._id.replace('_design/', '')}-${viewName}`;\n      indices.set(indexName, formattedResults);\n\n      return {\n        name: indexName,\n        type: 'view',\n        path: `indices/${indexName}.json`,\n      };\n    } catch (error) {\n      logger.error(`Failed to query view ${designDoc._id}/${viewName}:`, error);\n      // Return null to gracefully skip this view rather than failing the entire pack\n      return null;\n    }\n  }\n\n  /**\n   * Format CouchDB view results for static consumption\n   */\n  private formatViewResults(\n    viewName: string,\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    designDoc: DesignDocument\n  ): any {\n    const baseResult = {\n      type: 'couchdb-view',\n      viewName,\n      designDoc: designDoc._id,\n      results: viewRows,\n      metadata: {\n        resultCount: viewRows.length,\n        generatedAt: new Date().toISOString(),\n      },\n    };\n\n    // Apply view-specific formatting\n    switch (viewName) {\n      case 'elo':\n        return this.formatEloViewIndex(viewRows, baseResult);\n      case 'getTags':\n        return this.formatTagsViewIndex(viewRows, baseResult);\n      case 'cardsByInexperience':\n        return this.formatInexperienceViewIndex(viewRows, baseResult);\n      default:\n        return this.formatGenericViewIndex(viewRows, baseResult);\n    }\n  }\n\n  /**\n   * Format ELO view results - convert to sorted array format\n   */\n  private formatEloViewIndex(\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    // Sort by ELO score (key) for efficient range queries\n    const sortedResults = viewRows.sort((a, b) => {\n      if (typeof a.key === 'number' && typeof b.key === 'number') {\n        return a.key - b.key;\n      }\n      return 0;\n    });\n\n    return {\n      ...baseResult,\n      sorted: sortedResults,\n      stats: {\n        min: sortedResults[0]?.key || 0,\n        max: sortedResults[sortedResults.length - 1]?.key || 0,\n        count: sortedResults.length,\n      },\n    };\n  }\n\n  /**\n   * Format tags view results - convert to tag mapping format\n   */\n  private formatTagsViewIndex(\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    // Group by tag name (key)\n    const tagMap: Record<string, string[]> = {};\n    \n    for (const row of viewRows) {\n      const tagName = row.key;\n      if (typeof tagName === 'string') {\n        if (!tagMap[tagName]) {\n          tagMap[tagName] = [];\n        }\n        tagMap[tagName].push(row.id);\n      }\n    }\n\n    return {\n      ...baseResult,\n      byTag: tagMap,\n      tagCount: Object.keys(tagMap).length,\n    };\n  }\n\n  /**\n   * Format inexperience view results - convert to experience-based format\n   */\n  private formatInexperienceViewIndex(\n    viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    // Sort by inexperience level (key) - lower numbers = less experience\n    const sortedResults = viewRows.sort((a, b) => {\n      if (typeof a.key === 'number' && typeof b.key === 'number') {\n        return a.key - b.key;\n      }\n      return 0;\n    });\n\n    return {\n      ...baseResult,\n      sorted: sortedResults,\n      stats: {\n        minInexperience: sortedResults[0]?.key || 0,\n        maxInexperience: sortedResults[sortedResults.length - 1]?.key || 0,\n        count: sortedResults.length,\n      },\n    };\n  }\n\n  /**\n   * Format generic view results - fallback for unknown views\n   */\n  private formatGenericViewIndex(\n    _viewRows: Array<{ key: any; value: any; id: string }>,\n    baseResult: any\n  ): any {\n    return {\n      ...baseResult,\n      // Keep results as-is for unknown view types\n    };\n  }\n\n  /**\n   * Extract all attachments from documents and download binary data\n   */\n  private async extractAllAttachments(\n    docsByType: Record<DocType, any[]>,\n    attachments: Map<string, AttachmentData>\n  ): Promise<void> {\n    logger.info('Extracting attachments...');\n    \n    const allDocs: any[] = [];\n    for (const docs of Object.values(docsByType)) {\n      allDocs.push(...docs);\n    }\n\n    const docsWithAttachments = allDocs.filter(doc => doc._attachments && Object.keys(doc._attachments).length > 0);\n    \n    if (docsWithAttachments.length === 0) {\n      logger.info('No attachments found');\n      return;\n    }\n\n    logger.info(`Found ${docsWithAttachments.length} documents with attachments`);\n\n    // Process attachments concurrently\n    const extractionPromises = docsWithAttachments.map(doc => \n      this.extractDocumentAttachments(doc, attachments)\n    );\n\n    await Promise.all(extractionPromises);\n    \n    logger.info(`Extracted ${attachments.size} attachment files`);\n  }\n\n  /**\n   * Extract attachments for a single document\n   */\n  private async extractDocumentAttachments(\n    doc: any,\n    attachments: Map<string, AttachmentData>\n  ): Promise<void> {\n    if (!doc._attachments || !this.sourceDB) {\n      return;\n    }\n\n    const docId = doc._id;\n    \n    for (const [attachmentName, metadata] of Object.entries(doc._attachments as Record<string, any>)) {\n      try {\n        // Download attachment binary data\n        const attachmentResponse = await this.sourceDB.getAttachment(docId, attachmentName);\n        \n        // Convert to buffer\n        let buffer: Buffer;\n        if (attachmentResponse instanceof ArrayBuffer) {\n          buffer = Buffer.from(attachmentResponse);\n        } else if (Buffer.isBuffer(attachmentResponse)) {\n          buffer = attachmentResponse;\n        } else {\n          // For browser environments, the response might be a Blob\n          const blob = attachmentResponse as Blob;\n          buffer = Buffer.from(await blob.arrayBuffer());\n        }\n\n        // Generate filename with proper extension\n        const extension = this.getFileExtension(metadata.content_type);\n        const filename = `${attachmentName}${extension}`;\n        const attachmentPath = `attachments/${docId}/${filename}`;\n        \n        // Store attachment data\n        attachments.set(attachmentPath, {\n          docId,\n          attachmentName,\n          filename,\n          path: attachmentPath,\n          contentType: metadata.content_type,\n          length: metadata.length || buffer.length,\n          digest: metadata.digest,\n          buffer,\n        });\n\n        logger.debug(`Extracted attachment: ${attachmentPath}`);\n      } catch (error) {\n        logger.error(`Failed to extract attachment ${docId}/${attachmentName}:`, error);\n        throw new Error(`Failed to extract attachment ${docId}/${attachmentName}: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * Transform attachment stubs to include file paths\n   */\n  private transformAttachmentStubs(\n    attachments: Record<string, any>,\n    docId: string\n  ): Record<string, any> {\n    const transformed: Record<string, any> = {};\n    \n    for (const [attachmentName, metadata] of Object.entries(attachments)) {\n      const extension = this.getFileExtension(metadata.content_type);\n      const filename = `${attachmentName}${extension}`;\n      const attachmentPath = `attachments/${docId}/${filename}`;\n      \n      transformed[attachmentName] = {\n        path: attachmentPath,\n        content_type: metadata.content_type,\n        length: metadata.length,\n        digest: metadata.digest,\n        stub: false, // No longer a stub - we have the actual file\n      };\n    }\n    \n    return transformed;\n  }\n\n  /**\n   * Get file extension from content type\n   */\n  private getFileExtension(contentType: string): string {\n    const extensionMap: Record<string, string> = {\n      'image/jpeg': '.jpg',\n      'image/jpg': '.jpg', \n      'image/png': '.png',\n      'image/gif': '.gif',\n      'image/webp': '.webp',\n      'audio/mpeg': '.mp3',\n      'audio/mp3': '.mp3',\n      'audio/wav': '.wav',\n      'audio/ogg': '.ogg',\n      'video/mp4': '.mp4',\n      'video/webm': '.webm',\n      'application/pdf': '.pdf',\n      'text/plain': '.txt',\n      'application/json': '.json',\n    };\n    \n    return extensionMap[contentType] || '';\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.6",
+  "version": "0.1.8-0",
   "description": "Database layer for vue-skuilder",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -45,13 +45,16 @@
   },
   "dependencies": {
     "@nilock2/pouchdb-authentication": "^1.0.2",
-    "@vue-skuilder/common": "0.1.6",
+    "@vue-skuilder/common": "0.1.8-0",
     "moment": "^2.29.4",
     "pouchdb": "^9.0.0",
-    "pouchdb-find": "^9.0.0"
+    "pouchdb-find": "^9.0.0",
+    "uuid": "^11.1.0"
   },
   "devDependencies": {
+    "@types/uuid": "^10.0.0",
     "tsup": "^8.0.2",
     "typescript": "~5.7.2"
-  }
+  },
+  "stableVersion": "0.1.7"
 }

package/src/core/types/types-legacy.ts

@@ -86,7 +86,19 @@ export interface QuestionData extends SkuilderCourseData {
   dataShapeList: PouchDB.Core.DocumentId[];
 }
 
-export const cardHistoryPrefix = 'cardH';
+export const DocTypePrefixes: Record<string, string> = {
+  [DocType.CARD]: 'c',
+  [DocType.DISPLAYABLE_DATA]: 'dd',
+  [DocType.TAG]: 'TAG',
+  [DocType.CARDRECORD]: 'cardH',
+  [DocType.SCHEDULED_CARD]: 'card_review_',
+  // Add other doctypes here as they get prefixed IDs
+  [DocType.DATASHAPE]: 'DATASHAPE',
+  [DocType.QUESTIONTYPE]: 'QUESTION',
+  [DocType.VIEW]: 'VIEW',
+  [DocType.PEDAGOGY]: 'PEDAGOGY',
+  [DocType.NAVIGATION_STRATEGY]: 'NAVIGATION_STRATEGY',
+};
 
 export interface CardHistory<T extends CardRecord> {
   _id: PouchDB.Core.DocumentId;

package/src/core/types/user.ts

@@ -4,6 +4,7 @@ import { Moment } from 'moment';
 export interface UserConfig {
   darkMode: boolean;
   likesConfetti: boolean;
+  sessionTimeLimit: number; // Session time limit in minutes
 }
 
 export interface ActivityRecord {
@@ -48,13 +49,19 @@ export interface ScheduledCard {
    *
    * (Should probably be UTC adjusted so that performance is
    * not wonky across time zones)
+   * 
+   * Note: Stored as ISO string for PouchDB serialization compatibility,
+   * but can be consumed as Moment objects via moment.utc(reviewTime)
    */
-  reviewTime: Moment;
+  reviewTime: string | Moment;
 
   /**
    * The time at which this scheduled event was created.
+   * 
+   * Note: Stored as ISO string for PouchDB serialization compatibility,
+   * but can be consumed as Moment objects via moment.utc(scheduledAt)
    */
-  scheduledAt: Moment;
+  scheduledAt: string | Moment;
 
   /**
    * Classifying whether this card is scheduled on behalf of a

package/src/core/util/index.ts

@@ -1,4 +1,4 @@
-import { cardHistoryPrefix, CardHistory, CardRecord, QuestionRecord } from '../types/types-legacy';
+import { DocType, DocTypePrefixes, CardHistory, CardRecord, QuestionRecord } from '../types/types-legacy';
 
 export function areQuestionRecords(h: CardHistory<CardRecord>): h is CardHistory<QuestionRecord> {
   return isQuestionRecord(h.records[0]);
@@ -9,7 +9,7 @@ export function isQuestionRecord(c: CardRecord): c is QuestionRecord {
 }
 
 export function getCardHistoryID(courseID: string, cardID: string): PouchDB.Core.DocumentId {
-  return `${cardHistoryPrefix}-${courseID}-${cardID}`;
+  return `${DocTypePrefixes[DocType.CARDRECORD]}-${courseID}-${cardID}`;
 }
 
 export function parseCardHistoryID(id: string): {
@@ -20,9 +20,10 @@ export function parseCardHistoryID(id: string): {
   let error: string = '';
   error += split.length === 3 ? '' : `\n\tgiven ID has incorrect number of '-' characters`;
   error +=
-    split[0] === cardHistoryPrefix ? '' : `\n\tgiven ID does not start with ${cardHistoryPrefix}`;
+    split[0] === DocTypePrefixes[DocType.CARDRECORD] ? '' : `
+	given ID does not start with ${DocTypePrefixes[DocType.CARDRECORD]}`;
 
-  if (split.length === 3 && split[0] === cardHistoryPrefix) {
+  if (split.length === 3 && split[0] === DocTypePrefixes[DocType.CARDRECORD]) {
     return {
       courseID: split[1],
       cardID: split[2],

package/src/factory.ts

@@ -1,6 +1,7 @@
 // db/src/factory.ts
 
 import { DataLayerProvider } from './core/interfaces';
+import { BaseUser } from './impl/common';
 import { logger } from './util/logger';
 import { StaticCourseManifest } from './util/packer/types';
 
@@ -53,6 +54,30 @@ export async function initializeDataLayer(config: DataLayerConfig): Promise<Data
     ENV.COUCHDB_USERNAME = config.options.COUCHDB_USERNAME;
     ENV.COUCHDB_PASSWORD = config.options.COUCHDB_PASSWORD;
 
+    if (
+      config.options.COUCHDB_PASSWORD &&
+      config.options.COUCHDB_USERNAME &&
+      typeof window !== 'undefined'
+    ) {
+      // Dynamic import to avoid loading both implementations when only one is needed
+      const { CouchDBSyncStrategy } = await import('./impl/couch/CouchDBSyncStrategy');
+
+      // Create a sync strategy instance and authenticate
+      const syncStrategy = new CouchDBSyncStrategy();
+
+      const user = await BaseUser.instance(syncStrategy, config.options.COUCHDB_USERNAME);
+      const authResult = await user.login(
+        config.options.COUCHDB_USERNAME,
+        config.options.COUCHDB_PASSWORD
+      );
+
+      if (authResult.ok) {
+        logger.info(`Successfully authenticated as ${config.options.COUCHDB_USERNAME}`);
+      } else {
+        logger.warn(`Authentication failed: ${authResult.error}`);
+      }
+    }
+
     // Dynamic import to avoid loading both implementations when only one is needed
     const { CouchDataLayerProvider } = await import('./impl/couch/PouchDataLayerProvider');
     dataLayerInstance = new CouchDataLayerProvider(config.options.COURSE_IDS);

package/src/impl/common/BaseUserDB.ts

@@ -1,3 +1,4 @@
+import { DocType, DocTypePrefixes } from '@db/core';
 import { getCardHistoryID } from '@db/core/util';
 import { CourseElo, Status } from '@vue-skuilder/common';
 import moment, { Moment } from 'moment';
@@ -23,7 +24,6 @@ import type { SyncStrategy } from './SyncStrategy';
 import {
   filterAllDocsByPrefix,
   getStartAndEndKeys,
-  REVIEW_PREFIX,
   REVIEW_TIME_FORMAT,
   getLocalUserDB,
   scheduleCardReviewLocal,
@@ -38,8 +38,6 @@ const log = (s: any) => {
   logger.info(s);
 };
 
-const cardHistoryPrefix = 'cardH-';
-
 // console.log(`Connecting to remote: ${remoteStr}`);
 
 interface DesignDoc {
@@ -81,11 +79,14 @@ export class BaseUser implements UserDBInterface, DocumentUpdater {
     return !this._username.startsWith(GuestUsername);
   }
 
-  private remoteDB!: PouchDB.Database;
   public remote(): PouchDB.Database {
     return this.remoteDB;
   }
+
   private localDB!: PouchDB.Database;
+  private remoteDB!: PouchDB.Database;
+  private writeDB!: PouchDB.Database; // Database to use for write operations (local-first approach)
+
   private updateQueue!: UpdateQueue;
 
   public async createAccount(
@@ -112,7 +113,11 @@ Currently logged-in as ${this._username}.`
     if (result.status === Status.ok) {
       log(`Account created successfully, updating username to ${username}`);
       this._username = username;
-      localStorage.removeItem('dbUUID');
+      try {
+        localStorage.removeItem('dbUUID');
+      } catch (e) {
+        logger.warn('localStorage not available (Node.js environment):', e);
+      }
       await this.init();
     }
 
@@ -126,16 +131,23 @@ Currently logged-in as ${this._username}.`
       throw new Error('Authentication not supported by current sync strategy');
     }
 
-    if (!this._username.startsWith(GuestUsername)) {
-      throw new Error(`Cannot change accounts while logged in.
-      Log out of account ${this.getUsername()} before logging in as ${username}.`);
+    if (!this._username.startsWith(GuestUsername) && this._username != username) {
+      if (this._username != username) {
+        throw new Error(`Cannot change accounts while logged in.
+        Log out of account ${this.getUsername()} before logging in as ${username}.`);
+      }
+      logger.warn(`User ${this._username} is already logged in, but executing login again.`);
     }
 
     const loginResult = await this.syncStrategy.authenticate!(username, password);
     if (loginResult.ok) {
       log(`Logged in as ${username}`);
       this._username = username;
-      localStorage.removeItem('dbUUID');
+      try {
+        localStorage.removeItem('dbUUID');
+      } catch (e) {
+        logger.warn('localStorage not available (Node.js environment):', e);
+      }
       await this.init();
     }
     return loginResult;
@@ -163,8 +175,8 @@ Currently logged-in as ${this._username}.`
           const id = row.id;
           // Delete user progress data but preserve core user documents
           return (
-            id.startsWith(cardHistoryPrefix) || // Card interaction history
-            id.startsWith(REVIEW_PREFIX) || // Scheduled reviews
+            id.startsWith(DocTypePrefixes[DocType.CARDRECORD]) || // Card interaction history
+            id.startsWith(DocTypePrefixes[DocType.SCHEDULED_CARD]) || // Scheduled reviews
             id === BaseUser.DOC_IDS.COURSE_REGISTRATIONS || // Course registrations
             id === BaseUser.DOC_IDS.CLASSROOM_REGISTRATIONS || // Classroom registrations
             id === BaseUser.DOC_IDS.CONFIG // User config
@@ -253,7 +265,7 @@ Currently logged-in as ${this._username}.`
    *
    */
   public async getActiveCards() {
-    const keys = getStartAndEndKeys(REVIEW_PREFIX);
+    const keys = getStartAndEndKeys(DocTypePrefixes[DocType.SCHEDULED_CARD]);
 
     const reviews = await this.remoteDB.allDocs<ScheduledCard>({
       startkey: keys.startkey,
@@ -348,7 +360,7 @@ Currently logged-in as ${this._username}.`
   }
 
   private async getReviewstoDate(targetDate: Moment, course_id?: string) {
-    const keys = getStartAndEndKeys(REVIEW_PREFIX);
+    const keys = getStartAndEndKeys(DocTypePrefixes[DocType.SCHEDULED_CARD]);
 
     const reviews = await this.remoteDB.allDocs<ScheduledCard>({
       startkey: keys.startkey,
@@ -363,8 +375,11 @@ Currently logged-in as ${this._username}.`
     );
     return reviews.rows
       .filter((r) => {
-        if (r.id.startsWith(REVIEW_PREFIX)) {
-          const date = moment.utc(r.id.substr(REVIEW_PREFIX.length), REVIEW_TIME_FORMAT);
+        if (r.id.startsWith(DocTypePrefixes[DocType.SCHEDULED_CARD])) {
+          const date = moment.utc(
+            r.id.substr(DocTypePrefixes[DocType.SCHEDULED_CARD].length),
+            REVIEW_TIME_FORMAT
+          );
           if (targetDate.isAfter(date)) {
             if (course_id === undefined || r.doc!.courseId === course_id) {
               return true;
@@ -504,6 +519,7 @@ Currently logged-in as ${this._username}.`
       _id: BaseUser.DOC_IDS.CONFIG,
       darkMode: false,
       likesConfetti: false,
+      sessionTimeLimit: 5,
     };
 
     try {
@@ -585,11 +601,22 @@ Currently logged-in as ${this._username}.`
   private setDBandQ() {
     this.localDB = getLocalUserDB(this._username);
     this.remoteDB = this.syncStrategy.setupRemoteDB(this._username);
-    this.updateQueue = new UpdateQueue(this.localDB);
+    // writeDB follows local-first pattern: static mode writes to local, CouchDB writes to remote/local as appropriate
+    this.writeDB = this.syncStrategy.getWriteDB
+      ? this.syncStrategy.getWriteDB(this._username)
+      : this.localDB;
+    this.updateQueue = new UpdateQueue(this.localDB, this.writeDB);
   }
 
   private async init() {
     BaseUser._initialized = false;
+
+    // Skip admin user
+    if (this._username === 'admin') {
+      BaseUser._initialized = true;
+      return;
+    }
+
     this.setDBandQ();
 
     this.syncStrategy.startSync(this.localDB, this.remoteDB);
@@ -614,6 +641,11 @@ Currently logged-in as ${this._username}.`
   ];
 
   private async applyDesignDocs() {
+    if (this._username === 'admin') {
+      // Skip admin user
+      return;
+    }
+
     for (const doc of BaseUser.designDocs) {
       try {
         // Try to get existing doc
@@ -633,7 +665,7 @@ Currently logged-in as ${this._username}.`
           }
         }
       } catch (error: unknown) {
-        if (error instanceof Error && error.name === 'conflict') {
+        if ((error as any).name && (error as any).name === 'conflict') {
           logger.warn(`Design doc ${doc._id} update conflict - will retry`);
           // Wait a bit and try again
           await new Promise((resolve) => setTimeout(resolve, 1000));
@@ -673,7 +705,9 @@ Currently logged-in as ${this._username}.`
    * @returns The updated state of the card's CardHistory data
    */
 
-  public async putCardRecord<T extends CardRecord>(record: T): Promise<CardHistory<CardRecord>> {
+  public async putCardRecord<T extends CardRecord>(
+    record: T
+  ): Promise<CardHistory<CardRecord> & PouchDB.Core.RevisionIdMeta> {
     const cardHistoryID = getCardHistoryID(record.courseID, record.cardID);
     // stringify the current record to make it writable to couchdb
     record.timeStamp = moment.utc(record.timeStamp).toString() as unknown as Moment;
@@ -711,8 +745,8 @@ Currently logged-in as ${this._username}.`
           streak: 0,
           bestInterval: 0,
         };
-        void this.remoteDB.put<CardHistory<T>>(initCardHistory);
-        return initCardHistory;
+        const putResult = await this.writeDB.put<CardHistory<T>>(initCardHistory);
+        return { ...initCardHistory, _rev: putResult.rev };
       } else {
         throw new Error(`putCardRecord failed because of:
   name:${reason.name}
@@ -769,7 +803,7 @@ Currently logged-in as ${this._username}.`
         const deletePromises = duplicateDocIds.map(async (docId) => {
           try {
             const doc = await this.remoteDB.get(docId);
-            await this.remoteDB.remove(doc);
+            await this.writeDB.remove(doc);
             log(`Successfully removed duplicate review: ${docId}`);
           } catch (error) {
             log(`Failed to remove duplicate review ${docId}: ${error}`);
@@ -793,7 +827,7 @@ Currently logged-in as ${this._username}.`
    * @param course_id optional specification of individual course
    */
   async getSeenCards(course_id?: string) {
-    let prefix = cardHistoryPrefix;
+    let prefix = DocTypePrefixes[DocType.CARDRECORD];
     if (course_id) {
       prefix += course_id;
     }
@@ -803,8 +837,8 @@ Currently logged-in as ${this._username}.`
     // const docs = await this.localDB.allDocs({});
     const ret: PouchDB.Core.DocumentId[] = [];
     docs.rows.forEach((row) => {
-      if (row.id.startsWith(cardHistoryPrefix)) {
-        ret.push(row.id.substr(cardHistoryPrefix.length));
+      if (row.id.startsWith(DocTypePrefixes[DocType.CARDRECORD])) {
+        ret.push(row.id.substr(DocTypePrefixes[DocType.CARDRECORD].length));
       }
     });
     return ret;
@@ -817,7 +851,7 @@ Currently logged-in as ${this._username}.`
   async getHistory() {
     const cards = await filterAllDocsByPrefix<CardHistory<CardRecord>>(
       this.remoteDB,
-      cardHistoryPrefix,
+      DocTypePrefixes[DocType.CARDRECORD],
       {
         include_docs: true,
         attachments: false,
@@ -867,7 +901,7 @@ Currently logged-in as ${this._username}.`
 
       if (err.status === 404) {
         // doc does not exist. Create it and then run this fcn again.
-        await this.remoteDB.put<ClassroomRegistrationDoc>({
+        await this.writeDB.put<ClassroomRegistrationDoc>({
           _id: BaseUser.DOC_IDS.CLASSROOM_REGISTRATIONS,
           registrations: [],
         });
@@ -931,10 +965,10 @@ Currently logged-in as ${this._username}.`
     scheduledFor: ScheduledCard['scheduledFor'];
     schedulingAgentId: ScheduledCard['schedulingAgentId'];
   }) {
-    return scheduleCardReviewLocal(this.remoteDB, review);
+    return scheduleCardReviewLocal(this.writeDB, review);
   }
   public async removeScheduledCardReview(reviewId: string): Promise<void> {
-    return removeScheduledCardReviewLocal(this.remoteDB, reviewId);
+    return removeScheduledCardReviewLocal(this.writeDB, reviewId);
   }
 
   public async registerForClassroom(

package/src/impl/common/SyncStrategy.ts

@@ -14,6 +14,13 @@ export interface SyncStrategy {
    */
   setupRemoteDB(username: string): PouchDB.Database;
 
+  /**
+   * Get the database to use for write operations (local-first approach)
+   * @param username The username to get write DB for
+   * @returns PouchDB database instance for write operations
+   */
+  getWriteDB?(username: string): PouchDB.Database;
+
   /**
    * Start synchronization between local and remote databases
    * @param localDB The local PouchDB instance

package/src/impl/common/index.ts

@@ -11,7 +11,6 @@ export type {
 } from './types';
 export { BaseUser } from './BaseUserDB';
 export {
-  REVIEW_PREFIX,
   REVIEW_TIME_FORMAT,
   hexEncode,
   filterAllDocsByPrefix,

package/src/impl/common/userDBHelpers.ts

@@ -1,13 +1,14 @@
 // packages/db/src/impl/common/userDBHelpers.ts
 
 import moment from 'moment';
+import { DocType, DocTypePrefixes } from '@db/core';
 import { logger } from '../../util/logger';
 import { ScheduledCard } from '@db/core/types/user';
 
-export const REVIEW_PREFIX: string = 'card_review_';
 export const REVIEW_TIME_FORMAT: string = 'YYYY-MM-DD--kk:mm:ss-SSS';
 
 import pouch from '../couch/pouchdb-setup';
+import { getDbPath } from '../../util/dataDirectory';
 
 const log = (s: any) => {
   logger.info(s);
@@ -94,7 +95,16 @@ export function getLocalUserDB(username: string): PouchDB.Database {
   //   adapter = 'memory';
   // }
 
-  return new pouch(`userdb-${username}`, {});
+  const dbName = `userdb-${username}`;
+  
+  // Use proper data directory in Node.js, browser will use IndexedDB
+  if (typeof window === 'undefined') {
+    // Node.js environment - use filesystem with proper app data directory
+    return new pouch(getDbPath(dbName), {});
+  } else {
+    // Browser environment - use default (IndexedDB)
+    return new pouch(dbName, {});
+  }
 }
 
 /**
@@ -113,11 +123,11 @@ export function scheduleCardReviewLocal(
   const now = moment.utc();
   logger.info(`Scheduling for review in: ${review.time.diff(now, 'h') / 24} days`);
   void userDB.put<ScheduledCard>({
-    _id: REVIEW_PREFIX + review.time.format(REVIEW_TIME_FORMAT),
+    _id: DocTypePrefixes[DocType.SCHEDULED_CARD] + review.time.format(REVIEW_TIME_FORMAT),
     cardId: review.card_id,
-    reviewTime: review.time,
+    reviewTime: review.time.toISOString(),
     courseId: review.course_id,
-    scheduledAt: now,
+    scheduledAt: now.toISOString(),
     scheduledFor: review.scheduledFor,
     schedulingAgentId: review.schedulingAgentId,
   });

package/src/impl/couch/CouchDBSyncStrategy.ts

@@ -32,6 +32,16 @@ export class CouchDBSyncStrategy implements SyncStrategy {
     }
   }
 
+  getWriteDB(username: string): PouchDB.Database {
+    if (username === GuestUsername || username.startsWith(GuestUsername)) {
+      // Guest users write to local database
+      return getLocalUserDB(username);
+    } else {
+      // Authenticated users write to remote (which will sync to local)
+      return this.getUserDB(username);
+    }
+  }
+
   startSync(localDB: PouchDB.Database, remoteDB: PouchDB.Database): void {
     // Only sync if local and remote are different instances
     if (localDB !== remoteDB) {