@zintrust/core 0.1.26 → 0.1.28

package/src/runtime/PluginAutoImports.js

@@ -1,63 +0,0 @@
-import { pathToFileURL } from '../node-singletons/url.js';
-import { readEnvString } from '../common/ExternalServiceUtils.js';
-import { Logger } from '../config/logger.js';
-import { ErrorFactory } from '../exceptions/ZintrustError.js';
-import { existsSync } from '../node-singletons/fs.js';
-import * as path from '../node-singletons/path.js';
-const getProjectCwd = () => process.cwd();
-const getProjectRootEnv = () => readEnvString('ZINTRUST_PROJECT_ROOT');
-const resolveProjectRoot = () => {
-    const projectRootEnv = getProjectRootEnv();
-    if (projectRootEnv.trim().length > 0) {
-        return projectRootEnv.trim();
-    }
-    return getProjectCwd();
-};
-const getCandidates = (projectRoot) => {
-    return [
-        // Dev (tsx)
-        path.join(projectRoot, 'src', 'zintrust.plugins.ts'),
-        // Production build output (most common)
-        path.join(projectRoot, 'dist', 'src', 'zintrust.plugins.js'),
-        // Fallback (in case someone transpiles without /dist)
-        path.join(projectRoot, 'src', 'zintrust.plugins.js'),
-    ];
-};
-export const PluginAutoImports = Object.freeze({
-    /**
-     * Best-effort import of a project's `src/zintrust.plugins.ts` file.
-     *
-     * This file is generated/maintained by `zin plugin install` and contains
-     * side-effect imports (e.g. `@zintrust/db-mysql/register`) which register
-     * adapters/drivers into core registries.
-     */
-    async tryImportProjectAutoImports() {
-        const projectRoot = resolveProjectRoot();
-        const candidates = getCandidates(projectRoot);
-        for (const candidate of candidates) {
-            if (!existsSync(candidate))
-                continue;
-            try {
-                const url = pathToFileURL(candidate).href;
-                // eslint-disable-next-line no-await-in-loop
-                await import(url);
-                return { ok: true, loadedPath: candidate };
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                Logger.warn('[plugins] Failed to import plugin auto-imports', {
-                    candidate,
-                    errorMessage,
-                });
-                // Keep error creation for consistent structure (but do not throw).
-                ErrorFactory.createTryCatchError('Failed to import project plugin auto-imports', {
-                    candidate,
-                    error,
-                });
-                return { ok: false, loadedPath: candidate, reason: 'import-failed', errorMessage };
-            }
-        }
-        Logger.debug('[plugins] No plugin auto-imports file found', { projectRoot, candidates });
-        return { ok: false, reason: 'not-found' };
-    },
-});

package/src/runtime/PluginManager.d.ts

@@ -1,28 +0,0 @@
-import type { PluginDefinition } from './PluginRegistry';
-export declare const PluginManager: Readonly<{
-    /**
-     * List all available plugins
-     */
-    list(): Record<string, PluginDefinition>;
-    /**
-     * Resolve a plugin ID from an alias or full ID
-     */
-    resolveId(idOrAlias: string): string | null;
-    /**
-     * Check if a plugin is currently installed
-     */
-    isInstalled(pluginId: string): Promise<boolean>;
-    /**
-     * Install a plugin
-     */
-    install(pluginId: string, options?: {
-        packageManager?: string;
-    }): Promise<void>;
-    /**
-     * Uninstall a plugin
-     * Note: This does NOT uninstall dependencies to avoid breaking other things,
-     * but it does revert the code to the "stub" state if possible, or delete the file.
-     */
-    uninstall(pluginId: string): Promise<void>;
-}>;
-//# sourceMappingURL=PluginManager.d.ts.map

package/src/runtime/PluginManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgShE,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}

package/src/runtime/PluginManager.js

@@ -1,373 +0,0 @@
-/* eslint-disable @typescript-eslint/require-await */
-/**
- * Plugin Manager
- * Handles installation and removal of framework plugins.
- */
-import { SpawnUtil } from '../cli/utils/spawn.js';
-import { readEnvString } from '../common/ExternalServiceUtils.js';
-import { esmDirname, resolvePackageManager } from '../common/index.js';
-import { Logger } from '../config/logger.js';
-import { ErrorFactory } from '../exceptions/ZintrustError.js';
-import { execSync } from '../node-singletons/child-process.js';
-import { existsSync, fsPromises as fs } from '../node-singletons/fs.js';
-import * as path from '../node-singletons/path.js';
-import { PluginRegistry } from './PluginRegistry.js';
-const __dirname = esmDirname(import.meta.url);
-const MAX_PACKAGE_ROOT_SEARCH_DEPTH = 20;
-function findPackageRoot(startDir) {
-    let current = startDir;
-    for (let i = 0; i < MAX_PACKAGE_ROOT_SEARCH_DEPTH; i++) {
-        if (existsSync(path.join(current, 'package.json')))
-            return current;
-        const parent = path.dirname(current);
-        if (parent === current)
-            break;
-        current = parent;
-    }
-    // Fallback to a reasonable default if package.json isn't found.
-    return path.resolve(startDir, '../..');
-}
-const getProjectCwd = () => process.cwd();
-const getProjectRootEnv = () => readEnvString('ZINTRUST_PROJECT_ROOT');
-const getAllowPostInstallEnv = () => readEnvString('ZINTRUST_ALLOW_POSTINSTALL').trim();
-function resolveProjectRoot() {
-    const projectRootEnv = getProjectRootEnv();
-    if (projectRootEnv.trim().length > 0) {
-        return projectRootEnv.trim();
-    }
-    return getProjectCwd();
-}
-function resolveTemplateRootOrThrow() {
-    const packageRoot = findPackageRoot(__dirname);
-    const candidates = [
-        // Monorepo/dev layout
-        path.join(packageRoot, 'src', 'templates'),
-        // Packed layout (if templates are shipped without src)
-        path.join(packageRoot, 'templates'),
-        // Common build output layout
-        path.join(packageRoot, 'dist', 'templates'),
-    ];
-    for (const candidate of candidates) {
-        if (existsSync(candidate))
-            return candidate;
-    }
-    throw ErrorFactory.createNotFoundError('Plugin templates directory not found', {
-        candidates,
-        packageRoot,
-    });
-}
-function isStringRecord(value) {
-    if (typeof value !== 'object' || value === null)
-        return false;
-    for (const v of Object.values(value)) {
-        if (typeof v !== 'string')
-            return false;
-    }
-    return true;
-}
-function isStringArray(value) {
-    return Array.isArray(value) && value.every((v) => typeof v === 'string');
-}
-function parsePackageJsonDeps(text) {
-    const parsed = JSON.parse(text);
-    if (typeof parsed !== 'object' || parsed === null)
-        return {};
-    const obj = parsed;
-    const dependencies = isStringRecord(obj['dependencies']) ? obj['dependencies'] : undefined;
-    const devDependencies = isStringRecord(obj['devDependencies'])
-        ? obj['devDependencies']
-        : undefined;
-    return { dependencies, devDependencies };
-}
-function getPluginOrThrow(pluginId) {
-    const resolvedId = PluginManager.resolveId(pluginId);
-    if (resolvedId === null) {
-        throw ErrorFactory.createNotFoundError(`Plugin ${pluginId} not found`, { pluginId });
-    }
-    return { resolvedId, plugin: PluginRegistry[resolvedId] };
-}
-async function npmInstall(packages, options) {
-    if (packages.length === 0)
-        return;
-    Logger.info(`Installing ${options.label}: ${packages.join(', ')}...`);
-    const projectRoot = options.projectRoot ?? resolveProjectRoot();
-    const pm = options.packageManager ?? resolvePackageManager();
-    // Legacy behavior: npm uses execSync in this framework.
-    // This keeps behavior predictable for CI/test environments and matches existing unit tests.
-    if (pm === 'npm') {
-        const cmd = options.dev
-            ? `npm install -D ${packages.join(' ')}`
-            : `npm install ${packages.join(' ')}`;
-        try {
-            execSync(cmd, { cwd: projectRoot, stdio: 'inherit' });
-            return;
-        }
-        catch (error) {
-            ErrorFactory.createCliError(`Failed to install ${options.label}`, { error });
-            throw error;
-        }
-    }
-    let cmd;
-    let args = [];
-    switch (pm) {
-        case 'pnpm':
-            cmd = 'pnpm';
-            args = ['add', ...packages, ...(options.dev ? ['-D'] : [])];
-            break;
-        case 'yarn':
-            cmd = 'yarn';
-            args = ['add', ...packages, ...(options.dev ? ['--dev'] : [])];
-            break;
-        case 'npm':
-        default:
-            cmd = 'npm';
-            args = ['install', ...(options.dev ? ['--save-dev'] : []), ...packages];
-            break;
-    }
-    try {
-        // Use async spawn for all package managers to avoid blocking event loop
-        const exit = await SpawnUtil.spawnAndWait({ command: cmd, args, cwd: projectRoot });
-        if (exit !== 0) {
-            throw ErrorFactory.createCliError(`Package manager ${pm} failed to install ${options.label}`, {
-                exit,
-            });
-        }
-    }
-    catch (error) {
-        ErrorFactory.createCliError(`Failed to install ${options.label}`, { error });
-        throw error;
-    }
-}
-async function copyPluginTemplates(plugin) {
-    const templateRoot = resolveTemplateRootOrThrow();
-    const projectRoot = resolveProjectRoot();
-    // Parallelize file operations using Promise.all
-    await Promise.all(plugin.templates.map(async (template) => {
-        const sourcePath = path.join(templateRoot, template.source);
-        const destPath = path.join(projectRoot, template.destination);
-        // Prevent path traversal: resolved destination must be within project root
-        const resolvedDest = path.resolve(destPath);
-        const resolvedProjectRoot = path.resolve(projectRoot);
-        if (!(resolvedDest === resolvedProjectRoot ||
-            resolvedDest.startsWith(resolvedProjectRoot + path.sep))) {
-            throw ErrorFactory.createCliError(`Invalid template destination: ${template.destination}`, {
-                destination: template.destination,
-            });
-        }
-        Logger.info(`Copying ${template.source} to ${template.destination}...`);
-        try {
-            // Ensure destination directory exists
-            await fs.mkdir(path.dirname(destPath), { recursive: true });
-            // Read and write file
-            const content = await fs.readFile(sourcePath, 'utf-8');
-            await fs.writeFile(destPath, content, 'utf-8');
-        }
-        catch (error) {
-            ErrorFactory.createCliError(`Failed to copy template ${template.source}`, { error });
-            throw error;
-        }
-    }));
-}
-async function ensurePluginAutoImports(plugin) {
-    const rawImports = plugin.autoImports;
-    if (!isStringArray(rawImports) || rawImports.length === 0)
-        return;
-    const imports = rawImports;
-    const projectRoot = resolveProjectRoot();
-    const pluginFile = path.join(projectRoot, 'src', 'zintrust.plugins.ts');
-    await fs.mkdir(path.dirname(pluginFile), { recursive: true });
-    const header = '/**\n' +
-        ' * ZinTrust plugin auto-imports\n' +
-        ' *\n' +
-        ' * This file is managed by `zin plugin install` and contains side-effect\n' +
-        ' * imports that register optional adapters/drivers into core registries.\n' +
-        ' */\n\n';
-    let current = '';
-    try {
-        current = await fs.readFile(pluginFile, 'utf-8');
-    }
-    catch {
-        current = '';
-    }
-    const lines = [];
-    if (current.trim().length === 0) {
-        lines.push(header.trimEnd());
-    }
-    else {
-        lines.push(current.trimEnd());
-    }
-    const existing = new Set();
-    for (const line of lines.join('\n').split(/\r?\n/)) {
-        const m = new RegExp(/^\s*import\s+['"]([^'"]+)['"];\s*$/).exec(line);
-        if (m)
-            existing.add(m[1]);
-    }
-    let appended = 0;
-    for (const spec of imports) {
-        if (typeof spec !== 'string' || spec.trim() === '')
-            continue;
-        if (existing.has(spec))
-            continue;
-        lines.push(`import '${spec}';`);
-        existing.add(spec);
-        appended += 1;
-    }
-    if (appended === 0)
-        return;
-    const next = lines.join('\n') + '\n';
-    await fs.writeFile(pluginFile, next, 'utf-8');
-}
-function runPostInstall(plugin) {
-    if (!plugin.postInstall)
-        return;
-    const projectRoot = resolveProjectRoot();
-    if (plugin.postInstall.command !== undefined) {
-        // Post-install command execution is opt-in. To avoid arbitrary command execution
-        // and reduce supply-chain risk, we only execute when ZINTRUST_ALLOW_POSTINSTALL=1
-        const allow = getAllowPostInstallEnv() === '1';
-        if (allow) {
-            Logger.info(`Running post-install command: ${plugin.postInstall.command}...`);
-            try {
-                execSync(plugin.postInstall.command, {
-                    stdio: 'inherit',
-                    cwd: projectRoot,
-                });
-            }
-            catch (error) {
-                ErrorFactory.createCliError('Post-install command failed', { error });
-            }
-        }
-        else {
-            Logger.info(`Post-install command available but not executed (ZINTRUST_ALLOW_POSTINSTALL!=1): ${plugin.postInstall.command}`);
-        }
-    }
-    if (plugin.postInstall.message !== undefined && plugin.postInstall.message.length > 0) {
-        Logger.info('----------------------------------------');
-        Logger.info(plugin.postInstall.message);
-        Logger.info('----------------------------------------');
-    }
-}
-export const PluginManager = Object.freeze({
-    /**
-     * List all available plugins
-     */
-    list() {
-        return PluginRegistry;
-    },
-    /**
-     * Resolve a plugin ID from an alias or full ID
-     */
-    resolveId(idOrAlias) {
-        if (PluginRegistry[idOrAlias] !== undefined)
-            return idOrAlias;
-        for (const [id, plugin] of Object.entries(PluginRegistry)) {
-            if (plugin.aliases.includes(idOrAlias)) {
-                return id;
-            }
-        }
-        return null;
-    },
-    /**
-     * Check if a plugin is currently installed
-     */
-    async isInstalled(pluginId) {
-        const resolvedId = PluginManager.resolveId(pluginId);
-        if (resolvedId === null) {
-            throw ErrorFactory.createNotFoundError(`Plugin ${pluginId} not found`, { pluginId });
-        }
-        const plugin = PluginRegistry[resolvedId];
-        const projectRoot = resolveProjectRoot();
-        // Dependency-only plugins (no templates): consider installed when required deps are present.
-        if (plugin.templates.length === 0) {
-            try {
-                const packageJsonPath = path.join(projectRoot, 'package.json');
-                const packageJsonText = await fs.readFile(packageJsonPath, 'utf-8');
-                const packageJson = parsePackageJsonDeps(packageJsonText);
-                const hasDeps = plugin.dependencies.every((dep) => packageJson.dependencies?.[dep] ?? packageJson.devDependencies?.[dep] ?? '');
-                const hasDevDeps = plugin.devDependencies.every((dep) => packageJson.devDependencies?.[dep] ?? packageJson.dependencies?.[dep] ?? '');
-                return hasDeps && hasDevDeps;
-            }
-            catch {
-                return false;
-            }
-        }
-        // Check if the main template file exists in the destination
-        // We assume if the first template exists, the plugin is "installed"
-        if (plugin.templates.length > 0) {
-            const destPath = path.join(projectRoot, plugin.templates[0].destination);
-            try {
-                await fs.access(destPath);
-                // Also check if dependencies are in package.json
-                const packageJsonPath = path.join(projectRoot, 'package.json');
-                const packageJsonText = await fs.readFile(packageJsonPath, 'utf-8');
-                const packageJson = parsePackageJsonDeps(packageJsonText);
-                const hasDeps = plugin.dependencies.every((dep) => packageJson.dependencies?.[dep] ?? packageJson.devDependencies?.[dep] ?? '');
-                return hasDeps;
-            }
-            catch {
-                ErrorFactory.createCliError(`Plugin ${plugin.name} not installed (missing files or dependencies)`);
-                return false;
-            }
-        }
-        return false;
-    },
-    /**
-     * Install a plugin
-     */
-    async install(pluginId, options) {
-        const { plugin } = getPluginOrThrow(pluginId);
-        Logger.info(`Installing plugin: ${plugin.name}...`);
-        // 1. Install dependencies (use SpawnUtil and support multiple package managers)
-        await npmInstall(plugin.dependencies, {
-            dev: false,
-            label: 'dependencies',
-            packageManager: options?.packageManager,
-        });
-        await npmInstall(plugin.devDependencies, {
-            dev: true,
-            label: 'dev dependencies',
-            packageManager: options?.packageManager,
-        });
-        // 2. Copy templates
-        await copyPluginTemplates(plugin);
-        // 2b. Ensure plugin-side effects are imported by the project
-        await ensurePluginAutoImports(plugin);
-        // 3. Post-Install (still executed via execSync - opt-in)
-        runPostInstall(plugin);
-        Logger.info(`✓ Plugin ${plugin.name} installed successfully`);
-    },
-    /**
-     * Uninstall a plugin
-     * Note: This does NOT uninstall dependencies to avoid breaking other things,
-     * but it does revert the code to the "stub" state if possible, or delete the file.
-     */
-    async uninstall(pluginId) {
-        const resolvedId = PluginManager.resolveId(pluginId);
-        if (resolvedId === null) {
-            throw ErrorFactory.createNotFoundError(`Plugin ${pluginId} not found`, { pluginId });
-        }
-        const plugin = PluginRegistry[resolvedId];
-        Logger.info(`Uninstalling plugin: ${plugin.name}...`);
-        // Revert templates to stubs
-        // For now, we'll just delete the file if it's an adapter,
-        // BUT wait - we need the stubs to exist for the framework to compile if they are referenced.
-        // However, in the "Template" architecture, the stubs ARE the default state.
-        // So "uninstalling" might mean "restoring the stub".
-        // Since we don't have a "stub repository" easily accessible here without reading from git or a backup,
-        // and the user might have modified the file, "uninstall" is tricky.
-        // Strategy:
-        // 1. Warn the user that this will delete the file.
-        // 2. If it's a core adapter, we should probably restore a basic stub.
-        // For this iteration, we will just warn and delete, assuming the user knows what they are doing.
-        // OR, better: We can have a "stubs" folder in templates too?
-        // Actually, the "stubs" are what is currently in the codebase.
-        // When we "install", we overwrite the stub.
-        // When we "uninstall", we should ideally restore the stub.
-        // Let's check if we have a stub backup. If not, maybe we just leave the file but warn?
-        // Or maybe we don't support "uninstall" fully yet, just "install".
-        Logger.warn('Uninstalling plugins is not fully automated yet. You may need to manually revert file changes.');
-        // We can at least try to remove the dependencies if they are not used elsewhere?
-        // Too risky.
-        Logger.info(`✓ Plugin ${plugin.name} uninstalled (files preserved, please revert manually if needed)`);
-    },
-});

package/src/runtime/PluginRegistry.d.ts

@@ -1,27 +0,0 @@
-/**
- * Plugin Registry
- * Defines available plugins, their dependencies, and template paths.
- */
-export interface PluginDefinition {
-    name: string;
-    description: string;
-    type: 'database-adapter' | 'feature' | 'driver';
-    aliases: string[];
-    dependencies: string[];
-    devDependencies: string[];
-    /**
-     * Optional module specifiers to auto-import inside the project.
-     * Used to register adapters/drivers via side-effect imports.
-     */
-    autoImports?: string[];
-    templates: {
-        source: string;
-        destination: string;
-    }[];
-    postInstall?: {
-        message?: string;
-        command?: string;
-    };
-}
-export declare const PluginRegistry: Record<string, PluginDefinition>;
-//# sourceMappingURL=PluginRegistry.d.ts.map

package/src/runtime/PluginRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA2DD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAmJ3D,CAAC"}

package/src/runtime/PluginRegistry.js

@@ -1,183 +0,0 @@
-/**
- * Plugin Registry
- * Defines available plugins, their dependencies, and template paths.
- */
-const feature = (config) => ({
-    name: config.name,
-    description: config.description,
-    type: 'feature',
-    aliases: config.aliases,
-    dependencies: config.dependencies ?? [],
-    devDependencies: config.devDependencies ?? [],
-    autoImports: config.autoImports,
-    templates: config.templates,
-    postInstall: config.postInstall,
-});
-const driver = (config) => ({
-    name: config.name,
-    description: config.description,
-    type: 'driver',
-    aliases: config.aliases,
-    dependencies: config.dependencies,
-    devDependencies: [],
-    autoImports: config.autoImports,
-    templates: [],
-});
-const adapter = (config) => ({
-    name: config.name,
-    description: config.description,
-    type: 'database-adapter',
-    aliases: config.aliases,
-    dependencies: [config.dependency],
-    devDependencies: [],
-    autoImports: [config.autoImport],
-    templates: [],
-});
-export const PluginRegistry = {
-    'feature:auth': {
-        name: 'Authentication Feature',
-        description: 'JWT and Bcrypt based authentication helper',
-        type: 'feature',
-        aliases: ['f:auth', 'auth'],
-        dependencies: ['jsonwebtoken', 'bcrypt'],
-        devDependencies: ['@types/jsonwebtoken', '@types/bcrypt'],
-        templates: [
-            {
-                source: 'auth/Auth.ts.tpl',
-                destination: 'src/auth/Auth.ts',
-            },
-        ],
-        postInstall: {
-            message: 'Authentication installed! Please add JWT_SECRET to your .env file.',
-        },
-    },
-    'feature:queue': feature({
-        name: 'Queue Feature',
-        description: 'Simple job queue interface (In-Memory default)',
-        aliases: ['f:queue', 'queue'],
-        templates: [
-            {
-                source: 'features/Queue.ts.tpl',
-                destination: 'src/features/Queue.ts',
-            },
-        ],
-    }),
-    'driver:queue-redis': driver({
-        name: 'Redis Queue Driver',
-        description: 'Redis-backed queue driver (installs @zintrust/queue-redis)',
-        aliases: ['queue:redis'],
-        dependencies: ['@zintrust/queue-redis'],
-        autoImports: ['@zintrust/queue-redis/register'],
-    }),
-    'driver:queue-rabbitmq': driver({
-        name: 'RabbitMQ Queue Driver',
-        description: 'RabbitMQ-backed queue driver (installs @zintrust/queue-rabbitmq)',
-        aliases: ['queue:rabbitmq', 'queue:amqp'],
-        dependencies: ['@zintrust/queue-rabbitmq', 'amqplib'],
-        autoImports: ['@zintrust/queue-rabbitmq/register'],
-    }),
-    'driver:queue-sqs': driver({
-        name: 'AWS SQS Queue Driver',
-        description: 'SQS-backed queue driver (installs @zintrust/queue-sqs)',
-        aliases: ['queue:sqs'],
-        dependencies: ['@zintrust/queue-sqs', '@aws-sdk/client-sqs'],
-        autoImports: ['@zintrust/queue-sqs/register'],
-    }),
-    'driver:broadcast-redis': driver({
-        name: 'Redis Broadcast Driver',
-        description: 'Redis-backed broadcast driver (installs redis client dependency)',
-        aliases: ['broadcast:redis'],
-        dependencies: ['redis'],
-    }),
-    'driver:cache-redis': driver({
-        name: 'Redis Cache Driver',
-        description: 'Redis-backed cache driver (installs @zintrust/cache-redis)',
-        aliases: ['cache:redis'],
-        dependencies: ['@zintrust/cache-redis'],
-        autoImports: ['@zintrust/cache-redis/register'],
-    }),
-    'driver:cache-mongodb': driver({
-        name: 'MongoDB Cache Driver',
-        description: 'MongoDB Atlas Data API cache driver (installs @zintrust/cache-mongodb)',
-        aliases: ['cache:mongodb', 'cache:mongo'],
-        dependencies: ['@zintrust/cache-mongodb'],
-        autoImports: ['@zintrust/cache-mongodb/register'],
-    }),
-    'driver:mail-nodemailer': driver({
-        name: 'Nodemailer Mail Driver',
-        description: 'Nodemailer-based mail driver (installs @zintrust/mail-nodemailer)',
-        aliases: ['mail:nodemailer'],
-        dependencies: ['@zintrust/mail-nodemailer'],
-        autoImports: ['@zintrust/mail-nodemailer/register'],
-    }),
-    'driver:mail-smtp': driver({
-        name: 'SMTP Mail Driver',
-        description: 'SMTP mail driver (installs @zintrust/mail-smtp)',
-        aliases: ['mail:smtp'],
-        dependencies: ['@zintrust/mail-smtp'],
-        autoImports: ['@zintrust/mail-smtp/register'],
-    }),
-    'driver:mail-sendgrid': driver({
-        name: 'SendGrid Mail Driver',
-        description: 'SendGrid mail driver (installs @zintrust/mail-sendgrid)',
-        aliases: ['mail:sendgrid'],
-        dependencies: ['@zintrust/mail-sendgrid'],
-        autoImports: ['@zintrust/mail-sendgrid/register'],
-    }),
-    'driver:mail-mailgun': driver({
-        name: 'Mailgun Mail Driver',
-        description: 'Mailgun mail driver (installs @zintrust/mail-mailgun)',
-        aliases: ['mail:mailgun'],
-        dependencies: ['@zintrust/mail-mailgun'],
-        autoImports: ['@zintrust/mail-mailgun/register'],
-    }),
-    'driver:storage-s3': driver({
-        name: 'S3 Storage Driver',
-        description: 'S3 storage driver (installs @zintrust/storage-s3)',
-        aliases: ['storage:s3'],
-        dependencies: ['@zintrust/storage-s3'],
-        autoImports: ['@zintrust/storage-s3/register'],
-    }),
-    'driver:storage-r2': driver({
-        name: 'R2 Storage Driver',
-        description: 'Cloudflare R2 storage driver (installs @zintrust/storage-r2)',
-        aliases: ['storage:r2'],
-        dependencies: ['@zintrust/storage-r2'],
-        autoImports: ['@zintrust/storage-r2/register'],
-    }),
-    'driver:storage-gcs': driver({
-        name: 'GCS Storage Driver',
-        description: 'Google Cloud Storage driver (installs @zintrust/storage-gcs)',
-        aliases: ['storage:gcs'],
-        dependencies: ['@zintrust/storage-gcs', '@google-cloud/storage'],
-        autoImports: ['@zintrust/storage-gcs/register'],
-    }),
-    'adapter:postgres': adapter({
-        name: 'PostgreSQL Adapter',
-        description: 'Production-ready PostgreSQL database adapter using pg',
-        aliases: ['a:postgres', 'pg', 'db:postgres', 'postgresql', 'db:postgresql'],
-        dependency: '@zintrust/db-postgres',
-        autoImport: '@zintrust/db-postgres/register',
-    }),
-    'adapter:mysql': adapter({
-        name: 'MySQL Adapter',
-        description: 'Production-ready MySQL database adapter using mysql2',
-        aliases: ['a:mysql', 'mysql', 'db:mysql'],
-        dependency: '@zintrust/db-mysql',
-        autoImport: '@zintrust/db-mysql/register',
-    }),
-    'adapter:mssql': adapter({
-        name: 'SQL Server Adapter',
-        description: 'Production-ready SQL Server database adapter using mssql',
-        aliases: ['a:mssql', 'mssql', 'db:mssql'],
-        dependency: '@zintrust/db-sqlserver',
-        autoImport: '@zintrust/db-sqlserver/register',
-    }),
-    'adapter:sqlite': adapter({
-        name: 'SQLite Adapter',
-        description: 'SQLite database adapter using better-sqlite3',
-        aliases: ['a:sqlite', 'sqlite', 'db:sqlite'],
-        dependency: '@zintrust/db-sqlite',
-        autoImport: '@zintrust/db-sqlite/register',
-    }),
-};