saasgadget 0.1.0

package/dist/lib/competitor-scheduler.js

@@ -0,0 +1,235 @@
+/**
+ * Competitor monitoring scheduler — cron-like re-scan scheduling
+ * with diff detection and configurable intervals.
+ * @module lib/competitor-scheduler
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { executeScrapeCompetitor } from '../mcp/tools/scrape-competitor.js';
+import { ScanError } from './errors.js';
+// ─── Constants ──────────────────────────────────────────
+const SCHEDULER_DIR = join(homedir(), '.saasgadget', 'competitor-monitors');
+const MONITORS_FILE = join(SCHEDULER_DIR, 'monitors.json');
+const SNAPSHOTS_DIR = join(SCHEDULER_DIR, 'snapshots');
+const INTERVAL_MS = {
+    daily: 24 * 60 * 60 * 1000,
+    weekly: 7 * 24 * 60 * 60 * 1000,
+    monthly: 30 * 24 * 60 * 60 * 1000,
+};
+// ─── Logging Adapter ────────────────────────────────────
+const defaultLog = async (level, msg) => {
+    const prefix = level === 'error' ? '✗' : level === 'warning' ? '⚠' : '→';
+    console.log(`${prefix} ${msg}`);
+};
+// ─── CompetitorScheduler ────────────────────────────────
+export class CompetitorScheduler {
+    watchTimer = null;
+    /** Load all monitor configs from disk. */
+    async loadMonitors() {
+        try {
+            const raw = await readFile(MONITORS_FILE, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Save monitor configs to disk. */
+    async saveMonitors(monitors) {
+        await mkdir(SCHEDULER_DIR, { recursive: true });
+        await writeFile(MONITORS_FILE, JSON.stringify(monitors, null, 2), 'utf-8');
+    }
+    /** Add a new competitor monitor. */
+    async addMonitor(config) {
+        const monitors = await this.loadMonitors();
+        const monitor = {
+            ...config,
+            id: `mon-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+            createdAt: new Date().toISOString(),
+        };
+        monitors.push(monitor);
+        await this.saveMonitors(monitors);
+        return monitor;
+    }
+    /** Remove a monitor by ID. */
+    async removeMonitor(id) {
+        const monitors = await this.loadMonitors();
+        const filtered = monitors.filter((m) => m.id !== id);
+        if (filtered.length === monitors.length)
+            return false;
+        await this.saveMonitors(filtered);
+        return true;
+    }
+    /** Toggle a monitor's enabled state. */
+    async toggleMonitor(id, enabled) {
+        const monitors = await this.loadMonitors();
+        const monitor = monitors.find((m) => m.id === id);
+        if (!monitor)
+            return null;
+        monitor.enabled = enabled;
+        await this.saveMonitors(monitors);
+        return monitor;
+    }
+    /** Load snapshots for a monitor. */
+    async loadSnapshots(monitorId) {
+        const file = join(SNAPSHOTS_DIR, `${monitorId}.json`);
+        try {
+            const raw = await readFile(file, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Save a new snapshot for a monitor. */
+    async saveSnapshot(snapshot) {
+        await mkdir(SNAPSHOTS_DIR, { recursive: true });
+        const file = join(SNAPSHOTS_DIR, `${snapshot.monitorId}.json`);
+        const snapshots = await this.loadSnapshots(snapshot.monitorId);
+        snapshots.push(snapshot);
+        // Keep last 50 snapshots per monitor
+        const trimmed = snapshots.slice(-50);
+        await writeFile(file, JSON.stringify(trimmed, null, 2), 'utf-8');
+    }
+    /** Execute a single scan for a monitor and save the snapshot. */
+    async runScan(monitor, log = defaultLog) {
+        const result = await executeScrapeCompetitor({ url: monitor.url, extractFields: monitor.extractFields }, log);
+        const snapshot = {
+            monitorId: monitor.id,
+            scannedAt: new Date().toISOString(),
+            data: result,
+        };
+        await this.saveSnapshot(snapshot);
+        return snapshot;
+    }
+    /** Compute diff between the two most recent snapshots for a monitor. */
+    async computeDiff(monitorId) {
+        const snapshots = await this.loadSnapshots(monitorId);
+        if (snapshots.length < 2)
+            return null;
+        const monitors = await this.loadMonitors();
+        const monitor = monitors.find((m) => m.id === monitorId);
+        if (!monitor)
+            return null;
+        const prev = snapshots[snapshots.length - 2];
+        const curr = snapshots[snapshots.length - 1];
+        const details = [];
+        const fields = ['features', 'pricing', 'positioning', 'team', 'techStack'];
+        for (const field of fields) {
+            const prevVal = prev.data.data[field];
+            const currVal = curr.data.data[field];
+            if (prevVal === undefined && currVal !== undefined) {
+                details.push({ field, previous: prevVal, current: currVal, changeType: 'added' });
+            }
+            else if (prevVal !== undefined && currVal === undefined) {
+                details.push({ field, previous: prevVal, current: currVal, changeType: 'removed' });
+            }
+            else if (JSON.stringify(prevVal) !== JSON.stringify(currVal)) {
+                details.push({ field, previous: prevVal, current: currVal, changeType: 'modified' });
+            }
+        }
+        if (details.length === 0)
+            return null;
+        return {
+            monitorId,
+            url: monitor.url,
+            changedFields: details.map((d) => d.field),
+            previousSnapshot: prev.scannedAt,
+            currentSnapshot: curr.scannedAt,
+            details,
+        };
+    }
+    /** Check which monitors are due for a re-scan based on their interval. */
+    async getDueMonitors() {
+        const monitors = await this.loadMonitors();
+        const due = [];
+        const now = Date.now();
+        for (const monitor of monitors) {
+            if (!monitor.enabled)
+                continue;
+            const snapshots = await this.loadSnapshots(monitor.id);
+            const lastScan = snapshots.at(-1);
+            if (!lastScan) {
+                due.push(monitor); // Never scanned — always due
+                continue;
+            }
+            const elapsed = now - new Date(lastScan.scannedAt).getTime();
+            if (elapsed >= INTERVAL_MS[monitor.interval]) {
+                due.push(monitor);
+            }
+        }
+        return due;
+    }
+    /** Run all due monitors and return diffs for any that changed. */
+    async runDueScans(log = defaultLog) {
+        const due = await this.getDueMonitors();
+        const diffs = [];
+        for (const monitor of due) {
+            await log('info', `Scanning ${monitor.url} (${monitor.interval} schedule)...`);
+            await this.runScan(monitor, log);
+            const diff = await this.computeDiff(monitor.id);
+            if (diff) {
+                diffs.push(diff);
+                await log('warning', `Changes detected for ${monitor.url}: ${diff.changedFields.join(', ')}`);
+            }
+            else {
+                await log('info', `No changes detected for ${monitor.url}`);
+            }
+        }
+        return diffs;
+    }
+    /**
+     * Start watch mode — check for due monitors at a regular interval.
+     * @param checkIntervalMs How often to check (default: 1 hour)
+     */
+    startWatch(checkIntervalMs = 60 * 60 * 1000, log = defaultLog) {
+        if (this.watchTimer) {
+            throw new ScanError('Watch mode is already running. Call stopWatch() first.', 'Stop the existing watch before starting a new one.');
+        }
+        log('info', `Starting competitor watch mode (checking every ${checkIntervalMs / 60000}min)`);
+        // Run immediately on start
+        this.runDueScans(log).catch((err) => log('error', `Watch scan error: ${err instanceof Error ? err.message : String(err)}`));
+        this.watchTimer = setInterval(() => {
+            this.runDueScans(log).catch((err) => log('error', `Watch scan error: ${err instanceof Error ? err.message : String(err)}`));
+        }, checkIntervalMs);
+    }
+    /** Stop watch mode. */
+    stopWatch() {
+        if (this.watchTimer) {
+            clearInterval(this.watchTimer);
+            this.watchTimer = null;
+        }
+    }
+    /** Generate a markdown diff report for all monitors with changes. */
+    async generateDiffReport(diffs) {
+        if (diffs.length === 0)
+            return '# Competitor Monitor Report\n\nNo changes detected.\n';
+        const lines = [
+            '# Competitor Monitor Report',
+            '',
+            `Generated: ${new Date().toISOString()}`,
+            '',
+            `## Summary: ${diffs.length} competitor(s) with changes`,
+            '',
+        ];
+        for (const diff of diffs) {
+            lines.push(`### ${diff.url}`);
+            lines.push('');
+            lines.push(`| Field | Change | Previous → Current |`);
+            lines.push(`|-------|--------|-------------------|`);
+            for (const detail of diff.details) {
+                const prev = Array.isArray(detail.previous)
+                    ? `[${detail.previous.length} items]`
+                    : String(detail.previous ?? '—');
+                const curr = Array.isArray(detail.current)
+                    ? `[${detail.current.length} items]`
+                    : String(detail.current ?? '—');
+                lines.push(`| ${detail.field} | ${detail.changeType} | ${prev} → ${curr} |`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=competitor-scheduler.js.map

package/dist/lib/competitor-scheduler.js.map

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

package/dist/lib/crawler.d.ts

@@ -0,0 +1,17 @@
+import type { ICrawler, CrawlResult } from '../contracts/crawler.js';
+/**
+ * WebCrawler — multi-page crawl with depth control and dual-write URL tracking.
+ */
+export declare class WebCrawler implements ICrawler {
+    private rateLimiter;
+    constructor(requestsPerSecond?: number);
+    crawl(url: string, options?: {
+        maxDepth?: number;
+        rateLimit?: number;
+    }): Promise<CrawlResult[]>;
+    /**
+     * Get the session-local visited URLs (for session state tracking).
+     */
+    getVisitedUrls(): string[];
+}
+//# sourceMappingURL=crawler.d.ts.map

package/dist/lib/crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../../src/lib/crawler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA6ErE;;GAEG;AACH,qBAAa,UAAW,YAAW,QAAQ;IACzC,OAAO,CAAC,WAAW,CAAc;gBAErB,iBAAiB,GAAE,MAAU;IAInC,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,WAAW,EAAE,CAAC;IAuFzB;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;CAG3B"}

package/dist/lib/crawler.js

@@ -0,0 +1,168 @@
+/**
+ * Multi-page web crawler with depth control, robots.txt compliance, and rate limiting.
+ * Implements ICrawler contract.
+ * @module lib/crawler
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { httpFetch } from './http.js';
+import { normalizeUrl } from './url.js';
+import { RateLimiter, checkRobotsCompliance } from './rate-limiter.js';
+import { extractMainContent } from './html-cleaner.js';
+const MAX_DEPTH = 5;
+const VISITED_URLS_PATH = join(homedir(), '.saasgadget', 'cache', 'visited-urls.json');
+/**
+ * Load global visited URLs cache from disk.
+ */
+async function loadGlobalVisitedUrls() {
+    try {
+        const data = await readFile(VISITED_URLS_PATH, 'utf-8');
+        const urls = JSON.parse(data);
+        return new Set(urls);
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * Save global visited URLs cache to disk.
+ */
+async function saveGlobalVisitedUrls(urls) {
+    await mkdir(dirname(VISITED_URLS_PATH), { recursive: true });
+    await writeFile(VISITED_URLS_PATH, JSON.stringify([...urls]), 'utf-8');
+}
+/**
+ * Extract links from HTML content, resolving relative URLs.
+ */
+function extractLinks(html, baseUrl) {
+    const links = [];
+    const hrefRegex = /href="([^"]+)"/gi;
+    let match;
+    while ((match = hrefRegex.exec(html)) !== null) {
+        const href = match[1] ?? '';
+        // Skip anchors, javascript:, mailto:, tel:
+        if (href.startsWith('#') || href.startsWith('javascript:') ||
+            href.startsWith('mailto:') || href.startsWith('tel:'))
+            continue;
+        try {
+            const resolved = new URL(href, baseUrl).toString();
+            links.push(normalizeUrl(resolved));
+        }
+        catch {
+            // Skip invalid URLs
+        }
+    }
+    return [...new Set(links)];
+}
+/**
+ * Extract page title from HTML.
+ */
+function extractTitle(html) {
+    const match = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    return match?.[1]?.trim() ?? 'Untitled';
+}
+/**
+ * Check if a URL belongs to the same domain as the base URL.
+ */
+function isSameDomain(url, baseUrl) {
+    try {
+        const a = new URL(url);
+        const b = new URL(baseUrl);
+        return a.hostname === b.hostname;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * WebCrawler — multi-page crawl with depth control and dual-write URL tracking.
+ */
+export class WebCrawler {
+    rateLimiter;
+    constructor(requestsPerSecond = 2) {
+        this.rateLimiter = new RateLimiter(requestsPerSecond);
+    }
+    async crawl(url, options) {
+        const maxDepth = Math.min(options?.maxDepth ?? 2, MAX_DEPTH);
+        if (options?.rateLimit) {
+            this.rateLimiter = new RateLimiter(options.rateLimit);
+        }
+        // Load global visited URLs for deduplication
+        const globalVisited = await loadGlobalVisitedUrls();
+        const sessionVisited = new Set();
+        const results = [];
+        // BFS queue: [url, depth]
+        const queue = [[normalizeUrl(url), 0]];
+        while (queue.length > 0) {
+            const entry = queue.shift();
+            if (!entry)
+                break;
+            const [currentUrl, depth] = entry;
+            const normalized = normalizeUrl(currentUrl);
+            // Skip if already visited (global or session)
+            if (globalVisited.has(normalized) || sessionVisited.has(normalized))
+                continue;
+            // Check robots.txt compliance
+            const compliance = await checkRobotsCompliance(normalized);
+            if (!compliance.allowed)
+                continue;
+            // Apply crawl delay from robots.txt if specified
+            if (compliance.crawlDelay && compliance.crawlDelay > 0) {
+                await new Promise((r) => setTimeout(r, (compliance.crawlDelay ?? 0) * 1000));
+            }
+            // Rate limit
+            await this.rateLimiter.acquire();
+            // Mark as visited (dual-write)
+            globalVisited.add(normalized);
+            sessionVisited.add(normalized);
+            try {
+                const response = await httpFetch(normalized, {
+                    headers: {
+                        'User-Agent': 'SaaSGadget/1.0 (https://github.com/wxzrd21614/SaaSGadgetCLI)',
+                        Accept: 'text/html',
+                    },
+                    timeoutMs: 15_000,
+                });
+                if (response.status !== 200)
+                    continue;
+                const contentType = response.headers['content-type'] ?? '';
+                if (!contentType.includes('text/html'))
+                    continue;
+                const html = response.body;
+                const title = extractTitle(html);
+                const content = await extractMainContent(html);
+                const links = extractLinks(html, normalized);
+                results.push({
+                    url: normalized,
+                    content,
+                    title,
+                    links: links.filter((l) => isSameDomain(l, normalized)),
+                });
+                // Enqueue child links if within depth
+                if (depth < maxDepth) {
+                    for (const link of links) {
+                        if (isSameDomain(link, normalized) &&
+                            !globalVisited.has(link) &&
+                            !sessionVisited.has(link)) {
+                            queue.push([link, depth + 1]);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip failed pages, continue crawling
+            }
+        }
+        // Persist global visited URLs
+        await saveGlobalVisitedUrls(globalVisited);
+        return results;
+    }
+    /**
+     * Get the session-local visited URLs (for session state tracking).
+     */
+    getVisitedUrls() {
+        return [];
+    }
+}
+//# sourceMappingURL=crawler.js.map

package/dist/lib/crawler.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Error type hierarchy with actionable remediation messages.
+ * @module lib/errors
+ */
+export declare class SaaSGadgetError extends Error {
+    readonly remediation: string;
+    readonly code: string;
+    constructor(message: string, code: string, remediation: string);
+}
+export declare class AuthError extends SaaSGadgetError {
+    constructor(message: string, remediation?: string);
+}
+export declare class ConfigError extends SaaSGadgetError {
+    constructor(message: string, remediation?: string);
+}
+export declare class ScanError extends SaaSGadgetError {
+    constructor(message: string, remediation?: string);
+}
+export declare class MCPError extends SaaSGadgetError {
+    constructor(message: string, remediation?: string);
+}
+export declare class SessionError extends SaaSGadgetError {
+    constructor(message: string, remediation?: string);
+}
+export declare class BudgetExhaustedError extends SaaSGadgetError {
+    constructor(message?: string, remediation?: string);
+}
+export declare class ToolTimeoutError extends SaaSGadgetError {
+    constructor(toolName: string, timeoutMs: number, remediation?: string);
+}
+export declare class NetworkError extends SaaSGadgetError {
+    constructor(message: string, remediation?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAM/D;AAED,qBAAa,SAAU,SAAQ,eAAe;gBAChC,OAAO,EAAE,MAAM,EAAE,WAAW,SAAiD;CAI1F;AAED,qBAAa,WAAY,SAAQ,eAAe;gBAE5C,OAAO,EAAE,MAAM,EACf,WAAW,SAA2D;CAKzE;AAED,qBAAa,SAAU,SAAQ,eAAe;gBAE1C,OAAO,EAAE,MAAM,EACf,WAAW,SAA2D;CAKzE;AAED,qBAAa,QAAS,SAAQ,eAAe;gBAEzC,OAAO,EAAE,MAAM,EACf,WAAW,SAA6D;CAK3E;AAED,qBAAa,YAAa,SAAQ,eAAe;gBAE7C,OAAO,EAAE,MAAM,EACf,WAAW,SAA8D;CAK5E;AAED,qBAAa,oBAAqB,SAAQ,eAAe;gBAErD,OAAO,SAA4B,EACnC,WAAW,SAAkF;CAKhG;AAED,qBAAa,gBAAiB,SAAQ,eAAe;gBAEjD,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,SAAsE;CASpF;AAED,qBAAa,YAAa,SAAQ,eAAe;gBAE7C,OAAO,EAAE,MAAM,EACf,WAAW,SAAkD;CAKhE"}

package/dist/lib/errors.js

@@ -0,0 +1,63 @@
+/**
+ * Error type hierarchy with actionable remediation messages.
+ * @module lib/errors
+ */
+export class SaaSGadgetError extends Error {
+    remediation;
+    code;
+    constructor(message, code, remediation) {
+        super(message);
+        this.name = 'SaaSGadgetError';
+        this.code = code;
+        this.remediation = remediation;
+    }
+}
+export class AuthError extends SaaSGadgetError {
+    constructor(message, remediation = 'Run `saasgadget auth login` to authenticate.') {
+        super(message, 'AUTH_ERROR', remediation);
+        this.name = 'AuthError';
+    }
+}
+export class ConfigError extends SaaSGadgetError {
+    constructor(message, remediation = 'Run `saasgadget init --reset` to recreate your config.') {
+        super(message, 'CONFIG_ERROR', remediation);
+        this.name = 'ConfigError';
+    }
+}
+export class ScanError extends SaaSGadgetError {
+    constructor(message, remediation = 'Check the repository path and your network connection.') {
+        super(message, 'SCAN_ERROR', remediation);
+        this.name = 'ScanError';
+    }
+}
+export class MCPError extends SaaSGadgetError {
+    constructor(message, remediation = 'Run `saasgadget doctor` to verify MCP tool availability.') {
+        super(message, 'MCP_ERROR', remediation);
+        this.name = 'MCPError';
+    }
+}
+export class SessionError extends SaaSGadgetError {
+    constructor(message, remediation = 'Run `saasgadget session list` to view available sessions.') {
+        super(message, 'SESSION_ERROR', remediation);
+        this.name = 'SessionError';
+    }
+}
+export class BudgetExhaustedError extends SaaSGadgetError {
+    constructor(message = 'Token budget exhausted.', remediation = 'Increase `toggles.budgetTokens` in config or use `--compact` to free context.') {
+        super(message, 'BUDGET_EXHAUSTED', remediation);
+        this.name = 'BudgetExhaustedError';
+    }
+}
+export class ToolTimeoutError extends SaaSGadgetError {
+    constructor(toolName, timeoutMs, remediation = 'Increase `toggles.toolExecutionTimeoutMs` in config or try again.') {
+        super(`Tool "${toolName}" exceeded timeout of ${timeoutMs}ms.`, 'TOOL_TIMEOUT', remediation);
+        this.name = 'ToolTimeoutError';
+    }
+}
+export class NetworkError extends SaaSGadgetError {
+    constructor(message, remediation = 'Check your internet connection and try again.') {
+        super(message, 'NETWORK_ERROR', remediation);
+        this.name = 'NetworkError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,WAAW,CAAS;IACpB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY,EAAE,WAAmB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,eAAe;IAC5C,YAAY,OAAe,EAAE,WAAW,GAAG,8CAA8C;QACvF,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC9C,YACE,OAAe,EACf,WAAW,GAAG,wDAAwD;QAEtE,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,eAAe;IAC5C,YACE,OAAe,EACf,WAAW,GAAG,wDAAwD;QAEtE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,eAAe;IAC3C,YACE,OAAe,EACf,WAAW,GAAG,0DAA0D;QAExE,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C,YACE,OAAe,EACf,WAAW,GAAG,2DAA2D;QAEzE,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,YACE,OAAO,GAAG,yBAAyB,EACnC,WAAW,GAAG,+EAA+E;QAE7F,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD,YACE,QAAgB,EAChB,SAAiB,EACjB,WAAW,GAAG,mEAAmE;QAEjF,KAAK,CACH,SAAS,QAAQ,yBAAyB,SAAS,KAAK,EACxD,cAAc,EACd,WAAW,CACZ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C,YACE,OAAe,EACf,WAAW,GAAG,+CAA+C;QAE7D,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/lib/exporter.d.ts

@@ -0,0 +1,9 @@
+import type { IExporter, ExportFormat } from '../contracts/exporter.js';
+/**
+ * DataExporter — write structured data to JSON, Markdown, or CSV files.
+ */
+export declare class DataExporter implements IExporter {
+    readonly supportedFormats: readonly ExportFormat[];
+    export(data: Record<string, unknown>[], format: ExportFormat, outputPath: string): Promise<string>;
+}
+//# sourceMappingURL=exporter.d.ts.map

package/dist/lib/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../src/lib/exporter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA4ExE;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAwC;IAEpF,MAAM,CACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;CAoBnB"}