@topogram/cli 0.3.59 → 0.3.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topogram/cli",
-  "version": "0.3.59",
+  "version": "0.3.60",
   "description": "Topogram CLI for checking Topogram workspaces and generating app bundles.",
   "license": "Apache-2.0",
   "repository": {

package/src/generator/adapters.js

@@ -182,7 +182,8 @@ function buildContractsForContext(context) {
   }
   if (surface === "native" || surface === "ios_surface" || surface === "android_surface") {
     return {
-      uiSurface: generateUiSurfaceContract(context.graph, { ...(context.options || {}), projectionId })
+      uiSurface: generateUiSurfaceContract(context.graph, { ...(context.options || {}), projectionId }),
+      api: generateApiContractGraph(context.graph, {})
     };
   }
   return {};

package/src/generator/runtime/compile-check.js

@@ -1,4 +1,5 @@
 import {
+  generateNativeBundle,
   generateServerBundle,
   generateWebBundle,
   getDefaultEnvironmentProjections,
@@ -49,6 +50,12 @@ function buildCompileCheckPlan(graph, options = {}) {
       command: "npm run build"
     }
   ]);
+  const nativeChecks = topology.nativeRuntimes.map((component, index) => ({
+    id: index === 0 ? "native_swift_build" : `native_swift_build_${component.id}`,
+    cwd: topology.nativeDir(component),
+    install: null,
+    command: "swift build"
+  }));
   return {
     type: "compile_check_plan",
     name: compileCheckName(graph, options),
@@ -65,7 +72,7 @@ function buildCompileCheckPlan(graph, options = {}) {
         generator: runtime.generator
       }))
     },
-    checks: [...apiChecks, ...webChecks]
+    checks: [...apiChecks, ...webChecks, ...nativeChecks]
   };
 }
 
@@ -92,13 +99,14 @@ ${runtimeReference.environment.envExample || ""}
 function renderCompileCheckReadme(graph, options = {}) {
   return `# ${compileCheckName(graph, options).replace("Plan", "Bundle")}
 
-This bundle verifies that the generated server and web projects typecheck and build.
+This bundle verifies that generated server, web, and native projects compile.
 
 ## Checks
 
 - server TypeScript check
 - web TypeScript check
 - web production build
+- native Swift build
 
 ## Usage
 
@@ -124,15 +132,17 @@ function renderCompileCheckScript(plan) {
     ""
   ];
   if (plan.checks.length === 0) {
-    lines.push('echo "No API or web runtimes are configured; compile check is a no-op."');
+    lines.push('echo "No API, web, or native runtimes are configured; compile check is a no-op."');
   }
   for (const check of plan.checks) {
     const label = check.id.includes("web")
       ? check.id.includes("build") ? "Building generated web" : "Checking generated web"
-      : "Checking generated server";
+      : check.id.includes("native") ? "Building generated native app" : "Checking generated server";
     lines.push(`echo "${label} (${check.cwd})..."`);
-    lines.push(`echo "Installing dependencies (${check.cwd})..."`);
-    lines.push(`(cd "$ROOT_DIR/${check.cwd}" && ${check.install})`);
+    if (check.install) {
+      lines.push(`echo "Installing dependencies (${check.cwd})..."`);
+      lines.push(`(cd "$ROOT_DIR/${check.cwd}" && ${check.install})`);
+    }
     lines.push(`echo "Running ${check.command} (${check.cwd})..."`);
     lines.push(`(cd "$ROOT_DIR/${check.cwd}" && ${check.command})`);
     lines.push("");
@@ -158,6 +168,10 @@ export function generateCompileCheckBundle(graph, options = {}) {
     const webBundle = generateWebBundle(graph, component.projection.id, { ...options, component });
     mergeBundleFiles(files, topology.webDir(component), webBundle);
   }
+  for (const component of topology.nativeRuntimes) {
+    const nativeBundle = generateNativeBundle(graph, component.projection.id, { ...options, component });
+    mergeBundleFiles(files, topology.nativeDir(component), nativeBundle);
+  }
   return files;
 }
 

package/src/generator/runtime/environment.js

@@ -2,6 +2,7 @@ import { generateDbLifecyclePlan } from "../surfaces/databases/lifecycle-shared.
 import { getExampleImplementation } from "../../example-implementation.js";
 import {
   generateDbBundle,
+  generateNativeBundle,
   generateServerBundle,
   generateWebBundle,
   dbEnvVarsForComponent,
@@ -110,6 +111,7 @@ function buildEnvironmentPlan(graph, options = {}) {
       server: topology.primaryApi ? topology.serviceDir(topology.primaryApi) : null,
       web: topology.primaryWeb ? topology.webDir(topology.primaryWeb) : null,
       db: topology.primaryDb ? topology.dbDir(topology.primaryDb) : null,
+      native: topology.nativeRuntimes[0] ? topology.nativeDir(topology.nativeRuntimes[0]) : null,
       scripts: "scripts"
     },
     runtimes: {
@@ -130,6 +132,12 @@ function buildEnvironmentPlan(graph, options = {}) {
         dir: topology.webDir(component),
         uses_api: component.api
       })),
+      natives: topology.nativeRuntimes.map((component) => ({
+        id: component.id,
+        projection: component.projection.id,
+        dir: topology.nativeDir(component),
+        uses_api: component.api
+      })),
       databases: topology.dbRuntimes.map((component) => ({
         id: component.id,
         projection: component.projection.id,
@@ -273,6 +281,7 @@ function renderEnvironmentReadme(plan) {
   const hasDb = plan.runtimes.databases.length > 0;
   const hasApi = plan.runtimes.apis.length > 0;
   const hasWeb = plan.runtimes.webs.length > 0;
+  const hasNative = plan.runtimes.natives.length > 0;
   const localProcessNotes = !hasDb
     ? "- This bundle has no generated database surface."
     : plan.projections.db.engine === "sqlite"
@@ -294,7 +303,7 @@ ${localProcessNotes}
 
 This bundle packages the generated runtime into one local environment:
 
-${hasApi ? "- `services/<api-id>/`: generated API service scaffolds\n" : ""}${hasWeb ? `- \`web/<web-id>/\`: generated ${plan.runtimeProfiles.web === "react" ? "Vite + React Router" : plan.runtimeProfiles.web === "vanilla" ? "vanilla HTML/CSS/JS" : "SvelteKit"} web scaffolds\n` : ""}${hasDb ? "- `db/<db-id>/`: generated DB lifecycle bundles\n" : ""}${plan.files.dockerCompose ? `- \`${plan.files.dockerCompose}\`: local Postgres container` : hasDb ? (plan.projections.db.engine === "sqlite" ? "- local SQLite file orchestration (no Docker files generated)" : "- local-process Postgres orchestration (no Docker files generated)") : "- no DB orchestration is generated"}
+${hasApi ? "- `services/<api-id>/`: generated API service scaffolds\n" : ""}${hasWeb ? `- \`web/<web-id>/\`: generated ${plan.runtimeProfiles.web === "react" ? "Vite + React Router" : plan.runtimeProfiles.web === "vanilla" ? "vanilla HTML/CSS/JS" : "SvelteKit"} web scaffolds\n` : ""}${hasNative ? "- `native/<native-id>/`: generated native app scaffolds\n" : ""}${hasDb ? "- `db/<db-id>/`: generated DB lifecycle bundles\n" : ""}${plan.files.dockerCompose ? `- \`${plan.files.dockerCompose}\`: local Postgres container` : hasDb ? (plan.projections.db.engine === "sqlite" ? "- local SQLite file orchestration (no Docker files generated)" : "- local-process Postgres orchestration (no Docker files generated)") : "- no DB orchestration is generated"}
 
 ## Quick Start
 
@@ -318,6 +327,7 @@ ${dockerSection}
 
 - ${hasApi && hasDb ? `The generated server expects ${plan.projections.db.engine === "sqlite" ? "SQLite plus Prisma." : "Postgres plus Prisma."}` : hasApi ? "The generated server is stateless." : "No server surface is generated."}
 - ${hasWeb && hasApi ? "The generated web app talks to `PUBLIC_TOPOGRAM_API_BASE_URL`." : hasWeb ? "The generated web app is standalone." : "No web surface is generated."}
+- ${hasNative ? "Native app scaffolds use the same UI surface contracts as web surfaces." : "No native surface is generated."}
 - If \`.env\` is missing, generated scripts fall back to \`.env.example\`.
 - The DB lifecycle scripts remain the source of truth for greenfield bootstrap and brownfield migration.
 `;
@@ -635,6 +645,12 @@ export function generateEnvironmentBundle(graph, options = {}) {
       [topology.webDir(component)]: webBundle
     });
   }
+  for (const component of topology.nativeRuntimes) {
+    const nativeBundle = generateNativeBundle(graph, component.projection.id, { ...options, component });
+    mergeNamedBundles(files, {
+      [topology.nativeDir(component)]: nativeBundle
+    });
+  }
   for (const component of topology.dbRuntimes) {
     const dbBundle = generateDbBundle(graph, component.projection.id, { ...options, component });
     mergeNamedBundles(files, {

package/src/generator/runtime/shared.js

@@ -43,16 +43,19 @@ import { defaultProjectConfigForGraph, validateProjectConfig } from "../../proje
  * @property {RuntimeComponent[]} runtimes
  * @property {RuntimeComponent[]} apiRuntimes
  * @property {RuntimeComponent[]} webRuntimes
+ * @property {RuntimeComponent[]} nativeRuntimes
  * @property {RuntimeComponent[]} dbRuntimes
  * @property {RuntimeComponent[]} components Legacy alias for runtimes.
  * @property {RuntimeComponent[]} apiComponents Legacy alias for apiRuntimes.
  * @property {RuntimeComponent[]} webComponents Legacy alias for webRuntimes.
+ * @property {RuntimeComponent[]} nativeComponents Legacy alias for nativeRuntimes.
  * @property {RuntimeComponent[]} dbComponents Legacy alias for dbRuntimes.
  * @property {RuntimeComponent|null} primaryApi
  * @property {RuntimeComponent|null} primaryWeb
  * @property {RuntimeComponent|null} primaryDb
  * @property {(component: RuntimeComponent) => string} serviceDir
  * @property {(component: RuntimeComponent) => string} webDir
+ * @property {(component: RuntimeComponent) => string} nativeDir
  * @property {(component: RuntimeComponent) => string} dbDir
  */
 
@@ -371,6 +374,29 @@ export function generateWebBundle(graph, projectionId, options = {}) {
   }).files;
 }
 
+/**
+ * @param {ResolvedGraph} graph
+ * @param {string} projectionId
+ * @param {RuntimeGenerationOptions} [options]
+ * @returns {any}
+ */
+export function generateNativeBundle(graph, projectionId, options = {}) {
+  const topology = resolveRuntimeTopology(graph, options);
+  const runtime = options.runtime || options.component || topology.nativeRuntimes.find((entry) => entry.projection.id === projectionId);
+  if (!runtime) {
+    throw new Error(`No native runtime found for projection '${projectionId}'`);
+  }
+  return generateWithComponentGenerator({
+    graph,
+    projection: runtime.projection,
+    runtime,
+    component: runtime,
+    topology,
+    implementation: options.implementation || null,
+    options: { ...options, projectionId }
+  }).files;
+}
+
 /**
  * @param {ResolvedGraph} graph
  * @param {string} projectionId
@@ -450,7 +476,7 @@ function decorateRuntimes(graph, config) {
       runtime.databaseRuntime = byId.get(runtime.database) || null;
       runtime.databaseComponent = runtime.databaseRuntime;
     }
-    if (runtime.kind === "web_surface" && runtime.api) {
+    if (["web_surface", "ios_surface", "android_surface"].includes(runtime.kind) && runtime.api) {
       runtime.apiRuntime = byId.get(runtime.api) || null;
       runtime.apiComponent = runtime.apiRuntime;
     }
@@ -475,6 +501,7 @@ export function resolveRuntimeTopology(graph, options = {}) {
   const runtimes = decorateRuntimes(graph, config);
   const apiRuntimes = runtimes.filter((runtime) => runtime.kind === "api_service");
   const webRuntimes = runtimes.filter((runtime) => runtime.kind === "web_surface");
+  const nativeRuntimes = runtimes.filter((runtime) => runtime.kind === "ios_surface" || runtime.kind === "android_surface");
   const dbRuntimes = runtimes.filter((runtime) => runtime.kind === "database");
   const primaryApi = apiRuntimes[0] || null;
   const primaryWeb = webRuntimes[0] || null;
@@ -486,9 +513,11 @@ export function resolveRuntimeTopology(graph, options = {}) {
     components: runtimes,
     apiRuntimes,
     webRuntimes,
+    nativeRuntimes,
     dbRuntimes,
     apiComponents: apiRuntimes,
     webComponents: webRuntimes,
+    nativeComponents: nativeRuntimes,
     dbComponents: dbRuntimes,
     primaryApi,
     primaryWeb,
@@ -499,6 +528,9 @@ export function resolveRuntimeTopology(graph, options = {}) {
     webDir(component) {
       return `web/${component.id}`;
     },
+    nativeDir(component) {
+      return `native/${component.id}`;
+    },
     dbDir(component) {
       return `db/${component.id}`;
     }