@happyvertical/smrt-core 0.30.0

package/dist/schema/table-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-verifier.d.ts","sourceRoot":"","sources":["../../src/schema/table-verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAsC5D;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/schema/table-verifier.js

@@ -0,0 +1,37 @@
+import { DatabaseError } from "../errors.js";
+import { isTableVerified, markTableVerified } from "../table-cache.js";
+const memoryVerificationKeys = /* @__PURE__ */ new WeakMap();
+let nextMemoryVerificationId = 0;
+function getVerificationKey(db) {
+  const dbWithConfig = db;
+  const dbid = dbWithConfig.dbid || dbWithConfig.config?.dbid;
+  if (dbid) {
+    return dbid;
+  }
+  const dbUrl = db.url || dbWithConfig.config?.url;
+  if (dbUrl && dbUrl !== ":memory:" && dbUrl !== "memory" && dbUrl !== "file::memory:") {
+    return dbUrl;
+  }
+  let memoryKey = memoryVerificationKeys.get(db);
+  if (!memoryKey) {
+    nextMemoryVerificationId += 1;
+    memoryKey = `memory:${nextMemoryVerificationId}`;
+    memoryVerificationKeys.set(db, memoryKey);
+  }
+  return memoryKey;
+}
+async function verifyPersistenceTable(db, tableName, className) {
+  const verificationKey = getVerificationKey(db);
+  if (isTableVerified(verificationKey, tableName)) {
+    return;
+  }
+  const tableExists = await db.tableExists(tableName);
+  if (!tableExists) {
+    throw DatabaseError.schemaMissing(tableName, className);
+  }
+  markTableVerified(verificationKey, tableName);
+}
+export {
+  verifyPersistenceTable
+};
+//# sourceMappingURL=table-verifier.js.map

package/dist/schema/table-verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-verifier.js","sources":["../../src/schema/table-verifier.ts"],"sourcesContent":["import type { DatabaseInterface } from '@happyvertical/sql';\nimport { DatabaseError } from '../errors.js';\nimport { isTableVerified, markTableVerified } from '../table-cache.js';\n\nconst memoryVerificationKeys = new WeakMap<DatabaseInterface, string>();\nlet nextMemoryVerificationId = 0;\n\nfunction getVerificationKey(db: DatabaseInterface): string {\n  const dbWithConfig = db as DatabaseInterface & {\n    dbid?: string;\n    config?: { dbid?: string; url?: string };\n  };\n\n  const dbid = dbWithConfig.dbid || dbWithConfig.config?.dbid;\n  if (dbid) {\n    return dbid;\n  }\n\n  const dbUrl = db.url || dbWithConfig.config?.url;\n  if (\n    dbUrl &&\n    dbUrl !== ':memory:' &&\n    dbUrl !== 'memory' &&\n    dbUrl !== 'file::memory:'\n  ) {\n    return dbUrl;\n  }\n\n  let memoryKey = memoryVerificationKeys.get(db);\n  if (!memoryKey) {\n    nextMemoryVerificationId += 1;\n    memoryKey = `memory:${nextMemoryVerificationId}`;\n    memoryVerificationKeys.set(db, memoryKey);\n  }\n\n  return memoryKey;\n}\n\n/**\n * Verify that a model table already exists.\n *\n * Runtime no longer creates application tables implicitly. This helper is the\n * shared fail-fast path used by collections and objects before they touch app\n * tables, while still caching successful checks to avoid repeated round-trips.\n */\nexport async function verifyPersistenceTable(\n  db: DatabaseInterface,\n  tableName: string,\n  className: string,\n): Promise<void> {\n  const verificationKey = getVerificationKey(db);\n  if (isTableVerified(verificationKey, tableName)) {\n    return;\n  }\n\n  const tableExists = await db.tableExists(tableName);\n  if (!tableExists) {\n    throw DatabaseError.schemaMissing(tableName, className);\n  }\n\n  markTableVerified(verificationKey, tableName);\n}\n"],"names":[],"mappings":";;AAIA,MAAM,6CAA6B,QAAA;AACnC,IAAI,2BAA2B;AAE/B,SAAS,mBAAmB,IAA+B;AACzD,QAAM,eAAe;AAKrB,QAAM,OAAO,aAAa,QAAQ,aAAa,QAAQ;AACvD,MAAI,MAAM;AACR,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,GAAG,OAAO,aAAa,QAAQ;AAC7C,MACE,SACA,UAAU,cACV,UAAU,YACV,UAAU,iBACV;AACA,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,uBAAuB,IAAI,EAAE;AAC7C,MAAI,CAAC,WAAW;AACd,gCAA4B;AAC5B,gBAAY,UAAU,wBAAwB;AAC9C,2BAAuB,IAAI,IAAI,SAAS;AAAA,EAC1C;AAEA,SAAO;AACT;AASA,eAAsB,uBACpB,IACA,WACA,WACe;AACf,QAAM,kBAAkB,mBAAmB,EAAE;AAC7C,MAAI,gBAAgB,iBAAiB,SAAS,GAAG;AAC/C;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,GAAG,YAAY,SAAS;AAClD,MAAI,CAAC,aAAa;AAChB,UAAM,cAAc,cAAc,WAAW,SAAS;AAAA,EACxD;AAEA,oBAAkB,iBAAiB,SAAS;AAC9C;"}

package/dist/schema/types.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Schema definition types for SMRT objects
+ * Used for build-time schema generation and runtime table management
+ */
+export type SQLDataType = 'TEXT' | 'INTEGER' | 'REAL' | 'BLOB' | 'BOOLEAN' | 'JSON' | 'TIMESTAMP' | 'UUID';
+export interface ColumnDefinition {
+    type: SQLDataType;
+    primaryKey?: boolean;
+    /**
+     * Non-DDL marker for SMRT-owned identifier/reference columns. The migration
+     * differ uses this to distinguish intentionally UUID-compatible references
+     * from plain text provenance fields whose names may also end in `_id`.
+     */
+    referenceKind?: 'id' | 'foreignKey' | 'crossPackageRef' | 'tenantId';
+    unique?: boolean;
+    notNull?: boolean;
+    defaultValue?: any;
+    foreignKey?: {
+        table: string;
+        column: string;
+        onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
+        onUpdate?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
+    };
+    check?: string;
+    description?: string;
+}
+export interface IndexDefinition {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    where?: string;
+    description?: string;
+    /**
+     * Expression-based index target.
+     *
+     * When set, the DDL strategy renders the index over a JSON path inside
+     * `column` rather than the `columns` list. Used today by `@meta({ indexed: true })`
+     * which targets a key inside the `_meta_data` JSONB column.
+     */
+    jsonPath?: {
+        column: string;
+        path: string;
+    };
+}
+export interface TriggerDefinition {
+    name: string;
+    when: 'BEFORE' | 'AFTER' | 'INSTEAD OF';
+    event: 'INSERT' | 'UPDATE' | 'DELETE';
+    condition?: string;
+    body: string;
+    description?: string;
+}
+export interface ForeignKeyDefinition {
+    column: string;
+    referencesTable: string;
+    referencesColumn: string;
+    onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
+    onUpdate?: 'CASCADE' | 'SET NULL' | 'RESTRICT';
+}
+export interface SchemaDefinition {
+    tableName: string;
+    /** SQL DDL statement for table creation (optional - may be generated lazily) */
+    ddl?: string;
+    columns: Record<string, ColumnDefinition>;
+    indexes: IndexDefinition[];
+    triggers: TriggerDefinition[];
+    foreignKeys: ForeignKeyDefinition[];
+    version: string;
+    dependencies: string[];
+    packageName?: string;
+    baseClass?: string;
+}
+export interface SchemaManifest {
+    version: string;
+    timestamp: number;
+    packageName: string;
+    schemas: Record<string, SchemaDefinition>;
+    dependencies: string[];
+}
+export interface SchemaOverride {
+    tableName: string;
+    addColumns?: Record<string, ColumnDefinition>;
+    removeColumns?: string[];
+    addIndexes?: IndexDefinition[];
+    removeIndexes?: string[];
+    addTriggers?: TriggerDefinition[];
+    removeTriggers?: string[];
+    packageName: string;
+}
+export interface SchemaMigration {
+    id: string;
+    version: string;
+    description: string;
+    up: string[];
+    down: string[];
+    dependencies: string[];
+    packageName: string;
+}
+/**
+ * Status of a schema migration in the tracking table
+ */
+export type MigrationStatus = 'pending' | 'running' | 'completed' | 'failed' | 'rolled_back';
+/**
+ * Record stored in _smrt_schema_migrations table
+ * Tracks applied migrations for idempotency and audit
+ */
+export interface SchemaMigrationRecord {
+    /** UUID primary key */
+    id: string;
+    /** Migration name, e.g., '0001_initial_schema' */
+    name: string;
+    /** SMRT version when migration was created */
+    version: string;
+    /** SHA-256 checksum of migration SQL for idempotency */
+    checksum: string;
+    /** SHA-256 of what was actually applied (for drift detection) */
+    applied_checksum: string | null;
+    /** When the migration was applied */
+    applied_at: Date;
+    /** Execution duration in milliseconds */
+    execution_time_ms: number | null;
+    /** Source SMRT package that defined this migration */
+    package_name: string | null;
+    /** Original migration file path */
+    source_file: string | null;
+    /** Current migration status */
+    status: MigrationStatus;
+    /** Error message if status is 'failed' */
+    error_message: string | null;
+    /** Number of application attempts */
+    attempts: number;
+    /** Whether this migration can be rolled back */
+    is_reversible: boolean;
+    /** When the migration was rolled back (if applicable) */
+    rolled_back_at: Date | null;
+    /** Hostname or identifier of who/what applied the migration */
+    applied_by: string | null;
+    /** Batch number for migrations applied together */
+    batch: number | null;
+}
+/**
+ * Definition for a migration to be applied
+ * Used by db:diff generation and file parsing
+ */
+export interface MigrationDefinition {
+    /** Unique migration identifier, e.g., '0001_add_users_table' */
+    id: string;
+    /** Human-readable description */
+    description: string;
+    /** SMRT version this migration was created for */
+    version: string;
+    /** SQL statements to apply the migration */
+    up: string[];
+    /** SQL statements to rollback the migration */
+    down: string[];
+    /** Other migration IDs this depends on */
+    dependencies?: string[];
+    /** Package that defines this migration */
+    package_name?: string;
+    /** Source file path */
+    source_file?: string;
+    /** Whether this migration can be rolled back */
+    is_reversible?: boolean;
+}
+/**
+ * Result of applying a single migration
+ */
+export interface MigrationResult {
+    /** Whether the migration was successful (no errors) */
+    success: boolean;
+    /** Migration name */
+    name: string;
+    /** SHA-256 checksum of the migration */
+    checksum: string;
+    /** Execution duration in milliseconds */
+    execution_time_ms: number;
+    /** Whether the migration was actually applied (false if already applied) */
+    applied?: boolean;
+    /** Whether the migration was skipped (already applied with same checksum) */
+    skipped?: boolean;
+    /** Error if migration failed */
+    error?: Error | string;
+    /** Whether this was a rollback operation */
+    rolled_back?: boolean;
+}
+/**
+ * Drift detection result for a single migration
+ */
+export interface DriftReport {
+    /** Migration name */
+    migration_name: string;
+    /** Expected checksum from migration definition */
+    expected_checksum: string;
+    /** Actual checksum found in database */
+    actual_checksum: string;
+    /** Type of drift detected */
+    drift_type: 'file_modified' | 'db_modified' | 'missing_in_db' | 'unknown_in_db';
+    /** Suggested action to resolve the drift */
+    recommendation: string;
+}
+/**
+ * Schema difference for a single change
+ */
+export interface SchemaChange {
+    /** Type of change */
+    type: 'add_table' | 'drop_table' | 'add_column' | 'drop_column' | 'add_index' | 'drop_index' | 'type_mismatch' | 'type_upgrade';
+    /** Affected table name */
+    table: string;
+    /** Column or index name (if applicable) */
+    name?: string;
+    /** Column definition (for add_column) */
+    column?: ColumnDefinition;
+    /** Index definition (for add_index) */
+    index?: IndexDefinition;
+    /** For type mismatches and upgrades: expected vs actual */
+    mismatch?: {
+        expected: string;
+        actual: string;
+    };
+    /** Generated SQL statement */
+    sql?: string;
+    /**
+     * Generated SQL statements for changes that require multiple ordered steps.
+     * When omitted, callers should use the single `sql` statement.
+     */
+    sqlStatements?: string[];
+}
+/**
+ * Result of comparing manifest schema to database
+ */
+export interface SchemaDiff {
+    /** New tables to create */
+    added_tables: SchemaDefinition[];
+    /** Tables to drop (only if explicitly requested) */
+    dropped_tables: string[];
+    /** Changes to existing tables */
+    changes: SchemaChange[];
+    /** Whether any differences were found */
+    has_changes: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"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"}

package/dist/schema/utils.d.ts

@@ -0,0 +1,32 @@
+import { DatabaseInterface } from '@happyvertical/sql';
+import { DatabaseEngine } from './ddl/types.js';
+export { isJsonPathIndex, renderIndexTarget } from './index-utils.js';
+/**
+ * Generates a complete database schema SQL statement for a class
+ *
+ * This is a thin wrapper around SchemaGenerator that provides the
+ * single source of truth for schema generation. Uses ObjectRegistry
+ * cached fields from AST manifest for consistent schema generation.
+ *
+ * **Note**: Uses dynamic import for SchemaGenerator to avoid bundling
+ * Node.js-only code (node:crypto) in browser builds.
+ *
+ * @param ClassType - Class constructor to generate schema for
+ * @param providedFields - Optional fields map (used during registration)
+ * @returns SQL schema creation statement with CREATE TABLE and CREATE INDEX statements
+ */
+export declare function generateSchema(ClassType: new (...args: any[]) => any, providedFields?: Map<string, any>, options?: {
+    engine?: DatabaseEngine;
+}): Promise<string>;
+/**
+ * Ensure schema exists for a registered class.
+ *
+ * This compatibility helper is kept for tooling flows such as CLI commands that
+ * explicitly prepare schema ahead of runtime. Core runtime no longer calls this
+ * automatically.
+ *
+ * @deprecated Prefer explicit migration/bootstrap tooling. Runtime verifies
+ * schema and fails fast when tables are missing.
+ */
+export declare function ensureSchema(db: DatabaseInterface, className: string): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/schema/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/schema/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,mBAqI1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyEf"}

package/dist/schema/utils.js

@@ -0,0 +1,134 @@
+import { ObjectRegistry } from "../registry.js";
+import { tableNameFromClass } from "../utils.js";
+import { SchemaManager } from "./schema-manager.js";
+import { isJsonPathIndex, renderIndexTarget } from "./index-utils.js";
+async function generateSchema(ClassType, providedFields, options = {}) {
+  const className = ClassType.name;
+  const tableName = tableNameFromClass(ClassType);
+  if (!providedFields || providedFields.size === 0) {
+    await ObjectRegistry.ensureManifestLoaded(className);
+  }
+  const cachedFields = providedFields && providedFields.size > 0 ? providedFields : await ObjectRegistry.getAllFields(className);
+  if (cachedFields.size === 0) {
+    const isTestEnv = process.env.NODE_ENV === "test" || process.env.VITEST === "true" || typeof globalThis.describe !== "undefined" || typeof globalThis.it !== "undefined";
+    const testHint = isTestEnv ? `
+
+⚠️  Are you using 'smrt test'? Tests require manifest generation.
+   ✅ Use: smrt test
+   ❌ NOT:  npx vitest
+` : "";
+    const isRegistered = ObjectRegistry.hasClass(className);
+    if (isRegistered) {
+      throw new Error(
+        `No field metadata found for class '${className}'. The class is registered (decorator ran) but has no field definitions. This usually means the manifest file is missing or stale.` + testHint
+      );
+    } else {
+      throw new Error(
+        `Cannot generate schema for unregistered class '${className}'. Ensure the class is decorated with @smrt() for schema generation to work. Runtime introspection has been removed per issue #131.` + testHint
+      );
+    }
+  }
+  const tableStrategy = ObjectRegistry.getTableStrategy(className);
+  const { SchemaGenerator } = await import("./generator.js");
+  const generator = new SchemaGenerator();
+  const registeredClass = ObjectRegistry.getClass(className);
+  const runtimeSchemaConfig = registeredClass?.config ? {
+    conflictColumns: registeredClass.config.conflictColumns,
+    idType: registeredClass.config.idType,
+    registry: ObjectRegistry
+  } : void 0;
+  let schemaDefinition;
+  if (tableStrategy === "sti") {
+    const stiBase = ObjectRegistry.getSTIBase(className);
+    if (!stiBase) {
+      throw new Error(
+        `STI strategy detected for '${className}' but no STI base class found. This should not happen - please report this bug.`
+      );
+    }
+    const qualifiedClassName = registeredClass?.qualifiedName ?? registeredClass?.name ?? className;
+    if (qualifiedClassName === stiBase || className === stiBase) {
+      schemaDefinition = await generator.generateSTISchemaFromRegistry(
+        className,
+        tableName,
+        cachedFields,
+        runtimeSchemaConfig
+      );
+    } else {
+      return "";
+    }
+  } else {
+    schemaDefinition = generator.generateSchemaFromRegistry(
+      className,
+      tableName,
+      cachedFields,
+      runtimeSchemaConfig
+    );
+  }
+  if (registeredClass) {
+    registeredClass.schema = schemaDefinition;
+    registeredClass.schema.ddl = generator.generateSQL(
+      schemaDefinition,
+      "sqlite"
+    );
+  }
+  return generator.generateSQL(schemaDefinition, options.engine);
+}
+async function ensureSchema(db, className) {
+  const registered = ObjectRegistry.getClass(className);
+  if (!registered) {
+    throw new Error(
+      `Cannot ensure schema for unregistered class '${className}'. Ensure the class is decorated with @smrt() and registered in the ObjectRegistry.`
+    );
+  }
+  const tableStrategy = ObjectRegistry.getTableStrategy(className);
+  if (tableStrategy === "sti") {
+    const stiBase = ObjectRegistry.getSTIBase(className);
+    const qualifiedClassName = registered.qualifiedName ?? registered.name ?? className;
+    if (stiBase && stiBase !== qualifiedClassName && stiBase !== className) {
+      await ensureSchema(db, stiBase);
+      return;
+    }
+  }
+  let schemaDefinition = ObjectRegistry.getSchema(className);
+  if (tableStrategy === "sti") {
+    const tableName = ObjectRegistry.getTableName(className);
+    if (tableName) {
+      const mergedSchema = ObjectRegistry.getAllSchemasAsDefinitions()[tableName];
+      if (mergedSchema) {
+        schemaDefinition = mergedSchema;
+      }
+    }
+  }
+  if (!schemaDefinition?.tableName) {
+    const providedFields = registered.fields.size > 0 ? registered.fields : void 0;
+    await generateSchema(registered.constructor, providedFields);
+    schemaDefinition = ObjectRegistry.getSchema(className);
+    if (tableStrategy === "sti") {
+      const tableName = ObjectRegistry.getTableName(className);
+      if (tableName) {
+        const mergedSchema = ObjectRegistry.getAllSchemasAsDefinitions()[tableName];
+        if (mergedSchema) {
+          schemaDefinition = mergedSchema;
+        }
+      }
+    }
+  }
+  if (!schemaDefinition?.tableName) {
+    throw new Error(
+      `No schema definition found for class '${className}'. Run the manifest generation/build step before preparing schema.`
+    );
+  }
+  const mergedSchemaDefinition = ObjectRegistry.getAllSchemasAsDefinitions()[schemaDefinition.tableName];
+  const effectiveSchemaDefinition = mergedSchemaDefinition ?? schemaDefinition;
+  const schemaManager = new SchemaManager(db, {
+    skipTriggers: typeof db.exportTable === "function"
+  });
+  await schemaManager.ensureTable(effectiveSchemaDefinition);
+}
+export {
+  ensureSchema,
+  generateSchema,
+  isJsonPathIndex,
+  renderIndexTarget
+};
+//# sourceMappingURL=utils.js.map

package/dist/schema/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../src/schema/utils.ts"],"sourcesContent":["/**\n * Schema generation utilities - Node.js only\n *\n * These functions use SchemaGenerator which depends on node:crypto.\n * Separated from main utils.ts to prevent bundling in browser builds.\n *\n * SMRT handles ALL database maintenance directly.\n * SDK SQL remains a pure query/CRUD layer.\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport { ObjectRegistry } from '../registry.js';\nimport { tableNameFromClass } from '../utils.js';\nimport type { DatabaseEngine } from './ddl/types.js';\nimport { SchemaManager } from './schema-manager.js';\n\n// Index-rendering helpers live in a separate file to avoid pulling the\n// heavyweight registry/collection module graph into the DDL strategies.\nexport { isJsonPathIndex, renderIndexTarget } from './index-utils.js';\n\n/**\n * Generates a complete database schema SQL statement for a class\n *\n * This is a thin wrapper around SchemaGenerator that provides the\n * single source of truth for schema generation. Uses ObjectRegistry\n * cached fields from AST manifest for consistent schema generation.\n *\n * **Note**: Uses dynamic import for SchemaGenerator to avoid bundling\n * Node.js-only code (node:crypto) in browser builds.\n *\n * @param ClassType - Class constructor to generate schema for\n * @param providedFields - Optional fields map (used during registration)\n * @returns SQL schema creation statement with CREATE TABLE and CREATE INDEX statements\n */\nexport async function generateSchema(\n  ClassType: new (...args: any[]) => any,\n  providedFields?: Map<string, any>,\n  options: { engine?: DatabaseEngine } = {},\n) {\n  const className = ClassType.name;\n  const tableName = tableNameFromClass(ClassType);\n\n  // For external packages, ensure manifest is loaded before proceeding\n  if (!providedFields || providedFields.size === 0) {\n    await ObjectRegistry.ensureManifestLoaded(className);\n  }\n\n  // Use provided fields if available AND non-empty (during registration), otherwise get from registry\n  // NEW: Use getAllFields() to include inherited fields from parent classes\n  const cachedFields =\n    providedFields && providedFields.size > 0\n      ? providedFields\n      : await ObjectRegistry.getAllFields(className);\n\n  // Throw error if no fields found\n  if (cachedFields.size === 0) {\n    // Detect if running in test environment\n    const isTestEnv =\n      process.env.NODE_ENV === 'test' ||\n      process.env.VITEST === 'true' ||\n      typeof (globalThis as any).describe !== 'undefined' ||\n      typeof (globalThis as any).it !== 'undefined';\n\n    const testHint = isTestEnv\n      ? `\\n\\n⚠️  Are you using 'smrt test'? ` +\n        `Tests require manifest generation.\\n` +\n        `   ✅ Use: smrt test\\n` +\n        `   ❌ NOT:  npx vitest\\n`\n      : '';\n\n    // Check if class is actually registered (decorator ran but no fields loaded)\n    const isRegistered = ObjectRegistry.hasClass(className);\n\n    if (isRegistered) {\n      // Class registered but no fields - manifest problem\n      throw new Error(\n        `No field metadata found for class '${className}'. ` +\n          `The class is registered (decorator ran) but has no field definitions. ` +\n          `This usually means the manifest file is missing or stale.` +\n          testHint,\n      );\n    } else {\n      // Class not registered - decorator never ran\n      throw new Error(\n        `Cannot generate schema for unregistered class '${className}'. ` +\n          `Ensure the class is decorated with @smrt() for schema generation to work. ` +\n          `Runtime introspection has been removed per issue #131.` +\n          testHint,\n      );\n    }\n  }\n\n  // Check if class uses STI strategy\n  const tableStrategy = ObjectRegistry.getTableStrategy(className);\n\n  // Dynamic import SchemaGenerator (Node.js-only, uses node:crypto)\n  // This prevents bundling it into browser builds\n  const { SchemaGenerator } = await import('./generator.js');\n  const generator = new SchemaGenerator();\n  const registeredClass = ObjectRegistry.getClass(className);\n  const runtimeSchemaConfig = registeredClass?.config\n    ? {\n        conflictColumns: registeredClass.config.conflictColumns,\n        idType: registeredClass.config.idType,\n        registry: ObjectRegistry,\n      }\n    : undefined;\n\n  let schemaDefinition: Awaited<\n    ReturnType<\n      InstanceType<typeof SchemaGenerator>['generateSchemaFromRegistry']\n    >\n  >;\n\n  if (tableStrategy === 'sti') {\n    // STI: Generate shared table for base class\n    const stiBase = ObjectRegistry.getSTIBase(className);\n\n    if (!stiBase) {\n      throw new Error(\n        `STI strategy detected for '${className}' but no STI base class found. ` +\n          `This should not happen - please report this bug.`,\n      );\n    }\n\n    // Only generate schema for the base class (not for children).\n    // R5-canon: `getSTIBase` returns the qualified name; compare against\n    // the qualified form of this class so an STI base isn't\n    // mis-classified as a subclass and skipped.\n    const qualifiedClassName =\n      registeredClass?.qualifiedName ?? registeredClass?.name ?? className;\n    if (qualifiedClassName === stiBase || className === stiBase) {\n      // This is the base class - generate STI schema\n      schemaDefinition = await generator.generateSTISchemaFromRegistry(\n        className,\n        tableName,\n        cachedFields,\n        runtimeSchemaConfig,\n      );\n    } else {\n      // This is a child class - return null or empty schema\n      // The base class schema already includes all fields\n      // Child classes don't need their own tables\n      return ''; // Empty SQL - table already created by base class\n    }\n  } else {\n    // CTI: Generate separate table for each class\n    schemaDefinition = generator.generateSchemaFromRegistry(\n      className,\n      tableName,\n      cachedFields,\n      runtimeSchemaConfig,\n    );\n  }\n\n  // Store the full schema definition in the registry\n  // This is critical for:\n  // - STI tables where descendants have additional columns (issue #427)\n  // - Per-engine DDL generation via SchemaManager\n  if (registeredClass) {\n    // Store the full SchemaDefinition for SchemaManager to use\n    registeredClass.schema = schemaDefinition;\n    // Also store generated DDL for backward compatibility\n    registeredClass.schema.ddl = generator.generateSQL(\n      schemaDefinition,\n      'sqlite',\n    );\n  }\n\n  return generator.generateSQL(schemaDefinition, options.engine);\n}\n\n/**\n * Ensure schema exists for a registered class.\n *\n * This compatibility helper is kept for tooling flows such as CLI commands that\n * explicitly prepare schema ahead of runtime. Core runtime no longer calls this\n * automatically.\n *\n * @deprecated Prefer explicit migration/bootstrap tooling. Runtime verifies\n * schema and fails fast when tables are missing.\n */\nexport async function ensureSchema(\n  db: DatabaseInterface,\n  className: string,\n): Promise<void> {\n  const registered = ObjectRegistry.getClass(className);\n  if (!registered) {\n    throw new Error(\n      `Cannot ensure schema for unregistered class '${className}'. ` +\n        `Ensure the class is decorated with @smrt() and registered in the ObjectRegistry.`,\n    );\n  }\n\n  const tableStrategy = ObjectRegistry.getTableStrategy(className);\n  if (tableStrategy === 'sti') {\n    const stiBase = ObjectRegistry.getSTIBase(className);\n    // R5-canon: `getSTIBase` returns the qualified name. Compare\n    // against the qualified form of `className` so an STI base isn't\n    // mis-classified as a child and recursed on. Falls back to a\n    // simple-name compare for classes without a package context.\n    const qualifiedClassName =\n      registered.qualifiedName ?? registered.name ?? className;\n    if (stiBase && stiBase !== qualifiedClassName && stiBase !== className) {\n      await ensureSchema(db, stiBase);\n      return;\n    }\n  }\n\n  let schemaDefinition = ObjectRegistry.getSchema(className);\n  if (tableStrategy === 'sti') {\n    const tableName = ObjectRegistry.getTableName(className);\n    if (tableName) {\n      const mergedSchema =\n        ObjectRegistry.getAllSchemasAsDefinitions()[tableName];\n      if (mergedSchema) {\n        schemaDefinition = mergedSchema;\n      }\n    }\n  }\n\n  if (!schemaDefinition?.tableName) {\n    const providedFields =\n      registered.fields.size > 0 ? registered.fields : undefined;\n    await generateSchema(registered.constructor, providedFields);\n    schemaDefinition = ObjectRegistry.getSchema(className);\n\n    if (tableStrategy === 'sti') {\n      const tableName = ObjectRegistry.getTableName(className);\n      if (tableName) {\n        const mergedSchema =\n          ObjectRegistry.getAllSchemasAsDefinitions()[tableName];\n        if (mergedSchema) {\n          schemaDefinition = mergedSchema;\n        }\n      }\n    }\n  }\n\n  if (!schemaDefinition?.tableName) {\n    throw new Error(\n      `No schema definition found for class '${className}'. ` +\n        `Run the manifest generation/build step before preparing schema.`,\n    );\n  }\n\n  // Use the merged table definition for shared tables (especially STI).\n  // Per-class schema metadata can reflect only the current class, while\n  // the database table must include columns from all classes sharing it.\n  const mergedSchemaDefinition =\n    ObjectRegistry.getAllSchemasAsDefinitions()[schemaDefinition.tableName];\n  const effectiveSchemaDefinition = mergedSchemaDefinition ?? schemaDefinition;\n\n  const schemaManager = new SchemaManager(db, {\n    skipTriggers:\n      typeof (db as { exportTable?: unknown }).exportTable === 'function',\n  });\n  await schemaManager.ensureTable(effectiveSchemaDefinition);\n}\n"],"names":[],"mappings":"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"}

package/dist/scripts/create-wrappers.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * Create wrapper files for subpath exports
+ *
+ * The Vite build with preserveModules creates flat numbered files (index17.js, etc)
+ * but package.json exports expect directory structure (vite-plugin/index.js, etc).
+ * This script creates wrapper files that re-export from the main index.js.
+ */
+
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const distDir = join(__dirname, '../dist');
+
+// Map of subpath exports to their exported symbols
+const wrappers = [
+  {
+    path: 'vite-plugin/index.js',
+    exports: ['smrtPlugin'],
+  },
+  {
+    path: 'consumer-plugin/index.js',
+    exports: ['smrtConsumer'],
+  },
+  {
+    path: 'runtime/index.js',
+    exports: ['createMCPServer', 'createSmrtServer', 'createSmrtClient'],
+  },
+  {
+    path: 'prebuild/index.js',
+    exports: ['generateTypes', 'loadStaticManifest'],
+  },
+  {
+    path: 'fields/index.js',
+    exports: '*', // Re-export everything from fields
+  },
+  {
+    path: 'generators/cli.js',
+    exports: ['main'], // Import and run main for CLI
+    isCLI: true,
+  },
+  {
+    path: 'prebuild/cli.js',
+    exports: '*', // Re-export everything for prebuild CLI
+  },
+];
+
+// Create wrapper files
+for (const wrapper of wrappers) {
+  const wrapperPath = join(distDir, wrapper.path);
+  const wrapperDir = dirname(wrapperPath);
+
+  // Create directory if it doesn't exist
+  mkdirSync(wrapperDir, { recursive: true });
+
+  // Generate export statement
+  const shebang = wrapper.isCLI ? '#!/usr/bin/env node\n' : '';
+  let content;
+
+  if (wrapper.isCLI && wrapper.exports.includes('main')) {
+    // CLI entry point - import and run main
+    content = `${shebang}// Auto-generated CLI entry point
+import { main } from '../index.js';
+
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});
+`;
+  } else if (wrapper.exports === '*') {
+    // Wildcard export
+    content = `${shebang}// Auto-generated wrapper for subpath export
+export * from '../index.js';
+`;
+  } else {
+    // Named exports
+    content = `${shebang}// Auto-generated wrapper for subpath export
+export { ${wrapper.exports.join(', ')} } from '../index.js';
+`;
+  }
+
+  // Write wrapper file
+  writeFileSync(wrapperPath, content, 'utf-8');
+  console.log(`✓ Created wrapper: ${wrapper.path}`);
+}
+
+console.log(`\n✅ Generated ${wrappers.length} wrapper files`);