pkg-clean 1.0.0

package/dist/packageManagerFactory.js

@@ -0,0 +1,158 @@
+"use strict";
+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.PackageManagerFactory = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * NPM package manager implementation
+ */
+class NpmPackageManager {
+    getType() {
+        return "npm";
+    }
+    removeDependencies(projectRoot, packages) {
+        const pkgPath = path.join(projectRoot, "package.json");
+        if (!fs.existsSync(pkgPath)) {
+            throw new Error("package.json not found");
+        }
+        const content = fs.readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(content);
+        for (const packageName of packages) {
+            delete pkg.dependencies?.[packageName];
+            delete pkg.devDependencies?.[packageName];
+        }
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+        return true;
+    }
+}
+/**
+ * Yarn package manager implementation
+ */
+class YarnPackageManager {
+    getType() {
+        return "yarn";
+    }
+    removeDependencies(projectRoot, packages) {
+        const pkgPath = path.join(projectRoot, "package.json");
+        if (!fs.existsSync(pkgPath)) {
+            throw new Error("package.json not found");
+        }
+        const content = fs.readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(content);
+        for (const packageName of packages) {
+            delete pkg.dependencies?.[packageName];
+            delete pkg.devDependencies?.[packageName];
+        }
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+        return true;
+    }
+}
+/**
+ * pnpm package manager implementation
+ */
+class PnpmPackageManager {
+    getType() {
+        return "pnpm";
+    }
+    removeDependencies(projectRoot, packages) {
+        const pkgPath = path.join(projectRoot, "package.json");
+        if (!fs.existsSync(pkgPath)) {
+            throw new Error("package.json not found");
+        }
+        const content = fs.readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(content);
+        for (const packageName of packages) {
+            delete pkg.dependencies?.[packageName];
+            delete pkg.devDependencies?.[packageName];
+        }
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+        return true;
+    }
+}
+/**
+ * Factory for creating package manager instances.
+ * Detects the package manager type based on lock files in the project.
+ */
+class PackageManagerFactory {
+    /**
+     * Detects the package manager type by looking for lock files.
+     * @param projectRoot - The project root directory
+     * @returns The detected package manager type, defaults to 'npm'
+     */
+    static detect(projectRoot) {
+        // Check for yarn.lock
+        if (fs.existsSync(path.join(projectRoot, "yarn.lock"))) {
+            return "yarn";
+        }
+        // Check for pnpm-lock.yaml
+        if (fs.existsSync(path.join(projectRoot, "pnpm-lock.yaml"))) {
+            return "pnpm";
+        }
+        // Check for package-lock.json
+        if (fs.existsSync(path.join(projectRoot, "package-lock.json"))) {
+            return "npm";
+        }
+        // Default to npm
+        return "npm";
+    }
+    /**
+     * Creates a package manager instance.
+     * @param type - The type of package manager to create
+     * @returns An instance of the specified package manager
+     */
+    static create(type = "npm") {
+        switch (type) {
+            case "yarn":
+                return new YarnPackageManager();
+            case "pnpm":
+                return new PnpmPackageManager();
+            case "npm":
+            default:
+                return new NpmPackageManager();
+        }
+    }
+    /**
+     * Creates and detects the appropriate package manager for a project.
+     * @param projectRoot - The project root directory
+     * @returns An instance of the detected package manager
+     */
+    static createForProject(projectRoot) {
+        const type = this.detect(projectRoot);
+        return this.create(type);
+    }
+}
+exports.PackageManagerFactory = PackageManagerFactory;
+//# sourceMappingURL=packageManagerFactory.js.map

package/dist/packageManagerFactory.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,25 @@
+export interface DeprecationInfo {
+    name: string;
+    deprecated: boolean;
+    replacement?: string;
+    reason?: string;
+}
+/**
+ * Checks npm registry for package deprecation status.
+ * Results are cached to minimize network requests.
+ */
+export declare class Registry {
+    private cache;
+    /**
+     * Checks if a package is deprecated on npm.
+     * @param packageName - The name of the package to check
+     * @returns Deprecation information for the package
+     */
+    checkDeprecation(packageName: string): Promise<DeprecationInfo>;
+    /**
+     * Checks deprecation status for multiple packages in parallel.
+     * @param packages - Array of package names to check
+     * @returns Array of deprecation info for each package
+     */
+    checkMultiple(packages: string[]): Promise<DeprecationInfo[]>;
+}

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAsC;IAEnD;;;;OAIG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2CrE;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAGpE"}

package/dist/registry.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Registry = void 0;
+/**
+ * Checks npm registry for package deprecation status.
+ * Results are cached to minimize network requests.
+ */
+class Registry {
+    constructor() {
+        this.cache = new Map();
+    }
+    /**
+     * Checks if a package is deprecated on npm.
+     * @param packageName - The name of the package to check
+     * @returns Deprecation information for the package
+     */
+    async checkDeprecation(packageName) {
+        if (this.cache.has(packageName)) {
+            return this.cache.get(packageName);
+        }
+        try {
+            const response = await fetch(`https://registry.npmjs.org/${packageName}`);
+            if (!response.ok) {
+                const result = {
+                    name: packageName,
+                    deprecated: false,
+                };
+                this.cache.set(packageName, result);
+                return result;
+            }
+            const data = (await response.json());
+            const deprecated = !!data.deprecated;
+            const reason = typeof data.deprecated === "string" ? data.deprecated : undefined;
+            const result = {
+                name: packageName,
+                deprecated,
+                reason,
+            };
+            this.cache.set(packageName, result);
+            return result;
+        }
+        catch (_a) {
+            // Network error or invalid package
+            const result = {
+                name: packageName,
+                deprecated: false,
+            };
+            this.cache.set(packageName, result);
+            return result;
+        }
+    }
+    /**
+     * Checks deprecation status for multiple packages in parallel.
+     * @param packages - Array of package names to check
+     * @returns Array of deprecation info for each package
+     */
+    async checkMultiple(packages) {
+        return Promise.all(packages.map((pkg) => this.checkDeprecation(pkg)));
+    }
+}
+exports.Registry = Registry;

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":";;;AAOA;;;GAGG;AACH,MAAa,QAAQ;IAArB;QACU,UAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IA0DrD,CAAC;IAxDC;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;QACtC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;YAE1E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAoB;oBAC9B,IAAI,EAAE,WAAW;oBACjB,UAAU,EAAE,KAAK;iBAClB,CAAC;gBACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBACpC,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;YACF,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YACrC,MAAM,MAAM,GACV,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAEpE,MAAM,MAAM,GAAoB;gBAC9B,IAAI,EAAE,WAAW;gBACjB,UAAU;gBACV,MAAM;aACP,CAAC;YAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,MAAM,MAAM,GAAoB;gBAC9B,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,KAAK;aAClB,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,QAAkB;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;CACF;AA3DD,4BA2DC"}

package/dist/registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/registry.test.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const registry_1 = require("./registry");
+describe("Registry", () => {
+    let registry;
+    beforeEach(() => {
+        registry = new registry_1.Registry();
+        // Mock fetch globally
+        global.fetch = jest.fn();
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    it("should cache deprecation checks", async () => {
+        global.fetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ deprecated: false }),
+        });
+        // First call
+        const result1 = await registry.checkDeprecation("commander");
+        // Second call should use cache (fetch not called again)
+        const result2 = await registry.checkDeprecation("commander");
+        expect(result1.name).toBe("commander");
+        expect(result1.deprecated).toBe(false);
+        expect(result2).toEqual(result1);
+        expect(global.fetch).toHaveBeenCalledTimes(1);
+    });
+    it("should handle network errors gracefully", async () => {
+        global.fetch.mockRejectedValueOnce(new Error("Network error"));
+        const result = await registry.checkDeprecation("invalid-pkg-name-xyz123");
+        expect(result.name).toBe("invalid-pkg-name-xyz123");
+        expect(result.deprecated).toBe(false);
+    });
+    it("should parse deprecated string reason", async () => {
+        global.fetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                deprecated: "Use package-x instead",
+            }),
+        });
+        const result = await registry.checkDeprecation("old-package");
+        expect(result.name).toBe("old-package");
+        expect(result.deprecated).toBe(true);
+        expect(result.reason).toBe("Use package-x instead");
+    });
+    it("should handle 404 responses gracefully", async () => {
+        global.fetch.mockResolvedValueOnce({
+            ok: false,
+            status: 404,
+        });
+        const result = await registry.checkDeprecation("nonexistent-package");
+        expect(result.name).toBe("nonexistent-package");
+        expect(result.deprecated).toBe(false);
+    });
+    it("should check multiple packages in parallel", async () => {
+        global.fetch
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ deprecated: false }),
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ deprecated: true, reason: "Deprecated" }),
+        });
+        const results = await registry.checkMultiple(["commander", "old-pkg"]);
+        expect(results).toHaveLength(2);
+        expect(results[0].name).toBe("commander");
+        expect(results[0].deprecated).toBe(false);
+        expect(results[1].name).toBe("old-pkg");
+        expect(results[1].deprecated).toBe(true);
+    });
+});

package/dist/scanner.d.ts

@@ -0,0 +1,20 @@
+interface ScannerOptions {
+    ignore?: string[];
+}
+/**
+ * Scans project source files to extract imported package names.
+ * Supports ES6 imports and CommonJS require() statements.
+ */
+export declare class Scanner {
+    private importRegex;
+    /**
+     * Recursively scans a directory for imported packages.
+     * @param projectRoot - The root directory to scan
+     * @param options - Scanner configuration options
+     * @param options.ignore - Array of directory names to exclude (default: node_modules, dist, build)
+     * @returns A set of unique package names found in imports
+     */
+    scan(projectRoot: string, options?: ScannerOptions): Promise<Set<string>>;
+    private isCodeFile;
+}
+export {};

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,OAAO;IAElB,OAAO,CAAC,WAAW,CAC8D;IAEjF;;;;;;OAMG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAmCvB,OAAO,CAAC,UAAU;CAInB"}

package/dist/scanner.js

@@ -0,0 +1,89 @@
+"use strict";
+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.Scanner = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Scans project source files to extract imported package names.
+ * Supports ES6 imports and CommonJS require() statements.
+ */
+class Scanner {
+    constructor() {
+        // Matches: import 'x', import from 'x', require('x'), etc.
+        this.importRegex = /(?:import\s+(?:.*\s+)?from\s+|import\s+|require\s*\()\s*['"`]([^'"`]+)['"`]/g;
+    }
+    /**
+     * Recursively scans a directory for imported packages.
+     * @param projectRoot - The root directory to scan
+     * @param options - Scanner configuration options
+     * @param options.ignore - Array of directory names to exclude (default: node_modules, dist, build)
+     * @returns A set of unique package names found in imports
+     */
+    async scan(projectRoot, options = {}) {
+        const imports = new Set();
+        const ignore = new Set(options.ignore || ["node_modules", "dist", "build"]);
+        const scanDir = async (dir) => {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (ignore.has(entry.name))
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await scanDir(fullPath);
+                }
+                else if (this.isCodeFile(fullPath)) {
+                    const content = fs.readFileSync(fullPath, "utf-8");
+                    const matches = content.matchAll(this.importRegex);
+                    for (const match of matches) {
+                        const imported = match[1];
+                        // Extract package name from path (handle scoped packages)
+                        const packageName = imported.startsWith("@")
+                            ? imported.split("/").slice(0, 2).join("/")
+                            : imported.split("/")[0];
+                        imports.add(packageName);
+                    }
+                }
+            }
+        };
+        await scanDir(projectRoot);
+        return imports;
+    }
+    isCodeFile(filePath) {
+        const ext = path.extname(filePath);
+        return [".js", ".ts", ".jsx", ".tsx", ".mjs", ".cjs"].includes(ext);
+    }
+}
+exports.Scanner = Scanner;

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAM7B;;;GAGG;AACH,MAAa,OAAO;IAApB;QACE,2DAA2D;QACnD,gBAAW,GACjB,8EAA8E,CAAC;IAmDnF,CAAC;IAjDC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,UAA0B,EAAE;QAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAE5E,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;YACpC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;qBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACrC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBACnD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAEnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;wBAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;wBAC1B,0DAA0D;wBAC1D,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;4BAC1C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;4BAC3C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;wBAE3B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,QAAgB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;CACF;AAtDD,0BAsDC"}

package/dist/scanner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scanner.test.js

@@ -0,0 +1,79 @@
+"use strict";
+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 });
+const scanner_1 = require("./scanner");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+describe("Scanner", () => {
+    const scanner = new scanner_1.Scanner();
+    const testDir = path.join(__dirname, "fixtures");
+    beforeAll(() => {
+        if (!fs.existsSync(testDir)) {
+            fs.mkdirSync(testDir, { recursive: true });
+        }
+    });
+    afterAll(() => {
+        if (fs.existsSync(testDir)) {
+            fs.rmSync(testDir, { recursive: true });
+        }
+    });
+    it("should extract import statements", async () => {
+        const code = `
+      import lodash from 'lodash';
+      import { useState } from 'react';
+      const express = require('express');
+    `;
+        const file = path.join(testDir, "test1.js");
+        fs.writeFileSync(file, code);
+        const imports = await scanner.scan(testDir);
+        expect(imports.has("lodash")).toBe(true);
+        expect(imports.has("react")).toBe(true);
+        expect(imports.has("express")).toBe(true);
+    });
+    it("should handle scoped packages", async () => {
+        const code = `import { Button } from '@mui/material';`;
+        const file = path.join(testDir, "test2.tsx");
+        fs.writeFileSync(file, code);
+        const imports = await scanner.scan(testDir);
+        expect(imports.has("@mui/material")).toBe(true);
+    });
+    it("should ignore node_modules by default", async () => {
+        const nmDir = path.join(testDir, "node_modules");
+        fs.mkdirSync(nmDir, { recursive: true });
+        fs.writeFileSync(path.join(nmDir, "test.js"), "import 'should-be-ignored';");
+        const imports = await scanner.scan(testDir);
+        expect(imports.has("should-be-ignored")).toBe(false);
+    });
+});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "pkg-clean",
+  "version": "1.0.0",
+  "description": "Find and remove unused dependencies from your Node.js project",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "pkg-clean": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "dependencies",
+    "package.json",
+    "cleanup",
+    "unused",
+    "npm",
+    "cli",
+    "tool",
+    "dependency-analysis"
+  ],
+  "author": "Andrew Passanisi <passanisi.andrew@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/apassanisi/pkg-clean"
+  },
+  "homepage": "https://github.com/apassanisi/pkg-clean#readme",
+  "bugs": {
+    "url": "https://github.com/apassanisi/pkg-clean/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "jest": "^28.1.3",
+    "ts-jest": "^28.0.8",
+    "typescript": "^5.3.2"
+  }
+}