@zintrust/core 0.4.15 → 0.4.17

package/src/cli/utils/EnvFileLoader.js

@@ -1,277 +0,0 @@
-import { Env } from '../../config/env.js';
-import { isArray, isNonEmptyString } from '../../helper/index.js';
-import { existsSync, readFileSync } from '../../node-singletons/fs.js';
-import * as path from '../../node-singletons/path.js';
-const safeEnvGet = (key, defaultValue = '') => {
-    const envAny = Env;
-    if (typeof envAny.get === 'function')
-        return envAny.get(key, defaultValue);
-    const fromProcess = typeof process === 'undefined' ? undefined : process.env?.[key];
-    if (typeof fromProcess === 'string' && fromProcess !== '')
-        return fromProcess;
-    return defaultValue;
-};
-const safeEnvSet = (key, value) => {
-    const envAny = Env;
-    if (typeof envAny.set === 'function') {
-        envAny.set(key, value);
-        return;
-    }
-    if (typeof process === 'undefined' || process.env === undefined)
-        return;
-    process.env[key] = value;
-};
-const normalizeAppMode = (value) => {
-    const normalized = value.trim().toLowerCase();
-    if (normalized === 'production' || normalized === 'pro' || normalized === 'prod')
-        return 'production';
-    if (normalized === 'dev' || normalized === 'development')
-        return 'development';
-    // Per spec: any other value is treated as development.
-    return 'development';
-};
-const stripInlineComment = (value) => {
-    let inSingle = false;
-    let inDouble = false;
-    for (let i = 0; i < value.length; i += 1) {
-        const ch = value[i];
-        if (ch === "'" && !inDouble)
-            inSingle = !inSingle;
-        if (ch === '"' && !inSingle)
-            inDouble = !inDouble;
-        if (!inSingle && !inDouble && ch === '#') {
-            const prev = value[i - 1];
-            if (prev === undefined || prev === ' ' || prev === '\t') {
-                return value.slice(0, i).trimEnd();
-            }
-        }
-    }
-    return value;
-};
-const unquote = (value) => {
-    const trimmed = value.trim();
-    if (trimmed.length >= 2) {
-        const first = trimmed[0];
-        const last = trimmed.at(-1);
-        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
-            return trimmed.slice(1, -1);
-        }
-    }
-    return trimmed;
-};
-const parseEnvFile = (raw) => {
-    const result = {};
-    const lines = raw.split(/\r?\n/);
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed === '' || trimmed.startsWith('#'))
-            continue;
-        const withoutExport = trimmed.startsWith('export ') ? trimmed.slice('export '.length) : trimmed;
-        const eq = withoutExport.indexOf('=');
-        if (eq <= 0)
-            continue;
-        const key = withoutExport.slice(0, eq).trim();
-        if (key === '')
-            continue;
-        const rhs = withoutExport.slice(eq + 1);
-        const withoutComment = stripInlineComment(rhs);
-        const value = unquote(withoutComment);
-        // DX: treat empty assignments as "no-op" if the key already had a non-empty value earlier
-        // in the same file. This prevents accidental overrides like:
-        //   KV_NAMESPACE_ID=abc
-        //   ...
-        //   KV_NAMESPACE_ID=
-        if (value.trim() === '' && (result[key]?.trim() ?? '') !== '')
-            continue;
-        result[key] = value;
-    }
-    return result;
-};
-const applyToProcessEnv = (values, overrideExisting) => {
-    for (const [key, value] of Object.entries(values)) {
-        if (!overrideExisting && safeEnvGet(key, '') !== '')
-            continue;
-        // DX: don't wipe an already-populated env var with an empty value from an env file.
-        // This avoids surprising behavior when env templates include duplicate keys with blanks.
-        if (value.trim() === '' && safeEnvGet(key, '').trim() !== '')
-            continue;
-        safeEnvSet(key, value);
-    }
-    // Compatibility helpers
-    if (safeEnvGet('PORT', '') === '' && safeEnvGet('APP_PORT', '') !== '') {
-        safeEnvSet('PORT', safeEnvGet('APP_PORT', ''));
-    }
-};
-const readEnvFileIfExists = (cwd, filename) => {
-    const fullPath = path.join(cwd, filename);
-    if (!existsSync(fullPath))
-        return undefined;
-    const raw = readFileSync(fullPath, 'utf-8');
-    return parseEnvFile(raw);
-};
-const resolveAppMode = (cwd) => {
-    const existing = safeEnvGet('NODE_ENV', '');
-    if (existing.trim() !== '')
-        return normalizeAppMode(existing);
-    const fromDotEnv = readEnvFileIfExists(cwd, '.env');
-    const value = fromDotEnv?.['NODE_ENV'];
-    if (typeof value === 'string' && value.trim() !== '')
-        return normalizeAppMode(value);
-    return undefined;
-};
-const filesLoader = (cwd, mode) => {
-    const files = [];
-    if (existsSync(path.join(cwd, '.env')))
-        files.push('.env');
-    // Per your rule: production uses .env; dev uses .env.dev
-    if (mode !== undefined && mode !== '' && mode !== 'production') {
-        const modeFile = `.env.${mode}`;
-        if (existsSync(path.join(cwd, modeFile)))
-            files.push(modeFile);
-    }
-    const local = '.env.local';
-    if (existsSync(path.join(cwd, local)))
-        files.push(local);
-    if (mode !== undefined && mode !== '') {
-        const modeLocal = `.env.${mode}.local`;
-        if (existsSync(path.join(cwd, modeLocal)))
-            files.push(modeLocal);
-    }
-    return files;
-};
-let cached;
-const loadFromCwd = (cwd, overrideExisting) => {
-    const mode = resolveAppMode(cwd);
-    const files = filesLoader(cwd, mode);
-    let baseApplied = false;
-    for (const file of files) {
-        const parsed = readEnvFileIfExists(cwd, file);
-        if (!parsed)
-            continue;
-        if (file === '.env') {
-            applyToProcessEnv(parsed, overrideExisting);
-            baseApplied = true;
-            continue;
-        }
-        // .env is primary: overlays only fill missing values and never override base.
-        applyToProcessEnv(parsed, baseApplied ? false : overrideExisting);
-    }
-    // Set NODE_ENV to the normalized mode if we have one (after applying files)
-    if (mode !== undefined) {
-        safeEnvSet('NODE_ENV', mode);
-    }
-    return { loadedFiles: files, mode };
-};
-const loadFromFile = (filePath, overrideExisting) => {
-    if (!existsSync(filePath))
-        return { loadedFiles: [] };
-    const raw = readFileSync(filePath, 'utf-8');
-    const parsed = parseEnvFile(raw);
-    applyToProcessEnv(parsed, overrideExisting);
-    const rawMode = parsed['NODE_ENV'];
-    const mode = isNonEmptyString(rawMode) ? normalizeAppMode(rawMode) : undefined;
-    if (mode !== undefined) {
-        safeEnvSet('NODE_ENV', mode);
-    }
-    return { loadedFiles: [filePath], mode };
-};
-const normalizeCwdList = (value) => {
-    if (!isArray(value))
-        return [];
-    return value
-        .filter(isNonEmptyString)
-        .map((item) => item.trim())
-        .filter((item) => item !== '');
-};
-const normalizeEnvPathList = (value) => normalizeCwdList(value);
-const createLoadPlan = (options) => {
-    const cwd = isNonEmptyString(options.cwd) ? options.cwd : process.cwd();
-    const includeCwd = options.includeCwd !== false;
-    const extraCwds = normalizeCwdList(options.extraCwds);
-    const envPaths = normalizeEnvPathList(options.envPaths);
-    const overrideExisting = options.overrideExisting ?? true;
-    const sources = [];
-    if (includeCwd) {
-        sources.push({
-            key: `cwd:${cwd}`,
-            path: cwd,
-            kind: 'cwd',
-            overrideExisting,
-        });
-    }
-    for (const extraCwd of extraCwds) {
-        sources.push({
-            key: `cwd:${extraCwd}`,
-            path: extraCwd,
-            kind: 'cwd',
-            overrideExisting: true,
-        });
-    }
-    for (const envPath of envPaths) {
-        const looksLikeFile = path.basename(envPath).startsWith('.env');
-        sources.push({
-            key: `${looksLikeFile ? 'file' : 'cwd'}:${envPath}`,
-            path: envPath,
-            kind: looksLikeFile ? 'file' : 'cwd',
-            overrideExisting: true,
-        });
-    }
-    return sources.filter((source, index, items) => items.findIndex((item) => item.key === source.key) === index);
-};
-const loadSource = (source) => {
-    if (source.kind === 'file')
-        return loadFromFile(source.path, source.overrideExisting);
-    return loadFromCwd(source.path, source.overrideExisting);
-};
-const mergeCachedState = (state, source, next) => {
-    state.loadedSourceKeys.push(source.key);
-    if (next.mode !== undefined && state.mode === undefined) {
-        state.mode = next.mode;
-    }
-    if (next.loadedFiles.length > 0) {
-        state.loadedFiles.push(...next.loadedFiles);
-    }
-    return state;
-};
-const load = (options = {}) => {
-    const plan = createLoadPlan(options);
-    cached ??= { loadedFiles: [], loadedSourceKeys: [] };
-    for (const source of plan) {
-        if (cached.loadedSourceKeys.includes(source.key))
-            continue;
-        mergeCachedState(cached, source, loadSource(source));
-    }
-    return cached;
-};
-const ensureLoaded = (options = {}) => load({ ...options, overrideExisting: false });
-const applyCliOverrides = (overrides) => {
-    // Ensure base env is loaded first.
-    ensureLoaded();
-    if (typeof overrides.runtime === 'string' && overrides.runtime.trim() !== '') {
-        safeEnvSet('RUNTIME', overrides.runtime.trim());
-    }
-    if (typeof overrides.nodeEnv === 'string') {
-        safeEnvSet('NODE_ENV', overrides.nodeEnv);
-    }
-    if (typeof overrides.port === 'number') {
-        safeEnvSet('PORT', String(overrides.port));
-        safeEnvSet('APP_PORT', String(overrides.port));
-    }
-    if (typeof overrides.cacheEnabled === 'boolean') {
-        safeEnvSet('CACHE_ENABLED', String(overrides.cacheEnabled));
-    }
-    // Keep PORT/APP_PORT in sync if only one exists.
-    if (safeEnvGet('PORT', '') === '' && safeEnvGet('APP_PORT', '') !== '') {
-        safeEnvSet('PORT', safeEnvGet('APP_PORT', ''));
-    }
-    if (safeEnvGet('APP_PORT', '') === '' && safeEnvGet('PORT', '') !== '') {
-        safeEnvSet('APP_PORT', safeEnvGet('PORT', ''));
-    }
-};
-const getState = () => ensureLoaded();
-export const EnvFileLoader = Object.freeze({
-    load,
-    ensureLoaded,
-    applyCliOverrides,
-    getState,
-});

package/src/cli/utils/spawn.d.ts

@@ -1,11 +0,0 @@
-export interface SpawnAndWaitInput {
-    command: string;
-    args: string[];
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    forwardSignals?: boolean;
-}
-export declare const SpawnUtil: Readonly<{
-    spawnAndWait(input: SpawnAndWaitInput): Promise<number>;
-}>;
-//# sourceMappingURL=spawn.d.ts.map

package/src/cli/utils/spawn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA0CD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EA+E7D,CAAC"}

package/src/cli/utils/spawn.js

@@ -1,109 +0,0 @@
-import { appConfig } from '../../config/app.js';
-import { ErrorFactory } from '../../exceptions/ZintrustError.js';
-import { spawn } from '../../node-singletons/child-process.js';
-import { existsSync } from '../../node-singletons/fs.js';
-import * as path from '../../node-singletons/path.js';
-const getExitCode = (exitCode, signal) => {
-    if (typeof exitCode === 'number')
-        return exitCode;
-    if (signal === 'SIGINT' || signal === 'SIGTERM')
-        return 0;
-    return 1;
-};
-const resolveLocalBin = (command, cwd) => {
-    // If command is already a path, leave it alone.
-    if (command.includes('/') || command.includes('\\'))
-        return command;
-    const binDir = path.join(cwd, 'node_modules', '.bin');
-    const candidates = process.platform === 'win32'
-        ? [
-            path.join(binDir, `${command}.cmd`),
-            path.join(binDir, `${command}.exe`),
-            path.join(binDir, `${command}.bat`),
-            path.join(binDir, command),
-        ]
-        : [path.join(binDir, command)];
-    for (const candidate of candidates) {
-        if (existsSync(candidate))
-            return candidate;
-    }
-    return command;
-};
-const buildCommandNotFoundMessage = (command) => {
-    if (command === 'tsx') {
-        return [
-            "Error: 'tsx' not found on PATH.",
-            'Install it in the project with "npm install -D tsx".',
-            'If you want a machine-wide fallback, install it globally with "npm install -g tsx".',
-        ].join(' ');
-    }
-    return `Error: '${command}' not found on PATH.`;
-};
-export const SpawnUtil = Object.freeze({
-    async spawnAndWait(input) {
-        const cwd = input.cwd ?? process.cwd();
-        const resolvedCommand = resolveLocalBin(input.command, cwd);
-        const child = spawn(resolvedCommand, input.args, {
-            cwd,
-            env: input.env ?? appConfig.getSafeEnv(),
-            stdio: 'inherit',
-        });
-        // In interactive shells, the foreground process group already receives SIGINT
-        // (and often SIGTERM) so forwarding can cause duplicates. `tsx watch` is
-        // especially sensitive here and can print "Previous process hasn't exited yet. Force killing...".
-        const forwardSignals = typeof input.forwardSignals === 'boolean' ? input.forwardSignals : !process.stdin.isTTY;
-        const forwardSignal = (signal) => {
-            try {
-                child.kill(signal);
-            }
-            catch (error) {
-                const wrapped = ErrorFactory.createTryCatchError('Failed to forward signal to child process', error);
-                // Best-effort logging; then rethrow (tests/assertions rely on this behavior).
-                try {
-                    process.stderr.write(`${String(wrapped.message)}\n`);
-                }
-                catch {
-                    // ignore
-                }
-                throw wrapped;
-            }
-        };
-        const onSigint = () => {
-            if (forwardSignals) {
-                forwardSignal('SIGINT');
-            }
-            // If not forwarding, handle to prevent the parent from exiting before the child
-            // finishes its graceful shutdown (child receives SIGINT directly in TTY).
-        };
-        const onSigterm = () => {
-            if (forwardSignals) {
-                forwardSignal('SIGTERM');
-            }
-            // Same rationale as SIGINT: keep parent alive while waiting for child to exit.
-        };
-        process.on('SIGINT', onSigint);
-        process.on('SIGTERM', onSigterm);
-        try {
-            const result = await new Promise((resolve, reject) => {
-                child.once('error', (error) => {
-                    reject(error);
-                });
-                child.once('close', (code, signal) => {
-                    resolve({ exitCode: code, signal });
-                });
-            });
-            return getExitCode(result.exitCode, result.signal);
-        }
-        catch (error) {
-            const code = error?.code;
-            if (code === 'ENOENT') {
-                throw ErrorFactory.createCliError(buildCommandNotFoundMessage(input.command));
-            }
-            throw ErrorFactory.createTryCatchError('Failed to spawn child process', error);
-        }
-        finally {
-            process.off('SIGINT', onSigint);
-            process.off('SIGTERM', onSigterm);
-        }
-    },
-});

package/src/cli/workers/QueueWorkRunner.d.ts

@@ -1,23 +0,0 @@
-export type QueueWorkKind = 'broadcast' | 'notification';
-export type QueueWorkRunnerOptions = {
-    queueName: string;
-    kind?: QueueWorkKind;
-    driverName?: string;
-    timeoutSeconds?: number;
-    maxItems?: number;
-    /** Max retries after the first attempt (so total attempts = retry + 1) */
-    retry?: number;
-};
-export type QueueWorkRunnerResult = {
-    processed: number;
-    retried: number;
-    dropped: number;
-    notDueRequeued: number;
-    unknown: number;
-};
-export declare const QueueWorkRunner: Readonly<{
-    run(options: QueueWorkRunnerOptions): Promise<QueueWorkRunnerResult>;
-    parseKind(value: unknown): QueueWorkKind;
-}>;
-export default QueueWorkRunner;
-//# sourceMappingURL=QueueWorkRunner.d.ts.map

package/src/cli/workers/QueueWorkRunner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"QueueWorkRunner.d.ts","sourceRoot":"","sources":["../../../../src/cli/workers/QueueWorkRunner.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,CAAC;AAoBzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA0QF,eAAO,MAAM,eAAe;iBACP,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;qBAuCzD,OAAO,GAAG,aAAa;EAUxC,CAAC;AAEH,eAAe,eAAe,CAAC"}