threadforge 0.1.1 → 0.2.1

package/src/deploy/PlatformManifestGenerator.js

@@ -1,96 +0,0 @@
-/**
- * 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

@@ -1,112 +0,0 @@
-/**
- * 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;
-}