@zintrust/core 0.1.28 → 0.1.29

package/src/cli/services/VersionChecker.ts

@@ -1,308 +0,0 @@
-/**
- * VersionChecker - CLI Version Update Notification Service
- *
- * Checks if the current CLI version is outdated and warns users
- * when a newer version is available from npm registry.
- */
-
-import { HttpClient, type IHttpResponse } from '@httpClient/Http';
-import { existsSync, readFileSync } from '@node-singletons/fs';
-import { dirname, join } from '@node-singletons/path';
-import { fileURLToPath } from '@node-singletons/url';
-
-interface VersionCheckResult {
-  currentVersion: string;
-  latestVersion: string;
-  isOutdated: boolean;
-  updateAvailable: boolean;
-}
-
-interface VersionCheckConfig {
-  enabled: boolean;
-  checkInterval: number; // hours
-  skipVersionCheck: boolean;
-}
-
-export const VersionChecker = Object.freeze({
-  /**
-   * Resolve the nearest package.json from a starting directory.
-   */
-  findNearestPackageJson(startDir: string): string | null {
-    let current = startDir;
-    for (let i = 0; i < 8; i++) {
-      const candidate = join(current, 'package.json');
-      if (existsSync(candidate)) return candidate;
-
-      const parent = dirname(current);
-      if (parent === current) break;
-      current = parent;
-    }
-
-    return null;
-  },
-
-  /**
-   * Get current version from package.json
-   */
-  getCurrentVersion(): string {
-    try {
-      const moduleDir = dirname(fileURLToPath(import.meta.url));
-      const modulePackagePath = this.findNearestPackageJson(moduleDir);
-      const cwdPackagePath = this.findNearestPackageJson(process.cwd());
-      const packagePath = modulePackagePath ?? cwdPackagePath;
-
-      if (packagePath === null) return '0.0.0';
-
-      const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8')) as {
-        version?: string;
-      };
-      return typeof packageJson.version === 'string' ? packageJson.version : '0.0.0';
-    } catch {
-      return '0.0.0';
-    }
-  },
-
-  /**
-   * Get version check configuration
-   */
-  getConfig(): VersionCheckConfig {
-    return {
-      enabled: process.env['ZINTRUST_VERSION_CHECK'] !== 'false',
-      checkInterval: Number.parseInt(process.env['ZINTRUST_VERSION_CHECK_INTERVAL'] ?? '24', 10),
-      skipVersionCheck: process.env['ZINTRUST_SKIP_VERSION_CHECK'] === 'true',
-    };
-  },
-
-  /**
-   * Check if version check should be performed
-   */
-  shouldCheckVersion(): boolean {
-    const config = this.getConfig();
-
-    // Skip if disabled
-    if (!config.enabled || config.skipVersionCheck) {
-      return false;
-    }
-
-    // Skip for version commands
-    const args = new Set(process.argv.slice(2));
-    if (args.has('-v') || args.has('--version') || args.has('help') || args.has('new')) {
-      return false;
-    }
-
-    // Check last check time
-    const lastCheckKey = 'zintrust_last_version_check';
-    const lastCheck = globalThis.localStorage?.getItem?.(lastCheckKey);
-
-    if (lastCheck !== null && lastCheck !== undefined) {
-      const lastCheckTime = Number.parseInt(lastCheck, 10);
-      const now = Date.now();
-      const hoursSinceLastCheck = (now - lastCheckTime) / (1000 * 60 * 60);
-
-      if (hoursSinceLastCheck < config.checkInterval) {
-        return false;
-      }
-    }
-
-    return true;
-  },
-
-  /**
-   * Fetch latest version from npm registry
-   */
-  async fetchLatestVersion(): Promise<string> {
-    try {
-      const response = await this.fetchFromNpmRegistry();
-
-      if (!response.ok) {
-        return this.handleHttpError();
-      }
-
-      const data = await response.json();
-      return this.extractVersionFromResponse(data);
-    } catch {
-      // For network errors or other issues, don't block CLI usage
-      return this.getCurrentVersion();
-    }
-  },
-
-  /**
-   * Make request to npm registry
-   */
-  async fetchFromNpmRegistry(): Promise<IHttpResponse> {
-    return HttpClient.get('https://registry.npmjs.org/@zintrust/core/latest')
-      .withHeader('Accept', 'application/json')
-      .withHeader('User-Agent', 'ZinTrust-CLI-Version-Check')
-      .withTimeout(5000) // 5 second timeout
-      .send();
-  },
-
-  /**
-   * Handle HTTP errors from npm registry
-   */
-  handleHttpError(): string {
-    return this.getCurrentVersion();
-  },
-
-  /**
-   * Extract version from npm registry response
-   */
-  extractVersionFromResponse(data: unknown): string {
-    if (!this.isValidResponseData(data)) {
-      return this.getCurrentVersion();
-    }
-
-    const dataRecord = data;
-
-    // Try to get version from dist-tags.latest (standard npm response)
-    const latestVersion = this.getVersionFromDistTags(dataRecord);
-    if (latestVersion !== null && latestVersion !== undefined && latestVersion !== '') {
-      return latestVersion;
-    }
-
-    // Fallback to version field
-    const fallbackVersion = this.getVersionFromField(dataRecord);
-    if (fallbackVersion !== null && fallbackVersion !== undefined && fallbackVersion !== '') {
-      return fallbackVersion;
-    }
-
-    // Final fallback
-    return this.getCurrentVersion();
-  },
-
-  /**
-   * Check if response data is valid object
-   */
-  isValidResponseData(data: unknown): data is Record<string, unknown> {
-    return data !== null && data !== undefined && typeof data === 'object';
-  },
-
-  /**
-   * Extract version from dist-tags
-   */
-  getVersionFromDistTags(dataRecord: Record<string, unknown>): string | null {
-    const distTags = dataRecord['dist-tags'];
-    if (distTags !== null && distTags !== undefined) {
-      const distTagsRecord = distTags as Record<string, unknown>;
-      const latest = distTagsRecord['latest'];
-      if (typeof latest === 'string' && latest !== '') {
-        return latest;
-      }
-    }
-    return null;
-  },
-
-  /**
-   * Extract version from version field
-   */
-  getVersionFromField(dataRecord: Record<string, unknown>): string | null {
-    const version = dataRecord['version'];
-    if (typeof version === 'string' && version !== '') {
-      return version;
-    }
-    return null;
-  },
-
-  /**
-   * Compare versions using semver-like comparison
-   */
-  compareVersions(current: string, latest: string): number {
-    const cleanVersion = (version: string): string => {
-      // Remove leading 'v' and trailing pre-release identifiers safely
-      // Using specific patterns instead of greedy quantifiers to prevent ReDoS
-      return version.replace(/^v/, '').replace(/-[^-]*$/, '');
-    };
-
-    const currentParts = cleanVersion(current).split('.').map(Number);
-    const latestParts = cleanVersion(latest).split('.').map(Number);
-
-    const maxLength = Math.max(currentParts.length, latestParts.length);
-
-    for (let i = 0; i < maxLength; i++) {
-      const currentPart = currentParts[i] || 0;
-      const latestPart = latestParts[i] || 0;
-
-      if (currentPart < latestPart) return -1;
-      if (currentPart > latestPart) return 1;
-    }
-
-    return 0;
-  },
-
-  /**
-   * Perform version check and return result
-   */
-  async checkVersion(): Promise<VersionCheckResult | null> {
-    if (!this.shouldCheckVersion()) {
-      return null;
-    }
-
-    try {
-      const currentVersion = this.getCurrentVersion();
-      const latestVersion = await this.fetchLatestVersion();
-
-      const comparison = this.compareVersions(currentVersion, latestVersion);
-      const isOutdated = comparison < 0;
-      const updateAvailable = isOutdated;
-
-      // Update last check time
-      const lastCheckKey = 'zintrust_last_version_check';
-      globalThis.localStorage?.setItem?.(lastCheckKey, Date.now().toString());
-
-      return {
-        currentVersion,
-        latestVersion,
-        isOutdated,
-        updateAvailable,
-      };
-    } catch {
-      // Silently fail - version check should never block CLI usage
-      return null;
-    }
-  },
-
-  /**
-   * Display update notification to user
-   */
-  displayUpdateNotification(result: VersionCheckResult): void {
-    if (!result.updateAvailable) {
-      return;
-    }
-
-    const { currentVersion, latestVersion } = result;
-
-    // Use process.stdout.write for better control and to avoid eslint console errors
-    const output = [
-      '',
-      '⚠️  Update Available',
-      '┌' + '─'.repeat(50) + '┐',
-      `│ Current:  ${currentVersion.padEnd(40)}│`,
-      `│ Latest:   ${latestVersion.padEnd(40)}│`,
-      '└' + '─'.repeat(50) + '┘',
-      '',
-      '💡 Update to get the latest features and bug fixes:',
-      `   npm install -g @zintrust/core@${latestVersion}`,
-      '   or: npx @zintrust/core@latest [command]',
-      '',
-      '🔧 To disable version checks:',
-      '   export ZINTRUST_VERSION_CHECK=false',
-      '',
-    ].join('\n');
-
-    process.stdout.write(output);
-  },
-
-  /**
-   * Run version check and display notification if needed
-   */
-  async runVersionCheck(): Promise<void> {
-    try {
-      const result = await this.checkVersion();
-      if (result) {
-        this.displayUpdateNotification(result);
-      }
-    } catch {
-      // Version check should never crash the CLI
-    }
-  },
-});

package/src/cli/utils/DatabaseCliUtils.ts

@@ -1,75 +0,0 @@
-import type { CommandOptions, IBaseCommand } from '@cli/BaseCommand';
-import { PromptHelper } from '@cli/PromptHelper';
-import { Env } from '@config/env';
-import type { DatabaseConfig as OrmDatabaseConfig } from '@orm/DatabaseAdapter';
-
-export type ConnectionConfig = {
-  driver: string;
-  host?: string;
-  port?: number;
-  database?: string;
-  username?: string;
-  password?: string;
-};
-
-export const mapConnectionToOrmConfig = (conn: ConnectionConfig): OrmDatabaseConfig => {
-  switch (conn.driver) {
-    case 'sqlite':
-      return { driver: 'sqlite', database: conn.database ?? ':memory:' };
-    case 'postgresql':
-      return {
-        driver: 'postgresql',
-        host: conn.host,
-        port: conn.port,
-        database: conn.database,
-        username: conn.username,
-        password: conn.password,
-      };
-    case 'mysql':
-      return {
-        driver: 'mysql',
-        host: conn.host,
-        port: conn.port,
-        database: conn.database,
-        username: conn.username,
-        password: conn.password,
-      };
-    case 'sqlserver':
-      return {
-        driver: 'sqlserver',
-        host: conn.host,
-        port: conn.port,
-        database: conn.database,
-        username: conn.username,
-        password: conn.password,
-      };
-    default:
-      return { driver: 'sqlite', database: ':memory:' };
-  }
-};
-
-export const parseRollbackSteps = (options: CommandOptions): number => {
-  const stepRaw = typeof options['step'] === 'string' ? options['step'] : '1';
-  return Math.max(1, Number.parseInt(stepRaw, 10) || 1);
-};
-
-export const confirmProductionRun = async (params: {
-  cmd: IBaseCommand;
-  interactive: boolean;
-  message: string;
-  destructive?: boolean;
-  force?: boolean;
-}): Promise<boolean> => {
-  if (Env.NODE_ENV !== 'production') return true;
-  if (params.force === true) return true;
-
-  const prompt = params.destructive === true ? `${params.message} (destructive)` : params.message;
-  const confirmed = await PromptHelper.confirm(prompt, false, params.interactive);
-
-  if (!confirmed) {
-    params.cmd.warn('Cancelled.');
-    return false;
-  }
-
-  return true;
-};

package/src/cli/utils/DistPackager.ts

@@ -1,154 +0,0 @@
-import { Logger } from '@config/logger';
-import { ErrorFactory } from '@exceptions/ZintrustError';
-import fs from '@node-singletons/fs';
-import * as path from '@node-singletons/path';
-
-type RootPackageJson = {
-  name?: unknown;
-  version?: unknown;
-  dependencies?: unknown;
-};
-
-type DistPackageJson = {
-  name: string;
-  version: string;
-  private: boolean;
-  type: 'module';
-  main: './index.js';
-  types: './index.d.ts';
-  bin: Record<string, string>;
-  exports: {
-    '.': {
-      types: './index.d.ts';
-      default: './index.js';
-    };
-    './start': {
-      types: './start.d.ts';
-      default: './start.js';
-    };
-  };
-  dependencies: Record<string, unknown>;
-};
-
-const readRootPackageJson = (rootPath: string): RootPackageJson => {
-  const rootPackageJsonPath = path.join(rootPath, 'package.json');
-  if (!fs.existsSync(rootPackageJsonPath)) {
-    throw ErrorFactory.createConfigError(`Missing package.json at: ${rootPackageJsonPath}`);
-  }
-
-  try {
-    const raw = fs.readFileSync(rootPackageJsonPath, 'utf8');
-    return JSON.parse(raw) as RootPackageJson;
-  } catch (error) {
-    throw ErrorFactory.createTryCatchError('Failed to read root package.json', error);
-  }
-};
-
-const coerceDependencies = (value: unknown): Record<string, unknown> => {
-  if (typeof value !== 'object' || value === null) return {};
-  return value as Record<string, unknown>;
-};
-
-const buildDistPackageJson = (rootPkg: RootPackageJson): DistPackageJson => {
-  const name =
-    typeof rootPkg.name === 'string' && rootPkg.name.trim() !== ''
-      ? rootPkg.name
-      : '@zintrust/core';
-  const version =
-    typeof rootPkg.version === 'string' && rootPkg.version.trim() !== ''
-      ? rootPkg.version
-      : '0.0.0';
-
-  return {
-    name,
-    version,
-    private: true,
-    type: 'module',
-    main: './index.js',
-    types: './index.d.ts',
-    bin: {
-      zintrust: './bin/zintrust.js',
-      zin: './bin/zin.js',
-      z: './bin/z.js',
-      zt: './bin/zt.js',
-    },
-    exports: {
-      '.': {
-        types: './index.d.ts',
-        default: './index.js',
-      },
-      './start': {
-        types: './start.d.ts',
-        default: './start.js',
-      },
-    },
-    dependencies: coerceDependencies(rootPkg.dependencies),
-  };
-};
-
-const writeDistEntrypoints = (distPath: string): void => {
-  const distIndexJsPath = path.join(distPath, 'index.js');
-  const distIndexDtsPath = path.join(distPath, 'index.d.ts');
-
-  const distStartJsPath = path.join(distPath, 'start.js');
-  const distStartDtsPath = path.join(distPath, 'start.d.ts');
-
-  fs.writeFileSync(distIndexJsPath, "export * from './src/index.js';\n");
-  fs.writeFileSync(distIndexDtsPath, "export * from './src/index';\n");
-
-  fs.writeFileSync(
-    distStartJsPath,
-    "export * from './src/start.js'; export { default } from './src/start.js';\n"
-  );
-  fs.writeFileSync(
-    distStartDtsPath,
-    "export * from './src/start'; export { default } from './src/start';\n"
-  );
-};
-
-const writeDistPackageJson = (distPath: string, pkg: DistPackageJson): void => {
-  const distPackageJsonPath = path.join(distPath, 'package.json');
-  fs.writeFileSync(distPackageJsonPath, JSON.stringify(pkg, null, 2) + '\n');
-};
-
-const warnIfMissingDistArtifacts = (distPath: string): void => {
-  const expected = [
-    path.join(distPath, 'src', 'index.js'),
-    path.join(distPath, 'bin', 'zintrust.js'),
-    path.join(distPath, 'bin', 'zin.js'),
-  ];
-
-  for (const candidate of expected) {
-    if (!fs.existsSync(candidate)) {
-      Logger.warn(`Dist artifact missing (did you run build?): ${candidate}`);
-    }
-  }
-
-  const docsRoot = path.join(distPath, 'public');
-  if (!fs.existsSync(docsRoot)) {
-    Logger.warn(`Docs public root missing at ${docsRoot} (expected dist/public)`);
-  }
-};
-
-export const DistPackager = Object.freeze({
-  /**
-   * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`.
-   * This is intended for local dev/simulate apps, not publishing.
-   */
-  prepare(distPath: string, rootPath: string = process.cwd()): void {
-    if (!fs.existsSync(distPath)) {
-      throw ErrorFactory.createConfigError(
-        `Missing dist output at: ${distPath}. Run 'npm run build' first.`
-      );
-    }
-
-    const rootPkg = readRootPackageJson(rootPath);
-    const distPkg = buildDistPackageJson(rootPkg);
-
-    writeDistPackageJson(distPath, distPkg);
-    writeDistEntrypoints(distPath);
-    warnIfMissingDistArtifacts(distPath);
-
-    Logger.info(`✅ Prepared dist package metadata at: ${path.join(distPath, 'package.json')}`);
-  },
-});