threadforge 0.1.1 → 0.2.1

package/dist/plugins/PluginManager.d.ts

@@ -0,0 +1,209 @@
+/**
+ * ThreadForge Plugin System
+ *
+ * Plugins add infrastructure to your app without boilerplate.
+ * They handle connection management, health checks, nginx routing,
+ * graceful shutdown, and inject clients into every service.
+ *
+ * ═══════════════════════════════════════════════════════════════
+ * USAGE
+ * ═══════════════════════════════════════════════════════════════
+ *
+ *   // forge.config.ts
+ *   import { defineServices } from 'threadforge';
+ *   import { redis, postgres, s3 } from 'threadforge/plugins';
+ *
+ *   export default defineServices({
+ *     plugins: [
+ *       redis({ url: 'redis://localhost:6379' }),
+ *       postgres({ url: 'postgres://user:pass@localhost:5432/mydb' }),
+ *       s3({ bucket: 'my-uploads', region: 'us-east-1' }),
+ *     ],
+ *
+ *     users: {
+ *       entry: './services/users.ts',
+ *       port: 3001,
+ *       plugins: ['redis', 'postgres'],  // opt-in per service
+ *     },
+ *
+ *     uploads: {
+ *       entry: './services/uploads.ts',
+ *       port: 3002,
+ *       plugins: ['s3'],
+ *     },
+ *   });
+ *
+ * In your service:
+ *
+ *   @Prefix('/api/users')
+ *   class UserService extends Service {
+ *     async onStart(ctx) {
+ *       // Injected by plugins — ready to use, connection managed
+ *       const cached = await this.redis.get('user:123');
+ *       const rows = await this.postgres.query('SELECT * FROM users WHERE id = $1', [123]);
+ *     }
+ *   }
+ *
+ * ═══════════════════════════════════════════════════════════════
+ * PLUGIN LIFECYCLE
+ * ═══════════════════════════════════════════════════════════════
+ *
+ *   forge start
+ *     │
+ *     ▼ Supervisor reads config, finds plugins
+ *     │
+ *     ▼ plugin.validate()        — check config, throw if bad
+ *     ▼ plugin.env()             — env vars for workers (connection strings)
+ *     ▼ plugin.nginx()           — nginx location blocks (admin UIs, proxying)
+ *     │
+ *     ▼ Workers fork
+ *     │
+ *     ▼ plugin.connect()         — create client, connect, return instance
+ *     ▼ service.redis = client   — injected onto service instance
+ *     ▼ service.onStart(ctx)     — your code runs, clients ready
+ *     │
+ *     ▼ plugin.healthCheck()     — called by /health endpoint
+ *     │
+ *     ▼ shutdown
+ *     ▼ plugin.disconnect()      — close connections, drain pools
+ *
+ * ═══════════════════════════════════════════════════════════════
+ * WRITING A PLUGIN
+ * ═══════════════════════════════════════════════════════════════
+ *
+ *   export function myPlugin(options) {
+ *     return {
+ *       name: 'myPlugin',
+ *       version: '1.0.0',
+ *
+ *       // What property name to inject on the service (this.myPlugin)
+ *       inject: 'myPlugin',
+ *
+ *       // Validate config before startup (fail fast)
+ *       validate() { ... },
+ *
+ *       // Env vars to pass to workers
+ *       env() { return { MY_PLUGIN_URL: options.url }; },
+ *
+ *       // Create and return the client (called once per worker)
+ *       async connect(ctx) {
+ *         const client = new MyClient(options.url);
+ *         await client.connect();
+ *         return client;
+ *       },
+ *
+ *       // Health check (called by GET /health)
+ *       async healthCheck(client) {
+ *         await client.ping();
+ *         return { status: 'ok' };
+ *       },
+ *
+ *       // Clean shutdown
+ *       async disconnect(client) {
+ *         await client.quit();
+ *       },
+ *
+ *       // Nginx config blocks (optional)
+ *       nginx() {
+ *         return {
+ *           upstreams: [{ name: 'myPlugin', host: 'localhost', port: 8080 }],
+ *           locations: [{ path: '/admin/myplugin', proxy_pass: 'myPlugin' }],
+ *         };
+ *       },
+ *
+ *       // Prometheus metrics (optional)
+ *       metrics(client) {
+ *         return { pool_size: client.pool.totalCount };
+ *       },
+ *     };
+ *   }
+ */
+import type { Logger, PluginContext, PluginManagerHealthCheckResult } from "./types.js";
+interface NginxUpstream {
+    name: string;
+    host: string;
+    port: number;
+}
+interface NginxLocation {
+    path: string;
+    proxy_pass: string;
+}
+interface NginxBlocks {
+    upstreams: NginxUpstream[];
+    locations: NginxLocation[];
+}
+interface NginxConfig {
+    upstreams?: NginxUpstream[];
+    locations?: NginxLocation[];
+}
+interface WsUpgradeResult {
+    allow: boolean;
+    statusCode?: number;
+    reason?: string;
+}
+interface MetricsCollector {
+    gauge(name: string, value: number): void;
+}
+type MiddlewareFunction = (req: unknown, res: unknown, next: () => void) => void;
+interface ForgePlugin {
+    name: string;
+    version?: string;
+    inject: string;
+    /** Preferred inject key (defaults to `inject`). When set, the client is
+     *  injected under this name AND the legacy `inject` name. Accessing the
+     *  legacy name logs a one-time deprecation warning. */
+    injectAs?: string;
+    validate?: () => void;
+    env?: () => Record<string, string>;
+    connect: (ctx: PluginContext) => Promise<unknown>;
+    healthCheck?: (client: unknown) => Promise<PluginManagerHealthCheckResult>;
+    disconnect?: (client: unknown) => Promise<void>;
+    nginx?: () => NginxConfig;
+    metrics?: (client: unknown) => Record<string, number>;
+    middleware?: (client: unknown) => MiddlewareFunction;
+    onWsUpgrade?: (client: unknown, ctx: unknown) => Promise<boolean | WsUpgradeResult>;
+    onWsConnect?: (client: unknown, ctx: unknown) => Promise<void>;
+    onWsMessage?: (client: unknown, ctx: unknown) => Promise<void>;
+    onWsClose?: (client: unknown, ctx: unknown) => Promise<void>;
+    [key: string]: unknown;
+}
+interface WebSocketHook {
+    name: string;
+    onWsUpgrade?: (ctx: unknown) => Promise<boolean | WsUpgradeResult>;
+    onWsConnect?: (ctx: unknown) => Promise<void>;
+    onWsMessage?: (ctx: unknown) => Promise<void>;
+    onWsClose?: (ctx: unknown) => Promise<void>;
+}
+interface DisconnectError {
+    name: string;
+    error: string;
+}
+interface PluginManagerOptions {
+    logger?: Logger;
+}
+export declare class PluginManager {
+    plugins: Map<string, ForgePlugin>;
+    clients: Map<string, unknown>;
+    _connecting: Map<string, Promise<unknown>>;
+    _logger: Logger;
+    _deprecationWarned: Set<string>;
+    constructor(options?: PluginManagerOptions);
+    register(plugins: ForgePlugin[] | null | undefined): void;
+    validate(): void;
+    env(): Record<string, string>;
+    connectForService(servicePlugins: string[] | null | undefined, ctx: PluginContext): Promise<Map<string, unknown>>;
+    healthCheck(): Promise<Record<string, PluginManagerHealthCheckResult>>;
+    collectMetrics(metricsCollector: MetricsCollector): void;
+    disconnectAll(logger?: Logger): Promise<DisconnectError[]>;
+    /**
+     * Set client on the result map under the primary inject key (injectAs ?? inject).
+     * If the plugin defines injectAs and it differs from inject, also set a deprecation
+     * proxy under the legacy inject key that logs a warning on first access.
+     */
+    _setClientWithDeprecation(clients: Map<string, unknown>, plugin: ForgePlugin, client: unknown, ctx: PluginContext): void;
+    nginxBlocks(): NginxBlocks;
+    getMiddleware(servicePlugins?: string[] | null): MiddlewareFunction[];
+    getWebSocketHooks(servicePlugins?: string[] | null): WebSocketHook[];
+}
+export {};
+//# sourceMappingURL=PluginManager.d.ts.map

package/dist/plugins/PluginManager.d.ts.map

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

package/dist/plugins/PluginManager.js

@@ -0,0 +1,365 @@
+// ─── Timeout Helper ────────────────────────────────────────
+function withTimeout(promise, ms, label) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`${label} timed out after ${ms}ms`));
+        }, ms);
+        promise.then((val) => {
+            clearTimeout(timer);
+            resolve(val);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+// Default timeouts (ms)
+const CONNECT_TIMEOUT = 10_000;
+const HEALTH_TIMEOUT = 5_000;
+const DISCONNECT_TIMEOUT = 5_000;
+// ─── Type Guards ──────────────────────────────────────────
+function isPluginError(value) {
+    return value !== null && typeof value === "object" && value._pluginError === true;
+}
+// ─── Plugin Manager ────────────────────────────────────────
+export class PluginManager {
+    plugins;
+    clients;
+    _connecting;
+    _logger;
+    _deprecationWarned;
+    constructor(options = {}) {
+        this.plugins = new Map();
+        this.clients = new Map();
+        this._connecting = new Map();
+        this._deprecationWarned = new Set();
+        this._logger = options.logger ?? {
+            info: (...args) => console.log("[PluginManager]", ...args),
+            warn: (...args) => console.warn("[PluginManager]", ...args),
+            error: (...args) => console.error("[PluginManager]", ...args),
+        };
+    }
+    register(plugins) {
+        if (!plugins || !Array.isArray(plugins))
+            return;
+        // Build set of existing inject names (both inject and injectAs)
+        const injectNames = new Set();
+        for (const [, p] of this.plugins) {
+            if (p.inject)
+                injectNames.add(p.inject);
+            if (p.injectAs)
+                injectNames.add(p.injectAs);
+        }
+        const optionalFns = [
+            "validate",
+            "env",
+            "healthCheck",
+            "disconnect",
+            "nginx",
+            "metrics",
+            "middleware",
+            "onWsUpgrade",
+            "onWsConnect",
+            "onWsMessage",
+            "onWsClose",
+        ];
+        for (const plugin of plugins) {
+            if (!plugin.name)
+                throw new Error("Plugin must have a name");
+            if (!plugin.inject)
+                throw new Error(`Plugin "${plugin.name}" must have an inject property`);
+            if (!plugin.connect)
+                throw new Error(`Plugin "${plugin.name}" must have a connect() method`);
+            for (const optionalFn of optionalFns) {
+                if (plugin[optionalFn] !== undefined && typeof plugin[optionalFn] !== "function") {
+                    throw new Error(`Plugin "${plugin.name}" optional hook "${optionalFn}" must be a function`);
+                }
+            }
+            if (this.plugins.has(plugin.name)) {
+                throw new Error(`Duplicate plugin: "${plugin.name}"`);
+            }
+            const primaryInject = plugin.injectAs ?? plugin.inject;
+            if (injectNames.has(primaryInject)) {
+                throw new Error(`Duplicate plugin inject name: "${primaryInject}"`);
+            }
+            injectNames.add(primaryInject);
+            if (plugin.injectAs && plugin.inject !== plugin.injectAs) {
+                injectNames.add(plugin.inject);
+            }
+            this.plugins.set(plugin.name, plugin);
+        }
+    }
+    validate() {
+        for (const [name, plugin] of this.plugins) {
+            if (plugin.validate) {
+                try {
+                    plugin.validate();
+                }
+                catch (err) {
+                    throw new Error(`Plugin "${name}" validation failed: ${err.message}`);
+                }
+            }
+        }
+    }
+    env() {
+        const merged = {};
+        for (const [, plugin] of this.plugins) {
+            if (plugin.env) {
+                const pluginEnv = plugin.env();
+                for (const key of Object.keys(pluginEnv)) {
+                    if (merged[key] !== undefined) {
+                        throw new Error(`Plugin env var conflict: "${key}" is set by multiple plugins`);
+                    }
+                }
+                Object.assign(merged, pluginEnv);
+            }
+        }
+        return merged;
+    }
+    async connectForService(servicePlugins, ctx) {
+        const clients = new Map();
+        // If service doesn't specify plugins, connect ALL registered plugins
+        const pluginNames = servicePlugins ?? [...this.plugins.keys()];
+        // H-PLUGIN-2: Connect independent plugins in parallel for faster startup.
+        // Separate into cached/in-flight (resolved immediately) and fresh (connected concurrently).
+        const pendingConnects = [];
+        for (const name of pluginNames) {
+            const plugin = this.plugins.get(name);
+            if (!plugin) {
+                ctx.logger.warn(`Plugin "${name}" not registered, skipping`);
+                continue;
+            }
+            // Reuse existing connection if already connected in this worker
+            if (this.clients.has(name)) {
+                const cached = this.clients.get(name);
+                if (isPluginError(cached)) {
+                    const attempts = cached.attempts ?? 0;
+                    const retryAfterMs = Math.min(5000 * 2 ** attempts, 30000);
+                    if (Date.now() - cached.timestamp < retryAfterMs) {
+                        const errMsg = cached.errorMessage;
+                        const errorProxy = new Proxy({}, {
+                            get(_, prop) {
+                                if (prop === "then")
+                                    return undefined;
+                                throw new Error(`Plugin "${name}" is unavailable (connection failed: ${errMsg})`);
+                            },
+                        });
+                        this._setClientWithDeprecation(clients, plugin, errorProxy, ctx);
+                        continue;
+                    }
+                    this.clients.delete(name);
+                }
+                else if (cached !== null) {
+                    this._setClientWithDeprecation(clients, plugin, cached, ctx);
+                    continue;
+                }
+            }
+            // C-PLUGIN-2: Prevent double-connect — join in-flight connection
+            if (this._connecting.has(name)) {
+                pendingConnects.push({ name, plugin, promise: this._connecting.get(name), isJoin: true });
+                continue;
+            }
+            // Fresh connection — launch now, await later (parallel)
+            const connectPromise = (async () => {
+                const startTime = performance.now();
+                const client = await withTimeout(plugin.connect(ctx), CONNECT_TIMEOUT, `Plugin "${name}" connect`);
+                const duration = performance.now() - startTime;
+                ctx.metrics?.histogram?.("forge_plugin_connect_duration_ms", duration, { plugin: name, status: "success" });
+                return client;
+            })();
+            this._connecting.set(name, connectPromise);
+            pendingConnects.push({ name, plugin, promise: connectPromise, isJoin: false });
+        }
+        // Await all pending connections concurrently
+        const results = await Promise.allSettled(pendingConnects.map((p) => p.promise));
+        for (let i = 0; i < pendingConnects.length; i++) {
+            const { name, plugin, isJoin } = pendingConnects[i];
+            const result = results[i];
+            if (result.status === "fulfilled") {
+                const client = result.value;
+                if (!isJoin) {
+                    this.clients.set(name, client);
+                    const primaryKey = plugin.injectAs ?? plugin.inject;
+                    ctx.logger.info(`Plugin connected: ${name}`, { inject: `this.${primaryKey}` });
+                }
+                this._setClientWithDeprecation(clients, plugin, client, ctx);
+            }
+            else {
+                const err = result.reason;
+                if (!isJoin) {
+                    ctx.metrics?.increment?.("forge_plugin_connect_failures_total", { plugin: name });
+                    ctx.logger.warn(`Plugin "${name}" connect failed (degraded mode): ${err.message}`);
+                    const prevCached = this.clients.get(name);
+                    const attempts = (isPluginError(prevCached) ? (prevCached.attempts ?? 0) : 0) + 1;
+                    this.clients.set(name, {
+                        _pluginError: true,
+                        timestamp: Date.now(),
+                        errorMessage: err.message,
+                        attempts,
+                    });
+                }
+                const pluginName = name;
+                const errMsg = err.message;
+                const errorProxy = new Proxy({}, {
+                    get(_, prop) {
+                        if (prop === Symbol.toPrimitive || prop === "then" || prop === Symbol.iterator)
+                            return undefined;
+                        throw new Error(`Plugin "${pluginName}" is unavailable (connect failed: ${errMsg}). Check your ${pluginName} configuration.`);
+                    },
+                });
+                this._setClientWithDeprecation(clients, plugin, errorProxy, ctx);
+            }
+            if (!isJoin)
+                this._connecting.delete(name);
+        }
+        return clients;
+    }
+    async healthCheck() {
+        const results = {};
+        for (const [name, plugin] of this.plugins) {
+            const client = this.clients.get(name);
+            if (!client || isPluginError(client)) {
+                results[name] = this.clients.has(name)
+                    ? { status: "error", error: "Plugin failed to connect" }
+                    : { status: "not-checked" };
+                continue;
+            }
+            if (!plugin.healthCheck) {
+                results[name] = { status: "unknown" };
+                continue;
+            }
+            try {
+                results[name] = await withTimeout(plugin.healthCheck(client), HEALTH_TIMEOUT, `Plugin "${name}" healthCheck`);
+            }
+            catch (err) {
+                results[name] = { status: "error", error: err.message };
+            }
+        }
+        return results;
+    }
+    collectMetrics(metricsCollector) {
+        for (const [name, plugin] of this.plugins) {
+            const client = this.clients.get(name);
+            if (!client || !plugin.metrics)
+                continue;
+            try {
+                const pluginMetrics = plugin.metrics(client);
+                for (const [key, value] of Object.entries(pluginMetrics)) {
+                    metricsCollector.gauge(`forge_plugin_${name}_${key}`, value);
+                }
+            }
+            catch (err) {
+                this._logger?.warn?.(`Plugin metrics collection failed`, { error: err.message });
+            }
+        }
+    }
+    async disconnectAll(logger) {
+        const errors = [];
+        for (const [name, plugin] of this.plugins) {
+            const client = this.clients.get(name);
+            if (!client || isPluginError(client)) {
+                this.clients.delete(name);
+                continue;
+            }
+            try {
+                if (plugin.disconnect) {
+                    await withTimeout(plugin.disconnect(client), DISCONNECT_TIMEOUT, `Plugin "${name}" disconnect`);
+                }
+                logger?.info(`Plugin disconnected: ${name}`);
+            }
+            catch (err) {
+                errors.push({ name, error: err.message });
+                logger?.error(`Plugin "${name}" disconnect failed: ${err.message}`);
+                // Force cleanup as best effort
+                try {
+                    const c = client;
+                    if (typeof c.end === "function")
+                        await c.end().catch(() => { });
+                    else if (typeof c.quit === "function")
+                        await c.quit().catch(() => { });
+                    else if (typeof c.destroy === "function")
+                        c.destroy();
+                }
+                catch {
+                    // intentionally empty
+                }
+            }
+            this.clients.delete(name);
+        }
+        return errors;
+    }
+    /**
+     * Set client on the result map under the primary inject key (injectAs ?? inject).
+     * If the plugin defines injectAs and it differs from inject, also set a deprecation
+     * proxy under the legacy inject key that logs a warning on first access.
+     */
+    _setClientWithDeprecation(clients, plugin, client, ctx) {
+        const primaryKey = plugin.injectAs ?? plugin.inject;
+        clients.set(primaryKey, client);
+        // Legacy alias with deprecation warning
+        if (plugin.injectAs && plugin.inject !== plugin.injectAs) {
+            const legacyKey = plugin.inject;
+            const warned = this._deprecationWarned;
+            const logger = ctx.logger;
+            const newKey = plugin.injectAs;
+            const deprecationProxy = new Proxy({}, {
+                get(_, prop) {
+                    if (!warned.has(legacyKey)) {
+                        warned.add(legacyKey);
+                        logger.warn(`Plugin "${plugin.name}": this.${legacyKey} is deprecated, use this.${newKey} instead`);
+                    }
+                    return client[prop];
+                },
+            });
+            clients.set(legacyKey, deprecationProxy);
+        }
+    }
+    nginxBlocks() {
+        const blocks = { upstreams: [], locations: [] };
+        for (const [, plugin] of this.plugins) {
+            if (!plugin.nginx)
+                continue;
+            const nginx = plugin.nginx();
+            if (nginx.upstreams)
+                blocks.upstreams.push(...nginx.upstreams);
+            if (nginx.locations)
+                blocks.locations.push(...nginx.locations);
+        }
+        return blocks;
+    }
+    getMiddleware(servicePlugins) {
+        const middleware = [];
+        const names = servicePlugins ?? [...this.plugins.keys()];
+        for (const name of names) {
+            const plugin = this.plugins.get(name);
+            const client = this.clients.get(name);
+            if (!plugin?.middleware || !client)
+                continue;
+            middleware.push(plugin.middleware(client));
+        }
+        return middleware;
+    }
+    getWebSocketHooks(servicePlugins) {
+        const hooks = [];
+        const names = servicePlugins ?? [...this.plugins.keys()];
+        for (const name of names) {
+            const plugin = this.plugins.get(name);
+            const client = this.clients.get(name);
+            if (!plugin || !client)
+                continue;
+            if (isPluginError(client))
+                continue;
+            if (!plugin.onWsUpgrade && !plugin.onWsConnect && !plugin.onWsMessage && !plugin.onWsClose)
+                continue;
+            hooks.push({
+                name,
+                onWsUpgrade: plugin.onWsUpgrade ? (ctx) => plugin.onWsUpgrade(client, ctx) : undefined,
+                onWsConnect: plugin.onWsConnect ? (ctx) => plugin.onWsConnect(client, ctx) : undefined,
+                onWsMessage: plugin.onWsMessage ? (ctx) => plugin.onWsMessage(client, ctx) : undefined,
+                onWsClose: plugin.onWsClose ? (ctx) => plugin.onWsClose(client, ctx) : undefined,
+            });
+        }
+        return hooks;
+    }
+}
+//# sourceMappingURL=PluginManager.js.map

package/dist/plugins/PluginManager.js.map

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