@auto-engineer/design-system-importer 0.4.8 → 0.4.9

package/dist/utils/FilterLoader.js

@@ -3,78 +3,113 @@ import { pathToFileURL, fileURLToPath } from 'url';
 import { existsSync, readFileSync, writeFileSync, mkdtempSync, rmSync } from 'fs';
 import { spawnSync } from 'child_process';
 import { tmpdir } from 'os';
+import createDebug from 'debug';
+const debug = createDebug('design-system-importer:filter-loader');
+const debugLoad = createDebug('design-system-importer:filter-loader:load');
+const debugTS = createDebug('design-system-importer:filter-loader:typescript');
+const debugStrategy = createDebug('design-system-importer:filter-loader:strategy');
+const debugTemplate = createDebug('design-system-importer:filter-loader:template');
 export class FilterLoader {
     constructor() {
+        debug('FilterLoader instance created');
         // Get the directory where template files are stored
         const currentFile = fileURLToPath(import.meta.url);
         this.templatesDir = join(dirname(currentFile), 'templates');
+        debug('Templates directory: %s', this.templatesDir);
     }
     async loadFilter(filePath) {
+        debugLoad('Loading filter from: %s', filePath);
         if (typeof filePath !== 'string' || filePath.trim().length === 0) {
+            debugLoad('ERROR: Invalid filter path provided');
             throw new Error('Filter file path is required');
         }
         const absolutePath = resolvePath(process.cwd(), filePath);
+        debugLoad('Resolved absolute path: %s', absolutePath);
         if (!existsSync(absolutePath)) {
+            debugLoad('ERROR: Filter file not found at %s', absolutePath);
             throw new Error(`Filter file not found: ${absolutePath}`);
         }
         const ext = extname(absolutePath).toLowerCase();
+        debugLoad('File extension: %s', ext);
         // For TypeScript files, use tsx to load them
         if (ext === '.ts' || ext === '.tsx') {
+            debugLoad('Detected TypeScript file, using TypeScript loader');
             return this.loadTypeScriptFilter(absolutePath);
         }
         // For JavaScript files, load directly
+        debugLoad('Loading JavaScript file directly');
         const fileUrl = pathToFileURL(absolutePath).href;
+        debugLoad('File URL: %s', fileUrl);
         const loadedUnknown = await import(fileUrl);
         const loadedModule = loadedUnknown;
+        debugLoad('Module loaded, checking for filter function');
         if (typeof loadedModule.filter === 'function') {
+            debugLoad('Found named export "filter"');
             return loadedModule.filter;
         }
         if (typeof loadedModule.default === 'function') {
+            debugLoad('Found default export, using as filter');
             console.warn('Using default export from filter module. Prefer a named export "filter".');
             return loadedModule.default;
         }
+        debugLoad('ERROR: No filter function found in module');
         throw new Error('No filter function found. Export a function named "filter" or as a default export from the file.');
     }
     async loadTypeScriptFilter(filePath) {
+        debugTS('Loading TypeScript filter from: %s', filePath);
         // Create a temporary directory for our scripts
         const tempDir = mkdtempSync(join(tmpdir(), 'tsx-filter-'));
+        debugTS('Created temp directory: %s', tempDir);
         try {
             const filterUrl = pathToFileURL(filePath).href;
+            debugTS('Filter URL: %s', filterUrl);
             // Try different loading strategies in order
             const strategies = [
                 () => this.tryNodeDirectLoad(tempDir, filterUrl),
                 () => this.tryNpxTsxExport(tempDir, filterUrl),
                 () => this.tryNodeLoaderOptions(tempDir, filterUrl),
             ];
-            for (const strategy of strategies) {
-                const result = await strategy();
+            debugTS('Will try %d loading strategies', strategies.length);
+            for (let i = 0; i < strategies.length; i++) {
+                debugTS('Trying strategy %d/%d', i + 1, strategies.length);
+                const result = await strategies[i]();
                 if (result) {
+                    debugTS('Strategy %d succeeded!', i + 1);
                     return result;
                 }
+                debugTS('Strategy %d failed, trying next...', i + 1);
             }
+            debugTS('ERROR: All strategies failed to load TypeScript filter');
             throw new Error(`TypeScript filter cannot be loaded. ` +
                 `Please ensure tsx is installed in your project:\n` +
                 `  npm install -D tsx\n` +
                 `Or provide a JavaScript version of your filter.`);
         }
         catch (error) {
+            debugTS('ERROR: Failed to load TypeScript filter: %O', error);
             throw new Error(`Failed to load TypeScript filter.\n` +
                 `Error: ${error instanceof Error ? error.message : String(error)}\n` +
                 `Please ensure tsx is installed locally: npm install -D tsx`);
         }
         finally {
+            debugTS('Cleaning up temp directory: %s', tempDir);
             // Clean up temp files
             try {
                 rmSync(tempDir, { recursive: true, force: true });
+                debugTS('Temp directory cleaned up successfully');
             }
-            catch {
+            catch (cleanupError) {
+                debugTS('Warning: Failed to clean up temp directory: %O', cleanupError);
                 // Ignore cleanup errors
             }
         }
     }
     async tryNodeDirectLoad(tempDir, filterUrl) {
+        debugStrategy('Strategy: Node direct load');
         // First attempt: Try to run the loader script with Node.js directly
         const loaderFile = this.prepareTemplate(tempDir, 'tsx-loader.mjs', filterUrl);
+        debugStrategy('Prepared loader file: %s', loaderFile);
+        debugStrategy('Spawning node with experimental loader...');
         const result = spawnSync('node', [loaderFile], {
             cwd: process.cwd(),
             encoding: 'utf-8',
@@ -83,40 +118,64 @@ export class FilterLoader {
                 NODE_OPTIONS: '--experimental-loader tsx',
             },
         });
+        debugStrategy('Node process exit code: %d', result.status);
         if (result.status === 0) {
+            debugStrategy('Node direct load succeeded, importing module');
             // Success! Now import the loader module to get the filter
             const loaderModule = (await import(pathToFileURL(loaderFile).href));
+            debugStrategy('Filter function retrieved from module');
             return loaderModule.filter;
         }
+        debugStrategy('Node direct load failed');
+        if (result.stderr) {
+            debugStrategy('Error output: %s', result.stderr);
+        }
         return null;
     }
     async tryNpxTsxExport(tempDir, filterUrl) {
+        debugStrategy('Strategy: npx tsx export');
         // Second attempt: Use npx tsx to run a script that exports the filter
         const exportFile = this.prepareTemplate(tempDir, 'tsx-export.mjs', filterUrl);
+        debugStrategy('Prepared export file: %s', exportFile);
+        debugStrategy('Spawning npx tsx...');
         const npxResult = spawnSync('npx', ['tsx', exportFile], {
             cwd: process.cwd(),
             encoding: 'utf-8',
             shell: true,
         });
+        debugStrategy('npx process exit code: %d', npxResult.status);
         if (npxResult.status === 0 && npxResult.stdout) {
+            debugStrategy('npx tsx succeeded, parsing output');
             try {
                 const output = JSON.parse(npxResult.stdout);
                 if (output.success === true && typeof output.filterCode === 'string' && output.filterCode.length > 0) {
+                    debugStrategy('Successfully parsed filter code, creating function');
                     // Create a function from the filter code
                     // eslint-disable-next-line @typescript-eslint/no-implied-eval, @typescript-eslint/no-unsafe-call
                     const filter = new Function('return ' + output.filterCode)();
+                    debugStrategy('Filter function created successfully');
                     return filter;
                 }
+                debugStrategy('Output missing success flag or filter code');
             }
-            catch {
+            catch (parseError) {
+                debugStrategy('Failed to parse npx output: %O', parseError);
                 // JSON parse failed, try another approach
             }
         }
+        else {
+            debugStrategy('npx tsx failed or no output');
+            if (npxResult.stderr) {
+                debugStrategy('Error output: %s', npxResult.stderr);
+            }
+        }
         return null;
     }
     async tryNodeLoaderOptions(tempDir, filterUrl) {
+        debugStrategy('Strategy: Node loader options');
         // Third attempt: Create a wrapper that uses dynamic import with tsx
         const wrapperFile = this.prepareTemplate(tempDir, 'tsx-wrapper.mjs', filterUrl);
+        debugStrategy('Prepared wrapper file: %s', wrapperFile);
         // Try with various Node.js loader configurations
         const loaderOptions = [
             ['--loader', 'tsx'],
@@ -124,46 +183,67 @@ export class FilterLoader {
             ['--require', 'tsx'],
             ['--import', 'tsx'],
         ];
+        debugStrategy('Will try %d loader configurations', loaderOptions.length);
         for (const options of loaderOptions) {
+            debugStrategy('Trying loader options: %s', options.join(' '));
             const testResult = spawnSync('node', [...options, wrapperFile], {
                 cwd: process.cwd(),
                 encoding: 'utf-8',
                 env: { ...process.env },
             });
+            debugStrategy('Exit code: %d', testResult.status);
             if (testResult.status === 0) {
+                debugStrategy('Configuration works! Loading final filter');
                 // This configuration works! Use it to load the actual filter
                 const finalFile = this.prepareTemplate(tempDir, 'tsx-final-loader.mjs', filterUrl);
                 const finalModule = (await import(pathToFileURL(finalFile).href));
+                debugStrategy('Filter loaded successfully with options: %s', options.join(' '));
                 return finalModule.filter;
             }
+            else if (testResult.stderr) {
+                debugStrategy('Error with %s: %s', options.join(' '), testResult.stderr);
+            }
         }
+        debugStrategy('All loader options failed');
         return null;
     }
     prepareTemplate(tempDir, templateName, filterPath) {
+        debugTemplate('Preparing template: %s', templateName);
+        debugTemplate('Filter path: %s', filterPath);
         const templatePath = join(this.templatesDir, templateName);
         const outputPath = join(tempDir, templateName);
+        debugTemplate('Template path: %s', templatePath);
+        debugTemplate('Output path: %s', outputPath);
         // Read the template
         let content;
         if (existsSync(templatePath)) {
+            debugTemplate('Reading template from source');
             content = readFileSync(templatePath, 'utf-8');
         }
         else {
+            debugTemplate('Template not in source, checking dist');
             // Fallback to dist directory if running from compiled code
             const distTemplatePath = templatePath.replace('/src/', '/dist/');
+            debugTemplate('Checking dist path: %s', distTemplatePath);
             if (existsSync(distTemplatePath)) {
+                debugTemplate('Reading template from dist');
                 content = readFileSync(distTemplatePath, 'utf-8');
             }
             else {
+                debugTemplate('ERROR: Template not found in source or dist');
                 throw new Error(`Template not found: ${templateName}`);
             }
         }
         // Replace the placeholder with the actual filter path
         content = content.replace(/__FILTER_PATH__/g, filterPath);
+        debugTemplate('Replaced filter path placeholder');
         // Write the prepared script
         writeFileSync(outputPath, content);
+        debugTemplate('Written prepared script to: %s', outputPath);
         return outputPath;
     }
     cleanup() {
+        debug('FilterLoader cleanup called');
         // No cleanup needed
     }
 }

package/dist/utils/FilterLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterLoader.js","sourceRoot":"","sources":["../../src/utils/FilterLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAG5B,MAAM,OAAO,YAAY;IAGvB;QACE,oDAAoD;QACpD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QAE1D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAEhD,6CAA6C;QAC7C,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC;QAED,sCAAsC;QACtC,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;QACjD,MAAM,aAAa,GAAY,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,aAAwD,CAAC;QAE9E,IAAI,OAAO,YAAY,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9C,OAAO,YAAY,CAAC,MAA4B,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;YACzF,OAAO,YAAY,CAAC,OAA6B,CAAC;QACpD,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;IACtH,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,QAAgB;QACjD,+CAA+C;QAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;YAE/C,4CAA4C;YAC5C,MAAM,UAAU,GAAG;gBACjB,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC;gBAChD,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;gBAC9C,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC;aACpD,CAAC;YAEF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;gBAChC,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YAED,MAAM,IAAI,KAAK,CACb,sCAAsC;gBACpC,mDAAmD;gBACnD,wBAAwB;gBACxB,iDAAiD,CACpD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,qCAAqC;gBACnC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;gBACpE,4DAA4D,CAC/D,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,sBAAsB;YACtB,IAAI,CAAC;gBACH,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,SAAiB;QAChE,oEAAoE;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE;YAC7C,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,QAAQ,EAAE,OAAO;YACjB,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,YAAY,EAAE,2BAA2B;aAC1C;SACF,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,0DAA0D;YAC1D,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAmC,CAAC;YACtG,OAAO,YAAY,CAAC,MAAM,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,SAAiB;QAC9D,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAE9E,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE;YACtD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAA8C,CAAC;gBACzF,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrG,yCAAyC;oBACzC,iGAAiG;oBACjG,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,EAAwB,CAAC;oBACnF,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,SAAiB;QACnE,oEAAoE;QACpE,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;QAEhF,iDAAiD;QACjD,MAAM,aAAa,GAAG;YACpB,CAAC,UAAU,EAAE,KAAK,CAAC;YACnB,CAAC,uBAAuB,EAAE,KAAK,CAAC;YAChC,CAAC,WAAW,EAAE,KAAK,CAAC;YACpB,CAAC,UAAU,EAAE,KAAK,CAAC;SACpB,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,WAAW,CAAC,EAAE;gBAC9D,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;gBAClB,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;aACxB,CAAC,CAAC;YAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,6DAA6D;gBAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAC;gBACnF,MAAM,WAAW,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAmC,CAAC;gBACpG,OAAO,WAAW,CAAC,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,eAAe,CAAC,OAAe,EAAE,YAAoB,EAAE,UAAkB;QAC/E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAE/C,oBAAoB;QACpB,IAAI,OAAe,CAAC;QACpB,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,2DAA2D;YAC3D,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjE,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACjC,OAAO,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;QAE1D,4BAA4B;QAC5B,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEnC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,oBAAoB;IACtB,CAAC;CACF"}
+{"version":3,"file":"FilterLoader.js","sourceRoot":"","sources":["../../src/utils/FilterLoader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auto-engineer/design-system-importer",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@auto-engineer/message-bus": "^0.3.3",
+    "@auto-engineer/message-bus": "^0.3.4",
     "figma-api": "2.0.2-beta",
     "tsx": "^3.12.7"
   },

package/src/FigmaComponentsBuilder.ts

@@ -1,11 +1,20 @@
 import * as dotenv from 'dotenv';
 import * as Figma from 'figma-api';
+import createDebug from 'debug';
+
+const debug = createDebug('design-system-importer:figma-builder');
+const debugComponents = createDebug('design-system-importer:figma-builder:components');
+const debugFilters = createDebug('design-system-importer:figma-builder:filters');
+const debugAPI = createDebug('design-system-importer:figma-builder:api');
+const debugTree = createDebug('design-system-importer:figma-builder:tree');
 
 dotenv.config();
 
+debug('Initializing FigmaComponentsBuilder module');
 const figmaApi = new Figma.Api({
   personalAccessToken: process.env.FIGMA_PERSONAL_TOKEN as string,
 });
+debug('Figma API initialized with personal access token');
 
 export interface FigmaComponent {
   name: string;
@@ -26,47 +35,79 @@ interface FigmaNode {
 export class FigmaComponentsBuilder {
   components: FigmaComponent[] = [];
 
+  constructor() {
+    debug('FigmaComponentsBuilder instance created');
+    debugComponents('Initial components array: empty');
+  }
+
   async withFigmaComponents() {
+    debugAPI('Fetching Figma components from file: %s', process.env.FIGMA_FILE_ID);
     try {
+      debugAPI('Making API call to getFileComponents...');
       // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
       const response = await figmaApi.getFileComponents({ file_key: process.env.FIGMA_FILE_ID });
+      debugAPI('API response received');
       // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
       if (response.meta.components.length > 0) {
         // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-        console.log(JSON.stringify(response.meta.components.length, null, 2));
+        debugComponents('Found %d components in Figma file', response.meta.components.length);
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment,@typescript-eslint/no-unsafe-call,@typescript-eslint/no-unsafe-member-access
         this.components = response.meta.components.map(
-          (component: { name: string; description: string; thumbnail_url: string }) => ({
-            name: component.name,
-            description: component.description,
-            thumbnail: component.thumbnail_url,
-          }),
+          (component: { name: string; description: string; thumbnail_url: string }) => {
+            debugComponents('Processing component: %s', component.name);
+            return {
+              name: component.name,
+              description: component.description,
+              thumbnail: component.thumbnail_url,
+            };
+          },
         );
+        debugComponents('Successfully mapped %d components', this.components.length);
+      } else {
+        debugComponents('No components found in Figma file');
       }
     } catch (e) {
-      console.error(e);
+      debugAPI('ERROR: Failed to fetch Figma components: %O', e);
+      console.error('Failed to fetch Figma components:', e);
     }
+    debugComponents('withFigmaComponents complete, total components: %d', this.components.length);
     return this;
   }
 
   async withFigmaComponentSets() {
+    debugAPI('Fetching Figma component sets from file: %s', process.env.FIGMA_FILE_ID);
     try {
+      debugAPI('Making API call to getFileComponentSets...');
       // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
       const response = await figmaApi.getFileComponentSets({ file_key: process.env.FIGMA_FILE_ID });
+      debugAPI('API response received');
       // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
       if (response.meta.component_sets.length > 0) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        debugComponents('Found %d component sets in Figma file', response.meta.component_sets.length);
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment,@typescript-eslint/no-unsafe-call,@typescript-eslint/no-unsafe-member-access
         this.components = response.meta.component_sets.map(
-          (component: { name: string; description: string; thumbnail_url: string }) => ({
-            name: component.name,
-            description: component.description ?? 'N/A',
-            thumbnail: component.thumbnail_url ?? 'N/A',
-          }),
+          (component: { name: string; description: string; thumbnail_url: string }) => {
+            debugComponents('Processing component set: %s', component.name);
+            const mapped = {
+              name: component.name,
+              description: component.description ?? 'N/A',
+              thumbnail: component.thumbnail_url ?? 'N/A',
+            };
+            debugComponents('  - Description: %s', mapped.description.substring(0, 50));
+            debugComponents('  - Has thumbnail: %s', mapped.thumbnail !== 'N/A');
+            return mapped;
+          },
         );
+        debugComponents('Successfully mapped %d component sets', this.components.length);
+      } else {
+        debugComponents('No component sets found in Figma file');
       }
     } catch (e) {
-      console.error(e);
+      debugAPI('ERROR: Failed to fetch Figma component sets: %O', e);
+      console.error('Failed to fetch Figma component sets:', e);
     }
+    debugComponents('withFigmaComponentSets complete, total components: %d', this.components.length);
     return this;
   }
 
@@ -81,73 +122,107 @@ export class FigmaComponentsBuilder {
   // }
 
   withFilteredNamesForShadcn(): void {
+    debugFilters('Applying Shadcn name filter to %d components', this.components.length);
+    const originalCount = this.components.length;
     this.components = this.components
       .map((comp: FigmaComponent): FigmaComponent | null => {
-        if (!comp?.name) return null;
+        if (!comp?.name) {
+          debugFilters('Skipping component with no name');
+          return null;
+        }
 
         let str = comp.name.trim();
+        debugFilters('Processing component name: %s', str);
 
         if (str.includes('/')) {
+          const original = str;
           str = str.split('/')[0].trim();
+          debugFilters('  Split by /: %s -> %s', original, str);
         } else {
+          const original = str;
           str = str.split(' ')[0].trim();
+          debugFilters('  Split by space: %s -> %s', original, str);
         }
 
         if (str.length > 0) {
-          str = str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+          const capitalized = str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+          const final = capitalized.toLowerCase();
+          debugFilters('  Normalized: %s -> %s', str, final);
+          return {
+            ...comp,
+            name: final,
+          };
         } else {
+          debugFilters('  Empty string after processing, skipping');
           return null;
         }
-
-        return {
-          ...comp,
-          name: str.toLowerCase(),
-        };
       })
       .filter((c: FigmaComponent | null): c is FigmaComponent => Boolean(c));
+    debugFilters('Shadcn filter complete: %d -> %d components', originalCount, this.components.length);
   }
 
   withFilter(filter: FilterFunctionType): void {
+    debugFilters('Applying custom filter function to %d components', this.components.length);
+    const originalCount = this.components.length;
     try {
       this.components = filter(this.components);
+      debugFilters('Custom filter applied successfully: %d -> %d components', originalCount, this.components.length);
     } catch (e) {
+      debugFilters('ERROR: Failed to apply custom filter: %O', e);
       console.error('Error applying custom filter:', e);
     }
   }
 
   async withAllFigmaInstanceNames() {
+    debugAPI('Fetching all Figma instance names from file: %s', process.env.FIGMA_FILE_ID);
     try {
       /// ----
       const usedComponentMap = new Map<string, { name: string; description: string; thumbnail: string }>();
+      debugTree('Created component map for tracking unique instances');
 
+      debugAPI('Making API call to getFile with depth: 1...');
       // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
       const { document } = await figmaApi.getFile({
         file_key: process.env.FIGMA_FILE_ID,
         depth: 1,
       });
+      debugAPI('File document received, starting tree walk');
+
+      // eslint-disable-next-line complexity
+      function walkTree(node: FigmaNode, depth: number = 0) {
+        const indent = '  '.repeat(depth);
+        debugTree('%sVisiting node: %s (type: %s)', indent, node.name, node.type);
 
-      function walkTree(node: FigmaNode) {
         if (node.type === 'INSTANCE' && Boolean(node.name)) {
           if (!usedComponentMap.has(node.name)) {
+            debugTree('%s  -> Found new instance: %s', indent, node.name);
             usedComponentMap.set(node.name, {
               name: node.name,
               description: node.description ?? '',
               thumbnail: node.thumbnail_url ?? '',
             });
+            debugTree('%s     Description: %s', indent, node.description ? 'present' : 'empty');
+            debugTree('%s     Thumbnail: %s', indent, node.thumbnail_url ? 'present' : 'missing');
+          } else {
+            debugTree('%s  -> Instance already tracked: %s', indent, node.name);
           }
         }
 
         // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         if (node.children) {
+          debugTree('%s  Has %d children', indent, node.children.length);
           for (const child of node.children) {
-            walkTree(child);
+            walkTree(child, depth + 1);
           }
         }
       }
 
+      debugTree('Starting tree walk from document root');
       walkTree(document);
+      debugTree('Tree walk complete');
 
       this.components = Array.from(usedComponentMap.values());
+      debugComponents('Extracted %d unique component instances', this.components.length);
 
       /// ----
 
@@ -196,12 +271,20 @@ export class FigmaComponentsBuilder {
       //   );
       // }
     } catch (e) {
-      console.error(e);
+      debugAPI('ERROR: Failed to fetch Figma instance names: %O', e);
+      console.error('Failed to fetch Figma instance names:', e);
     }
+    debugComponents('withAllFigmaInstanceNames complete, total components: %d', this.components.length);
     return this;
   }
 
   build() {
+    debug('Building final component list');
+    debugComponents('Returning %d components', this.components.length);
+    if (this.components.length > 0) {
+      debugComponents('First component: %s', this.components[0].name);
+      debugComponents('Last component: %s', this.components[this.components.length - 1].name);
+    }
     return this.components;
   }
 }