@empline/preflight 1.0.20

package/dist/checks/business/image-upload-optimization.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Image Upload Optimization Preflight
+ *
+ * Validates that the image upload pipeline includes all required optimizations:
+ * 1. Client-side EXIF rotation (before upload)
+ * 2. WebP conversion (30% smaller uploads)
+ * 3. Parallel front/back upload
+ * 4. Background prefetch for back images
+ * 5. Original JPEG preservation in Cloudflare R2
+ *
+ * These optimizations reduce upload time by 40-60% and improve UX.
+ */
+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("node:fs"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "business/image-upload-optimization";
+exports.name = "Image Upload Optimization";
+exports.category = "business";
+exports.blocking = true;
+exports.description = "Image Upload Optimization Preflight";
+exports.tags = ["business"];
+const results = [];
+function addResult(result) {
+    results.push(result);
+    const icon = result.passed ? console_chars_1.emoji.success : console_chars_1.emoji.error;
+    const location = result.file ? ` (${result.file}${result.line ? `:${result.line}` : ""})` : "";
+    console.log(`  ${icon} ${result.message}${location}`);
+}
+function fileExists(filePath) {
+    return fs.existsSync(filePath);
+}
+function fileContains(filePath, pattern) {
+    if (!fileExists(filePath)) {
+        return { found: false };
+    }
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        if (pattern.test(lines[i] || "")) {
+            return { found: true, line: i + 1 };
+        }
+    }
+    // Check full content for multi-line patterns
+    if (pattern.test(content)) {
+        return { found: true };
+    }
+    return { found: false };
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.rocket} IMAGE UPLOAD OPTIMIZATION VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.info} Validating client-side image optimizations...\n`);
+    // ---
+    // 1. Client-side optimization module exists
+    // ---
+    console.log(`${console_chars_1.emoji.folder} Checking optimization module...`);
+    const clientOptPath = "lib/client-image-optimization.ts";
+    if (!fileExists(clientOptPath)) {
+        addResult({
+            passed: false,
+            message: "Missing client-side optimization module",
+            file: clientOptPath,
+        });
+    }
+    else {
+        addResult({
+            passed: true,
+            message: "Client-side optimization module exists",
+            file: clientOptPath,
+        });
+        // Check for required exports
+        const requiredExports = [
+            { pattern: /export\s+async\s+function\s+readExifOrientation/, name: "readExifOrientation" },
+            { pattern: /export\s+async\s+function\s+applyExifRotation/, name: "applyExifRotation" },
+            { pattern: /export\s+async\s+function\s+convertToWebP/, name: "convertToWebP" },
+            {
+                pattern: /export\s+async\s+function\s+optimizeImageForUpload/,
+                name: "optimizeImageForUpload",
+            },
+            {
+                pattern: /export\s+async\s+function\s+uploadImagesInParallel/,
+                name: "uploadImagesInParallel",
+            },
+            { pattern: /export\s+class\s+BackImagePrefetcher/, name: "BackImagePrefetcher" },
+        ];
+        for (const { pattern, name } of requiredExports) {
+            const result = fileContains(clientOptPath, pattern);
+            addResult({
+                passed: result.found,
+                message: result.found ? `Export '${name}' present` : `Missing export '${name}'`,
+                file: clientOptPath,
+                line: result.line,
+            });
+        }
+    }
+    // ---
+    // 2. EXIF rotation is applied client-side
+    // ---
+    console.log(`\n${console_chars_1.emoji.rotate} Checking EXIF rotation...`);
+    const exifPatterns = [
+        { pattern: /EXIF_ORIENTATIONS/, name: "EXIF orientation mapping" },
+        { pattern: /orientation\s*===?\s*1/, name: "Normal orientation check" },
+        { pattern: /canvas\.toBlob/, name: "Canvas-based rotation" },
+    ];
+    for (const { pattern, name } of exifPatterns) {
+        const result = fileContains(clientOptPath, pattern);
+        addResult({
+            passed: result.found,
+            message: result.found ? `${name} implemented` : `Missing ${name}`,
+            file: clientOptPath,
+            line: result.line,
+        });
+    }
+    // ---
+    // 3. WebP conversion is available
+    // ---
+    console.log(`\n${console_chars_1.emoji.image} Checking WebP conversion...`);
+    const webpPatterns = [
+        { pattern: /image\/webp/, name: "WebP MIME type" },
+        { pattern: /supportsWebP/, name: "WebP support detection" },
+        { pattern: /compressionRatio/, name: "Compression tracking" },
+    ];
+    for (const { pattern, name } of webpPatterns) {
+        const result = fileContains(clientOptPath, pattern);
+        addResult({
+            passed: result.found,
+            message: result.found ? `${name} implemented` : `Missing ${name}`,
+            file: clientOptPath,
+            line: result.line,
+        });
+    }
+    // ---
+    // 4. Parallel upload support
+    // ---
+    console.log(`\n${console_chars_1.emoji.lightning} Checking parallel upload...`);
+    const parallelResult = fileContains(clientOptPath, /Promise\.all\s*\(\s*\[/);
+    addResult({
+        passed: parallelResult.found,
+        message: parallelResult.found
+            ? "Parallel upload (Promise.all) implemented"
+            : "Missing parallel upload support",
+        file: clientOptPath,
+        line: parallelResult.line,
+    });
+    // ---
+    // 5. Background prefetch
+    // ---
+    console.log(`\n${console_chars_1.emoji.clock} Checking background prefetch...`);
+    const prefetchPatterns = [
+        { pattern: /startPrefetch/, name: "Prefetch start method" },
+        { pattern: /getPrefetchedResult/, name: "Prefetch retrieval method" },
+        { pattern: /prefetchPromise/, name: "Prefetch promise storage" },
+    ];
+    for (const { pattern, name } of prefetchPatterns) {
+        const result = fileContains(clientOptPath, pattern);
+        addResult({
+            passed: result.found,
+            message: result.found ? `${name} implemented` : `Missing ${name}`,
+            file: clientOptPath,
+            line: result.line,
+        });
+    }
+    // ---
+    // 6. Original JPEG preservation
+    // ---
+    console.log(`\n${console_chars_1.emoji.archive} Checking original preservation...`);
+    const preservationPatterns = [
+        { pattern: /original:\s*Blob/, name: "Original blob in result type" },
+        { pattern: /originalBlob/, name: "Original blob variable" },
+        { pattern: /image\/jpeg.*0\.95/, name: "High-quality JPEG preservation" },
+    ];
+    for (const { pattern, name } of preservationPatterns) {
+        const result = fileContains(clientOptPath, pattern);
+        addResult({
+            passed: result.found,
+            message: result.found ? `${name} implemented` : `Missing ${name}`,
+            file: clientOptPath,
+            line: result.line,
+        });
+    }
+    // ---
+    // 7. Upload API supports dual format
+    // ---
+    console.log(`\n${console_chars_1.emoji.cloud} Checking upload API...`);
+    const uploadApiPath = "app/api/images/upload/route.ts";
+    if (fileExists(uploadApiPath)) {
+        const dualFormatResult = fileContains(uploadApiPath, /original|archival|preserveOriginal/i);
+        addResult({
+            passed: dualFormatResult.found,
+            message: dualFormatResult.found
+                ? "Upload API supports original preservation"
+                : "Upload API should support original JPEG preservation",
+            file: uploadApiPath,
+            line: dualFormatResult.line,
+        });
+    }
+    else {
+        addResult({
+            passed: false,
+            message: "Upload API route not found",
+            file: uploadApiPath,
+        });
+    }
+    // ---
+    // Summary
+    // ---
+    console.log(`\n${(0, console_chars_1.createDivider)(60, "heavy")}`);
+    const passed = results.filter((r) => r.passed).length;
+    const failed = results.filter((r) => !r.passed).length;
+    const total = results.length;
+    if (failed === 0) {
+        console.log(`${console_chars_1.emoji.success} All ${total} checks passed!`);
+        console.log(`\n${console_chars_1.emoji.rocket} Image upload optimizations are properly configured.`);
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        process.exit(0);
+    }
+    else {
+        console.log(`${console_chars_1.emoji.warning} ${passed}/${total} checks passed, ${failed} failed.`);
+        console.log(`\n${console_chars_1.emoji.error} Image upload optimizations are incomplete.`);
+        console.log(`\nRequired optimizations:`);
+        console.log(`  1. Client-side EXIF rotation (reduces server load)`);
+        console.log(`  2. WebP conversion (30% smaller uploads)`);
+        console.log(`  3. Parallel front/back upload (saves 1-2s)`);
+        console.log(`  4. Background prefetch (smoother UX)`);
+        console.log(`  5. Original JPEG preservation (archival in R2)`);
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=image-upload-optimization.js.map

package/dist/checks/business/image-upload-optimization.js.map

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

package/dist/checks/business/inventory-atomicity-validation.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env tsx
+/**
+ * Inventory Atomicity Validation Preflight
+ *
+ * Ensures inventory operations are atomic and race-condition safe:
+ * - Uses transactions for inventory updates
+ * - Uses optimistic locking or atomic decrements
+ * - No read-then-write patterns without locks
+ * - Proper rollback on payment failures
+ *
+ * BLOCKING: Race conditions cause overselling
+ */
+export declare const id = "business/inventory-atomicity-validation";
+export declare const name = "Inventory Atomicity Validation";
+export declare const category = "business";
+export declare const blocking = true;
+export declare const description = "Inventory Atomicity Validation Preflight";
+export declare const tags: string[];
+//# sourceMappingURL=inventory-atomicity-validation.d.ts.map

package/dist/checks/business/inventory-atomicity-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-atomicity-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/business/inventory-atomicity-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAUH,eAAO,MAAM,EAAE,4CAA4C,CAAC;AAC5D,eAAO,MAAM,IAAI,mCAAmC,CAAC;AACrD,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,6CAA6C,CAAC;AACtE,eAAO,MAAM,IAAI,UAA4B,CAAC"}

package/dist/checks/business/inventory-atomicity-validation.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Inventory Atomicity Validation Preflight
+ *
+ * Ensures inventory operations are atomic and race-condition safe:
+ * - Uses transactions for inventory updates
+ * - Uses optimistic locking or atomic decrements
+ * - No read-then-write patterns without locks
+ * - Proper rollback on payment failures
+ *
+ * BLOCKING: Race conditions cause overselling
+ */
+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 glob_1 = require("glob");
+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 = "business/inventory-atomicity-validation";
+exports.name = "Inventory Atomicity Validation";
+exports.category = "business";
+exports.blocking = true;
+exports.description = "Inventory Atomicity Validation Preflight";
+exports.tags = ["business", "validation"];
+const issues = [];
+// Dangerous patterns that indicate non-atomic inventory operations
+const DANGEROUS_PATTERNS = [
+    // Read quantity then update separately
+    {
+        pattern: /quantityAvailable\s*[<>=]/gi,
+        followedBy: /\.update\s*\(/gi,
+        message: "Read-then-write pattern on inventory - use atomic decrement or transaction",
+        type: "error",
+    },
+    // Direct quantity assignment without transaction
+    {
+        pattern: /quantityAvailable\s*:\s*\d+/gi,
+        notInContext: /\$transaction|\btx\b|transaction/gi,
+        message: "Direct quantity assignment - should use atomic decrement { decrement: N }",
+        type: "warning",
+    },
+];
+// Safe patterns that indicate proper atomic operations
+const SAFE_PATTERNS = [
+    // Atomic decrement
+    /quantityAvailable\s*:\s*\{\s*decrement\s*:/i,
+    // Atomic increment
+    /quantityAvailable\s*:\s*\{\s*increment\s*:/i,
+    // Transaction context
+    /\$transaction/i,
+    // Optimistic locking
+    /version\s*:\s*\{\s*increment/i,
+    // WHERE clause with quantity check
+    /where\s*:\s*\{[^}]*quantityAvailable\s*:\s*\{\s*gte/i,
+];
+// Files/directories to scan
+const SCAN_PATTERNS = ["lib/**/*.ts", "app/api/**/*.ts", "app/api/**/route.ts"];
+// Files to exclude
+const EXCLUDE_PATTERNS = [
+    "**/node_modules/**",
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/test/**",
+    "**/tests/**",
+    "**/__mocks__/**",
+];
+async function scanFile(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    // Check if file deals with inventory
+    if (!content.includes("quantityAvailable") &&
+        !content.includes("quantityAvailable") &&
+        !content.includes("stock")) {
+        return;
+    }
+    // Check if file uses safe patterns
+    const usesSafePatterns = SAFE_PATTERNS.some((pattern) => pattern.test(content));
+    const usesTransaction = /\$transaction/.test(content) || /\btx\b/.test(content);
+    // Look for inventory update patterns
+    lines.forEach((line, index) => {
+        const lineNum = index + 1;
+        // Skip comments
+        if (line.trim().startsWith("//") || line.trim().startsWith("*")) {
+            return;
+        }
+        // Check for direct quantity updates without atomic operations
+        if (/quantityAvailable\s*:\s*[a-zA-Z]/.test(line) && !/{/.test(line)) {
+            // Direct assignment to a variable value
+            if (!usesTransaction) {
+                issues.push({
+                    file: filePath,
+                    line: lineNum,
+                    type: "warning",
+                    message: "Direct quantity assignment outside transaction - potential race condition",
+                    code: line.trim().substring(0, 100),
+                });
+            }
+        }
+        // Check for quantity comparison followed by update (read-then-write)
+        if (/quantityAvailable\s*[<>=!]+\s*\d+/.test(line)) {
+            // Look ahead for update
+            const nextLines = lines.slice(index, index + 10).join("\n");
+            if (/\.update\s*\(/.test(nextLines) && !usesTransaction) {
+                issues.push({
+                    file: filePath,
+                    line: lineNum,
+                    type: "error",
+                    message: "Read-then-write pattern on inventory without transaction - race condition risk",
+                    code: line.trim().substring(0, 100),
+                });
+            }
+        }
+    });
+    // Check for missing rollback on payment failure
+    checkPaymentRollback(filePath, content);
+}
+function checkPaymentRollback(filePath, content) {
+    // If file handles payments and inventory
+    if ((content.includes("payment") || content.includes("capture")) &&
+        (content.includes("quantityAvailable") || content.includes("decrement"))) {
+        // Check for rollback/restore logic
+        const hasRollback = content.includes("increment") ||
+            content.includes("rollback") ||
+            content.includes("restore") ||
+            (content.includes("catch") && content.includes("increment"));
+        if (!hasRollback) {
+            issues.push({
+                file: filePath,
+                line: 1,
+                type: "warning",
+                message: "Payment + inventory logic without visible rollback on failure",
+                code: "Consider: if payment fails, restore inventory with { increment: N }",
+            });
+        }
+    }
+}
+// Check for proper inventory reservation pattern
+async function checkInventoryReservation() {
+    const checkoutFiles = await (0, glob_1.glob)("app/api/**/checkout/**/*.ts", { ignore: EXCLUDE_PATTERNS });
+    const orderFiles = await (0, glob_1.glob)("app/api/**/order*/**/*.ts", { ignore: EXCLUDE_PATTERNS });
+    const files = [...checkoutFiles, ...orderFiles];
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf-8");
+        // Check if checkout/order creation reserves inventory
+        if (content.includes("create") && content.includes("Order")) {
+            const hasInventoryReservation = content.includes("decrement") ||
+                content.includes("quantityAvailable") ||
+                content.includes("reserveInventory") ||
+                content.includes("holdInventory");
+            if (!hasInventoryReservation) {
+                issues.push({
+                    file,
+                    line: 1,
+                    type: "warning",
+                    message: "Order creation without visible inventory reservation",
+                    code: "Orders should reserve inventory atomically on creation",
+                });
+            }
+        }
+    }
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    console.log(`${console_chars_1.emoji.package} Inventory Atomicity Validation Preflight`);
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    // Get all files to scan
+    const files = [];
+    for (const pattern of SCAN_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: EXCLUDE_PATTERNS,
+            nodir: true,
+        });
+        files.push(...matches);
+    }
+    console.log(`Scanning ${files.length} files for inventory atomicity issues...`);
+    // Scan each file
+    for (const file of files) {
+        await scanFile(file);
+    }
+    // Check inventory reservation patterns
+    await checkInventoryReservation();
+    // Report results
+    const errors = issues.filter((i) => i.type === "error");
+    const warnings = issues.filter((i) => i.type === "warning");
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No inventory atomicity issues found`);
+        process.exit(0);
+    }
+    console.log(`\n Found ${errors.length} errors, ${warnings.length} warnings\n`);
+    // Group by file
+    const byFile = new Map();
+    for (const issue of issues) {
+        const existing = byFile.get(issue.file) || [];
+        existing.push(issue);
+        byFile.set(issue.file, existing);
+    }
+    // Print issues
+    for (const [file, fileIssues] of byFile) {
+        console.log(`\n${console_chars_1.emoji.file} ${file}`);
+        for (const issue of fileIssues) {
+            const icon = issue.type === "error" ? `${console_chars_1.emoji.error}` : `${console_chars_1.emoji.warning}`;
+            console.log(`   ${icon} Line ${issue.line}: ${issue.message}`);
+            console.log(`      ${issue.code}`);
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "heavy"));
+    console.log(`${console_chars_1.emoji.hint} Best Practices:`);
+    console.log("   - Use atomic operations: { decrement: N } or { increment: N }");
+    console.log("   - Wrap inventory + payment in $transaction");
+    console.log("   - Use WHERE clause: quantityAvailable: { gte: orderQuantity }");
+    console.log("   - Always rollback inventory on payment failure");
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} BLOCKING: Fix inventory atomicity errors before proceeding`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.warning}  Warnings found - review for potential race conditions`);
+    process.exit(0);
+}
+main().catch(console.error);
+//# sourceMappingURL=inventory-atomicity-validation.js.map

package/dist/checks/business/inventory-atomicity-validation.js.map

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

package/dist/checks/business/order-state-machine-validation.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env tsx
+/**
+ * Order State Machine Validation Preflight
+ *
+ * Ensures order status transitions follow business rules:
+ * - Valid transitions only (PENDING → PAID → SHIPPED → DELIVERED)
+ * - No skipping states
+ * - Cancellation rules enforced
+ * - Refund rules enforced
+ *
+ * BLOCKING: Invalid state transitions cause order processing failures
+ */
+export declare const id = "business/order-state-machine-validation";
+export declare const name = "Order State Machine Validation";
+export declare const category = "business";
+export declare const blocking = true;
+export declare const description = "Order State Machine Validation Preflight";
+export declare const tags: string[];
+//# sourceMappingURL=order-state-machine-validation.d.ts.map

package/dist/checks/business/order-state-machine-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-state-machine-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/business/order-state-machine-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAUH,eAAO,MAAM,EAAE,4CAA4C,CAAC;AAC5D,eAAO,MAAM,IAAI,mCAAmC,CAAC;AACrD,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,6CAA6C,CAAC;AACtE,eAAO,MAAM,IAAI,UAA4B,CAAC"}