easyeda-mcp-pro 0.4.0 → 0.5.2

package/dist/bom-quality/quality.js

@@ -0,0 +1,179 @@
+/**
+ * BOM quality — report generation.
+ *
+ * Analyses BOM entries against supplier data to surface issues:
+ *  1. **Unavailable** — part not found or discontinued at any supplier.
+ *  2. **Single-source** — part found at exactly one supplier.
+ *  3. **Missing MPN** — no manufacturer part number.
+ *  4. **Missing footprint** — no package / footprint.
+ *  5. **Low stock** — stock below threshold at every supplier.
+ *
+ * @module
+ */
+import { DEFAULT_BOM_QUALITY_CONFIG } from './types.js';
+import { availableAdapters } from './adapter.js';
+import { getLogger } from '../utils/logger.js';
+// ── Issue factory ──────────────────────────────────────────────────────────
+function issue(type, severity, reference, message, details) {
+    return { type, severity, reference, message, details };
+}
+function unavailableIssue(ref, supplier, reason) {
+    return issue('unavailable', 'error', ref, `Part not available at ${supplier}: ${reason}`, {
+        supplier,
+        reason,
+    });
+}
+function singleSourceIssue(ref, suppliers) {
+    return issue('single_source', 'warning', ref, `Part is single-sourced (only found at ${suppliers.join(', ')})`, { suppliers });
+}
+function missingMpnIssue(ref) {
+    return issue('missing_mpn', 'warning', ref, 'No manufacturer part number (MPN) specified — replaceability is limited');
+}
+function missingFootprintIssue(ref) {
+    return issue('missing_footprint', 'warning', ref, 'No footprint / package specified — PCB layout verification is not possible');
+}
+function lowStockIssue(ref, supplier, stock) {
+    return issue('low_stock', 'warning', ref, `Low stock at ${supplier}: ${stock} units`, {
+        supplier,
+        stock,
+    });
+}
+// ── Supplier query scope ───────────────────────────────────────────────────
+/**
+ * Determine which supplier identifiers to query based on what the entry has.
+ * - If an LCSC code is present, query LCSC.
+ * - If an MPN is present, query Mouser and DigiKey.
+ */
+function queryTargets(entry) {
+    const targets = [];
+    if (entry.lcsc) {
+        targets.push({ supplier: 'lcsc', identifier: { lcsc: entry.lcsc } });
+    }
+    if (entry.mpn) {
+        targets.push({ supplier: 'mouser', identifier: { mpn: entry.mpn } });
+        targets.push({ supplier: 'digikey', identifier: { mpn: entry.mpn } });
+    }
+    return targets;
+}
+// ── Supplier query helper ────────────────────────────────────────────────
+async function querySuppliersForEntry(entry, adapterByKind, _logger) {
+    const targets = queryTargets(entry);
+    const supplierData = [];
+    let hasErrors = false;
+    for (const target of targets) {
+        const adapter = adapterByKind.get(target.supplier);
+        if (!adapter)
+            continue;
+        try {
+            const result = await adapter.queryPart(target.identifier);
+            if (result) {
+                supplierData.push(result);
+                if (result.confidence === 'low')
+                    hasErrors = true;
+            }
+        }
+        catch {
+            // Should not happen (adapters catch internally), but safeguard
+            hasErrors = true;
+        }
+    }
+    return { supplierData, hasErrors, queriedCount: targets.length };
+}
+// ── Main entry point ───────────────────────────────────────────────────────
+/**
+ * Generate a BOM quality report for the given entries.
+ *
+ * For each entry the function:
+ *  1. Queries every available supplier that can handle the entry.
+ *  2. Collects supplier results (with error resilience).
+ *  3. Runs the five quality checks.
+ *  4. Returns a structured report with a summary.
+ *
+ * Supplier failures are caught gracefully — the report always succeeds
+ * (non-null), with `hasSupplierErrors` set to `true` and any affected
+ * entries marked via their issues.
+ */
+export async function generateBomQualityReport(bomId, entries, adapters, config = DEFAULT_BOM_QUALITY_CONFIG) {
+    const now = new Date().toISOString();
+    let hasSupplierErrors = false;
+    // Resolve available adapters once
+    const adapterList = availableAdapters(adapters);
+    const adapterByKind = new Map(adapterList.map((a) => [a.kind, a]));
+    const logger = getLogger();
+    const reportEntries = await Promise.all(entries.map(async (entry) => {
+        // ── 1. Query applicable suppliers ──────────────────────────────────
+        const { supplierData, hasErrors, queriedCount } = await querySuppliersForEntry(entry, adapterByKind, logger);
+        if (hasErrors)
+            hasSupplierErrors = true;
+        // ── 2. Run quality checks ──────────────────────────────────────────
+        const issues = [];
+        // Check: unavailable (not found or discontinued at any queried supplier)
+        const foundSuppliers = supplierData.filter((s) => s.found);
+        const discontinuedSuppliers = supplierData.filter((s) => s.found && s.lifecycle === 'discontinued');
+        if (supplierData.length > 0 && foundSuppliers.length === 0) {
+            // Queried at least one supplier, none had it
+            const queried = supplierData.map((s) => s.supplier).join(', ');
+            issues.push(unavailableIssue(entry.reference, queried, 'not found at any supplier'));
+        }
+        for (const ds of discontinuedSuppliers) {
+            issues.push(unavailableIssue(entry.reference, ds.supplier, 'discontinued / obsolete'));
+        }
+        // Check: single-source
+        const uniqueFoundSuppliers = [...new Set(foundSuppliers.map((s) => s.supplier))];
+        if (uniqueFoundSuppliers.length === 1 && queriedCount > 1) {
+            // Only flag single-source when we actually queried more than one supplier
+            // (i.e. the entry had identifiers for multiple suppliers)
+            issues.push(singleSourceIssue(entry.reference, uniqueFoundSuppliers));
+        }
+        // Check: missing MPN
+        if (config.requireMpn && !entry.mpn && !entry.manufacturer) {
+            issues.push(missingMpnIssue(entry.reference));
+        }
+        // Check: missing footprint
+        if (config.requireFootprint && !entry.footprint) {
+            issues.push(missingFootprintIssue(entry.reference));
+        }
+        // Check: low stock (at every found supplier)
+        if (foundSuppliers.length > 0) {
+            const allLow = foundSuppliers.every((s) => s.stock < config.lowStockThreshold);
+            if (allLow) {
+                for (const fs of foundSuppliers) {
+                    issues.push(lowStockIssue(entry.reference, fs.supplier, fs.stock));
+                }
+            }
+        }
+        return {
+            reference: entry.reference,
+            description: entry.value ?? '',
+            footprint: entry.footprint ?? '',
+            quantity: entry.quantity,
+            lcsc: entry.lcsc,
+            mpn: entry.mpn,
+            manufacturer: entry.manufacturer,
+            supplierData,
+            issues,
+        };
+    }));
+    // ── 3. Aggregate summary ────────────────────────────────────────────────
+    const allIssues = reportEntries.flatMap((e) => e.issues);
+    const summary = {
+        totalIssues: allIssues.length,
+        errors: allIssues.filter((i) => i.severity === 'error').length,
+        warnings: allIssues.filter((i) => i.severity === 'warning').length,
+        info: allIssues.filter((i) => i.severity === 'info').length,
+        unavailableCount: allIssues.filter((i) => i.type === 'unavailable').length,
+        singleSourceCount: allIssues.filter((i) => i.type === 'single_source').length,
+        missingMpnCount: allIssues.filter((i) => i.type === 'missing_mpn').length,
+        missingFootprintCount: allIssues.filter((i) => i.type === 'missing_footprint').length,
+        lowStockCount: allIssues.filter((i) => i.type === 'low_stock').length,
+    };
+    return {
+        bomId,
+        generatedAt: now,
+        totalEntries: entries.length,
+        entries: reportEntries,
+        summary,
+        hasSupplierErrors,
+    };
+}
+//# sourceMappingURL=quality.js.map

package/dist/bom-quality/quality.js.map

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

package/dist/bom-quality/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * BOM quality — core type definitions.
+ *
+ * @module
+ */
+/** Supported supplier identifiers. */
+export type SupplierKind = 'lcsc' | 'mouser' | 'digikey' | 'jlcpcb';
+/** Lifecycle / status of a part at a supplier. */
+export type PartLifecycle = 'active' | 'discontinued' | 'unknown';
+/** BOM entry as passed to quality check, extended with metadata. */
+export interface BomEntry {
+    reference: string;
+    value?: string;
+    footprint?: string;
+    lcsc?: string;
+    mpn?: string;
+    manufacturer?: string;
+    quantity: number;
+    /** Source of this entry (e.g. 'bridge', 'manual'). */
+    source: string;
+    /** ISO-8601 timestamp when this entry was obtained. */
+    fetchedAt: string;
+}
+/** Normalised result from a single supplier query. */
+export interface SupplierQueryResult {
+    supplier: SupplierKind;
+    found: boolean;
+    lcsc?: string;
+    mpn?: string;
+    manufacturer?: string;
+    description?: string;
+    lifecycle: PartLifecycle;
+    stock: number;
+    unitPrice?: number;
+    currency?: string;
+    leadTimeDays?: number;
+    /** ISO-8601 timestamp of this supplier response. */
+    queriedAt: string;
+    /** Human-readable confidence (e.g. 'high', 'medium', 'low'). */
+    confidence: 'high' | 'medium' | 'low';
+}
+/** Issue type identifiers for the BOM quality report. */
+export type BomQualityIssueType = 'unavailable' | 'single_source' | 'missing_mpn' | 'missing_footprint' | 'low_stock';
+/** A single quality issue found for a BOM entry. */
+export interface BomQualityIssue {
+    type: BomQualityIssueType;
+    severity: 'error' | 'warning' | 'info';
+    reference: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/** Complete BOM quality report. */
+export interface BomQualityReport {
+    bomId: string;
+    generatedAt: string;
+    totalEntries: number;
+    entries: Array<{
+        reference: string;
+        description: string;
+        footprint: string;
+        quantity: number;
+        lcsc?: string;
+        mpn?: string;
+        manufacturer?: string;
+        /** Supplier-specific data collected during the check. */
+        supplierData: SupplierQueryResult[];
+        issues: BomQualityIssue[];
+    }>;
+    summary: {
+        totalIssues: number;
+        errors: number;
+        warnings: number;
+        info: number;
+        unavailableCount: number;
+        singleSourceCount: number;
+        missingMpnCount: number;
+        missingFootprintCount: number;
+        lowStockCount: number;
+    };
+    /** Whether any suppliers returned errors during the check. */
+    hasSupplierErrors: boolean;
+}
+/** Configuration for BOM quality checking. */
+export interface BomQualityConfig {
+    /** Stock threshold below which a part is considered low-stock. */
+    lowStockThreshold: number;
+    /** Whether to treat a missing LCSC code as an error. */
+    requireLcsc: boolean;
+    /** Whether to treat a missing MPN as a warning. */
+    requireMpn: boolean;
+    /** Whether to treat a missing footprint as a warning. */
+    requireFootprint: boolean;
+}
+export declare const DEFAULT_BOM_QUALITY_CONFIG: BomQualityConfig;

package/dist/bom-quality/types.js

@@ -0,0 +1,12 @@
+/**
+ * BOM quality — core type definitions.
+ *
+ * @module
+ */
+export const DEFAULT_BOM_QUALITY_CONFIG = {
+    lowStockThreshold: 100,
+    requireLcsc: false,
+    requireMpn: true,
+    requireFootprint: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/bom-quality/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bom-quality/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuGH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,iBAAiB,EAAE,GAAG;IACtB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/dist/bridge/manager.d.ts

@@ -9,20 +9,44 @@ export declare class BridgeManager extends EventEmitter {
     private ws;
     private heartbeatTimer;
     private reconnectTimer;
+    private staleSweepTimer;
     private _activePort;
     private _connectedAtMs;
     private requestMap;
     private requestIdCounter;
     private config;
     private _lastHeartbeatMs;
+    private reconnectAttempts;
+    private reconnectStartMs;
+    private pairingChallenges;
+    private _methodRegistryHash;
     constructor(config: EnvConfig);
     get lastHeartbeatMs(): number;
     get activePort(): number;
     get uptimeMs(): number;
     get connected(): boolean;
+    /**
+     * Wait until the bridge is in the 'connected' state.
+     * Resolves immediately if already connected. Rejects after timeoutMs.
+     */
+    waitForConnection(timeoutMs: number): Promise<void>;
+    get methodRegistryHash(): string;
+    private isLoopbackHost;
+    private computeMethodRegistryHash;
     connect(): Promise<void>;
     private tryListen;
     private handleConnection;
+    /**
+     * Validate and accept a handshake message. Sets up the bridge session
+     * and replies with a hello containing the server's capabilities.
+     */
+    private handleHandshake;
+    /**
+     * Validate and handle an incoming request from the extension.
+     * The server does not currently accept arbitrary extension requests,
+     * so unknown methods are rejected with a structured error response.
+     */
+    private handleIncomingRequest;
     call<TParams, TResult>(method: string, params?: TParams, opts?: {
         timeoutMs?: number;
         traceparent?: string;
@@ -32,6 +56,23 @@ export declare class BridgeManager extends EventEmitter {
     private rejectPending;
     private startHeartbeat;
     private stopHeartbeat;
+    /**
+     * Schedule a reconnect attempt with tiered backoff. Never stops retrying.
+     * Tiers (elapsed since first disconnect):
+     *   0–30 s  → 1 s interval
+     *   30–120 s → 3 s interval
+     *   >120 s  → 10 s interval
+     * Each delay has ±10 % jitter.
+     */
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    /**
+     * Periodically sweep the pending-request map for entries whose
+     * timeout has elapsed but whose `setTimeout` may have been leaked
+     * (defence-in-depth). Runs every 30 s while connected.
+     */
+    private startStaleSweep;
+    private stopStaleSweep;
 }
 /**
  * Parse a port scan specification string into an ordered array of ports.