@zintrust/core 0.1.28 → 0.1.30

package/bin/zintrust-microservices.ts

@@ -1,199 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * ZinTrust Microservices CLI
- * Commands for generating, bundling, and managing microservices
- */
-
-import { Logger } from '@config/logger';
-import { MicroserviceGenerator } from '@microservices/MicroserviceGenerator';
-import { MicroserviceManager } from '@microservices/MicroserviceManager';
-import { ServiceBundler } from '@microservices/ServiceBundler';
-import { readFileSync } from '@node-singletons/fs';
-import { dirname, join } from '@node-singletons/path';
-import { fileURLToPath } from '@node-singletons/url';
-import { program } from 'commander';
-
-type CliOptions = Record<string, unknown>;
-
-const getStringOption = (options: CliOptions, key: string, fallback: string): string => {
-  const value = options[key];
-  return typeof value === 'string' && value.trim() !== '' ? value : fallback;
-};
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Version
-const packageJsonUnknown: unknown = JSON.parse(
-  readFileSync(join(__dirname, '../package.json'), 'utf-8')
-);
-const packageVersion =
-  typeof packageJsonUnknown === 'object' &&
-  packageJsonUnknown !== null &&
-  'version' in packageJsonUnknown &&
-  typeof (packageJsonUnknown as { version: unknown }).version === 'string'
-    ? (packageJsonUnknown as { version: string }).version
-    : '0.0.0';
-
-program.version(packageVersion);
-
-/**
- * Generate microservices
- */
-program
-  .command('generate <domain> <services>')
-  .description('Generate microservices scaffold')
-  .option('--port <port>', 'Base port for services', '3001')
-  .option('--version <version>', 'Service version', '1.0.0')
-  .action(async (domain: string, services: string, options: CliOptions) => {
-    try {
-      const serviceList = services.split(',').map((s) => s.trim());
-      const portRaw = getStringOption(options, 'port', '3001');
-      const version = getStringOption(options, 'version', '1.0.0');
-
-      await MicroserviceGenerator.getInstance().generate({
-        domain,
-        services: serviceList,
-        basePort: Number.parseInt(portRaw, 10),
-        version,
-      });
-
-      Logger.info('Microservices generated successfully');
-    } catch (error) {
-      Logger.error('Error generating microservices:', error);
-      process.exit(1);
-    }
-  });
-
-/**
- * Bundle services
- */
-program
-  .command('bundle <domain> <services>')
-  .description('Bundle microservices for deployment')
-  .option('--output <dir>', 'Output directory', 'dist/services')
-  .option('--target-size <mb>', 'Target bundle size in MB', '1')
-  .action(async (domain: string, services: string, options: CliOptions) => {
-    try {
-      const serviceList = services.split(',').map((s) => s.trim());
-      const outputDir = getStringOption(options, 'output', 'dist/services');
-
-      const results = await ServiceBundler.getInstance().bundleAll(domain, serviceList, outputDir);
-
-      const allOptimized = results.every((r: { optimized: boolean }) => r.optimized === true);
-      if (allOptimized === false) {
-        Logger.warn('Some services exceed target size. Consider optimizing bundle.');
-      }
-    } catch (error) {
-      Logger.error('Error bundling microservices:', error);
-      process.exit(1);
-    }
-  });
-
-/**
- * Create Docker images
- */
-program
-  .command('docker <domain> <services>')
-  .description('Create Docker images for services')
-  .option('--registry <url>', 'Docker registry URL', 'localhost:5000')
-  .action(async (domain: string, services: string, options: CliOptions) => {
-    try {
-      const serviceList = services.split(',').map((s) => s.trim());
-      const registry = getStringOption(options, 'registry', 'localhost:5000');
-
-      await Promise.all(
-        serviceList.map((service) =>
-          ServiceBundler.getInstance().createServiceImage(service, domain, registry)
-        )
-      );
-
-      Logger.info(
-        `Docker images ready. Build with:\n  docker-compose -f services/${domain}/docker-compose.yml build`
-      );
-    } catch (error) {
-      Logger.error('Error creating Docker images:', error);
-      process.exit(1);
-    }
-  });
-
-/**
- * Discover services
- */
-program
-  .command('discover')
-  .description('Discover available microservices')
-  .action(async () => {
-    try {
-      const configs = await MicroserviceManager.discoverServices();
-
-      if (configs.length === 0) {
-        Logger.info('No microservices found in services/ folder');
-        return;
-      }
-
-      Logger.info(`Found ${configs.length} microservice(s):`);
-
-      for (const config of configs) {
-        const version =
-          config.version !== undefined && config.version !== null && config.version !== ''
-            ? config.version
-            : '1.0.0';
-
-        Logger.info(`  • ${config.name} (${config.domain}) - v${version}`);
-
-        if (
-          config.dependencies !== undefined &&
-          config.dependencies !== null &&
-          config.dependencies.length > 0
-        ) {
-          Logger.info(`    Dependencies: ${config.dependencies.join(', ')}`);
-        }
-      }
-    } catch (error) {
-      Logger.error('Error discovering services:', error);
-      process.exit(1);
-    }
-  });
-
-/**
- * Status of services
- */
-program
-  .command('status')
-  .description('Check status of running microservices')
-  .action(async () => {
-    try {
-      const manager = MicroserviceManager.getInstance();
-      const summary = manager.getStatusSummary();
-
-      Logger.info(`Microservices Status:\n${JSON.stringify(summary, null, 2)}`);
-    } catch (error) {
-      Logger.error('Error getting microservices status:', error);
-      process.exit(1);
-    }
-  });
-
-/**
- * Health check
- */
-program
-  .command('health')
-  .description('Health check all services')
-  .action(async () => {
-    try {
-      const manager = MicroserviceManager.getInstance();
-      const results = await manager.healthCheckAll();
-
-      Logger.info('Health Check Results');
-      for (const [service, healthy] of Object.entries(results)) {
-        Logger.info(`  ${service}: ${healthy ? 'Healthy' : 'Unhealthy'}`);
-      }
-    } catch (error) {
-      Logger.error('Error performing health check:', error);
-      process.exit(1);
-    }
-  });
-
-program.parse(process.argv);

package/bin/zintrust.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env -S node --import tsx
-
-/**
- * ZinTrust CLI - Main Entry Point
- *
- * This bin script is a thin wrapper around the hashbang-free implementation in
- * bin/zintrust-main.ts. Keeping the implementation hashbang-free allows other
- * shortcuts (zin/z/zt) to import it without parse issues.
- */
-
-import { run } from './zintrust-main.js';
-
-await run();
-export {};

package/bin/zt.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env -S node --import tsx
-
-/**
- * ZinTrust CLI Shortcut - 'z'
- * Mirrors bin/zintrust.ts for convenience
- */
-
-import { run } from './zintrust-main.js';
-
-await run();

package/dist/src/index.js

@@ -1,212 +0,0 @@
-/**
- * @zintrust/core v0.1.28
- *
- * ZinTrust Framework - Production-Grade TypeScript Backend
- * Built for performance, type safety, and exceptional developer experience
- *
- * Build Information:
- *   Built: 2026-01-28T22:41:09.126Z
- *   Node: >=20.0.0
- *   License: MIT
- *
- * Copyright (c) 2026 ZinTrust
- * https://zintrust.com
- */
-/**
- * ZinTrust Framework - Production-Grade TypeScript Backend
- * Built for performance, type safety, and exceptional developer experience
- */
-/**
- * Framework version and build metadata
- * Available at runtime for debugging and health checks
- */
-export const ZINTRUST_VERSION = '0.1.23';
-export const ZINTRUST_BUILD_DATE = '2026-01-28T22:41:09.085Z'; // Replaced during build
-import { Application } from './boot/Application.js';
-import { AwsSigV4 } from './common/index.js';
-import { SignedRequest } from './security/SignedRequest.js';
-const ZintrustApplication = Application;
-const ZintrustAwsSigV4 = AwsSigV4;
-const ZintrustSignedRequest = SignedRequest;
-export { Server } from './boot/Server.js';
-export { ServiceContainer } from './container/ServiceContainer.js';
-export { createPaginator, getNextPageUrl, getPrevPageUrl, Paginator } from './database/Paginator.js';
-export { Controller } from './http/Controller.js';
-export { FileUpload } from './http/FileUpload.js';
-export { Kernel } from './http/Kernel.js';
-export { bodyParsingMiddleware } from './http/middleware/BodyParsingMiddleware.js';
-export { fileUploadMiddleware } from './http/middleware/FileUploadMiddleware.js';
-export { BodyParsers } from './http/parsers/BodyParsers.js';
-export { MultipartParser } from './http/parsers/MultipartParser.js';
-export { MultipartParserRegistry } from './http/parsers/MultipartParserRegistry.js';
-export { Request } from './http/Request.js';
-export { RequestContext } from './http/RequestContext.js';
-export { Response } from './http/Response.js';
-export { getValidatedBody, getValidatedHeaders, getValidatedParams, getValidatedQuery, hasValidatedBody, requireValidatedBody, ValidationHelper, } from './http/ValidationHelper.js';
-export { CsrfMiddleware } from './middleware/CsrfMiddleware.js';
-export { ErrorHandlerMiddleware } from './middleware/ErrorHandlerMiddleware.js';
-export { LoggingMiddleware } from './middleware/LoggingMiddleware.js';
-export { MiddlewareStack } from './middleware/MiddlewareStack.js';
-export { RateLimiter } from './middleware/RateLimiter.js';
-export { SecurityMiddleware } from './middleware/SecurityMiddleware.js';
-export { SessionMiddleware } from './middleware/SessionMiddleware.js';
-export { ValidationMiddleware } from './middleware/ValidationMiddleware.js';
-export { MySQLAdapter } from './orm/adapters/MySQLAdapter.js';
-export { PostgreSQLAdapter } from './orm/adapters/PostgreSQLAdapter.js';
-export { SQLiteAdapter } from './orm/adapters/SQLiteAdapter.js';
-export { SQLServerAdapter } from './orm/adapters/SQLServerAdapter.js';
-export { Database, resetDatabase, useDatabase, useEnsureDbConnected } from './orm/Database.js';
-export { Model } from './orm/Model.js';
-export { QueryBuilder } from './orm/QueryBuilder.js';
-export { ZintrustApplication as Application };
-// Time Utilities
-export { DateTime } from './time/DateTime.js';
-// Migrations
-// Note: `Schema` is already exported by Validation. We expose the migration schema runtime
-// as `MigrationSchema` to avoid name collisions.
-export { Schema as MigrationSchema } from './migrations/schema/index.js';
-// Adapter registry (for external adapter packages)
-export { OpenApiGenerator } from './openapi/OpenApiGenerator.js';
-export { Router } from './routes/Router.js';
-export { normalizeRouteMeta, RouteRegistry } from './routes/RouteRegistry.js';
-export { DatabaseAdapterRegistry } from './orm/DatabaseAdapterRegistry.js';
-// Common
-export { generateSecureJobId, generateUuid, getString, Utilities, } from './common/utility.js';
-export { delay, ensureDirSafe } from './common/index.js';
-export { ZintrustAwsSigV4 as AwsSigV4 };
-// Collections
-export { collect, Collection } from './collections/index.js';
-// HTTP Client
-export { HttpClient } from './tools/http/Http.js';
-// Profiling
-export { MemoryProfiler } from './profiling/MemoryProfiler.js';
-export { N1Detector } from './profiling/N1Detector.js';
-export { QueryLogger } from './profiling/QueryLogger.js';
-export { RequestProfiler } from './profiling/RequestProfiler.js';
-// Performance
-export { GenerationCache, LazyLoader, Memoize, ParallelGenerator, PerformanceOptimizer, runAll, runBatch, } from './performance/Optimizer.js';
-// Observability
-export { OpenTelemetry } from './observability/OpenTelemetry.js';
-export { PrometheusMetrics } from './observability/PrometheusMetrics.js';
-// Validation
-export { ValidationError } from './validation/ValidationError.js';
-export { Schema, Validator } from './validation/Validator.js';
-// Security
-export { CsrfTokenManager } from './security/CsrfTokenManager.js';
-export { EncryptedEnvelope } from './security/EncryptedEnvelope.js';
-export { Encryptor } from './security/Encryptor.js';
-export { Hash } from './security/Hash.js';
-export { JwtManager } from './security/JwtManager.js';
-export { PasswordResetTokenBroker } from './security/PasswordResetTokenBroker.js';
-export { createSanitizer, Sanitizer } from './security/Sanitizer.js';
-export { TokenRevocation } from './security/TokenRevocation.js';
-export { Xss } from './security/Xss.js';
-export { XssProtection } from './security/XssProtection.js';
-export { ZintrustSignedRequest as SignedRequest };
-// Exceptions
-export { ErrorFactory } from './exceptions/ZintrustError.js';
-// Events
-export { EventDispatcher } from './events/EventDispatcher.js';
-// Sessions
-export { SessionManager } from './session/SessionManager.js';
-// Config (core-owned)
-export { Env } from './config/env.js';
-export { Logger } from './config/logger.js';
-export { appConfig } from './config/app.js';
-export { cacheConfig } from './config/cache.js';
-// Cache helpers
-export { Cache, cache } from './cache/Cache.js';
-export { registerCachesFromRuntimeConfig } from './cache/CacheRuntimeRegistration.js';
-// Cache driver registry (for external driver packages)
-export { CacheDriverRegistry } from './cache/CacheDriverRegistry.js';
-export { databaseConfig } from './config/database.js';
-export { registerDatabasesFromRuntimeConfig } from './orm/DatabaseRuntimeRegistration.js';
-export { microservicesConfig } from './config/microservices.js';
-// Microservices
-export { MicroserviceBootstrap } from './microservices/MicroserviceBootstrap.js';
-export { MicroserviceManager } from './microservices/MicroserviceManager.js';
-export { RequestTracingMiddleware } from './microservices/RequestTracingMiddleware.js';
-export { ServiceAuthMiddleware } from './microservices/ServiceAuthMiddleware.js';
-export { HealthCheckHandler, ServiceHealthMonitor } from './microservices/ServiceHealthMonitor.js';
-export { middlewareConfig, MiddlewareKeys } from './config/middleware.js';
-export { createBaseDrivers, queueConfig } from './config/queue.js';
-export { default as broadcastConfig } from './config/broadcast.js';
-export { default as notificationConfig } from './config/notification.js';
-export { securityConfig } from './config/security.js';
-export { mailConfig } from './config/mail.js';
-export { storageConfig } from './config/storage.js';
-export { startupConfig } from './config/startup.js';
-export { Constants, DEFAULTS, ENV_KEYS, HTTP_HEADERS, MIME_TYPES } from './config/constants.js';
-export { FeatureFlags } from './config/features.js';
-export { Cloudflare } from './config/cloudflare.js';
-export { getDatabaseCredentials, getJwtSecrets, SECRETS, SecretsManager, } from './config/SecretsManager.js';
-// Config (validation)
-export { StartupConfigValidator } from './config/StartupConfigValidator.js';
-// Mail
-export { Mail } from './tools/mail/index.js';
-export { MailTemplateRenderer, MailTemplates } from './tools/mail/templates/index.js';
-// Mail driver registry (for external driver packages)
-export { MailDriverRegistry } from './tools/mail/MailDriverRegistry.js';
-export { registerQueuesFromRuntimeConfig } from './tools/queue/QueueRuntimeRegistration.js';
-export { SmtpDriver } from './tools/mail/drivers/Smtp.js';
-export { SendGridDriver } from './tools/mail/drivers/SendGrid.js';
-export { MailgunDriver } from './tools/mail/drivers/Mailgun.js';
-// Notifications
-export { sendSlackWebhook } from './tools/notification/drivers/Slack.js';
-export { TermiiDriver } from './tools/notification/drivers/Termii.js';
-export { sendSms } from './tools/notification/drivers/Twilio.js';
-export { Notification } from './tools/notification/Notification.js';
-export { NotificationRegistry } from './tools/notification/Registry.js';
-// Templates
-export { MarkdownRenderer } from './tools/templates/index.js';
-// Health & Runtime (for scaffolded routes and health checks)
-export { RuntimeHealthProbes } from './health/RuntimeHealthProbes.js';
-// Broadcast (for real-time features)
-export { Broadcast } from './tools/broadcast/Broadcast.js';
-export { BroadcastRegistry } from './tools/broadcast/BroadcastRegistry.js';
-export { registerBroadcastersFromRuntimeConfig } from './tools/broadcast/BroadcastRuntimeRegistration.js';
-export { BroadcastWorker } from '../packages/workers/src/index.js';
-// Notification Workers
-export { NotificationWorker } from '../packages/workers/src/index.js';
-// Storage (for file management and signed URLs)
-export { Storage } from './tools/storage/index.js';
-export { LocalSignedUrl } from './tools/storage/LocalSignedUrl.js';
-export { StorageDriverRegistry } from './tools/storage/StorageDriverRegistry.js';
-export { S3Driver } from './tools/storage/drivers/S3.js';
-export { R2Driver } from './tools/storage/drivers/R2.js';
-export { GcsDriver } from './tools/storage/drivers/Gcs.js';
-// Queue drivers (for external registration packages)
-export { RedisQueue } from './tools/queue/drivers/Redis.js';
-export { createLockProvider, getLockProvider, registerLockProvider } from './tools/queue/LockProvider.js';
-export { Queue, resolveLockPrefix } from './tools/queue/Queue.js';
-// Seeders (for database seeding)
-export { SeederLoader } from './seeders/SeederLoader.js';
-// Schedules
-export { default as logCleanup } from './schedules/log-cleanup.js';
-// Node Singletons (cross-runtime wrappers for Node.js APIs)
-export * as NodeSingletons from './node-singletons/index.js';
-// Auth features
-export { Auth } from './auth/Auth.js';
-// Microservice utilities
-export { MicroserviceGenerator } from './microservices/MicroserviceGenerator.js';
-// CLI utilities (for build tools and scripting)
-export { BaseCommand } from './cli/BaseCommand.js';
-export { CLI } from './cli/CLI.js';
-export { ErrorHandler, EXIT_CODES } from './cli/ErrorHandler.js';
-// Runtime detection and kernel
-export { getKernel } from './runtime/getKernel.js';
-export { useFileLoader } from './runtime/useFileLoader.js';
-// Plugin system
-export { PluginManager } from './runtime/PluginManager.js';
-export { PluginRegistry } from './runtime/PluginRegistry.js';
-export { nowIso } from './common/utility.js';
-export { randomBytes } from './node-singletons/crypto.js';
-// Redis config
-export * from './config/redis.js';
-export { ZintrustLang } from './lang/lang.js';
-// Workers config
-export { createRedisConnection, workersConfig } from './config/workers.js';
-// Redis config key
-export { createBullMQKey, createCacheKey, createKeyByType, createQueueKey, createRedisKey, createSessionKey, createWorkerKey, extractOriginalKey, getBullMQSafeQueueName, getPrefix, isAppKey, } from './tools/redis/RedisKeyManager.js';
-// NOTE: Node-only exports (like FileLogWriter, process) are intentionally not
-// exported from this root entrypoint. Use the '@zintrust/core/node' subpath.

package/src/auth/Auth.ts

@@ -1,42 +0,0 @@
-// TEMPLATE_START
-import * as bcrypt from 'bcrypt';
-import jwt, { type Secret, type SignOptions } from 'jsonwebtoken';
-
-const { sign, verify } = jwt;
-
-export const Auth = Object.freeze({
-  /**
-   * Hash a password
-   */
-  async hash(password: string): Promise<string> {
-    const salt = await bcrypt.genSalt(10);
-    return bcrypt.hash(password, salt);
-  },
-
-  /**
-   * Compare a password with a hash
-   */
-  async compare(password: string, hash: string): Promise<boolean> {
-    return bcrypt.compare(password, hash);
-  },
-
-  /**
-   * Generate a JWT token
-   */
-  generateToken(
-    payload: Record<string, unknown>,
-    secret: Secret,
-    expiresIn: NonNullable<SignOptions['expiresIn']> = '1h'
-  ): string {
-    const options: SignOptions = { expiresIn };
-    return sign(payload, secret, options);
-  },
-
-  /**
-   * Verify a JWT token
-   */
-  verifyToken<T>(token: string, secret: Secret): T {
-    return verify(token, secret) as T;
-  },
-});
-// TEMPLATE_END