@learnpack/learnpack 5.0.297 → 5.0.300

package/src/utils/export/README.md

@@ -1,178 +1,178 @@
-# Export Utilities
-
-This directory contains utilities for exporting courses to different formats.
-
-## Supported Formats
-
-- **SCORM**: Learning Management System compatible package
-- **EPUB**: E-book format for offline reading
-
-## Usage
-
-### API Endpoints
-
-The export functionality is available through the `/export/:course_slug/:format` endpoint:
-
-- `GET /export/{course_slug}/scorm` - Export course to SCORM format
-- `GET /export/{course_slug}/epub` - Export course to EPUB format
-
-### Example Usage
-
-```bash
-# Export course to SCORM
-curl -O "http://localhost:3000/export/my-course/scorm"
-
-# Export course to EPUB (default English)
-curl -O "http://localhost:3000/export/my-course/epub"
-
-# Export course to EPUB in Spanish
-curl -O "http://localhost:3000/export/my-course/epub?language=es"
-
-# Export course to EPUB in French
-curl -O "http://localhost:3000/export/my-course/epub?language=fr"
-```
-
-## Requirements
-
-### SCORM Export
-
-- No additional requirements
-
-### EPUB Export
-
-- **Pandoc** must be installed on the system
-- Pandoc is used to convert markdown to HTML and generate EPUB files
-- **Language Support**: Use the `language` query parameter to specify the language
-  - Default: `en` (English)
-  - The system will prioritize language-specific files (e.g., `README.es.md` for Spanish)
-  - Falls back to `README.md` if no language-specific file is found
-
-### Installing Pandoc
-
-#### Windows
-
-```bash
-# Using Chocolatey
-choco install pandoc
-
-# Using Scoop
-scoop install pandoc
-
-# Or download from https://pandoc.org/installing.html
-```
-
-#### macOS
-
-```bash
-# Using Homebrew
-brew install pandoc
-
-# Using MacPorts
-sudo port install pandoc
-```
-
-#### Linux
-
-```bash
-# Ubuntu/Debian
-sudo apt-get install pandoc
-
-# CentOS/RHEL
-sudo yum install pandoc
-
-# Arch Linux
-sudo pacman -S pandoc
-```
-
-## Architecture
-
-The export system is modular and consists of:
-
-- **`types.ts`**: Type definitions for export options and course metadata
-- **`shared.ts`**: Common utility functions used by all export formats
-- **`scorm.ts`**: SCORM export implementation
-- **`epub.ts`**: EPUB export implementation using Pandoc
-- **`index.ts`**: Main export interface
-
-## Adding New Export Formats
-
-To add a new export format:
-
-1. Create a new file in the export directory (e.g., `pdf.ts`)
-2. Implement the export function following the same pattern
-3. Add the new format to the `ExportFormat` type in `types.ts`
-4. Update the main export endpoint in `serve.ts`
-5. Add the new format to the export index
-
-### Example New Format
-
-```typescript
-// pdf.ts
-export async function exportToPdf(options: ExportOptions): Promise<string> {
-  // Implementation here
-  return outputPath;
-}
-
-// types.ts
-export type ExportFormat = 'scorm' | 'epub' | 'pdf';
-
-// serve.ts
-} else if (format === "pdf") {
-  outputPath = await exportToPdf({
-    courseSlug: course_slug,
-    format: "pdf",
-    bucket,
-    outDir: path.join(__dirname, "../output/directory")
-  });
-  filename = `${course_slug}.pdf`;
-}
-```
-
-## File Structure
-
-```
-src/utils/export/
-├── index.ts          # Main export interface
-├── types.ts          # Type definitions
-├── shared.ts         # Shared utilities
-├── scorm.ts          # SCORM export
-├── epub.ts           # EPUB export
-├── templates/        # Export templates
-│   ├── scorm/        # SCORM template files
-│   └── epub/         # EPUB template files
-└── README.md         # This file
-```
-
-## Templates
-
-### SCORM Template
-
-Contains the necessary files for a SCORM package:
-
-- `imsmanifest.xml` - Course manifest
-- `config/` - Configuration files
-- XSD schema files for validation
-
-### EPUB Template
-
-Contains styling and assets for EPUB generation:
-
-- `epub.css` - Basic EPUB styling
-- `cover.png` - Default cover image (placeholder)
-
-## Error Handling
-
-The export system includes comprehensive error handling:
-
-- Invalid format validation
-- File system operation errors
-- Pandoc execution errors (for EPUB)
-- Network/download errors
-- Cleanup on failure
-
-## Performance Considerations
-
-- Temporary files are automatically cleaned up
-- Large courses may take time to process
-- Consider implementing progress indicators for long-running exports
-- Memory usage scales with course size
+# Export Utilities
+
+This directory contains utilities for exporting courses to different formats.
+
+## Supported Formats
+
+- **SCORM**: Learning Management System compatible package
+- **EPUB**: E-book format for offline reading
+
+## Usage
+
+### API Endpoints
+
+The export functionality is available through the `/export/:course_slug/:format` endpoint:
+
+- `GET /export/{course_slug}/scorm` - Export course to SCORM format
+- `GET /export/{course_slug}/epub` - Export course to EPUB format
+
+### Example Usage
+
+```bash
+# Export course to SCORM
+curl -O "http://localhost:3000/export/my-course/scorm"
+
+# Export course to EPUB (default English)
+curl -O "http://localhost:3000/export/my-course/epub"
+
+# Export course to EPUB in Spanish
+curl -O "http://localhost:3000/export/my-course/epub?language=es"
+
+# Export course to EPUB in French
+curl -O "http://localhost:3000/export/my-course/epub?language=fr"
+```
+
+## Requirements
+
+### SCORM Export
+
+- No additional requirements
+
+### EPUB Export
+
+- **Pandoc** must be installed on the system
+- Pandoc is used to convert markdown to HTML and generate EPUB files
+- **Language Support**: Use the `language` query parameter to specify the language
+  - Default: `en` (English)
+  - The system will prioritize language-specific files (e.g., `README.es.md` for Spanish)
+  - Falls back to `README.md` if no language-specific file is found
+
+### Installing Pandoc
+
+#### Windows
+
+```bash
+# Using Chocolatey
+choco install pandoc
+
+# Using Scoop
+scoop install pandoc
+
+# Or download from https://pandoc.org/installing.html
+```
+
+#### macOS
+
+```bash
+# Using Homebrew
+brew install pandoc
+
+# Using MacPorts
+sudo port install pandoc
+```
+
+#### Linux
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install pandoc
+
+# CentOS/RHEL
+sudo yum install pandoc
+
+# Arch Linux
+sudo pacman -S pandoc
+```
+
+## Architecture
+
+The export system is modular and consists of:
+
+- **`types.ts`**: Type definitions for export options and course metadata
+- **`shared.ts`**: Common utility functions used by all export formats
+- **`scorm.ts`**: SCORM export implementation
+- **`epub.ts`**: EPUB export implementation using Pandoc
+- **`index.ts`**: Main export interface
+
+## Adding New Export Formats
+
+To add a new export format:
+
+1. Create a new file in the export directory (e.g., `pdf.ts`)
+2. Implement the export function following the same pattern
+3. Add the new format to the `ExportFormat` type in `types.ts`
+4. Update the main export endpoint in `serve.ts`
+5. Add the new format to the export index
+
+### Example New Format
+
+```typescript
+// pdf.ts
+export async function exportToPdf(options: ExportOptions): Promise<string> {
+  // Implementation here
+  return outputPath;
+}
+
+// types.ts
+export type ExportFormat = 'scorm' | 'epub' | 'pdf';
+
+// serve.ts
+} else if (format === "pdf") {
+  outputPath = await exportToPdf({
+    courseSlug: course_slug,
+    format: "pdf",
+    bucket,
+    outDir: path.join(__dirname, "../output/directory")
+  });
+  filename = `${course_slug}.pdf`;
+}
+```
+
+## File Structure
+
+```
+src/utils/export/
+├── index.ts          # Main export interface
+├── types.ts          # Type definitions
+├── shared.ts         # Shared utilities
+├── scorm.ts          # SCORM export
+├── epub.ts           # EPUB export
+├── templates/        # Export templates
+│   ├── scorm/        # SCORM template files
+│   └── epub/         # EPUB template files
+└── README.md         # This file
+```
+
+## Templates
+
+### SCORM Template
+
+Contains the necessary files for a SCORM package:
+
+- `imsmanifest.xml` - Course manifest
+- `config/` - Configuration files
+- XSD schema files for validation
+
+### EPUB Template
+
+Contains styling and assets for EPUB generation:
+
+- `epub.css` - Basic EPUB styling
+- `cover.png` - Default cover image (placeholder)
+
+## Error Handling
+
+The export system includes comprehensive error handling:
+
+- Invalid format validation
+- File system operation errors
+- Pandoc execution errors (for EPUB)
+- Network/download errors
+- Cleanup on failure
+
+## Performance Considerations
+
+- Temporary files are automatically cleaned up
+- Large courses may take time to process
+- Consider implementing progress indicators for long-running exports
+- Memory usage scales with course size

package/src/utils/incrementVersion.js

@@ -1,74 +1,74 @@
-const fs = require("fs")
-const path = require("path")
-const readline = require("readline")
-
-// Get command-line arguments
-const args = process.argv.slice(2)
-const partIndex = args.findIndex(arg => arg === "-p" || arg === "--part")
-const part =
-  partIndex !== -1 && args[partIndex + 1] ?
-    args[partIndex + 1].toLowerCase() :
-    null
-
-const packagePath = path.resolve(process.cwd(), "package.json")
-
-try {
-  // Read package.json file
-  const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"))
-
-  // Check if "version" field exists
-  if (!packageJson.version) {
-    throw new Error(
-      'El archivo package.json no contiene una propiedad "version".'
-    )
-  }
-
-  const [major, minor, patch] = packageJson.version.split(".").map(Number)
-
-  // Function to update version
-  const updateVersion = part => {
-    let newVersion
-    switch (part) {
-      case "major":
-        newVersion = `${major + 1}.0.0`
-        break
-      case "minor":
-        newVersion = `${major}.${minor + 1}.0`
-        break
-      case "patch":
-        newVersion = `${major}.${minor}.${patch + 1}`
-        break
-      default:
-        console.error("Opción no válida. Usa: major, minor o patch.")
-        process.exit(1)
-    }
-
-    // Update package.json
-    packageJson.version = newVersion
-    fs.writeFileSync(packagePath, JSON.stringify(packageJson, null, 2), "utf8")
-
-    console.log(`Versión actualizada: ${packageJson.version} -> ${newVersion}`)
-  }
-
-  if (part) {
-    // If flag is provided, update immediately
-    updateVersion(part)
-  } else {
-    // Otherwise, ask the user interactively
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-    })
-
-    rl.question(
-      "¿Qué parte de la versión deseas incrementar? (major, minor, patch): ",
-      answer => {
-        updateVersion(answer.toLowerCase())
-        rl.close()
-      }
-    )
-  }
-} catch (error) {
-  console.error(`Error: ${error.message}`)
-  process.exit(1)
-}
+const fs = require("fs")
+const path = require("path")
+const readline = require("readline")
+
+// Get command-line arguments
+const args = process.argv.slice(2)
+const partIndex = args.findIndex(arg => arg === "-p" || arg === "--part")
+const part =
+  partIndex !== -1 && args[partIndex + 1] ?
+    args[partIndex + 1].toLowerCase() :
+    null
+
+const packagePath = path.resolve(process.cwd(), "package.json")
+
+try {
+  // Read package.json file
+  const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf8"))
+
+  // Check if "version" field exists
+  if (!packageJson.version) {
+    throw new Error(
+      'El archivo package.json no contiene una propiedad "version".'
+    )
+  }
+
+  const [major, minor, patch] = packageJson.version.split(".").map(Number)
+
+  // Function to update version
+  const updateVersion = part => {
+    let newVersion
+    switch (part) {
+      case "major":
+        newVersion = `${major + 1}.0.0`
+        break
+      case "minor":
+        newVersion = `${major}.${minor + 1}.0`
+        break
+      case "patch":
+        newVersion = `${major}.${minor}.${patch + 1}`
+        break
+      default:
+        console.error("Opción no válida. Usa: major, minor o patch.")
+        process.exit(1)
+    }
+
+    // Update package.json
+    packageJson.version = newVersion
+    fs.writeFileSync(packagePath, JSON.stringify(packageJson, null, 2), "utf8")
+
+    console.log(`Versión actualizada: ${packageJson.version} -> ${newVersion}`)
+  }
+
+  if (part) {
+    // If flag is provided, update immediately
+    updateVersion(part)
+  } else {
+    // Otherwise, ask the user interactively
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    })
+
+    rl.question(
+      "¿Qué parte de la versión deseas incrementar? (major, minor, patch): ",
+      answer => {
+        updateVersion(answer.toLowerCase())
+        rl.close()
+      }
+    )
+  }
+} catch (error) {
+  console.error(`Error: ${error.message}`)
+  process.exit(1)
+}

package/src/utils/misc.ts

@@ -1,58 +1,58 @@
-export const prioritizeHTMLFile = (entryFiles: string[]) => {
-  let files = []
-
-  // Find the html file and put it as latest in the files array
-  // in order to keep the html file opened in vscode plugin
-  const index = entryFiles.findIndex(file => {
-    return /.*\.html$/.test(file)
-  })
-
-  if (index !== -1) {
-    for (const [i, entryFile] of entryFiles.entries()) {
-      if (i !== index) {
-        files.push(entryFile)
-      }
-    }
-
-    files.push(entryFiles[index])
-  } else {
-    files = entryFiles
-  }
-
-  return files
-}
-
-export function minutesToISO8601Duration(minutes: number): string {
-  if (minutes <= 0) 
-return "PT0M"
-
-  const weeks = Math.floor(minutes / (60 * 24 * 7))
-  minutes %= 60 * 24 * 7
-
-  const days = Math.floor(minutes / (60 * 24))
-  minutes %= 60 * 24
-
-  const hours = Math.floor(minutes / 60)
-  const mins = minutes % 60
-
-  let duration = "P"
-  if (weeks) 
-duration += `${weeks}W`
-  if (days) 
-duration += `${days}D`
-
-  if (hours || mins) 
-duration += "T"
-  if (hours) 
-duration += `${hours}H`
-  if (mins) 
-duration += `${mins}M`
-
-  return duration
-}
-
-export const createUploadMiddleware = () => {
-  // eslint-disable-next-line
-  const multer = require("multer")
-  return multer({ limits: { fileSize: 25 * 1024 * 1024 } })
-}
+export const prioritizeHTMLFile = (entryFiles: string[]) => {
+  let files = []
+
+  // Find the html file and put it as latest in the files array
+  // in order to keep the html file opened in vscode plugin
+  const index = entryFiles.findIndex(file => {
+    return /.*\.html$/.test(file)
+  })
+
+  if (index !== -1) {
+    for (const [i, entryFile] of entryFiles.entries()) {
+      if (i !== index) {
+        files.push(entryFile)
+      }
+    }
+
+    files.push(entryFiles[index])
+  } else {
+    files = entryFiles
+  }
+
+  return files
+}
+
+export function minutesToISO8601Duration(minutes: number): string {
+  if (minutes <= 0) 
+return "PT0M"
+
+  const weeks = Math.floor(minutes / (60 * 24 * 7))
+  minutes %= 60 * 24 * 7
+
+  const days = Math.floor(minutes / (60 * 24))
+  minutes %= 60 * 24
+
+  const hours = Math.floor(minutes / 60)
+  const mins = minutes % 60
+
+  let duration = "P"
+  if (weeks) 
+duration += `${weeks}W`
+  if (days) 
+duration += `${days}D`
+
+  if (hours || mins) 
+duration += "T"
+  if (hours) 
+duration += `${hours}H`
+  if (mins) 
+duration += `${mins}M`
+
+  return duration
+}
+
+export const createUploadMiddleware = () => {
+  // eslint-disable-next-line
+  const multer = require("multer")
+  return multer({ limits: { fileSize: 25 * 1024 * 1024 } })
+}