@magentrix-corp/magentrix-cli 1.3.16 → 1.3.17

package/utils/iris/zipper.js

@@ -1,248 +1,248 @@
-import { mkdirSync, rmSync, writeFileSync, readFileSync, existsSync, readdirSync, statSync, chmodSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, basename } from 'node:path';
-import { randomUUID, createHash } from 'node:crypto';
-import archiver from 'archiver';
-import extractZip from 'extract-zip';
-
-// System/hidden files that should never be included in IRIS app zips or hashes
-const IGNORED_FILES = new Set(['.DS_Store', 'Thumbs.db', 'desktop.ini']);
-
-/**
- * Recursively fix permissions on extracted files.
- * Sets directories to 0o755 and files to 0o644.
- * This ensures the current user can read/write/delete the files.
- *
- * @param {string} dir - Directory to fix permissions for
- */
-function fixPermissions(dir) {
-    if (!existsSync(dir)) return;
-
-    try {
-        const stat = statSync(dir);
-        if (stat.isDirectory()) {
-            chmodSync(dir, 0o755);
-            const entries = readdirSync(dir);
-            for (const entry of entries) {
-                fixPermissions(join(dir, entry));
-            }
-        } else {
-            chmodSync(dir, 0o644);
-        }
-    } catch {
-        // Ignore permission errors - best effort
-    }
-}
-
-/**
- * Create a zip file from a build directory with proper Iris structure.
- * The zip will contain a single root folder with the app slug.
- *
- * @param {string} distPath - Path to the build output directory (e.g., ./dist)
- * @param {string} appSlug - Slug for the app (becomes the root folder in zip)
- * @returns {Promise<Buffer>} - The zip file as a Buffer
- */
-export async function createIrisZip(distPath, appSlug) {
-    return new Promise((resolve, reject) => {
-        const chunks = [];
-
-        const archive = archiver('zip', {
-            zlib: { level: 9 } // Maximum compression
-        });
-
-        archive.on('data', (chunk) => {
-            chunks.push(chunk);
-        });
-
-        archive.on('error', (err) => {
-            reject(err);
-        });
-
-        archive.on('end', () => {
-            resolve(Buffer.concat(chunks));
-        });
-
-        // Add the dist directory contents under the app slug folder
-        // This creates the structure: appSlug/remoteEntry.js, appSlug/assets/...
-        // Filter out OS-generated system files (.DS_Store, Thumbs.db, etc.)
-        archive.directory(distPath, appSlug, (entry) =>
-            IGNORED_FILES.has(basename(entry.name)) ? false : entry
-        );
-
-        archive.finalize();
-    });
-}
-
-/**
- * Extract a zip buffer to a directory.
- *
- * @param {Buffer} zipBuffer - The zip file as a Buffer
- * @param {string} outputDir - Directory to extract to
- * @returns {Promise<string>} - Path to the extracted directory
- */
-export async function extractIrisZip(zipBuffer, outputDir) {
-    // Create a temporary file to hold the zip
-    const tempDir = join(tmpdir(), `iris-extract-${randomUUID()}`);
-    const tempZipPath = join(tempDir, 'temp.zip');
-
-    try {
-        // Create temp directory
-        mkdirSync(tempDir, { recursive: true });
-
-        // Write buffer to temp file
-        writeFileSync(tempZipPath, zipBuffer);
-
-        // Ensure output directory exists
-        mkdirSync(outputDir, { recursive: true });
-
-        // Extract
-        await extractZip(tempZipPath, { dir: outputDir });
-
-        // Fix permissions so files can be deleted/modified later
-        fixPermissions(outputDir);
-
-        return outputDir;
-    } finally {
-        // Cleanup temp directory
-        try {
-            rmSync(tempDir, { recursive: true, force: true });
-        } catch {
-            // Ignore cleanup errors
-        }
-    }
-}
-
-/**
- * Get the size of a buffer in human-readable format.
- *
- * @param {number} bytes - Size in bytes
- * @returns {string} - Human-readable size (e.g., "1.2 MB")
- */
-export function formatFileSize(bytes) {
-    if (bytes === 0) return '0 B';
-
-    const units = ['B', 'KB', 'MB', 'GB'];
-    const k = 1024;
-    const i = Math.floor(Math.log(bytes) / Math.log(k));
-
-    if (i === 0) return `${bytes} ${units[0]}`;
-
-    return `${(bytes / Math.pow(k, i)).toFixed(1)} ${units[i]}`;
-}
-
-/**
- * Count files in a directory recursively.
- *
- * @param {string} dir - Directory path
- * @returns {number} - Number of files
- */
-export function countFiles(dir) {
-    if (!existsSync(dir)) return 0;
-
-    let count = 0;
-
-    function walk(currentDir) {
-        const entries = readdirSync(currentDir);
-        for (const entry of entries) {
-            const fullPath = join(currentDir, entry);
-            const stat = statSync(fullPath);
-            if (stat.isDirectory()) {
-                walk(fullPath);
-            } else {
-                count++;
-            }
-        }
-    }
-
-    walk(dir);
-    return count;
-}
-
-/**
- * Calculate total size of files in a directory recursively.
- *
- * @param {string} dir - Directory path
- * @returns {number} - Total size in bytes
- */
-export function calculateDirSize(dir) {
-    if (!existsSync(dir)) return 0;
-
-    let totalSize = 0;
-
-    function walk(currentDir) {
-        const entries = readdirSync(currentDir);
-        for (const entry of entries) {
-            const fullPath = join(currentDir, entry);
-            const stat = statSync(fullPath);
-            if (stat.isDirectory()) {
-                walk(fullPath);
-            } else {
-                totalSize += stat.size;
-            }
-        }
-    }
-
-    walk(dir);
-    return totalSize;
-}
-
-/**
- * Get list of all files in a directory recursively with relative paths.
- *
- * @param {string} dir - Directory path
- * @param {string} basePath - Base path for relative path calculation
- * @returns {string[]} - Array of relative file paths
- */
-export function getFilesRecursive(dir, basePath = dir) {
-    if (!existsSync(dir)) return [];
-
-    const files = [];
-
-    function walk(currentDir) {
-        const entries = readdirSync(currentDir);
-        for (const entry of entries) {
-            // Skip OS-generated system files
-            if (IGNORED_FILES.has(entry)) continue;
-
-            const fullPath = join(currentDir, entry);
-            const stat = statSync(fullPath);
-            if (stat.isDirectory()) {
-                walk(fullPath);
-            } else {
-                const relativePath = fullPath.slice(basePath.length + 1);
-                files.push(relativePath);
-            }
-        }
-    }
-
-    walk(dir);
-    return files;
-}
-
-/**
- * Calculate a content hash for an entire Iris app folder.
- * Hashes all file contents and their relative paths to detect any changes.
- *
- * @param {string} dir - Directory path to the Iris app
- * @returns {string} - SHA256 hash of all files
- */
-export function hashIrisAppFolder(dir) {
-    if (!existsSync(dir)) return '';
-
-    const hash = createHash('sha256');
-    const files = getFilesRecursive(dir).sort(); // Sort for consistent ordering
-
-    for (const relativePath of files) {
-        const fullPath = join(dir, relativePath);
-        try {
-            const content = readFileSync(fullPath);
-            // Include the relative path in the hash so renames are detected
-            hash.update(relativePath);
-            hash.update(content);
-        } catch {
-            // Skip files we can't read
-        }
-    }
-
-    return hash.digest('hex');
-}
+import { mkdirSync, rmSync, writeFileSync, readFileSync, existsSync, readdirSync, statSync, chmodSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, basename } from 'node:path';
+import { randomUUID, createHash } from 'node:crypto';
+import archiver from 'archiver';
+import extractZip from 'extract-zip';
+
+// System/hidden files that should never be included in IRIS app zips or hashes
+const IGNORED_FILES = new Set(['.DS_Store', 'Thumbs.db', 'desktop.ini']);
+
+/**
+ * Recursively fix permissions on extracted files.
+ * Sets directories to 0o755 and files to 0o644.
+ * This ensures the current user can read/write/delete the files.
+ *
+ * @param {string} dir - Directory to fix permissions for
+ */
+function fixPermissions(dir) {
+    if (!existsSync(dir)) return;
+
+    try {
+        const stat = statSync(dir);
+        if (stat.isDirectory()) {
+            chmodSync(dir, 0o755);
+            const entries = readdirSync(dir);
+            for (const entry of entries) {
+                fixPermissions(join(dir, entry));
+            }
+        } else {
+            chmodSync(dir, 0o644);
+        }
+    } catch {
+        // Ignore permission errors - best effort
+    }
+}
+
+/**
+ * Create a zip file from a build directory with proper Iris structure.
+ * The zip will contain a single root folder with the app slug.
+ *
+ * @param {string} distPath - Path to the build output directory (e.g., ./dist)
+ * @param {string} appSlug - Slug for the app (becomes the root folder in zip)
+ * @returns {Promise<Buffer>} - The zip file as a Buffer
+ */
+export async function createIrisZip(distPath, appSlug) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+
+        const archive = archiver('zip', {
+            zlib: { level: 9 } // Maximum compression
+        });
+
+        archive.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+
+        archive.on('error', (err) => {
+            reject(err);
+        });
+
+        archive.on('end', () => {
+            resolve(Buffer.concat(chunks));
+        });
+
+        // Add the dist directory contents under the app slug folder
+        // This creates the structure: appSlug/remoteEntry.js, appSlug/assets/...
+        // Filter out OS-generated system files (.DS_Store, Thumbs.db, etc.)
+        archive.directory(distPath, appSlug, (entry) =>
+            IGNORED_FILES.has(basename(entry.name)) ? false : entry
+        );
+
+        archive.finalize();
+    });
+}
+
+/**
+ * Extract a zip buffer to a directory.
+ *
+ * @param {Buffer} zipBuffer - The zip file as a Buffer
+ * @param {string} outputDir - Directory to extract to
+ * @returns {Promise<string>} - Path to the extracted directory
+ */
+export async function extractIrisZip(zipBuffer, outputDir) {
+    // Create a temporary file to hold the zip
+    const tempDir = join(tmpdir(), `iris-extract-${randomUUID()}`);
+    const tempZipPath = join(tempDir, 'temp.zip');
+
+    try {
+        // Create temp directory
+        mkdirSync(tempDir, { recursive: true });
+
+        // Write buffer to temp file
+        writeFileSync(tempZipPath, zipBuffer);
+
+        // Ensure output directory exists
+        mkdirSync(outputDir, { recursive: true });
+
+        // Extract
+        await extractZip(tempZipPath, { dir: outputDir });
+
+        // Fix permissions so files can be deleted/modified later
+        fixPermissions(outputDir);
+
+        return outputDir;
+    } finally {
+        // Cleanup temp directory
+        try {
+            rmSync(tempDir, { recursive: true, force: true });
+        } catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+
+/**
+ * Get the size of a buffer in human-readable format.
+ *
+ * @param {number} bytes - Size in bytes
+ * @returns {string} - Human-readable size (e.g., "1.2 MB")
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0) return '0 B';
+
+    const units = ['B', 'KB', 'MB', 'GB'];
+    const k = 1024;
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+    if (i === 0) return `${bytes} ${units[0]}`;
+
+    return `${(bytes / Math.pow(k, i)).toFixed(1)} ${units[i]}`;
+}
+
+/**
+ * Count files in a directory recursively.
+ *
+ * @param {string} dir - Directory path
+ * @returns {number} - Number of files
+ */
+export function countFiles(dir) {
+    if (!existsSync(dir)) return 0;
+
+    let count = 0;
+
+    function walk(currentDir) {
+        const entries = readdirSync(currentDir);
+        for (const entry of entries) {
+            const fullPath = join(currentDir, entry);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                walk(fullPath);
+            } else {
+                count++;
+            }
+        }
+    }
+
+    walk(dir);
+    return count;
+}
+
+/**
+ * Calculate total size of files in a directory recursively.
+ *
+ * @param {string} dir - Directory path
+ * @returns {number} - Total size in bytes
+ */
+export function calculateDirSize(dir) {
+    if (!existsSync(dir)) return 0;
+
+    let totalSize = 0;
+
+    function walk(currentDir) {
+        const entries = readdirSync(currentDir);
+        for (const entry of entries) {
+            const fullPath = join(currentDir, entry);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                walk(fullPath);
+            } else {
+                totalSize += stat.size;
+            }
+        }
+    }
+
+    walk(dir);
+    return totalSize;
+}
+
+/**
+ * Get list of all files in a directory recursively with relative paths.
+ *
+ * @param {string} dir - Directory path
+ * @param {string} basePath - Base path for relative path calculation
+ * @returns {string[]} - Array of relative file paths
+ */
+export function getFilesRecursive(dir, basePath = dir) {
+    if (!existsSync(dir)) return [];
+
+    const files = [];
+
+    function walk(currentDir) {
+        const entries = readdirSync(currentDir);
+        for (const entry of entries) {
+            // Skip OS-generated system files
+            if (IGNORED_FILES.has(entry)) continue;
+
+            const fullPath = join(currentDir, entry);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                walk(fullPath);
+            } else {
+                const relativePath = fullPath.slice(basePath.length + 1);
+                files.push(relativePath);
+            }
+        }
+    }
+
+    walk(dir);
+    return files;
+}
+
+/**
+ * Calculate a content hash for an entire Iris app folder.
+ * Hashes all file contents and their relative paths to detect any changes.
+ *
+ * @param {string} dir - Directory path to the Iris app
+ * @returns {string} - SHA256 hash of all files
+ */
+export function hashIrisAppFolder(dir) {
+    if (!existsSync(dir)) return '';
+
+    const hash = createHash('sha256');
+    const files = getFilesRecursive(dir).sort(); // Sort for consistent ordering
+
+    for (const relativePath of files) {
+        const fullPath = join(dir, relativePath);
+        try {
+            const content = readFileSync(fullPath);
+            // Include the relative path in the hash so renames are detected
+            hash.update(relativePath);
+            hash.update(content);
+        } catch {
+            // Skip files we can't read
+        }
+    }
+
+    return hash.digest('hex');
+}