@zintrust/core 3.4.0 → 3.5.1

package/src/cli/services/VersionChecker.d.ts

@@ -1,95 +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 { type IHttpResponse } from '../../tools/http/Http.js';
-interface VersionCheckResult {
-    currentVersion: string;
-    latestVersion: string;
-    isOutdated: boolean;
-    updateAvailable: boolean;
-}
-interface VersionCheckConfig {
-    enabled: boolean;
-    checkInterval: number;
-    skipVersionCheck: boolean;
-}
-export declare const VersionChecker: Readonly<{
-    isDetachedChildProcess(): boolean;
-    shouldSkipVersionCheckForArgs(args: Set<string>): boolean;
-    hasFreshVersionCheck(checkInterval: number): boolean;
-    /**
-     * Resolve the nearest package.json from a starting directory.
-     */
-    findNearestPackageJson(startDir: string): string | null;
-    /**
-     * Get current version from package.json
-     */
-    getCurrentVersion(): string;
-    /**
-     * Get version check configuration
-     */
-    getConfig(): VersionCheckConfig;
-    /**
-     * Check if version check should be performed
-     */
-    shouldCheckVersion(): boolean;
-    /**
-     * Fetch cached version if available and fresh
-     */
-    getCachedVersion(checkInterval: number): string | null;
-    /**
-     * Cache the latest version and timestamp
-     */
-    cacheLatestVersion(version: string): void;
-    /**
-     * Fetch latest version from npm registry
-     */
-    fetchLatestVersion(): Promise<string>;
-    /**
-     * Make request to npm registry
-     */
-    fetchFromNpmRegistry(): Promise<IHttpResponse>;
-    /**
-     * Handle HTTP errors from npm registry
-     */
-    handleHttpError(): string;
-    /**
-     * Extract version from npm registry response
-     */
-    extractVersionFromResponse(data: unknown): string;
-    /**
-     * Check if response data is valid object
-     */
-    isValidResponseData(data: unknown): data is Record<string, unknown>;
-    /**
-     * Extract version from dist-tags
-     */
-    getVersionFromDistTags(dataRecord: Record<string, unknown>): string | null;
-    /**
-     * Extract version from version field
-     */
-    getVersionFromField(dataRecord: Record<string, unknown>): string | null;
-    /**
-     * Compare versions using semver-like comparison
-     */
-    compareVersions(current: string, latest: string): number;
-    /**
-     * Perform version check and return result
-     */
-    checkVersion(): Promise<VersionCheckResult | null>;
-    /**
-     * Display update notification to user
-     */
-    displayUpdateNotification(result: VersionCheckResult): void;
-    spawnDetachedVersionCheck(): void;
-    runVersionCheckInline(): Promise<void>;
-    /**
-     * Run version check and display notification if needed
-     */
-    runVersionCheck(): Promise<void>;
-}>;
-export {};
-//# sourceMappingURL=VersionChecker.d.ts.map

package/src/cli/services/VersionChecker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VersionChecker.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/VersionChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMlE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAID,eAAO,MAAM,cAAc;8BACC,OAAO;wCAIG,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO;wCAYrB,MAAM,GAAG,OAAO;IAapD;;OAEG;qCAC8B,MAAM,GAAG,MAAM,GAAG,IAAI;IAcvD;;OAEG;yBACkB,MAAM;IAkB3B;;OAEG;iBACU,kBAAkB;IAQ/B;;OAEG;0BACmB,OAAO;IA0B7B;;OAEG;oCAC6B,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBtD;;OAEG;gCACyB,MAAM,GAAG,IAAI;IAezC;;OAEG;0BACyB,OAAO,CAAC,MAAM,CAAC;IA6B3C;;OAEG;4BAC2B,OAAO,CAAC,aAAa,CAAC;IAQpD;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qCAC8B,OAAO,GAAG,MAAM;IAuBjD;;OAEG;8BACuB,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInE;;OAEG;uCACgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAY1E;;OAEG;oCAC6B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAQvE;;OAEG;6BACsB,MAAM,UAAU,MAAM,GAAG,MAAM;IAuBxD;;OAEG;oBACmB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyBxD;;OAEG;sCAC+B,kBAAkB,GAAG,IAAI;iCA4B9B,IAAI;6BAkCF,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;uBACsB,OAAO,CAAC,IAAI,CAAC;EAQtC,CAAC"}

package/src/cli/services/VersionChecker.js

@@ -1,360 +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 { Logger } from '../../config/logger.js';
-import { HttpClient } from '../../tools/http/Http.js';
-import { spawn } from '../../node-singletons/child-process.js';
-import { existsSync, readFileSync } from '../../node-singletons/fs.js';
-import { dirname, join } from '../../node-singletons/path.js';
-import { fileURLToPath } from '../../node-singletons/url.js';
-const VERSION_CHECK_CHILD_ENV = 'ZINTRUST_VERSION_CHECK_CHILD';
-export const VersionChecker = Object.freeze({
-    isDetachedChildProcess() {
-        return process.env[VERSION_CHECK_CHILD_ENV] === 'true';
-    },
-    shouldSkipVersionCheckForArgs(args) {
-        return (args.has('-v') ||
-            args.has('--version') ||
-            args.has('help') ||
-            args.has('new') ||
-            args.has('migrate') ||
-            args.has('schedule:run') ||
-            args.has('schedule:list'));
-    },
-    hasFreshVersionCheck(checkInterval) {
-        const lastCheck = globalThis.localStorage?.getItem?.('zintrust_last_version_check');
-        if (lastCheck === null || lastCheck === undefined) {
-            return false;
-        }
-        const lastCheckTime = Number.parseInt(lastCheck, 10);
-        const hoursSinceLastCheck = (Date.now() - lastCheckTime) / (1000 * 60 * 60);
-        return hoursSinceLastCheck < checkInterval;
-    },
-    /**
-     * Resolve the nearest package.json from a starting directory.
-     */
-    findNearestPackageJson(startDir) {
-        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() {
-        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'));
-            return typeof packageJson.version === 'string' ? packageJson.version : '0.0.0';
-        }
-        catch {
-            return '0.0.0';
-        }
-    },
-    /**
-     * Get version check configuration
-     */
-    getConfig() {
-        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() {
-        if (this.isDetachedChildProcess()) {
-            return true;
-        }
-        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 (this.shouldSkipVersionCheckForArgs(args)) {
-            return false;
-        }
-        // Check last check time
-        if (this.hasFreshVersionCheck(config.checkInterval)) {
-            return false;
-        }
-        return true;
-    },
-    /**
-     * Fetch cached version if available and fresh
-     */
-    getCachedVersion(checkInterval) {
-        const LAST_CHECK_KEY = 'zintrust_last_version_check';
-        const CACHED_VERSION_KEY = 'zintrust_cached_latest_version';
-        try {
-            const ls = globalThis.localStorage;
-            if (!ls?.getItem)
-                return null;
-            const last = ls.getItem(LAST_CHECK_KEY);
-            const cached = ls.getItem(CACHED_VERSION_KEY);
-            if (last === null || cached === null)
-                return null;
-            const lastTime = Number.parseInt(last, 10);
-            if (Number.isNaN(lastTime))
-                return null;
-            const hoursSince = (Date.now() - lastTime) / (1000 * 60 * 60);
-            return hoursSince < checkInterval ? cached : null;
-        }
-        catch {
-            // Ignore localStorage failures
-            return null;
-        }
-    },
-    /**
-     * Cache the latest version and timestamp
-     */
-    cacheLatestVersion(version) {
-        const LAST_CHECK_KEY = 'zintrust_last_version_check';
-        const CACHED_VERSION_KEY = 'zintrust_cached_latest_version';
-        try {
-            const ls = globalThis.localStorage;
-            if (ls?.setItem) {
-                ls.setItem(CACHED_VERSION_KEY, version);
-                ls.setItem(LAST_CHECK_KEY, Date.now().toString());
-            }
-        }
-        catch {
-            // Best-effort caching
-        }
-    },
-    /**
-     * Fetch latest version from npm registry
-     */
-    async fetchLatestVersion() {
-        try {
-            const cfg = this.getConfig();
-            // Try to get cached version first
-            const cachedVersion = this.getCachedVersion(cfg.checkInterval);
-            if (cachedVersion !== null) {
-                return cachedVersion;
-            }
-            // Fetch from network
-            const response = await this.fetchFromNpmRegistry();
-            if (!response.ok) {
-                return this.handleHttpError();
-            }
-            const data = await response.json();
-            const latest = this.extractVersionFromResponse(data);
-            // Cache for future use
-            this.cacheLatestVersion(latest);
-            return latest;
-        }
-        catch {
-            // For network errors or other issues, don't block CLI usage
-            return this.getCurrentVersion();
-        }
-    },
-    /**
-     * Make request to npm registry
-     */
-    async fetchFromNpmRegistry() {
-        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() {
-        return this.getCurrentVersion();
-    },
-    /**
-     * Extract version from npm registry response
-     */
-    extractVersionFromResponse(data) {
-        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) {
-        return data !== null && data !== undefined && typeof data === 'object';
-    },
-    /**
-     * Extract version from dist-tags
-     */
-    getVersionFromDistTags(dataRecord) {
-        const distTags = dataRecord['dist-tags'];
-        if (distTags !== null && distTags !== undefined) {
-            const distTagsRecord = distTags;
-            const latest = distTagsRecord['latest'];
-            if (typeof latest === 'string' && latest !== '') {
-                return latest;
-            }
-        }
-        return null;
-    },
-    /**
-     * Extract version from version field
-     */
-    getVersionFromField(dataRecord) {
-        const version = dataRecord['version'];
-        if (typeof version === 'string' && version !== '') {
-            return version;
-        }
-        return null;
-    },
-    /**
-     * Compare versions using semver-like comparison
-     */
-    compareVersions(current, latest) {
-        const cleanVersion = (version) => {
-            // 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() {
-        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;
-            return {
-                currentVersion,
-                latestVersion,
-                isOutdated,
-                updateAvailable,
-            };
-        }
-        catch {
-            // Silently fail - version check should never block CLI usage
-            return null;
-        }
-    },
-    /**
-     * Display update notification to user
-     */
-    displayUpdateNotification(result) {
-        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);
-    },
-    spawnDetachedVersionCheck() {
-        if (!this.shouldCheckVersion()) {
-            return;
-        }
-        const entrypoint = process.argv[1];
-        if (typeof entrypoint !== 'string' || entrypoint.trim() === '') {
-            return;
-        }
-        try {
-            const child = spawn(process.execPath, [...process.execArgv, entrypoint, ...process.argv.slice(2)], {
-                detached: true,
-                env: {
-                    ...process.env,
-                    [VERSION_CHECK_CHILD_ENV]: 'true',
-                },
-                stdio: 'ignore',
-            });
-            child.once('error', (error) => {
-                Logger.debug('Detached version check failed to start', error);
-            });
-            child.unref();
-        }
-        catch (error) {
-            Logger.debug('Detached version check spawn failed', error);
-        }
-    },
-    async runVersionCheckInline() {
-        try {
-            const result = await this.checkVersion();
-            if (result) {
-                this.displayUpdateNotification(result);
-            }
-        }
-        catch {
-            // Version check should never crash the CLI
-        }
-    },
-    /**
-     * Run version check and display notification if needed
-     */
-    async runVersionCheck() {
-        if (this.isDetachedChildProcess()) {
-            await this.runVersionCheckInline();
-            return;
-        }
-        this.spawnDetachedVersionCheck();
-    },
-});

package/src/cli/services/WorkerStartupDiagnostics.d.ts

@@ -1,41 +0,0 @@
-type IssueSeverity = 'error' | 'warn' | 'info';
-export type WorkerStartupIssue = Readonly<{
-    severity: IssueSeverity;
-    message: string;
-    envKeys: ReadonlyArray<string>;
-}>;
-export type WorkerStartupEnvStatus = Readonly<{
-    key: string;
-    present: boolean;
-    resolvedValue: string;
-    explicitValue: string;
-}>;
-export type WorkerStartupDiagnosticsReport = Readonly<{
-    flags: Readonly<{
-        runtimeMode: string;
-        workerEnabled: boolean;
-        workerAutoStart: boolean;
-        dockerWorker: boolean;
-        queueEnabled: boolean;
-        queueDriver: string;
-        persistenceDriver: string;
-    }>;
-    issues: ReadonlyArray<WorkerStartupIssue>;
-    missingEnvKeys: ReadonlyArray<string>;
-    envStatus: ReadonlyArray<WorkerStartupEnvStatus>;
-    firstFault: Readonly<{
-        message: string;
-        code?: string;
-    }> | null;
-    logPointers: ReadonlyArray<string>;
-    nextSteps: ReadonlyArray<string>;
-}>;
-export declare const WorkerStartupDiagnostics: Readonly<{
-    collect: (error?: unknown) => WorkerStartupDiagnosticsReport;
-    renderLines: (report: WorkerStartupDiagnosticsReport) => string[];
-    log: (error?: unknown, context?: string) => WorkerStartupDiagnosticsReport;
-    hasBlockingIssues: (report: WorkerStartupDiagnosticsReport) => boolean;
-    createCliError(message: string): Error;
-}>;
-export {};
-//# sourceMappingURL=WorkerStartupDiagnostics.d.ts.map

package/src/cli/services/WorkerStartupDiagnostics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkerStartupDiagnostics.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/WorkerStartupDiagnostics.ts"],"names":[],"mappings":"AAMA,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACpD,KAAK,EAAE,QAAQ,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;QACzB,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;IACH,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC1C,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IACjD,UAAU,EAAE,QAAQ,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,GAAG,IAAI,CAAC;IACV,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC,CAAC;AA8bH,eAAO,MAAM,wBAAwB;sBAxFZ,OAAO,KAAG,8BAA8B;0BAwCpC,8BAA8B,KAAG,MAAM,EAAE;kBA0BjD,OAAO,uBAA+B,8BAA8B;gCAmBtD,8BAA8B,KAAG,OAAO;4BAQjD,MAAM,GAAG,KAAK;EAGtC,CAAC"}