@empline/preflight 1.1.31 → 1.1.33

package/dist/checks/checkout/checkout-tax-consistency.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requires = exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+/**
+ * Checkout Tax Consistency Preflight
+ *
+ * Validates that tax calculations are consistent and correct:
+ * 1. Tax calculated server-side (not client-side only)
+ * 2. Tax rate applied consistently across checkout flow
+ * 3. Tax included in order total calculation
+ * 4. Tax amount stored in order record
+ * 5. Total = subtotal + shipping + tax
+ *
+ * Prevents:
+ * - Client-side tax manipulation
+ * - Inconsistent tax rates
+ * - Missing tax in order totals
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+// METADATA - Required for plugin loader discovery
+exports.id = "checkout/checkout-tax-consistency";
+exports.name = "Checkout Tax Consistency";
+exports.description = "Validates tax calculations are consistent and server-side";
+exports.category = "checkout";
+exports.blocking = true;
+exports.tags = ["checkout", "tax", "pricing", "validation", "ecommerce"];
+exports.requires = ["trading-card-system"];
+/**
+ * Files to check
+ */
+const CHECKOUT_FILES = [
+    "app/api/orders/create/route.ts",
+    "app/api/orders/capture/route.ts",
+    "app/api/orders/process/route.ts",
+    "lib/order-service.ts",
+    "lib/pricing*.ts",
+    "lib/tax*.ts",
+];
+const SCHEMA_FILES = [
+    "prisma/schema.prisma",
+];
+/**
+ * Required patterns
+ */
+const REQUIRED_PATTERNS = {
+    // Server-side tax calculation
+    serverSideTaxCalc: {
+        pattern: /tax\s*=.*(?:subtotal|total).*\*|taxRate|calculateTax|getTaxAmount/i,
+        description: "Server-side tax calculation",
+        critical: true,
+    },
+    // Tax rate constant or config
+    taxRateDefinition: {
+        pattern: /TAX_RATE|taxRate\s*[:=]\s*0\.\d+|0\.08|8\s*%|tax.*percent/i,
+        description: "Tax rate definition/constant",
+        critical: true,
+    },
+    // Tax in total calculation
+    taxInTotalCalc: {
+        pattern: /total\s*=.*\+.*tax|subtotal.*shipping.*tax|totalAmount.*tax/i,
+        description: "Tax included in total calculation",
+        critical: true,
+    },
+    // Tax field in order schema/creation
+    taxInOrderRecord: {
+        pattern: /tax:\s*(?:Decimal|Float|Number)|tax\s*Decimal|data:\s*\{[^}]*tax:/i,
+        description: "Tax amount stored in order record",
+        critical: true,
+    },
+    // Decimal precision for monetary values
+    decimalPrecision: {
+        pattern: /Decimal|toFixed\s*\(\s*2\s*\)|\.round\(|monetary|currency/i,
+        description: "Decimal precision for monetary calculations",
+        critical: false,
+    },
+};
+/**
+ * Anti-patterns
+ */
+const ANTI_PATTERNS = {
+    // Tax from client request
+    taxFromClient: {
+        pattern: /req\.body\.tax|request\.json\(\).*tax|body\.tax\s*\|\||tax:\s*body\.tax/,
+        description: "Tax value accepted from client (should be calculated server-side)",
+    },
+    // Tax calculation on client only
+    clientOnlyTax: {
+        pattern: /['"]use client['"]\s*[\s\S]*?taxRate\s*\*\s*subtotal/,
+        description: "Tax calculated only on client side",
+    },
+    // Floating point math for money
+    floatMathForMoney: {
+        pattern: /(?:price|total|subtotal|tax)\s*\*\s*(?:price|quantity)(?!.*Decimal)/,
+        description: "Floating point math for monetary values (use Decimal)",
+    },
+};
+async function run() {
+    console.log(`\n${console_chars_1.emoji.chart} CHECKOUT TAX CONSISTENCY CHECK`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const issues = [];
+    const filesChecked = [];
+    // Find files
+    const allPatterns = [...CHECKOUT_FILES, ...SCHEMA_FILES];
+    const allFiles = [];
+    for (const pattern of allPatterns) {
+        const matches = await (0, glob_1.glob)(pattern, { cwd: process.cwd() });
+        allFiles.push(...matches);
+    }
+    const uniqueFiles = [...new Set(allFiles)];
+    console.log(`\n${console_chars_1.emoji.search} Scanning ${uniqueFiles.length} checkout/pricing files...`);
+    if (uniqueFiles.length === 0) {
+        console.log(`\n${console_chars_1.emoji.warning} No checkout files found - skipping check`);
+        return { success: true, errors: 0, warnings: 1 };
+    }
+    // Combine content
+    let combinedContent = "";
+    for (const relativePath of uniqueFiles) {
+        const filePath = path_1.default.join(process.cwd(), relativePath);
+        if (!fs_1.default.existsSync(filePath))
+            continue;
+        filesChecked.push(relativePath);
+        const content = fs_1.default.readFileSync(filePath, "utf-8");
+        combinedContent += content + "\n";
+        console.log(`   ${console_chars_1.emoji.file} ${relativePath}`);
+    }
+    // Check required patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking tax calculation patterns...`);
+    for (const [name, check] of Object.entries(REQUIRED_PATTERNS)) {
+        const hasPattern = check.pattern.test(combinedContent);
+        if (!hasPattern) {
+            issues.push({
+                file: "checkout files",
+                type: "missing-pattern",
+                pattern: name,
+                description: check.description,
+                critical: check.critical,
+            });
+            const icon = check.critical ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`   ${icon} Missing: ${check.description}`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success} Found: ${check.description}`);
+        }
+    }
+    // Check anti-patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking for anti-patterns...`);
+    for (const relativePath of filesChecked) {
+        const filePath = path_1.default.join(process.cwd(), relativePath);
+        const content = fs_1.default.readFileSync(filePath, "utf-8");
+        for (const [name, check] of Object.entries(ANTI_PATTERNS)) {
+            if (check.pattern.test(content)) {
+                issues.push({
+                    file: relativePath,
+                    type: "anti-pattern",
+                    pattern: name,
+                    description: check.description,
+                    critical: true,
+                });
+                console.log(`   ${console_chars_1.emoji.error} ${relativePath}: ${check.description}`);
+            }
+        }
+    }
+    // Summary
+    const criticalIssues = issues.filter((i) => i.critical);
+    const warningIssues = issues.filter((i) => !i.critical);
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Files checked: ${filesChecked.length}`);
+    console.log(`   Critical issues: ${criticalIssues.length}`);
+    console.log(`   Warning issues: ${warningIssues.length}`);
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} CHECKOUT TAX CONSISTENCY CHECK PASSED`);
+        return { success: true, errors: 0, warnings: 0 };
+    }
+    if (criticalIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Critical issues:`);
+        for (const issue of criticalIssues) {
+            console.log(`   ${issue.file}: ${issue.description}`);
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.info} Tax consistency requirements:`);
+    console.log(`   1. Tax must be calculated server-side`);
+    console.log(`   2. Tax rate must be defined as constant/config`);
+    console.log(`   3. Total = subtotal + shipping + tax`);
+    console.log(`   4. Tax amount stored in order record`);
+    console.log(`   5. Use Decimal for monetary precision`);
+    if (criticalIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} CHECKOUT TAX CONSISTENCY CHECK FAILED`);
+        return { success: false, errors: criticalIssues.length, warnings: warningIssues.length };
+    }
+    console.log(`\n${console_chars_1.emoji.warning} CHECKOUT TAX CONSISTENCY CHECK PASSED WITH WARNINGS`);
+    return { success: true, errors: 0, warnings: warningIssues.length };
+}
+// Allow direct execution
+if (require.main === module) {
+    run()
+        .then((result) => {
+        process.exit(result.success ? 0 : 1);
+    })
+        .catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=checkout-tax-consistency.js.map

package/dist/checks/checkout/checkout-tax-consistency.js.map

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

package/dist/checks/framework/prisma-version-bugs.d.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * Preflight Check: Prisma Version Known Bugs
+ *
+ * Category: framework
+ * Severity: blocking
+ *
+ * Checks for known problematic Prisma versions that have critical bugs.
+ * This preflight catches version-specific issues that wouldn't be flagged
+ * by simple "outdated package" checks.
+ *
+ * KNOWN ISSUES:
+ * - Prisma 7.0.0-7.2.x: @map() decorator bug with driver adapters (GitHub #27357)
+ *   Causes "The column `(not available)` does not exist" errors at runtime
+ *   when using @prisma/adapter-pg with models that have @map() annotations.
+ *   Fixed in 7.3.0+
+ *
+ * @see https://github.com/prisma/prisma/issues/27357
+ */
+export declare const id = "framework/prisma-version-bugs";
+export declare const name = "Prisma Version Known Bugs";
+export declare const category = "framework";
+export declare const blocking = true;
+export declare const description = "Checks for Prisma versions with known critical bugs";
+export declare const tags: string[];
+/**
+ * Dev version overrides - when a dev version is intentionally used to fix a bug,
+ * document it here so the package update checker doesn't flag it for downgrade.
+ *
+ * Format: { package: "prisma", minDevVersion: "7.3.0-dev.7", reason: "GH-27357 fix" }
+ */
+interface DevOverride {
+    package: string;
+    minDevVersion: string;
+    reason: string;
+    bugId: string;
+}
+declare const APPROVED_DEV_OVERRIDES: DevOverride[];
+declare function isDevVersion(version: string): boolean;
+declare function getApprovedDevOverride(version: string): DevOverride | null;
+export { APPROVED_DEV_OVERRIDES, getApprovedDevOverride, isDevVersion };
+export declare function run(): Promise<{
+    success: boolean;
+    errors: number;
+    warnings: number;
+}>;
+//# sourceMappingURL=prisma-version-bugs.d.ts.map

package/dist/checks/framework/prisma-version-bugs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-version-bugs.d.ts","sourceRoot":"","sources":["../../../src/checks/framework/prisma-version-bugs.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAQH,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAChD,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,wDAAwD,CAAC;AACjF,eAAO,MAAM,IAAI,UAAmD,CAAC;AAErE;;;;;GAKG;AACH,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,QAAA,MAAM,sBAAsB,EAAE,WAAW,EAOxC,CAAC;AA+GF,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,iBAAS,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4BnE;AAGD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,YAAY,EAAE,CAAC;AAqCxE,wBAAsB,GAAG,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8C3F"}

package/dist/checks/framework/prisma-version-bugs.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Preflight Check: Prisma Version Known Bugs
+ *
+ * Category: framework
+ * Severity: blocking
+ *
+ * Checks for known problematic Prisma versions that have critical bugs.
+ * This preflight catches version-specific issues that wouldn't be flagged
+ * by simple "outdated package" checks.
+ *
+ * KNOWN ISSUES:
+ * - Prisma 7.0.0-7.2.x: @map() decorator bug with driver adapters (GitHub #27357)
+ *   Causes "The column `(not available)` does not exist" errors at runtime
+ *   when using @prisma/adapter-pg with models that have @map() annotations.
+ *   Fixed in 7.3.0+
+ *
+ * @see https://github.com/prisma/prisma/issues/27357
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPROVED_DEV_OVERRIDES = exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.getApprovedDevOverride = getApprovedDevOverride;
+exports.isDevVersion = isDevVersion;
+exports.run = run;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const console_chars_1 = require("../../utils/console-chars");
+// Preflight metadata
+exports.id = "framework/prisma-version-bugs";
+exports.name = "Prisma Version Known Bugs";
+exports.category = "framework";
+exports.blocking = true;
+exports.description = "Checks for Prisma versions with known critical bugs";
+exports.tags = ["prisma", "version", "bugs", "driver-adapters"];
+const APPROVED_DEV_OVERRIDES = [
+    {
+        package: "prisma",
+        minDevVersion: "7.3.0-dev.7",
+        reason: "@map() decorator fix with driver adapters",
+        bugId: "GH-27357",
+    },
+];
+exports.APPROVED_DEV_OVERRIDES = APPROVED_DEV_OVERRIDES;
+// Known Prisma bugs with version ranges
+const KNOWN_BUGS = [
+    {
+        id: "GH-27357",
+        affectedVersions: (version) => {
+            // Affected: 7.0.0 to 7.2.x (stable versions)
+            // Fixed in: 7.3.0+ (or 7.3.0-dev.7+)
+            const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-dev\.(\d+))?/);
+            if (!match)
+                return false;
+            const major = parseInt(match[1], 10);
+            const minor = parseInt(match[2], 10);
+            const devNum = match[4] ? parseInt(match[4], 10) : null;
+            // v7.0.0 - v7.2.x are affected
+            if (major === 7 && minor >= 0 && minor <= 2) {
+                return true;
+            }
+            // v7.3.0-dev.0 through v7.3.0-dev.6 are still affected
+            if (major === 7 && minor === 3 && devNum !== null && devNum < 7) {
+                return true;
+            }
+            return false;
+        },
+        condition: () => {
+            // Only applies when using driver adapters
+            return usesDriverAdapter();
+        },
+        title: "@map() decorator bug with driver adapters",
+        description: 'Causes "The column `(not available)` does not exist" runtime errors ' +
+            "when using @prisma/adapter-pg with models that have @map() annotations.",
+        fixedIn: "7.3.0 (or 7.3.0-dev.7+)",
+        reference: "https://github.com/prisma/prisma/issues/27357",
+    },
+];
+function getPackageJsonPath() {
+    return (0, path_1.join)(process.cwd(), "package.json");
+}
+function getPrismaVersion() {
+    const pkgPath = getPackageJsonPath();
+    if (!(0, fs_1.existsSync)(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, "utf-8"));
+        const version = pkg.dependencies?.prisma ||
+            pkg.devDependencies?.prisma ||
+            pkg.dependencies?.["@prisma/client"] ||
+            pkg.devDependencies?.["@prisma/client"];
+        if (!version)
+            return null;
+        // Remove version prefixes like ^ or ~
+        return version.replace(/^[\^~]/, "");
+    }
+    catch {
+        return null;
+    }
+}
+function usesDriverAdapter() {
+    // Check if @prisma/adapter-pg (or other adapters) is in dependencies
+    const pkgPath = getPackageJsonPath();
+    if (!(0, fs_1.existsSync)(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, "utf-8"));
+        const allDeps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        // Check for known driver adapter packages
+        const adapterPackages = [
+            "@prisma/adapter-pg",
+            "@prisma/adapter-neon",
+            "@prisma/adapter-planetscale",
+            "@prisma/adapter-libsql",
+            "@prisma/adapter-d1",
+        ];
+        return adapterPackages.some((adapter) => adapter in allDeps);
+    }
+    catch {
+        return false;
+    }
+}
+function isDevVersion(version) {
+    return version.includes("-dev.") || version.includes("-alpha") || version.includes("-beta");
+}
+function getApprovedDevOverride(version) {
+    if (!isDevVersion(version))
+        return null;
+    // Find matching approved override
+    for (const override of APPROVED_DEV_OVERRIDES) {
+        if (override.package !== "prisma")
+            continue;
+        // Parse version to compare
+        const minMatch = override.minDevVersion.match(/^(\d+)\.(\d+)\.(\d+)-dev\.(\d+)/);
+        const curMatch = version.match(/^(\d+)\.(\d+)\.(\d+)-dev\.(\d+)/);
+        if (!minMatch || !curMatch)
+            continue;
+        const [, minMaj, minMin, minPatch, minDev] = minMatch.map(Number);
+        const [, curMaj, curMin, curPatch, curDev] = curMatch.map(Number);
+        // Check if current version is >= minimum approved version
+        if (curMaj > minMaj ||
+            (curMaj === minMaj && curMin > minMin) ||
+            (curMaj === minMaj && curMin === minMin && curPatch > minPatch) ||
+            (curMaj === minMaj && curMin === minMin && curPatch === minPatch && curDev >= minDev)) {
+            return override;
+        }
+    }
+    return null;
+}
+function checkPrismaVersion() {
+    const version = getPrismaVersion();
+    const usesAdapter = usesDriverAdapter();
+    if (!version) {
+        return {
+            passed: true,
+            version: null,
+            triggeredBugs: [],
+            usesAdapter,
+            approvedDevOverride: null,
+        };
+    }
+    const triggeredBugs = KNOWN_BUGS.filter((bug) => {
+        // Check if version is affected
+        if (!bug.affectedVersions(version))
+            return false;
+        // Check additional conditions if present
+        if (bug.condition && !bug.condition())
+            return false;
+        return true;
+    });
+    const approvedDevOverride = getApprovedDevOverride(version);
+    return {
+        passed: triggeredBugs.length === 0,
+        version,
+        triggeredBugs,
+        usesAdapter,
+        approvedDevOverride,
+    };
+}
+async function run() {
+    console.log(`\n${console_chars_1.emoji.search} PRISMA VERSION KNOWN BUGS CHECK`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const result = checkPrismaVersion();
+    if (!result.version) {
+        console.log(`\n   ${console_chars_1.emoji.warning} Prisma not found in package.json`);
+        console.log(`   Skipping version check.`);
+        console.log(`\n${console_chars_1.emoji.success} PRISMA VERSION CHECK PASSED (no Prisma found)`);
+        return { success: true, errors: 0, warnings: 0 };
+    }
+    console.log(`\n   Prisma version: ${result.version}`);
+    console.log(`   Uses driver adapter: ${result.usesAdapter ? "Yes" : "No"}`);
+    // Show dev override info if applicable
+    if (result.approvedDevOverride) {
+        console.log(`   Approved dev override: Yes`);
+        console.log(`      Reason: ${result.approvedDevOverride.reason} (${result.approvedDevOverride.bugId})`);
+        console.log(`      Note: Do not downgrade to stable until ${result.approvedDevOverride.minDevVersion.split("-")[0]} stable is released`);
+    }
+    if (result.passed) {
+        console.log(`\n${console_chars_1.emoji.success} PRISMA VERSION CHECK PASSED`);
+        console.log(`\nNo known critical bugs affect this Prisma version.`);
+        return { success: true, errors: 0, warnings: 0 };
+    }
+    console.log(`\n${console_chars_1.emoji.error} Found ${result.triggeredBugs.length} known bug(s) affecting this version:`);
+    for (const bug of result.triggeredBugs) {
+        console.log(`\n   [${bug.id}] ${bug.title}`);
+        console.log(`      ${bug.description}`);
+        console.log(`      Fixed in: ${bug.fixedIn}`);
+        console.log(`      Reference: ${bug.reference}`);
+    }
+    console.log(`\n${console_chars_1.emoji.info} FIX:`);
+    console.log(`   Upgrade Prisma to a version with the fix:`);
+    console.log(`   pnpm add prisma@latest @prisma/client@latest @prisma/adapter-pg@latest`);
+    console.log(`\n   Or if the fix is only in dev versions:`);
+    console.log(`   pnpm add prisma@dev @prisma/client@dev @prisma/adapter-pg@dev`);
+    console.log(`\n${console_chars_1.emoji.error} PRISMA VERSION CHECK FAILED`);
+    return { success: false, errors: result.triggeredBugs.length, warnings: 0 };
+}
+// Allow direct execution
+if (require.main === module) {
+    run()
+        .then((result) => {
+        process.exit(result.success ? 0 : 1);
+    })
+        .catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=prisma-version-bugs.js.map

package/dist/checks/framework/prisma-version-bugs.js.map

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

package/dist/checks/framework/turbopack-prisma-external.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * Preflight Check: Turbopack Prisma External Packages
+ *
+ * Category: framework
+ * Severity: blocking
+ *
+ * Ensures that Prisma packages are properly excluded from Turbopack bundling
+ * in next.config.js via serverExternalPackages.
+ *
+ * WHY THIS MATTERS:
+ * When Turbopack bundles @prisma/client, it can mangle the internal column name
+ * resolution, causing runtime errors like:
+ *   "The column `(not available)` does not exist in the current database"
+ *
+ * This happens because Prisma's query builder dynamically resolves column names
+ * at runtime using the generated client's metadata. Turbopack's bundling breaks
+ * this resolution, especially for columns using @map() in the schema.
+ *
+ * SOLUTION:
+ * Add "@prisma/client" and "prisma" to serverExternalPackages in next.config.js
+ * to prevent Turbopack from bundling them.
+ *
+ * @see https://nextjs.org/docs/app/api-reference/next-config-js/serverExternalPackages
+ */
+export declare const id = "framework/turbopack-prisma-external";
+export declare const name = "Turbopack Prisma External Packages";
+export declare const category = "framework";
+export declare const blocking = true;
+export declare const description = "Ensures Prisma packages are excluded from Turbopack bundling";
+export declare const tags: string[];
+export declare function run(): Promise<{
+    success: boolean;
+    errors: number;
+    warnings: number;
+}>;
+//# sourceMappingURL=turbopack-prisma-external.d.ts.map

package/dist/checks/framework/turbopack-prisma-external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turbopack-prisma-external.d.ts","sourceRoot":"","sources":["../../../src/checks/framework/turbopack-prisma-external.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,eAAO,MAAM,EAAE,wCAAwC,CAAC;AACxD,eAAO,MAAM,IAAI,uCAAuC,CAAC;AACzD,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,iEAAiE,CAAC;AAC1F,eAAO,MAAM,IAAI,UAA+C,CAAC;AAmFjE,wBAAsB,GAAG,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAwC3F"}