@goatlab/node-backend 0.2.6 → 1.0.0

package/dist/server/middleware/memoryMonitor.example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryMonitor.example.js","sourceRoot":"","sources":["../../../src/server/middleware/memoryMonitor.example.ts"],"names":[],"mappings":"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"}

package/dist/server/middleware/memoryMonitor.middleware.d.ts

@@ -0,0 +1,42 @@
+import type { Request, Response, NextFunction } from 'express';
+import { CommonLogger } from '@goatlab/js-utils';
+interface MemoryMonitorOptions {
+    logger?: CommonLogger;
+    warningThreshold?: number;
+    criticalThreshold?: number;
+    monitorInterval?: number;
+    enableGarbageCollection?: boolean;
+    addHeaders?: boolean;
+}
+interface MemoryMetrics {
+    heapUsedMB: number;
+    heapTotalMB: number;
+    heapUsedPercentage: number;
+    rssMB: number;
+    timestamp: number;
+}
+declare class MemoryMonitor {
+    private logger;
+    private warningThreshold;
+    private criticalThreshold;
+    private monitorInterval;
+    private enableGarbageCollection;
+    private addHeaders;
+    private intervalTimer?;
+    private lastMetrics?;
+    private gcAvailable;
+    constructor(options?: MemoryMonitorOptions);
+    private getMemoryMetrics;
+    private formatMemoryMetrics;
+    private checkMemoryUsage;
+    startMonitoring(): void;
+    stopMonitoring(): void;
+    middleware(): (_req: Request, res: Response, next: NextFunction) => void;
+    getLastMetrics(): MemoryMetrics | undefined;
+}
+export declare function createMemoryMonitorMiddleware(options?: MemoryMonitorOptions): {
+    middleware: (req: Request, res: Response, next: NextFunction) => void;
+    monitor: MemoryMonitor;
+};
+export declare function memoryMonitorMiddleware(options?: MemoryMonitorOptions): (req: Request, res: Response, next: NextFunction) => void;
+export {};

package/dist/server/middleware/memoryMonitor.middleware.js

@@ -0,0 +1,134 @@
+"use strict";
+// npx vitest run ./src/server/middleware/memoryMonitor.middleware.test.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMemoryMonitorMiddleware = createMemoryMonitorMiddleware;
+exports.memoryMonitorMiddleware = memoryMonitorMiddleware;
+const colors_1 = require("kleur/colors");
+class MemoryMonitor {
+    logger;
+    warningThreshold;
+    criticalThreshold;
+    monitorInterval;
+    enableGarbageCollection;
+    addHeaders;
+    intervalTimer;
+    lastMetrics;
+    gcAvailable;
+    constructor(options = {}) {
+        this.logger = options.logger || console;
+        this.warningThreshold = options.warningThreshold || 90;
+        this.criticalThreshold = options.criticalThreshold || 95;
+        this.monitorInterval = options.monitorInterval || 30000; // 30 seconds default
+        this.enableGarbageCollection = options.enableGarbageCollection !== false;
+        this.addHeaders = options.addHeaders !== false;
+        // Check if garbage collection is available
+        this.gcAvailable = typeof global.gc === 'function';
+        if (this.enableGarbageCollection && !this.gcAvailable) {
+            this.logger.warn('Garbage collection is not available. Run node with --expose-gc flag to enable.');
+        }
+    }
+    getMemoryMetrics() {
+        const memUsage = process.memoryUsage();
+        const heapUsedMB = memUsage.heapUsed / (1024 * 1024);
+        const heapTotalMB = memUsage.heapTotal / (1024 * 1024);
+        const heapUsedPercentage = (memUsage.heapUsed / memUsage.heapTotal) * 100;
+        const rssMB = memUsage.rss / (1024 * 1024);
+        return {
+            heapUsedMB,
+            heapTotalMB,
+            heapUsedPercentage,
+            rssMB,
+            timestamp: Date.now()
+        };
+    }
+    formatMemoryMetrics(metrics) {
+        return `Heap: ${metrics.heapUsedMB.toFixed(2)}/${metrics.heapTotalMB.toFixed(2)}MB (${metrics.heapUsedPercentage.toFixed(1)}%) | RSS: ${metrics.rssMB.toFixed(2)}MB`;
+    }
+    checkMemoryUsage(metrics) {
+        const { heapUsedPercentage } = metrics;
+        if (heapUsedPercentage >= this.criticalThreshold) {
+            this.logger.error((0, colors_1.red)(`CRITICAL: Memory usage at ${heapUsedPercentage.toFixed(1)}% - ${this.formatMemoryMetrics(metrics)}`));
+            // Attempt garbage collection if available and enabled
+            if (this.enableGarbageCollection && this.gcAvailable) {
+                this.logger.warn('Triggering garbage collection due to critical memory usage');
+                global.gc();
+                // Log memory after GC
+                setTimeout(() => {
+                    const afterGcMetrics = this.getMemoryMetrics();
+                    this.logger.log(`Memory after GC: ${this.formatMemoryMetrics(afterGcMetrics)}`);
+                }, 100);
+            }
+        }
+        else if (heapUsedPercentage >= this.warningThreshold) {
+            this.logger.warn((0, colors_1.yellow)(`WARNING: Memory usage at ${heapUsedPercentage.toFixed(1)}% - ${this.formatMemoryMetrics(metrics)}`));
+        }
+    }
+    startMonitoring() {
+        if (this.intervalTimer) {
+            return; // Already monitoring
+        }
+        // Initial check
+        const initialMetrics = this.getMemoryMetrics();
+        this.logger.log(`Memory monitoring started - ${this.formatMemoryMetrics(initialMetrics)}`);
+        this.intervalTimer = setInterval(() => {
+            const metrics = this.getMemoryMetrics();
+            this.lastMetrics = metrics;
+            this.checkMemoryUsage(metrics);
+        }, this.monitorInterval);
+        // Ensure timer doesn't prevent process from exiting
+        this.intervalTimer.unref();
+    }
+    stopMonitoring() {
+        if (this.intervalTimer) {
+            clearInterval(this.intervalTimer);
+            this.intervalTimer = undefined;
+            this.logger.log('Memory monitoring stopped');
+        }
+    }
+    middleware() {
+        return (_req, res, next) => {
+            const metrics = this.getMemoryMetrics();
+            this.lastMetrics = metrics;
+            // Add memory metrics to response headers if enabled
+            if (this.addHeaders) {
+                res.setHeader('X-Memory-Heap-Used-MB', metrics.heapUsedMB.toFixed(2));
+                res.setHeader('X-Memory-Heap-Total-MB', metrics.heapTotalMB.toFixed(2));
+                res.setHeader('X-Memory-Heap-Used-Percent', metrics.heapUsedPercentage.toFixed(1));
+                res.setHeader('X-Memory-RSS-MB', metrics.rssMB.toFixed(2));
+            }
+            // Check memory usage on each request
+            this.checkMemoryUsage(metrics);
+            next();
+        };
+    }
+    getLastMetrics() {
+        return this.lastMetrics;
+    }
+}
+// Track if we've already added process listeners
+let processListenersAdded = false;
+// Factory function to create memory monitor middleware
+function createMemoryMonitorMiddleware(options) {
+    const monitor = new MemoryMonitor(options);
+    // Start background monitoring
+    monitor.startMonitoring();
+    // Handle graceful shutdown - only add listeners once globally
+    if (!processListenersAdded && process.env.NODE_ENV !== 'test') {
+        processListenersAdded = true;
+        const cleanup = () => {
+            monitor.stopMonitoring();
+        };
+        process.once('SIGTERM', cleanup);
+        process.once('SIGINT', cleanup);
+    }
+    return {
+        middleware: monitor.middleware(),
+        monitor
+    };
+}
+// Convenience middleware function for simple usage
+function memoryMonitorMiddleware(options) {
+    const { middleware } = createMemoryMonitorMiddleware(options);
+    return middleware;
+}
+//# sourceMappingURL=memoryMonitor.middleware.js.map

package/dist/server/middleware/memoryMonitor.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryMonitor.middleware.js","sourceRoot":"","sources":["../../../src/server/middleware/memoryMonitor.middleware.ts"],"names":[],"mappings":"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"}

package/dist/server/services/secrets/examples/container-preload.example.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/services/secrets/examples/container-preload.example.js

@@ -0,0 +1,148 @@
+"use strict";
+// Example: Using SecretService with preloading in Container
+Object.defineProperty(exports, "__esModule", { value: true });
+const Container_1 = require("../../../../container/Container");
+const secret_service_1 = require("../secret.service");
+// Define your service factories (mock for example)
+const factories = {
+    secrets: (secret_service_1.SecretService),
+    database: class MockDatabaseService {
+        tenantId;
+        config;
+        constructor(tenantId, config) {
+            this.tenantId = tenantId;
+            this.config = config;
+        }
+        async connect() { console.log('Connected to DB'); }
+        async query(sql) { return []; }
+    },
+    api: class MockApiService {
+        tenantId;
+        config;
+        constructor(tenantId, config) {
+            this.tenantId = tenantId;
+            this.config = config;
+        }
+        async getUser(userId, apiKey) { return { id: userId }; }
+        async processData(apiKey) { return { processed: true }; }
+    }
+};
+// Create container with preloading pattern
+const container = new Container_1.Container(factories, async (preload, meta) => {
+    // Create secret service instance
+    const secretService = preload.secrets(meta.tenantId, {
+        provider: 'FILE', // or 'VAULT', 'ENV'
+        location: meta.secretsLocation,
+        encryptionKey: meta.encryptionKey,
+        vaultConfig: meta.vaultConfig
+    });
+    // Preload secrets before using them
+    await secretService.preload();
+    // Now we can use synchronous methods to get secrets
+    const dbConnectionString = secretService.getSecretSync('DB_CONNECTION_STRING');
+    const jwtSecret = secretService.getSecretSync('JWT_SECRET');
+    // Create other services using the preloaded secrets
+    const database = preload.database(meta.tenantId, meta.tenantId, {
+        connectionString: dbConnectionString
+    });
+    const api = preload.api(meta.tenantId, meta.tenantId, {
+        database,
+        jwtSecret
+    });
+    return {
+        secrets: secretService,
+        database,
+        api
+    };
+});
+// Usage example
+async function processRequest(tenantMeta, userId) {
+    await container.bootstrap(tenantMeta, async () => {
+        const { api, secrets } = container.context;
+        // Secrets are already preloaded, so we can use sync methods
+        const apiKey = secrets.getSecretSync('API_KEY');
+        // Use services
+        const user = await api.getUser(userId, apiKey);
+        return user;
+    });
+}
+// Example with multiple providers
+async function multiProviderExample() {
+    // FILE provider for development
+    const devTenant = {
+        tenantId: 'dev-tenant',
+        secretsLocation: '/secrets/dev.json',
+        encryptionKey: 'dev-encryption-key-32chars'
+    };
+    // VAULT provider for production
+    const prodTenant = {
+        tenantId: 'prod-tenant',
+        secretsLocation: 'production/secrets',
+        encryptionKey: 'prod-encryption-key-32chars',
+        vaultConfig: {
+            endpoint: 'https://vault.company.com',
+            token: process.env.VAULT_TOKEN
+        }
+    };
+    // ENV provider for CI/CD
+    const ciTenant = {
+        tenantId: 'ci-tenant',
+        secretsLocation: 'CI', // Will look for CI_API_KEY, CI_DB_CONNECTION_STRING, etc.
+        encryptionKey: 'ci-encryption-key-32chars'
+    };
+}
+// Example with automatic invalidation (FILE provider)
+async function fileWatchingExample() {
+    const container = new Container_1.Container(factories, async (preload, meta) => {
+        const secretService = preload.secrets(meta.tenantId, {
+            provider: 'FILE',
+            location: meta.secretsLocation,
+            encryptionKey: meta.encryptionKey,
+            cacheTTL: 60000 // 1 minute cache
+        });
+        // Enable automatic reload on file changes
+        await secretService.preload();
+        // Secrets will automatically reload if the file changes
+        return { secrets: secretService };
+    });
+    // The secret service will watch for file changes and reload automatically
+}
+// Example with batch operations
+async function batchTenantProcessing() {
+    const tenants = [
+        { tenantId: 'tenant1', secretsLocation: '/secrets/tenant1.json', encryptionKey: 'key1' },
+        { tenantId: 'tenant2', secretsLocation: '/secrets/tenant2.json', encryptionKey: 'key2' },
+        { tenantId: 'tenant3', secretsLocation: '/secrets/tenant3.json', encryptionKey: 'key3' }
+    ];
+    const results = await container.bootstrapBatch(tenants.map(meta => ({
+        metadata: meta,
+        fn: async () => {
+            const { secrets, api } = container.context;
+            // Each tenant has its own preloaded secrets
+            const apiKey = secrets.getSecretSync('API_KEY');
+            // Process tenant data
+            return api.processData(apiKey);
+        }
+    })), {
+        concurrency: 5,
+        continueOnError: true,
+        onProgress: (completed, total) => {
+            console.log(`Processed ${completed}/${total} tenants`);
+        }
+    });
+    // Check results
+    for (const result of results) {
+        if (result.status === 'success') {
+            console.log(`Tenant ${result.metadata.tenantId} processed successfully`);
+        }
+        else {
+            console.error(`Tenant ${result.metadata.tenantId} failed:`, result.error);
+        }
+    }
+}
+// Cleanup when done
+async function cleanup() {
+    // Dispose all services (including secret watchers)
+    await container.disposeAll();
+}
+//# sourceMappingURL=container-preload.example.js.map

package/dist/server/services/secrets/examples/container-preload.example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-preload.example.js","sourceRoot":"","sources":["../../../../../src/server/services/secrets/examples/container-preload.example.ts"],"names":[],"mappings":"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"}

package/dist/server/services/secrets/index.d.ts

@@ -0,0 +1 @@
+export { SecretService, SecretServiceConfig, SecretProvider, VaultConfig } from './secret.service';

package/dist/server/services/secrets/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecretService = void 0;
+var secret_service_1 = require("./secret.service");
+Object.defineProperty(exports, "SecretService", { enumerable: true, get: function () { return secret_service_1.SecretService; } });
+//# sourceMappingURL=index.js.map

package/dist/server/services/secrets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/services/secrets/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkG;AAAzF,+GAAA,aAAa,OAAA"}

package/dist/server/services/secrets/secret.service.d.ts

@@ -5,17 +5,44 @@ export interface VaultConfig {
     mount?: string;
     namespace?: string;
 }
+export interface SecretServiceConfig {
+    provider: SecretProvider;
+    location: string;
+    encryptionKey: string;
+    vaultConfig?: VaultConfig;
+    cacheTTL?: number;
+}
 export declare class SecretService<SecretType> {
     provider: SecretProvider;
     location: string;
     encryptionKey: string;
     vaultConfig?: VaultConfig;
-    constructor({ provider, location, encryptionKey, vaultConfig }: {
-        provider: SecretProvider;
-        location: string;
-        encryptionKey: string;
-        vaultConfig?: VaultConfig;
-    });
+    cacheTTL: number;
+    protected preloadedSecrets?: SecretType;
+    protected isPreloaded: boolean;
+    private fileWatcher?;
+    constructor(config: SecretServiceConfig);
+    /**
+     * Preload secrets asynchronously for synchronous access later
+     * This method loads secrets once and stores them in the instance
+     */
+    preload(): Promise<void>;
+    /**
+     * Invalidate preloaded secrets and stop file watching
+     */
+    invalidate(): Promise<void>;
+    /**
+     * Set up file watching for automatic invalidation
+     */
+    private setupFileWatcher;
+    /**
+     * Load secrets asynchronously with decryption for all providers
+     */
+    private loadSecretsAsync;
+    private isCacheValid;
+    private setCache;
+    private getCache;
+    loadSecretsFromFileAsync(): Promise<SecretType>;
     loadSecretsFromFile(): SecretType;
     loadSecretsFromGCP(): SecretType;
     loadEncryptionKeyFromGCP(): string;
@@ -24,9 +51,22 @@ export declare class SecretService<SecretType> {
     storeSecretsToVault(secrets: Partial<SecretType>): Promise<void>;
     loadSecrets(): SecretType | Promise<SecretType>;
     loadEncryptionKey(): string;
+    getSecretAsync(secretName: keyof SecretType): Promise<string>;
+    getSecretJsonAsync<T = any>(secretName: keyof SecretType): Promise<T>;
     getSecret(secretName: keyof SecretType): Promise<string>;
     getSecretJson<T = any>(secretName: keyof SecretType): Promise<T>;
+    /**
+     * Get a secret synchronously (requires preload() to be called first)
+     */
     getSecretSync(secretName: keyof SecretType): string;
+    /**
+     * Get a JSON secret synchronously (requires preload() to be called first)
+     */
     getSecretJsonSync<T = any>(secretName: keyof SecretType): T;
     static clearCache(): void;
+    static cleanupExpiredCache(): void;
+    /**
+     * Clean up resources (file watchers, etc.) when service is no longer needed
+     */
+    dispose(): void;
 }