formatferry 1.0.1 → 1.0.2

package/dist/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/entitlement.js.map

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

package/dist/index.d.ts

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

package/dist/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/index.js

@@ -21128,7 +21128,7 @@ async function importXlsx() {
   return import("xlsx/dist/xlsx.mini.min.js");
 }
 async function importPdfjs() {
-  return import("pdfjs-dist");
+  return import("pdfjs-dist/legacy/build/pdf.mjs");
 }
 async function loadLibraryInternal(format) {
   try {
@@ -21160,7 +21160,7 @@ async function loadLibraryInternal(format) {
         try {
           library = await importPdfjs();
           const pdfjs = library;
-          if (pdfjs.GlobalWorkerOptions) {
+          if (pdfjs.GlobalWorkerOptions && (typeof process === "undefined" || !process.versions?.node)) {
             pdfjs.GlobalWorkerOptions.workerSrc = "/pdf.worker.min.mjs";
           }
         } catch {
@@ -21957,16 +21957,17 @@ function clearConfig() {
   }
 }
 
-// ../../src/shared/entitlement-service.ts
+// ../../src/shared/entitlement-service.js
 var FreeEntitlementProvider = class {
   getState() {
     return { tier: "free", features: [], expiresAt: null, lastValidated: "" };
   }
-  hasFeature(_feature) {
+  hasFeature() {
     return false;
   }
 };
 var CachedEntitlementProvider = class {
+  state;
   constructor(state) {
     this.state = state;
   }

package/dist/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/commands/auth.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI auth command — license key management.
+ *
+ * Sub-commands (via options):
+ *   formatferry auth --license-key <KEY>   Validate + store license key (Req 9.1, 9.3, 9.4)
+ *   formatferry auth --status              Show current tier/expiry/features (Req 9.6)
+ *   formatferry auth --logout              Remove stored license key (Req 9.7)
+ *
+ * License Server: POST https://formatferry.vibingfun.com/v1/licenses/validate
+ */
+export interface AuthOptions {
+    licenseKey?: string;
+    status?: boolean;
+    logout?: boolean;
+}
+export declare function authCommand(options: AuthOptions): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/packages/cli/src/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrE"}

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

@@ -0,0 +1,102 @@
+/**
+ * CLI auth command — license key management.
+ *
+ * Sub-commands (via options):
+ *   formatferry auth --license-key <KEY>   Validate + store license key (Req 9.1, 9.3, 9.4)
+ *   formatferry auth --status              Show current tier/expiry/features (Req 9.6)
+ *   formatferry auth --logout              Remove stored license key (Req 9.7)
+ *
+ * License Server: POST https://formatferry.vibingfun.com/v1/licenses/validate
+ */
+import { readConfig, writeConfig, clearConfig } from '../config-store.js';
+const LICENSE_SERVER_URL = 'https://formatferry.vibingfun.com';
+const VALIDATE_ENDPOINT = `${LICENSE_SERVER_URL}/v1/licenses/validate`;
+const TIMEOUT_MS = 10_000;
+export async function authCommand(options) {
+    if (options.licenseKey) {
+        await handleLicenseKey(options.licenseKey);
+    }
+    else if (options.status) {
+        handleStatus();
+    }
+    else if (options.logout) {
+        handleLogout();
+    }
+    else {
+        handleStatus();
+    }
+}
+// ─── --license-key ────────────────────────────────────────────────────────────
+async function handleLicenseKey(key) {
+    let data;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        const response = await fetch(VALIDATE_ENDPOINT, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ key }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        data = (await response.json());
+        if (!response.ok && !data.valid) {
+            process.stderr.write(`Error: Invalid license key. Please check your key and try again.\n`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: Could not reach license server — ${msg}\n`);
+        process.exit(1);
+    }
+    if (data.revoked) {
+        process.stderr.write(`Error: This license key has been revoked.\n`);
+        process.exit(1);
+    }
+    if (!data.valid) {
+        process.stderr.write(`Error: Invalid license key. Please check your key and try again.\n`);
+        process.exit(1);
+    }
+    writeConfig({
+        licenseKey: key,
+        tier: data.tier ?? 'premium',
+        features: data.features ?? [],
+        expiresAt: data.expiresAt ?? null,
+        lastValidated: new Date().toISOString(),
+    });
+    const features = data.features ?? [];
+    process.stdout.write(`License activated successfully!\n`);
+    process.stdout.write(`Tier: ${data.tier ?? 'premium'}\n`);
+    if (data.expiresAt) {
+        process.stdout.write(`Expires: ${data.expiresAt}\n`);
+    }
+    if (features.length > 0) {
+        process.stdout.write(`Unlocked features: ${features.join(', ')}\n`);
+    }
+}
+// ─── --status ─────────────────────────────────────────────────────────────────
+function handleStatus() {
+    const config = readConfig();
+    if (!config || !config.licenseKey) {
+        process.stdout.write(`Tier: free\n`);
+        process.stdout.write(`No license key configured.\n`);
+        return;
+    }
+    const tier = config.tier ?? 'free';
+    const features = config.features ?? [];
+    const expiresAt = config.expiresAt ?? null;
+    process.stdout.write(`Tier: ${tier}\n`);
+    if (expiresAt) {
+        process.stdout.write(`Expires: ${expiresAt}\n`);
+    }
+    if (features.length > 0) {
+        process.stdout.write(`Features: ${features.join(', ')}\n`);
+    }
+}
+// ─── --logout ─────────────────────────────────────────────────────────────────
+function handleLogout() {
+    clearConfig();
+    process.stdout.write(`Logged out. License key removed.\n`);
+}
+//# sourceMappingURL=auth.js.map

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

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

package/dist/packages/cli/src/commands/batch.d.ts

@@ -0,0 +1,10 @@
+export interface BatchOptions {
+    batch?: string;
+    outputDir?: string;
+    format?: string;
+    [key: string]: unknown;
+}
+/** Derive the output .md path. Req 8.2 (same dir) / Req 8.3 (outputDir) */
+export declare function getOutputPath(filePath: string, outputDir?: string): string;
+export declare function batchCommand(options: BatchOptions): Promise<void>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/packages/cli/src/commands/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../../../src/commands/batch.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAkCD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCvE"}

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

@@ -0,0 +1,92 @@
+/**
+ * CLI batch command
+ *
+ * Batch-converts files matching a glob pattern to Markdown.
+ * Supports --output-dir for writing all outputs to a single directory.
+ * Gated behind the 'batch' Premium entitlement.
+ *
+ * Requirements: 8.1, 8.2, 8.3, 8.4, 8.5, 8.6
+ */
+import fg from 'fast-glob';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { extname, basename, dirname, join } from 'path';
+import { resolveEntitlement } from '../entitlement.js';
+import { ConversionEngine } from '../../../../src/shared/conversion-engine.js';
+import { sanitizeHTML } from '../../../../src/shared/input-sanitizer.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';
+const SUPPORTED_EXTENSIONS = new Set(['.html', '.htm', '.docx', '.pdf', '.xlsx', '.csv']);
+/** Derive the output .md path. Req 8.2 (same dir) / Req 8.3 (outputDir) */
+export function getOutputPath(filePath, outputDir) {
+    const ext = extname(filePath);
+    const stem = basename(filePath, ext);
+    if (outputDir)
+        return join(outputDir, `${stem}.md`);
+    return join(dirname(filePath), `${stem}.md`);
+}
+async function convertFile(filePath, format) {
+    const ext = extname(filePath).toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.has(ext))
+        throw new Error(`Unsupported file type: ${ext}`);
+    const buffer = readFileSync(filePath);
+    const engine = new ConversionEngine();
+    if (ext === '.html' || ext === '.htm') {
+        const result = await engine.convert(sanitizeHTML(buffer.toString('utf8')), {
+            format, preserveTables: true, preserveLists: true, customRules: [],
+        });
+        return result.markdown;
+    }
+    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    if (ext === '.docx') {
+        const r = await docxAdapter.parseToHtml(arrayBuffer);
+        const c = await engine.convert(sanitizeHTML(r.html), { format, preserveTables: true, preserveLists: true, customRules: [] });
+        return c.markdown;
+    }
+    if (ext === '.pdf') {
+        const r = await pdfAdapter.parseToText(arrayBuffer);
+        const c = await engine.convert(sanitizeHTML(r.html), { format, preserveTables: true, preserveLists: true, customRules: [] });
+        return c.markdown;
+    }
+    // .xlsx / .csv
+    const r = await spreadsheetAdapter.parseToHtml(arrayBuffer, ext.slice(1), 0);
+    const c = await engine.convert(sanitizeHTML(r.html), { format, preserveTables: true, preserveLists: true, customRules: [] });
+    return c.markdown;
+}
+export async function batchCommand(options) {
+    // Req 8.4: entitlement check
+    const provider = await resolveEntitlement();
+    if (!provider.hasFeature('batch')) {
+        process.stderr.write('Error: Batch processing requires a Premium license.\n' +
+            'Run `formatferry auth --license-key <KEY>` to activate your license.\n');
+        process.exit(1);
+    }
+    const glob = options.batch;
+    if (!glob) {
+        process.stderr.write('Error: --batch <glob> is required\n');
+        process.exit(1);
+    }
+    const files = await fg(glob, { absolute: true });
+    if (files.length === 0) {
+        process.stderr.write(`No files matched: ${glob}\n`);
+        process.exit(1);
+    }
+    const format = options.format ?? 'github';
+    if (options.outputDir)
+        mkdirSync(options.outputDir, { recursive: true });
+    let successful = 0, failed = 0;
+    for (const filePath of files) {
+        try {
+            const markdown = await convertFile(filePath, format);
+            writeFileSync(getOutputPath(filePath, options.outputDir), markdown, 'utf8');
+            successful++;
+        }
+        catch (err) {
+            process.stderr.write(`Error processing ${filePath}: ${err instanceof Error ? err.message : String(err)}\n`);
+            failed++;
+        }
+    }
+    // Req 8.5: summary
+    process.stderr.write(`\nBatch complete: ${successful} succeeded, ${failed} failed, ${files.length} total\n`);
+}
+//# sourceMappingURL=batch.js.map

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

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

package/dist/packages/cli/src/commands/convert.d.ts

@@ -0,0 +1,26 @@
+import { type MarkdownFormat } from '../../../../src/shared/conversion-engine.js';
+/** Supported input file types */
+type InputType = 'html' | 'docx' | 'pdf' | 'xlsx' | 'csv';
+/**
+ * Detect input type from file extension.
+ * Writes error to stderr and exits with code 1 on unsupported extension.
+ */
+export declare function detectInputType(filePath: string): InputType;
+/**
+ * Validate the --format flag value.
+ * Writes error to stderr and exits with code 1 on unknown format.
+ */
+export declare function validateFormat(format: string): MarkdownFormat;
+/** Options passed by Commander to the convert action */
+export interface ConvertOptions {
+    input?: string;
+    output?: string;
+    format?: string;
+}
+/**
+ * Main convert command action.
+ * Called by Commander when the user runs `formatferry [options]`.
+ */
+export declare function convertCommand(options: ConvertOptions): Promise<void>;
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/packages/cli/src/commands/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../../../src/commands/convert.ts"],"names":[],"mappings":"AAUA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAQtF,iCAAiC;AACjC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAW1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAkB3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAQ7D;AA8FD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE3E"}

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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"}