@topogram/cli 0.3.34

package/src/generator/shared.js

@@ -0,0 +1,29 @@
+export function refList(items) {
+  if (!items || items.length === 0) {
+    return "_none_";
+  }
+
+  return items.map((item) => `\`${item.id}\``).join(", ");
+}
+
+export function symbolList(items) {
+  if (!items || items.length === 0) {
+    return "_none_";
+  }
+
+  return items.map((item) => `\`${item}\``).join(", ");
+}
+
+export function fieldSignature(field) {
+  const parts = [`\`${field.name}\``, `\`${field.fieldType}\``];
+  if (field.requiredness) {
+    parts.push(field.requiredness);
+  }
+  if (field.defaultValue != null) {
+    parts.push(`default \`${field.defaultValue}\``);
+  }
+  if (field.sourceName && field.sourceName !== field.name) {
+    parts.push(`from \`${field.sourceName}\``);
+  }
+  return parts.join(" - ");
+}

package/src/generator/surfaces/contracts.js

@@ -0,0 +1,146 @@
+import { refList, symbolList } from "../shared.js";
+import { buildUiSharedRealization } from "../../realization/ui/index.js";
+
+export function generateUiContractGraph(graph, options = {}) {
+  return buildUiSharedRealization(graph, options);
+}
+
+export function generateUiContractDebug(graph, options = {}) {
+  const contracts = options.projectionId ? [generateUiContractGraph(graph, options)] : Object.values(generateUiContractGraph(graph, options));
+  const lines = [];
+
+  lines.push("# UI Contract Debug");
+  lines.push("");
+  lines.push(`Generated from \`${graph.root}\``);
+  lines.push("");
+
+  for (const contract of contracts) {
+    lines.push(`## \`${contract.projection.id}\` - ${contract.projection.name}`);
+    lines.push("");
+    lines.push(`Platform: \`${contract.projection.platform}\``);
+    lines.push(`Realizes: ${refList(contract.realizes)}`);
+    lines.push(`Outputs: ${symbolList(contract.outputs)}`);
+    if (contract.appShell) {
+      lines.push(`App shell: brand \`${contract.appShell.brand}\`, shell \`${contract.appShell.shell}\``);
+    }
+    if (contract.navigation) {
+      const visibleItems = (contract.navigation.items || []).filter((item) => item.visible);
+      lines.push(`Navigation: ${visibleItems.length > 0 ? visibleItems.map((item) => `\`${item.label}\``).join(", ") : "_none_"}`);
+    }
+    lines.push("");
+
+    for (const screen of contract.screens) {
+      lines.push(`### \`${screen.id}\` - ${screen.title || screen.id}`);
+      lines.push("");
+      lines.push(`Kind: \`${screen.kind}\``);
+      if (screen.loadCapability?.id) {
+        lines.push(`Load: \`${screen.loadCapability.id}\``);
+      }
+      if (screen.submitCapability?.id) {
+        lines.push(`Submit: \`${screen.submitCapability.id}\``);
+      }
+      if (screen.viewShape?.id) {
+        lines.push(`View shape: \`${screen.viewShape.id}\``);
+      }
+      if (screen.itemShape?.id) {
+        lines.push(`Item shape: \`${screen.itemShape.id}\``);
+      }
+      if (screen.inputShape?.id) {
+        lines.push(`Input shape: \`${screen.inputShape.id}\``);
+      }
+      if (screen.navigation.successNavigate) {
+        lines.push(`Success navigate: \`${screen.navigation.successNavigate}\``);
+      }
+      if (screen.navigation.successRefresh) {
+        lines.push(`Success refresh: \`${screen.navigation.successRefresh}\``);
+      }
+      if (screen.emptyState) {
+        lines.push(`Empty state: \`${screen.emptyState.title || ""}\` ${screen.emptyState.body ? `- ${screen.emptyState.body}` : ""}`.trim());
+      }
+      lines.push(
+        `States: ${Object.entries(screen.states || {})
+          .map(([key, value]) => `\`${key}=${value}\``)
+          .join(", ")}`
+      );
+      if ((screen.patterns || []).length > 0) {
+        lines.push(`Patterns: ${(screen.patterns || []).map((pattern) => `\`${pattern}\``).join(", ")}`);
+      }
+      lines.push("");
+
+      lines.push("Actions:");
+      if (
+        !screen.actions.primary?.id &&
+        !screen.actions.secondary?.id &&
+        !screen.actions.destructive?.id &&
+        !screen.actions.terminal?.id &&
+        screen.actions.screen.length === 0
+      ) {
+        lines.push("- _none_");
+      } else {
+        for (const [label, action] of [
+          ["primary", screen.actions.primary],
+          ["secondary", screen.actions.secondary],
+          ["destructive", screen.actions.destructive],
+          ["terminal", screen.actions.terminal]
+        ]) {
+          if (action?.id) {
+            lines.push(`- ${label}: \`${action.id}\``);
+          }
+        }
+        for (const action of screen.actions.screen) {
+          lines.push(`- screen action: \`${action.capability?.id}\` (${action.prominence})`);
+        }
+      }
+      lines.push("");
+
+      lines.push("Collection:");
+      lines.push(`- filters: ${screen.collection.filters.length > 0 ? screen.collection.filters.map((field) => `\`${field}\``).join(", ") : "_none_"}`);
+      lines.push(`- search: ${screen.collection.search.length > 0 ? screen.collection.search.map((field) => `\`${field}\``).join(", ") : "_none_"}`);
+      lines.push(`- pagination: ${screen.collection.pagination ? `\`${screen.collection.pagination}\`` : "_none_"}`);
+      lines.push(`- views: ${screen.collection.views.length > 0 ? screen.collection.views.map((view) => `\`${view}\``).join(", ") : "_none_"}`);
+      lines.push(`- groupBy: ${screen.collection.groupBy.length > 0 ? screen.collection.groupBy.map((field) => `\`${field}\``).join(", ") : "_none_"}`);
+      lines.push(
+        `- sort: ${
+          screen.collection.sort.length > 0
+            ? screen.collection.sort.map((entry) => `\`${entry.field}\` ${entry.direction}`).join(", ")
+            : "_none_"
+        }`
+      );
+      lines.push("");
+
+      lines.push("Visibility:");
+      if (screen.visibility.length === 0) {
+        lines.push("- _none_");
+      } else {
+        for (const rule of screen.visibility) {
+          lines.push(`- \`${rule.capability?.id}\` visible_if ${rule.predicate} \`${rule.value}\`${rule.claimValue ? ` claim_value \`${rule.claimValue}\`` : ""}${rule.ownershipField ? ` ownership_field \`${rule.ownershipField}\`` : ""}`);
+        }
+      }
+      lines.push("");
+
+      lines.push("Lookups:");
+      if (screen.lookups.length === 0) {
+        lines.push("- _none_");
+      } else {
+        for (const lookup of screen.lookups) {
+          lines.push(
+            `- field \`${lookup.field}\` -> entity \`${lookup.entity?.id}\` label_field \`${lookup.labelField}\`${lookup.emptyLabel ? ` empty_label "${lookup.emptyLabel}"` : ""}`
+          );
+        }
+      }
+      lines.push("");
+
+      lines.push("Regions:");
+      if (screen.regions.length === 0) {
+        lines.push("- _none_");
+      } else {
+        for (const region of screen.regions) {
+          lines.push(`- \`${region.region}\`${region.pattern ? ` pattern \`${region.pattern}\`` : ""}${region.placement ? ` placement \`${region.placement}\`` : ""}`);
+        }
+      }
+      lines.push("");
+    }
+  }
+
+  return `${lines.join("\n").trimEnd()}\n`;
+}

package/src/generator/surfaces/databases/contract.js

@@ -0,0 +1,40 @@
+import { buildDbRealization } from "../../../realization/db/index.js";
+
+export function generateDbContractGraph(graph, options = {}) {
+  return buildDbRealization(graph, options);
+}
+
+export function generateDbContractDebug(graph, options = {}) {
+  const contracts = options.projectionId ? [generateDbContractGraph(graph, options)] : Object.values(generateDbContractGraph(graph, options));
+  const lines = [];
+
+  lines.push("# DB Contract Debug");
+  lines.push("");
+  lines.push(`Generated from \`${graph.root}\``);
+  lines.push("");
+
+  for (const contract of contracts) {
+    lines.push(`## \`${contract.projection.id}\` - ${contract.projection.name}`);
+    lines.push("");
+    lines.push(`Platform: \`${contract.projection.platform}\``);
+    lines.push(`Profile: \`${contract.profile}\``);
+    lines.push("");
+
+    for (const table of contract.tables) {
+      lines.push(`### \`${table.table}\` <- \`${table.entity.id}\``);
+      lines.push("");
+      lines.push("Columns:");
+      for (const column of table.columns) {
+        lines.push(`- \`${column.name}\` <- \`${column.sourceField}\` : \`${column.fieldType}\` ${column.requiredness}`);
+      }
+      lines.push(`Primary key: ${table.primaryKey.length > 0 ? table.primaryKey.map((field) => `\`${field}\``).join(", ") : "_none_"}`);
+      lines.push(`Unique: ${table.uniques.length > 0 ? table.uniques.map((fields) => `[${fields.join(", ")}]`).join(", ") : "_none_"}`);
+      lines.push(`Indexes: ${table.indexes.length > 0 ? table.indexes.map((entry) => `${entry.type}[${entry.fields.join(", ")}]`).join(", ") : "_none_"}`);
+      lines.push(`Relations: ${table.relations.length > 0 ? table.relations.map((entry) => `\`${entry.field}\` -> \`${entry.target?.id}.${entry.target?.field}\`${entry.onDelete ? ` on_delete ${entry.onDelete}` : ""}`).join(", ") : "_none_"}`);
+      lines.push(`Lifecycle: ${table.lifecycle.softDelete ? `soft_delete(${table.lifecycle.softDelete.field}=${table.lifecycle.softDelete.value})` : "_none_"}${table.lifecycle.timestamps ? `, timestamps(${table.lifecycle.timestamps.createdAt}, ${table.lifecycle.timestamps.updatedAt})` : ""}`);
+      lines.push("");
+    }
+  }
+
+  return `${lines.join("\n").trimEnd()}\n`;
+}

package/src/generator/surfaces/databases/index.js

@@ -0,0 +1,84 @@
+import {
+  generateDbContractDebug,
+  generateDbContractGraph
+} from "./contract.js";
+import { generateWithComponentGenerator } from "../../adapters.js";
+import { generateDbLifecyclePlan } from "./lifecycle-shared.js";
+import { generateDbSchemaSnapshot } from "./snapshot.js";
+import { generateDbMigrationPlan } from "./migration-plan.js";
+import { getDbFamily } from "./shared.js";
+import {
+  generatePostgresDbLifecycleBundle,
+  generatePostgresDbLifecyclePlan,
+  generatePostgresDrizzleSchema,
+  generatePostgresPrismaSchema,
+  generatePostgresSqlMigration,
+  generatePostgresSqlSchema
+} from "./postgres/index.js";
+import {
+  generateSqliteDbLifecycleBundle,
+  generateSqliteDbLifecyclePlan,
+  generateSqlitePrismaSchema,
+  generateSqliteSqlMigration,
+  generateSqliteSqlSchema
+} from "./sqlite/index.js";
+
+export function generateDbTarget(target, graph, options = {}) {
+  const family = getDbFamily(options);
+
+  if (target === "db-contract-graph") {
+    return generateDbContractGraph(graph, options);
+  }
+  if (target === "db-contract-debug") {
+    return generateDbContractDebug(graph, options);
+  }
+  if (target === "db-schema-snapshot") {
+    return generateDbSchemaSnapshot(graph, options);
+  }
+  if (target === "db-migration-plan") {
+    return generateDbMigrationPlan(graph, options);
+  }
+  if (target === "sql-schema") {
+    return family === "sqlite"
+      ? generateSqliteSqlSchema(graph, options)
+      : generatePostgresSqlSchema(graph, options);
+  }
+  if (target === "sql-migration") {
+    return family === "sqlite"
+      ? generateSqliteSqlMigration(graph, options)
+      : generatePostgresSqlMigration(graph, options);
+  }
+  if (target === "db-lifecycle-plan") {
+    if (!options.projectionId) {
+      return generateDbLifecyclePlan(graph, options);
+    }
+    return family === "sqlite"
+      ? generateSqliteDbLifecyclePlan(graph, options)
+      : generatePostgresDbLifecyclePlan(graph, options);
+  }
+  if (target === "db-lifecycle-bundle") {
+    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 family === "sqlite"
+      ? generateSqliteDbLifecycleBundle(graph, options)
+      : generatePostgresDbLifecycleBundle(graph, options);
+  }
+  if (target === "prisma-schema") {
+    return family === "sqlite"
+      ? generateSqlitePrismaSchema(graph, options)
+      : generatePostgresPrismaSchema(graph, options);
+  }
+  if (target === "drizzle-schema") {
+    return generatePostgresDrizzleSchema(graph, options);
+  }
+
+  throw new Error(`Unsupported DB generator target '${target}'`);
+}

package/src/generator/surfaces/databases/lifecycle-shared.d.ts

@@ -0,0 +1 @@
+export function generateDbLifecycleBundleForProjection(graph: any, projection: any, options?: any): any;