threadforge 0.1.0

package/src/deploy/PlatformManifestGenerator.js

@@ -0,0 +1,96 @@
+/**
+ * Platform Manifest Generator
+ *
+ * Generates a `routes/platform.yaml` manifest for ForgeProxy
+ * that describes the platform topology: apps, domains, shared services.
+ *
+ * ForgeProxy already loads `routes/*.yaml` with `host` and `project_id`
+ * fields — this file is supplementary metadata for tooling.
+ */
+
+import { resolveAppDomains } from "../core/platform-config.js";
+
+function yamlString(value) {
+  const text = String(value ?? "");
+  return `'${text.replace(/'/g, "''")}'`;
+}
+
+function yamlArray(values = []) {
+  return `[${values.map((value) => yamlString(value)).join(", ")}]`;
+}
+
+/**
+ * Generate a platform.yaml manifest.
+ *
+ * @param {Object} platformConfig - The platform block from the user config
+ * @param {Object} hostMeta - From resolveHostConfig().hostMeta
+ * @param {Object} [sites] - From resolveHostConfig().sites
+ * @returns {string} YAML string
+ */
+export function generatePlatformManifest(platformConfig, hostMeta, sites = {}) {
+  const apps = platformConfig.apps ?? {};
+  const globalAuth = platformConfig.globalAuth ?? false;
+
+  let yaml = `# Auto-generated by: forge platform generate\n`;
+  yaml += `# Do not edit — regenerate with: forge platform generate\n\n`;
+
+  yaml += `apps:\n`;
+  for (const [appId, app] of Object.entries(apps)) {
+    const domains = resolveAppDomains(app);
+    const meta = hostMeta?.[appId];
+
+    yaml += `  ${appId}:\n`;
+    yaml += `    domains: ${yamlArray(domains)}\n`;
+
+    // Reference per-service route manifests
+    if (meta?.services?.length > 0) {
+      const routeFiles = meta.services.map((s) => `routes/${s.replace(/:/g, "_")}.yaml`);
+      if (routeFiles.length === 1) {
+        yaml += `    routes: ${yamlString(routeFiles[0])}\n`;
+      } else {
+        yaml += `    routes:\n`;
+        for (const f of routeFiles) {
+          yaml += `      - ${yamlString(f)}\n`;
+        }
+      }
+    }
+
+    if (globalAuth) {
+      yaml += `    auth_required: true\n`;
+      yaml += `    public_paths: ${yamlArray(["/auth/*", "/public/*"])}\n`;
+    }
+
+    if (app.static) {
+      yaml += `    static: ${yamlString(app.static)}\n`;
+    }
+
+    const site = sites?.[appId];
+    if (site?.frontend) {
+      yaml += `    frontend:\n`;
+      yaml += `      plugin: ${yamlString(site.frontend.plugin)}\n`;
+      yaml += `      base_path: ${yamlString(site.frontend.basePath)}\n`;
+      yaml += `      out_dir: ${yamlString(site.frontend.outDir)}\n`;
+      yaml += `      spa_fallback: ${site.frontend.spaFallback ? "true" : "false"}\n`;
+    }
+  }
+
+  // Shared services section (auth + identity when globalAuth is enabled)
+  if (globalAuth) {
+    const sharedEntries = [
+      { name: "auth", prefix: "/auth", mountOnAll: true },
+      { name: "identity", prefix: "/identity", mountOnAll: false },
+    ];
+
+    yaml += `\nshared_services:\n`;
+    for (const entry of sharedEntries) {
+      yaml += `  ${entry.name}:\n`;
+      yaml += `    routes: ${yamlString(`routes/${entry.name}.yaml`)}\n`;
+      if (entry.mountOnAll) {
+        yaml += `    mount_on_all_apps: true\n`;
+      }
+      yaml += `    prefix: ${yamlString(entry.prefix)}\n`;
+    }
+  }
+
+  return yaml;
+}

package/src/deploy/RouteManifestGenerator.js

@@ -0,0 +1,112 @@
+/**
+ * Route Manifest Generator
+ *
+ * Reads service classes, extracts route + internal method declarations,
+ * and generates YAML route manifests for ForgeProxy.
+ *
+ * `forge generate` produces:
+ *
+ *   # routes/users.yaml
+ *   service: users
+ *   prefix: /api/users
+ *   auth: required
+ *   rate_limit: 1000/min
+ *
+ *   routes:
+ *     - method: GET
+ *       path: /:id
+ *       handler: getUser
+ *
+ *   # Backend-only methods (callable via IPC, not via HTTP)
+ *   internal_methods:
+ *     - name: validatePassword
+ *       local_only: true   # zero-copy, same-process only
+ */
+
+import { getContract, getInternalMethods } from "../decorators/index.js";
+
+/**
+ * Generate a route manifest for a single service.
+ */
+export function generateRouteManifest(serviceName, ServiceClass, serviceConfig = {}) {
+  const contract = getContract(ServiceClass);
+  if (!contract || (contract.routes.length === 0 && contract.methods.size === 0)) return null;
+
+  const prefix = ServiceClass.prefix ?? serviceConfig.prefix ?? `/${serviceName}`;
+  const auth = ServiceClass.auth ?? serviceConfig.auth ?? "required";
+  const rateLimit = ServiceClass.rateLimit ?? serviceConfig.rateLimit ?? null;
+
+  let yaml = `# Auto-generated by: forge generate\n`;
+  yaml += `# Source: ${serviceName} service\n`;
+  yaml += `# Do not edit — regenerate with: forge generate\n\n`;
+  yaml += `service: '${serviceName}'\n`;
+  yaml += `prefix: '${prefix}'\n`;
+  yaml += `auth: '${auth}'\n`;
+
+  if (rateLimit) {
+    yaml += `rate_limit: '${rateLimit}'\n`;
+  }
+
+  // Multi-project host fields
+  if (serviceConfig._projectId) {
+    yaml += `project_id: '${serviceConfig._projectId}'\n`;
+  }
+  if (serviceConfig._hostDomain) {
+    yaml += `host: '${serviceConfig._hostDomain}'\n`;
+  }
+
+  // HTTP routes (ForgeProxy handles these)
+  if (contract.routes.length > 0) {
+    yaml += `\nroutes:\n`;
+    for (const route of contract.routes) {
+      if (ServiceClass.prototype && typeof ServiceClass.prototype[route.handlerName] !== "function") {
+        console.warn(
+          `[Deploy] Route handler "${route.handlerName}" for ${route.httpMethod} ${route.path} ` +
+          `does not exist on ${serviceName}. Check contract definition.`,
+        );
+      }
+
+      yaml += `  - method: ${route.httpMethod}\n`;
+      yaml += `    path: ${route.path}\n`;
+      yaml += `    handler: ${route.handlerName}\n`;
+
+      if (route.auth && route.auth !== auth) {
+        yaml += `    auth: ${route.auth}\n`;
+      }
+      if (route.rateLimit) {
+        yaml += `    rate_limit: ${route.rateLimit}\n`;
+      }
+      if (route.cacheSecs) {
+        yaml += `    cache_secs: ${route.cacheSecs}\n`;
+      }
+    }
+  }
+
+  // Internal methods (backend-only, not routed via HTTP)
+  const internalMethods = getInternalMethods(ServiceClass);
+  if (internalMethods.length > 0) {
+    yaml += `\n# Backend-only methods (callable via IPC, not via HTTP)\n`;
+    yaml += `internal_methods:\n`;
+    for (const method of internalMethods) {
+      const meta = contract.methods.get(method);
+      yaml += `  - name: ${method}\n`;
+      if (meta?.options?.localOnly) {
+        yaml += `    local_only: true\n`;
+      }
+    }
+  }
+
+  return yaml;
+}
+
+/**
+ * Generate route manifests for all services.
+ */
+export function generateAllRouteManifests(serviceClasses, serviceConfigs = {}) {
+  const manifests = new Map();
+  for (const [name, ServiceClass] of Object.entries(serviceClasses)) {
+    const yaml = generateRouteManifest(name, ServiceClass, serviceConfigs[name] ?? {});
+    if (yaml) manifests.set(name, yaml);
+  }
+  return manifests;
+}