@empline/preflight 1.1.0

package/dist/checks/api/response-time-budget.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * API Response Time Budget Preflight
+ *
+ * Detects API routes that may have performance issues:
+ * - Missing caching headers
+ * - N+1 query patterns
+ * - Large response payloads without pagination
+ * - Missing timeout handling
+ */
+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 });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "api/response-time-budget";
+exports.name = "Response Time Budget";
+exports.category = "api";
+exports.blocking = true;
+exports.description = "API Response Time Budget Preflight";
+exports.tags = ["api"];
+const findings = [];
+function scanApiRoute(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const relativePath = path.relative(process.cwd(), filePath);
+    // Check for missing cache headers on GET routes
+    const hasGetHandler = /export\s+(async\s+)?function\s+GET/.test(content);
+    const hasCacheHeader = /Cache-Control|s-maxage|stale-while-revalidate|revalidate/.test(content);
+    if (hasGetHandler && !hasCacheHeader) {
+        findings.push({
+            file: relativePath,
+            line: 1,
+            message: "GET route missing cache headers. Consider adding Cache-Control or Next.js revalidate.",
+            severity: "warning",
+            code: "API_NO_CACHE",
+        });
+    }
+    lines.forEach((line, idx) => {
+        const lineNum = idx + 1;
+        // Check for findMany without take/limit (potential large response)
+        if (/\.findMany\s*\(/.test(line)) {
+            const queryBlock = lines.slice(idx, Math.min(idx + 15, lines.length)).join("\n");
+            if (!/take\s*:/.test(queryBlock) && !/limit/.test(queryBlock)) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "findMany without take/limit may return unbounded results. Add pagination.",
+                    severity: "warning",
+                    code: "API_UNBOUNDED_QUERY",
+                });
+            }
+        }
+        // Check for loops with database calls (N+1 pattern)
+        // Only flag if there's an AWAITED database call INSIDE the loop body
+        if (/for\s*\(/.test(line) && /\)\s*{?\s*$/.test(line.trim())) {
+            // Check for preflight-ignore on the line before the loop
+            const prevLine = idx > 0 ? lines[idx - 1] : "";
+            if (/preflight-ignore/.test(prevLine)) {
+                return; // Skip this loop
+            }
+            // Find the loop body by tracking braces
+            let braceCount = line.includes("{") ? 1 : 0;
+            let loopBodyLines = [line];
+            for (let i = idx + 1; i < Math.min(idx + 30, lines.length); i++) {
+                const l = lines[i];
+                loopBodyLines.push(l);
+                // Count braces
+                const opens = (l.match(/{/g) || []).length;
+                const closes = (l.match(/}/g) || []).length;
+                braceCount += opens - closes;
+                // If we started without a brace, look for the first one
+                if (braceCount === 0 && !line.includes("{") && l.includes("{")) {
+                    braceCount = 1;
+                }
+                // Loop body ends when braces are balanced
+                if (braceCount <= 0 && loopBodyLines.length > 1) {
+                    break;
+                }
+            }
+            const loopBlock = loopBodyLines.join("\n");
+            // Check if this is collecting promises for later execution
+            const isCollectingPromises = /\.push\s*\(\s*\n?\s*prisma\./.test(loopBlock) ||
+                /Promises\.push|promises\.push/.test(loopBlock);
+            // Must have await directly before prisma call in the loop (not tx. which is transaction)
+            const hasDatabaseCall = /await\s+prisma\.\w+\.(findUnique|findFirst|create|update|delete|upsert)\s*\(/.test(loopBlock);
+            // tx. calls inside transactions are fine - they're batched by the transaction
+            const isTransactionContext = /await\s+tx\./.test(loopBlock);
+            const isBatchOperation = /createMany|updateMany|deleteMany|\$transaction\s*\(/.test(loopBlock);
+            const isParallelExecution = /Promise\.all\s*\(/.test(lines.slice(Math.max(0, idx - 3), idx + 1).join("\n"));
+            const hasIgnore = /preflight-ignore/.test(loopBlock);
+            if (hasDatabaseCall &&
+                !isBatchOperation &&
+                !isParallelExecution &&
+                !isCollectingPromises &&
+                !isTransactionContext &&
+                !hasIgnore) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "Database query inside loop detected (N+1 pattern). Use include/select or batch queries.",
+                    severity: "error",
+                    code: "API_N_PLUS_ONE",
+                });
+            }
+        }
+        // For forEach/map, only flag if the callback contains await prisma
+        if (/\.forEach\s*\(\s*(async\s*)?\(/.test(line) || /\.map\s*\(\s*async\s*\(/.test(line)) {
+            // Check for preflight-ignore on the line before
+            const prevLine = idx > 0 ? lines[idx - 1] : "";
+            if (/preflight-ignore/.test(prevLine)) {
+                return; // Skip this loop
+            }
+            const loopBlock = lines.slice(idx, Math.min(idx + 10, lines.length)).join("\n");
+            // Only flag async callbacks with database calls (not tx. which is transaction)
+            const hasDatabaseCall = /await\s+prisma\.\w+\.(findUnique|findFirst|create|update|delete|upsert)\s*\(/.test(loopBlock);
+            const isTransactionContext = /await\s+tx\./.test(loopBlock);
+            const isBatchOperation = /createMany|updateMany|deleteMany|\$transaction\s*\(/.test(loopBlock);
+            const isParallelExecution = /Promise\.all\s*\(/.test(lines.slice(Math.max(0, idx - 3), idx + 1).join("\n"));
+            const hasIgnore = /preflight-ignore/.test(loopBlock);
+            if (hasDatabaseCall &&
+                !isBatchOperation &&
+                !isParallelExecution &&
+                !isTransactionContext &&
+                !hasIgnore) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "Database query inside loop detected (N+1 pattern). Use include/select or batch queries.",
+                    severity: "error",
+                    code: "API_N_PLUS_ONE",
+                });
+            }
+        }
+        // Check for missing error handling in async operations
+        if (/await\s+prisma\./.test(line)) {
+            const surroundingBlock = lines
+                .slice(Math.max(0, idx - 5), Math.min(idx + 5, lines.length))
+                .join("\n");
+            if (!/try\s*{|\.catch\(|catch\s*\(/.test(surroundingBlock)) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "Database operation without try/catch. Unhandled errors cause 500s.",
+                    severity: "warning",
+                    code: "API_NO_ERROR_HANDLING",
+                });
+            }
+        }
+        // Check for JSON.stringify on large objects without streaming
+        if (/JSON\.stringify\(/.test(line) && /findMany|getAll|list/.test(content)) {
+            findings.push({
+                file: relativePath,
+                line: lineNum,
+                message: "JSON.stringify on potentially large dataset. Consider streaming for large responses.",
+                severity: "warning",
+                code: "API_LARGE_JSON",
+            });
+        }
+        // Check for missing timeout on external API calls
+        if (/fetch\(/.test(line) && !/AbortController|timeout|signal/.test(content)) {
+            findings.push({
+                file: relativePath,
+                line: lineNum,
+                message: "External fetch without timeout. Add AbortController with timeout.",
+                severity: "warning",
+                code: "API_NO_TIMEOUT",
+            });
+        }
+        // Check for synchronous heavy operations
+        if (/JSON\.parse\(.*readFileSync|fs\.readFileSync/.test(line)) {
+            findings.push({
+                file: relativePath,
+                line: lineNum,
+                message: "Synchronous file read in API route blocks event loop. Use async/await.",
+                severity: "error",
+                code: "API_SYNC_IO",
+            });
+        }
+    });
+    // Check for missing rate limiting indicators
+    const hasRateLimiting = /rateLimit|rateLimiter|Ratelimit|x-ratelimit/.test(content);
+    const isMutationRoute = /POST|PUT|PATCH|DELETE/.test(content);
+    if (isMutationRoute && !hasRateLimiting) {
+        findings.push({
+            file: relativePath,
+            line: 1,
+            message: "Mutation route without rate limiting. Consider adding rate limits.",
+            severity: "warning",
+            code: "API_NO_RATE_LIMIT",
+        });
+    }
+}
+// Routes to skip (integration/batch routes intentionally process in loops)
+const SKIP_ROUTE_PATTERNS = [
+    "/integrations/", // Integration routes process external data
+    "/batch-import/", // Batch routes intentionally loop
+    "/batch-export/", // Batch routes intentionally loop
+    "/sync/", // Sync routes process all items
+    "/cron/", // Cron jobs have their own logic
+    "/webhooks/", // Webhooks process incoming data
+    "/dev/", // Development routes
+    "/reconcile/", // Reconciliation routes compare datasets
+];
+function getApiRoutes() {
+    const files = [];
+    const scanDir = (dir) => {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                scanDir(fullPath);
+            }
+            else if (entry.name === "route.ts" || entry.name === "route.js") {
+                // Skip integration/batch routes
+                const normalizedPath = fullPath.replace(/\\/g, "/");
+                if (!SKIP_ROUTE_PATTERNS.some((pattern) => normalizedPath.includes(pattern))) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    };
+    scanDir("app/api");
+    return files;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log(`${console_chars_1.emoji.search} Checking API response time budgets...\n`);
+    const apiRoutes = getApiRoutes();
+    for (const route of apiRoutes) {
+        scanApiRoute(route);
+    }
+    // Deduplicate
+    const uniqueFindings = findings.filter((f, i, arr) => arr.findIndex((x) => x.file === f.file && x.line === f.line && x.code === f.code) === i);
+    const errors = uniqueFindings.filter((f) => f.severity === "error");
+    const warnings = uniqueFindings.filter((f) => f.severity === "warning");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} Performance Errors (blocking):`);
+        for (const f of errors) {
+            console.log(`  ${f.file}:${f.line} [${f.code}]`);
+            console.log(`    ${f.message}`);
+        }
+        console.log("");
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  Performance Warnings:`);
+        for (const f of warnings.slice(0, 15)) {
+            console.log(`  ${f.file}:${f.line} [${f.code}]`);
+        }
+        if (warnings.length > 15) {
+            console.log(`  ... and ${warnings.length - 15} more warnings`);
+        }
+        console.log("");
+    }
+    // Write findings
+    const findingsPath = process.env.PREFLIGHT_FINDINGS_PATH;
+    if (findingsPath) {
+        fs.writeFileSync(findingsPath, JSON.stringify(uniqueFindings, null, 2));
+    }
+    console.log(`${console_chars_1.emoji.chart} Scanned ${apiRoutes.length} API routes`);
+    console.log(`   Errors: ${errors.length}`);
+    console.log(`   Warnings: ${warnings.length}`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} API performance check failed`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} API performance check passed`);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=response-time-budget.js.map

package/dist/checks/api/response-time-budget.js.map

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

package/dist/checks/api/variant-switching-integrity.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Preflight: Variant Switching Integrity Validation
+ *
+ * RULE: The variant switching feature must maintain its core components:
+ * 1. API must return variants array with required fields
+ * 2. ListingShowcaseCard must accept variants and activeFilters props
+ * 3. ListingsGrid must pass filterState to cards
+ * 4. Types must include ListingVariant interface
+ *
+ * This ensures product cards can display different variants (graders/conditions)
+ * based on filter selection.
+ *
+ * @blocking true
+ * @category api
+ */
+export declare const id = "api/variant-switching-integrity";
+export declare const name = "Variant Switching Integrity";
+export declare const category = "api";
+export declare const blocking = true;
+export declare const description = "Preflight: Variant Switching Integrity Validation";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=variant-switching-integrity.d.ts.map

package/dist/checks/api/variant-switching-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-switching-integrity.d.ts","sourceRoot":"","sources":["../../../src/checks/api/variant-switching-integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,eAAO,MAAM,EAAE,oCAAoC,CAAC;AACpD,eAAO,MAAM,IAAI,gCAAgC,CAAC;AAClD,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,sDAAsD,CAAC;AAC/E,eAAO,MAAM,IAAI,UAAU,CAAC;AAoP5B,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAwCzC"}

package/dist/checks/api/variant-switching-integrity.js

@@ -0,0 +1,312 @@
+"use strict";
+/**
+ * Preflight: Variant Switching Integrity Validation
+ *
+ * RULE: The variant switching feature must maintain its core components:
+ * 1. API must return variants array with required fields
+ * 2. ListingShowcaseCard must accept variants and activeFilters props
+ * 3. ListingsGrid must pass filterState to cards
+ * 4. Types must include ListingVariant interface
+ *
+ * This ensures product cards can display different variants (graders/conditions)
+ * based on filter selection.
+ *
+ * @blocking true
+ * @category api
+ */
+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 });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "api/variant-switching-integrity";
+exports.name = "Variant Switching Integrity";
+exports.category = "api";
+exports.blocking = true;
+exports.description = "Preflight: Variant Switching Integrity Validation";
+exports.tags = ["api"];
+const FILES_TO_CHECK = {
+    api: "app/api/listings/route.ts",
+    types: "app/cards/[category]/_components/types.ts",
+    grid: "app/cards/[category]/_components/ListingsGrid.tsx",
+    card: "components/cards/ListingShowcaseCard.tsx",
+    hook: "app/cards/[category]/_components/useCategoryListings.ts",
+};
+// Required fields in ListingVariant interface
+const REQUIRED_VARIANT_FIELDS = ["id", "price", "grader", "condition", "imageUrls", "slug"];
+// Required props in ListingShowcaseCard
+const REQUIRED_CARD_PROPS = ["variants", "activeFilters"];
+function readFile(filePath) {
+    const fullPath = path.resolve(process.cwd(), filePath);
+    if (!fs.existsSync(fullPath)) {
+        return null;
+    }
+    return fs.readFileSync(fullPath, "utf-8");
+}
+function findLineNumber(content, searchText) {
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes(searchText)) {
+            return i + 1;
+        }
+    }
+    return 0;
+}
+function validateApiRoute(errors) {
+    const content = readFile(FILES_TO_CHECK.api);
+    if (!content) {
+        errors.push({
+            file: FILES_TO_CHECK.api,
+            line: 0,
+            message: "API route file not found",
+        });
+        return;
+    }
+    // Check for variantsMap creation
+    if (!content.includes("variantsMap")) {
+        errors.push({
+            file: FILES_TO_CHECK.api,
+            line: 0,
+            message: "API must create variantsMap to group variants by catalog card",
+        });
+    }
+    // Check for variants in response
+    if (!content.includes("variants:") || !content.includes("variantsMap.get")) {
+        errors.push({
+            file: FILES_TO_CHECK.api,
+            line: findLineNumber(content, "transformedListings"),
+            message: "API must include variants array in listing response",
+        });
+    }
+    // Check for catalogId in response
+    if (!content.includes("catalogId")) {
+        errors.push({
+            file: FILES_TO_CHECK.api,
+            line: 0,
+            message: "API must include catalogId in listing response for variant grouping",
+        });
+    }
+    // Check that graded field is selected from listings
+    if (!content.includes("graded: true") && !content.includes("graded: listing.graded")) {
+        errors.push({
+            file: FILES_TO_CHECK.api,
+            line: 0,
+            message: "API must select graded field from listings for variant data",
+        });
+    }
+}
+function validateTypes(errors) {
+    const content = readFile(FILES_TO_CHECK.types);
+    if (!content) {
+        errors.push({
+            file: FILES_TO_CHECK.types,
+            line: 0,
+            message: "Types file not found",
+        });
+        return;
+    }
+    // Check for ListingVariant interface
+    if (!content.includes("interface ListingVariant")) {
+        errors.push({
+            file: FILES_TO_CHECK.types,
+            line: 0,
+            message: "ListingVariant interface must be defined",
+        });
+        return;
+    }
+    // Check for required fields in ListingVariant
+    for (const field of REQUIRED_VARIANT_FIELDS) {
+        const fieldPattern = new RegExp(`${field}\\s*[?]?\\s*:`);
+        if (!fieldPattern.test(content)) {
+            errors.push({
+                file: FILES_TO_CHECK.types,
+                line: findLineNumber(content, "interface ListingVariant"),
+                message: `ListingVariant must include '${field}' field`,
+            });
+        }
+    }
+    // Check TransformedListing has variants property
+    if (!content.includes("variants?: ListingVariant[]")) {
+        errors.push({
+            file: FILES_TO_CHECK.types,
+            line: findLineNumber(content, "interface TransformedListing"),
+            message: "TransformedListing must include 'variants?: ListingVariant[]' property",
+        });
+    }
+}
+function validateListingsGrid(errors) {
+    const content = readFile(FILES_TO_CHECK.grid);
+    if (!content) {
+        errors.push({
+            file: FILES_TO_CHECK.grid,
+            line: 0,
+            message: "ListingsGrid file not found",
+        });
+        return;
+    }
+    // Check for filterState prop
+    if (!content.includes("filterState")) {
+        errors.push({
+            file: FILES_TO_CHECK.grid,
+            line: 0,
+            message: "ListingsGrid must accept filterState prop to pass to cards",
+        });
+    }
+    // Check that variants are passed to ListingShowcaseCard
+    if (!content.includes("variants={")) {
+        errors.push({
+            file: FILES_TO_CHECK.grid,
+            line: findLineNumber(content, "ListingShowcaseCard"),
+            message: "ListingsGrid must pass variants to ListingShowcaseCard",
+        });
+    }
+    // Check that activeFilters are passed to ListingShowcaseCard
+    if (!content.includes("activeFilters={")) {
+        errors.push({
+            file: FILES_TO_CHECK.grid,
+            line: findLineNumber(content, "ListingShowcaseCard"),
+            message: "ListingsGrid must pass activeFilters to ListingShowcaseCard",
+        });
+    }
+}
+function validateListingShowcaseCard(errors) {
+    const content = readFile(FILES_TO_CHECK.card);
+    if (!content) {
+        errors.push({
+            file: FILES_TO_CHECK.card,
+            line: 0,
+            message: "ListingShowcaseCard file not found",
+        });
+        return;
+    }
+    // Check for required props in interface
+    for (const prop of REQUIRED_CARD_PROPS) {
+        if (!content.includes(`${prop}?:`)) {
+            errors.push({
+                file: FILES_TO_CHECK.card,
+                line: findLineNumber(content, "interface ListingShowcaseCardProps"),
+                message: `ListingShowcaseCard must accept '${prop}' prop`,
+            });
+        }
+    }
+    // Check for variant selection logic (useMemo)
+    if (!content.includes("selectedVariant") || !content.includes("useMemo")) {
+        errors.push({
+            file: FILES_TO_CHECK.card,
+            line: 0,
+            message: "ListingShowcaseCard must implement variant selection logic using useMemo",
+        });
+    }
+    // Check that display values use variant data
+    const displayVariables = ["displayPrice", "displayCondition", "displayImageUrls", "displaySlug"];
+    for (const variable of displayVariables) {
+        if (!content.includes(variable)) {
+            errors.push({
+                file: FILES_TO_CHECK.card,
+                line: 0,
+                message: `ListingShowcaseCard must use '${variable}' to display variant data`,
+            });
+        }
+    }
+}
+function validateHook(errors) {
+    const content = readFile(FILES_TO_CHECK.hook);
+    if (!content) {
+        errors.push({
+            file: FILES_TO_CHECK.hook,
+            line: 0,
+            message: "useCategoryListings hook file not found",
+        });
+        return;
+    }
+    // Check that variants are extracted from API response
+    if (!content.includes("variants") || !content.includes("apiListing.variants")) {
+        errors.push({
+            file: FILES_TO_CHECK.hook,
+            line: findLineNumber(content, "transformListings"),
+            message: "useCategoryListings must extract variants from API response",
+        });
+    }
+    // Check that filterState is returned
+    if (!content.includes("filterState,") || !content.includes("return {")) {
+        errors.push({
+            file: FILES_TO_CHECK.hook,
+            line: 0,
+            message: "useCategoryListings must return filterState for variant switching",
+        });
+    }
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log("🔍 Validating variant switching integrity...\n");
+    const errors = [];
+    validateApiRoute(errors);
+    validateTypes(errors);
+    validateListingsGrid(errors);
+    validateListingShowcaseCard(errors);
+    validateHook(errors);
+    if (errors.length === 0) {
+        console.log("✅ Variant switching feature is properly implemented\n");
+        console.log("   Components validated:");
+        console.log("   ✓ API returns variants array with catalog grouping");
+        console.log("   ✓ ListingVariant type has required fields");
+        console.log("   ✓ ListingsGrid passes filterState to cards");
+        console.log("   ✓ ListingShowcaseCard implements variant selection");
+        console.log("   ✓ useCategoryListings extracts and returns variants\n");
+        process.exit(0);
+    }
+    else {
+        console.log("❌ Variant switching validation failed\n");
+        console.log("   Errors found:\n");
+        for (const error of errors) {
+            console.log(`   ❌ ${error.file}${error.line ? ` (line ${error.line})` : ""}`);
+            console.log(`      ${error.message}\n`);
+        }
+        console.log("\n   📋 RULE: Variant switching requires:");
+        console.log("      1. API must return variants[] and catalogId for each listing");
+        console.log("      2. ListingVariant type must have id, price, grader, condition, imageUrls, slug");
+        console.log("      3. ListingsGrid must pass filterState and variants to cards");
+        console.log("      4. ListingShowcaseCard must select variant based on activeFilters\n");
+        process.exit(1);
+    }
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=variant-switching-integrity.js.map