kigumi 0.19.2 → 0.20.0

package/README.md

@@ -345,19 +345,19 @@ git push                       # Push to GitHub — done!
 }
 ```
 
-| Field                                  | Required | Description                                |
-| -------------------------------------- | -------- | ------------------------------------------ |
-| `name`                                 | Yes      | Registry name                              |
-| `version`                              | Yes      | Semver version (e.g. `1.0.0`)              |
-| `frameworks`                           | Yes      | Array: `react`, `vue`, `svelte`, `angular` |
-| `components[slug].files[fw].component` | Yes      | Main component file path                   |
-| `components[slug].files[fw].css`       | No       | CSS file path                              |
-| `components[slug].files[fw].test`      | No       | Test file path                             |
-| `components[slug].files[fw].extras`    | No       | Additional files (hooks, utils)            |
-| `components[slug].dependencies`        | No       | Other component slugs in this registry     |
-| `themes[slug].files.css`               | Yes      | Main theme CSS file                        |
-| `themes[slug].files.variables`         | No       | CSS variables file                         |
-| `themes[slug].extends`                 | No       | Built-in theme to extend                   |
+| Field                                  | Required | Description                            |
+| -------------------------------------- | -------- | -------------------------------------- |
+| `name`                                 | Yes      | Registry name                          |
+| `version`                              | Yes      | Semver version (e.g. `1.0.0`)          |
+| `frameworks`                           | Yes      | Array: `react`, `vue`, `angular`       |
+| `components[slug].files[fw].component` | Yes      | Main component file path               |
+| `components[slug].files[fw].css`       | No       | CSS file path                          |
+| `components[slug].files[fw].test`      | No       | Test file path                         |
+| `components[slug].files[fw].extras`    | No       | Additional files (hooks, utils)        |
+| `components[slug].dependencies`        | No       | Other component slugs in this registry |
+| `themes[slug].files.css`               | Yes      | Main theme CSS file                    |
+| `themes[slug].files.variables`         | No       | CSS variables file                     |
+| `themes[slug].extends`                 | No       | Built-in theme to extend               |
 
 ## Global Options
 

package/dist/bin.js

@@ -9,5 +9,5 @@ Please upgrade: https://nodejs.org`
   );
   process.exit(1);
 }
-await import("./-KKAC4XOR.js");
+await import("./index.js");
 //# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\nexport {};\n\nconst major = parseInt(process.version.slice(1), 10);\n\nif (major < 20) {\n  console.error(\n    `kigumi requires Node.js 20 or later (detected ${process.version}).` +\n      '\\nPlease upgrade: https://nodejs.org'\n  );\n  process.exit(1);\n}\n\nawait import('./index.js');\n"],"mappings":";;;AAIA,IAAM,QAAQ,SAAS,QAAQ,QAAQ,MAAM,CAAC,GAAG,EAAE;AAEnD,IAAI,QAAQ,IAAI;AACd,UAAQ;AAAA,IACN,iDAAiD,QAAQ,OAAO;AAAA;AAAA,EAElE;AACA,UAAQ,KAAK,CAAC;AAChB;AAEA,MAAM,OAAO,gBAAY;","names":[]}
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\nexport {};\n\nconst major = parseInt(process.version.slice(1), 10);\n\nif (major < 20) {\n  console.error(\n    `kigumi requires Node.js 20 or later (detected ${process.version}).` +\n      '\\nPlease upgrade: https://nodejs.org'\n  );\n  process.exit(1);\n}\n\nawait import('./index.js');\n"],"mappings":";;;AAIA,IAAM,QAAQ,SAAS,QAAQ,QAAQ,MAAM,CAAC,GAAG,EAAE;AAEnD,IAAI,QAAQ,IAAI;AACd,UAAQ;AAAA,IACN,iDAAiD,QAAQ,OAAO;AAAA;AAAA,EAElE;AACA,UAAQ,KAAK,CAAC;AAChB;AAEA,MAAM,OAAO,YAAY;","names":[]}

package/dist/chunk-F52T5BFP.js

@@ -0,0 +1,260 @@
+// src/utils/tier.ts
+import fs2 from "fs-extra";
+import path2 from "path";
+import { z } from "zod";
+
+// src/constants.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var WEB_AWESOME_FREE_PACKAGE = "@awesome.me/webawesome";
+var WEB_AWESOME_PRO_PACKAGE = "@awesome.me/webawesome-pro";
+var WEB_AWESOME_SCOPE = "@awesome.me";
+var ENV_TOKEN_KEY = "WEBAWESOME_NPM_TOKEN";
+var MIN_TOKEN_LENGTH = 10;
+var CONFIG_FILE_NAME = "kigumi.config.json";
+var ENV_FILE_NAME = ".env";
+var NPM_PUBLIC_REGISTRY = "https://registry.npmjs.org/";
+var NPM_PRO_REGISTRY = "https://npm.cloudsmith.io/fortawesome/webawesome-pro";
+var FREE_PACKAGE_REGEX = /@awesome\.me\/webawesome(?!-pro)/g;
+var PRO_PACKAGE_REGEX = /@awesome\.me\/webawesome-pro/g;
+var FREE_PACKAGE_PATTERN = /@awesome\.me\/webawesome(?!-pro)/;
+var PRO_PACKAGE_PATTERN = /@awesome\.me\/webawesome-pro/;
+var ENV_TOKEN_REGEX = /^\s*WEBAWESOME_NPM_TOKEN\s*=\s*(.+?)\s*$/m;
+var DEFAULT_WEBAWESOME_VERSION = "^3.5.0";
+var GITHUB_RAW_BASE_URL = "https://raw.githubusercontent.com";
+var KIGUMI_CACHE_DIR = ".kigumi/cache";
+var REGISTRY_CACHE_TTL_MS = 36e5;
+var REGISTRY_FILE_NAME = "registry.json";
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/kigumi/latest";
+var UPDATE_CHECK_CACHE_TTL_MS = 864e5;
+var UPDATE_CHECK_TIMEOUT_MS = 3e3;
+var UPDATE_CHECK_CACHE_FILE = "update-check.json";
+var GITHUB_REPO_URL = "https://github.com/Siregar/kigumi-cli";
+var GITHUB_ISSUES_URL = `${GITHUB_REPO_URL}/issues`;
+var __constants_filename = fileURLToPath(import.meta.url);
+var __constants_dirname = dirname(__constants_filename);
+var __cliPackageJson = JSON.parse(
+  readFileSync(join(__constants_dirname, "..", "package.json"), "utf-8")
+);
+var CLI_VERSION = __cliPackageJson.version;
+
+// src/utils/token.ts
+import fs from "fs-extra";
+import os from "os";
+import path from "path";
+async function detectProToken(cwd) {
+  const result = await detectProTokenWithSource(cwd);
+  return result.token;
+}
+function detectProTokenSync(cwd) {
+  const result = detectProTokenWithSourceSync(cwd);
+  return result.token;
+}
+function getTokenSourceSync(cwd) {
+  const result = detectProTokenWithSourceSync(cwd);
+  return result.source;
+}
+async function detectProTokenWithSource(cwd) {
+  const envToken = getTokenFromEnvVar();
+  if (envToken) {
+    return { token: envToken, source: "env" };
+  }
+  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {
+    const npmrcToken = await getTokenFromGlobalNpmrc();
+    if (npmrcToken) {
+      return { token: npmrcToken, source: "npmrc" };
+    }
+  }
+  const dotenvToken = await getTokenFromDotenv(cwd);
+  if (dotenvToken) {
+    return { token: dotenvToken, source: "dotenv" };
+  }
+  return { token: null, source: null };
+}
+function detectProTokenWithSourceSync(cwd) {
+  const envToken = getTokenFromEnvVar();
+  if (envToken) {
+    return { token: envToken, source: "env" };
+  }
+  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {
+    const npmrcToken = getTokenFromGlobalNpmrcSync();
+    if (npmrcToken) {
+      return { token: npmrcToken, source: "npmrc" };
+    }
+  }
+  const dotenvToken = getTokenFromDotenvSync(cwd);
+  if (dotenvToken) {
+    return { token: dotenvToken, source: "dotenv" };
+  }
+  return { token: null, source: null };
+}
+function getTokenFromEnvVar() {
+  const token = process.env[ENV_TOKEN_KEY];
+  if (token && token.length >= MIN_TOKEN_LENGTH) {
+    return token.trim();
+  }
+  return null;
+}
+async function getTokenFromGlobalNpmrc() {
+  const npmrcPath = path.join(os.homedir(), ".npmrc");
+  if (!await fs.pathExists(npmrcPath)) {
+    return null;
+  }
+  const content = await fs.readFile(npmrcPath, "utf-8");
+  return extractTokenFromNpmrc(content);
+}
+function getTokenFromGlobalNpmrcSync() {
+  const npmrcPath = path.join(os.homedir(), ".npmrc");
+  if (!fs.existsSync(npmrcPath)) {
+    return null;
+  }
+  const content = fs.readFileSync(npmrcPath, "utf-8");
+  return extractTokenFromNpmrc(content);
+}
+function extractTokenFromNpmrc(content) {
+  const registryHost = NPM_PRO_REGISTRY.replace("https://", "");
+  const patterns = [
+    new RegExp(`//${registryHost}/?:_authToken=(.+)`, "m"),
+    new RegExp(`${registryHost}/?:_authToken=(.+)`, "m")
+  ];
+  for (const pattern of patterns) {
+    const match = content.match(pattern);
+    if (match && match[1]) {
+      const token = match[1].trim();
+      if (token.length >= MIN_TOKEN_LENGTH) {
+        return token;
+      }
+    }
+  }
+  return null;
+}
+async function getTokenFromDotenv(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!await fs.pathExists(envPath)) {
+    return null;
+  }
+  const content = await fs.readFile(envPath, "utf-8");
+  return extractTokenFromDotenv(content);
+}
+function getTokenFromDotenvSync(cwd) {
+  const envPath = path.join(cwd, ENV_FILE_NAME);
+  if (!fs.existsSync(envPath)) {
+    return null;
+  }
+  const content = fs.readFileSync(envPath, "utf-8");
+  return extractTokenFromDotenv(content);
+}
+function extractTokenFromDotenv(content) {
+  const match = content.match(ENV_TOKEN_REGEX);
+  if (match && match[1]) {
+    const token = match[1].trim();
+    if (token.length >= MIN_TOKEN_LENGTH) {
+      return token;
+    }
+  }
+  return null;
+}
+function describeTokenSource(source) {
+  switch (source) {
+    case "env":
+      return `environment variable ($${ENV_TOKEN_KEY})`;
+    case "npmrc":
+      return "global ~/.npmrc";
+    case "dotenv":
+      return "project .env file";
+    default:
+      return "unknown";
+  }
+}
+
+// src/utils/tier.ts
+var tierSchema = z.enum(["free", "pro"], {
+  error: () => 'Must be either "free" or "pro"'
+});
+async function detectTier(cwd) {
+  const packageJsonPath = path2.join(cwd, "package.json");
+  if (await fs2.pathExists(packageJsonPath)) {
+    try {
+      const packageJson = await fs2.readJson(packageJsonPath);
+      const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+      };
+      if (deps[WEB_AWESOME_PRO_PACKAGE]) {
+        return "pro";
+      }
+      if (deps[WEB_AWESOME_FREE_PACKAGE]) {
+        return "free";
+      }
+    } catch (_error) {
+    }
+  }
+  const token = await detectProToken(cwd);
+  return token ? "pro" : "free";
+}
+function detectTierSync(cwd) {
+  const packageJsonPath = path2.join(cwd, "package.json");
+  if (fs2.pathExistsSync(packageJsonPath)) {
+    try {
+      const packageJson = fs2.readJsonSync(packageJsonPath);
+      const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+      };
+      if (deps[WEB_AWESOME_PRO_PACKAGE]) {
+        return "pro";
+      }
+      if (deps[WEB_AWESOME_FREE_PACKAGE]) {
+        return "free";
+      }
+    } catch (_error) {
+    }
+  }
+  const token = detectProTokenSync(cwd);
+  return token ? "pro" : "free";
+}
+async function getProToken(cwd) {
+  return detectProToken(cwd);
+}
+function getWebAwesomePackage(tier) {
+  return tier === "pro" ? WEB_AWESOME_PRO_PACKAGE : WEB_AWESOME_FREE_PACKAGE;
+}
+
+export {
+  WEB_AWESOME_FREE_PACKAGE,
+  WEB_AWESOME_PRO_PACKAGE,
+  WEB_AWESOME_SCOPE,
+  ENV_TOKEN_KEY,
+  MIN_TOKEN_LENGTH,
+  CONFIG_FILE_NAME,
+  ENV_FILE_NAME,
+  NPM_PUBLIC_REGISTRY,
+  NPM_PRO_REGISTRY,
+  FREE_PACKAGE_REGEX,
+  PRO_PACKAGE_REGEX,
+  FREE_PACKAGE_PATTERN,
+  PRO_PACKAGE_PATTERN,
+  ENV_TOKEN_REGEX,
+  DEFAULT_WEBAWESOME_VERSION,
+  GITHUB_RAW_BASE_URL,
+  KIGUMI_CACHE_DIR,
+  REGISTRY_CACHE_TTL_MS,
+  REGISTRY_FILE_NAME,
+  NPM_REGISTRY_URL,
+  UPDATE_CHECK_CACHE_TTL_MS,
+  UPDATE_CHECK_TIMEOUT_MS,
+  UPDATE_CHECK_CACHE_FILE,
+  GITHUB_REPO_URL,
+  GITHUB_ISSUES_URL,
+  CLI_VERSION,
+  detectProTokenSync,
+  getTokenSourceSync,
+  describeTokenSource,
+  tierSchema,
+  detectTier,
+  detectTierSync,
+  getProToken,
+  getWebAwesomePackage
+};
+//# sourceMappingURL=chunk-F52T5BFP.js.map

package/dist/chunk-F52T5BFP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/tier.ts","../src/constants.ts","../src/utils/token.ts"],"sourcesContent":["/**\n * Tier Detection Utility\n *\n * PURPOSE: Determines Free vs Pro tier based on token availability.\n *\n * Token detection uses fallback chain (see src/utils/token.ts):\n * 1. $WEBAWESOME_NPM_TOKEN environment variable (CI/CD)\n * 2. Global ~/.npmrc (local development)\n * 3. Project .env file (backwards compatible)\n *\n * EXPORTS:\n * - detectTier() - Async tier detection (PREFERRED)\n * - detectTierSync() - Sync version (use only when absolutely necessary)\n * - getProToken() - Get token from any source\n * - getWebAwesomePackage() - Get npm package name for tier\n *\n * @see AGENTS.md Rule #8 for tier system architecture\n */\n\nimport fs from 'fs-extra';\nimport path from 'path';\nimport { z } from 'zod';\nimport {\n  WEB_AWESOME_FREE_PACKAGE,\n  WEB_AWESOME_PRO_PACKAGE,\n} from '../constants.js';\nimport { detectProToken, detectProTokenSync } from './token.js';\n\nexport const tierSchema = z.enum(['free', 'pro'], {\n  error: () => 'Must be either \"free\" or \"pro\"',\n});\n\nexport type Tier = z.infer<typeof tierSchema>;\n\n/**\n * Detect tier based on installed package\n *\n * Checks package.json to see if @awesome.me/webawesome-pro is installed.\n * Falls back to token detection if package.json doesn't exist.\n *\n * @param cwd - Current working directory\n * @returns 'pro' if webawesome-pro is installed, 'free' otherwise\n */\nexport async function detectTier(cwd: string): Promise<Tier> {\n  // First check package.json for installed package\n  const packageJsonPath = path.join(cwd, 'package.json');\n  if (await fs.pathExists(packageJsonPath)) {\n    try {\n      const packageJson = await fs.readJson(packageJsonPath);\n      const deps = {\n        ...packageJson.dependencies,\n        ...packageJson.devDependencies,\n      };\n\n      // If webawesome-pro is installed, it's Pro tier\n      if (deps[WEB_AWESOME_PRO_PACKAGE]) {\n        return 'pro';\n      }\n\n      // If webawesome (free) is installed, it's Free tier\n      if (deps[WEB_AWESOME_FREE_PACKAGE]) {\n        return 'free';\n      }\n    } catch (_error) {\n      // Ignore JSON parse errors, fall through to token detection\n    }\n  }\n\n  // Fallback to token detection (for init command or if no package installed yet)\n  const token = await detectProToken(cwd);\n  return token ? 'pro' : 'free';\n}\n\n/**\n * Synchronous version of detectTier\n *\n * WHY: Some code paths (e.g., validators) need synchronous tier detection.\n * Prefer detectTier() when possible.\n */\nexport function detectTierSync(cwd: string): Tier {\n  // First check package.json for installed package\n  const packageJsonPath = path.join(cwd, 'package.json');\n  if (fs.pathExistsSync(packageJsonPath)) {\n    try {\n      const packageJson = fs.readJsonSync(packageJsonPath);\n      const deps = {\n        ...packageJson.dependencies,\n        ...packageJson.devDependencies,\n      };\n\n      // If webawesome-pro is installed, it's Pro tier\n      if (deps[WEB_AWESOME_PRO_PACKAGE]) {\n        return 'pro';\n      }\n\n      // If webawesome (free) is installed, it's Free tier\n      if (deps[WEB_AWESOME_FREE_PACKAGE]) {\n        return 'free';\n      }\n    } catch (_error) {\n      // Ignore JSON parse errors, fall through to token detection\n    }\n  }\n\n  // Fallback to token detection (for init command or if no package installed yet)\n  const token = detectProTokenSync(cwd);\n  return token ? 'pro' : 'free';\n}\n\n/**\n * Get Pro token from fallback chain\n *\n * @param cwd - Current working directory\n * @returns Token string if found, null otherwise\n */\nexport async function getProToken(cwd: string): Promise<string | null> {\n  return detectProToken(cwd);\n}\n\n/**\n * Get package name based on tier\n *\n * @param tier - 'free' or 'pro'\n * @returns Full npm package name\n */\nexport function getWebAwesomePackage(tier: Tier): string {\n  return tier === 'pro' ? WEB_AWESOME_PRO_PACKAGE : WEB_AWESOME_FREE_PACKAGE;\n}\n","/**\n * Central Constants for Kigumi CLI\n *\n * PURPOSE: Single source of truth for magic strings and configuration values.\n * Changes here propagate to the entire codebase.\n *\n * @see AGENTS.md for usage context\n */\n\n// =============================================================================\n// Package Names\n// =============================================================================\n\n/** Free tier npm package name */\nexport const WEB_AWESOME_FREE_PACKAGE = '@awesome.me/webawesome';\n\n/** Pro tier npm package name */\nexport const WEB_AWESOME_PRO_PACKAGE = '@awesome.me/webawesome-pro';\n\n/** Scope for Web Awesome packages */\nexport const WEB_AWESOME_SCOPE = '@awesome.me';\n\n// =============================================================================\n// Web Component Configuration\n// =============================================================================\n\n/** Prefix for all Web Awesome custom elements (e.g., wa-button, wa-card) */\nexport const WEB_COMPONENT_PREFIX = 'wa-';\n\n// =============================================================================\n// Environment Variables\n// =============================================================================\n\n/** Environment variable key for Pro tier authentication token */\nexport const ENV_TOKEN_KEY = 'WEBAWESOME_NPM_TOKEN';\n\n/**\n * Minimum valid token length for Pro tier\n *\n * WHY: Cloudsmith tokens are typically 40+ chars. 10 is a safety threshold\n * to avoid accepting malformed/empty values like \"=\" or \"token\".\n */\nexport const MIN_TOKEN_LENGTH = 10;\n\n// =============================================================================\n// File Names\n// =============================================================================\n\n/** Kigumi configuration file name */\nexport const CONFIG_FILE_NAME = 'kigumi.config.json';\n\n/** Environment variables file name */\nexport const ENV_FILE_NAME = '.env';\n\n/** NPM registry configuration file name */\nexport const NPMRC_FILE_NAME = '.npmrc';\n\n/** Kigumi setup file (generated) */\nexport const KIGUMI_SETUP_FILE = 'kigumi.ts';\n\n/** Theme CSS file (generated) */\nexport const THEME_CSS_FILE = 'theme.css';\n\n/** Vite environment types file */\nexport const VITE_ENV_DTS_FILE = 'vite-env.d.ts';\n\n// =============================================================================\n// NPM Registry URLs\n// =============================================================================\n\n/** Public npm registry for Free tier */\nexport const NPM_PUBLIC_REGISTRY = 'https://registry.npmjs.org/';\n\n/** Cloudsmith registry for Pro tier */\nexport const NPM_PRO_REGISTRY =\n  'https://npm.cloudsmith.io/fortawesome/webawesome-pro';\n\n// =============================================================================\n// Regex Patterns\n// =============================================================================\n\n/**\n * Regex to match Free package imports\n * WHY: Matches @awesome.me/webawesome but NOT @awesome.me/webawesome-pro\n */\nexport const FREE_PACKAGE_REGEX = /@awesome\\.me\\/webawesome(?!-pro)/g;\n\n/**\n * Regex to match Pro package imports\n */\nexport const PRO_PACKAGE_REGEX = /@awesome\\.me\\/webawesome-pro/g;\n\n/**\n * Non-global patterns for .test() usage in loops.\n * WHY: The /g flag on module-level singletons causes lastIndex state to\n * persist between calls, making every other file in a loop silently skip.\n * Use these for .test(); use FREE_PACKAGE_REGEX / PRO_PACKAGE_REGEX for .replace().\n */\nexport const FREE_PACKAGE_PATTERN = /@awesome\\.me\\/webawesome(?!-pro)/;\nexport const PRO_PACKAGE_PATTERN = /@awesome\\.me\\/webawesome-pro/;\n\n/**\n * Regex to extract token from .env file\n * WHY: Matches WEBAWESOME_NPM_TOKEN with optional whitespace around =\n */\nexport const ENV_TOKEN_REGEX = /^\\s*WEBAWESOME_NPM_TOKEN\\s*=\\s*(.+?)\\s*$/m;\n\n// =============================================================================\n// Default Paths\n// =============================================================================\n\n/** Default components directory */\nexport const DEFAULT_COMPONENTS_DIR = 'src/components/ui';\n\n/** Default utils/lib directory */\nexport const DEFAULT_UTILS_DIR = 'src/lib';\n\n/** Default styles directory */\nexport const DEFAULT_STYLES_DIR = 'src/styles';\n\n// =============================================================================\n// Exit Codes\n// =============================================================================\n\n/** Successful exit */\nexport const EXIT_SUCCESS = 0;\n\n/** Error exit */\nexport const EXIT_ERROR = 1;\n\n// =============================================================================\n// Timeouts\n// =============================================================================\n\n/** Install command timeout in milliseconds (5 minutes) */\nexport const INSTALL_TIMEOUT_MS = 300_000;\n\n// =============================================================================\n// Web Awesome Version\n// =============================================================================\n\n/** Default Web Awesome package version */\nexport const DEFAULT_WEBAWESOME_VERSION = '^3.5.0';\n\n// =============================================================================\n// Community Registry\n// =============================================================================\n\n/** GitHub raw content base URL */\nexport const GITHUB_RAW_BASE_URL = 'https://raw.githubusercontent.com';\n\n/** Kigumi cache directory (relative to home dir) */\nexport const KIGUMI_CACHE_DIR = '.kigumi/cache';\n\n/** Registry cache TTL in milliseconds (1 hour) */\nexport const REGISTRY_CACHE_TTL_MS = 3_600_000;\n\n/** Community registry file name */\nexport const REGISTRY_FILE_NAME = 'registry.json';\n\n// =============================================================================\n// Update Check\n// =============================================================================\n\n/** NPM registry URL for checking latest CLI version */\nexport const NPM_REGISTRY_URL = 'https://registry.npmjs.org/kigumi/latest';\n\n/** Update check cache TTL in milliseconds (24 hours) */\nexport const UPDATE_CHECK_CACHE_TTL_MS = 86_400_000;\n\n/** Update check fetch timeout in milliseconds (3 seconds) */\nexport const UPDATE_CHECK_TIMEOUT_MS = 3_000;\n\n/** Update check cache file name (within KIGUMI_CACHE_DIR) */\nexport const UPDATE_CHECK_CACHE_FILE = 'update-check.json';\n\n// =============================================================================\n// GitHub Repository\n// =============================================================================\n\n/** GitHub repository URL */\nexport const GITHUB_REPO_URL = 'https://github.com/Siregar/kigumi-cli';\n\n/** GitHub issues URL for bug reports */\nexport const GITHUB_ISSUES_URL = `${GITHUB_REPO_URL}/issues`;\n\n// =============================================================================\n// CLI Version\n// =============================================================================\n\nimport { readFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __constants_filename = fileURLToPath(import.meta.url);\nconst __constants_dirname = dirname(__constants_filename);\nconst __cliPackageJson = JSON.parse(\n  readFileSync(join(__constants_dirname, '..', 'package.json'), 'utf-8')\n);\n\n/** Current Kigumi CLI version (read from package.json) */\nexport const CLI_VERSION: string = __cliPackageJson.version;\n","/**\n * Token Detection Utility\n *\n * PURPOSE: Detects Web Awesome Pro token from multiple sources with fallback chain.\n *\n * FALLBACK CHAIN (in priority order):\n * 1. Environment Variable: $WEBAWESOME_NPM_TOKEN (for CI/CD)\n * 2. Global ~/.npmrc (recommended for local development)\n * 3. Project .env file (backwards compatible)\n *\n * EXPORTS:\n * - detectProToken() - Get token from any source\n * - detectProTokenSync() - Sync version\n * - getTokenSource() - Identify where token was found\n *\n * @see AGENTS.md for token handling architecture\n */\n\nimport fs from 'fs-extra';\nimport os from 'os';\nimport path from 'path';\nimport {\n  ENV_FILE_NAME,\n  ENV_TOKEN_KEY,\n  ENV_TOKEN_REGEX,\n  MIN_TOKEN_LENGTH,\n  NPM_PRO_REGISTRY,\n} from '../constants.js';\n\nexport type TokenSource = 'env' | 'npmrc' | 'dotenv' | null;\n\ninterface TokenResult {\n  token: string | null;\n  source: TokenSource;\n}\n\n/**\n * Detect Pro token from fallback chain\n *\n * Priority:\n * 1. $WEBAWESOME_NPM_TOKEN environment variable\n * 2. Global ~/.npmrc (//npm.cloudsmith.io/.../webawesome-pro/:_authToken)\n * 3. Project .env file\n *\n * @param cwd - Current working directory (for .env lookup)\n * @returns Token string if found, null otherwise\n */\nexport async function detectProToken(cwd: string): Promise<string | null> {\n  const result = await detectProTokenWithSource(cwd);\n  return result.token;\n}\n\n/**\n * Synchronous version of detectProToken\n */\nexport function detectProTokenSync(cwd: string): string | null {\n  const result = detectProTokenWithSourceSync(cwd);\n  return result.token;\n}\n\n/**\n * Get token source without returning the actual token\n *\n * Useful for displaying where the token was found without exposing it.\n *\n * @param cwd - Current working directory\n * @returns Source identifier or null\n */\nexport async function getTokenSource(cwd: string): Promise<TokenSource> {\n  const result = await detectProTokenWithSource(cwd);\n  return result.source;\n}\n\n/**\n * Synchronous version of getTokenSource\n */\nexport function getTokenSourceSync(cwd: string): TokenSource {\n  const result = detectProTokenWithSourceSync(cwd);\n  return result.source;\n}\n\n/**\n * Internal: Detect token with source information (async)\n */\nasync function detectProTokenWithSource(cwd: string): Promise<TokenResult> {\n  // 1. Check environment variable first (CI/CD priority)\n  const envToken = getTokenFromEnvVar();\n  if (envToken) {\n    return { token: envToken, source: 'env' };\n  }\n\n  // 2. Check global ~/.npmrc (skip in tests if env var set)\n  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {\n    const npmrcToken = await getTokenFromGlobalNpmrc();\n    if (npmrcToken) {\n      return { token: npmrcToken, source: 'npmrc' };\n    }\n  }\n\n  // 3. Check project .env file (backwards compatible)\n  const dotenvToken = await getTokenFromDotenv(cwd);\n  if (dotenvToken) {\n    return { token: dotenvToken, source: 'dotenv' };\n  }\n\n  return { token: null, source: null };\n}\n\n/**\n * Internal: Detect token with source information (sync)\n */\nfunction detectProTokenWithSourceSync(cwd: string): TokenResult {\n  // 1. Check environment variable first\n  const envToken = getTokenFromEnvVar();\n  if (envToken) {\n    return { token: envToken, source: 'env' };\n  }\n\n  // 2. Check global ~/.npmrc (skip in tests if env var set)\n  if (!process.env.KIGUMI_SKIP_GLOBAL_NPMRC) {\n    const npmrcToken = getTokenFromGlobalNpmrcSync();\n    if (npmrcToken) {\n      return { token: npmrcToken, source: 'npmrc' };\n    }\n  }\n\n  // 3. Check project .env file\n  const dotenvToken = getTokenFromDotenvSync(cwd);\n  if (dotenvToken) {\n    return { token: dotenvToken, source: 'dotenv' };\n  }\n\n  return { token: null, source: null };\n}\n\n/**\n * Get token from environment variable\n */\nfunction getTokenFromEnvVar(): string | null {\n  const token = process.env[ENV_TOKEN_KEY];\n  if (token && token.length >= MIN_TOKEN_LENGTH) {\n    return token.trim();\n  }\n  return null;\n}\n\n/**\n * Get token from global ~/.npmrc (async)\n *\n * Looks for: //npm.cloudsmith.io/fortawesome/webawesome-pro/:_authToken=TOKEN\n */\nasync function getTokenFromGlobalNpmrc(): Promise<string | null> {\n  const npmrcPath = path.join(os.homedir(), '.npmrc');\n\n  if (!(await fs.pathExists(npmrcPath))) {\n    return null;\n  }\n\n  const content = await fs.readFile(npmrcPath, 'utf-8');\n  return extractTokenFromNpmrc(content);\n}\n\n/**\n * Get token from global ~/.npmrc (sync)\n */\nfunction getTokenFromGlobalNpmrcSync(): string | null {\n  const npmrcPath = path.join(os.homedir(), '.npmrc');\n\n  if (!fs.existsSync(npmrcPath)) {\n    return null;\n  }\n\n  const content = fs.readFileSync(npmrcPath, 'utf-8');\n  return extractTokenFromNpmrc(content);\n}\n\n/**\n * Extract auth token from npmrc content\n *\n * Matches patterns like:\n * - //npm.cloudsmith.io/fortawesome/webawesome-pro/:_authToken=TOKEN\n * - //npm.cloudsmith.io/fortawesome/webawesome-pro:_authToken=TOKEN\n */\nfunction extractTokenFromNpmrc(content: string): string | null {\n  // Extract registry host from NPM_PRO_REGISTRY (remove https://)\n  const registryHost = NPM_PRO_REGISTRY.replace('https://', '');\n\n  // Match auth token for the Pro registry\n  // Supports both //:_authToken and :_authToken patterns\n  const patterns = [\n    new RegExp(`//${registryHost}/?:_authToken=(.+)`, 'm'),\n    new RegExp(`${registryHost}/?:_authToken=(.+)`, 'm'),\n  ];\n\n  for (const pattern of patterns) {\n    const match = content.match(pattern);\n    if (match && match[1]) {\n      const token = match[1].trim();\n      if (token.length >= MIN_TOKEN_LENGTH) {\n        return token;\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Get token from project .env file (async)\n */\nasync function getTokenFromDotenv(cwd: string): Promise<string | null> {\n  const envPath = path.join(cwd, ENV_FILE_NAME);\n\n  if (!(await fs.pathExists(envPath))) {\n    return null;\n  }\n\n  const content = await fs.readFile(envPath, 'utf-8');\n  return extractTokenFromDotenv(content);\n}\n\n/**\n * Get token from project .env file (sync)\n */\nfunction getTokenFromDotenvSync(cwd: string): string | null {\n  const envPath = path.join(cwd, ENV_FILE_NAME);\n\n  if (!fs.existsSync(envPath)) {\n    return null;\n  }\n\n  const content = fs.readFileSync(envPath, 'utf-8');\n  return extractTokenFromDotenv(content);\n}\n\n/**\n * Extract token from .env content\n */\nfunction extractTokenFromDotenv(content: string): string | null {\n  const match = content.match(ENV_TOKEN_REGEX);\n  if (match && match[1]) {\n    const token = match[1].trim();\n    if (token.length >= MIN_TOKEN_LENGTH) {\n      return token;\n    }\n  }\n  return null;\n}\n\n/**\n * Get human-readable description of token source\n *\n * Useful for user-facing messages.\n */\nexport function describeTokenSource(source: TokenSource): string {\n  switch (source) {\n    case 'env':\n      return `environment variable ($${ENV_TOKEN_KEY})`;\n    case 'npmrc':\n      return 'global ~/.npmrc';\n    case 'dotenv':\n      return 'project .env file';\n    default:\n      return 'unknown';\n  }\n}\n"],"mappings":"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","names":["fs","path","path","fs"]}