@easynet/agent-common 1.0.0 → 1.0.1

package/dist/{chunk-3PI6JR76.js → chunk-KRKFTXH6.js}

@@ -235,6 +235,77 @@ async function importFromCache(packageRoot) {
   );
 }
 
+// src/npm/command.ts
+import { spawnSync } from "child_process";
+function normalizeOutput(v) {
+  return typeof v === "string" ? v : "";
+}
+function runNpmCommand(args, options = {}) {
+  const result = spawnSync("npm", args, {
+    cwd: options.cwd ?? process.cwd(),
+    env: options.env ?? process.env,
+    encoding: "utf-8",
+    timeout: options.timeoutMs,
+    stdio: options.stdio ?? "pipe",
+    shell: options.shell ?? false
+  });
+  return {
+    args,
+    status: result.status,
+    stdout: normalizeOutput(result.stdout),
+    stderr: normalizeOutput(result.stderr),
+    signal: result.signal,
+    error: result.error ?? void 0
+  };
+}
+function assertNpmCommandSuccess(result, context) {
+  if (!result.error && result.status === 0) return;
+  const details = result.error?.message || result.stderr.trim() || (result.status == null ? "terminated" : `exit code ${result.status}`);
+  throw new Error(`${context} failed: npm ${result.args.join(" ")} (${details})`);
+}
+function npmSearchJson(query, options = {}) {
+  const result = runNpmCommand(["search", query, "--json"], options);
+  if (result.error || result.status !== 0) return [];
+  const text = result.stdout.trim();
+  if (!text) return [];
+  try {
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
+}
+function npmInstall(options = {}) {
+  const args = ["install"];
+  if (options.global) args.push("-g");
+  if (options.registry) args.push("--registry", options.registry);
+  if (options.legacyPeerDeps) args.push("--legacy-peer-deps");
+  if (options.noPackageLock) args.push("--no-package-lock");
+  if (Array.isArray(options.packages) && options.packages.length > 0) {
+    args.push(...options.packages);
+  }
+  const result = runNpmCommand(args, options);
+  assertNpmCommandSuccess(result, "npm install");
+}
+function npmRunScript(script, options = {}) {
+  const result = runNpmCommand(["run", script], options);
+  assertNpmCommandSuccess(result, `npm run ${script}`);
+}
+function npmPublish(options = {}) {
+  const args = ["publish"];
+  if (options.tag) args.push("--tag", options.tag);
+  if (options.access) args.push("--access", options.access);
+  if (options.registry) args.push("--registry", options.registry);
+  const result = runNpmCommand(args, options);
+  assertNpmCommandSuccess(result, "npm publish");
+}
+function npmRoot(options = {}) {
+  const args = ["root", ...options.global ? ["-g"] : []];
+  const result = runNpmCommand(args, options);
+  assertNpmCommandSuccess(result, "npm root");
+  return result.stdout.trim();
+}
+
 export {
   NPM_PROTOCOL_PREFIX,
   isNpmProviderSpec,
@@ -248,6 +319,13 @@ export {
   ensureNpmPackageInstalled,
   ensurePackageInCache,
   getPackageEntryPath,
-  importFromCache
+  importFromCache,
+  runNpmCommand,
+  assertNpmCommandSuccess,
+  npmSearchJson,
+  npmInstall,
+  npmRunScript,
+  npmPublish,
+  npmRoot
 };
-//# sourceMappingURL=chunk-3PI6JR76.js.map
+//# sourceMappingURL=chunk-KRKFTXH6.js.map

package/dist/chunk-KRKFTXH6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/npm/provider.ts","../src/npm/version.ts","../src/npm/install.ts","../src/npm/cache.ts","../src/npm/command.ts"],"sourcesContent":["export const NPM_PROTOCOL_PREFIX = \"npm:\";\n\nexport interface NpmProviderInfo {\n  pkg: string;\n  tag?: string;\n  fragment?: string;\n}\n\nexport interface NpmProviderSpec {\n  packageName: string;\n  version?: string;\n  provider?: string;\n}\n\nexport function isNpmProviderSpec(spec: unknown): spec is string {\n  return typeof spec === \"string\" && spec.startsWith(NPM_PROTOCOL_PREFIX);\n}\n\nexport function parseNpmProvider(provider: string): NpmProviderInfo | null {\n  if (!isNpmProviderSpec(provider)) return null;\n  const rest = provider.slice(NPM_PROTOCOL_PREFIX.length);\n  const hashIdx = rest.indexOf(\"#\");\n  const fragment = hashIdx >= 0 ? rest.slice(hashIdx + 1) : undefined;\n  const beforeHash = hashIdx >= 0 ? rest.slice(0, hashIdx) : rest;\n  const atIdx = beforeHash.startsWith(\"@\") ? beforeHash.indexOf(\"@\", 1) : beforeHash.lastIndexOf(\"@\");\n  const pkg = atIdx > 0 ? beforeHash.slice(0, atIdx) : beforeHash;\n  const tag = atIdx > 0 ? beforeHash.slice(atIdx + 1) : undefined;\n  return { pkg: pkg || beforeHash, tag: tag || undefined, fragment };\n}\n\nexport function parseNpmProviderSpec(spec: string): NpmProviderSpec | null {\n  const parsed = parseNpmProvider(spec);\n  if (!parsed) return null;\n  return {\n    packageName: parsed.pkg,\n    version: parsed.tag,\n    provider: parsed.fragment,\n  };\n}\n","import { execFileSync } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { parseNpmProvider } from \"./provider.js\";\n\ninterface VersionCacheEntry {\n  version: string;\n  timestamp: number;\n}\n\nconst versionCache = new Map<string, VersionCacheEntry>();\nconst CACHE_TTL = 5 * 60 * 1000;\n\nexport interface ResolveNpmVersionOptions {\n  cwd?: string;\n  timeoutMs?: number;\n}\n\nexport function clearVersionCache(): void {\n  versionCache.clear();\n}\n\nexport function resolveNpmPackageVersion(pkg: string, tag?: string, options: ResolveNpmVersionOptions = {}): string | null {\n  const cacheKey = tag ? `${pkg}@${tag}` : pkg;\n  const cached = versionCache.get(cacheKey);\n  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {\n    return cached.version;\n  }\n\n  try {\n    const spec = tag ? `${pkg}@${tag}` : pkg;\n    const out = execFileSync(\"npm\", [\"view\", spec, \"version\"], {\n      cwd: options.cwd ?? process.cwd(),\n      encoding: \"utf-8\",\n      timeout: options.timeoutMs ?? 8000,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    const version = out?.trim() ?? null;\n    if (version) {\n      versionCache.set(cacheKey, { version, timestamp: Date.now() });\n    }\n    return version;\n  } catch {\n    return null;\n  }\n}\n\nexport function resolveLatestVersionFromRegistry(packageName: string, options: ResolveNpmVersionOptions = {}): string {\n  const version = resolveNpmPackageVersion(packageName, undefined, options);\n  if (!version) {\n    throw new Error(`Failed to resolve latest version for ${packageName}`);\n  }\n  return version;\n}\n\nexport function formatProviderDisplay(provider: string): string {\n  const parsed = parseNpmProvider(provider);\n  if (parsed == null) return provider;\n\n  const resolved = resolveNpmPackageVersion(parsed.pkg, parsed.tag);\n  const version = resolved ?? parsed.tag ?? \"latest\";\n  const frag = parsed.fragment ? `#${parsed.fragment}` : \"\";\n  return `npm:${parsed.pkg}@${version}${frag}`;\n}\n\nexport function getInstalledVersion(packageName: string, options: { cwd?: string } = {}): string | null {\n  const cwd = options.cwd ?? process.cwd();\n  const req = createRequire(import.meta.url);\n  try {\n    const p = req.resolve(`${packageName}/package.json`, { paths: [cwd] });\n    const j = JSON.parse(readFileSync(p, \"utf-8\")) as { version?: string };\n    return typeof j.version === \"string\" ? j.version : null;\n  } catch {\n    return null;\n  }\n}\n","import { execFileSync } from \"node:child_process\";\nimport { getInstalledVersion, resolveLatestVersionFromRegistry } from \"./version.js\";\n\nconst VERSION_LATEST = \"latest\";\n\nexport interface EnsureNpmPackageInstalledOptions {\n  version?: string;\n  cwd?: string;\n  stdio?: \"inherit\" | \"pipe\";\n  noPackageLock?: boolean;\n  logPrefix?: string;\n}\n\nasync function resolveInstallVersion(\n  packageName: string,\n  version: string | undefined,\n  cwd: string,\n): Promise<string> {\n  const isLatestOrEmpty =\n    version === undefined ||\n    version === \"\" ||\n    (typeof version === \"string\" && version.toLowerCase() === VERSION_LATEST);\n  if (isLatestOrEmpty) {\n    return resolveLatestVersionFromRegistry(packageName, { cwd });\n  }\n  return version;\n}\n\nexport async function ensureNpmPackageInstalled(\n  packageName: string,\n  options: EnsureNpmPackageInstalledOptions = {},\n): Promise<void> {\n  if (typeof packageName !== \"string\" || packageName.trim().length === 0) {\n    throw new Error(\"ensureNpmPackageInstalled requires a non-empty package name\");\n  }\n\n  const cwd = options.cwd ?? process.cwd();\n  const resolvedVersion = await resolveInstallVersion(packageName, options.version, cwd);\n  const installedVersion = getInstalledVersion(packageName, { cwd });\n\n  if (installedVersion === resolvedVersion) return;\n\n  const installSpec = `${packageName}@${resolvedVersion}`;\n  const prefix = options.logPrefix ?? \"[agent-common]\";\n  if (installedVersion === null) {\n    console.info(`${prefix} Installing provider: ${installSpec}`);\n  } else {\n    console.info(`${prefix} Updating provider: ${packageName} ${installedVersion} -> ${resolvedVersion}`);\n  }\n\n  const args = [\"install\", installSpec];\n  if (options.noPackageLock !== false) args.push(\"--no-package-lock\");\n\n  try {\n    execFileSync(\"npm\", args, {\n      cwd,\n      stdio: options.stdio ?? \"inherit\",\n      encoding: \"utf-8\",\n    });\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`npm install failed for ${installSpec}: ${msg}`, { cause: e });\n  }\n}\n","import { execSync } from \"node:child_process\";\nimport { readFileSync, readdirSync, mkdirSync, rmSync, renameSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolveLatestVersionFromRegistry } from \"./version.js\";\n\nexport interface EnsurePackageInCacheOptions {\n  cacheBase?: string;\n  afterInstall?: (cacheDir: string, packageName: string) => void;\n}\n\nconst DEFAULT_CACHE_BASE = join(homedir(), \".agent\", \"cache\");\n\nfunction isLatestRequest(version: string): boolean {\n  const v = (version ?? \"\").trim().toLowerCase();\n  return v === \"\" || v === \"latest\";\n}\n\nfunction getCachedPackageVersion(cacheDir: string): string | undefined {\n  const pkgPath = join(cacheDir, \"package.json\");\n  if (!existsSync(pkgPath)) return undefined;\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { version?: string };\n    return typeof pkg.version === \"string\" ? pkg.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction packagePathSegments(name: string): string[] {\n  const withoutScope = name.replace(/^@/, \"\");\n  return withoutScope.split(\"/\").filter(Boolean);\n}\n\nfunction resolveCacheDir(cacheBase: string, packageName: string, version: string): string {\n  const segments = packagePathSegments(packageName);\n  return join(cacheBase, ...segments, version);\n}\n\nexport function ensurePackageInCache(\n  packageName: string,\n  version: string = \"latest\",\n  options: EnsurePackageInCacheOptions = {},\n): string {\n  const cacheBase = options.cacheBase ?? DEFAULT_CACHE_BASE;\n  const resolvedVersion = isLatestRequest(version)\n    ? resolveLatestVersionFromRegistry(packageName)\n    : version;\n\n  const cacheDir = resolveCacheDir(cacheBase, packageName, resolvedVersion);\n  const packageJsonPath = join(cacheDir, \"package.json\");\n  const nodeModulesPath = join(cacheDir, \"node_modules\");\n\n  if (existsSync(packageJsonPath) && existsSync(nodeModulesPath)) {\n    const cachedVersion = getCachedPackageVersion(cacheDir);\n    if (cachedVersion === resolvedVersion) {\n      options.afterInstall?.(cacheDir, packageName);\n      return cacheDir;\n    }\n    rmSync(cacheDir, { recursive: true, force: true });\n  }\n\n  const packDest = join(cacheBase, \".pack-tmp\", packageName.replace(/@/g, \"\").replace(/\\//g, \"_\"));\n  mkdirSync(packDest, { recursive: true });\n\n  try {\n    execSync(`npm pack ${packageName}@${resolvedVersion} --pack-destination \"${packDest}\"`, {\n      cwd: process.cwd(),\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n\n    const files = readdirSync(packDest);\n    const tgz = files.find((f) => f.endsWith(\".tgz\"));\n    if (!tgz) throw new Error(`npm pack did not produce a .tgz in ${packDest}`);\n\n    const extractDir = join(packDest, \"extract\");\n    mkdirSync(extractDir, { recursive: true });\n    execSync(`tar -xzf \"${join(packDest, tgz)}\" -C \"${extractDir}\"`, {\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n\n    const extractedPackage = join(extractDir, \"package\");\n    if (!existsSync(extractedPackage)) {\n      throw new Error(`Extracted tarball did not contain \\\"package\\\" dir in ${extractDir}`);\n    }\n\n    mkdirSync(join(cacheDir, \"..\"), { recursive: true });\n    if (existsSync(cacheDir)) rmSync(cacheDir, { recursive: true, force: true });\n    renameSync(extractedPackage, cacheDir);\n\n    const npmInstallTimeout = 120_000;\n    const maxAttempts = 3;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        execSync(\"npm install --prefer-offline --no-audit --no-fund\", {\n          cwd: cacheDir,\n          stdio: \"pipe\",\n          encoding: \"utf-8\",\n          timeout: npmInstallTimeout,\n        });\n        break;\n      } catch (err) {\n        if (attempt >= maxAttempts) {\n          const lastErr = err instanceof Error ? err : new Error(String(err));\n          throw new Error(`npm install in cache failed after ${maxAttempts} attempts: ${lastErr.message}`);\n        }\n        const delayMs = 5_000 * attempt;\n        const deadline = Date.now() + delayMs;\n        while (Date.now() < deadline) {\n          // retry delay\n        }\n      }\n    }\n\n    options.afterInstall?.(cacheDir, packageName);\n    return cacheDir;\n  } finally {\n    if (existsSync(packDest)) rmSync(packDest, { recursive: true, force: true });\n  }\n}\n\nexport function getPackageEntryPath(packageRoot: string): string {\n  const pkgPath = join(packageRoot, \"package.json\");\n  if (!existsSync(pkgPath)) throw new Error(`No package.json in ${packageRoot}`);\n  const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { main?: string };\n  const main = pkg.main ?? \"dist/index.js\";\n  const entry = join(packageRoot, main);\n  if (!existsSync(entry)) throw new Error(`Entry not found: ${entry}`);\n  return entry;\n}\n\nexport async function importFromCache(packageRoot: string): Promise<unknown> {\n  const entryPath = getPackageEntryPath(packageRoot);\n  const fileUrl = pathToFileURL(entryPath).href;\n  return import(/* @vite-ignore */ fileUrl);\n}\n","import { spawnSync } from \"node:child_process\";\n\nexport interface RunNpmCommandOptions {\n  cwd?: string;\n  env?: NodeJS.ProcessEnv;\n  timeoutMs?: number;\n  stdio?: \"pipe\" | \"inherit\";\n  shell?: boolean;\n}\n\nexport interface NpmCommandResult {\n  args: string[];\n  status: number | null;\n  stdout: string;\n  stderr: string;\n  signal: NodeJS.Signals | null;\n  error?: Error;\n}\n\nexport interface NpmInstallOptions extends RunNpmCommandOptions {\n  packages?: string[];\n  global?: boolean;\n  noPackageLock?: boolean;\n  legacyPeerDeps?: boolean;\n  registry?: string;\n}\n\nexport interface NpmPublishOptions extends RunNpmCommandOptions {\n  tag?: string;\n  access?: \"public\" | \"restricted\";\n  registry?: string;\n}\n\nfunction normalizeOutput(v: unknown): string {\n  return typeof v === \"string\" ? v : \"\";\n}\n\nexport function runNpmCommand(args: string[], options: RunNpmCommandOptions = {}): NpmCommandResult {\n  const result = spawnSync(\"npm\", args, {\n    cwd: options.cwd ?? process.cwd(),\n    env: options.env ?? process.env,\n    encoding: \"utf-8\",\n    timeout: options.timeoutMs,\n    stdio: options.stdio ?? \"pipe\",\n    shell: options.shell ?? false,\n  });\n\n  return {\n    args,\n    status: result.status,\n    stdout: normalizeOutput(result.stdout),\n    stderr: normalizeOutput(result.stderr),\n    signal: result.signal,\n    error: result.error ?? undefined,\n  };\n}\n\nexport function assertNpmCommandSuccess(result: NpmCommandResult, context: string): void {\n  if (!result.error && result.status === 0) return;\n  const details =\n    result.error?.message ||\n    result.stderr.trim() ||\n    (result.status == null ? \"terminated\" : `exit code ${result.status}`);\n  throw new Error(`${context} failed: npm ${result.args.join(\" \")} (${details})`);\n}\n\nexport function npmSearchJson(query: string, options: RunNpmCommandOptions = {}): unknown[] {\n  const result = runNpmCommand([\"search\", query, \"--json\"], options);\n  if (result.error || result.status !== 0) return [];\n  const text = result.stdout.trim();\n  if (!text) return [];\n  try {\n    const parsed = JSON.parse(text) as unknown;\n    return Array.isArray(parsed) ? parsed : [];\n  } catch {\n    return [];\n  }\n}\n\nexport function npmInstall(options: NpmInstallOptions = {}): void {\n  const args: string[] = [\"install\"];\n  if (options.global) args.push(\"-g\");\n  if (options.registry) args.push(\"--registry\", options.registry);\n  if (options.legacyPeerDeps) args.push(\"--legacy-peer-deps\");\n  if (options.noPackageLock) args.push(\"--no-package-lock\");\n  if (Array.isArray(options.packages) && options.packages.length > 0) {\n    args.push(...options.packages);\n  }\n  const result = runNpmCommand(args, options);\n  assertNpmCommandSuccess(result, \"npm install\");\n}\n\nexport function npmRunScript(script: string, options: RunNpmCommandOptions = {}): void {\n  const result = runNpmCommand([\"run\", script], options);\n  assertNpmCommandSuccess(result, `npm run ${script}`);\n}\n\nexport function npmPublish(options: NpmPublishOptions = {}): void {\n  const args: string[] = [\"publish\"];\n  if (options.tag) args.push(\"--tag\", options.tag);\n  if (options.access) args.push(\"--access\", options.access);\n  if (options.registry) args.push(\"--registry\", options.registry);\n  const result = runNpmCommand(args, options);\n  assertNpmCommandSuccess(result, \"npm publish\");\n}\n\nexport function npmRoot(options: RunNpmCommandOptions & { global?: boolean } = {}): string {\n  const args = [\"root\", ...(options.global ? [\"-g\"] : [])];\n  const result = runNpmCommand(args, options);\n  assertNpmCommandSuccess(result, \"npm root\");\n  return result.stdout.trim();\n}\n"],"mappings":"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","names":["execFileSync","execFileSync","readFileSync","readFileSync"]}

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   NPM_PROTOCOL_PREFIX,
+  assertNpmCommandSuccess,
   clearVersionCache,
   ensureNpmPackageInstalled,
   ensurePackageInCache,
@@ -8,13 +9,20 @@ import {
   getPackageEntryPath,
   importFromCache,
   isNpmProviderSpec,
+  npmInstall,
+  npmPublish,
+  npmRoot,
+  npmRunScript,
+  npmSearchJson,
   parseNpmProvider,
   parseNpmProviderSpec,
   resolveLatestVersionFromRegistry,
-  resolveNpmPackageVersion
-} from "./chunk-3PI6JR76.js";
+  resolveNpmPackageVersion,
+  runNpmCommand
+} from "./chunk-KRKFTXH6.js";
 export {
   NPM_PROTOCOL_PREFIX,
+  assertNpmCommandSuccess,
   clearVersionCache,
   ensureNpmPackageInstalled,
   ensurePackageInCache,
@@ -23,9 +31,15 @@ export {
   getPackageEntryPath,
   importFromCache,
   isNpmProviderSpec,
+  npmInstall,
+  npmPublish,
+  npmRoot,
+  npmRunScript,
+  npmSearchJson,
   parseNpmProvider,
   parseNpmProviderSpec,
   resolveLatestVersionFromRegistry,
-  resolveNpmPackageVersion
+  resolveNpmPackageVersion,
+  runNpmCommand
 };
 //# sourceMappingURL=index.js.map

package/dist/npm/command.d.ts

@@ -0,0 +1,36 @@
+export interface RunNpmCommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    stdio?: "pipe" | "inherit";
+    shell?: boolean;
+}
+export interface NpmCommandResult {
+    args: string[];
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    signal: NodeJS.Signals | null;
+    error?: Error;
+}
+export interface NpmInstallOptions extends RunNpmCommandOptions {
+    packages?: string[];
+    global?: boolean;
+    noPackageLock?: boolean;
+    legacyPeerDeps?: boolean;
+    registry?: string;
+}
+export interface NpmPublishOptions extends RunNpmCommandOptions {
+    tag?: string;
+    access?: "public" | "restricted";
+    registry?: string;
+}
+export declare function runNpmCommand(args: string[], options?: RunNpmCommandOptions): NpmCommandResult;
+export declare function assertNpmCommandSuccess(result: NpmCommandResult, context: string): void;
+export declare function npmSearchJson(query: string, options?: RunNpmCommandOptions): unknown[];
+export declare function npmInstall(options?: NpmInstallOptions): void;
+export declare function npmRunScript(script: string, options?: RunNpmCommandOptions): void;
+export declare function npmPublish(options?: NpmPublishOptions): void;
+export declare function npmRoot(options?: RunNpmCommandOptions & {
+    global?: boolean;
+}): string;

package/dist/npm/index.d.ts

@@ -2,3 +2,4 @@ export { NPM_PROTOCOL_PREFIX, isNpmProviderSpec, parseNpmProvider, parseNpmProvi
 export { clearVersionCache, resolveNpmPackageVersion, resolveLatestVersionFromRegistry, formatProviderDisplay, getInstalledVersion, type ResolveNpmVersionOptions, } from "./version.js";
 export { ensureNpmPackageInstalled, type EnsureNpmPackageInstalledOptions, } from "./install.js";
 export { ensurePackageInCache, getPackageEntryPath, importFromCache, type EnsurePackageInCacheOptions, } from "./cache.js";
+export { runNpmCommand, assertNpmCommandSuccess, npmSearchJson, npmInstall, npmRunScript, npmPublish, npmRoot, type RunNpmCommandOptions, type NpmCommandResult, type NpmInstallOptions, type NpmPublishOptions, } from "./command.js";

package/dist/npm/index.js

@@ -1,5 +1,6 @@
 import {
   NPM_PROTOCOL_PREFIX,
+  assertNpmCommandSuccess,
   clearVersionCache,
   ensureNpmPackageInstalled,
   ensurePackageInCache,
@@ -8,13 +9,20 @@ import {
   getPackageEntryPath,
   importFromCache,
   isNpmProviderSpec,
+  npmInstall,
+  npmPublish,
+  npmRoot,
+  npmRunScript,
+  npmSearchJson,
   parseNpmProvider,
   parseNpmProviderSpec,
   resolveLatestVersionFromRegistry,
-  resolveNpmPackageVersion
-} from "../chunk-3PI6JR76.js";
+  resolveNpmPackageVersion,
+  runNpmCommand
+} from "../chunk-KRKFTXH6.js";
 export {
   NPM_PROTOCOL_PREFIX,
+  assertNpmCommandSuccess,
   clearVersionCache,
   ensureNpmPackageInstalled,
   ensurePackageInCache,
@@ -23,9 +31,15 @@ export {
   getPackageEntryPath,
   importFromCache,
   isNpmProviderSpec,
+  npmInstall,
+  npmPublish,
+  npmRoot,
+  npmRunScript,
+  npmSearchJson,
   parseNpmProvider,
   parseNpmProviderSpec,
   resolveLatestVersionFromRegistry,
-  resolveNpmPackageVersion
+  resolveNpmPackageVersion,
+  runNpmCommand
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easynet/agent-common",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Shared runtime utilities for Easynet agent projects",
   "type": "module",
   "main": "./dist/index.js",

package/dist/chunk-3PI6JR76.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/npm/provider.ts","../src/npm/version.ts","../src/npm/install.ts","../src/npm/cache.ts"],"sourcesContent":["export const NPM_PROTOCOL_PREFIX = \"npm:\";\n\nexport interface NpmProviderInfo {\n  pkg: string;\n  tag?: string;\n  fragment?: string;\n}\n\nexport interface NpmProviderSpec {\n  packageName: string;\n  version?: string;\n  provider?: string;\n}\n\nexport function isNpmProviderSpec(spec: unknown): spec is string {\n  return typeof spec === \"string\" && spec.startsWith(NPM_PROTOCOL_PREFIX);\n}\n\nexport function parseNpmProvider(provider: string): NpmProviderInfo | null {\n  if (!isNpmProviderSpec(provider)) return null;\n  const rest = provider.slice(NPM_PROTOCOL_PREFIX.length);\n  const hashIdx = rest.indexOf(\"#\");\n  const fragment = hashIdx >= 0 ? rest.slice(hashIdx + 1) : undefined;\n  const beforeHash = hashIdx >= 0 ? rest.slice(0, hashIdx) : rest;\n  const atIdx = beforeHash.startsWith(\"@\") ? beforeHash.indexOf(\"@\", 1) : beforeHash.lastIndexOf(\"@\");\n  const pkg = atIdx > 0 ? beforeHash.slice(0, atIdx) : beforeHash;\n  const tag = atIdx > 0 ? beforeHash.slice(atIdx + 1) : undefined;\n  return { pkg: pkg || beforeHash, tag: tag || undefined, fragment };\n}\n\nexport function parseNpmProviderSpec(spec: string): NpmProviderSpec | null {\n  const parsed = parseNpmProvider(spec);\n  if (!parsed) return null;\n  return {\n    packageName: parsed.pkg,\n    version: parsed.tag,\n    provider: parsed.fragment,\n  };\n}\n","import { execFileSync } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { parseNpmProvider } from \"./provider.js\";\n\ninterface VersionCacheEntry {\n  version: string;\n  timestamp: number;\n}\n\nconst versionCache = new Map<string, VersionCacheEntry>();\nconst CACHE_TTL = 5 * 60 * 1000;\n\nexport interface ResolveNpmVersionOptions {\n  cwd?: string;\n  timeoutMs?: number;\n}\n\nexport function clearVersionCache(): void {\n  versionCache.clear();\n}\n\nexport function resolveNpmPackageVersion(pkg: string, tag?: string, options: ResolveNpmVersionOptions = {}): string | null {\n  const cacheKey = tag ? `${pkg}@${tag}` : pkg;\n  const cached = versionCache.get(cacheKey);\n  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {\n    return cached.version;\n  }\n\n  try {\n    const spec = tag ? `${pkg}@${tag}` : pkg;\n    const out = execFileSync(\"npm\", [\"view\", spec, \"version\"], {\n      cwd: options.cwd ?? process.cwd(),\n      encoding: \"utf-8\",\n      timeout: options.timeoutMs ?? 8000,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    const version = out?.trim() ?? null;\n    if (version) {\n      versionCache.set(cacheKey, { version, timestamp: Date.now() });\n    }\n    return version;\n  } catch {\n    return null;\n  }\n}\n\nexport function resolveLatestVersionFromRegistry(packageName: string, options: ResolveNpmVersionOptions = {}): string {\n  const version = resolveNpmPackageVersion(packageName, undefined, options);\n  if (!version) {\n    throw new Error(`Failed to resolve latest version for ${packageName}`);\n  }\n  return version;\n}\n\nexport function formatProviderDisplay(provider: string): string {\n  const parsed = parseNpmProvider(provider);\n  if (parsed == null) return provider;\n\n  const resolved = resolveNpmPackageVersion(parsed.pkg, parsed.tag);\n  const version = resolved ?? parsed.tag ?? \"latest\";\n  const frag = parsed.fragment ? `#${parsed.fragment}` : \"\";\n  return `npm:${parsed.pkg}@${version}${frag}`;\n}\n\nexport function getInstalledVersion(packageName: string, options: { cwd?: string } = {}): string | null {\n  const cwd = options.cwd ?? process.cwd();\n  const req = createRequire(import.meta.url);\n  try {\n    const p = req.resolve(`${packageName}/package.json`, { paths: [cwd] });\n    const j = JSON.parse(readFileSync(p, \"utf-8\")) as { version?: string };\n    return typeof j.version === \"string\" ? j.version : null;\n  } catch {\n    return null;\n  }\n}\n","import { execFileSync } from \"node:child_process\";\nimport { getInstalledVersion, resolveLatestVersionFromRegistry } from \"./version.js\";\n\nconst VERSION_LATEST = \"latest\";\n\nexport interface EnsureNpmPackageInstalledOptions {\n  version?: string;\n  cwd?: string;\n  stdio?: \"inherit\" | \"pipe\";\n  noPackageLock?: boolean;\n  logPrefix?: string;\n}\n\nasync function resolveInstallVersion(\n  packageName: string,\n  version: string | undefined,\n  cwd: string,\n): Promise<string> {\n  const isLatestOrEmpty =\n    version === undefined ||\n    version === \"\" ||\n    (typeof version === \"string\" && version.toLowerCase() === VERSION_LATEST);\n  if (isLatestOrEmpty) {\n    return resolveLatestVersionFromRegistry(packageName, { cwd });\n  }\n  return version;\n}\n\nexport async function ensureNpmPackageInstalled(\n  packageName: string,\n  options: EnsureNpmPackageInstalledOptions = {},\n): Promise<void> {\n  if (typeof packageName !== \"string\" || packageName.trim().length === 0) {\n    throw new Error(\"ensureNpmPackageInstalled requires a non-empty package name\");\n  }\n\n  const cwd = options.cwd ?? process.cwd();\n  const resolvedVersion = await resolveInstallVersion(packageName, options.version, cwd);\n  const installedVersion = getInstalledVersion(packageName, { cwd });\n\n  if (installedVersion === resolvedVersion) return;\n\n  const installSpec = `${packageName}@${resolvedVersion}`;\n  const prefix = options.logPrefix ?? \"[agent-common]\";\n  if (installedVersion === null) {\n    console.info(`${prefix} Installing provider: ${installSpec}`);\n  } else {\n    console.info(`${prefix} Updating provider: ${packageName} ${installedVersion} -> ${resolvedVersion}`);\n  }\n\n  const args = [\"install\", installSpec];\n  if (options.noPackageLock !== false) args.push(\"--no-package-lock\");\n\n  try {\n    execFileSync(\"npm\", args, {\n      cwd,\n      stdio: options.stdio ?? \"inherit\",\n      encoding: \"utf-8\",\n    });\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`npm install failed for ${installSpec}: ${msg}`, { cause: e });\n  }\n}\n","import { execSync } from \"node:child_process\";\nimport { readFileSync, readdirSync, mkdirSync, rmSync, renameSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolveLatestVersionFromRegistry } from \"./version.js\";\n\nexport interface EnsurePackageInCacheOptions {\n  cacheBase?: string;\n  afterInstall?: (cacheDir: string, packageName: string) => void;\n}\n\nconst DEFAULT_CACHE_BASE = join(homedir(), \".agent\", \"cache\");\n\nfunction isLatestRequest(version: string): boolean {\n  const v = (version ?? \"\").trim().toLowerCase();\n  return v === \"\" || v === \"latest\";\n}\n\nfunction getCachedPackageVersion(cacheDir: string): string | undefined {\n  const pkgPath = join(cacheDir, \"package.json\");\n  if (!existsSync(pkgPath)) return undefined;\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { version?: string };\n    return typeof pkg.version === \"string\" ? pkg.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction packagePathSegments(name: string): string[] {\n  const withoutScope = name.replace(/^@/, \"\");\n  return withoutScope.split(\"/\").filter(Boolean);\n}\n\nfunction resolveCacheDir(cacheBase: string, packageName: string, version: string): string {\n  const segments = packagePathSegments(packageName);\n  return join(cacheBase, ...segments, version);\n}\n\nexport function ensurePackageInCache(\n  packageName: string,\n  version: string = \"latest\",\n  options: EnsurePackageInCacheOptions = {},\n): string {\n  const cacheBase = options.cacheBase ?? DEFAULT_CACHE_BASE;\n  const resolvedVersion = isLatestRequest(version)\n    ? resolveLatestVersionFromRegistry(packageName)\n    : version;\n\n  const cacheDir = resolveCacheDir(cacheBase, packageName, resolvedVersion);\n  const packageJsonPath = join(cacheDir, \"package.json\");\n  const nodeModulesPath = join(cacheDir, \"node_modules\");\n\n  if (existsSync(packageJsonPath) && existsSync(nodeModulesPath)) {\n    const cachedVersion = getCachedPackageVersion(cacheDir);\n    if (cachedVersion === resolvedVersion) {\n      options.afterInstall?.(cacheDir, packageName);\n      return cacheDir;\n    }\n    rmSync(cacheDir, { recursive: true, force: true });\n  }\n\n  const packDest = join(cacheBase, \".pack-tmp\", packageName.replace(/@/g, \"\").replace(/\\//g, \"_\"));\n  mkdirSync(packDest, { recursive: true });\n\n  try {\n    execSync(`npm pack ${packageName}@${resolvedVersion} --pack-destination \"${packDest}\"`, {\n      cwd: process.cwd(),\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n\n    const files = readdirSync(packDest);\n    const tgz = files.find((f) => f.endsWith(\".tgz\"));\n    if (!tgz) throw new Error(`npm pack did not produce a .tgz in ${packDest}`);\n\n    const extractDir = join(packDest, \"extract\");\n    mkdirSync(extractDir, { recursive: true });\n    execSync(`tar -xzf \"${join(packDest, tgz)}\" -C \"${extractDir}\"`, {\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n\n    const extractedPackage = join(extractDir, \"package\");\n    if (!existsSync(extractedPackage)) {\n      throw new Error(`Extracted tarball did not contain \\\"package\\\" dir in ${extractDir}`);\n    }\n\n    mkdirSync(join(cacheDir, \"..\"), { recursive: true });\n    if (existsSync(cacheDir)) rmSync(cacheDir, { recursive: true, force: true });\n    renameSync(extractedPackage, cacheDir);\n\n    const npmInstallTimeout = 120_000;\n    const maxAttempts = 3;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        execSync(\"npm install --prefer-offline --no-audit --no-fund\", {\n          cwd: cacheDir,\n          stdio: \"pipe\",\n          encoding: \"utf-8\",\n          timeout: npmInstallTimeout,\n        });\n        break;\n      } catch (err) {\n        if (attempt >= maxAttempts) {\n          const lastErr = err instanceof Error ? err : new Error(String(err));\n          throw new Error(`npm install in cache failed after ${maxAttempts} attempts: ${lastErr.message}`);\n        }\n        const delayMs = 5_000 * attempt;\n        const deadline = Date.now() + delayMs;\n        while (Date.now() < deadline) {\n          // retry delay\n        }\n      }\n    }\n\n    options.afterInstall?.(cacheDir, packageName);\n    return cacheDir;\n  } finally {\n    if (existsSync(packDest)) rmSync(packDest, { recursive: true, force: true });\n  }\n}\n\nexport function getPackageEntryPath(packageRoot: string): string {\n  const pkgPath = join(packageRoot, \"package.json\");\n  if (!existsSync(pkgPath)) throw new Error(`No package.json in ${packageRoot}`);\n  const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { main?: string };\n  const main = pkg.main ?? \"dist/index.js\";\n  const entry = join(packageRoot, main);\n  if (!existsSync(entry)) throw new Error(`Entry not found: ${entry}`);\n  return entry;\n}\n\nexport async function importFromCache(packageRoot: string): Promise<unknown> {\n  const entryPath = getPackageEntryPath(packageRoot);\n  const fileUrl = pathToFileURL(entryPath).href;\n  return import(/* @vite-ignore */ fileUrl);\n}\n"],"mappings":"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","names":["execFileSync","execFileSync","readFileSync","readFileSync"]}