threadforge 0.1.1 → 0.2.1

package/dist/deploy/NginxGenerator.d.ts

@@ -0,0 +1,165 @@
+import { type ServiceType as ServiceTypeValue } from "../core/config-enums.js";
+/**
+ * Nginx Config Generator v2
+ *
+ * Routes ingress traffic through ForgeProxy.
+ * ForgeProxy handles route matching + policy enforcement.
+ *
+ *   /api/users/*    -> ForgeProxy -> users service
+ *   /api/billing/*  -> ForgeProxy -> billing service
+ *   /auth/*         -> ForgeProxy -> auth service
+ *
+ * nginx forwards requests to ForgeProxy and preserves request metadata.
+ *
+ * Service prefix ordering still matters for nginx location block matching.
+ */
+interface Upstream {
+    host: string;
+    port: number;
+}
+interface NginxService {
+    prefix: string | null;
+    port?: number;
+    upstreams?: Upstream[];
+    type?: ServiceTypeValue;
+}
+interface SslConfig {
+    cert: string;
+    key: string;
+}
+interface RateLimits {
+    requestsPerSecond?: number;
+    authPerSecond?: number;
+    burst?: number;
+    authBurst?: number;
+    maxConnsPerIP?: number;
+}
+interface PluginLocation {
+    path: string;
+    config: string;
+}
+interface WebSocketRoute {
+    path: string;
+    service: string;
+}
+interface ForgeProxyConfig {
+    enabled?: boolean;
+    host?: string;
+    port?: number;
+    keepalive?: number;
+}
+interface NginxConfigOptions {
+    domain?: string;
+    services?: Record<string, NginxService>;
+    ssl?: SslConfig;
+    rateLimits?: RateLimits;
+    staticDir?: string;
+    websockets?: boolean;
+    websocketPaths?: string[];
+    websocketRoutes?: WebSocketRoute[];
+    maxBodySize?: number;
+    forgeProxy?: boolean | ForgeProxyConfig | null;
+    trustedProxies?: string[];
+    pluginLocations?: PluginLocation[];
+}
+interface ManifestNode {
+    host: string;
+    services: string[];
+    role?: string;
+}
+interface DeployManifest {
+    nodes: Record<string, ManifestNode>;
+}
+interface WebSocketConfig {
+    enabled?: boolean;
+    paths?: string[];
+}
+interface ServiceConfig {
+    type?: ServiceTypeValue;
+    port?: number;
+    prefix?: string | null;
+    websocket?: boolean | string[] | WebSocketConfig;
+}
+interface LegacyWebSocketOptions {
+    websockets?: boolean;
+    websocketPaths?: string[];
+}
+interface StaticMount {
+    dir: string;
+    basePath?: string;
+    spaFallback?: boolean;
+    cachePolicy?: "immutable" | "none" | "short";
+    siteId?: string;
+    domains?: string[];
+}
+interface AppConfig {
+    domains?: string[];
+    domain?: string;
+    ssl?: SslConfig | null;
+    static?: string | null;
+    staticMounts?: StaticMount[];
+    services?: string[];
+    frontend?: {
+        basePath?: string;
+        outDir?: string;
+        spaFallback?: boolean;
+    } | null;
+}
+interface HostMetaEntry {
+    domain?: string;
+    services: string[];
+}
+interface PlatformNginxOptions {
+    apps?: Record<string, AppConfig>;
+    services?: Record<string, NginxService>;
+    hostMeta?: Record<string, HostMetaEntry>;
+    defaultSsl?: SslConfig | null;
+    maxBodySize?: number;
+    forgeProxy?: boolean | ForgeProxyConfig | null;
+}
+interface HostNginxOptions {
+    hostMeta: Record<string, HostMetaEntry>;
+    services: Record<string, NginxService>;
+    ssl?: SslConfig;
+    maxBodySize?: number;
+    forgeProxy?: boolean | ForgeProxyConfig | null;
+}
+/**
+ * Generate nginx.conf for a standard (non-platform) deployment.
+ */
+export declare function generateNginxConfig(options?: NginxConfigOptions): string;
+/**
+ * Build the nginx service map from a deployment manifest.
+ *
+ * Scans the manifest and service configs to determine:
+ *   - Which services are edge (need nginx routing)
+ *   - Their prefixes
+ *   - Their upstream addresses (host:port per node)
+ */
+export declare function buildNginxServiceMap(manifest: DeployManifest, serviceConfigs: Record<string, ServiceConfig>, deployPorts?: Record<string, number>): Record<string, NginxService>;
+/**
+ * Build websocket route mappings from per-service websocket config.
+ *
+ * Supports service-level config forms:
+ *   websocket: true
+ *   websocket: ["/ws", "/ws/chat"]
+ *   websocket: { enabled: true, paths: ["/ws"] }
+ */
+export declare function buildNginxWebSocketRoutes(serviceConfigs: Record<string, ServiceConfig>, nginxServices: Record<string, NginxService>, legacy?: LegacyWebSocketOptions): WebSocketRoute[];
+/**
+ * Generate an nginx config for ForgeHost with per-project server blocks.
+ *
+ * Each project gets its own `server { server_name ... }` block. Requests
+ * are forwarded to ForgeProxy, with X-Forge-Project injected per host block.
+ */
+export declare function generateHostNginxConfig(options: HostNginxOptions): string;
+/**
+ * Generate an nginx config for Platform Mode with per-domain TLS,
+ * per-app static dirs, shared auth mount, and X-Forwarded-Host.
+ *
+ * Each app gets its own `server { server_name ... }` block with
+ * individual SSL certificates (defaults to Let's Encrypt paths).
+ */
+export declare function generatePlatformNginxConfig(options?: PlatformNginxOptions): string;
+export {};
+//# sourceMappingURL=NginxGenerator.d.ts.map

package/dist/deploy/NginxGenerator.d.ts.map

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