@topogram/cli 0.3.34

package/src/generator/surfaces/databases/sqlite/sql-migration.js

@@ -0,0 +1,65 @@
+import { buildDbMigrationPlan } from "../migration-plan.js";
+import { generateDbSchemaSnapshot, getTableFromSnapshot } from "../snapshot.js";
+import {
+  renderAddColumn,
+  renderCreateTable
+} from "../shared.js";
+import { resolveSqliteCapabilities } from "./capabilities.js";
+
+function renderSqlMigration(plan, snapshot) {
+  if (!plan.supported) {
+    throw new Error(`Migration plan for '${plan.projection.id}' requires manual intervention`);
+  }
+
+  const statements = [];
+  for (const operation of plan.operations) {
+    if (operation.type === "create_enum" || operation.type === "add_enum_value") {
+      continue;
+    }
+
+    if (operation.type === "create_table") {
+      const table = getTableFromSnapshot(snapshot, operation.table);
+      statements.push(renderCreateTable(table, "sqlite"));
+      continue;
+    }
+
+    if (operation.type === "add_column") {
+      const table = getTableFromSnapshot(snapshot, operation.table);
+      const column = table?.columns.find((entry) => entry.name === operation.column);
+      statements.push(renderAddColumn(operation.table, column));
+      continue;
+    }
+
+    if (operation.type === "add_unique_constraint") {
+      statements.push(`alter table ${operation.table} add unique (${operation.fields.join(", ")});`);
+      continue;
+    }
+
+    if (operation.type === "add_index" || operation.type === "add_unique_index") {
+      const unique = operation.type === "add_unique_index" ? "unique " : "";
+      const name = `${operation.table}_${operation.fields.join("_")}_${operation.type === "add_unique_index" ? "unique" : "index"}`;
+      statements.push(`create ${unique}index ${name} on ${operation.table} (${operation.fields.join(", ")});`);
+      continue;
+    }
+
+    if (operation.type === "add_foreign_key") {
+      continue;
+    }
+  }
+
+  return `${statements.join("\n\n").trimEnd()}\n`;
+}
+
+export function generateSqliteSqlMigration(graph, options = {}) {
+  resolveSqliteCapabilities(options.profileId);
+  if (!options.projectionId) {
+    throw new Error("sql-migration requires --projection");
+  }
+  if (!options.fromSnapshot) {
+    throw new Error("sql-migration requires --from-snapshot");
+  }
+
+  const toSnapshot = generateDbSchemaSnapshot(graph, options);
+  const plan = buildDbMigrationPlan(options.fromSnapshot, toSnapshot, options);
+  return renderSqlMigration({ ...plan, graph }, toSnapshot);
+}

package/src/generator/surfaces/databases/sqlite/sql-schema.js

@@ -0,0 +1,27 @@
+import { generateDbContractGraph } from "../contract.js";
+import { normalizeDbSchemaSnapshot } from "../snapshot.js";
+import {
+  indexGraphStatements,
+  renderCreateTable,
+  renderIndexes
+} from "../shared.js";
+import { resolveSqliteCapabilities } from "./capabilities.js";
+
+export function generateSqliteSqlSchema(graph, options = {}) {
+  resolveSqliteCapabilities(options.profileId);
+  const contract = generateDbContractGraph(graph, options);
+  const byId = indexGraphStatements(graph);
+  const snapshot = normalizeDbSchemaSnapshot(contract, byId);
+  const statements = ["pragma foreign_keys = on;", ""];
+
+  for (const table of snapshot.tables) {
+    statements.push(renderCreateTable(table, "sqlite", { byId }));
+    statements.push("");
+    for (const index of renderIndexes(table)) {
+      statements.push(index);
+    }
+    statements.push("");
+  }
+
+  return `${statements.join("\n").trimEnd()}\n`;
+}

package/src/generator/surfaces/index.js

@@ -0,0 +1,25 @@
+import { generateBackendTarget } from "./services/index.js";
+import { generateSwiftUiApp } from "./native/swiftui-app.js";
+import { generateWebTarget } from "./web/index.js";
+import { generateWithComponentGenerator } from "../adapters.js";
+
+export function generateAppTarget(target, graph, options = {}) {
+  if (target === "server-contract" || target === "persistence-scaffold" || target === "hono-server" || target === "express-server") {
+    return generateBackendTarget(target, graph, options);
+  }
+  if (target === "swiftui-app") {
+    if (options.component?.generator?.id) {
+      return generateWithComponentGenerator({
+        graph,
+        projection: options.component.projection,
+        component: options.component,
+        topology: options.topology || null,
+        implementation: options.implementation || null,
+        options
+      }).files;
+    }
+    return generateSwiftUiApp(graph, options);
+  }
+
+  return generateWebTarget(target, graph, options);
+}

package/src/generator/surfaces/native/swiftui-app.js

@@ -0,0 +1,38 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { buildWebRealization } from "../../../realization/ui/build-web-realization.js";
+import { pickDefaultIosUiProjection, pickDefaultUiWebProjection } from "../../runtime/shared.js";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Emits a SwiftPM iOS SwiftUI app driven by the routed UI contract (default: `proj_ui_native__ios` when present, else first `proj_ui_web__*` projection).
+ */
+export function generateSwiftUiApp(graph, options = {}) {
+  const fallbackId =
+    pickDefaultIosUiProjection(graph)?.id ||
+    pickDefaultUiWebProjection(graph)?.id ||
+    "proj_ui_web__sveltekit";
+  const projectionId = options.projectionId || fallbackId;
+  const realization = buildWebRealization(graph, { projectionId });
+  const apiContracts = realization.apiContracts;
+  const contractJson = `${JSON.stringify(realization.contract, null, 2)}\n`;
+  const apiJson = `${JSON.stringify(apiContracts, null, 2)}\n`;
+
+  const runtimeDir = path.join(__dirname, "swiftui-templates", "runtime");
+  const swiftFiles = fs.readdirSync(runtimeDir).filter((f) => f.endsWith(".swift"));
+  const files = {};
+
+  for (const name of swiftFiles) {
+    files[`Sources/TodoSwiftUIApp/${name}`] = fs.readFileSync(path.join(runtimeDir, name), "utf8");
+  }
+
+  files["Package.swift"] = fs.readFileSync(path.join(__dirname, "swiftui-templates", "Package.swift.txt"), "utf8");
+  files["README.md"] = fs.readFileSync(path.join(__dirname, "swiftui-templates", "README.generated.md"), "utf8");
+  files["Sources/TodoSwiftUIApp/Resources/ui-web-contract.json"] = contractJson;
+  files["Sources/TodoSwiftUIApp/Resources/api-contracts.json"] = apiJson;
+
+  return files;
+}

package/src/generator/surfaces/native/swiftui-templates/Package.swift.txt

@@ -0,0 +1,20 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "TodoSwiftUIApp",
+    platforms: [.iOS(.v17), .macOS(.v14)],
+    products: [
+        .executable(name: "TodoSwiftUIApp", targets: ["TodoSwiftUIApp"])
+    ],
+    targets: [
+        .executableTarget(
+            name: "TodoSwiftUIApp",
+            path: "Sources/TodoSwiftUIApp",
+            resources: [
+                .copy("Resources/api-contracts.json"),
+                .copy("Resources/ui-web-contract.json")
+            ]
+        )
+    ]
+)

package/src/generator/surfaces/native/swiftui-templates/README.generated.md

@@ -0,0 +1,26 @@
+# Todo SwiftUI (generated)
+
+Apple SwiftUI client generated from the same **`buildWebRealization`** routed UI contract as the web stacks. Prefer the **`proj_ui_native__ios`** projection when present; otherwise the generator falls back to a **`proj_ui_web__*`** projection (often **`proj_ui_web__sveltekit`**).
+
+## Bundle inputs
+
+- **`Resources/ui-web-contract.json`** — same shape as `apps/web/src/lib/topogram/ui-web-contract.json`
+- **`Resources/api-contracts.json`** — same shape as `apps/web/src/lib/topogram/api-contracts.json`
+
+## Run
+
+Open **`Package.swift`** in Xcode 15+ and run the **`TodoSwiftUIApp`** scheme on an iOS Simulator.
+
+Configure the API base URL and demo auth token via scheme environment variables (mirror web):
+
+- `PUBLIC_TOPOGRAM_API_BASE_URL` (default `http://localhost:3000`)
+- `PUBLIC_TOPOGRAM_DEMO_AUTH_TOKEN`
+- Optional JWT / permission env vars matching web `visibility.ts` (`PUBLIC_TOPOGRAM_AUTH_*`).
+
+## Regenerate
+
+From `engine/`:
+
+```bash
+topogram ./topogram --generate swiftui-app --projection proj_ui_native__ios --write --out-dir ./app/ios-swiftui
+```