@node-cli/bundlecheck 1.1.2 → 1.3.0

package/README.md

@@ -13,7 +13,10 @@ A CLI tool to check the bundle size of npm packages, similar to [bundlephobia.co
 - Support for checking specific exports (tree-shaking)
 - Automatic externalization of React and React-DOM
 - Raw and gzip sizes with configurable compression level
+- **Platform support**: target `browser` (default) or `node` with smart auto-detection
+- Custom npm registry support (for private registries)
 - Fast bundling using esbuild (with pnpm support)
+- **Local caching** for faster repeated lookups (SQLite-based, max 100 entries)
 
 ## Installation
 
@@ -91,16 +94,19 @@ bundlecheck lodash "debounce,throttle"
 
 ### Options
 
-| Flag                | Short       | Description                                             |
-| ------------------- | ----------- | ------------------------------------------------------- |
-| `--help`            | `-h`        | Display help instructions                               |
-| `--version`         | `-v`        | Output the current version                              |
-| `--versions`        | `-V`        | Choose from available package versions interactively    |
-| `--trend [N]`       | `-t [N]`    | Show bundle size trend for N versions (default: 5)      |
-| `--boring`          | `-b`        | Do not use color output                                 |
-| `--gzipLevel <n>`   | `-g <n>`    | Gzip compression level (1-9, default: 5)                |
-| `--external <pkgs>` | `-e <pkgs>` | Comma-separated additional packages to mark as external |
-| `--noExternal`      | `-n`        | Do not mark any packages as external                    |
+| Flag                | Short       | Description                                                      |
+| ------------------- | ----------- | ---------------------------------------------------------------- |
+| `--help`            | `-h`        | Display help instructions                                        |
+| `--version`         | `-v`        | Output the current version                                       |
+| `--versions`        | `-V`        | Choose from available package versions interactively             |
+| `--trend [N]`       | `-t [N]`    | Show bundle size trend for N versions (default: 5)               |
+| `--boring`          | `-b`        | Do not use color output                                          |
+| `--gzipLevel <n>`   | `-g <n>`    | Gzip compression level (1-9, default: 5)                         |
+| `--external <pkgs>` | `-e <pkgs>` | Comma-separated additional packages to mark as external          |
+| `--noExternal`      | `-n`        | Do not mark any packages as external                             |
+| `--registry <url>`  | `-r <url>`  | Custom npm registry URL (default: registry.npmjs.org)            |
+| `--platform <name>` | `-p <name>` | Target platform: `auto` (default), `browser`, or `node`          |
+| `--force`           | `-f`        | Bypass cache and force re-fetch/re-calculation                   |
 
 ### Examples
 
@@ -132,6 +138,18 @@ bundlecheck lodash --trend
 
 # Show bundle size trend for 3 versions
 bundlecheck lodash --trend 3
+
+# Use a custom npm registry
+bundlecheck @myorg/private-pkg --registry https://npm.mycompany.com
+
+# Check a Node.js package (explicit platform)
+bundlecheck express --platform node
+
+# Auto-detect platform (default behavior)
+bundlecheck express  # auto-detects "node" from package.json engines
+
+# Bypass cache and force re-fetch
+bundlecheck lodash --force
 ```
 
 ## How It Works
@@ -143,12 +161,88 @@ bundlecheck lodash --trend 3
 5. Reports raw and gzip sizes
 6. Cleans up temporary files
 
+## Platform Support
+
+The `--platform` flag controls how the bundle is built:
+
+- **`auto`** (default): Automatically detects the platform from the package's `engines` field. If the package specifies `engines.node` without `engines.browser`, it uses `node`; otherwise defaults to `browser`.
+- **`browser`**: Builds for browser environments (also accepts aliases: `web`, `desktop`, `client`)
+- **`node`**: Builds for Node.js environments (also accepts aliases: `server`, `nodejs`, `backend`)
+
+When targeting **node** platform:
+- Gzip size is not calculated (shows "N/A") since server-side code isn't typically served compressed over HTTP
+- The bundle is optimized for Node.js built-ins
+
+```bash
+# Auto-detect (recommended for most cases)
+bundlecheck express           # detects "node" from engines.node
+
+# Explicit platform
+bundlecheck lodash --platform browser
+bundlecheck fastify -p server  # "server" is an alias for "node"
+```
+
 ## Default Externals
 
 By default, `react` and `react-dom` are marked as external (not included in the bundle size) since most React-based packages expect these as peer dependencies. This matches how these packages would typically be used in a real application.
 
 To include React/React-DOM in the bundle size calculation, use the `--no-external` flag.
 
+## Custom Registry
+
+Use the `--registry` flag to check packages from private or alternative npm registries:
+
+```bash
+# Private corporate registry
+bundlecheck @myorg/myorg-ui-library --registry https://npm.mycompany.com
+
+# Verdaccio local registry
+bundlecheck my-local-pkg --registry http://localhost:4873
+
+```
+
+Note: If the registry requires authentication, ensure your npm/pnpm is configured with the appropriate credentials (via `.npmrc` or environment variables).
+
+## Cache
+
+Bundle size results are cached locally to speed up repeated lookups. The cache is stored in `~/.bundlecheck/cache.db` using SQLite.
+
+### How it works
+
+- Results are cached based on: package name, version, exports, platform, gzip level, and externals configuration
+- The cache holds up to **100 entries** (least recently used entries are evicted first)
+- When you check a package, the CLI first looks for a cached result with matching parameters
+
+### Smart version matching
+
+The cache uses **resolved versions**, not the requested specifier. This means:
+
+```bash
+bundlecheck @mantine/core          # Resolves "latest" to e.g. 8.0.0, caches as 8.0.0
+bundlecheck @mantine/core@8.0.0    # Cache hit! Same resolved version
+```
+
+This also works with `--trend`: if you previously checked `@mantine/core` (which resolved to v8.0.0), running `--trend` will use the cached result for v8.0.0 and only fetch the other versions.
+
+### Bypassing the cache
+
+Use the `--force` flag to skip the cache and re-fetch/re-calculate:
+
+```bash
+bundlecheck lodash --force    # Always fetches fresh data
+bundlecheck lodash -f         # Short form
+```
+
+### Cache location
+
+The cache database is stored at:
+
+```
+~/.bundlecheck/cache.db
+```
+
+To clear the cache, simply delete this file or the `~/.bundlecheck` directory.
+
 ## License
 
 MIT - see [LICENSE](./LICENSE) for details.

package/dist/bundlecheck.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 /* istanbul ignore file */ import { Logger } from "@node-cli/logger";
 import kleur from "kleur";
-import { checkBundleSize, formatBytes, parsePackageSpecifier } from "./bundler.js";
-import { TREND_VERSION_COUNT } from "./defaults.js";
+import { checkBundleSize, formatBytes, getExternals, parsePackageSpecifier } from "./bundler.js";
+import { getCachedResult, normalizeCacheKey, setCachedResult } from "./cache.js";
+import { normalizePlatform, TREND_VERSION_COUNT } from "./defaults.js";
 import { config } from "./parse.js";
 import { analyzeTrend, renderTrendGraph, selectTrendVersions } from "./trend.js";
 import { fetchPackageVersions, promptForVersion } from "./versions.js";
@@ -13,6 +14,28 @@ kleur.enabled = !flags?.boring;
 const log = new Logger({
     boring: flags?.boring
 });
+/**
+ * Display bundle result in a formatted box
+ */ function displayResult(result, isAutoDetected) {
+    const blue = kleur.blue;
+    const green = kleur.green;
+    const platformLabel = result.platform === "node" ? "node" : "browser";
+    const platformNote = isAutoDetected ? " (auto-detected)" : "";
+    log.printBox([
+        `${blue("Package:")} ${result.packageName} (${blue("version:")} ${result.packageVersion})`,
+        result.exports.length > 0 ? `${blue("Exports:")} { ${result.exports.join(", ")} }` : `${blue("Exports:")} * (entire package)`,
+        "",
+        `${blue("Raw size:")}  ${formatBytes(result.rawSize)}`,
+        result.gzipSize !== null ? `${blue("Gzip size:")} ${formatBytes(result.gzipSize)} (level ${result.gzipLevel})` : `${blue("Gzip size:")} N/A (not applicable for node platform)`,
+        "",
+        result.externals.length > 0 ? `${blue("Externals:")} ${result.externals.join(", ")}` : `${blue("Externals:")} ${green("none")}`,
+        result.dependencies.length > 0 ? `${blue("Dependencies:")} ${result.dependencies.join(", ")}` : `${blue("Dependencies:")} ${green("none")}`,
+        `${blue("Platform:")} ${platformLabel}${platformNote}`
+    ], {
+        borderStyle: "round",
+        align: "left"
+    });
+}
 async function main() {
     let packageName = parameters?.["0"];
     if (!packageName) {
@@ -31,6 +54,8 @@ async function main() {
     if (exportsArg) {
         exports = exportsArg.split(",").map((e)=>e.trim()).filter(Boolean);
     }
+    // Normalize platform from flag (handles aliases like "web" → "browser")
+    const platform = normalizePlatform(flags?.platform);
     // If --trend flag is set, show bundle size trend across versions
     // --trend alone uses default (5), --trend N uses N versions
     const trendValue = flags?.trend;
@@ -42,7 +67,10 @@ async function main() {
             // Construct the full package path including subpath if present
             const fullPackagePath = subpath ? `${name}/${subpath}` : name;
             log.info(`\nFetching available versions for ${name}...`);
-            const { versions } = await fetchPackageVersions(packageName);
+            const { versions } = await fetchPackageVersions({
+                packageName,
+                registry: flags?.registry
+            });
             if (versions.length === 0) {
                 log.error("No versions found for this package");
                 process.exit(1);
@@ -58,7 +86,10 @@ async function main() {
                 additionalExternals,
                 noExternal: flags?.noExternal,
                 gzipLevel: flags?.gzipLevel,
-                boring: flags?.boring
+                boring: flags?.boring,
+                registry: flags?.registry,
+                platform,
+                force: flags?.force
             });
             if (results.length === 0) {
                 log.error("Failed to analyze any versions");
@@ -81,7 +112,10 @@ async function main() {
         try {
             const { name, subpath } = parsePackageSpecifier(packageName);
             log.info(`\nFetching available versions for ${name}...`);
-            const { versions, tags } = await fetchPackageVersions(packageName);
+            const { versions, tags } = await fetchPackageVersions({
+                packageName,
+                registry: flags?.registry
+            });
             if (versions.length === 0) {
                 log.error("No versions found for this package");
                 process.exit(1);
@@ -100,31 +134,53 @@ async function main() {
     if (exports && exports.length > 0) {
         log.info(`Exports: { ${exports.join(", ")} }`);
     }
-    log.info("Please wait, installing and bundling...\n");
     try {
+        // Parse package specifier to get name and version
+        const { name: baseName, version: requestedVersion } = parsePackageSpecifier(packageName);
+        // Resolve "latest" to actual version for cache key
+        let resolvedVersion = requestedVersion;
+        if (requestedVersion === "latest") {
+            const { tags } = await fetchPackageVersions({
+                packageName: baseName,
+                registry: flags?.registry
+            });
+            resolvedVersion = tags.latest || requestedVersion;
+        }
+        // Compute externals for cache key (same logic as bundler)
+        const externals = getExternals(baseName, additionalExternals, flags?.noExternal);
+        // Build cache key
+        // Note: platform can be undefined (auto-detect), which is stored as "auto" in cache
+        const cacheKey = normalizeCacheKey({
+            packageName: baseName,
+            version: resolvedVersion,
+            exports,
+            platform,
+            gzipLevel: flags?.gzipLevel ?? 5,
+            externals,
+            noExternal: flags?.noExternal ?? false
+        });
+        // Check cache (unless --force flag is set)
+        if (!flags?.force) {
+            const cached = getCachedResult(cacheKey);
+            if (cached) {
+                log.info("NOTE: Using cached results\n");
+                displayResult(cached, platform === undefined);
+                process.exit(0);
+            }
+        }
+        log.info("Please wait, installing and bundling...\n");
         const result = await checkBundleSize({
             packageName,
             exports,
             additionalExternals,
             noExternal: flags?.noExternal,
-            gzipLevel: flags?.gzipLevel
-        });
-        const blue = kleur.blue;
-        const green = kleur.green;
-        // Display results
-        log.printBox([
-            `${blue("Package:")} ${result.packageName} (${blue("version:")} ${result.packageVersion})`,
-            result.exports.length > 0 ? `${blue("Exports:")} { ${result.exports.join(", ")} }` : `${blue("Exports:")} * (entire package)`,
-            "",
-            `${blue("Raw size:")}  ${formatBytes(result.rawSize)}`,
-            `${blue("Gzip size:")} ${formatBytes(result.gzipSize)} (level ${result.gzipLevel})`,
-            "",
-            result.externals.length > 0 ? `${blue("Externals:")} ${result.externals.join(", ")}` : `${blue("Externals:")} ${green("none")}`,
-            result.dependencies.length > 0 ? `${blue("Dependencies:")} ${result.dependencies.join(", ")}` : `${blue("Dependencies:")} ${green("none")}`
-        ], {
-            borderStyle: "round",
-            align: "left"
+            gzipLevel: flags?.gzipLevel,
+            registry: flags?.registry,
+            platform
         });
+        // Store result in cache
+        setCachedResult(cacheKey, result);
+        displayResult(result, platform === undefined);
         process.exit(0);
     } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);

package/dist/bundlecheck.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bundlecheck.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/* istanbul ignore file */\n\nimport { Logger } from \"@node-cli/logger\";\nimport kleur from \"kleur\";\nimport {\n\tcheckBundleSize,\n\tformatBytes,\n\tparsePackageSpecifier,\n} from \"./bundler.js\";\nimport { TREND_VERSION_COUNT } from \"./defaults.js\";\nimport { config } from \"./parse.js\";\nimport {\n\tanalyzeTrend,\n\trenderTrendGraph,\n\tselectTrendVersions,\n} from \"./trend.js\";\nimport { fetchPackageVersions, promptForVersion } from \"./versions.js\";\n\nconst flags = config.flags;\nconst parameters = config.parameters;\n\n// Disable kleur colors when --boring flag is set\nkleur.enabled = !flags?.boring;\n\nconst log = new Logger({\n\tboring: flags?.boring,\n});\n\nasync function main() {\n\tlet packageName = parameters?.[\"0\"];\n\n\tif (!packageName) {\n\t\tlog.error(\"Package name is required\");\n\t\tconfig.showHelp?.();\n\t\tprocess.exit(1);\n\t}\n\n\t// Parse additional externals if provided (comma-separated)\n\tlet additionalExternals: string[] | undefined;\n\tif (flags?.external) {\n\t\tadditionalExternals = flags.external\n\t\t\t.split(\",\")\n\t\t\t.map((e) => e.trim())\n\t\t\t.filter(Boolean);\n\t}\n\n\t// Parse exports if provided (comma-separated)\n\tlet exports: string[] | undefined;\n\tconst exportsArg = parameters?.[\"1\"];\n\tif (exportsArg) {\n\t\texports = exportsArg\n\t\t\t.split(\",\")\n\t\t\t.map((e) => e.trim())\n\t\t\t.filter(Boolean);\n\t}\n\n\t// If --trend flag is set, show bundle size trend across versions\n\t// --trend alone uses default (5), --trend N uses N versions\n\tconst trendValue = flags?.trend;\n\tif (trendValue !== undefined) {\n\t\tconst parsedCount = Number.parseInt(trendValue, 10);\n\t\tconst versionCount =\n\t\t\t!Number.isNaN(parsedCount) && parsedCount > 0\n\t\t\t\t? parsedCount\n\t\t\t\t: TREND_VERSION_COUNT;\n\n\t\ttry {\n\t\t\tconst { name, subpath } = parsePackageSpecifier(packageName);\n\t\t\t// Construct the full package path including subpath if present\n\t\t\tconst fullPackagePath = subpath ? `${name}/${subpath}` : name;\n\n\t\t\tlog.info(`\\nFetching available versions for ${name}...`);\n\n\t\t\tconst { versions } = await fetchPackageVersions(packageName);\n\n\t\t\tif (versions.length === 0) {\n\t\t\t\tlog.error(\"No versions found for this package\");\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\n\t\t\t// Select versions for trend\n\t\t\tconst trendVersions = selectTrendVersions(versions, versionCount);\n\n\t\t\tlog.info(\n\t\t\t\t`Analyzing ${trendVersions.length} versions: ${trendVersions.join(\", \")}`,\n\t\t\t);\n\t\t\tlog.info(\"\");\n\n\t\t\tconst results = await analyzeTrend({\n\t\t\t\tpackageName: fullPackagePath,\n\t\t\t\tversions: trendVersions,\n\t\t\t\texports,\n\t\t\t\tadditionalExternals,\n\t\t\t\tnoExternal: flags?.noExternal,\n\t\t\t\tgzipLevel: flags?.gzipLevel,\n\t\t\t\tboring: flags?.boring,\n\t\t\t});\n\n\t\t\tif (results.length === 0) {\n\t\t\t\tlog.error(\"Failed to analyze any versions\");\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\n\t\t\t// Render and display the trend graph\n\t\t\tconst graphLines = renderTrendGraph(\n\t\t\t\tfullPackagePath,\n\t\t\t\tresults,\n\t\t\t\tflags?.boring,\n\t\t\t);\n\t\t\tfor (const line of graphLines) {\n\t\t\t\tlog.log(line);\n\t\t\t}\n\n\t\t\tprocess.exit(0);\n\t\t} catch (error) {\n\t\t\tconst errorMessage =\n\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\tlog.error(`Failed to analyze trend: ${errorMessage}`);\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\t// If --versions flag is set, fetch and prompt for version selection\n\tif (flags?.versions) {\n\t\ttry {\n\t\t\tconst { name, subpath } = parsePackageSpecifier(packageName);\n\t\t\tlog.info(`\\nFetching available versions for ${name}...`);\n\n\t\t\tconst { versions, tags } = await fetchPackageVersions(packageName);\n\n\t\t\tif (versions.length === 0) {\n\t\t\t\tlog.error(\"No versions found for this package\");\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\n\t\t\tconst selectedVersion = await promptForVersion(name, versions, tags);\n\t\t\t// Rebuild specifier preserving any subpath\n\t\t\tpackageName = subpath\n\t\t\t\t? `${name}/${subpath}@${selectedVersion}`\n\t\t\t\t: `${name}@${selectedVersion}`;\n\t\t\tlog.info(`\\nSelected: ${packageName}`);\n\t\t} catch (error) {\n\t\t\tconst errorMessage =\n\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\tlog.error(`Failed to fetch versions: ${errorMessage}`);\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\tlog.info(`\\nAnalyzing bundle size for: ${packageName}`);\n\tif (exports && exports.length > 0) {\n\t\tlog.info(`Exports: { ${exports.join(\", \")} }`);\n\t}\n\tlog.info(\"Please wait, installing and bundling...\\n\");\n\n\ttry {\n\t\tconst result = await checkBundleSize({\n\t\t\tpackageName,\n\t\t\texports,\n\t\t\tadditionalExternals,\n\t\t\tnoExternal: flags?.noExternal,\n\t\t\tgzipLevel: flags?.gzipLevel,\n\t\t});\n\n\t\tconst blue = kleur.blue;\n\t\tconst green = kleur.green;\n\n\t\t// Display results\n\t\tlog.printBox(\n\t\t\t[\n\t\t\t\t`${blue(\"Package:\")} ${result.packageName} (${blue(\"version:\")} ${result.packageVersion})`,\n\t\t\t\tresult.exports.length > 0\n\t\t\t\t\t? `${blue(\"Exports:\")} { ${result.exports.join(\", \")} }`\n\t\t\t\t\t: `${blue(\"Exports:\")} * (entire package)`,\n\t\t\t\t\"\",\n\t\t\t\t`${blue(\"Raw size:\")}  ${formatBytes(result.rawSize)}`,\n\t\t\t\t`${blue(\"Gzip size:\")} ${formatBytes(result.gzipSize)} (level ${result.gzipLevel})`,\n\t\t\t\t\"\",\n\t\t\t\tresult.externals.length > 0\n\t\t\t\t\t? `${blue(\"Externals:\")} ${result.externals.join(\", \")}`\n\t\t\t\t\t: `${blue(\"Externals:\")} ${green(\"none\")}`,\n\t\t\t\tresult.dependencies.length > 0\n\t\t\t\t\t? `${blue(\"Dependencies:\")} ${result.dependencies.join(\", \")}`\n\t\t\t\t\t: `${blue(\"Dependencies:\")} ${green(\"none\")}`,\n\t\t\t],\n\t\t\t{\n\t\t\t\tborderStyle: \"round\",\n\t\t\t\talign: \"left\",\n\t\t\t},\n\t\t);\n\n\t\tprocess.exit(0);\n\t} catch (error) {\n\t\tconst errorMessage = error instanceof Error ? error.message : String(error);\n\t\tlog.error(`Failed to analyze bundle size: ${errorMessage}`);\n\t\tprocess.exit(1);\n\t}\n}\n\nmain();\n"],"names":["Logger","kleur","checkBundleSize","formatBytes","parsePackageSpecifier","TREND_VERSION_COUNT","config","analyzeTrend","renderTrendGraph","selectTrendVersions","fetchPackageVersions","promptForVersion","flags","parameters","enabled","boring","log","main","packageName","error","showHelp","process","exit","additionalExternals","external","split","map","e","trim","filter","Boolean","exports","exportsArg","trendValue","trend","undefined","parsedCount","Number","parseInt","versionCount","isNaN","name","subpath","fullPackagePath","info","versions","length","trendVersions","join","results","noExternal","gzipLevel","graphLines","line","errorMessage","Error","message","String","tags","selectedVersion","result","blue","green","printBox","packageVersion","rawSize","gzipSize","externals","dependencies","borderStyle","align"],"mappings":"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"}
+{"version":3,"sources":["../src/bundlecheck.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/* istanbul ignore file */\n\nimport { Logger } from \"@node-cli/logger\";\nimport kleur from \"kleur\";\nimport {\n\tcheckBundleSize,\n\tformatBytes,\n\tgetExternals,\n\tparsePackageSpecifier,\n} from \"./bundler.js\";\nimport {\n\tgetCachedResult,\n\tnormalizeCacheKey,\n\tsetCachedResult,\n} from \"./cache.js\";\nimport { normalizePlatform, TREND_VERSION_COUNT } from \"./defaults.js\";\nimport { config } from \"./parse.js\";\nimport {\n\tanalyzeTrend,\n\trenderTrendGraph,\n\tselectTrendVersions,\n} from \"./trend.js\";\nimport { fetchPackageVersions, promptForVersion } from \"./versions.js\";\n\nconst flags = config.flags;\nconst parameters = config.parameters;\n\n// Disable kleur colors when --boring flag is set\nkleur.enabled = !flags?.boring;\n\nconst log = new Logger({\n\tboring: flags?.boring,\n});\n\n/**\n * Display bundle result in a formatted box\n */\nfunction displayResult(\n\tresult: {\n\t\tpackageName: string;\n\t\tpackageVersion: string;\n\t\texports: string[];\n\t\trawSize: number;\n\t\tgzipSize: number | null;\n\t\tgzipLevel: number;\n\t\texternals: string[];\n\t\tdependencies: string[];\n\t\tplatform: \"browser\" | \"node\";\n\t},\n\tisAutoDetected: boolean,\n): void {\n\tconst blue = kleur.blue;\n\tconst green = kleur.green;\n\n\tconst platformLabel = result.platform === \"node\" ? \"node\" : \"browser\";\n\tconst platformNote = isAutoDetected ? \" (auto-detected)\" : \"\";\n\n\tlog.printBox(\n\t\t[\n\t\t\t`${blue(\"Package:\")} ${result.packageName} (${blue(\"version:\")} ${result.packageVersion})`,\n\t\t\tresult.exports.length > 0\n\t\t\t\t? `${blue(\"Exports:\")} { ${result.exports.join(\", \")} }`\n\t\t\t\t: `${blue(\"Exports:\")} * (entire package)`,\n\t\t\t\"\",\n\t\t\t`${blue(\"Raw size:\")}  ${formatBytes(result.rawSize)}`,\n\t\t\tresult.gzipSize !== null\n\t\t\t\t? `${blue(\"Gzip size:\")} ${formatBytes(result.gzipSize)} (level ${result.gzipLevel})`\n\t\t\t\t: `${blue(\"Gzip size:\")} N/A (not applicable for node platform)`,\n\t\t\t\"\",\n\t\t\tresult.externals.length > 0\n\t\t\t\t? `${blue(\"Externals:\")} ${result.externals.join(\", \")}`\n\t\t\t\t: `${blue(\"Externals:\")} ${green(\"none\")}`,\n\t\t\tresult.dependencies.length > 0\n\t\t\t\t? `${blue(\"Dependencies:\")} ${result.dependencies.join(\", \")}`\n\t\t\t\t: `${blue(\"Dependencies:\")} ${green(\"none\")}`,\n\t\t\t`${blue(\"Platform:\")} ${platformLabel}${platformNote}`,\n\t\t],\n\t\t{\n\t\t\tborderStyle: \"round\",\n\t\t\talign: \"left\",\n\t\t},\n\t);\n}\n\nasync function main() {\n\tlet packageName = parameters?.[\"0\"];\n\n\tif (!packageName) {\n\t\tlog.error(\"Package name is required\");\n\t\tconfig.showHelp?.();\n\t\tprocess.exit(1);\n\t}\n\n\t// Parse additional externals if provided (comma-separated)\n\tlet additionalExternals: string[] | undefined;\n\tif (flags?.external) {\n\t\tadditionalExternals = flags.external\n\t\t\t.split(\",\")\n\t\t\t.map((e) => e.trim())\n\t\t\t.filter(Boolean);\n\t}\n\n\t// Parse exports if provided (comma-separated)\n\tlet exports: string[] | undefined;\n\tconst exportsArg = parameters?.[\"1\"];\n\tif (exportsArg) {\n\t\texports = exportsArg\n\t\t\t.split(\",\")\n\t\t\t.map((e) => e.trim())\n\t\t\t.filter(Boolean);\n\t}\n\n\t// Normalize platform from flag (handles aliases like \"web\" → \"browser\")\n\tconst platform = normalizePlatform(flags?.platform);\n\n\t// If --trend flag is set, show bundle size trend across versions\n\t// --trend alone uses default (5), --trend N uses N versions\n\tconst trendValue = flags?.trend;\n\tif (trendValue !== undefined) {\n\t\tconst parsedCount = Number.parseInt(trendValue, 10);\n\t\tconst versionCount =\n\t\t\t!Number.isNaN(parsedCount) && parsedCount > 0\n\t\t\t\t? parsedCount\n\t\t\t\t: TREND_VERSION_COUNT;\n\n\t\ttry {\n\t\t\tconst { name, subpath } = parsePackageSpecifier(packageName);\n\t\t\t// Construct the full package path including subpath if present\n\t\t\tconst fullPackagePath = subpath ? `${name}/${subpath}` : name;\n\n\t\t\tlog.info(`\\nFetching available versions for ${name}...`);\n\n\t\t\tconst { versions } = await fetchPackageVersions({\n\t\t\t\tpackageName,\n\t\t\t\tregistry: flags?.registry,\n\t\t\t});\n\n\t\t\tif (versions.length === 0) {\n\t\t\t\tlog.error(\"No versions found for this package\");\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\n\t\t\t// Select versions for trend\n\t\t\tconst trendVersions = selectTrendVersions(versions, versionCount);\n\n\t\t\tlog.info(\n\t\t\t\t`Analyzing ${trendVersions.length} versions: ${trendVersions.join(\", \")}`,\n\t\t\t);\n\t\t\tlog.info(\"\");\n\n\t\t\tconst results = await analyzeTrend({\n\t\t\t\tpackageName: fullPackagePath,\n\t\t\t\tversions: trendVersions,\n\t\t\t\texports,\n\t\t\t\tadditionalExternals,\n\t\t\t\tnoExternal: flags?.noExternal,\n\t\t\t\tgzipLevel: flags?.gzipLevel,\n\t\t\t\tboring: flags?.boring,\n\t\t\t\tregistry: flags?.registry,\n\t\t\t\tplatform,\n\t\t\t\tforce: flags?.force,\n\t\t\t});\n\n\t\t\tif (results.length === 0) {\n\t\t\t\tlog.error(\"Failed to analyze any versions\");\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\n\t\t\t// Render and display the trend graph\n\t\t\tconst graphLines = renderTrendGraph(\n\t\t\t\tfullPackagePath,\n\t\t\t\tresults,\n\t\t\t\tflags?.boring,\n\t\t\t);\n\t\t\tfor (const line of graphLines) {\n\t\t\t\tlog.log(line);\n\t\t\t}\n\n\t\t\tprocess.exit(0);\n\t\t} catch (error) {\n\t\t\tconst errorMessage =\n\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\tlog.error(`Failed to analyze trend: ${errorMessage}`);\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\t// If --versions flag is set, fetch and prompt for version selection\n\tif (flags?.versions) {\n\t\ttry {\n\t\t\tconst { name, subpath } = parsePackageSpecifier(packageName);\n\t\t\tlog.info(`\\nFetching available versions for ${name}...`);\n\n\t\t\tconst { versions, tags } = await fetchPackageVersions({\n\t\t\t\tpackageName,\n\t\t\t\tregistry: flags?.registry,\n\t\t\t});\n\n\t\t\tif (versions.length === 0) {\n\t\t\t\tlog.error(\"No versions found for this package\");\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\n\t\t\tconst selectedVersion = await promptForVersion(name, versions, tags);\n\t\t\t// Rebuild specifier preserving any subpath\n\t\t\tpackageName = subpath\n\t\t\t\t? `${name}/${subpath}@${selectedVersion}`\n\t\t\t\t: `${name}@${selectedVersion}`;\n\t\t\tlog.info(`\\nSelected: ${packageName}`);\n\t\t} catch (error) {\n\t\t\tconst errorMessage =\n\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\tlog.error(`Failed to fetch versions: ${errorMessage}`);\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\tlog.info(`\\nAnalyzing bundle size for: ${packageName}`);\n\tif (exports && exports.length > 0) {\n\t\tlog.info(`Exports: { ${exports.join(\", \")} }`);\n\t}\n\n\ttry {\n\t\t// Parse package specifier to get name and version\n\t\tconst { name: baseName, version: requestedVersion } =\n\t\t\tparsePackageSpecifier(packageName);\n\n\t\t// Resolve \"latest\" to actual version for cache key\n\t\tlet resolvedVersion = requestedVersion;\n\t\tif (requestedVersion === \"latest\") {\n\t\t\tconst { tags } = await fetchPackageVersions({\n\t\t\t\tpackageName: baseName,\n\t\t\t\tregistry: flags?.registry,\n\t\t\t});\n\t\t\tresolvedVersion = tags.latest || requestedVersion;\n\t\t}\n\n\t\t// Compute externals for cache key (same logic as bundler)\n\t\tconst externals = getExternals(\n\t\t\tbaseName,\n\t\t\tadditionalExternals,\n\t\t\tflags?.noExternal,\n\t\t);\n\n\t\t// Build cache key\n\t\t// Note: platform can be undefined (auto-detect), which is stored as \"auto\" in cache\n\t\tconst cacheKey = normalizeCacheKey({\n\t\t\tpackageName: baseName,\n\t\t\tversion: resolvedVersion,\n\t\t\texports,\n\t\t\tplatform,\n\t\t\tgzipLevel: flags?.gzipLevel ?? 5,\n\t\t\texternals,\n\t\t\tnoExternal: flags?.noExternal ?? false,\n\t\t});\n\n\t\t// Check cache (unless --force flag is set)\n\t\tif (!flags?.force) {\n\t\t\tconst cached = getCachedResult(cacheKey);\n\t\t\tif (cached) {\n\t\t\t\tlog.info(\"NOTE: Using cached results\\n\");\n\t\t\t\tdisplayResult(cached, platform === undefined);\n\t\t\t\tprocess.exit(0);\n\t\t\t}\n\t\t}\n\n\t\tlog.info(\"Please wait, installing and bundling...\\n\");\n\n\t\tconst result = await checkBundleSize({\n\t\t\tpackageName,\n\t\t\texports,\n\t\t\tadditionalExternals,\n\t\t\tnoExternal: flags?.noExternal,\n\t\t\tgzipLevel: flags?.gzipLevel,\n\t\t\tregistry: flags?.registry,\n\t\t\tplatform,\n\t\t});\n\n\t\t// Store result in cache\n\t\tsetCachedResult(cacheKey, result);\n\n\t\tdisplayResult(result, platform === undefined);\n\n\t\tprocess.exit(0);\n\t} catch (error) {\n\t\tconst errorMessage = error instanceof Error ? error.message : String(error);\n\t\tlog.error(`Failed to analyze bundle size: ${errorMessage}`);\n\t\tprocess.exit(1);\n\t}\n}\n\nmain();\n"],"names":["Logger","kleur","checkBundleSize","formatBytes","getExternals","parsePackageSpecifier","getCachedResult","normalizeCacheKey","setCachedResult","normalizePlatform","TREND_VERSION_COUNT","config","analyzeTrend","renderTrendGraph","selectTrendVersions","fetchPackageVersions","promptForVersion","flags","parameters","enabled","boring","log","displayResult","result","isAutoDetected","blue","green","platformLabel","platform","platformNote","printBox","packageName","packageVersion","exports","length","join","rawSize","gzipSize","gzipLevel","externals","dependencies","borderStyle","align","main","error","showHelp","process","exit","additionalExternals","external","split","map","e","trim","filter","Boolean","exportsArg","trendValue","trend","undefined","parsedCount","Number","parseInt","versionCount","isNaN","name","subpath","fullPackagePath","info","versions","registry","trendVersions","results","noExternal","force","graphLines","line","errorMessage","Error","message","String","tags","selectedVersion","baseName","version","requestedVersion","resolvedVersion","latest","cacheKey","cached"],"mappings":"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"}

package/dist/bundler.d.ts

@@ -18,16 +18,21 @@ export type BundleOptions = {
     additionalExternals?: string[];
     noExternal?: boolean;
     gzipLevel?: number;
+    registry?: string;
+    /** Target platform. If undefined, auto-detects from package.json engines */
+    platform?: "browser" | "node";
 };
 export type BundleResult = {
     packageName: string;
     packageVersion: string;
     exports: string[];
     rawSize: number;
-    gzipSize: number;
+    /** Gzip size in bytes, or null for node platform (gzip not applicable) */
+    gzipSize: number | null;
     gzipLevel: number;
     externals: string[];
     dependencies: string[];
+    platform: "browser" | "node";
 };
 /**
  * Format bytes to human-readable string
@@ -40,6 +45,10 @@ export type EntryContentOptions = {
     allSubpaths?: string[];
     exportToSubpath?: Map<string, string>;
 };
+/**
+ * Get externals list based on options
+ */
+export declare function getExternals(packageName: string, externals?: string[], noExternal?: boolean): string[];
 export type PackageExports = Record<string, string | {
     import?: string;
     types?: string;
@@ -50,6 +59,7 @@ export type PackageInfo = {
     peerDependencies: Record<string, string>;
     exports: PackageExports | null;
     hasMainEntry: boolean;
+    engines: Record<string, string> | null;
 };
 /**
  * Check the bundle size of an npm package

package/dist/bundler.js

@@ -122,16 +122,44 @@ const gzipAsync = promisify(zlib.gzip);
 }
 // Cache the result of pnpm availability check
 let usePnpm = null;
+/**
+ * Validate and sanitize a registry URL to prevent command injection
+ * @param registry - The registry URL to validate
+ * @returns The sanitized URL or undefined if invalid
+ * @throws Error if the URL is invalid or contains potentially malicious characters
+ */ function validateRegistryUrl(registry) {
+    // Parse as URL to validate format
+    let url;
+    try {
+        url = new URL(registry);
+    } catch  {
+        throw new Error(`Invalid registry URL: ${registry}. Must be a valid URL (e.g., https://registry.example.com)`);
+    }
+    // Only allow http and https protocols
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`Invalid registry URL protocol: ${url.protocol}. Only http: and https: are allowed`);
+    }
+    // Return the sanitized URL (URL constructor normalizes it)
+    return url.toString();
+}
 /**
  * Get the install command (pnpm preferred, npm fallback)
- */ function getInstallCommand() {
+ * @param registry - Optional custom npm registry URL
+ */ function getInstallCommand(registry) {
     if (usePnpm === null) {
         usePnpm = isPnpmAvailable();
     }
+    let registryArg = "";
+    if (registry) {
+        // Validate and sanitize the registry URL to prevent command injection
+        const sanitizedRegistry = validateRegistryUrl(registry);
+        // Quote the URL to handle any special characters safely
+        registryArg = ` --registry "${sanitizedRegistry}"`;
+    }
     if (usePnpm) {
-        return "pnpm install --ignore-scripts --no-frozen-lockfile";
+        return `pnpm install --ignore-scripts --no-frozen-lockfile${registryArg}`;
     }
-    return "npm install --legacy-peer-deps --ignore-scripts";
+    return `npm install --legacy-peer-deps --ignore-scripts${registryArg}`;
 }
 /**
  * Generate the entry file content based on package, subpath, and exports
@@ -180,7 +208,7 @@ let usePnpm = null;
 }
 /**
  * Get externals list based on options
- */ function getExternals(packageName, externals, noExternal) {
+ */ export function getExternals(packageName, externals, noExternal) {
     if (noExternal) {
         return [];
     }
@@ -220,7 +248,8 @@ let usePnpm = null;
                 dependencies: pkgJson.dependencies || {},
                 peerDependencies: pkgJson.peerDependencies || {},
                 exports: pkgJson.exports || null,
-                hasMainEntry
+                hasMainEntry,
+                engines: pkgJson.engines || null
             };
         }
     } catch  {
@@ -231,7 +260,8 @@ let usePnpm = null;
         dependencies: {},
         peerDependencies: {},
         exports: null,
-        hasMainEntry: true
+        hasMainEntry: true,
+        engines: null
     };
 }
 /**
@@ -326,7 +356,7 @@ let usePnpm = null;
 /**
  * Check the bundle size of an npm package
  */ export async function checkBundleSize(options) {
-    const { packageName: packageSpecifier, exports, additionalExternals, noExternal, gzipLevel = 5 } = options;
+    const { packageName: packageSpecifier, exports, additionalExternals, noExternal, gzipLevel = 5, registry, platform: explicitPlatform } = options;
     // Parse the package specifier to extract name, version, and subpath
     const { name: packageName, version: requestedVersion, subpath } = parsePackageSpecifier(packageSpecifier);
     const tmpDir = createTempDir();
@@ -342,14 +372,22 @@ let usePnpm = null;
         };
         fs.writeFileSync(path.join(tmpDir, "package.json"), JSON.stringify(packageJson, null, 2));
         // Install the main package (try pnpm first, fallback to npm)
-        const installCmd = getInstallCommand();
+        const installCmd = getInstallCommand(registry);
         execSync(installCmd, {
             cwd: tmpDir,
             stdio: "pipe"
         });
-        // Get package info (version, dependencies, peer dependencies, exports)
+        // Get package info (version, dependencies, peer dependencies, exports, engines)
         const pkgInfo = getPackageInfo(tmpDir, packageName);
         const peerDepKeys = Object.keys(pkgInfo.peerDependencies);
+        // Determine platform: use explicit value if provided, otherwise auto-detect from engines
+        let platform = "browser";
+        if (explicitPlatform) {
+            platform = explicitPlatform;
+        } else if (pkgInfo.engines?.node && !pkgInfo.engines?.browser) {
+            // Package specifies node engine without browser - likely a Node.js package
+            platform = "node";
+        }
         // Collect all dependency names (prod + peer)
         const allDependencies = [
             ...new Set([
@@ -411,7 +449,7 @@ let usePnpm = null;
             bundle: true,
             write: false,
             format: "esm",
-            platform: "browser",
+            platform,
             target: "es2020",
             minify: true,
             treeShaking: true,
@@ -421,11 +459,14 @@ let usePnpm = null;
         // Get raw size
         const bundleContent = result.outputFiles[0].contents;
         const rawSize = bundleContent.length;
-        // Gzip the bundle
-        const gzipped = await gzipAsync(Buffer.from(bundleContent), {
-            level: gzipLevel
-        });
-        const gzipSize = gzipped.length;
+        // Gzip the bundle (only for browser platform - not relevant for Node.js)
+        let gzipSize = null;
+        if (platform === "browser") {
+            const gzipped = await gzipAsync(Buffer.from(bundleContent), {
+                level: gzipLevel
+            });
+            gzipSize = gzipped.length;
+        }
         // Determine the display name
         let displayName = packageName;
         if (resolvedSubpath) {
@@ -445,7 +486,8 @@ let usePnpm = null;
             gzipSize,
             gzipLevel,
             externals,
-            dependencies: allDependencies
+            dependencies: allDependencies,
+            platform
         };
     } finally{
         cleanupTempDir(tmpDir);