formatferry 0.1.3 → 1.0.0

package/dist/packages/cli/src/commands/convert.js

@@ -0,0 +1,198 @@
+/**
+ * CLI convert command
+ *
+ * Handles stdin → stdout, file input, file output, format selection,
+ * and binary file processing (DOCX, PDF, XLSX/CSV).
+ *
+ * Requirements: 7.3, 7.4, 7.5, 7.6, 7.7, 7.10, 11.1, 11.2, 11.3, 11.5
+ */
+import { readFileSync, writeFileSync } from 'fs';
+import { extname } from 'path';
+import { ConversionEngine } from '../../../../src/shared/conversion-engine.js';
+import { docxAdapter } from '../../../../src/shared/adapters/docx-adapter.js';
+import { pdfAdapter } from '../../../../src/shared/adapters/pdf-adapter.js';
+import { spreadsheetAdapter } from '../../../../src/shared/adapters/spreadsheet-adapter.js';
+import { sanitizeHTML, normalizeAtlassianHTML } from '../../../../src/shared/input-sanitizer.js';
+import { isAtlassianHTML } from '../../../../src/shared/atlassian-detector.js';
+import { resolveEntitlement } from '../entitlement.js';
+/** Valid markdown format values */
+const VALID_FORMATS = [
+    'github',
+    'commonmark',
+    'discord',
+    'reddit',
+    'rmarkdown',
+];
+/**
+ * Detect input type from file extension.
+ * Writes error to stderr and exits with code 1 on unsupported extension.
+ */
+export function detectInputType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const map = {
+        '.html': 'html',
+        '.htm': 'html',
+        '.docx': 'docx',
+        '.pdf': 'pdf',
+        '.xlsx': 'xlsx',
+        '.csv': 'csv',
+    };
+    const type = map[ext];
+    if (!type) {
+        process.stderr.write(`Unsupported file type: ${ext}\nSupported: .html, .htm, .docx, .pdf, .xlsx, .csv\n`);
+        process.exit(1);
+    }
+    return type;
+}
+/**
+ * Validate the --format flag value.
+ * Writes error to stderr and exits with code 1 on unknown format.
+ */
+export function validateFormat(format) {
+    if (VALID_FORMATS.includes(format)) {
+        return format;
+    }
+    process.stderr.write(`Unknown format: "${format}"\nSupported formats: ${VALID_FORMATS.join(', ')}\n`);
+    process.exit(1);
+}
+/**
+ * Read all data from stdin as a string.
+ */
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => { data += chunk; });
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', reject);
+    });
+}
+/**
+ * Convert HTML string to Markdown using ConversionEngine.
+ * Applies Atlassian normalization if the HTML is Atlassian and the user has the feature.
+ * Req 2.3, 2.4
+ */
+async function htmlToMarkdown(html, format, applyAtlassianNormalization = false) {
+    const processedHtml = applyAtlassianNormalization ? normalizeAtlassianHTML(html) : html;
+    const engine = new ConversionEngine();
+    const result = await engine.convert(processedHtml, {
+        format,
+        preserveTables: true,
+        preserveLists: true,
+        customRules: [],
+    });
+    return result.markdown;
+}
+/**
+ * Convert a binary file (DOCX/PDF/XLSX/CSV) buffer to Markdown.
+ * Req 11.1, 11.2, 11.3, 11.5
+ */
+async function binaryToMarkdown(buffer, type, format) {
+    // Convert Buffer → ArrayBuffer (Req 11.5: read as Buffer, not UTF-8)
+    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    const engine = new ConversionEngine();
+    switch (type) {
+        case 'docx': {
+            // Req 11.1: use mammoth integration
+            const result = await docxAdapter.parseToHtml(arrayBuffer);
+            const sanitized = sanitizeHTML(result.html);
+            const converted = await engine.convert(sanitized, {
+                format,
+                preserveTables: true,
+                preserveLists: true,
+                customRules: [],
+            });
+            return converted.markdown;
+        }
+        case 'pdf': {
+            // Req 11.2: use pdfjs-dist integration
+            const result = await pdfAdapter.parseToText(arrayBuffer);
+            const sanitized = sanitizeHTML(result.html);
+            const converted = await engine.convert(sanitized, {
+                format,
+                preserveTables: true,
+                preserveLists: true,
+                customRules: [],
+            });
+            return converted.markdown;
+        }
+        case 'xlsx':
+        case 'csv': {
+            // Req 11.3: use spreadsheet processing
+            const result = await spreadsheetAdapter.parseToHtml(arrayBuffer, type, 0);
+            const sanitized = sanitizeHTML(result.html);
+            const converted = await engine.convert(sanitized, {
+                format,
+                preserveTables: true,
+                preserveLists: true,
+                customRules: [],
+            });
+            return converted.markdown;
+        }
+    }
+}
+/**
+ * Main convert command action.
+ * Called by Commander when the user runs `formatferry [options]`.
+ */
+export async function convertCommand(options) {
+    // Validate format (default: github)
+    const format = validateFormat(options.format ?? 'github');
+    let markdown;
+    if (options.input) {
+        // File input mode (Req 7.4, 7.10)
+        let fileBuffer;
+        try {
+            fileBuffer = readFileSync(options.input);
+        }
+        catch {
+            process.stderr.write(`Error: Cannot read file "${options.input}"\n`);
+            process.exit(1);
+        }
+        const inputType = detectInputType(options.input);
+        if (inputType === 'html') {
+            // Text file — decode as UTF-8
+            const html = fileBuffer.toString('utf8');
+            // Req 2.3, 2.4: Atlassian entitlement check
+            let applyAtlassian = false;
+            if (isAtlassianHTML(html)) {
+                const provider = await resolveEntitlement();
+                if (!provider.hasFeature('atlassian')) {
+                    process.stderr.write('Error: Atlassian HTML detected. A Premium license is required to process Atlassian content.\n' +
+                        'Run `formatferry auth --license-key <KEY>` to activate your license.\n');
+                    process.exit(1);
+                }
+                applyAtlassian = true;
+            }
+            markdown = await htmlToMarkdown(html, format, applyAtlassian);
+        }
+        else {
+            // Binary file — pass Buffer directly (Req 11.5)
+            markdown = await binaryToMarkdown(fileBuffer, inputType, format);
+        }
+    }
+    else {
+        // Stdin mode (Req 7.3)
+        const html = await readStdin();
+        // Req 2.3, 2.4: Atlassian entitlement check for stdin
+        let applyAtlassian = false;
+        if (isAtlassianHTML(html)) {
+            const provider = await resolveEntitlement();
+            if (!provider.hasFeature('atlassian')) {
+                process.stderr.write('Error: Atlassian HTML detected. A Premium license is required to process Atlassian content.\n' +
+                    'Run `formatferry auth --license-key <KEY>` to activate your license.\n');
+                process.exit(1);
+            }
+            applyAtlassian = true;
+        }
+        markdown = await htmlToMarkdown(html, format, applyAtlassian);
+    }
+    // Output (Req 7.5)
+    if (options.output) {
+        writeFileSync(options.output, markdown, 'utf8');
+    }
+    else {
+        process.stdout.write(markdown);
+    }
+}
+//# sourceMappingURL=convert.js.map

package/dist/packages/cli/src/commands/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../../../src/commands/convert.ts"],"names":[],"mappings":"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"}

package/dist/packages/cli/src/config-store.d.ts

@@ -0,0 +1,27 @@
+export declare let CONFIG_PATH: string;
+/** Override the config path (for testing only). */
+export declare function _setConfigPathForTesting(p: string): void;
+export interface StoredConfig {
+    licenseKey?: string;
+    tier?: 'free' | 'premium';
+    features?: string[];
+    expiresAt?: string | null;
+    lastValidated?: string;
+    apiKey?: string;
+}
+/**
+ * Read the stored config. Returns `null` if the file is missing or corrupted.
+ * Silently discards errors so the CLI always falls back to free tier (Req 10.7).
+ */
+export declare function readConfig(): StoredConfig | null;
+/**
+ * Persist config to disk. Creates parent directories as needed.
+ * Sets mode 0o600 on POSIX (owner read/write only) per Req 9.5.
+ */
+export declare function writeConfig(config: StoredConfig): void;
+/**
+ * Reset the config to an empty object (effectively clearing all stored values).
+ * Silently ignores errors (e.g. if the file doesn't exist yet).
+ */
+export declare function clearConfig(): void;
+//# sourceMappingURL=config-store.d.ts.map

package/dist/packages/cli/src/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../../../src/config-store.ts"],"names":[],"mappings":"AAsBA,eAAO,IAAI,WAAW,QAAgC,CAAC;AAEvD,mDAAmD;AACnD,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,GAAG,IAAI,CAOhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAKlC"}

package/dist/packages/cli/src/config-store.js

@@ -0,0 +1,58 @@
+/**
+ * Cross-platform config store for FormatFerry CLI.
+ *
+ * Config path:
+ *   - POSIX: ~/.config/formatferry/config.json  (Req 9.2)
+ *   - Windows: %APPDATA%\formatferry\config.json (Req 9.2)
+ *
+ * File permissions:
+ *   - POSIX: 0o600 (owner read/write only) (Req 9.5)
+ *   - Windows: 0o600 is silently ignored by Node.js — security relies on
+ *     %APPDATA% being inside the user's profile directory, which is protected
+ *     by Windows NTFS user account ACLs. No additional code is needed.
+ *
+ * Corrupted or missing config → returns null → Free tier (Req 10.7)
+ */
+import envPaths from 'env-paths';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+const paths = envPaths('formatferry', { suffix: '' });
+// Exported so tests can override via module-level patching
+export let CONFIG_PATH = `${paths.config}/config.json`;
+/** Override the config path (for testing only). */
+export function _setConfigPathForTesting(p) {
+    CONFIG_PATH = p;
+}
+/**
+ * Read the stored config. Returns `null` if the file is missing or corrupted.
+ * Silently discards errors so the CLI always falls back to free tier (Req 10.7).
+ */
+export function readConfig() {
+    try {
+        const raw = readFileSync(CONFIG_PATH, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null; // Missing or corrupted → Free tier
+    }
+}
+/**
+ * Persist config to disk. Creates parent directories as needed.
+ * Sets mode 0o600 on POSIX (owner read/write only) per Req 9.5.
+ */
+export function writeConfig(config) {
+    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+/**
+ * Reset the config to an empty object (effectively clearing all stored values).
+ * Silently ignores errors (e.g. if the file doesn't exist yet).
+ */
+export function clearConfig() {
+    try {
+        mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+        writeFileSync(CONFIG_PATH, '{}', { mode: 0o600 });
+    }
+    catch { /* ignore */ }
+}
+//# sourceMappingURL=config-store.js.map

package/dist/packages/cli/src/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../../../src/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAEtD,2DAA2D;AAC3D,MAAM,CAAC,IAAI,WAAW,GAAG,GAAG,KAAK,CAAC,MAAM,cAAc,CAAC;AAEvD,mDAAmD;AACnD,MAAM,UAAU,wBAAwB,CAAC,CAAS;IAChD,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,aAAa,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;AAC1B,CAAC"}

package/dist/packages/cli/src/entitlement.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI startup license validation with caching (Design §5.5)
+ * Validates: Requirements 10.1–10.7
+ */
+import { type EntitlementProvider } from '../../../src/shared/entitlement-service.js';
+/**
+ * Resolve the entitlement provider for the current CLI session.
+ * Called once at CLI startup before any command runs.
+ */
+export declare function resolveEntitlement(): Promise<EntitlementProvider>;
+//# sourceMappingURL=entitlement.d.ts.map

package/dist/packages/cli/src/entitlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.d.ts","sourceRoot":"","sources":["../../../../src/entitlement.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAGL,KAAK,mBAAmB,EAGzB,MAAM,4CAA4C,CAAC;AAepD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA0FvE"}

package/dist/packages/cli/src/entitlement.js

@@ -0,0 +1,91 @@
+/**
+ * CLI startup license validation with caching (Design §5.5)
+ * Validates: Requirements 10.1–10.7
+ */
+import { readConfig, writeConfig, clearConfig } from './config-store.js';
+import { FreeEntitlementProvider, CachedEntitlementProvider, } from '../../../src/shared/entitlement-service.js';
+const LICENSE_SERVER_URL = 'https://formatferry.vibingfun.com';
+const VALIDATE_ENDPOINT = `${LICENSE_SERVER_URL}/v1/licenses/validate`;
+const STARTUP_TIMEOUT_MS = 2_000;
+const STALE_CACHE_DAYS = 7;
+/**
+ * Resolve the entitlement provider for the current CLI session.
+ * Called once at CLI startup before any command runs.
+ */
+export async function resolveEntitlement() {
+    // Req 10.7: Corrupted ConfigStore → silently discard, free tier
+    let config;
+    try {
+        config = readConfig();
+    }
+    catch {
+        return new FreeEntitlementProvider();
+    }
+    if (!config || !config.licenseKey) {
+        return new FreeEntitlementProvider();
+    }
+    const { licenseKey, lastValidated } = config;
+    // Req 10.1: Ping License Server with 2s timeout
+    let data = null;
+    let networkError = false;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), STARTUP_TIMEOUT_MS);
+        const response = await fetch(VALIDATE_ENDPOINT, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ key: licenseKey }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        data = (await response.json());
+    }
+    catch {
+        networkError = true;
+    }
+    if (!networkError && data !== null) {
+        // Req 10.6: Revoked → delete key, downgrade to free
+        if (data.revoked) {
+            clearConfig();
+            return new FreeEntitlementProvider();
+        }
+        if (!data.valid) {
+            return new FreeEntitlementProvider();
+        }
+        // Req 10.2 + 10.4: valid → update cache with fresh data + ISO 8601 timestamp
+        const freshState = {
+            tier: data.tier ?? 'premium',
+            features: (data.features ?? []),
+            expiresAt: data.expiresAt ?? null,
+            lastValidated: new Date().toISOString(),
+        };
+        writeConfig({
+            ...config,
+            tier: freshState.tier,
+            features: freshState.features,
+            expiresAt: freshState.expiresAt,
+            lastValidated: freshState.lastValidated,
+        });
+        return new CachedEntitlementProvider(freshState);
+    }
+    // Req 10.3 + 10.5: Network error/timeout — check cache age
+    const cacheAgeMs = lastValidated
+        ? Date.now() - new Date(lastValidated).getTime()
+        : Infinity;
+    const staleCacheMs = STALE_CACHE_DAYS * 24 * 60 * 60 * 1000;
+    if (cacheAgeMs < staleCacheMs) {
+        // Req 10.3: Fresh cache → use cached entitlements
+        const cachedState = {
+            tier: config.tier ?? 'free',
+            features: (config.features ?? []),
+            expiresAt: config.expiresAt ?? null,
+            lastValidated: lastValidated ?? '',
+        };
+        return new CachedEntitlementProvider(cachedState);
+    }
+    // Req 10.5: Stale cache + unreachable → warn stderr, free tier
+    process.stderr.write('Warning: Could not reach license server and cached license is older than 7 days. ' +
+        'Operating in free tier. Please reconnect to validate your license.\n');
+    return new FreeEntitlementProvider();
+}
+//# sourceMappingURL=entitlement.js.map

package/dist/packages/cli/src/entitlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.js","sourceRoot":"","sources":["../../../../src/entitlement.ts"],"names":[],"mappings":"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"}

package/dist/packages/cli/src/index.d.ts

@@ -0,0 +1,2 @@
+import './shim.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/cli/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,CAAC"}

package/dist/packages/cli/src/index.js

@@ -0,0 +1,28 @@
+// Entry point — shim MUST be imported first to set up DOM globals before any shared modules
+import './shim.js';
+import { program } from 'commander';
+import { convertCommand } from './commands/convert.js';
+import { authCommand } from './commands/auth.js';
+// Version is read from package.json at build time
+const VERSION = '0.1.0';
+program
+    .name('formatferry')
+    .version(VERSION)
+    .description('Convert HTML, DOCX, PDF, XLSX to Markdown')
+    .option('-i, --input <path>', 'Input file path')
+    .option('-o, --output <path>', 'Output file path')
+    .option('-f, --format <format>', 'Markdown format (github, commonmark, discord, reddit, rmarkdown)', 'github')
+    .option('--url <url>', 'Fetch article from URL')
+    .option('--batch <glob>', 'Batch convert files (Premium)')
+    .option('--output-dir <dir>', 'Output directory for batch')
+    .action(convertCommand);
+// Auth subcommand
+program
+    .command('auth')
+    .description('Manage license key authentication')
+    .option('--license-key <key>', 'Activate a license key')
+    .option('--status', 'Show current license status')
+    .option('--logout', 'Remove stored license key')
+    .action(authCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/packages/cli/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,kDAAkD;AAClD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;KACjD,MAAM,CAAC,uBAAuB,EAAE,kEAAkE,EAAE,QAAQ,CAAC;KAC7G,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC;KAC/C,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;KACzD,MAAM,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;KAC1D,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,kBAAkB;AAClB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;KACvD,MAAM,CAAC,UAAU,EAAE,6BAA6B,CAAC;KACjD,MAAM,CAAC,UAAU,EAAE,2BAA2B,CAAC;KAC/C,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/packages/cli/src/shim.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shim.d.ts.map

package/dist/packages/cli/src/shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.d.ts","sourceRoot":"","sources":["../../../../src/shim.ts"],"names":[],"mappings":""}

package/dist/packages/cli/src/shim.js

@@ -0,0 +1,21 @@
+/**
+ * Global DOM shim for Node.js CLI context.
+ *
+ * This file MUST be imported as the very first import in index.ts.
+ * It assigns linkedom-backed globals to satisfy third-party libraries
+ * (e.g. turndown) that contain hardcoded checks for window.document.
+ *
+ * Compatibility outcome (Task 5.4): linkedom compatible.
+ * Smoke test (src/tests/shim-smoke.test.ts) confirmed that linkedom-backed
+ * globals satisfy turndown and DOMPurify without errors. No jsdom fallback needed.
+ */
+import { parseHTML } from 'linkedom';
+const { document, window } = parseHTML('<!DOCTYPE html><html><body></body></html>');
+// Satisfy turndown's hardcoded window.document checks
+globalThis.window = window;
+globalThis.document = document;
+globalThis.DOMParser = window.DOMParser;
+globalThis.Node = window.Node;
+globalThis.HTMLElement = window.HTMLElement;
+globalThis.HTMLTableElement = window.HTMLTableElement;
+//# sourceMappingURL=shim.js.map

package/dist/packages/cli/src/shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.js","sourceRoot":"","sources":["../../../../src/shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,2CAA2C,CAAC,CAAC;AAEpF,sDAAsD;AACrD,UAAsC,CAAC,MAAM,GAAG,MAAM,CAAC;AACvD,UAAsC,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC3D,UAAsC,CAAC,SAAS,GAAI,MAA4C,CAAC,SAAS,CAAC;AAC3G,UAAsC,CAAC,IAAI,GAAI,MAAuC,CAAC,IAAI,CAAC;AAC5F,UAAsC,CAAC,WAAW,GAAI,MAA8C,CAAC,WAAW,CAAC;AACjH,UAAsC,CAAC,gBAAgB,GAAI,MAAmD,CAAC,gBAAgB,CAAC"}

package/dist/shim.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shim.d.ts.map

package/dist/shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.d.ts","sourceRoot":"","sources":["../src/shim.ts"],"names":[],"mappings":""}

package/dist/shim.js

@@ -0,0 +1,21 @@
+/**
+ * Global DOM shim for Node.js CLI context.
+ *
+ * This file MUST be imported as the very first import in index.ts.
+ * It assigns linkedom-backed globals to satisfy third-party libraries
+ * (e.g. turndown) that contain hardcoded checks for window.document.
+ *
+ * Compatibility outcome (Task 5.4): linkedom compatible.
+ * Smoke test (src/tests/shim-smoke.test.ts) confirmed that linkedom-backed
+ * globals satisfy turndown and DOMPurify without errors. No jsdom fallback needed.
+ */
+import { parseHTML } from 'linkedom';
+const { document, window } = parseHTML('<!DOCTYPE html><html><body></body></html>');
+// Satisfy turndown's hardcoded window.document checks
+globalThis.window = window;
+globalThis.document = document;
+globalThis.DOMParser = window.DOMParser;
+globalThis.Node = window.Node;
+globalThis.HTMLElement = window.HTMLElement;
+globalThis.HTMLTableElement = window.HTMLTableElement;
+//# sourceMappingURL=shim.js.map

package/dist/shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.js","sourceRoot":"","sources":["../src/shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,2CAA2C,CAAC,CAAC;AAEpF,sDAAsD;AACrD,UAAsC,CAAC,MAAM,GAAG,MAAM,CAAC;AACvD,UAAsC,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC3D,UAAsC,CAAC,SAAS,GAAI,MAA4C,CAAC,SAAS,CAAC;AAC3G,UAAsC,CAAC,IAAI,GAAI,MAAuC,CAAC,IAAI,CAAC;AAC5F,UAAsC,CAAC,WAAW,GAAI,MAA8C,CAAC,WAAW,CAAC;AACjH,UAAsC,CAAC,gBAAgB,GAAI,MAAmD,CAAC,gBAAgB,CAAC"}

package/dist/src/shared/adapters/docx-adapter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * DOCX Adapter Module
+ *
+ * Converts DOCX files to HTML using Mammoth.js for processing through
+ * the existing ConversionEngine pipeline.
+ *
+ * Requirements: 1.1, 1.3, 1.4, 1.5, 1.6
+ */
+/** Image reference extracted from DOCX */
+export interface ImageReference {
+    /** Original filename from the DOCX */
+    filename: string;
+    /** Image width in pixels (if available) */
+    width?: number;
+    /** Image height in pixels (if available) */
+    height?: number;
+    /** Alt text from the document */
+    altText?: string;
+    /** Content type (e.g., 'image/png') */
+    contentType?: string;
+}
+/** Document metadata extracted from DOCX */
+export interface DocumentMetadata {
+    /** Document title (if available) */
+    title?: string;
+    /** Document author (if available) */
+    author?: string;
+    /** Number of images in the document */
+    imageCount: number;
+}
+/** Result of parsing a DOCX file */
+export interface DocxParseResult {
+    /** HTML content extracted from the DOCX */
+    html: string;
+    /** Images found in the document */
+    images: ImageReference[];
+    /** Document metadata */
+    metadata: DocumentMetadata;
+    /** Any warnings generated during parsing */
+    warnings: string[];
+}
+/** Error thrown when DOCX parsing fails */
+export declare class DocxParseError extends Error {
+    readonly code: 'CORRUPTED' | 'INVALID_FORMAT' | 'PARSE_ERROR';
+    readonly originalError?: Error | undefined;
+    constructor(message: string, code: 'CORRUPTED' | 'INVALID_FORMAT' | 'PARSE_ERROR', originalError?: Error | undefined);
+}
+/**
+ * Reset image counter (primarily for testing)
+ */
+export declare function resetImageCounter(): void;
+/**
+ * DOCX Adapter class
+ *
+ * Handles conversion of DOCX files to HTML using Mammoth.js.
+ * Images are converted to placeholder text rather than base64 data
+ * to keep output clean and avoid bloating the markdown.
+ */
+export declare class DocxAdapter {
+    private mammoth;
+    /**
+     * Load the Mammoth library if not already loaded
+     */
+    private ensureMammothLoaded;
+    /**
+     * Parse a DOCX file and convert it to HTML
+     *
+     * @param arrayBuffer - The DOCX file content as an ArrayBuffer
+     * @returns Promise resolving to the parse result with HTML and metadata
+     * @throws DocxParseError if the file cannot be parsed
+     */
+    parseToHtml(arrayBuffer: ArrayBuffer): Promise<DocxParseResult>;
+    /**
+     * Extract raw text from a DOCX file (without formatting)
+     *
+     * @param arrayBuffer - The DOCX file content as an ArrayBuffer
+     * @returns Promise resolving to the raw text content
+     */
+    extractRawText(arrayBuffer: ArrayBuffer): Promise<string>;
+}
+/**
+ * Singleton instance for convenience
+ */
+export declare const docxAdapter: DocxAdapter;
+//# sourceMappingURL=docx-adapter.d.ts.map

package/dist/src/shared/adapters/docx-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/shared/adapters/docx-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2CAA2C;AAC3C,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,WAAW,GAAG,gBAAgB,GAAG,aAAa;aACpD,aAAa,CAAC,EAAE,KAAK;gBAFrC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,WAAW,GAAG,gBAAgB,GAAG,aAAa,EACpD,aAAa,CAAC,EAAE,KAAK,YAAA;CAKxC;AAOD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA2B;IAE1C;;OAEG;YACW,mBAAmB;IAOjC;;;;;;OAMG;IACG,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAsHrE;;;;;OAKG;IACG,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAehE;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC"}