@empline/preflight 1.1.11 → 1.1.13

package/dist/checks/consolidated/lib-organization.js

@@ -0,0 +1,419 @@
+"use strict";
+/**
+ * Lib Organization Preflight Check
+ *
+ * Ensures the lib/ directory maintains proper organization:
+ * 1. New files are added to appropriate domain barrels
+ * 2. Domain barrels exist and export their modules
+ * 3. No orphaned files that should be in a domain
+ *
+ * Run: pnpm preflight:lib-organization
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const LIB_DIR = path.join(process.cwd(), "lib");
+// Domain definitions with their barrel paths and file patterns
+const DOMAINS = {
+    auth: {
+        barrel: "lib/auth/index.ts",
+        patterns: [/^auth[-.].*\.ts$/, /^session[-.].*\.ts$/, /^password[-.].*\.ts$/, /^2fa.*\.ts$/],
+        description: "Authentication, session, password utilities",
+    },
+    images: {
+        barrel: "lib/images/index.ts",
+        patterns: [
+            /^image[-.].*\.ts$/,
+            /^client-image.*\.ts$/,
+            /^responsive-image.*\.ts$/,
+            /^webp.*\.ts$/,
+            /^import-image.*\.ts$/,
+        ],
+        description: "Image processing, optimization, storage",
+    },
+    integrations: {
+        barrel: "lib/integrations/index.ts",
+        patterns: [
+            /^woocommerce.*\.ts$/,
+            /^shopify.*\.ts$/,
+            /^ebay.*\.ts$/,
+            /^integration[-.].*\.ts$/,
+            /^web-scraping.*\.ts$/,
+        ],
+        description: "WooCommerce, Shopify, eBay, platform integrations",
+    },
+    catalog: {
+        barrel: "lib/catalog/index.ts",
+        patterns: [/^.*-catalog-helpers\.ts$/, /^catalog[-.].*\.ts$/],
+        description: "Product catalog helpers for all types",
+    },
+    recognition: {
+        barrel: "lib/recognition/index.ts",
+        patterns: [
+            /^.*recognition.*\.ts$/,
+            /^batch-recognition.*\.ts$/,
+            /^card-pairing.*\.ts$/,
+            /^confidence.*\.ts$/,
+            /^field-confidence.*\.ts$/,
+        ],
+        description: "Card recognition, AI, learning system",
+    },
+    grading: {
+        barrel: "lib/grading/index.ts",
+        patterns: [
+            /^grading[-.].*\.ts$/,
+            /^graded[-.].*\.ts$/,
+            /^.*-grading-utils\.ts$/,
+            /^comprehensive-grading.*\.ts$/,
+        ],
+        description: "Grading detection and utilities",
+    },
+    listings: {
+        barrel: "lib/listings/index.ts",
+        patterns: [/^listing[-.].*\.ts$/, /^new-listing.*\.ts$/],
+        description: "Listing operations and utilities",
+    },
+    storage: {
+        barrel: "lib/storage/index.ts",
+        patterns: [/^r2[-.].*\.ts$/],
+        description: "R2/CDN storage utilities",
+    },
+    google: {
+        barrel: "lib/google/index.ts",
+        patterns: [/^google[-.].*\.ts$/],
+        description: "Google Merchant API, OAuth",
+    },
+    vision: {
+        barrel: "lib/vision/index.ts",
+        patterns: [/^vision[-.].*\.ts$/, /^deepseek.*\.ts$/],
+        description: "Vision AI services",
+    },
+    ocr: {
+        barrel: "lib/ocr/index.ts",
+        patterns: [/^ocr[-.].*\.ts$/],
+        description: "OCR processing utilities",
+    },
+};
+// Files that are intentionally at root level (not in a domain)
+const ROOT_LEVEL_ALLOWLIST = new Set([
+    "prisma.ts",
+    "logger.ts",
+    "enhanced-logger.ts",
+    "settings.ts",
+    "constants",
+    "types",
+    "api",
+    "data",
+    "database",
+    "analytics",
+    "analytics-utils.ts",
+    "auth.ts", // Main NextAuth config - re-exported by lib/auth/index.ts
+    "enhanced-image-processing.ts", // Server-side Sharp - re-exported by lib/images/index.ts
+    "search",
+    "cards",
+    "ai",
+    "monitoring",
+    "performance",
+    "navigation",
+    "validation",
+    "workers",
+    "scrapers",
+    "examples",
+    "__mocks__",
+    "2fa",
+    // Utility files that don't fit a specific domain
+    "brand-utils.ts",
+    "brand-series-validation.ts",
+    "category-utils.ts",
+    "category-icons.tsx",
+    "category-chip-constants.ts",
+    "card-brands-data.ts",
+    "card-display-utils.ts",
+    "card-validation.ts",
+    "condition-utils.ts",
+    "crockford-id.ts",
+    "ids.ts",
+    "id-prefixes.ts",
+    "product-id-system.ts",
+    "product-utils.ts",
+    "product-helpers.ts",
+    "product-schema.ts",
+    "enum-helpers.ts",
+    "enum-conversion-utils.ts",
+    "format-utils.ts",
+    "text-utils.ts",
+    "locale-utils.ts",
+    "serialization-utils.ts",
+    "template-utils.ts",
+    "template-variables.ts",
+    "email-utils.ts",
+    "sendgrid-service.ts",
+    "notification-service.ts",
+    "seo.ts",
+    "seo-utils.ts",
+    "turnstile.ts",
+    "spam-protection.ts",
+    "rate-limiting.ts",
+    "haptics.ts",
+    "code-splitting.tsx",
+    "dynamic-imports.tsx",
+    "critical-css.ts",
+    "theme.ts",
+    "theme-tokens.ts",
+    "sidebar-constants.ts",
+    "billing-constants.ts",
+    "paypal.ts",
+    "shipping-calculator.ts",
+    "usps-shipping-service.ts",
+    "order-helpers.ts",
+    "inventory-utils.ts",
+    "seller-analytics.ts",
+    "collection-analytics.ts",
+    "market-data.ts",
+    "market-data-utils.ts",
+    "price-tracking.ts",
+    "trending-cards.ts",
+    "player-name-utils.ts",
+    "baseball-teams.ts",
+    "platform-utils.ts",
+    "platform-metrics-service.ts",
+    "review-service.ts",
+    "store-stats-updater.ts",
+    "soft-delete-helpers.ts",
+    "optimistic-locking.ts",
+    "prisma-guards.ts",
+    "prisma-middleware.ts",
+    "database-client.ts",
+    "debug-logger.ts",
+    "api-logger.ts",
+    "error-handler.ts",
+    "cost-monitor.ts",
+    "cache-warming.ts",
+    "learning-system.ts",
+    "metadata-cache.ts",
+    "enhanced-metadata-cache.ts",
+    "enhanced-metadata-cache.js",
+    "enhanced-image-processing.js",
+    "ref-normalization.ts",
+    "reference-data.ts",
+    "reference-data-client.ts",
+    "reference-data-approval.ts",
+    "reference-data-auto-creation.ts",
+    "team-auto-creation.ts",
+    "field-mappings.ts",
+    "scraper.ts",
+    "perceptual-hash.ts",
+    "advanced-perceptual-hash.ts",
+    "border-resolution-metrics.ts",
+    "rotation-metrics.ts",
+    "compression-analytics.ts",
+    "performance-reporter.ts",
+    "performance-tracker.ts",
+    "search-cache.ts",
+    "mock-auth-service.ts",
+    "simple-auth.ts",
+]);
+function getLibRootFiles() {
+    const entries = fs.readdirSync(LIB_DIR, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isFile() && (e.name.endsWith(".ts") || e.name.endsWith(".tsx")))
+        .map((e) => e.name);
+}
+function getDomainForFile(filename) {
+    for (const [domain, config] of Object.entries(DOMAINS)) {
+        for (const pattern of config.patterns) {
+            if (pattern.test(filename)) {
+                return domain;
+            }
+        }
+    }
+    return null;
+}
+function isInAllowlist(filename) {
+    // Check exact match
+    if (ROOT_LEVEL_ALLOWLIST.has(filename)) {
+        return true;
+    }
+    // Check if it's a directory name
+    const baseName = filename.replace(/\.(ts|tsx)$/, "");
+    if (ROOT_LEVEL_ALLOWLIST.has(baseName)) {
+        return true;
+    }
+    return false;
+}
+function checkBarrelExportsFile(barrelPath, expectedExports) {
+    const missing = [];
+    if (!fs.existsSync(barrelPath)) {
+        return expectedExports;
+    }
+    const content = fs.readFileSync(barrelPath, "utf-8");
+    for (const file of expectedExports) {
+        // Check if the file is exported in some form
+        const baseName = file.replace(/\.(ts|tsx)$/, "");
+        const exportPatterns = [
+            `from '../../../../../../${baseName}'`,
+            `from "./${baseName}"`,
+            `from '../../../../../../${file.replace(".ts", "")}'`,
+            `'../${baseName}'`,
+            // Also check for the base name without path prefix (in case of re-export with different path)
+            `/${baseName}'`,
+            `/${baseName}"`,
+        ];
+        const isExported = exportPatterns.some((pattern) => content.includes(pattern));
+        if (!isExported) {
+            missing.push(file);
+        }
+    }
+    return missing;
+}
+function runCheck() {
+    const issues = [];
+    const rootFiles = getLibRootFiles();
+    let organizedFiles = 0;
+    let rootLevelFiles = 0;
+    let missingFromBarrels = 0;
+    // Group files by their detected domain
+    const filesByDomain = {};
+    for (const file of rootFiles) {
+        const domain = getDomainForFile(file);
+        if (domain) {
+            if (!filesByDomain[domain]) {
+                filesByDomain[domain] = [];
+            }
+            filesByDomain[domain].push(file);
+            organizedFiles++;
+        }
+        else if (isInAllowlist(file)) {
+            rootLevelFiles++;
+        }
+        else {
+            // File doesn't match any domain and isn't in allowlist
+            issues.push({
+                file,
+                domain: "unknown",
+                message: `File "${file}" is not in any domain barrel or allowlist. Consider adding it to a domain or the allowlist.`,
+                severity: "warning",
+            });
+            rootLevelFiles++;
+        }
+    }
+    // Check if domain barrel exports are complete
+    for (const [domain, files] of Object.entries(filesByDomain)) {
+        const config = DOMAINS[domain];
+        if (!config)
+            continue;
+        const barrelPath = path.join(process.cwd(), config.barrel);
+        if (!fs.existsSync(barrelPath)) {
+            issues.push({
+                file: config.barrel,
+                domain,
+                message: `Domain barrel "${config.barrel}" does not exist but has ${files.length} matching files.`,
+                severity: "error",
+            });
+            missingFromBarrels += files.length;
+            continue;
+        }
+        const missingExports = checkBarrelExportsFile(barrelPath, files);
+        for (const missing of missingExports) {
+            issues.push({
+                file: missing,
+                domain,
+                message: `File "${missing}" matches domain "${domain}" but is not exported from "${config.barrel}".`,
+                severity: "warning",
+            });
+            missingFromBarrels++;
+        }
+    }
+    // Only fail on errors, not warnings
+    const hasErrors = issues.some((i) => i.severity === "error");
+    return {
+        passed: !hasErrors,
+        issues,
+        stats: {
+            totalFiles: rootFiles.length,
+            organizedFiles,
+            rootLevelFiles,
+            missingFromBarrels,
+        },
+    };
+}
+function formatOutput(result) {
+    console.log("\n📂 LIB ORGANIZATION PREFLIGHT CHECK");
+    console.log((0, console_chars_1.createDivider)(60, "double"));
+    console.log(`\n${console_chars_1.emoji.chart} Statistics:`);
+    console.log(`   Total root-level files: ${result.stats.totalFiles}`);
+    console.log(`   Files matching domains: ${result.stats.organizedFiles}`);
+    console.log(`   Root-level (allowed):   ${result.stats.rootLevelFiles}`);
+    console.log(`   Missing from barrels:   ${result.stats.missingFromBarrels}`);
+    if (result.issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} All lib files are properly organized!`);
+        return;
+    }
+    const errors = result.issues.filter((i) => i.severity === "error");
+    const warnings = result.issues.filter((i) => i.severity === "warning");
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Errors (${errors.length}):`);
+        for (const issue of errors) {
+            console.log(`   ${console_chars_1.chars.bullet} [${issue.domain}] ${issue.message}`);
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  Warnings (${warnings.length}):`);
+        for (const issue of warnings.slice(0, 10)) {
+            console.log(`   ${console_chars_1.chars.bullet} [${issue.domain}] ${issue.message}`);
+        }
+        if (warnings.length > 10) {
+            console.log(`   ... and ${warnings.length - 10} more warnings`);
+        }
+    }
+    console.log("\n📖 Domain Reference:");
+    for (const [domain, config] of Object.entries(DOMAINS)) {
+        console.log(`   ${console_chars_1.chars.bullet} ${domain}: ${config.description}`);
+    }
+    console.log(`\n${console_chars_1.emoji.hint} To fix:`);
+    console.log("   1. Add missing files to their domain barrel exports");
+    console.log("   2. Or add files to ROOT_LEVEL_ALLOWLIST if they should stay at root");
+    console.log("   3. See docs/architecture/LIB-DIRECTORY-ORGANIZATION.md for details");
+}
+// Main execution
+const result = runCheck();
+formatOutput(result);
+if (!result.passed) {
+    process.exit(1);
+}
+console.log(`\n${console_chars_1.emoji.success} Lib organization check passed!\n`);
+//# sourceMappingURL=lib-organization.js.map

package/dist/checks/consolidated/lib-organization.js.map

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

package/dist/checks/consolidated/n-plus-one.d.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env tsx
+/**
+ * N+1 Query Detection Preflight
+ *
+ * N+1 queries are a common performance anti-pattern where:
+ * - 1 query fetches a list of items
+ * - N additional queries fetch related data for each item
+ *
+ * This results in O(N) database queries instead of O(1) with proper JOINs.
+ *
+ * Patterns detected:
+ * - Loops with Prisma queries inside
+ * - .map() with await prisma.* calls
+ * - forEach with database operations
+ * - Promise.all with individual queries per item
+ *
+ * Usage:
+ *   pnpm preflight:n-plus-one                 # Full check
+ *   pnpm preflight:n-plus-one --verbose       # Show code snippets
+ *
+ * @blocking false (warning only - needs human review)
+ */
+interface Issue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion?: string;
+    snippet?: string;
+}
+interface CheckResult {
+    passed: boolean;
+    issues: Issue[];
+    duration: number;
+    filesScanned: number;
+}
+declare class NPlusOneDetector {
+    private verbose;
+    private parallel;
+    constructor(options?: {
+        verbose?: boolean;
+        parallel?: boolean;
+    });
+    /**
+     * Detect N+1 patterns in a file
+     */
+    private analyzeFile;
+    /**
+     * Extract loop body and check for Prisma calls
+     */
+    private extractLoopBody;
+    /**
+     * Extract map/forEach body and check for Prisma calls
+     */
+    private extractMapBody;
+    /**
+     * Run the N+1 detection
+     */
+    run(): Promise<CheckResult>;
+}
+export { NPlusOneDetector };
+//# sourceMappingURL=n-plus-one.d.ts.map

package/dist/checks/consolidated/n-plus-one.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n-plus-one.d.ts","sourceRoot":"","sources":["../../../src/checks/consolidated/n-plus-one.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,cAAM,gBAAgB;IACpB,OAAO,CAAC,OAAO,CAAU;IAEzB,OAAO,CAAC,QAAQ,CAAkB;gBACtB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAKnE;;OAEG;IACH,OAAO,CAAC,WAAW;IA8HnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;CAwElC;AAoBD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}