@zintrust/core 0.1.0

package/src/microservices/ServiceBundler.js

@@ -0,0 +1,297 @@
+/**
+ * Service Bundler - Creates optimized, independent microservice packages
+ * Target: Each service < 1MB for serverless deployment
+ */
+import { Logger } from '../config/logger';
+import fs from '../node-singletons/fs';
+import * as path from '../node-singletons/path';
+/**
+ * Service bundler for independent deployment
+ */
+export const ServiceBundler = Object.freeze(() => {
+    let instance;
+    return {
+        getInstance() {
+            instance ??= this.create();
+            return instance;
+        },
+        async bundleService(config) {
+            return this.getInstance().bundleService(config);
+        },
+        async bundleAll(domain, services, outputDir) {
+            return this.getInstance().bundleAll(domain, services, outputDir);
+        },
+        async createServiceImage(serviceName, domain, registry) {
+            return this.getInstance().createServiceImage(serviceName, domain, registry);
+        },
+        /**
+         * Create a new service bundler instance
+         */
+        create() {
+            return {
+                /**
+                 * Bundle a single microservice
+                 */
+                async bundleService(config) {
+                    return runBundleService(config);
+                },
+                /**
+                 * Bundle multiple services
+                 */
+                async bundleAll(domain, services, outputDir = 'dist/services') {
+                    return runBundleAll(domain, services, outputDir, async (c) => this.bundleService(c));
+                },
+                /**
+                 * Create Docker image for service
+                 */
+                async createServiceImage(serviceName, domain, registry = 'localhost:5000') {
+                    return runCreateServiceImage(serviceName, domain, registry);
+                },
+            };
+        },
+    };
+})();
+/**
+ * Run bundle for a single service
+ */
+async function runBundleService(config) {
+    const { serviceName, domain, outputDir, targetSize = 1 } = config;
+    Logger.info(`\n📦 Bundling service: ${serviceName}`);
+    const serviceDir = `services/${domain}/${serviceName}`;
+    const bundleDir = path.join(outputDir, `${domain}-${serviceName}`);
+    prepareBundleDirectory(bundleDir);
+    const { totalSize, fileCount } = copyServiceFiles(serviceDir, bundleDir);
+    const metadata = generateBundleMetadata(serviceName, domain, totalSize, fileCount, targetSize);
+    fs.writeFileSync(path.join(bundleDir, 'bundle.json'), JSON.stringify(metadata, null, 2));
+    logBundleSummary(totalSize, fileCount, targetSize);
+    return {
+        serviceName,
+        sizeBytes: totalSize,
+        sizeMB: Number.parseFloat((totalSize / (1024 * 1024)).toFixed(2)),
+        files: fileCount,
+        location: bundleDir,
+        optimized: totalSize < targetSize * 1024 * 1024,
+    };
+}
+/**
+ * Run bundle for all services
+ */
+async function runBundleAll(domain, services, outputDir, bundleServiceFn) {
+    Logger.info(`\n📦 Bundling ${services.length} services for domain: ${domain}`);
+    const promises = services.map(async (service) => {
+        try {
+            return await bundleServiceFn({
+                serviceName: service,
+                domain,
+                outputDir,
+            });
+        }
+        catch (error) {
+            Logger.error(`Failed to bundle ${service}:`, error);
+            return null;
+        }
+    });
+    const allResults = await Promise.all(promises);
+    const results = allResults.filter((r) => r !== null);
+    // Print summary
+    printBundleSummary(results);
+    return results;
+}
+/**
+ * Run create service image
+ */
+async function runCreateServiceImage(serviceName, domain, registry) {
+    const serviceDir = `services/${domain}/${serviceName}`;
+    const imageTag = `${registry}/${domain}-${serviceName}:latest`;
+    Logger.info(`\n🐳 Creating Docker image: ${imageTag}`);
+    // Generate minimal Dockerfile
+    const dockerfile = generateDockerfile(serviceName);
+    fs.writeFileSync(path.join(serviceDir, 'Dockerfile'), dockerfile);
+    Logger.info(`  ✓ Dockerfile created at ${serviceDir}/Dockerfile`);
+    Logger.info(`  To build: docker build -t ${imageTag} ${serviceDir}`);
+    return imageTag;
+}
+/**
+ * Copy directory recursively
+ */
+function copyDirectory(src, dest) {
+    if (fs.existsSync(dest) === false) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    const files = fs.readdirSync(src);
+    for (const file of files) {
+        const srcPath = path.join(src, file);
+        const destPath = path.join(dest, file);
+        const stats = fs.statSync(srcPath);
+        if (stats.isDirectory() === true) {
+            copyDirectory(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Get directory size
+ */
+function getDirectorySize(dir) {
+    if (fs.existsSync(dir) === false)
+        return 0;
+    let size = 0;
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        const stats = fs.statSync(filePath);
+        if (stats.isDirectory() === true) {
+            size += getDirectorySize(filePath);
+        }
+        else {
+            size += stats.size;
+        }
+    }
+    return size;
+}
+/**
+ * Count files in directory
+ */
+function countFiles(dir) {
+    if (fs.existsSync(dir) === false)
+        return 0;
+    let count = 0;
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        const stats = fs.statSync(filePath);
+        if (stats.isDirectory() === true) {
+            count += countFiles(filePath);
+        }
+        else {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Prepare bundle directory
+ */
+function prepareBundleDirectory(bundleDir) {
+    if (fs.existsSync(bundleDir) === true) {
+        fs.rmSync(bundleDir, { recursive: true });
+    }
+    fs.mkdirSync(bundleDir, { recursive: true });
+}
+/**
+ * Copy service files to bundle directory
+ */
+function copyServiceFiles(serviceDir, bundleDir) {
+    const filesToCopy = [
+        { src: `${serviceDir}/dist`, dest: `${bundleDir}/dist` },
+        { src: `${serviceDir}/package.json`, dest: `${bundleDir}/package.json` },
+        {
+            src: `${serviceDir}/service.config.json`,
+            dest: `${bundleDir}/service.config.json`,
+        },
+        { src: `${serviceDir}/.env.example`, dest: `${bundleDir}/.env.example` },
+    ];
+    let totalSize = 0;
+    let fileCount = 0;
+    for (const { src, dest } of filesToCopy) {
+        if (fs.existsSync(src) === true) {
+            const stats = fs.statSync(src);
+            if (stats.isDirectory() === true) {
+                copyDirectory(src, dest);
+                totalSize += getDirectorySize(dest);
+                fileCount += countFiles(dest);
+            }
+            else {
+                fs.copyFileSync(src, dest);
+                totalSize += stats.size;
+                fileCount++;
+            }
+        }
+    }
+    return { totalSize, fileCount };
+}
+/**
+ * Generate bundle metadata
+ */
+function generateBundleMetadata(serviceName, domain, totalSize, fileCount, targetSize) {
+    return {
+        service: serviceName,
+        domain,
+        timestamp: new Date().toISOString(),
+        sizeBytes: totalSize,
+        files: fileCount,
+        optimized: totalSize < targetSize * 1024 * 1024,
+    };
+}
+/**
+ * Log bundle summary
+ */
+function logBundleSummary(totalSize, fileCount, targetSize) {
+    const sizeMB = (totalSize / (1024 * 1024)).toFixed(2);
+    Logger.info(`  ✓ Size: ${sizeMB} MB (${fileCount} files)`);
+    if (totalSize > targetSize * 1024 * 1024) {
+        Logger.warn(`  ⚠️  Bundle exceeds ${targetSize} MB target - consider optimizing`);
+    }
+}
+/**
+ * Print bundle summary
+ */
+function printBundleSummary(results) {
+    Logger.info('\n📊 Bundle Summary');
+    Logger.info('━'.repeat(60));
+    let totalSize = 0;
+    let totalFiles = 0;
+    for (const result of results) {
+        const status = result.optimized === true ? '✅' : '⚠️ ';
+        Logger.info(`${status} ${result.serviceName.padEnd(20)} ${result.sizeMB.toFixed(2)} MB (${result.files} files)`);
+        totalSize += result.sizeBytes;
+        totalFiles += result.files;
+    }
+    Logger.info('━'.repeat(60));
+    const totalMB = (totalSize / (1024 * 1024)).toFixed(2);
+    Logger.info(`Total: ${totalMB} MB across ${totalFiles} files\n`);
+}
+/**
+ * Generate minimal Dockerfile
+ */
+function generateDockerfile(serviceName) {
+    return String.raw `FROM node:20-alpine
+
+WORKDIR /app
+
+COPY package.json ./
+RUN npm install --production --ignore-scripts
+
+COPY dist ./dist
+
+ENV NODE_ENV=production
+ENV SERVICE_NAME=${serviceName}
+
+HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
+  CMD node -e "require('node:http').get('http://localhost:3000/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1))"
+
+EXPOSE 3000
+
+CMD ["node", "dist/src/Kernel.js"]
+`;
+}
+/**
+ * CLI command to bundle services
+ */
+export async function bundleServices(domain, services) {
+    const serviceList = services.split(',').map((s) => s.trim());
+    const results = await ServiceBundler.getInstance().bundleAll(domain, serviceList, 'dist/services');
+    const allOptimized = results.every((r) => r.optimized);
+    if (allOptimized) {
+        Logger.info('✅ All services optimized for serverless deployment!');
+    }
+    else {
+        Logger.info('⚠️  Some services exceed 1MB target - consider further optimization');
+    }
+}
+export const bundleService = async (config) => ServiceBundler.getInstance().bundleService(config);
+export const bundleAll = async (domain, services, outputDir) => ServiceBundler.getInstance().bundleAll(domain, services, outputDir);
+export const createServiceImage = async (serviceName, domain, registry) => ServiceBundler.getInstance().createServiceImage(serviceName, domain, registry);
+export default ServiceBundler;

package/src/microservices/ServiceHealthMonitor.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Service Health Check and Monitoring System
+ * Provides per-service and aggregated health status with detailed diagnostics
+ */
+import type { IRequest } from '../http/Request';
+import type { IResponse } from '../http/Response';
+export interface HealthCheckResult {
+    service: string;
+    domain: string;
+    port: number;
+    status: 'healthy' | 'degraded' | 'unhealthy' | 'stopped';
+    timestamp: string;
+    responseTime: number;
+    version: string;
+    checks: {
+        http: boolean;
+        database?: boolean;
+        dependencies?: Record<string, boolean>;
+    };
+    message?: string;
+}
+export interface AggregatedHealthStatus {
+    timestamp: string;
+    totalServices: number;
+    healthy: number;
+    degraded: number;
+    unhealthy: number;
+    services: HealthCheckResult[];
+}
+export interface IHealthCheckHandler {
+    handle(req: IRequest, res: IResponse): Promise<void>;
+}
+/**
+ * Health Check Endpoint Handler
+ * Each service should expose this as GET /health
+ */
+export declare const HealthCheckHandler: Readonly<{
+    /**
+     * Create a new health check handler instance
+     */
+    create(serviceName: string, version: string, port: number, domain: string, dependencies?: string[], checkDatabase?: () => Promise<boolean>): IHealthCheckHandler;
+}>;
+export interface IServiceHealthMonitor {
+    start(): void;
+    stop(): void;
+    checkAll(): Promise<AggregatedHealthStatus>;
+    getLastStatus(): AggregatedHealthStatus;
+    getServiceStatus(serviceName: string): HealthCheckResult | undefined;
+    areAllHealthy(): boolean;
+    isServiceHealthy(serviceName: string): boolean;
+}
+/**
+ * Service Health Monitor
+ * Monitors multiple services and provides aggregated health status
+ */
+export declare const ServiceHealthMonitor: Readonly<{
+    /**
+     * Create a new service health monitor instance
+     */
+    create(healthCheckUrls: Record<string, string>, intervalMs?: number): IServiceHealthMonitor;
+}>;
+export interface IHealthCheckAggregator {
+    handle(req: IRequest, res: IResponse): Promise<void>;
+}
+/**
+ * Health Check Aggregator Endpoint
+ * Exposes aggregated health status at GET /health/services
+ */
+export declare const HealthCheckAggregator: Readonly<{
+    /**
+     * Create a new health check aggregator instance
+     */
+    create(monitor: IServiceHealthMonitor): IHealthCheckAggregator;
+}>;
+declare const _default: {
+    HealthCheckHandler: Readonly<{
+        /**
+         * Create a new health check handler instance
+         */
+        create(serviceName: string, version: string, port: number, domain: string, dependencies?: string[], checkDatabase?: () => Promise<boolean>): IHealthCheckHandler;
+    }>;
+    ServiceHealthMonitor: Readonly<{
+        /**
+         * Create a new service health monitor instance
+         */
+        create(healthCheckUrls: Record<string, string>, intervalMs?: number): IServiceHealthMonitor;
+    }>;
+    HealthCheckAggregator: Readonly<{
+        /**
+         * Create a new health check aggregator instance
+         */
+        create(monitor: IServiceHealthMonitor): IHealthCheckAggregator;
+    }>;
+};
+export default _default;
+//# sourceMappingURL=ServiceHealthMonitor.d.ts.map

package/src/microservices/ServiceHealthMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceHealthMonitor.d.ts","sourceRoot":"","sources":["../../../src/microservices/ServiceHealthMonitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;wBAEY,MAAM,WACV,MAAM,QACT,MAAM,UACJ,MAAM,iBACA,MAAM,EAAE,kBACN,MAAM,OAAO,CAAC,OAAO,CAAC,GACrC,mBAAmB;EA0DtB,CAAC;AA4EH,MAAM,WAAW,qBAAqB;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C,aAAa,IAAI,sBAAsB,CAAC;IACxC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACrE,aAAa,IAAI,OAAO,CAAC;IACzB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;4BAEgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAC3B,MAAM,GACjB,qBAAqB;EAcxB,CAAC;AA6NH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;oBACa,qBAAqB,GAAG,sBAAsB;EAqB9D,CAAC;;;QAjbD;;WAEG;4BAEY,MAAM,WACV,MAAM,QACT,MAAM,UACJ,MAAM,iBACA,MAAM,EAAE,kBACN,MAAM,OAAO,CAAC,OAAO,CAAC,GACrC,mBAAmB;;;QAqJtB;;WAEG;gCAEgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAC3B,MAAM,GACjB,qBAAqB;;;QAoPxB;;WAEG;wBACa,qBAAqB,GAAG,sBAAsB;;;AA4ChE,wBAIE"}