@exyconn/common 1.0.0 → 2.1.0

package/dist/client/utils/index.d.mts

@@ -282,4 +282,126 @@ declare const createSuccessResponse: <T>(data: T, message?: string) => ApiRespon
  */
 declare const createErrorResponse: (message: string, statusCode?: number, error?: string) => ApiResponse<never>;
 
-export { ApiUrlBuilder, type ApiUrlConfig, EventEmitter, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatRelativeTime, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify };
+/**
+ * Package Check Utility
+ * Analyzes package.json dependencies and checks for updates
+ *
+ * Features:
+ * - Fetches package.json from URL or file path
+ * - Checks all dependency types (dependencies, devDependencies, peerDependencies, optionalDependencies)
+ * - Compares versions with npm registry
+ * - Provides update suggestions
+ * - Supports auto mode with npm-check-updates
+ */
+interface PackageVersion {
+    /** Package name */
+    name: string;
+    /** Current version in package.json */
+    current: string;
+    /** Latest version available on npm */
+    latest: string;
+    /** Is update available? */
+    hasUpdate: boolean;
+    /** Update type: major, minor, patch, or none */
+    updateType: 'major' | 'minor' | 'patch' | 'prerelease' | 'none';
+    /** Dependency type */
+    dependencyType: 'dependencies' | 'devDependencies' | 'peerDependencies' | 'optionalDependencies';
+}
+interface PackageCheckResult {
+    /** Package name from package.json */
+    packageName: string;
+    /** Current package version */
+    packageVersion: string;
+    /** Total dependencies checked */
+    totalDependencies: number;
+    /** Dependencies with updates available */
+    outdatedCount: number;
+    /** All dependency information */
+    dependencies: PackageVersion[];
+    /** Dependencies grouped by type */
+    byType: {
+        dependencies: PackageVersion[];
+        devDependencies: PackageVersion[];
+        peerDependencies: PackageVersion[];
+        optionalDependencies: PackageVersion[];
+    };
+    /** Dependencies grouped by update type */
+    byUpdateType: {
+        major: PackageVersion[];
+        minor: PackageVersion[];
+        patch: PackageVersion[];
+        prerelease: PackageVersion[];
+    };
+    /** Timestamp of check */
+    checkedAt: Date;
+    /** Errors encountered */
+    errors: string[];
+}
+interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+}
+interface NpmRegistryResponse {
+    'dist-tags': {
+        latest: string;
+        [key: string]: string;
+    };
+    versions: Record<string, unknown>;
+}
+/**
+ * Parse version string, removing range operators
+ */
+declare function parseVersion(version: string): string;
+/**
+ * Compare two semver versions
+ */
+declare function compareVersions(current: string, latest: string): 'major' | 'minor' | 'patch' | 'prerelease' | 'none';
+/**
+ * Main function to check package.json for updates
+ *
+ * @example
+ * // From URL
+ * const result = await checkPackage('https://raw.githubusercontent.com/user/repo/main/package.json');
+ *
+ * @example
+ * // From object
+ * const result = await checkPackage({
+ *   name: 'my-package',
+ *   dependencies: { 'lodash': '^4.17.0' }
+ * });
+ *
+ * @example
+ * // In Node.js, read file first
+ * import fs from 'fs';
+ * const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf-8'));
+ * const result = await checkPackage(pkg);
+ */
+declare function checkPackage(source: string | PackageJson): Promise<PackageCheckResult>;
+/**
+ * Format check result as human-readable string
+ */
+declare function formatPackageCheckResult(result: PackageCheckResult): string;
+/**
+ * Generate ncu (npm-check-updates) command
+ */
+declare function generateNcuCommand(result: PackageCheckResult, options?: {
+    updateType?: 'major' | 'minor' | 'patch' | 'all';
+    interactive?: boolean;
+    upgrade?: boolean;
+}): string;
+/**
+ * Package check utilities for client-side usage
+ */
+declare const packageCheck: {
+    readonly check: typeof checkPackage;
+    readonly format: typeof formatPackageCheckResult;
+    readonly generateNcuCommand: typeof generateNcuCommand;
+    readonly parseVersion: typeof parseVersion;
+    readonly compareVersions: typeof compareVersions;
+};
+
+export { ApiUrlBuilder, type ApiUrlConfig, EventEmitter, type NpmRegistryResponse, type PackageCheckResult, type PackageJson, type PackageVersion, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, checkPackage, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatPackageCheckResult, formatRelativeTime, generateNcuCommand, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, packageCheck, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify };

package/dist/client/utils/index.d.ts

@@ -282,4 +282,126 @@ declare const createSuccessResponse: <T>(data: T, message?: string) => ApiRespon
  */
 declare const createErrorResponse: (message: string, statusCode?: number, error?: string) => ApiResponse<never>;
 
-export { ApiUrlBuilder, type ApiUrlConfig, EventEmitter, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatRelativeTime, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify };
+/**
+ * Package Check Utility
+ * Analyzes package.json dependencies and checks for updates
+ *
+ * Features:
+ * - Fetches package.json from URL or file path
+ * - Checks all dependency types (dependencies, devDependencies, peerDependencies, optionalDependencies)
+ * - Compares versions with npm registry
+ * - Provides update suggestions
+ * - Supports auto mode with npm-check-updates
+ */
+interface PackageVersion {
+    /** Package name */
+    name: string;
+    /** Current version in package.json */
+    current: string;
+    /** Latest version available on npm */
+    latest: string;
+    /** Is update available? */
+    hasUpdate: boolean;
+    /** Update type: major, minor, patch, or none */
+    updateType: 'major' | 'minor' | 'patch' | 'prerelease' | 'none';
+    /** Dependency type */
+    dependencyType: 'dependencies' | 'devDependencies' | 'peerDependencies' | 'optionalDependencies';
+}
+interface PackageCheckResult {
+    /** Package name from package.json */
+    packageName: string;
+    /** Current package version */
+    packageVersion: string;
+    /** Total dependencies checked */
+    totalDependencies: number;
+    /** Dependencies with updates available */
+    outdatedCount: number;
+    /** All dependency information */
+    dependencies: PackageVersion[];
+    /** Dependencies grouped by type */
+    byType: {
+        dependencies: PackageVersion[];
+        devDependencies: PackageVersion[];
+        peerDependencies: PackageVersion[];
+        optionalDependencies: PackageVersion[];
+    };
+    /** Dependencies grouped by update type */
+    byUpdateType: {
+        major: PackageVersion[];
+        minor: PackageVersion[];
+        patch: PackageVersion[];
+        prerelease: PackageVersion[];
+    };
+    /** Timestamp of check */
+    checkedAt: Date;
+    /** Errors encountered */
+    errors: string[];
+}
+interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+}
+interface NpmRegistryResponse {
+    'dist-tags': {
+        latest: string;
+        [key: string]: string;
+    };
+    versions: Record<string, unknown>;
+}
+/**
+ * Parse version string, removing range operators
+ */
+declare function parseVersion(version: string): string;
+/**
+ * Compare two semver versions
+ */
+declare function compareVersions(current: string, latest: string): 'major' | 'minor' | 'patch' | 'prerelease' | 'none';
+/**
+ * Main function to check package.json for updates
+ *
+ * @example
+ * // From URL
+ * const result = await checkPackage('https://raw.githubusercontent.com/user/repo/main/package.json');
+ *
+ * @example
+ * // From object
+ * const result = await checkPackage({
+ *   name: 'my-package',
+ *   dependencies: { 'lodash': '^4.17.0' }
+ * });
+ *
+ * @example
+ * // In Node.js, read file first
+ * import fs from 'fs';
+ * const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf-8'));
+ * const result = await checkPackage(pkg);
+ */
+declare function checkPackage(source: string | PackageJson): Promise<PackageCheckResult>;
+/**
+ * Format check result as human-readable string
+ */
+declare function formatPackageCheckResult(result: PackageCheckResult): string;
+/**
+ * Generate ncu (npm-check-updates) command
+ */
+declare function generateNcuCommand(result: PackageCheckResult, options?: {
+    updateType?: 'major' | 'minor' | 'patch' | 'all';
+    interactive?: boolean;
+    upgrade?: boolean;
+}): string;
+/**
+ * Package check utilities for client-side usage
+ */
+declare const packageCheck: {
+    readonly check: typeof checkPackage;
+    readonly format: typeof formatPackageCheckResult;
+    readonly generateNcuCommand: typeof generateNcuCommand;
+    readonly parseVersion: typeof parseVersion;
+    readonly compareVersions: typeof compareVersions;
+};
+
+export { ApiUrlBuilder, type ApiUrlConfig, EventEmitter, type NpmRegistryResponse, type PackageCheckResult, type PackageJson, type PackageVersion, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, checkPackage, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatPackageCheckResult, formatRelativeTime, generateNcuCommand, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, packageCheck, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify };

package/dist/client/utils/index.js

@@ -359,6 +359,209 @@ var createErrorResponse = (message, statusCode = 400, error) => ({
   statusCode
 });
 
+// src/client/utils/packageCheck.ts
+function parseVersion(version) {
+  return version.replace(/[\^~>=<|*x\s]/g, "").split(" ")[0] || "0.0.0";
+}
+function compareVersions(current, latest) {
+  const currentClean = parseVersion(current);
+  const latestClean = parseVersion(latest);
+  if (currentClean === latestClean) return "none";
+  const [curMajor, curMinor, curPatch] = currentClean.split(".").map(Number);
+  const [latMajor, latMinor, latPatch] = latestClean.split(".").map(Number);
+  if (latest.includes("-")) return "prerelease";
+  if (latMajor > curMajor) return "major";
+  if (latMinor > curMinor) return "minor";
+  if (latPatch > curPatch) return "patch";
+  return "none";
+}
+async function fetchLatestVersion(packageName) {
+  try {
+    const encodedName = packageName.startsWith("@") ? `@${encodeURIComponent(packageName.slice(1))}` : encodeURIComponent(packageName);
+    const response = await fetch(`https://registry.npmjs.org/${encodedName}`);
+    if (!response.ok) {
+      return null;
+    }
+    const data = await response.json();
+    return data["dist-tags"]?.latest || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchPackageJson(source) {
+  if (typeof source === "object") {
+    return source;
+  }
+  if (source.startsWith("http://") || source.startsWith("https://")) {
+    const response = await fetch(source);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch package.json from ${source}: ${response.status}`);
+    }
+    return response.json();
+  }
+  throw new Error(
+    "File path support requires Node.js environment. Use URL or pass package.json object directly."
+  );
+}
+async function checkDependencyType(deps, type, errors) {
+  if (!deps) return [];
+  const results = [];
+  const entries = Object.entries(deps);
+  const concurrencyLimit = 10;
+  for (let i = 0; i < entries.length; i += concurrencyLimit) {
+    const batch = entries.slice(i, i + concurrencyLimit);
+    const batchResults = await Promise.all(
+      batch.map(async ([name, currentVersion]) => {
+        try {
+          const latest = await fetchLatestVersion(name);
+          if (!latest) {
+            errors.push(`Could not fetch latest version for ${name}`);
+            return {
+              name,
+              current: currentVersion,
+              latest: "unknown",
+              hasUpdate: false,
+              updateType: "none",
+              dependencyType: type
+            };
+          }
+          const updateType = compareVersions(currentVersion, latest);
+          return {
+            name,
+            current: currentVersion,
+            latest,
+            hasUpdate: updateType !== "none",
+            updateType,
+            dependencyType: type
+          };
+        } catch (err) {
+          errors.push(`Error checking ${name}: ${err}`);
+          return {
+            name,
+            current: currentVersion,
+            latest: "error",
+            hasUpdate: false,
+            updateType: "none",
+            dependencyType: type
+          };
+        }
+      })
+    );
+    results.push(...batchResults);
+  }
+  return results;
+}
+async function checkPackage(source) {
+  const errors = [];
+  let pkg;
+  try {
+    pkg = await fetchPackageJson(source);
+  } catch (err) {
+    throw new Error(`Failed to load package.json: ${err}`);
+  }
+  const [dependencies, devDependencies, peerDependencies, optionalDependencies] = await Promise.all([
+    checkDependencyType(pkg.dependencies, "dependencies", errors),
+    checkDependencyType(pkg.devDependencies, "devDependencies", errors),
+    checkDependencyType(pkg.peerDependencies, "peerDependencies", errors),
+    checkDependencyType(pkg.optionalDependencies, "optionalDependencies", errors)
+  ]);
+  const allDeps = [...dependencies, ...devDependencies, ...peerDependencies, ...optionalDependencies];
+  return {
+    packageName: pkg.name || "unknown",
+    packageVersion: pkg.version || "0.0.0",
+    totalDependencies: allDeps.length,
+    outdatedCount: allDeps.filter((d) => d.hasUpdate).length,
+    dependencies: allDeps,
+    byType: {
+      dependencies,
+      devDependencies,
+      peerDependencies,
+      optionalDependencies
+    },
+    byUpdateType: {
+      major: allDeps.filter((d) => d.updateType === "major"),
+      minor: allDeps.filter((d) => d.updateType === "minor"),
+      patch: allDeps.filter((d) => d.updateType === "patch"),
+      prerelease: allDeps.filter((d) => d.updateType === "prerelease")
+    },
+    checkedAt: /* @__PURE__ */ new Date(),
+    errors
+  };
+}
+function formatPackageCheckResult(result) {
+  const lines = [];
+  lines.push(`\u{1F4E6} Package: ${result.packageName}@${result.packageVersion}`);
+  lines.push(`\u{1F4C5} Checked: ${result.checkedAt.toISOString()}`);
+  lines.push(`\u{1F4CA} Total: ${result.totalDependencies} | Outdated: ${result.outdatedCount}`);
+  lines.push("");
+  if (result.byUpdateType.major.length > 0) {
+    lines.push("\u{1F534} MAJOR Updates:");
+    result.byUpdateType.major.forEach((d) => {
+      lines.push(`   ${d.name}: ${d.current} \u2192 ${d.latest}`);
+    });
+    lines.push("");
+  }
+  if (result.byUpdateType.minor.length > 0) {
+    lines.push("\u{1F7E1} MINOR Updates:");
+    result.byUpdateType.minor.forEach((d) => {
+      lines.push(`   ${d.name}: ${d.current} \u2192 ${d.latest}`);
+    });
+    lines.push("");
+  }
+  if (result.byUpdateType.patch.length > 0) {
+    lines.push("\u{1F7E2} PATCH Updates:");
+    result.byUpdateType.patch.forEach((d) => {
+      lines.push(`   ${d.name}: ${d.current} \u2192 ${d.latest}`);
+    });
+    lines.push("");
+  }
+  if (result.errors.length > 0) {
+    lines.push("\u26A0\uFE0F  Errors:");
+    result.errors.forEach((e) => {
+      lines.push(`   ${e}`);
+    });
+  }
+  return lines.join("\n");
+}
+function generateNcuCommand(result, options = {}) {
+  const { updateType = "all", interactive = false, upgrade = false } = options;
+  let packages = [];
+  switch (updateType) {
+    case "major":
+      packages = result.byUpdateType.major.map((d) => d.name);
+      break;
+    case "minor":
+      packages = result.byUpdateType.minor.map((d) => d.name);
+      break;
+    case "patch":
+      packages = result.byUpdateType.patch.map((d) => d.name);
+      break;
+    default:
+      packages = result.dependencies.filter((d) => d.hasUpdate).map((d) => d.name);
+  }
+  if (packages.length === 0) {
+    return "# No updates available";
+  }
+  let cmd = "npx npm-check-updates";
+  if (packages.length > 0 && packages.length < result.dependencies.length) {
+    cmd += ` --filter "${packages.join(",")}"`;
+  }
+  if (interactive) {
+    cmd += " --interactive";
+  }
+  if (upgrade) {
+    cmd += " --upgrade";
+  }
+  return cmd;
+}
+var packageCheck = {
+  check: checkPackage,
+  format: formatPackageCheckResult,
+  generateNcuCommand,
+  parseVersion,
+  compareVersions
+};
+
 exports.ApiUrlBuilder = ApiUrlBuilder;
 exports.EventEmitter = EventEmitter;
 exports.addDays = addDays;
@@ -366,6 +569,7 @@ exports.appEvents = appEvents;
 exports.camelToKebab = camelToKebab;
 exports.capitalize = capitalize;
 exports.capitalizeWords = capitalizeWords;
+exports.checkPackage = checkPackage;
 exports.copyToClipboard = copyToClipboard;
 exports.createApiEndpoints = createApiEndpoints;
 exports.createApiUrlBuilder = createApiUrlBuilder;
@@ -378,7 +582,9 @@ exports.formatDate = formatDate;
 exports.formatDateForInput = formatDateForInput;
 exports.formatDateTime = formatDateTime;
 exports.formatDateTimeForInput = formatDateTimeForInput;
+exports.formatPackageCheckResult = formatPackageCheckResult;
 exports.formatRelativeTime = formatRelativeTime;
+exports.generateNcuCommand = generateNcuCommand;
 exports.getErrorMessage = getErrorMessage;
 exports.getNextPage = getNextPage;
 exports.getPrevPage = getPrevPage;
@@ -392,6 +598,7 @@ exports.isPast = isPast;
 exports.isSuccessResponse = isSuccessResponse;
 exports.isToday = isToday;
 exports.kebabToCamel = kebabToCamel;
+exports.packageCheck = packageCheck;
 exports.readFromClipboard = readFromClipboard;
 exports.slugify = slugify;
 exports.slugifyUnique = slugifyUnique;