@zintrust/core 0.1.26 → 0.1.28

package/src/cache/drivers/KVDriver.js

@@ -1,55 +0,0 @@
-/**
- * Cloudflare KV Cache Driver
- * Interfaces with the native KV binding in Cloudflare Workers
- */
-import { Cloudflare } from '../../config/cloudflare.js';
-import { Logger } from '../../config/logger.js';
-/**
- * Create a new KV driver instance
- */
-const create = () => {
-    // In Cloudflare Workers, the KV namespace is usually bound to a variable in the environment
-    const kv = Cloudflare.getKVBinding('CACHE');
-    return {
-        async get(key) {
-            if (kv === null)
-                return null;
-            const value = await kv.get(key, { type: 'json' });
-            return value ?? null;
-        },
-        async set(key, value, ttl) {
-            if (kv === null) {
-                Logger.warn('KV binding "CACHE" not found. Cache set ignored.');
-                return;
-            }
-            const options = {};
-            if (ttl !== undefined) {
-                // KV expirationTtl must be at least 60 seconds
-                options.expirationTtl = Math.max(60, ttl);
-            }
-            await kv.put(key, JSON.stringify(value), options);
-        },
-        async delete(key) {
-            if (kv === null)
-                return;
-            await kv.delete(key);
-        },
-        async clear() {
-            // KV doesn't support clearing all keys easily without listing and deleting
-            Logger.warn('KV clear() is not implemented due to Cloudflare KV limitations.');
-            await Promise.resolve();
-        },
-        async has(key) {
-            if (kv === null)
-                return false;
-            const value = await kv.get(key);
-            return value !== null;
-        },
-    };
-};
-/**
- * KVDriver namespace - sealed for immutability
- */
-export const KVDriver = Object.freeze({
-    create,
-});

package/src/cache/drivers/KVRemoteDriver.d.ts

@@ -1,11 +0,0 @@
-/**
- * KV Remote Cache Driver
- *
- * Calls a ZinTrust Cloudflare Worker KV proxy over HTTPS.
- */
-import type { CacheDriver } from '../CacheDriver';
-export declare const KVRemoteDriver: Readonly<{
-    create(): CacheDriver;
-}>;
-export default KVRemoteDriver;
-//# sourceMappingURL=KVRemoteDriver.d.ts.map

package/src/cache/drivers/KVRemoteDriver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"KVRemoteDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVRemoteDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsBtD,eAAO,MAAM,cAAc;cACf,WAAW;EAiErB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cache/drivers/KVRemoteDriver.js

@@ -1,70 +0,0 @@
-/**
- * KV Remote Cache Driver
- *
- * Calls a ZinTrust Cloudflare Worker KV proxy over HTTPS.
- */
-import { RemoteSignedJson } from '../../common/RemoteSignedJson.js';
-import { Env } from '../../config/env.js';
-import { Logger } from '../../config/logger.js';
-const normalizeNamespace = (defaultNamespace) => defaultNamespace.trim() === '' ? undefined : defaultNamespace;
-export const KVRemoteDriver = Object.freeze({
-    create() {
-        const settings = {
-            baseUrl: Env.get('KV_REMOTE_URL'),
-            keyId: Env.get('KV_REMOTE_KEY_ID'),
-            secret: Env.get('KV_REMOTE_SECRET'),
-            defaultNamespace: Env.get('KV_REMOTE_NAMESPACE'),
-            timeoutMs: Env.getInt('ZT_PROXY_TIMEOUT_MS', Env.REQUEST_TIMEOUT),
-        };
-        const remote = {
-            baseUrl: settings.baseUrl,
-            keyId: settings.keyId,
-            secret: settings.secret,
-            timeoutMs: settings.timeoutMs,
-            missingUrlMessage: 'KV remote proxy URL is missing (KV_REMOTE_URL)',
-            missingCredentialsMessage: 'KV remote signing credentials are missing (KV_REMOTE_KEY_ID / KV_REMOTE_SECRET)',
-            messages: {
-                unauthorized: 'KV remote proxy unauthorized',
-                forbidden: 'KV remote proxy forbidden',
-                rateLimited: 'KV remote proxy rate limited',
-                rejected: 'KV remote proxy rejected request',
-                error: 'KV remote proxy error',
-                timedOut: 'KV remote proxy request timed out',
-            },
-        };
-        return {
-            async get(key) {
-                const out = await RemoteSignedJson.request(remote, '/zin/kv/get', {
-                    namespace: normalizeNamespace(settings.defaultNamespace),
-                    key,
-                    type: 'json',
-                });
-                return out.value ?? null;
-            },
-            async set(key, value, ttl) {
-                await RemoteSignedJson.request(remote, '/zin/kv/put', {
-                    namespace: normalizeNamespace(settings.defaultNamespace),
-                    key,
-                    value,
-                    ttlSeconds: ttl,
-                });
-            },
-            async delete(key) {
-                await RemoteSignedJson.request(remote, '/zin/kv/delete', {
-                    namespace: normalizeNamespace(settings.defaultNamespace),
-                    key,
-                });
-            },
-            async clear() {
-                // KV proxy does not implement clear() (and KV itself does not support full namespace wipe efficiently).
-                Logger.warn('KV remote clear() is not implemented.');
-                await Promise.resolve();
-            },
-            async has(key) {
-                const value = await this.get(key);
-                return value !== null;
-            },
-        };
-    },
-});
-export default KVRemoteDriver;

package/src/cache/drivers/MemoryDriver.d.ts

@@ -1,12 +0,0 @@
-/**
- * Memory Cache Driver
- * Simple in-memory storage for local development
- */
-import type { CacheDriver } from '../CacheDriver';
-/**
- * MemoryDriver namespace - sealed for immutability
- */
-export declare const MemoryDriver: Readonly<{
-    create: () => CacheDriver;
-}>;
-//# sourceMappingURL=MemoryDriver.d.ts.map

package/src/cache/drivers/MemoryDriver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0EtD;;GAEG;AACH,eAAO,MAAM,YAAY;kBAtEN,WAAW;EAwE5B,CAAC"}

package/src/cache/drivers/MemoryDriver.js

@@ -1,71 +0,0 @@
-/**
- * Memory Cache Driver
- * Simple in-memory storage for local development
- */
-/**
- * Memory Cache Driver
- * Simple in-memory storage for local development
- * Refactored to Functional Object pattern
- */
-const create = () => {
-    const storage = new Map();
-    // Background cleanup interval (runs every 60 seconds)
-    const cleanupInterval = setInterval(() => {
-        const now = Date.now();
-        for (const [key, item] of storage.entries()) {
-            if (item.expires !== null && item.expires < now) {
-                storage.delete(key);
-            }
-        }
-    }, 60_000); // 60 seconds
-    // Unref so it doesn't keep process alive
-    cleanupInterval.unref();
-    return {
-        async get(key) {
-            await Promise.resolve();
-            const item = storage.get(key);
-            if (item === undefined)
-                return null;
-            if (item.expires !== null && item.expires < Date.now()) {
-                storage.delete(key);
-                return null;
-            }
-            return item.value;
-        },
-        async set(key, value, ttl) {
-            const expires = ttl === undefined ? null : Date.now() + ttl * 1000;
-            storage.set(key, { value, expires });
-            await Promise.resolve();
-        },
-        async delete(key) {
-            storage.delete(key);
-            await Promise.resolve();
-        },
-        async clear() {
-            storage.clear();
-            await Promise.resolve();
-        },
-        async has(key) {
-            await Promise.resolve();
-            const item = storage.get(key);
-            if (item === undefined)
-                return false;
-            if (item.expires !== null && item.expires < Date.now()) {
-                storage.delete(key);
-                return false;
-            }
-            return true;
-        },
-        async dispose() {
-            clearInterval(cleanupInterval);
-            storage.clear();
-            await Promise.resolve();
-        },
-    };
-};
-/**
- * MemoryDriver namespace - sealed for immutability
- */
-export const MemoryDriver = Object.freeze({
-    create,
-});

package/src/cache/drivers/MongoDriver.d.ts

@@ -1,17 +0,0 @@
-/**
- * MongoDB Cache Driver
- * Uses MongoDB Atlas Data API (HTTPS) for zero-dependency integration
- */
-import type { CacheDriver } from '../CacheDriver';
-/**
- * MongoDB Cache Driver
- * Uses MongoDB Atlas Data API (HTTPS) for zero-dependency integration
- * Sealed namespace for immutability
- */
-export declare const MongoDriver: Readonly<{
-    /**
-     * Create a new MongoDB driver instance
-     */
-    create(): CacheDriver;
-}>;
-//# sourceMappingURL=MongoDriver.d.ts.map

package/src/cache/drivers/MongoDriver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MongoDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/MongoDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;cACO,WAAW;EA4ErB,CAAC"}

package/src/cache/drivers/MongoDriver.js

@@ -1,80 +0,0 @@
-/**
- * MongoDB Cache Driver
- * Uses MongoDB Atlas Data API (HTTPS) for zero-dependency integration
- */
-import { Env } from '../../config/env.js';
-import { Logger } from '../../config/logger.js';
-import { ErrorFactory } from '../../exceptions/ZintrustError.js';
-/**
- * MongoDB Cache Driver
- * Uses MongoDB Atlas Data API (HTTPS) for zero-dependency integration
- * Sealed namespace for immutability
- */
-export const MongoDriver = Object.freeze({
-    /**
-     * Create a new MongoDB driver instance
-     */
-    create() {
-        const uri = Env.MONGO_URI;
-        const db = Env.MONGO_DB;
-        const collection = 'cache';
-        const request = async (action, body) => {
-            if (uri === '') {
-                Logger.warn('MONGO_URI not configured. MongoDB Cache request ignored.');
-                return null;
-            }
-            try {
-                const response = await fetch(`${uri}/action/${action}`, {
-                    method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                        'Access-Control-Request-Headers': '*',
-                    },
-                    body: JSON.stringify({
-                        dataSource: 'Cluster0',
-                        database: db,
-                        collection: collection,
-                        ...body,
-                    }),
-                });
-                return await response.json();
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                ErrorFactory.createTryCatchError(`MongoDB Cache Error: ${message}`);
-                return null;
-            }
-        };
-        return {
-            async get(key) {
-                const result = (await request('findOne', { filter: { _id: key } }));
-                if (result?.document === undefined || result.document === null)
-                    return null;
-                const doc = result.document;
-                if (doc.expires !== null && doc.expires < Date.now()) {
-                    await this.delete(key);
-                    return null;
-                }
-                return doc.value;
-            },
-            async set(key, value, ttl) {
-                const expires = ttl === undefined ? null : Date.now() + ttl * 1000;
-                await request('updateOne', {
-                    filter: { _id: key },
-                    update: { $set: { value, expires } },
-                    upsert: true,
-                });
-            },
-            async delete(key) {
-                await request('deleteOne', { filter: { _id: key } });
-            },
-            async clear() {
-                await request('deleteMany', { filter: {} });
-            },
-            async has(key) {
-                const result = (await request('findOne', { filter: { _id: key } }));
-                return result?.document !== undefined && result.document !== null;
-            },
-        };
-    },
-});

package/src/cache/drivers/RedisDriver.d.ts

@@ -1,12 +0,0 @@
-/**
- * Redis Cache Driver
- * Zero-dependency implementation using Node.js native net module
- */
-import type { CacheDriver } from '../CacheDriver';
-/**
- * RedisDriver namespace - sealed for immutability
- */
-export declare const RedisDriver: Readonly<{
-    create: () => CacheDriver;
-}>;
-//# sourceMappingURL=RedisDriver.d.ts.map

package/src/cache/drivers/RedisDriver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoFtD;;GAEG;AACH,eAAO,MAAM,WAAW;kBA9EL,WAAW;EAgF5B,CAAC"}

package/src/cache/drivers/RedisDriver.js

@@ -1,84 +0,0 @@
-/**
- * Redis Cache Driver
- * Zero-dependency implementation using Node.js native net module
- */
-import { Env } from '../../config/env.js';
-import { Logger } from '../../config/logger.js';
-import * as net from '../../node-singletons/net.js';
-import { createCacheKey } from '../../tools/redis/RedisKeyManager.js';
-/**
- * Create a new Redis driver instance
- */
-const create = () => {
-    let client = null;
-    const host = Env.REDIS_HOST;
-    const port = Env.REDIS_PORT;
-    const connect = async () => {
-        if (client && !client.destroyed)
-            return client;
-        return new Promise((resolve, reject) => {
-            const socket = net.connect(port, host, () => {
-                client = socket;
-                resolve(socket);
-            });
-            socket.on('error', (err) => {
-                Logger.error(`Redis Connection Error: ${err.message}`);
-                reject(err);
-            });
-        });
-    };
-    const sendCommand = async (command) => {
-        const socket = await connect();
-        return new Promise((resolve, _reject) => {
-            socket.once('data', (data) => {
-                resolve(data.toString());
-            });
-            socket.write(command);
-        });
-    };
-    return {
-        async get(key) {
-            try {
-                const prefixedKey = createCacheKey(key);
-                const response = await sendCommand(`GET ${prefixedKey}\r\n`);
-                if (response.startsWith('$-1'))
-                    return null;
-                // Basic RESP parsing
-                const lines = response.split('\r\n');
-                const value = lines[1];
-                return JSON.parse(value);
-            }
-            catch (error) {
-                Logger.error('Redis GET failed', error);
-                return null;
-            }
-        },
-        async set(key, value, ttl) {
-            const prefixedKey = createCacheKey(key);
-            const jsonValue = JSON.stringify(value);
-            let command = `SET ${prefixedKey} ${jsonValue}\r\n`;
-            if (ttl !== undefined) {
-                command = `SETEX ${prefixedKey} ${ttl} ${jsonValue}\r\n`;
-            }
-            await sendCommand(command);
-        },
-        async delete(key) {
-            const prefixedKey = createCacheKey(key);
-            await sendCommand(`DEL ${prefixedKey}\r\n`);
-        },
-        async clear() {
-            await sendCommand(`FLUSHDB\r\n`);
-        },
-        async has(key) {
-            const prefixedKey = createCacheKey(key);
-            const response = await sendCommand(`EXISTS ${prefixedKey}\r\n`);
-            return response.includes(':1');
-        },
-    };
-};
-/**
- * RedisDriver namespace - sealed for immutability
- */
-export const RedisDriver = Object.freeze({
-    create,
-});

package/src/cli/BaseCommand.d.ts

@@ -1,41 +0,0 @@
-/**
- * Base Command - Abstract Command Class
- * All CLI commands extend this class
- */
-import { Command } from 'commander';
-export interface CommandOptions {
-    verbose?: boolean;
-    args?: string[];
-    [key: string]: unknown;
-}
-export interface IBaseCommand {
-    [x: string]: unknown;
-    name: string;
-    description: string;
-    verbose?: boolean;
-    getCommand(): Command;
-    addOptions?: (command: Command) => void;
-    execute(options: CommandOptions): void | Promise<void>;
-    info(message: string): void;
-    success(message: string): void;
-    warn(message: string): void;
-    debug(message: unknown): void;
-}
-/**
- * Command Factory Helper
- * Sealed namespace for immutability
- */
-export declare const BaseCommand: Readonly<{
-    /**
-     * Create a command instance with common logic
-     */
-    create<T extends IBaseCommand = IBaseCommand>(config: {
-        name: string;
-        description: string;
-        /** Optional alias or aliases for the command (e.g. 'make:mail') */
-        aliases?: string | string[];
-        addOptions?: (command: Command) => void;
-        execute: (options: CommandOptions) => void | Promise<void>;
-    }): T;
-}>;
-//# sourceMappingURL=BaseCommand.d.ts.map

package/src/cli/BaseCommand.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;WACI,CAAC,SAAS,YAAY,yBAAyB;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,CAAC;EA6DL,CAAC"}

package/src/cli/BaseCommand.js

@@ -1,69 +0,0 @@
-/**
- * Base Command - Abstract Command Class
- * All CLI commands extend this class
- */
-import { ErrorHandler } from './ErrorHandler.js';
-import { ErrorFactory } from '../exceptions/ZintrustError.js';
-import { Command } from 'commander';
-/**
- * Command Factory Helper
- * Sealed namespace for immutability
- */
-export const BaseCommand = Object.freeze({
-    /**
-     * Create a command instance with common logic
-     */
-    create(config) {
-        const getCommand = () => {
-            const command = new Command(config.name);
-            command.description(config.description);
-            command.option('--verbose', 'Enable verbose output');
-            if (typeof config.aliases === 'string' && config.aliases.length > 0) {
-                command.alias(config.aliases);
-            }
-            if (Array.isArray(config.aliases)) {
-                for (const alias of config.aliases) {
-                    if (typeof alias === 'string' && alias.length > 0) {
-                        command.alias(alias);
-                    }
-                }
-            }
-            // Add custom options
-            if (config.addOptions) {
-                config.addOptions(command);
-            }
-            // Set action handler
-            command.action(async (...args) => {
-                const options = args.at(-2);
-                const commandArgs = args.slice(0, -2);
-                options.args = commandArgs;
-                try {
-                    await config.execute(options);
-                }
-                catch (error) {
-                    if (error instanceof Error) {
-                        ErrorFactory.createTryCatchError('Command execution failed', error);
-                        ErrorHandler.handle(error, undefined, false);
-                        return;
-                    }
-                    const wrapped = ErrorFactory.createTryCatchError('Command execution failed', error);
-                    ErrorHandler.handle(wrapped, undefined, false);
-                }
-            });
-            return command;
-        };
-        const base = {
-            name: config.name,
-            description: config.description,
-            verbose: false,
-            addOptions: config.addOptions,
-            getCommand,
-            execute: config.execute,
-            info: (msg) => ErrorHandler.info(msg),
-            success: (msg) => ErrorHandler.success(msg),
-            warn: (msg) => ErrorHandler.warn(msg),
-            debug: (msg) => ErrorHandler.debug(msg, true),
-        };
-        return base;
-    },
-});

package/src/cli/CLI.d.ts

@@ -1,21 +0,0 @@
-/**
- * CLI - Main CLI Class
- * Orchestrates all CLI commands using Commander
- */
-import { Command } from 'commander';
-export interface ICLI {
-    run(args: string[]): Promise<void>;
-    getProgram(): Command;
-}
-/**
- * CLI - Main CLI Class
- * Orchestrates all CLI commands using Commander
- *
- * Notes:
- * - `CLI.create()` is the preferred API (used by current bin scripts/tests).
- * - `new CLI()` remains supported for backward compatibility with older bin scripts.
- */
-export declare const CLI: Readonly<{
-    create(): ICLI;
-}>;
-//# sourceMappingURL=CLI.d.ts.map

package/src/cli/CLI.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0CH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AA2MD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}