@empline/preflight 1.0.20

package/dist/checks/data-integrity/cart-data-integrity.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Preflight: Cart Data Integrity
+ *
+ * Validates cart-related data flow and consistency:
+ * - Cart state management follows proper patterns
+ * - Cart items reference valid catalog/listing data
+ * - Quantity limits are enforced
+ * - Price calculations are consistent
+ * - Cart expiration logic is present
+ *
+ * @blocking true - Cart bugs cause direct revenue loss
+ */
+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;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "data-integrity/cart-data-integrity";
+exports.name = "Cart Data Integrity";
+exports.category = "data-integrity";
+exports.blocking = true;
+exports.description = "Preflight: Cart Data Integrity";
+exports.tags = ["data-integrity"];
+const issues = [];
+function scanFile(filePath, content) {
+    const lines = content.split("\n");
+    const relPath = path.relative(process.cwd(), filePath).replace(/\\/g, "/");
+    // Check for cart state patterns
+    lines.forEach((line, idx) => {
+        const lineNum = idx + 1;
+        // 1. Direct localStorage cart manipulation without validation
+        if (line.includes("localStorage.getItem") &&
+            line.includes("cart") &&
+            !content.includes("validateCartItem")) {
+            // Check if this file has proper validation
+            if (!content.includes("try") || !content.includes("JSON.parse")) {
+                issues.push({
+                    file: relPath,
+                    line: lineNum,
+                    message: "Cart localStorage access without JSON.parse try/catch",
+                    type: "warning",
+                });
+            }
+        }
+        // 2. Cart quantity without limits
+        if ((line.includes("quantity") || line.includes("qty")) &&
+            line.includes("cart") &&
+            (line.includes("+=") || line.includes("+ 1") || line.includes("+1"))) {
+            // Check for max quantity validation nearby
+            const contextStart = Math.max(0, idx - 10);
+            const contextEnd = Math.min(lines.length, idx + 10);
+            const context = lines.slice(contextStart, contextEnd).join("\n");
+            if (!context.includes("MAX_QUANTITY") &&
+                !context.includes("maxQuantity") &&
+                !context.includes("maxQuantity") &&
+                !context.includes("> 99") &&
+                !context.includes(">= 100")) {
+                issues.push({
+                    file: relPath,
+                    line: lineNum,
+                    message: "Cart quantity increment without max limit check",
+                    type: "warning",
+                });
+            }
+        }
+        // 3. Cart price calculations without Decimal
+        if (line.includes("cart") &&
+            (line.includes("price") || line.includes("total")) &&
+            (line.includes("* ") || line.includes(" * "))) {
+            if (!content.includes("Decimal") &&
+                !content.includes("roundMoneyAmount") &&
+                !content.includes("toFixed")) {
+                issues.push({
+                    file: relPath,
+                    line: lineNum,
+                    message: "Cart price calculation may have floating point precision issues",
+                    type: "warning",
+                });
+            }
+        }
+        // 4. Cart without listing/catalog validation
+        if (line.includes("addToCart") && !content.includes("listingStatus")) {
+            // Check if context validates listing is available
+            const contextStart = Math.max(0, idx - 20);
+            const contextEnd = Math.min(lines.length, idx + 20);
+            const context = lines.slice(contextStart, contextEnd).join("\n");
+            if (!context.includes("ACTIVE") &&
+                !context.includes("available") &&
+                !context.includes("inStock")) {
+                issues.push({
+                    file: relPath,
+                    line: lineNum,
+                    message: "addToCart without listing status validation",
+                    type: "warning",
+                });
+            }
+        }
+        // 5. Cart mutations without optimistic update rollback
+        if (line.includes("setCart") && (line.includes("fetch") || line.includes("api"))) {
+            const contextStart = Math.max(0, idx - 5);
+            const contextEnd = Math.min(lines.length, idx + 15);
+            const context = lines.slice(contextStart, contextEnd).join("\n");
+            if (!context.includes("catch") &&
+                !context.includes("rollback") &&
+                !context.includes("revert")) {
+                issues.push({
+                    file: relPath,
+                    line: lineNum,
+                    message: "Cart mutation with API call but no error rollback",
+                    type: "warning",
+                });
+            }
+        }
+    });
+}
+function scanDirectory(dir) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        // Skip common non-source directories
+        if (entry.isDirectory()) {
+            if (["node_modules", ".next", "dist", ".git", "test-results", "backups"].includes(entry.name)) {
+                continue;
+            }
+            scanDirectory(fullPath);
+        }
+        else if (entry.isFile() && /\.(tsx?|jsx?)$/.test(entry.name)) {
+            // Only scan files likely to have cart logic
+            const content = fs.readFileSync(fullPath, "utf-8");
+            if (content.includes("cart") || content.includes("Cart")) {
+                scanFile(fullPath, content);
+            }
+        }
+    }
+}
+function main() {
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`  ${console_chars_1.emoji.search} CART DATA INTEGRITY PREFLIGHT`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log("Scanning cart-related files for data integrity issues...\n");
+    // Scan relevant directories
+    const dirsToScan = [
+        path.join(process.cwd(), "app"),
+        path.join(process.cwd(), "components"),
+        path.join(process.cwd(), "hooks"),
+        path.join(process.cwd(), "lib"),
+        path.join(process.cwd(), "contexts"),
+    ];
+    for (const dir of dirsToScan) {
+        if (fs.existsSync(dir)) {
+            scanDirectory(dir);
+        }
+    }
+    // Report results
+    const errors = issues.filter((i) => i.type === "error");
+    const warnings = issues.filter((i) => i.type === "warning");
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    console.log(`${console_chars_1.emoji.chart} Results:`);
+    console.log(`   Errors:   ${errors.length}`);
+    console.log(`   Warnings: ${warnings.length}`);
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERRORS (blocking):\n`);
+        errors.forEach((e) => {
+            console.log(`  ${e.file}:${e.line}`);
+            console.log(`    ${e.message}\n`);
+        });
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} WARNINGS:\n`);
+        // Group by file for readability
+        const byFile = new Map();
+        warnings.forEach((w) => {
+            if (!byFile.has(w.file))
+                byFile.set(w.file, []);
+            byFile.get(w.file).push(w);
+        });
+        byFile.forEach((fileWarnings, file) => {
+            console.log(`  ${file}`);
+            fileWarnings.forEach((w) => {
+                console.log(`    Line ${w.line}: ${w.message}`);
+            });
+            console.log("");
+        });
+    }
+    if (errors.length === 0 && warnings.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} Cart data integrity check passed!\n`);
+        process.exit(0);
+    }
+    else if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Cart data integrity check FAILED (${errors.length} errors)\n`);
+        process.exit(1);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.warning} Cart data integrity check passed with ${warnings.length} warnings\n`);
+        process.exit(0);
+    }
+}
+main();
+//# sourceMappingURL=cart-data-integrity.js.map

package/dist/checks/data-integrity/cart-data-integrity.js.map

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

package/dist/checks/data-integrity/enum-special-chars-validation.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env tsx
+/**
+ * Enum Special Character Mapping Validation - BLOCKING
+ *
+ * Guardrail:
+ * - Ensures brand/enum mappings include special character variants
+ * - GPT/OCR often returns display names with apostrophes, colons, accents
+ * - Missing variants cause silent fallback to defaults (e.g., TOPPS)
+ *
+ * Why this exists:
+ * - "Collector's Edge" was falling back to TOPPS because only "collectors edge" was mapped
+ * - "Magic: The Gathering" needs colon variant
+ * - "Pokémon" needs accent variant
+ * - "Yu-Gi-Oh!" needs exclamation variant
+ *
+ * Usage:
+ *   pnpm preflight:enum-special-chars
+ *   pnpm preflight:enum-special-chars --verbose
+ */
+export declare const id = "data-integrity/enum-special-chars-validation";
+export declare const name = "Enum Special Character Mapping Validation";
+export declare const category = "data-integrity";
+export declare const blocking = true;
+export declare const description = "Ensures brand/enum mappings include special character variants";
+export declare const tags: string[];
+//# sourceMappingURL=enum-special-chars-validation.d.ts.map

package/dist/checks/data-integrity/enum-special-chars-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-special-chars-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/data-integrity/enum-special-chars-validation.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;GAiBG;AAMH,eAAO,MAAM,EAAE,iDAAiD,CAAC;AACjE,eAAO,MAAM,IAAI,8CAA8C,CAAC;AAChE,eAAO,MAAM,QAAQ,mBAAmB,CAAC;AACzC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,mEAAmE,CAAC;AAC5F,eAAO,MAAM,IAAI,UAA+C,CAAC"}

package/dist/checks/data-integrity/enum-special-chars-validation.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Enum Special Character Mapping Validation - BLOCKING
+ *
+ * Guardrail:
+ * - Ensures brand/enum mappings include special character variants
+ * - GPT/OCR often returns display names with apostrophes, colons, accents
+ * - Missing variants cause silent fallback to defaults (e.g., TOPPS)
+ *
+ * Why this exists:
+ * - "Collector's Edge" was falling back to TOPPS because only "collectors edge" was mapped
+ * - "Magic: The Gathering" needs colon variant
+ * - "Pokémon" needs accent variant
+ * - "Yu-Gi-Oh!" needs exclamation variant
+ *
+ * Usage:
+ *   pnpm preflight:enum-special-chars
+ *   pnpm preflight:enum-special-chars --verbose
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs_1 = require("fs");
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "data-integrity/enum-special-chars-validation";
+exports.name = "Enum Special Character Mapping Validation";
+exports.category = "data-integrity";
+exports.blocking = true;
+exports.description = "Ensures brand/enum mappings include special character variants";
+exports.tags = ["data-integrity", "validation", "blocking"];
+const CHECK_NAME = "Enum Special Character Mapping Validation";
+// Required special character variants for each enum value
+const REQUIRED_VARIANTS = {
+    COLLECTORS_EDGE: ["collector's edge", "collectors edge"],
+    BOWMANS_BEST: ["bowman's best", "bowmans best"],
+    MAGIC_THE_GATHERING: ["magic: the gathering", "magic the gathering"],
+    POKEMON: ["pokémon", "pokemon"],
+    YU_GI_OH: ["yu-gi-oh!", "yu-gi-oh", "yugioh"],
+};
+function checkFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, "utf-8").toLowerCase();
+    const violations = [];
+    for (const [enumValue, requiredVariants] of Object.entries(REQUIRED_VARIANTS)) {
+        // Only check files that have this enum value
+        if (!content.includes(enumValue.toLowerCase()))
+            continue;
+        for (const variant of requiredVariants) {
+            // Check if the variant is mapped (look for it as a key in a mapping)
+            // Pattern: "variant": "ENUM" or 'variant': 'ENUM' or variant: "ENUM"
+            const variantPattern = new RegExp(`["']?${variant.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']?\\s*:\\s*["']?${enumValue}`, "i");
+            if (!variantPattern.test(content)) {
+                violations.push({
+                    file: filePath,
+                    enumValue,
+                    missingVariant: variant,
+                });
+            }
+        }
+    }
+    return violations;
+}
+function main() {
+    console.log(`\n${console_chars_1.chars.info} ${CHECK_NAME} (BLOCKING)`);
+    console.log((0, console_chars_1.createDivider)(70, "heavy") + "\n");
+    const filesToCheck = [
+        "lib/vision/normalization.ts",
+        "lib/enum-helpers.ts",
+    ];
+    const violations = [];
+    for (const file of filesToCheck) {
+        try {
+            violations.push(...checkFile(file));
+        }
+        catch (error) {
+            console.log(`${console_chars_1.chars.warning} Could not read ${file}: ${error}`);
+        }
+    }
+    if (violations.length === 0) {
+        console.log(`${console_chars_1.emoji.success} All special character variants are mapped correctly\n`);
+        process.exit(0);
+    }
+    console.log(`${console_chars_1.emoji.error} Found ${violations.length} missing special character variant(s):\n`);
+    for (const v of violations) {
+        console.log(`  ${console_chars_1.chars.bullet} ${v.file}`);
+        console.log(`    Missing: "${v.missingVariant}" → "${v.enumValue}"`);
+        console.log();
+    }
+    console.log(`\n${console_chars_1.chars.info} Fix: Add the missing variant mappings to the enum helper files.`);
+    console.log(`${console_chars_1.chars.info} Example: "${violations[0]?.missingVariant}": "${violations[0]?.enumValue}"\n`);
+    process.exit(1);
+}
+main();
+//# sourceMappingURL=enum-special-chars-validation.js.map

package/dist/checks/data-integrity/enum-special-chars-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-special-chars-validation.js","sourceRoot":"","sources":["../../../src/checks/data-integrity/enum-special-chars-validation.ts"],"names":[],"mappings":"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"}

package/dist/checks/data-integrity/notification-template-alignment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Preflight: Notification Template Alignment
+ *
+ * Validates that notification preferences pages (seller/buyer) align with
+ * the email templates defined in the system. Ensures no orphaned notifications
+ * or missing templates.
+ *
+ * Categories:
+ * - Buyer: Order notifications, payment confirmations, wishlist alerts
+ * - Seller: Listing status, orders received, payouts, reviews
+ * - Account: Security, verification, account updates
+ * - Marketing: Promotions, newsletters, price alerts
+ * - System: Announcements, maintenance, digests
+ */
+export declare const id = "data-integrity/notification-template-alignment";
+export declare const name = "Notification Template Alignment";
+export declare const category = "data-integrity";
+export declare const blocking = false;
+export declare const description = "Preflight: Notification Template Alignment";
+export declare const tags: string[];
+//# sourceMappingURL=notification-template-alignment.d.ts.map

package/dist/checks/data-integrity/notification-template-alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-template-alignment.d.ts","sourceRoot":"","sources":["../../../src/checks/data-integrity/notification-template-alignment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,eAAO,MAAM,EAAE,mDAAmD,CAAC;AACnE,eAAO,MAAM,IAAI,oCAAoC,CAAC;AACtD,eAAO,MAAM,QAAQ,mBAAmB,CAAC;AACzC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,+CAA+C,CAAC;AACxE,eAAO,MAAM,IAAI,UAAqB,CAAC"}