@node-cli/bundlecheck 1.2.0 → 1.4.0

package/README.md

@@ -13,8 +13,11 @@ 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)
+- **Library API** for programmatic usage in Node.js applications
 
 ## Installation
 
@@ -92,17 +95,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                    |
-| `--registry <url>`  | `-r <url>`  | Custom npm registry URL (default: registry.npmjs.org)   |
+| 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
 
@@ -137,6 +142,216 @@ 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
+```
+
+## Programmatic Usage (Library API)
+
+In addition to the CLI, `@node-cli/bundlecheck` can be used as a library in your Node.js code.
+
+### Installation
+
+```bash
+npm install @node-cli/bundlecheck
+```
+
+### Basic Usage
+
+```js
+import { getBundleStats, getBundleTrend, getPackageVersions } from "@node-cli/bundlecheck";
+
+// Get bundle stats for a single package
+const stats = await getBundleStats({
+  package: "@mantine/core@7.0.0",
+});
+console.log(stats);
+// {
+//   packageName: "@mantine/core",
+//   packageVersion: "7.0.0",
+//   rawSize: 234567,
+//   gzipSize: 45678,
+//   rawSizeFormatted: "229.07 kB",
+//   gzipSizeFormatted: "44.61 kB",
+//   exports: [],
+//   externals: ["react", "react-dom"],
+//   dependencies: ["@floating-ui/react", ...],
+//   platform: "browser",
+//   gzipLevel: 5,
+//   fromCache: false
+// }
+
+// Check specific exports (tree-shaking)
+const buttonStats = await getBundleStats({
+  package: "@mantine/core",
+  exports: ["Button", "Input"],
+});
+console.log(buttonStats.gzipSizeFormatted); // "12.3 kB"
+
+// Get bundle size trend across versions
+const trend = await getBundleTrend({
+  package: "@mantine/core",
+  versionCount: 5,
+});
+console.log(trend);
+// {
+//   packageName: "@mantine/core",
+//   versions: [
+//     { version: "7.0.0", rawSize: 234567, gzipSize: 45678, rawSizeFormatted: "229.07 kB", ... },
+//     { version: "6.0.0", rawSize: 220000, gzipSize: 42000, ... },
+//     ...
+//   ],
+//   change: {
+//     fromVersion: "5.0.0",
+//     toVersion: "7.0.0",
+//     rawDiff: 14567,
+//     rawPercent: 6.6,
+//     rawDiffFormatted: "+14.23 kB",
+//     gzipDiff: 3678,
+//     gzipPercent: 8.7,
+//     gzipDiffFormatted: "+3.59 kB"
+//   }
+// }
+
+// Get available versions for a package
+const versions = await getPackageVersions({
+  package: "@mantine/core",
+});
+console.log(versions.tags.latest); // "7.0.0"
+console.log(versions.versions.slice(0, 5)); // ["7.0.0", "6.0.21", "6.0.20", ...]
+```
+
+### API Reference
+
+#### `getBundleStats(options)`
+
+Get bundle size statistics for a single package.
+
+**Options:**
+
+| Option       | Type                          | Default    | Description                                              |
+| ------------ | ----------------------------- | ---------- | -------------------------------------------------------- |
+| `package`    | `string`                      | (required) | Package name with optional version (e.g., `lodash@4.17.0`) |
+| `exports`    | `string[]`                    | `undefined`| Specific exports to measure (tree-shaking)               |
+| `external`   | `string[]`                    | `undefined`| Additional packages to mark as external                  |
+| `noExternal` | `boolean`                     | `false`    | Bundle everything including default externals            |
+| `gzipLevel`  | `number`                      | `5`        | Gzip compression level (1-9)                             |
+| `registry`   | `string`                      | `undefined`| Custom npm registry URL                                  |
+| `platform`   | `"browser" \| "node" \| "auto"` | `"auto"`   | Target platform                                          |
+| `force`      | `boolean`                     | `false`    | Bypass cache                                             |
+
+**Returns:** `Promise<BundleStats>`
+
+```ts
+type BundleStats = {
+  packageName: string;        // Display name (may include subpath)
+  packageVersion: string;     // Resolved version
+  exports: string[];          // Exports analyzed
+  rawSize: number;            // Raw size in bytes
+  gzipSize: number | null;    // Gzip size in bytes (null for node platform)
+  gzipLevel: number;          // Compression level used
+  externals: string[];        // External packages
+  dependencies: string[];     // Package dependencies
+  platform: "browser" | "node";
+  rawSizeFormatted: string;   // Human-readable (e.g., "45.2 kB")
+  gzipSizeFormatted: string | null;
+  fromCache: boolean;         // Whether result was from cache
+};
+```
+
+#### `getBundleTrend(options)`
+
+Get bundle size trend across multiple versions.
+
+**Options:**
+
+| Option         | Type                          | Default    | Description                                              |
+| -------------- | ----------------------------- | ---------- | -------------------------------------------------------- |
+| `package`      | `string`                      | (required) | Package name (version ignored if provided)               |
+| `versionCount` | `number`                      | `5`        | Number of versions to analyze                            |
+| `exports`      | `string[]`                    | `undefined`| Specific exports to measure                              |
+| `external`     | `string[]`                    | `undefined`| Additional packages to mark as external                  |
+| `noExternal`   | `boolean`                     | `false`    | Bundle everything including default externals            |
+| `gzipLevel`    | `number`                      | `5`        | Gzip compression level (1-9)                             |
+| `registry`     | `string`                      | `undefined`| Custom npm registry URL                                  |
+| `platform`     | `"browser" \| "node" \| "auto"` | `"auto"`   | Target platform                                          |
+| `force`        | `boolean`                     | `false`    | Bypass cache                                             |
+
+**Returns:** `Promise<BundleTrend>`
+
+```ts
+type BundleTrend = {
+  packageName: string;
+  versions: TrendVersionResult[];  // Results for each version (newest first)
+  change: TrendChange | null;      // Change between oldest and newest
+};
+
+type TrendVersionResult = {
+  version: string;
+  rawSize: number;
+  gzipSize: number | null;
+  rawSizeFormatted: string;
+  gzipSizeFormatted: string | null;
+};
+
+type TrendChange = {
+  fromVersion: string;
+  toVersion: string;
+  rawDiff: number;              // Positive = increase, negative = decrease
+  rawPercent: number | null;    // null if oldest size was 0
+  rawDiffFormatted: string;     // e.g., "+5.2 kB" or "-1.3 kB"
+  gzipDiff: number | null;
+  gzipPercent: number | null;   // null if not applicable or oldest size was 0
+  gzipDiffFormatted: string | null;
+};
+```
+
+#### `getPackageVersions(options)`
+
+Get available versions for an npm package.
+
+**Options:**
+
+| Option     | Type     | Default    | Description                  |
+| ---------- | -------- | ---------- | ---------------------------- |
+| `package`  | `string` | (required) | Package name                 |
+| `registry` | `string` | `undefined`| Custom npm registry URL      |
+
+**Returns:** `Promise<PackageVersions>`
+
+```ts
+type PackageVersions = {
+  versions: string[];              // All versions (newest first)
+  tags: Record<string, string>;    // Dist tags (e.g., { latest: "7.0.0" })
+};
+```
+
+### Utility Functions
+
+```js
+import { formatBytes, parsePackageSpecifier, clearCache, getCacheCount } from "@node-cli/bundlecheck";
+
+// Format bytes to human-readable string
+formatBytes(1024);        // "1 kB"
+formatBytes(1536);        // "1.5 kB"
+
+// Parse a package specifier
+parsePackageSpecifier("@scope/name@1.0.0");
+// { name: "@scope/name", version: "1.0.0" }
+
+parsePackageSpecifier("@scope/name/subpath@2.0.0");
+// { name: "@scope/name", version: "2.0.0", subpath: "subpath" }
+
+// Cache management
+getCacheCount();  // Returns number of cached entries
+clearCache();     // Clears all cached results
 ```
 
 ## How It Works
@@ -148,6 +363,27 @@ bundlecheck @myorg/private-pkg --registry https://npm.mycompany.com
 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.
@@ -169,6 +405,46 @@ 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,18 +1,41 @@
 #!/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";
 const flags = config.flags;
 const parameters = config.parameters;
-// Disable kleur colors when --boring flag is set
+// Disable kleur colors when --boring flag is set.
 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) {
@@ -20,26 +43,29 @@ async function main() {
         config.showHelp?.();
         process.exit(1);
     }
-    // Parse additional externals if provided (comma-separated)
+    // Parse additional externals if provided (comma-separated).
     let additionalExternals;
     if (flags?.external) {
         additionalExternals = flags.external.split(",").map((e)=>e.trim()).filter(Boolean);
     }
-    // Parse exports if provided (comma-separated)
+    // Parse exports if provided (comma-separated).
     let exports;
     const exportsArg = parameters?.["1"];
     if (exportsArg) {
         exports = exportsArg.split(",").map((e)=>e.trim()).filter(Boolean);
     }
-    // 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;
+    // 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;
     if (trendValue !== undefined) {
         const parsedCount = Number.parseInt(trendValue, 10);
         const versionCount = !Number.isNaN(parsedCount) && parsedCount > 0 ? parsedCount : TREND_VERSION_COUNT;
         try {
             const { name, subpath } = parsePackageSpecifier(packageName);
-            // Construct the full package path including subpath if present
+            // 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({
@@ -50,7 +76,7 @@ async function main() {
                 log.error("No versions found for this package");
                 process.exit(1);
             }
-            // Select versions for trend
+            // Select versions for trend.
             const trendVersions = selectTrendVersions(versions, versionCount);
             log.info(`Analyzing ${trendVersions.length} versions: ${trendVersions.join(", ")}`);
             log.info("");
@@ -62,13 +88,15 @@ async function main() {
                 noExternal: flags?.noExternal,
                 gzipLevel: flags?.gzipLevel,
                 boring: flags?.boring,
-                registry: flags?.registry
+                registry: flags?.registry,
+                platform,
+                force: flags?.force
             });
             if (results.length === 0) {
                 log.error("Failed to analyze any versions");
                 process.exit(1);
             }
-            // Render and display the trend graph
+            // Render and display the trend graph.
             const graphLines = renderTrendGraph(fullPackagePath, results, flags?.boring);
             for (const line of graphLines){
                 log.log(line);
@@ -80,7 +108,7 @@ async function main() {
             process.exit(1);
         }
     }
-    // If --versions flag is set, fetch and prompt for version selection
+    // If --versions flag is set, fetch and prompt for version selection.
     if (flags?.versions) {
         try {
             const { name, subpath } = parsePackageSpecifier(packageName);
@@ -94,7 +122,7 @@ async function main() {
                 process.exit(1);
             }
             const selectedVersion = await promptForVersion(name, versions, tags);
-            // Rebuild specifier preserving any subpath
+            // Rebuild specifier preserving any subpath.
             packageName = subpath ? `${name}/${subpath}@${selectedVersion}` : `${name}@${selectedVersion}`;
             log.info(`\nSelected: ${packageName}`);
         } catch (error) {
@@ -107,32 +135,54 @@ 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,
-            registry: flags?.registry
-        });
-        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"
+            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({\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});\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\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\tregistry: flags?.registry,\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","registry","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/**\n\t * If --trend flag is set, show bundle size trend across versions --trend alone\n\t * uses default (5), --trend N uses N versions.\n\t */\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/**\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\t */\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

@@ -4,7 +4,7 @@ export type ParsedPackage = {
     subpath?: string;
 };
 /**
- * Parse a package specifier to extract name, version, and subpath
+ * Parse a package specifier to extract name, version, and subpath.
  * Handles:
  * - @scope/package@1.0.0
  * - @scope/package/subpath@1.0.0
@@ -19,19 +19,27 @@ export type BundleOptions = {
     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
+ * Format bytes to human-readable string.
  */
 export declare function formatBytes(bytes: number): string;
 export type EntryContentOptions = {
@@ -41,6 +49,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;
@@ -51,8 +63,9 @@ 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
+ * Check the bundle size of an npm package.
  */
 export declare function checkBundleSize(options: BundleOptions): Promise<BundleResult>;