@zintrust/core 0.1.28 → 0.1.29

package/src/runtime/PluginRegistry.ts

@@ -1,232 +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; // Path relative to src/templates/
-    destination: string; // Path relative to project root
-  }[];
-  postInstall?: {
-    message?: string;
-    command?: string;
-  };
-}
-
-type PluginTemplates = PluginDefinition['templates'];
-
-const feature = (config: {
-  name: string;
-  description: string;
-  aliases: string[];
-  templates: PluginTemplates;
-  dependencies?: string[];
-  devDependencies?: string[];
-  autoImports?: string[];
-  postInstall?: PluginDefinition['postInstall'];
-}): PluginDefinition => ({
-  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: string;
-  description: string;
-  aliases: string[];
-  dependencies: string[];
-  autoImports?: string[];
-}): PluginDefinition => ({
-  name: config.name,
-  description: config.description,
-  type: 'driver',
-  aliases: config.aliases,
-  dependencies: config.dependencies,
-  devDependencies: [],
-  autoImports: config.autoImports,
-  templates: [],
-});
-
-const adapter = (config: {
-  name: string;
-  description: string;
-  aliases: string[];
-  dependency: string;
-  autoImport: string;
-}): PluginDefinition => ({
-  name: config.name,
-  description: config.description,
-  type: 'database-adapter',
-  aliases: config.aliases,
-  dependencies: [config.dependency],
-  devDependencies: [],
-  autoImports: [config.autoImport],
-  templates: [],
-});
-
-export const PluginRegistry: Record<string, PluginDefinition> = {
-  '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',
-  }),
-};

package/src/runtime/RuntimeAdapter.ts

@@ -1,291 +0,0 @@
-import type { IncomingMessage, ServerResponse } from '@node-singletons/http';
-
-type Tbody = string | Buffer | null;
-
-/**
- * Request body type for handlers
- */
-export type IRequestBody = Buffer;
-
-/**
- * HTTP request/response for serverless and edge platforms
- */
-export interface PlatformRequest {
-  method: string;
-  path: string;
-  headers: Record<string, string | string[]>;
-  body?: Tbody;
-  query?: Record<string, string | string[]>;
-  remoteAddr?: string;
-}
-
-export interface PlatformResponse {
-  statusCode: number;
-  headers: Record<string, string | string[]>;
-  body?: Tbody;
-  isBase64Encoded?: boolean;
-}
-
-/**
- * RuntimeAdapter interface for platform-agnostic HTTP handling
- * Allows single codebase deployment to Lambda, Fargate, Cloudflare, Deno
- */
-export interface RuntimeAdapter {
-  /**
-   * Platform identifier
-   */
-  platform: 'nodejs' | 'lambda' | 'fargate' | 'cloudflare' | 'deno';
-
-  /**
-   * Handle platform-specific request event
-   * Convert to standard HTTP format, process, and normalize response
-   */
-  handle(event: unknown, context?: unknown): Promise<PlatformResponse>;
-
-  /**
-   * Convert platform event to standard PlatformRequest
-   */
-  parseRequest(event: unknown): PlatformRequest;
-
-  /**
-   * Convert ZinTrust response to platform-specific format
-   */
-  formatResponse(response: PlatformResponse): unknown;
-
-  /**
-   * Get platform-specific logger for debugging
-   */
-  getLogger(): {
-    debug(msg: string, data?: unknown): void;
-    info(msg: string, data?: unknown): void;
-    warn(msg: string, data?: unknown): void;
-    error(msg: string, err?: Error): void;
-  };
-
-  /**
-   * Check if platform supports persistent connections
-   */
-  supportsPersistentConnections(): boolean;
-
-  /**
-   * Get environment configuration object
-   */
-  getEnvironment(): {
-    nodeEnv: NodeJS.ProcessEnv['NODE_ENV'];
-    runtime: string;
-    dbConnection: string;
-    dbHost?: string;
-    dbPort?: number;
-    [key: string]: unknown;
-  };
-}
-
-/**
- * Request handler that processes HTTP requests through ZinTrust framework
- */
-export type ZintrustHandler = (
-  req: IncomingMessage,
-  res: ServerResponse,
-  body: Tbody
-) => Promise<void>;
-
-/**
- * Adapter configuration options
- */
-export interface AdapterConfig {
-  handler: ZintrustHandler;
-  logger?: {
-    debug(msg: string, data?: unknown): void;
-    info(msg: string, data?: unknown): void;
-    warn(msg: string, data?: unknown): void;
-    error(msg: string, err?: Error): void;
-  };
-  timeout?: number; // Request timeout in ms
-  maxBodySize?: number; // Max request body size in bytes
-}
-
-/**
- * Response wrapper for normalizing HTTP responses across platforms
- */
-export interface IHttpResponse {
-  statusCode: number;
-  headers: Record<string, string | string[]>;
-  body: Tbody;
-  isBase64Encoded: boolean;
-  setStatus(code: number): IHttpResponse;
-  setHeader(key: string, value: string | string[]): IHttpResponse;
-  setHeaders(headers: Record<string, string | string[]>): IHttpResponse;
-  setBody(body: Tbody, isBase64?: boolean): IHttpResponse;
-  setJSON(data: unknown): IHttpResponse;
-  toResponse(): PlatformResponse;
-}
-
-export const HttpResponse = Object.freeze({
-  create(): IHttpResponse {
-    const state = {
-      statusCode: 200,
-      headers: { 'Content-Type': 'application/json' } as Record<string, string | string[]>,
-      body: null as Tbody,
-      isBase64Encoded: false,
-    };
-
-    const self: IHttpResponse = {
-      get statusCode() {
-        return state.statusCode;
-      },
-      set statusCode(val: number) {
-        state.statusCode = val;
-      },
-      get headers() {
-        return state.headers;
-      },
-      set headers(val: Record<string, string | string[]>) {
-        state.headers = val;
-      },
-      get body() {
-        return state.body;
-      },
-      set body(val: Tbody) {
-        state.body = val;
-      },
-      get isBase64Encoded() {
-        return state.isBase64Encoded;
-      },
-      set isBase64Encoded(val: boolean) {
-        state.isBase64Encoded = val;
-      },
-
-      setStatus(code: number): IHttpResponse {
-        state.statusCode = code;
-        return self;
-      },
-
-      setHeader(key: string, value: string | string[]): IHttpResponse {
-        state.headers[key] = value;
-        return self;
-      },
-
-      setHeaders(newHeaders: Record<string, string | string[]>): IHttpResponse {
-        state.headers = { ...state.headers, ...newHeaders };
-        return self;
-      },
-
-      setBody(newBody: Tbody, isBase64?: boolean): IHttpResponse {
-        state.body = newBody;
-        state.isBase64Encoded = isBase64 ?? false;
-        return self;
-      },
-
-      setJSON(data: unknown): IHttpResponse {
-        state.headers['Content-Type'] = 'application/json';
-        state.body = JSON.stringify(data);
-        state.isBase64Encoded = false;
-        return self;
-      },
-
-      toResponse(): PlatformResponse {
-        return {
-          statusCode: state.statusCode,
-          headers: state.headers,
-          body: state.body ?? undefined,
-          isBase64Encoded: state.isBase64Encoded,
-        };
-      },
-    };
-
-    return self;
-  },
-});
-
-/**
- * Error response helper
- */
-export const ErrorResponse = Object.freeze({
-  create(statusCode: number, message: string, details?: unknown): IHttpResponse {
-    const response = HttpResponse.create();
-    response.setStatus(statusCode);
-    response.setJSON({
-      error: message,
-      statusCode,
-      timestamp: new Date().toISOString(),
-      ...(details === undefined ? {} : { details }),
-    });
-    return response;
-  },
-});
-
-/**
- * Create mock Node.js request/response objects for platform compatibility
- */
-export function createMockHttpObjects(request: PlatformRequest): {
-  req: Record<string, unknown>;
-  res: Record<string, unknown>;
-  responseData: {
-    statusCode: number;
-    headers: Record<string, string | string[]>;
-    body: Tbody;
-  };
-} {
-  const coerceFirstForwardedFor = (value: unknown): string | undefined => {
-    if (Array.isArray(value)) {
-      const first = (value as unknown[])[0];
-      return typeof first === 'string' && first.trim() !== '' ? first.trim() : undefined;
-    }
-    if (typeof value === 'string' && value.trim() !== '') return value.trim();
-    return undefined;
-  };
-
-  const forwardedFor = coerceFirstForwardedFor(request.headers?.['x-forwarded-for']);
-  const remoteAddress =
-    typeof request.remoteAddr === 'string' && request.remoteAddr.trim() !== ''
-      ? request.remoteAddr.trim()
-      : (forwardedFor?.split(',')[0]?.trim() ?? '') || '0.0.0.0';
-
-  const responseData = {
-    statusCode: 200,
-    headers: { 'Content-Type': 'application/json' } as Record<string, string | string[]>,
-    body: null as Tbody,
-  };
-
-  // Create minimal mock objects for compatibility
-  const req = {
-    method: request.method,
-    url: request.path,
-    headers: request.headers,
-    remoteAddress,
-    socket: {
-      remoteAddress,
-    },
-    connection: {
-      remoteAddress,
-    },
-  };
-
-  const res = {
-    statusCode: 200,
-    headers: responseData.headers,
-    writeHead: function (statusCode: number, headers?: Record<string, string | string[]>): object {
-      responseData.statusCode = statusCode;
-      if (headers) {
-        responseData.headers = { ...responseData.headers, ...headers };
-      }
-      return this;
-    },
-    setHeader: function (name: string, value: string): object {
-      responseData.headers[name.toLowerCase()] = value;
-      return this;
-    },
-    end: function (chunk?: string | Buffer): object {
-      if (chunk !== undefined) {
-        responseData.body = chunk;
-      }
-      return this;
-    },
-    write: function (chunk: string | Buffer): boolean {
-      responseData.body = chunk;
-      return true;
-    },
-  };
-
-  return { req, res, responseData };
-}

package/src/runtime/StartupConfigFileRegistry.ts

@@ -1,64 +0,0 @@
-import useFileLoader from '@runtime/useFileLoader';
-
-export const StartupConfigFile = {
-  Broadcast: 'config/broadcast.ts',
-  Cache: 'config/cache.ts',
-  Database: 'config/database.ts',
-  Mail: 'config/mail.ts',
-  Middleware: 'config/middleware.ts',
-  Notification: 'config/notification.ts',
-  Queue: 'config/queue.ts',
-  Storage: 'config/storage.ts',
-  Workers: 'config/workers.ts',
-} as const;
-
-export type StartupConfigFileTyps =
-  | typeof StartupConfigFile.Broadcast
-  | typeof StartupConfigFile.Cache
-  | typeof StartupConfigFile.Database
-  | typeof StartupConfigFile.Mail
-  | typeof StartupConfigFile.Middleware
-  | typeof StartupConfigFile.Notification
-  | typeof StartupConfigFile.Queue
-  | typeof StartupConfigFile.Storage
-  | typeof StartupConfigFile.Workers;
-
-const cache = new Map<StartupConfigFileTyps, unknown>();
-let preloaded = false;
-
-export const StartupConfigFileRegistry = Object.freeze({
-  async preload(files: readonly StartupConfigFileTyps[]): Promise<void> {
-    const tasks = files.map(async (file) => {
-      const loader = useFileLoader(file);
-      if (!loader.exists()) {
-        cache.delete(file);
-        return;
-      }
-
-      const value = await loader.get();
-      cache.set(file, value);
-    });
-    await Promise.all(tasks);
-    preloaded = true;
-  },
-
-  isPreloaded(): boolean {
-    return preloaded;
-  },
-
-  get<T>(file: StartupConfigFileTyps): T | undefined {
-    return cache.get(file) as T | undefined;
-  },
-
-  has(file: StartupConfigFileTyps): boolean {
-    return cache.has(file);
-  },
-
-  /** Intended for tests only. */
-  clear(): void {
-    cache.clear();
-    preloaded = false;
-  },
-});
-
-export default StartupConfigFileRegistry;