@happyvertical/smrt-core 0.40.69 → 0.40.70

package/dist/schema/schema-aggregator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-aggregator.d.ts","sourceRoot":"","sources":["../../src/schema/schema-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAgB/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrC,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5C,yBAAyB;IACzB,KAAK,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAEhC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA4FD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,iBAAiB;IAoE5D;;OAEG;IACH,OAAO,CAAC,YAAY;IA6CpB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAgEtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAuCpB"}
+{"version":3,"file":"schema-aggregator.d.ts","sourceRoot":"","sources":["../../src/schema/schema-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,sBAAsB,CAAC;AAM9B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrC,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5C,yBAAyB;IACzB,KAAK,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAEhC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqBD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,iBAAiB;IAoE5D;;OAEG;IACH,OAAO,CAAC,YAAY;IAgDpB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAqDtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAuCpB"}

package/dist/schema/schema-aggregator.js

@@ -1,9 +1,6 @@
-import { quoteIdentifier } from "./sql-identifiers.js";
-import { renderIndexTarget } from "./index-utils.js";
 import { loadExternalManifestSync } from "../manifest/manifest-loader.js";
 import { discoverSmrtPackages } from "../manifest/discover-smrt-packages.js";
-import { findCreateTableBodyRange, getSQLDefinitionComparisonKey, getSQLDefinitionIdentifier, isSQLTableConstraintDefinition, materializeManifestDDLForEngine, tokenizeSQLDDLBody } from "./ddl/materialize-manifest.js";
-import "./utils.js";
+import { collectManifestTables, renderCollectedManifestTable } from "./manifest-schema.js";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/schema/schema-aggregator.ts
@@ -13,6 +10,12 @@ import { join } from "node:path";
 * Aggregates database schemas across multiple SMRT package manifests.
 * Handles STI table deduplication, index merging, and sorting for deterministic output.
 *
+* Tables and indexes are rendered from the manifests' structured `columns` /
+* `indexes` through the dialect's DDL strategy (`getDDLStrategy`), the same
+* renderer `smrt db:migrate` uses — never from the cached `schema.ddl` string,
+* which carries no indexes and no per-engine types (#2358). Objects that expose
+* no structured columns fall back to their cached `ddl` for the CREATE TABLE.
+*
 * This replaces the manual generate-schema.ts pattern used by downstream
 * projects like blindmanpress.com (Issue #1013).
 *
@@ -44,54 +47,6 @@ var DEFAULT_MINIMAL_SKIP_PATTERNS = [
 	/_relationship_term/,
 	/_relationship_type/
 ];
-function parseDefinitionsFromDDL(ddl) {
-	const columns = /* @__PURE__ */ new Map();
-	const tableElements = [];
-	const bodyRange = findCreateTableBodyRange(ddl);
-	if (!bodyRange) return {
-		columns,
-		tableElements
-	};
-	const [bodyStart, bodyEnd] = bodyRange;
-	const segments = tokenizeSQLDDLBody(ddl.slice(bodyStart + 1, bodyEnd));
-	for (const segment of segments) {
-		const identifier = getSQLDefinitionIdentifier(segment);
-		if (!identifier) continue;
-		if (isSQLTableConstraintDefinition(segment)) {
-			tableElements.push(segment);
-			continue;
-		}
-		columns.set(identifier.name, segment);
-	}
-	return {
-		columns,
-		tableElements
-	};
-}
-function mergeDDL(existingDDL, newDDL) {
-	const existingDefinitions = parseDefinitionsFromDDL(existingDDL);
-	const newDefinitions = parseDefinitionsFromDDL(newDDL);
-	const missingCols = [];
-	for (const [name, def] of newDefinitions.columns) if (!existingDefinitions.columns.has(name)) missingCols.push(def);
-	const existingTableElements = new Set(existingDefinitions.tableElements.map(getSQLDefinitionComparisonKey));
-	const missingTableElements = newDefinitions.tableElements.filter((definition) => !existingTableElements.has(getSQLDefinitionComparisonKey(definition)));
-	if (missingCols.length === 0 && missingTableElements.length === 0) return existingDDL;
-	const bodyRange = findCreateTableBodyRange(existingDDL);
-	if (!bodyRange) return existingDDL;
-	const [bodyStart, bodyEnd] = bodyRange;
-	const prefix = existingDDL.slice(0, bodyStart + 1);
-	const body = existingDDL.slice(bodyStart + 1, bodyEnd);
-	const suffix = existingDDL.slice(bodyEnd);
-	const segments = tokenizeSQLDDLBody(body);
-	const firstConstraintIndex = segments.findIndex((segment) => isSQLTableConstraintDefinition(segment));
-	const insertionIndex = firstConstraintIndex === -1 ? segments.length : firstConstraintIndex;
-	return `${prefix}\n${[
-		...segments.slice(0, insertionIndex),
-		...missingCols,
-		...segments.slice(insertionIndex),
-		...missingTableElements
-	].map((segment) => `  ${segment}`).join(",\n")}\n${suffix}`;
-}
 /**
 * Aggregates database schemas from multiple SMRT package manifests.
 *
@@ -151,7 +106,7 @@ var SchemaAggregator = class {
 			const localPath = localPaths[packageName];
 			if (existsSync(localPath)) try {
 				const content = JSON.parse(readFileSync(localPath, "utf-8"));
-				if (Object.values(content.objects || {}).some((obj) => obj.schema?.ddl)) return content;
+				if (Object.values(content.objects || {}).some((obj) => obj.schema?.tableName && (Object.keys(obj.schema.columns || {}).length > 0 || obj.schema.ddl))) return content;
 			} catch {}
 		}
 		const manifest = loadExternalManifestSync(packageName);
@@ -166,54 +121,44 @@ var SchemaAggregator = class {
 	/**
 	* Extract schemas from manifests, deduplicating STI tables.
 	*
-	* For STI tables (shared by multiple classes across packages),
-	* keeps the most comprehensive DDL (largest) and merges indexes.
+	* STI tables (shared by multiple classes across packages) are merged
+	* structurally — columns first-wins by name, indexes deduplicated by name —
+	* and every table is rendered through the dialect's DDL strategy, the same
+	* renderer `db:migrate` uses. The manifest's cached `schema.ddl` string is
+	* consulted only for objects that expose no structured columns (#2358).
 	*/
 	extractSchemas(manifests, dialect) {
-		const tables = /* @__PURE__ */ new Map();
 		const engine = dialect === "sqlite" ? "sqlite" : "postgres";
+		const entries = [];
+		const manifestColumns = /* @__PURE__ */ new Map();
 		for (const manifest of manifests) for (const [_key, object] of Object.entries(manifest.objects)) {
 			const schema = object.schema;
-			if (!schema?.ddl) continue;
+			if (!schema?.tableName) continue;
 			const className = object.className || _key;
-			const tableName = schema.tableName;
-			const existing = tables.get(tableName);
-			const executableDDL = materializeManifestDDLForEngine(schema.ddl, engine);
-			if (existing) {
-				existing.ddl = mergeDDL(existing.ddl, executableDDL);
-				existing.sources.push(`${manifest.packageName || "?"}:${className}`);
-				if (schema.columns) existing.columns = {
-					...existing.columns || {},
-					...schema.columns
-				};
-				for (const idx of schema.indexes || []) {
-					const indexDdl = this.formatIndexDdl(idx, tableName, engine);
-					if (!existing.indexes.includes(indexDdl)) existing.indexes.push(indexDdl);
-				}
-			} else {
-				const indexes = [];
-				for (const idx of schema.indexes || []) indexes.push(this.formatIndexDdl(idx, tableName, engine));
-				tables.set(tableName, {
-					tableName,
-					ddl: executableDDL,
-					indexes,
-					sources: [`${manifest.packageName || "?"}:${className}`],
-					columns: schema.columns
-				});
+			entries.push({
+				schema,
+				source: `${manifest.packageName || "?"}:${className}`
+			});
+			if (schema.columns && Object.keys(schema.columns).length > 0) {
+				const merged = manifestColumns.get(schema.tableName) ?? {};
+				for (const [name, column] of Object.entries(schema.columns)) if (!(name in merged)) merged[name] = column;
+				manifestColumns.set(schema.tableName, merged);
 			}
 		}
+		const tables = /* @__PURE__ */ new Map();
+		for (const [tableName, table] of collectManifestTables(entries)) {
+			const rendered = renderCollectedManifestTable(table, engine);
+			tables.set(tableName, {
+				tableName,
+				ddl: rendered.createTable,
+				indexes: rendered.indexes,
+				sources: table.sources,
+				columns: manifestColumns.get(tableName)
+			});
+		}
 		return tables;
 	}
 	/**
-	* Format an index definition into a CREATE INDEX statement.
-	*/
-	formatIndexDdl(idx, tableName, engine = "sqlite") {
-		const target = renderIndexTarget(idx, engine);
-		const indexName = quoteIdentifier(idx.name);
-		const table = quoteIdentifier(tableName);
-		return idx.unique ? `CREATE UNIQUE INDEX IF NOT EXISTS ${indexName} ON ${table} (${target});` : `CREATE INDEX IF NOT EXISTS ${indexName} ON ${table} (${target});`;
-	}
-	/**
 	* Apply minimal filtering to remove infrastructure/collection tables.
 	*/
 	applyMinimalFilter(tables, options) {

package/dist/schema/schema-aggregator.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-aggregator.js","names":[],"sources":["../../src/schema/schema-aggregator.ts"],"sourcesContent":["/**\n * Schema Aggregator\n *\n * Aggregates database schemas across multiple SMRT package manifests.\n * Handles STI table deduplication, index merging, and sorting for deterministic output.\n *\n * This replaces the manual generate-schema.ts pattern used by downstream\n * projects like blindmanpress.com (Issue #1013).\n *\n * @example\n * ```typescript\n * import { SchemaAggregator } from '@happyvertical/smrt-core/schema';\n *\n * // Auto-discover from installed @happyvertical packages in node_modules\n * const aggregator = new SchemaAggregator();\n * const result = aggregator.aggregate();\n *\n * // Or with explicit packages\n * const result = aggregator.aggregate({\n *   packages: ['@happyvertical/smrt-profiles', '@happyvertical/smrt-events'],\n * });\n *\n * console.log(result.sql);        // Combined CREATE TABLE + INDEX SQL\n * console.log(result.tables);     // Map of table info\n * console.log(result.manifests);  // Loaded manifests by package\n * ```\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { discoverSmrtPackages } from '../manifest/discover-smrt-packages.js';\nimport { loadExternalManifestSync } from '../manifest/manifest-loader.js';\nimport type { SmartObjectManifest } from '../scanner/types.js';\nimport {\n  findCreateTableBodyRange,\n  getSQLDefinitionComparisonKey,\n  getSQLDefinitionIdentifier,\n  isSQLTableConstraintDefinition,\n  materializeManifestDDLForEngine,\n  tokenizeSQLDDLBody,\n} from './ddl/materialize-manifest.js';\nimport { quoteIdentifier } from './sql-identifiers.js';\nimport { renderIndexTarget } from './utils.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Aggregated table information including DDL, indexes, and source tracking.\n */\nexport interface AggregatedTable {\n  /** Table name */\n  tableName: string;\n  /** CREATE TABLE statement (most comprehensive version for STI tables) */\n  ddl: string;\n  /** CREATE INDEX statements (deduplicated across sources) */\n  indexes: string[];\n  /** Package:className sources that contribute to this table */\n  sources: string[];\n  /** Schema definition metadata */\n  columns?: Record<string, unknown>;\n}\n\n/**\n * Result of schema aggregation across packages.\n */\nexport interface AggregationResult {\n  /** Aggregated tables keyed by table name */\n  tables: Map<string, AggregatedTable>;\n  /** Combined SQL string (CREATE TABLE + CREATE INDEX statements) */\n  sql: string;\n  /** Loaded manifests keyed by package name */\n  manifests: Map<string, SmartObjectManifest>;\n  /** Summary statistics */\n  stats: {\n    packagesLoaded: number;\n    packagesSkipped: number;\n    totalObjects: number;\n    uniqueTables: number;\n    stiTables: number;\n  };\n}\n\n/**\n * Options for schema aggregation.\n */\nexport interface AggregateOptions {\n  /**\n   * Explicit list of packages to scan. If omitted, auto-discovers\n   * installed `@happyvertical/smrt-*` packages from `node_modules`\n   * via `discoverSmrtPackages()`.\n   */\n  packages?: string[];\n\n  /**\n   * Additional local filesystem paths to check for manifests,\n   * keyed by package name. Useful for development when local\n   * packages have newer schemas than node_modules.\n   */\n  localPaths?: Record<string, string>;\n\n  /**\n   * Skip collection tables and infrastructure tables.\n   * Useful for generating minimal schemas for lightweight deployments.\n   */\n  minimal?: boolean;\n\n  /**\n   * Table name patterns to skip in minimal mode.\n   * Defaults to common infrastructure tables.\n   */\n  minimalSkipPatterns?: RegExp[];\n\n  /**\n   * Specific table names to skip in minimal mode.\n   */\n  minimalSkipTables?: string[];\n\n  /**\n   * SQL dialect for the output. Affects PRAGMA statements and syntax.\n   * @default 'postgres'\n   */\n  dialect?: 'postgres' | 'sqlite';\n\n  /** Log progress to console */\n  verbose?: boolean;\n}\n\n// ============================================================================\n// Default minimal-mode skip lists\n// ============================================================================\n\nconst DEFAULT_MINIMAL_SKIP_PATTERNS: RegExp[] = [\n  /^api_key/,\n  /^magic_link/,\n  /^nostr_/,\n  /^audit_log/,\n  /_metafield/,\n  /_metadata/,\n  /_relationship_term/,\n  /_relationship_type/,\n];\n\nfunction parseDefinitionsFromDDL(ddl: string): {\n  columns: Map<string, string>;\n  tableElements: string[];\n} {\n  const columns = new Map<string, string>();\n  const tableElements: string[] = [];\n  const bodyRange = findCreateTableBodyRange(ddl);\n  if (!bodyRange) return { columns, tableElements };\n  const [bodyStart, bodyEnd] = bodyRange;\n\n  const segments = tokenizeSQLDDLBody(ddl.slice(bodyStart + 1, bodyEnd));\n\n  for (const segment of segments) {\n    const identifier = getSQLDefinitionIdentifier(segment);\n    if (!identifier) continue;\n    if (isSQLTableConstraintDefinition(segment)) {\n      tableElements.push(segment);\n      continue;\n    }\n\n    columns.set(identifier.name, segment);\n  }\n\n  return { columns, tableElements };\n}\n\nfunction mergeDDL(existingDDL: string, newDDL: string): string {\n  const existingDefinitions = parseDefinitionsFromDDL(existingDDL);\n  const newDefinitions = parseDefinitionsFromDDL(newDDL);\n\n  const missingCols: string[] = [];\n  for (const [name, def] of newDefinitions.columns) {\n    if (!existingDefinitions.columns.has(name)) {\n      missingCols.push(def);\n    }\n  }\n\n  const existingTableElements = new Set(\n    existingDefinitions.tableElements.map(getSQLDefinitionComparisonKey),\n  );\n  const missingTableElements = newDefinitions.tableElements.filter(\n    (definition) =>\n      !existingTableElements.has(getSQLDefinitionComparisonKey(definition)),\n  );\n\n  if (missingCols.length === 0 && missingTableElements.length === 0) {\n    return existingDDL;\n  }\n\n  const bodyRange = findCreateTableBodyRange(existingDDL);\n  if (!bodyRange) return existingDDL;\n  const [bodyStart, bodyEnd] = bodyRange;\n  const prefix = existingDDL.slice(0, bodyStart + 1);\n  const body = existingDDL.slice(bodyStart + 1, bodyEnd);\n  const suffix = existingDDL.slice(bodyEnd);\n  const segments = tokenizeSQLDDLBody(body);\n  const firstConstraintIndex = segments.findIndex((segment) =>\n    isSQLTableConstraintDefinition(segment),\n  );\n  const insertionIndex =\n    firstConstraintIndex === -1 ? segments.length : firstConstraintIndex;\n  const mergedSegments = [\n    ...segments.slice(0, insertionIndex),\n    ...missingCols,\n    ...segments.slice(insertionIndex),\n    ...missingTableElements,\n  ];\n\n  return `${prefix}\\n${mergedSegments.map((segment) => `  ${segment}`).join(',\\n')}\\n${suffix}`;\n}\n\n// ============================================================================\n// SchemaAggregator\n// ============================================================================\n\n/**\n * Aggregates database schemas from multiple SMRT package manifests.\n *\n * Handles the complete workflow of discovering packages, loading manifests,\n * extracting DDL, deduplicating STI tables, and producing combined SQL.\n */\nexport class SchemaAggregator {\n  /**\n   * Aggregate schemas from SMRT packages.\n   *\n   * @param options - Aggregation options\n   * @returns Aggregated schemas with combined SQL\n   */\n  aggregate(options: AggregateOptions = {}): AggregationResult {\n    const verbose = options.verbose ?? false;\n\n    // 1. Discover packages\n    const packages = options.packages || discoverSmrtPackages();\n\n    if (verbose) {\n      console.log(`[SchemaAggregator] Scanning ${packages.length} packages...`);\n    }\n\n    // 2. Load manifests\n    const manifests = new Map<string, SmartObjectManifest>();\n    let packagesSkipped = 0;\n\n    for (const pkg of packages) {\n      const manifest = this.loadManifest(pkg, options.localPaths);\n      if (manifest) {\n        manifests.set(pkg, manifest);\n        if (verbose) {\n          const objectCount = Object.keys(manifest.objects).length;\n          console.log(`  ✓ ${pkg} (${objectCount} objects)`);\n        }\n      } else {\n        packagesSkipped++;\n        if (verbose) {\n          console.log(`  [skip] ${pkg} - manifest not found`);\n        }\n      }\n    }\n\n    // 3. Extract and deduplicate schemas\n    const tables = this.extractSchemas(\n      Array.from(manifests.values()),\n      options.dialect,\n    );\n\n    // 4. Apply minimal filtering if requested\n    if (options.minimal) {\n      this.applyMinimalFilter(tables, options);\n    }\n\n    // 5. Count STI tables and total objects\n    let stiTables = 0;\n    let totalObjects = 0;\n    for (const table of tables.values()) {\n      if (table.sources.length > 1) stiTables++;\n    }\n    for (const manifest of manifests.values()) {\n      totalObjects += Object.keys(manifest.objects).length;\n    }\n\n    // 6. Generate combined SQL\n    const sql = this.generateSQL(tables, options);\n\n    return {\n      tables,\n      sql,\n      manifests,\n      stats: {\n        packagesLoaded: manifests.size,\n        packagesSkipped,\n        totalObjects,\n        uniqueTables: tables.size,\n        stiTables,\n      },\n    };\n  }\n\n  /**\n   * Load a manifest from local path or node_modules.\n   */\n  private loadManifest(\n    packageName: string,\n    localPaths?: Record<string, string>,\n  ): SmartObjectManifest | null {\n    // Try local development path first (may have newer schemas)\n    if (localPaths?.[packageName]) {\n      const localPath = localPaths[packageName];\n      if (existsSync(localPath)) {\n        try {\n          const content = JSON.parse(\n            readFileSync(localPath, 'utf-8'),\n          ) as SmartObjectManifest;\n          // Only use local if it has schemas\n          const hasSchemas = Object.values(content.objects || {}).some(\n            (obj) => obj.schema?.ddl,\n          );\n          if (hasSchemas) return content;\n        } catch {\n          // Fall through to node_modules\n        }\n      }\n    }\n\n    // Try loadExternalManifestSync (handles node_modules resolution)\n    const manifest = loadExternalManifestSync(packageName);\n    if (manifest) return manifest;\n\n    // Fallback: try common node_modules paths relative to cwd\n    const root = process.cwd();\n    const paths = [\n      join(root, 'node_modules', packageName, 'dist', 'manifest.json'),\n      join(root, 'node_modules', packageName, 'manifest.json'),\n    ];\n\n    for (const manifestPath of paths) {\n      if (existsSync(manifestPath)) {\n        try {\n          return JSON.parse(readFileSync(manifestPath, 'utf-8'));\n        } catch {}\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Extract schemas from manifests, deduplicating STI tables.\n   *\n   * For STI tables (shared by multiple classes across packages),\n   * keeps the most comprehensive DDL (largest) and merges indexes.\n   */\n  private extractSchemas(\n    manifests: SmartObjectManifest[],\n    dialect?: 'postgres' | 'sqlite',\n  ): Map<string, AggregatedTable> {\n    const tables = new Map<string, AggregatedTable>();\n    // The aggregator only knows sqlite vs postgres; jsonPath rendering\n    // treats anything non-sqlite as the postgres-style `->>` form, which\n    // is also what DuckDB accepts. Default mirrors `AggregateOptions.dialect`\n    // (`@default 'postgres'`) so unspecified callers get the documented shape.\n    const engine: 'sqlite' | 'postgres' | 'duckdb' =\n      dialect === 'sqlite' ? 'sqlite' : 'postgres';\n\n    for (const manifest of manifests) {\n      for (const [_key, object] of Object.entries(manifest.objects)) {\n        const schema = object.schema;\n        if (!schema?.ddl) continue;\n\n        const className: string = object.className || _key;\n        const tableName: string = schema.tableName;\n        const existing = tables.get(tableName);\n        const executableDDL = materializeManifestDDLForEngine(\n          schema.ddl,\n          engine,\n        );\n\n        if (existing) {\n          // STI table — merge columns from every subtype into the shared DDL.\n          existing.ddl = mergeDDL(existing.ddl, executableDDL);\n          existing.sources.push(`${manifest.packageName || '?'}:${className}`);\n          if (schema.columns) {\n            existing.columns = {\n              ...(existing.columns || {}),\n              ...schema.columns,\n            };\n          }\n\n          // Merge indexes (deduplicate by SQL text)\n          for (const idx of schema.indexes || []) {\n            const indexDdl = this.formatIndexDdl(idx, tableName, engine);\n            if (!existing.indexes.includes(indexDdl)) {\n              existing.indexes.push(indexDdl);\n            }\n          }\n        } else {\n          // New table\n          const indexes: string[] = [];\n          for (const idx of schema.indexes || []) {\n            indexes.push(this.formatIndexDdl(idx, tableName, engine));\n          }\n\n          tables.set(tableName, {\n            tableName,\n            ddl: executableDDL,\n            indexes,\n            sources: [`${manifest.packageName || '?'}:${className}`],\n            columns: schema.columns,\n          });\n        }\n      }\n    }\n\n    return tables;\n  }\n\n  /**\n   * Format an index definition into a CREATE INDEX statement.\n   */\n  private formatIndexDdl(\n    idx: {\n      name: string;\n      columns: string[];\n      unique?: boolean;\n      jsonPath?: { column: string; path: string };\n    },\n    tableName: string,\n    engine: 'sqlite' | 'postgres' | 'duckdb' = 'sqlite',\n  ): string {\n    const target = renderIndexTarget(idx, engine);\n    const indexName = quoteIdentifier(idx.name);\n    const table = quoteIdentifier(tableName);\n    return idx.unique\n      ? `CREATE UNIQUE INDEX IF NOT EXISTS ${indexName} ON ${table} (${target});`\n      : `CREATE INDEX IF NOT EXISTS ${indexName} ON ${table} (${target});`;\n  }\n\n  /**\n   * Apply minimal filtering to remove infrastructure/collection tables.\n   */\n  private applyMinimalFilter(\n    tables: Map<string, AggregatedTable>,\n    options: AggregateOptions,\n  ): void {\n    const skipPatterns =\n      options.minimalSkipPatterns || DEFAULT_MINIMAL_SKIP_PATTERNS;\n    const skipTables = new Set(options.minimalSkipTables || []);\n\n    for (const tableName of Array.from(tables.keys())) {\n      if (skipTables.has(tableName)) {\n        tables.delete(tableName);\n        continue;\n      }\n      for (const pattern of skipPatterns) {\n        if (pattern.test(tableName)) {\n          tables.delete(tableName);\n          break;\n        }\n      }\n    }\n  }\n\n  /**\n   * Generate combined SQL from aggregated tables.\n   */\n  private generateSQL(\n    tables: Map<string, AggregatedTable>,\n    options: AggregateOptions,\n  ): string {\n    const lines: string[] = [\n      '-- Combined SMRT Database Schema',\n      `-- Generated: ${new Date().toISOString()}`,\n      '',\n    ];\n\n    if (options.dialect === 'sqlite') {\n      lines.push('PRAGMA foreign_keys = ON;', '');\n    }\n\n    // Sort tables by name for deterministic output\n    const sortedTables = Array.from(tables.entries()).sort((a, b) =>\n      a[0].localeCompare(b[0]),\n    );\n\n    for (const [tableName, table] of sortedTables) {\n      lines.push(`-- Table: ${tableName}`);\n      if (table.sources.length > 1) {\n        lines.push(`-- STI table, sources: ${table.sources.join(', ')}`);\n      } else {\n        lines.push(`-- Source: ${table.sources[0]}`);\n      }\n      lines.push(table.ddl);\n      lines.push('');\n\n      if (table.indexes.length > 0) {\n        for (const idx of table.indexes) {\n          lines.push(idx);\n        }\n        lines.push('');\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema-aggregator.js","names":[],"sources":["../../src/schema/schema-aggregator.ts"],"sourcesContent":["/**\n * Schema Aggregator\n *\n * Aggregates database schemas across multiple SMRT package manifests.\n * Handles STI table deduplication, index merging, and sorting for deterministic output.\n *\n * Tables and indexes are rendered from the manifests' structured `columns` /\n * `indexes` through the dialect's DDL strategy (`getDDLStrategy`), the same\n * renderer `smrt db:migrate` uses — never from the cached `schema.ddl` string,\n * which carries no indexes and no per-engine types (#2358). Objects that expose\n * no structured columns fall back to their cached `ddl` for the CREATE TABLE.\n *\n * This replaces the manual generate-schema.ts pattern used by downstream\n * projects like blindmanpress.com (Issue #1013).\n *\n * @example\n * ```typescript\n * import { SchemaAggregator } from '@happyvertical/smrt-core/schema';\n *\n * // Auto-discover from installed @happyvertical packages in node_modules\n * const aggregator = new SchemaAggregator();\n * const result = aggregator.aggregate();\n *\n * // Or with explicit packages\n * const result = aggregator.aggregate({\n *   packages: ['@happyvertical/smrt-profiles', '@happyvertical/smrt-events'],\n * });\n *\n * console.log(result.sql);        // Combined CREATE TABLE + INDEX SQL\n * console.log(result.tables);     // Map of table info\n * console.log(result.manifests);  // Loaded manifests by package\n * ```\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { discoverSmrtPackages } from '../manifest/discover-smrt-packages.js';\nimport { loadExternalManifestSync } from '../manifest/manifest-loader.js';\nimport type { SmartObjectManifest } from '../scanner/types.js';\nimport type { DatabaseEngine } from './ddl/types.js';\nimport {\n  collectManifestTables,\n  type ManifestColumnLike,\n  renderCollectedManifestTable,\n} from './manifest-schema.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Aggregated table information including DDL, indexes, and source tracking.\n */\nexport interface AggregatedTable {\n  /** Table name */\n  tableName: string;\n  /**\n   * CREATE TABLE statement rendered by the dialect's DDL strategy from the\n   * merged structured columns of every contributing class (STI union). A\n   * table with a column-less contributor (hand-authored manifest) has that\n   * contributor's cached `ddl` merged on top; a table with no structured\n   * columns at all is the merged cached `ddl`.\n   */\n  ddl: string;\n  /**\n   * CREATE INDEX statements rendered by the same strategy (partial `WHERE`\n   * and JSON-path targets included), deduplicated by index name across\n   * sources.\n   */\n  indexes: string[];\n  /** Package:className sources that contribute to this table */\n  sources: string[];\n  /**\n   * Manifest column metadata as published in `manifest.json` (`default`,\n   * not `defaultValue`), merged across contributors — first contributor wins\n   * per column name, matching the rendered DDL.\n   */\n  columns?: Record<string, ManifestColumnLike>;\n}\n\n/**\n * Result of schema aggregation across packages.\n */\nexport interface AggregationResult {\n  /** Aggregated tables keyed by table name */\n  tables: Map<string, AggregatedTable>;\n  /** Combined SQL string (CREATE TABLE + CREATE INDEX statements) */\n  sql: string;\n  /** Loaded manifests keyed by package name */\n  manifests: Map<string, SmartObjectManifest>;\n  /** Summary statistics */\n  stats: {\n    packagesLoaded: number;\n    packagesSkipped: number;\n    totalObjects: number;\n    uniqueTables: number;\n    stiTables: number;\n  };\n}\n\n/**\n * Options for schema aggregation.\n */\nexport interface AggregateOptions {\n  /**\n   * Explicit list of packages to scan. If omitted, auto-discovers\n   * installed `@happyvertical/smrt-*` packages from `node_modules`\n   * via `discoverSmrtPackages()`.\n   */\n  packages?: string[];\n\n  /**\n   * Additional local filesystem paths to check for manifests,\n   * keyed by package name. Useful for development when local\n   * packages have newer schemas than node_modules.\n   */\n  localPaths?: Record<string, string>;\n\n  /**\n   * Skip collection tables and infrastructure tables.\n   * Useful for generating minimal schemas for lightweight deployments.\n   */\n  minimal?: boolean;\n\n  /**\n   * Table name patterns to skip in minimal mode.\n   * Defaults to common infrastructure tables.\n   */\n  minimalSkipPatterns?: RegExp[];\n\n  /**\n   * Specific table names to skip in minimal mode.\n   */\n  minimalSkipTables?: string[];\n\n  /**\n   * SQL dialect for the output. Affects PRAGMA statements and syntax.\n   * @default 'postgres'\n   */\n  dialect?: 'postgres' | 'sqlite';\n\n  /** Log progress to console */\n  verbose?: boolean;\n}\n\n// ============================================================================\n// Default minimal-mode skip lists\n// ============================================================================\n\nconst DEFAULT_MINIMAL_SKIP_PATTERNS: RegExp[] = [\n  /^api_key/,\n  /^magic_link/,\n  /^nostr_/,\n  /^audit_log/,\n  /_metafield/,\n  /_metadata/,\n  /_relationship_term/,\n  /_relationship_type/,\n];\n\n// ============================================================================\n// SchemaAggregator\n// ============================================================================\n\n/**\n * Aggregates database schemas from multiple SMRT package manifests.\n *\n * Handles the complete workflow of discovering packages, loading manifests,\n * extracting DDL, deduplicating STI tables, and producing combined SQL.\n */\nexport class SchemaAggregator {\n  /**\n   * Aggregate schemas from SMRT packages.\n   *\n   * @param options - Aggregation options\n   * @returns Aggregated schemas with combined SQL\n   */\n  aggregate(options: AggregateOptions = {}): AggregationResult {\n    const verbose = options.verbose ?? false;\n\n    // 1. Discover packages\n    const packages = options.packages || discoverSmrtPackages();\n\n    if (verbose) {\n      console.log(`[SchemaAggregator] Scanning ${packages.length} packages...`);\n    }\n\n    // 2. Load manifests\n    const manifests = new Map<string, SmartObjectManifest>();\n    let packagesSkipped = 0;\n\n    for (const pkg of packages) {\n      const manifest = this.loadManifest(pkg, options.localPaths);\n      if (manifest) {\n        manifests.set(pkg, manifest);\n        if (verbose) {\n          const objectCount = Object.keys(manifest.objects).length;\n          console.log(`  ✓ ${pkg} (${objectCount} objects)`);\n        }\n      } else {\n        packagesSkipped++;\n        if (verbose) {\n          console.log(`  [skip] ${pkg} - manifest not found`);\n        }\n      }\n    }\n\n    // 3. Extract and deduplicate schemas\n    const tables = this.extractSchemas(\n      Array.from(manifests.values()),\n      options.dialect,\n    );\n\n    // 4. Apply minimal filtering if requested\n    if (options.minimal) {\n      this.applyMinimalFilter(tables, options);\n    }\n\n    // 5. Count STI tables and total objects\n    let stiTables = 0;\n    let totalObjects = 0;\n    for (const table of tables.values()) {\n      if (table.sources.length > 1) stiTables++;\n    }\n    for (const manifest of manifests.values()) {\n      totalObjects += Object.keys(manifest.objects).length;\n    }\n\n    // 6. Generate combined SQL\n    const sql = this.generateSQL(tables, options);\n\n    return {\n      tables,\n      sql,\n      manifests,\n      stats: {\n        packagesLoaded: manifests.size,\n        packagesSkipped,\n        totalObjects,\n        uniqueTables: tables.size,\n        stiTables,\n      },\n    };\n  }\n\n  /**\n   * Load a manifest from local path or node_modules.\n   */\n  private loadManifest(\n    packageName: string,\n    localPaths?: Record<string, string>,\n  ): SmartObjectManifest | null {\n    // Try local development path first (may have newer schemas)\n    if (localPaths?.[packageName]) {\n      const localPath = localPaths[packageName];\n      if (existsSync(localPath)) {\n        try {\n          const content = JSON.parse(\n            readFileSync(localPath, 'utf-8'),\n          ) as SmartObjectManifest;\n          // Only use local if it has schemas\n          const hasSchemas = Object.values(content.objects || {}).some(\n            (obj) =>\n              obj.schema?.tableName &&\n              (Object.keys(obj.schema.columns || {}).length > 0 ||\n                obj.schema.ddl),\n          );\n          if (hasSchemas) return content;\n        } catch {\n          // Fall through to node_modules\n        }\n      }\n    }\n\n    // Try loadExternalManifestSync (handles node_modules resolution)\n    const manifest = loadExternalManifestSync(packageName);\n    if (manifest) return manifest;\n\n    // Fallback: try common node_modules paths relative to cwd\n    const root = process.cwd();\n    const paths = [\n      join(root, 'node_modules', packageName, 'dist', 'manifest.json'),\n      join(root, 'node_modules', packageName, 'manifest.json'),\n    ];\n\n    for (const manifestPath of paths) {\n      if (existsSync(manifestPath)) {\n        try {\n          return JSON.parse(readFileSync(manifestPath, 'utf-8'));\n        } catch {}\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Extract schemas from manifests, deduplicating STI tables.\n   *\n   * STI tables (shared by multiple classes across packages) are merged\n   * structurally — columns first-wins by name, indexes deduplicated by name —\n   * and every table is rendered through the dialect's DDL strategy, the same\n   * renderer `db:migrate` uses. The manifest's cached `schema.ddl` string is\n   * consulted only for objects that expose no structured columns (#2358).\n   */\n  private extractSchemas(\n    manifests: SmartObjectManifest[],\n    dialect?: 'postgres' | 'sqlite',\n  ): Map<string, AggregatedTable> {\n    // Default mirrors `AggregateOptions.dialect` (`@default 'postgres'`) so\n    // unspecified callers get the documented shape.\n    const engine: DatabaseEngine = dialect === 'sqlite' ? 'sqlite' : 'postgres';\n\n    const entries: Array<{\n      schema: NonNullable<SmartObjectManifest['objects'][string]['schema']>;\n      source: string;\n    }> = [];\n    // Published manifest column metadata, merged first-wins per table so\n    // `AggregatedTable.columns` keeps its manifest shape for downstream\n    // generate-schema scripts.\n    const manifestColumns = new Map<\n      string,\n      Record<string, ManifestColumnLike>\n    >();\n    for (const manifest of manifests) {\n      for (const [_key, object] of Object.entries(manifest.objects)) {\n        const schema = object.schema;\n        if (!schema?.tableName) continue;\n        const className: string = object.className || _key;\n        entries.push({\n          schema,\n          source: `${manifest.packageName || '?'}:${className}`,\n        });\n        if (schema.columns && Object.keys(schema.columns).length > 0) {\n          const merged = manifestColumns.get(schema.tableName) ?? {};\n          for (const [name, column] of Object.entries(schema.columns)) {\n            if (!(name in merged)) merged[name] = column;\n          }\n          manifestColumns.set(schema.tableName, merged);\n        }\n      }\n    }\n\n    const tables = new Map<string, AggregatedTable>();\n    for (const [tableName, table] of collectManifestTables(entries)) {\n      const rendered = renderCollectedManifestTable(table, engine);\n      tables.set(tableName, {\n        tableName,\n        ddl: rendered.createTable,\n        indexes: rendered.indexes,\n        sources: table.sources,\n        columns: manifestColumns.get(tableName),\n      });\n    }\n\n    return tables;\n  }\n\n  /**\n   * Apply minimal filtering to remove infrastructure/collection tables.\n   */\n  private applyMinimalFilter(\n    tables: Map<string, AggregatedTable>,\n    options: AggregateOptions,\n  ): void {\n    const skipPatterns =\n      options.minimalSkipPatterns || DEFAULT_MINIMAL_SKIP_PATTERNS;\n    const skipTables = new Set(options.minimalSkipTables || []);\n\n    for (const tableName of Array.from(tables.keys())) {\n      if (skipTables.has(tableName)) {\n        tables.delete(tableName);\n        continue;\n      }\n      for (const pattern of skipPatterns) {\n        if (pattern.test(tableName)) {\n          tables.delete(tableName);\n          break;\n        }\n      }\n    }\n  }\n\n  /**\n   * Generate combined SQL from aggregated tables.\n   */\n  private generateSQL(\n    tables: Map<string, AggregatedTable>,\n    options: AggregateOptions,\n  ): string {\n    const lines: string[] = [\n      '-- Combined SMRT Database Schema',\n      `-- Generated: ${new Date().toISOString()}`,\n      '',\n    ];\n\n    if (options.dialect === 'sqlite') {\n      lines.push('PRAGMA foreign_keys = ON;', '');\n    }\n\n    // Sort tables by name for deterministic output\n    const sortedTables = Array.from(tables.entries()).sort((a, b) =>\n      a[0].localeCompare(b[0]),\n    );\n\n    for (const [tableName, table] of sortedTables) {\n      lines.push(`-- Table: ${tableName}`);\n      if (table.sources.length > 1) {\n        lines.push(`-- STI table, sources: ${table.sources.join(', ')}`);\n      } else {\n        lines.push(`-- Source: ${table.sources[0]}`);\n      }\n      lines.push(table.ddl);\n      lines.push('');\n\n      if (table.indexes.length > 0) {\n        for (const idx of table.indexes) {\n          lines.push(idx);\n        }\n        lines.push('');\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n"],"mappings":"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"}

package/dist/schema/system-table-shapes.d.ts

@@ -0,0 +1,52 @@
+import { DatabaseEngine } from './ddl/types.js';
+/** One column as declared by hand-written system-table DDL. */
+export interface SystemTableColumnShape {
+    name: string;
+    /**
+     * The engine-materialized type text exactly as declared (`TEXT`, `BIGINT`,
+     * `TIMESTAMPTZ`, …). System DDL is materialized per engine by
+     * `getSystemTableDDL()`, so no abstract-type mapping is involved.
+     */
+    type: string;
+    primaryKey: boolean;
+    notNull: boolean;
+    unique: boolean;
+    hasDefault: boolean;
+}
+/** One index as declared by hand-written system-table DDL. */
+export interface SystemTableIndexShape {
+    name: string;
+    columns: string[];
+    unique: boolean;
+    where?: string;
+}
+/** The complete declared shape of one `_smrt_*` table. */
+export interface SystemTableShape {
+    tableName: string;
+    columns: SystemTableColumnShape[];
+    indexes: SystemTableIndexShape[];
+    /**
+     * Column sets declared by inline `UNIQUE (...)` table constraints. These
+     * back framework upserts but materialize as implicit indexes
+     * (`sqlite_autoindex_*` / `<table>_key`) that name-based introspection
+     * misses, so they are tracked separately from {@link indexes}.
+     */
+    uniqueConstraints: string[][];
+}
+/**
+ * Parse the complete system-table DDL for an engine into table shapes.
+ *
+ * @param engine - Target engine; selects the materialized DDL variant
+ *   (PostgreSQL uses TIMESTAMPTZ where the portable DDL says TIMESTAMP).
+ * @returns One shape per declared `_smrt_*` table, keyed by table name.
+ */
+export declare function getSystemTableShapes(engine: DatabaseEngine): Map<string, SystemTableShape>;
+/**
+ * Parse an arbitrary DDL script into table shapes.
+ *
+ * Exported for tests and for callers that materialize system DDL themselves.
+ * Statements the parser does not understand are skipped silently — this is a
+ * diagnostic input, never an execution path.
+ */
+export declare function parseTableShapes(ddl: string): Map<string, SystemTableShape>;
+//# sourceMappingURL=system-table-shapes.d.ts.map

package/dist/schema/system-table-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-table-shapes.d.ts","sourceRoot":"","sources":["../../src/schema/system-table-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,EAAE,EAAE,CAAC;CAC/B;AAqBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GACrB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE/B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA8B3E"}

package/dist/schema/system-table-shapes.js

@@ -0,0 +1,174 @@
+import { getSystemTableDDL } from "../system/schema.js";
+//#region src/schema/system-table-shapes.ts
+/**
+* System-table shape parsing (#2368)
+*
+* `_smrt_*` tables are created from hand-written DDL in `src/system/schema.ts`
+* rather than from decorated classes, so they never enter the manifest and the
+* manifest-driven differ has never compared them against a live database.
+*
+* This module parses that DDL back into a structural description — columns,
+* declared indexes, and inline `UNIQUE (...)` constraints — so the live-schema
+* parity check can hold system tables to the same standard as application
+* tables. The DDL is the source of truth for these tables; parsing it (rather
+* than duplicating a hand-maintained expectation table) keeps the two from
+* drifting apart.
+*
+* The parser is deliberately narrow: it understands the portable subset SMRT
+* actually writes (`CREATE TABLE IF NOT EXISTS`, `CREATE [UNIQUE] INDEX IF NOT
+* EXISTS`, simple column definitions, inline `UNIQUE`/`PRIMARY KEY` table
+* constraints) and ignores anything else rather than guessing.
+*/
+var CREATE_TABLE_RE = /^CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?("?)([A-Za-z_][\w$]*)\1\s*\(/i;
+var CREATE_INDEX_RE = /^CREATE\s+(UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?("?)([A-Za-z_][\w$]*)\2\s+ON\s+("?)([A-Za-z_][\w$]*)\4\s*\(([^)]*)\)\s*(?:WHERE\s+([\s\S]+))?$/i;
+/**
+* Table-level constraint clauses that carry no column-shape information.
+*
+* Anchored on a following delimiter rather than a bare prefix so a column
+* legitimately named `checksum` is not mistaken for a `CHECK` constraint.
+*/
+var IGNORED_CONSTRAINT_PATTERNS = [
+	/^CHECK\s*\(/i,
+	/^FOREIGN\s+KEY\b/i,
+	/^CONSTRAINT\s+/i,
+	/^EXCLUDE\b/i
+];
+/**
+* Parse the complete system-table DDL for an engine into table shapes.
+*
+* @param engine - Target engine; selects the materialized DDL variant
+*   (PostgreSQL uses TIMESTAMPTZ where the portable DDL says TIMESTAMP).
+* @returns One shape per declared `_smrt_*` table, keyed by table name.
+*/
+function getSystemTableShapes(engine) {
+	return parseTableShapes(getSystemTableDDL(engine).join("\n"));
+}
+/**
+* Parse an arbitrary DDL script into table shapes.
+*
+* Exported for tests and for callers that materialize system DDL themselves.
+* Statements the parser does not understand are skipped silently — this is a
+* diagnostic input, never an execution path.
+*/
+function parseTableShapes(ddl) {
+	const shapes = /* @__PURE__ */ new Map();
+	for (const statement of splitStatements(stripComments(ddl))) {
+		const tableMatch = statement.match(CREATE_TABLE_RE);
+		if (tableMatch) {
+			const shape = parseCreateTable(statement, tableMatch[2]);
+			if (shape) shapes.set(shape.tableName, shape);
+			continue;
+		}
+		const indexMatch = statement.match(CREATE_INDEX_RE);
+		if (!indexMatch) continue;
+		const [, uniqueKeyword, , indexName, , tableName, columnList, where] = indexMatch;
+		const shape = shapes.get(tableName);
+		if (!shape) continue;
+		shape.indexes.push({
+			name: indexName,
+			columns: splitColumnList(columnList),
+			unique: Boolean(uniqueKeyword),
+			...where ? { where: where.trim() } : {}
+		});
+	}
+	return shapes;
+}
+/** Remove `--` line comments so they cannot be mistaken for statements. */
+function stripComments(ddl) {
+	return ddl.replace(/--[^\n]*/g, "");
+}
+/** Split a DDL script on statement terminators, dropping empty fragments. */
+function splitStatements(ddl) {
+	return ddl.split(";").map((statement) => statement.trim()).filter((statement) => statement.length > 0);
+}
+function parseCreateTable(statement, tableName) {
+	const open = statement.indexOf("(");
+	const close = statement.lastIndexOf(")");
+	if (open === -1 || close === -1 || close <= open) return null;
+	const shape = {
+		tableName,
+		columns: [],
+		indexes: [],
+		uniqueConstraints: []
+	};
+	for (const item of splitTopLevel(statement.slice(open + 1, close))) {
+		const uniqueConstraint = item.match(/^UNIQUE\s*\(([^)]*)\)$/i);
+		if (uniqueConstraint) {
+			shape.uniqueConstraints.push(splitColumnList(uniqueConstraint[1]));
+			continue;
+		}
+		if (/^PRIMARY\s+KEY\s*\(/i.test(item)) {
+			const primaryKeyColumns = item.match(/^PRIMARY\s+KEY\s*\(([^)]*)\)$/i);
+			if (primaryKeyColumns) {
+				const columnNames = new Set(splitColumnList(primaryKeyColumns[1]));
+				for (const column of shape.columns) if (columnNames.has(column.name)) column.primaryKey = true;
+			}
+			continue;
+		}
+		if (IGNORED_CONSTRAINT_PATTERNS.some((pattern) => pattern.test(item))) continue;
+		const column = parseColumnDefinition(item);
+		if (column) shape.columns.push(column);
+	}
+	return shape;
+}
+/**
+* Multi-word type tails SMRT's portable DDL can produce. Kept explicit so a
+* trailing constraint keyword is never absorbed into the type text.
+*/
+var MULTI_WORD_TYPE_TAILS = [
+	"WITH TIME ZONE",
+	"WITHOUT TIME ZONE",
+	"PRECISION",
+	"VARYING"
+];
+function parseColumnDefinition(item) {
+	const tokens = item.split(/\s+/);
+	if (tokens.length < 2) return null;
+	const name = unquoteIdentifier(tokens[0]);
+	if (!/^[A-Za-z_][\w$]*$/.test(name)) return null;
+	let type = tokens[1];
+	let rest = tokens.slice(2).join(" ");
+	for (const tail of MULTI_WORD_TYPE_TAILS) if (rest.toUpperCase().startsWith(tail)) {
+		type = `${type} ${rest.slice(0, tail.length)}`;
+		rest = rest.slice(tail.length).trim();
+		break;
+	}
+	const restUpper = rest.toUpperCase();
+	return {
+		name,
+		type,
+		primaryKey: /\bPRIMARY\s+KEY\b/.test(restUpper),
+		notNull: /\bNOT\s+NULL\b/.test(restUpper),
+		unique: /\bUNIQUE\b/.test(restUpper),
+		hasDefault: /\bDEFAULT\b/.test(restUpper)
+	};
+}
+/** Split a parenthesized column list into bare column names. */
+function splitColumnList(columnList) {
+	return columnList.split(",").map((column) => unquoteIdentifier(column.trim())).filter((column) => column.length > 0);
+}
+/** Split on commas that sit outside any parenthesis nesting. */
+function splitTopLevel(body) {
+	const items = [];
+	let depth = 0;
+	let current = "";
+	for (const char of body) {
+		if (char === "(") depth++;
+		if (char === ")") depth--;
+		if (char === "," && depth === 0) {
+			items.push(current.trim());
+			current = "";
+			continue;
+		}
+		current += char;
+	}
+	if (current.trim().length > 0) items.push(current.trim());
+	return items.map((item) => item.replace(/\s+/g, " ").trim()).filter((item) => item.length > 0);
+}
+function unquoteIdentifier(identifier) {
+	return identifier.replace(/^["`[]|["`\]]$/g, "");
+}
+//#endregion
+export { getSystemTableShapes, parseTableShapes };
+
+//# sourceMappingURL=system-table-shapes.js.map

package/dist/schema/system-table-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-table-shapes.js","names":[],"sources":["../../src/schema/system-table-shapes.ts"],"sourcesContent":["/**\n * System-table shape parsing (#2368)\n *\n * `_smrt_*` tables are created from hand-written DDL in `src/system/schema.ts`\n * rather than from decorated classes, so they never enter the manifest and the\n * manifest-driven differ has never compared them against a live database.\n *\n * This module parses that DDL back into a structural description — columns,\n * declared indexes, and inline `UNIQUE (...)` constraints — so the live-schema\n * parity check can hold system tables to the same standard as application\n * tables. The DDL is the source of truth for these tables; parsing it (rather\n * than duplicating a hand-maintained expectation table) keeps the two from\n * drifting apart.\n *\n * The parser is deliberately narrow: it understands the portable subset SMRT\n * actually writes (`CREATE TABLE IF NOT EXISTS`, `CREATE [UNIQUE] INDEX IF NOT\n * EXISTS`, simple column definitions, inline `UNIQUE`/`PRIMARY KEY` table\n * constraints) and ignores anything else rather than guessing.\n */\n\nimport { getSystemTableDDL } from '../system/schema.js';\nimport type { DatabaseEngine } from './ddl/types.js';\n\n/** One column as declared by hand-written system-table DDL. */\nexport interface SystemTableColumnShape {\n  name: string;\n  /**\n   * The engine-materialized type text exactly as declared (`TEXT`, `BIGINT`,\n   * `TIMESTAMPTZ`, …). System DDL is materialized per engine by\n   * `getSystemTableDDL()`, so no abstract-type mapping is involved.\n   */\n  type: string;\n  primaryKey: boolean;\n  notNull: boolean;\n  unique: boolean;\n  hasDefault: boolean;\n}\n\n/** One index as declared by hand-written system-table DDL. */\nexport interface SystemTableIndexShape {\n  name: string;\n  columns: string[];\n  unique: boolean;\n  where?: string;\n}\n\n/** The complete declared shape of one `_smrt_*` table. */\nexport interface SystemTableShape {\n  tableName: string;\n  columns: SystemTableColumnShape[];\n  indexes: SystemTableIndexShape[];\n  /**\n   * Column sets declared by inline `UNIQUE (...)` table constraints. These\n   * back framework upserts but materialize as implicit indexes\n   * (`sqlite_autoindex_*` / `<table>_key`) that name-based introspection\n   * misses, so they are tracked separately from {@link indexes}.\n   */\n  uniqueConstraints: string[][];\n}\n\nconst CREATE_TABLE_RE =\n  /^CREATE\\s+TABLE\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(\"?)([A-Za-z_][\\w$]*)\\1\\s*\\(/i;\n\nconst CREATE_INDEX_RE =\n  /^CREATE\\s+(UNIQUE\\s+)?INDEX\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(\"?)([A-Za-z_][\\w$]*)\\2\\s+ON\\s+(\"?)([A-Za-z_][\\w$]*)\\4\\s*\\(([^)]*)\\)\\s*(?:WHERE\\s+([\\s\\S]+))?$/i;\n\n/**\n * Table-level constraint clauses that carry no column-shape information.\n *\n * Anchored on a following delimiter rather than a bare prefix so a column\n * legitimately named `checksum` is not mistaken for a `CHECK` constraint.\n */\nconst IGNORED_CONSTRAINT_PATTERNS = [\n  /^CHECK\\s*\\(/i,\n  /^FOREIGN\\s+KEY\\b/i,\n  /^CONSTRAINT\\s+/i,\n  /^EXCLUDE\\b/i,\n];\n\n/**\n * Parse the complete system-table DDL for an engine into table shapes.\n *\n * @param engine - Target engine; selects the materialized DDL variant\n *   (PostgreSQL uses TIMESTAMPTZ where the portable DDL says TIMESTAMP).\n * @returns One shape per declared `_smrt_*` table, keyed by table name.\n */\nexport function getSystemTableShapes(\n  engine: DatabaseEngine,\n): Map<string, SystemTableShape> {\n  return parseTableShapes(getSystemTableDDL(engine).join('\\n'));\n}\n\n/**\n * Parse an arbitrary DDL script into table shapes.\n *\n * Exported for tests and for callers that materialize system DDL themselves.\n * Statements the parser does not understand are skipped silently — this is a\n * diagnostic input, never an execution path.\n */\nexport function parseTableShapes(ddl: string): Map<string, SystemTableShape> {\n  const shapes = new Map<string, SystemTableShape>();\n\n  for (const statement of splitStatements(stripComments(ddl))) {\n    const tableMatch = statement.match(CREATE_TABLE_RE);\n    if (tableMatch) {\n      const shape = parseCreateTable(statement, tableMatch[2]);\n      if (shape) {\n        shapes.set(shape.tableName, shape);\n      }\n      continue;\n    }\n\n    const indexMatch = statement.match(CREATE_INDEX_RE);\n    if (!indexMatch) continue;\n\n    const [, uniqueKeyword, , indexName, , tableName, columnList, where] =\n      indexMatch;\n    const shape = shapes.get(tableName);\n    if (!shape) continue;\n\n    shape.indexes.push({\n      name: indexName,\n      columns: splitColumnList(columnList),\n      unique: Boolean(uniqueKeyword),\n      ...(where ? { where: where.trim() } : {}),\n    });\n  }\n\n  return shapes;\n}\n\n/** Remove `--` line comments so they cannot be mistaken for statements. */\nfunction stripComments(ddl: string): string {\n  return ddl.replace(/--[^\\n]*/g, '');\n}\n\n/** Split a DDL script on statement terminators, dropping empty fragments. */\nfunction splitStatements(ddl: string): string[] {\n  return ddl\n    .split(';')\n    .map((statement) => statement.trim())\n    .filter((statement) => statement.length > 0);\n}\n\nfunction parseCreateTable(\n  statement: string,\n  tableName: string,\n): SystemTableShape | null {\n  const open = statement.indexOf('(');\n  const close = statement.lastIndexOf(')');\n  if (open === -1 || close === -1 || close <= open) {\n    return null;\n  }\n\n  const shape: SystemTableShape = {\n    tableName,\n    columns: [],\n    indexes: [],\n    uniqueConstraints: [],\n  };\n\n  for (const item of splitTopLevel(statement.slice(open + 1, close))) {\n    const uniqueConstraint = item.match(/^UNIQUE\\s*\\(([^)]*)\\)$/i);\n    if (uniqueConstraint) {\n      shape.uniqueConstraints.push(splitColumnList(uniqueConstraint[1]));\n      continue;\n    }\n\n    if (/^PRIMARY\\s+KEY\\s*\\(/i.test(item)) {\n      const primaryKeyColumns = item.match(/^PRIMARY\\s+KEY\\s*\\(([^)]*)\\)$/i);\n      if (primaryKeyColumns) {\n        const columnNames = new Set(splitColumnList(primaryKeyColumns[1]));\n        for (const column of shape.columns) {\n          if (columnNames.has(column.name)) {\n            column.primaryKey = true;\n          }\n        }\n      }\n      continue;\n    }\n\n    if (IGNORED_CONSTRAINT_PATTERNS.some((pattern) => pattern.test(item))) {\n      continue;\n    }\n\n    const column = parseColumnDefinition(item);\n    if (column) {\n      shape.columns.push(column);\n    }\n  }\n\n  return shape;\n}\n\n/**\n * Multi-word type tails SMRT's portable DDL can produce. Kept explicit so a\n * trailing constraint keyword is never absorbed into the type text.\n */\nconst MULTI_WORD_TYPE_TAILS = [\n  'WITH TIME ZONE',\n  'WITHOUT TIME ZONE',\n  'PRECISION',\n  'VARYING',\n];\n\nfunction parseColumnDefinition(item: string): SystemTableColumnShape | null {\n  const tokens = item.split(/\\s+/);\n  if (tokens.length < 2) return null;\n\n  const name = unquoteIdentifier(tokens[0]);\n  if (!/^[A-Za-z_][\\w$]*$/.test(name)) return null;\n\n  let type = tokens[1];\n  let rest = tokens.slice(2).join(' ');\n  for (const tail of MULTI_WORD_TYPE_TAILS) {\n    if (rest.toUpperCase().startsWith(tail)) {\n      type = `${type} ${rest.slice(0, tail.length)}`;\n      rest = rest.slice(tail.length).trim();\n      break;\n    }\n  }\n\n  const restUpper = rest.toUpperCase();\n  return {\n    name,\n    type,\n    primaryKey: /\\bPRIMARY\\s+KEY\\b/.test(restUpper),\n    notNull: /\\bNOT\\s+NULL\\b/.test(restUpper),\n    unique: /\\bUNIQUE\\b/.test(restUpper),\n    hasDefault: /\\bDEFAULT\\b/.test(restUpper),\n  };\n}\n\n/** Split a parenthesized column list into bare column names. */\nfunction splitColumnList(columnList: string): string[] {\n  return columnList\n    .split(',')\n    .map((column) => unquoteIdentifier(column.trim()))\n    .filter((column) => column.length > 0);\n}\n\n/** Split on commas that sit outside any parenthesis nesting. */\nfunction splitTopLevel(body: string): string[] {\n  const items: string[] = [];\n  let depth = 0;\n  let current = '';\n\n  for (const char of body) {\n    if (char === '(') depth++;\n    if (char === ')') depth--;\n    if (char === ',' && depth === 0) {\n      items.push(current.trim());\n      current = '';\n      continue;\n    }\n    current += char;\n  }\n\n  if (current.trim().length > 0) {\n    items.push(current.trim());\n  }\n\n  return items\n    .map((item) => item.replace(/\\s+/g, ' ').trim())\n    .filter((item) => item.length > 0);\n}\n\nfunction unquoteIdentifier(identifier: string): string {\n  return identifier.replace(/^[\"`[]|[\"`\\]]$/g, '');\n}\n"],"mappings":"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"}