formatferry 0.1.4 → 1.0.0

package/dist/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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"}