@happyvertical/smrt-core 0.30.0

package/dist/test-utils.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Comprehensive test utilities for SMRT framework testing
+ *
+ * Provides unified mocking for collections, objects, and database operations
+ * to support both CLI and API generator testing scenarios.
+ */
+/**
+ * Snapshot ObjectRegistry state and return a restore function for manifest-heavy
+ * tests that mutate registry internals at runtime.
+ */
+export declare function snapshotObjectRegistryState(): () => void;
+/**
+ * Mock object instance with all required lifecycle methods
+ */
+export interface MockObject {
+    id: string;
+    slug?: string;
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: any;
+    save: () => Promise<MockObject>;
+    delete: () => Promise<void>;
+    initialize: () => Promise<void>;
+}
+/**
+ * Mock collection with all CRUD operations
+ */
+export interface MockCollection {
+    list: (options?: any) => Promise<MockObject[]>;
+    get: (id: string) => Promise<MockObject | null>;
+    create: (data: any) => Promise<MockObject>;
+    update: (id: string, data: any) => Promise<MockObject>;
+    delete: (id: string) => Promise<void>;
+    initialize: () => Promise<void>;
+    save: (object: MockObject) => Promise<MockObject>;
+}
+/**
+ * Test data factory for generating consistent mock data
+ */
+export declare class TestDataFactory {
+    private static idCounter;
+    static generateId(): string;
+    static generateTestUser(overrides?: Partial<MockObject>): MockObject;
+    static generateTestProduct(overrides?: Partial<MockObject>): MockObject;
+    /**
+     * Generate multiple test objects
+     */
+    static generateMultiple<T extends MockObject>(generator: (overrides?: Partial<T>) => T, count: number, overrides?: Partial<T>): T[];
+}
+/**
+ * Mock collection factory with comprehensive CRUD support
+ */
+export declare class MockCollectionFactory {
+    private storage;
+    /**
+     * Create a mock collection with realistic behavior
+     */
+    createMockCollection(objectType?: 'user' | 'product'): MockCollection;
+    /**
+     * Clear all mock data
+     */
+    clear(): void;
+    /**
+     * Get current storage for inspection
+     */
+    getStorage(): Map<string, MockObject>;
+}
+/**
+ * Complete mock context factory for CLI and API testing
+ */
+export declare class MockContextFactory {
+    private collectionFactory;
+    /**
+     * Create a comprehensive mock context with database and AI
+     */
+    createMockContext(overrides?: any): any;
+    /**
+     * Create mock collections for testing
+     */
+    createMockCollections(): {
+        TestUser: MockCollection;
+        TestProduct: MockCollection;
+    };
+    /**
+     * Clear all mock data
+     */
+    clear(): void;
+}
+/**
+ * Enhanced test setup utilities
+ */
+export declare class TestSetup {
+    private static mockFactory;
+    /**
+     * Set up complete test environment
+     */
+    static setupTestEnvironment(): {
+        mockContext: any;
+        mockCollections: {
+            TestUser: MockCollection;
+            TestProduct: MockCollection;
+        };
+        cleanup: () => void;
+    };
+    /**
+     * Mock collection constructor to return mock instances
+     */
+    static mockCollectionConstructors(mockCollections: any): any;
+    /**
+     * Create realistic database query responses
+     */
+    static createDatabaseResponses(objectType?: 'user' | 'product'): {
+        list: {
+            rows: MockObject[];
+        };
+        get: {
+            rows: MockObject[];
+        };
+        create: {
+            rows: MockObject[];
+        };
+        update: {
+            rows: MockObject[];
+        };
+        delete: {
+            rows: never[];
+        };
+        empty: {
+            rows: never[];
+        };
+    };
+}
+/**
+ * Export commonly used mock instances for convenience
+ */
+export declare const mockContextFactory: MockContextFactory;
+export declare const testDataFactory: typeof TestDataFactory;
+export declare const mockCollectionFactory: MockCollectionFactory;
+export declare const testSetup: typeof TestSetup;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.d.ts.map

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

package/dist/testing/database.d.ts

@@ -0,0 +1,73 @@
+import { DatabaseInterface } from '@happyvertical/sql';
+/**
+ * Options for creating a test database
+ */
+export interface TestDatabaseOptions {
+    /**
+     * Database type (default: 'sqlite')
+     * - 'sqlite': SQLite database
+     * - 'json': JSON adapter (stores data as JSON files with DuckDB for querying)
+     */
+    type?: 'sqlite' | 'json';
+    /**
+     * Database URL (default: ':memory:')
+     * Use ':memory:' for in-memory databases (fastest for tests)
+     * Or provide a file path for persistent test databases
+     */
+    url?: string;
+    /**
+     * Pre-existing database to initialize schemas in.
+     * If provided, `type` and `url` are ignored.
+     */
+    db?: DatabaseInterface;
+    /**
+     * Specific classes to setup schemas for.
+     * If not provided, sets up schemas for all registered classes.
+     */
+    classes?: string[];
+    /**
+     * Whether to include system tables (default: true)
+     * System tables include _smrt_contexts, _smrt_migrations, etc.
+     */
+    includeSystemTables?: boolean;
+}
+/**
+ * Creates an in-memory test database with schemas pre-created
+ *
+ * This utility is designed for testing. It creates an in-memory database
+ * and initializes all registered SMRT object schemas using the **same
+ * schema generation logic** as the production migration system.
+ *
+ * **Key features:**
+ * - Uses `SchemaGenerator.generateSQL()` - the single source of truth for DDL
+ * - Handles STI (Single Table Inheritance) correctly
+ * - Creates system tables for framework functionality
+ * - Safe for parallel test execution (each call creates isolated instance)
+ *
+ * @param options - Configuration options
+ * @returns Promise resolving to configured DatabaseInterface
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - all registered schemas
+ * const db = await getTestDatabase();
+ *
+ * // Specific classes only
+ * const db = await getTestDatabase({ classes: ['Council', 'Meeting'] });
+ *
+ * // JSON adapter instead of SQLite
+ * const db = await getTestDatabase({ type: 'json' });
+ *
+ * // File-based database for persistent tests
+ * const db = await getTestDatabase({ type: 'sqlite', url: '/tmp/test.db' });
+ *
+ * // Initialize schemas in an existing database
+ * const myDb = await getDatabase({ type: 'sqlite', url: ':memory:' });
+ * await getTestDatabase({ db: myDb });
+ *
+ * // Skip system tables (rare use case)
+ * const db = await getTestDatabase({ includeSystemTables: false });
+ * ```
+ */
+export declare function getTestDatabase(options?: TestDatabaseOptions): Promise<DatabaseInterface>;
+//# sourceMappingURL=database.d.ts.map

package/dist/testing/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/testing/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAgJ5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,EAAE,CAAC,EAAE,iBAAiB,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAuCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAqH5B"}

package/dist/testing/database.js

@@ -0,0 +1,204 @@
+import { getDatabase } from "@happyvertical/sql";
+import { isCollectionRegistration, resolveCollectionItemClassName, resolveRelatedRegistration } from "../registry/collection-resolution.js";
+import { ObjectRegistry } from "../registry.js";
+import { SchemaGenerator } from "../schema/generator.js";
+import { ensureLegacySystemTableCompatibility } from "../system/compatibility.js";
+import { ALL_SYSTEM_TABLES } from "../system/schema.js";
+function resolveSTIBaseRegistration(className, stiBaseName) {
+  const registered = ObjectRegistry.getClass(className);
+  if (stiBaseName.includes(":")) {
+    return ObjectRegistry.getClass(stiBaseName);
+  }
+  if (registered?.packageName) {
+    const samePackageBase = ObjectRegistry.getClassInPackage(
+      registered.packageName,
+      stiBaseName
+    );
+    if (samePackageBase) {
+      return samePackageBase;
+    }
+  }
+  return ObjectRegistry.getClass(stiBaseName);
+}
+function resolveSTIBaseLookupName(className, stiBaseName) {
+  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);
+  return stiBase?.qualifiedName || stiBase?.name || stiBaseName;
+}
+function isSTIChild(className) {
+  const stiBaseName = ObjectRegistry.getSTIBase(className);
+  if (!stiBaseName) {
+    return false;
+  }
+  const registered = ObjectRegistry.getClass(className);
+  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);
+  if (registered && stiBase) {
+    return registered !== stiBase;
+  }
+  return stiBaseName !== className;
+}
+const collectionRegistrationLookup = {
+  findClass: (className) => ObjectRegistry.getClass(className),
+  findClassInPackage: (packageName, className) => ObjectRegistry.getClassInPackage(packageName, className),
+  getInheritanceChain: (className) => ObjectRegistry.getInheritanceChain(className)
+};
+function resolveCollectionSchemaClassName(className, registered) {
+  const itemClassName = resolveCollectionItemClassName(
+    className,
+    registered,
+    collectionRegistrationLookup
+  );
+  if (itemClassName) {
+    const itemRegistration = resolveRelatedRegistration(
+      itemClassName,
+      registered,
+      collectionRegistrationLookup
+    );
+    const itemLookupName = itemRegistration?.qualifiedName || itemRegistration?.name || itemClassName;
+    const stiBase = ObjectRegistry.getSTIBase(itemLookupName);
+    return stiBase ? resolveSTIBaseLookupName(itemLookupName, stiBase) : itemLookupName;
+  }
+  const tableName = registered.schema?.tableName || registered.config.tableName || ObjectRegistry.getTableName(className);
+  if (!tableName) {
+    return className;
+  }
+  const collectionPackage = registered.packageName;
+  for (const candidate of ObjectRegistry.getAllClasses().values()) {
+    if (candidate === registered || isCollectionRegistration(
+      candidate.qualifiedName || candidate.name,
+      candidate,
+      collectionRegistrationLookup
+    )) {
+      continue;
+    }
+    const candidateTableName = candidate.schema?.tableName || candidate.config.tableName;
+    if (candidateTableName !== tableName) {
+      continue;
+    }
+    if (collectionPackage && candidate.packageName && candidate.packageName !== collectionPackage) {
+      continue;
+    }
+    const candidateLookupName = candidate.qualifiedName || candidate.name;
+    const stiBase = ObjectRegistry.getSTIBase(candidateLookupName);
+    return stiBase ? resolveSTIBaseLookupName(candidateLookupName, stiBase) : candidateLookupName;
+  }
+  return className;
+}
+function resolveRequestedSchemaClassName(className) {
+  const registered = ObjectRegistry.getClass(className);
+  if (!registered) {
+    return className;
+  }
+  if (!isCollectionRegistration(
+    className,
+    registered,
+    collectionRegistrationLookup
+  )) {
+    const stiBase = ObjectRegistry.getSTIBase(className);
+    return stiBase ? resolveSTIBaseLookupName(className, stiBase) : className;
+  }
+  return resolveCollectionSchemaClassName(className, registered);
+}
+function resolveRequestedSchemaClassNames(classNames) {
+  const resolved = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const className of classNames) {
+    const schemaClassName = resolveRequestedSchemaClassName(className);
+    if (seen.has(schemaClassName)) {
+      continue;
+    }
+    seen.add(schemaClassName);
+    resolved.push(schemaClassName);
+  }
+  return resolved;
+}
+async function getTestDatabase(options = {}) {
+  const {
+    type = "sqlite",
+    url = ":memory:",
+    db: existingDb,
+    classes,
+    includeSystemTables = true
+  } = options;
+  const db = existingDb ?? await getDatabase({
+    type,
+    url,
+    __smrtSkipVitestSchemaPreparation: true
+  });
+  if (includeSystemTables) {
+    await initializeSystemTables(db);
+  }
+  const classNames = resolveRequestedSchemaClassNames(
+    classes ?? ObjectRegistry.getQualifiedClassNames()
+  );
+  if (classNames.length === 0) {
+    return db;
+  }
+  const schemaGenerator = new SchemaGenerator();
+  const ddlEngine = type === "json" || typeof db.exportTable === "function" ? "json" : "sqlite";
+  const createdTables = /* @__PURE__ */ new Set();
+  for (const className of classNames) {
+    const registered = ObjectRegistry.getClass(className);
+    if (isSTIChild(className)) {
+      continue;
+    }
+    const tableName = ObjectRegistry.getTableName(className);
+    if (!tableName || createdTables.has(tableName)) {
+      continue;
+    }
+    const fields = await ObjectRegistry.getAllFields(className);
+    const strategy = ObjectRegistry.getTableStrategy(className);
+    const runtimeSchemaConfig = {
+      conflictColumns: ObjectRegistry.getConflictColumns(className),
+      idType: registered?.config.idType,
+      registry: ObjectRegistry
+    };
+    const schema = strategy === "sti" ? await schemaGenerator.generateSTISchemaFromRegistry(
+      className,
+      tableName,
+      fields,
+      runtimeSchemaConfig
+    ) : schemaGenerator.generateSchemaFromRegistry(
+      className,
+      tableName,
+      fields,
+      runtimeSchemaConfig
+    );
+    const ddl = schemaGenerator.generateSQL(schema, ddlEngine);
+    try {
+      await db.query(ddl);
+      createdTables.add(tableName);
+      const ddlStrategy = (await import("../schema/ddl/index.js")).getDDLStrategy(ddlEngine);
+      const indexStatements = ddlStrategy.generateIndexes(schema);
+      for (const indexSQL of indexStatements) {
+        try {
+          await db.query(indexSQL);
+        } catch (indexError) {
+          console.warn(
+            `[getTestDatabase] Warning: Failed to create index: ${indexError instanceof Error ? indexError.message : String(indexError)} (SQL: ${indexSQL})`
+          );
+        }
+      }
+    } catch (error) {
+      throw new Error(
+        `[getTestDatabase] Failed to create table '${tableName}' for class '${className}': ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  return db;
+}
+async function initializeSystemTables(db) {
+  await ensureLegacySystemTableCompatibility(db);
+  const allStatements = [];
+  for (const multiStatementSQL of ALL_SYSTEM_TABLES) {
+    const statements = multiStatementSQL.split(";").map((s) => s.trim()).filter((s) => s.length > 0);
+    allStatements.push(...statements);
+  }
+  for (const statement of allStatements) {
+    await db.query(statement);
+  }
+}
+export {
+  getTestDatabase
+};
+//# sourceMappingURL=database.js.map

package/dist/testing/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sources":["../../src/testing/database.ts"],"sourcesContent":["/**\n * Test database utilities for SMRT framework\n *\n * Provides `getTestDatabase()` which creates an in-memory database with all\n * registered SMRT object schemas. Uses the same schema generation logic as\n * the migration system to ensure consistency between test and production.\n *\n * @example\n * ```typescript\n * import { getTestDatabase } from '@happyvertical/smrt-core/testing';\n *\n * beforeEach(async () => {\n *   const db = await getTestDatabase();\n *   collection = await MyCollection.create({ db });\n * });\n * ```\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport { getDatabase } from '@happyvertical/sql';\nimport {\n  type CollectionRegistrationLookup,\n  isCollectionRegistration,\n  resolveCollectionItemClassName,\n  resolveRelatedRegistration,\n} from '../registry/collection-resolution.js';\nimport { ObjectRegistry } from '../registry.js';\nimport { SchemaGenerator } from '../schema/generator.js';\nimport { ensureLegacySystemTableCompatibility } from '../system/compatibility.js';\nimport { ALL_SYSTEM_TABLES } from '../system/schema.js';\n\ntype TestDatabaseConnectionOptions = Parameters<typeof getDatabase>[0] & {\n  __smrtSkipVitestSchemaPreparation?: boolean;\n};\n\nfunction resolveSTIBaseRegistration(className: string, stiBaseName: string) {\n  const registered = ObjectRegistry.getClass(className);\n\n  if (stiBaseName.includes(':')) {\n    return ObjectRegistry.getClass(stiBaseName);\n  }\n\n  if (registered?.packageName) {\n    const samePackageBase = ObjectRegistry.getClassInPackage(\n      registered.packageName,\n      stiBaseName,\n    );\n    if (samePackageBase) {\n      return samePackageBase;\n    }\n  }\n\n  return ObjectRegistry.getClass(stiBaseName);\n}\n\nfunction resolveSTIBaseLookupName(\n  className: string,\n  stiBaseName: string,\n): string {\n  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);\n  return stiBase?.qualifiedName || stiBase?.name || stiBaseName;\n}\n\nfunction isSTIChild(className: string): boolean {\n  const stiBaseName = ObjectRegistry.getSTIBase(className);\n  if (!stiBaseName) {\n    return false;\n  }\n\n  const registered = ObjectRegistry.getClass(className);\n  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);\n\n  if (registered && stiBase) {\n    return registered !== stiBase;\n  }\n\n  return stiBaseName !== className;\n}\n\ntype RegisteredSchemaClass = NonNullable<\n  ReturnType<typeof ObjectRegistry.getClass>\n>;\n\nconst collectionRegistrationLookup: CollectionRegistrationLookup = {\n  findClass: (className) => ObjectRegistry.getClass(className),\n  findClassInPackage: (packageName, className) =>\n    ObjectRegistry.getClassInPackage(packageName, className),\n  getInheritanceChain: (className) =>\n    ObjectRegistry.getInheritanceChain(className),\n};\n\nfunction resolveCollectionSchemaClassName(\n  className: string,\n  registered: RegisteredSchemaClass,\n): string {\n  const itemClassName = resolveCollectionItemClassName(\n    className,\n    registered,\n    collectionRegistrationLookup,\n  );\n  if (itemClassName) {\n    const itemRegistration = resolveRelatedRegistration(\n      itemClassName,\n      registered,\n      collectionRegistrationLookup,\n    );\n    const itemLookupName =\n      itemRegistration?.qualifiedName ||\n      itemRegistration?.name ||\n      itemClassName;\n    const stiBase = ObjectRegistry.getSTIBase(itemLookupName);\n    return stiBase\n      ? resolveSTIBaseLookupName(itemLookupName, stiBase)\n      : itemLookupName;\n  }\n\n  const tableName =\n    registered.schema?.tableName ||\n    registered.config.tableName ||\n    ObjectRegistry.getTableName(className);\n  if (!tableName) {\n    return className;\n  }\n\n  const collectionPackage = registered.packageName;\n\n  for (const candidate of ObjectRegistry.getAllClasses().values()) {\n    if (\n      candidate === registered ||\n      isCollectionRegistration(\n        candidate.qualifiedName || candidate.name,\n        candidate,\n        collectionRegistrationLookup,\n      )\n    ) {\n      continue;\n    }\n\n    const candidateTableName =\n      candidate.schema?.tableName || candidate.config.tableName;\n    if (candidateTableName !== tableName) {\n      continue;\n    }\n\n    if (\n      collectionPackage &&\n      candidate.packageName &&\n      candidate.packageName !== collectionPackage\n    ) {\n      continue;\n    }\n\n    const candidateLookupName = candidate.qualifiedName || candidate.name;\n    const stiBase = ObjectRegistry.getSTIBase(candidateLookupName);\n    return stiBase\n      ? resolveSTIBaseLookupName(candidateLookupName, stiBase)\n      : candidateLookupName;\n  }\n\n  return className;\n}\n\n/**\n * Options for creating a test database\n */\nexport interface TestDatabaseOptions {\n  /**\n   * Database type (default: 'sqlite')\n   * - 'sqlite': SQLite database\n   * - 'json': JSON adapter (stores data as JSON files with DuckDB for querying)\n   */\n  type?: 'sqlite' | 'json';\n\n  /**\n   * Database URL (default: ':memory:')\n   * Use ':memory:' for in-memory databases (fastest for tests)\n   * Or provide a file path for persistent test databases\n   */\n  url?: string;\n\n  /**\n   * Pre-existing database to initialize schemas in.\n   * If provided, `type` and `url` are ignored.\n   */\n  db?: DatabaseInterface;\n\n  /**\n   * Specific classes to setup schemas for.\n   * If not provided, sets up schemas for all registered classes.\n   */\n  classes?: string[];\n\n  /**\n   * Whether to include system tables (default: true)\n   * System tables include _smrt_contexts, _smrt_migrations, etc.\n   */\n  includeSystemTables?: boolean;\n}\n\nfunction resolveRequestedSchemaClassName(className: string): string {\n  const registered = ObjectRegistry.getClass(className);\n  if (!registered) {\n    return className;\n  }\n\n  if (\n    !isCollectionRegistration(\n      className,\n      registered,\n      collectionRegistrationLookup,\n    )\n  ) {\n    const stiBase = ObjectRegistry.getSTIBase(className);\n    return stiBase ? resolveSTIBaseLookupName(className, stiBase) : className;\n  }\n\n  return resolveCollectionSchemaClassName(className, registered);\n}\n\nfunction resolveRequestedSchemaClassNames(classNames: string[]): string[] {\n  const resolved: string[] = [];\n  const seen = new Set<string>();\n\n  for (const className of classNames) {\n    const schemaClassName = resolveRequestedSchemaClassName(className);\n    if (seen.has(schemaClassName)) {\n      continue;\n    }\n\n    seen.add(schemaClassName);\n    resolved.push(schemaClassName);\n  }\n\n  return resolved;\n}\n\n/**\n * Creates an in-memory test database with schemas pre-created\n *\n * This utility is designed for testing. It creates an in-memory database\n * and initializes all registered SMRT object schemas using the **same\n * schema generation logic** as the production migration system.\n *\n * **Key features:**\n * - Uses `SchemaGenerator.generateSQL()` - the single source of truth for DDL\n * - Handles STI (Single Table Inheritance) correctly\n * - Creates system tables for framework functionality\n * - Safe for parallel test execution (each call creates isolated instance)\n *\n * @param options - Configuration options\n * @returns Promise resolving to configured DatabaseInterface\n *\n * @example\n * ```typescript\n * // Basic usage - all registered schemas\n * const db = await getTestDatabase();\n *\n * // Specific classes only\n * const db = await getTestDatabase({ classes: ['Council', 'Meeting'] });\n *\n * // JSON adapter instead of SQLite\n * const db = await getTestDatabase({ type: 'json' });\n *\n * // File-based database for persistent tests\n * const db = await getTestDatabase({ type: 'sqlite', url: '/tmp/test.db' });\n *\n * // Initialize schemas in an existing database\n * const myDb = await getDatabase({ type: 'sqlite', url: ':memory:' });\n * await getTestDatabase({ db: myDb });\n *\n * // Skip system tables (rare use case)\n * const db = await getTestDatabase({ includeSystemTables: false });\n * ```\n */\nexport async function getTestDatabase(\n  options: TestDatabaseOptions = {},\n): Promise<DatabaseInterface> {\n  const {\n    type = 'sqlite',\n    url = ':memory:',\n    db: existingDb,\n    classes,\n    includeSystemTables = true,\n  } = options;\n\n  // Use existing database or create new one\n  const db =\n    existingDb ??\n    (await getDatabase({\n      type,\n      url,\n      __smrtSkipVitestSchemaPreparation: true,\n    } as TestDatabaseConnectionOptions));\n\n  // Initialize system tables (same as production)\n  if (includeSystemTables) {\n    await initializeSystemTables(db);\n  }\n\n  // Get class names to setup\n  const classNames = resolveRequestedSchemaClassNames(\n    classes ?? ObjectRegistry.getQualifiedClassNames(),\n  );\n\n  // Skip if no classes registered\n  if (classNames.length === 0) {\n    return db;\n  }\n\n  // Use the same schema generation as production\n  const schemaGenerator = new SchemaGenerator();\n  const ddlEngine =\n    type === 'json' || typeof (db as any).exportTable === 'function'\n      ? 'json'\n      : 'sqlite';\n\n  // Track created tables to avoid duplicates (STI base classes)\n  const createdTables = new Set<string>();\n\n  for (const className of classNames) {\n    // R11: the registration carries idType (native uuid vs text); read it\n    // below when building runtimeSchemaConfig.\n    const registered = ObjectRegistry.getClass(className);\n    // Skip STI children - their schema is part of the base class table.\n    // main (#1324): isSTIChild() compares RegisteredClass *identity* rather\n    // than raw strings, so it stays correct under R5-canon (getSTIBase returns\n    // qualified names) while also handling collection/override registrations.\n    if (isSTIChild(className)) {\n      continue;\n    }\n\n    const tableName = ObjectRegistry.getTableName(className);\n    if (!tableName || createdTables.has(tableName)) {\n      continue;\n    }\n\n    const fields = await ObjectRegistry.getAllFields(className);\n    const strategy = ObjectRegistry.getTableStrategy(className);\n    const runtimeSchemaConfig = {\n      conflictColumns: ObjectRegistry.getConflictColumns(className),\n      idType: registered?.config.idType,\n      registry: ObjectRegistry,\n    };\n\n    // Generate schema using SchemaGenerator (same as migrations)\n    const schema =\n      strategy === 'sti'\n        ? await schemaGenerator.generateSTISchemaFromRegistry(\n            className,\n            tableName,\n            fields,\n            runtimeSchemaConfig,\n          )\n        : schemaGenerator.generateSchemaFromRegistry(\n            className,\n            tableName,\n            fields,\n            runtimeSchemaConfig,\n          );\n\n    // Generate DDL using generateSQL() - the single source of truth\n    const ddl = schemaGenerator.generateSQL(schema, ddlEngine);\n\n    try {\n      await db.query(ddl);\n      createdTables.add(tableName);\n\n      // Create indexes (use DDL strategy so jsonPath / where / etc. render)\n      const ddlStrategy = (\n        await import('../schema/ddl/index.js')\n      ).getDDLStrategy(ddlEngine);\n      const indexStatements = ddlStrategy.generateIndexes(schema);\n      for (const indexSQL of indexStatements) {\n        try {\n          await db.query(indexSQL);\n        } catch (indexError) {\n          // Log but don't fail on index creation errors\n          // Some indexes may fail if columns don't exist (STI meta fields)\n          console.warn(\n            `[getTestDatabase] Warning: Failed to create index: ${indexError instanceof Error ? indexError.message : String(indexError)} (SQL: ${indexSQL})`,\n          );\n        }\n      }\n    } catch (error) {\n      // Provide helpful error message for table creation failures\n      throw new Error(\n        `[getTestDatabase] Failed to create table '${tableName}' for class '${className}': ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  return db;\n}\n\n/**\n * Initialize SMRT system tables in a database\n *\n * System tables use _smrt_ prefix and store framework metadata.\n * All statements use `IF NOT EXISTS` for idempotency.\n *\n * @param db - Database interface to initialize\n */\nasync function initializeSystemTables(db: DatabaseInterface): Promise<void> {\n  await ensureLegacySystemTableCompatibility(db);\n\n  // Split multi-statement SQL into individual statements\n  const allStatements: string[] = [];\n  for (const multiStatementSQL of ALL_SYSTEM_TABLES) {\n    const statements = multiStatementSQL\n      .split(';')\n      .map((s) => s.trim())\n      .filter((s) => s.length > 0);\n    allStatements.push(...statements);\n  }\n\n  // Use db.query() — system tables use CREATE TABLE/INDEX IF NOT EXISTS\n  // which databases handle natively without per-column existence checks.\n  for (const statement of allStatements) {\n    await db.query(statement);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SMRT Testing Utilities
+ *
+ * Provides utilities for testing SMRT objects in isolation.
+ * The main export is `getTestDatabase()` which creates an in-memory
+ * database with all registered schemas pre-created.
+ *
+ * @example
+ * ```typescript
+ * import { getTestDatabase } from '@happyvertical/smrt-core/testing';
+ *
+ * beforeEach(async () => {
+ *   const db = await getTestDatabase();
+ *   collection = await MyCollection.create({ db });
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { getTestDatabase, type TestDatabaseOptions } from './database.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export testing utilities from testing/index.ts
+ * This file exists to satisfy the package.json exports configuration
+ */
+export * from './testing/index.js';
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/testing.js

@@ -0,0 +1,5 @@
+import { getTestDatabase } from "./testing/database.js";
+export {
+  getTestDatabase
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Function Calling Tools Module
+ *
+ * Public API for AI tool generation and execution
+ */
+export { executeToolCall, executeToolCalls, formatToolResults, type ToolCall, type ToolCallResult, validateToolCall, } from './tool-executor.js';
+export { type AiConfig, convertTypeToJsonSchema, generateToolFromMethod, generateToolManifest, shouldIncludeMethod, } from './tool-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,QAAQ,EACb,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/tools/tool-executor.d.ts

@@ -0,0 +1,101 @@
+import { SignalBus } from '../signals/bus.js';
+/**
+ * Tool call structure from AI response
+ */
+export interface ToolCall {
+    /**
+     * Unique identifier for this tool call
+     */
+    id: string;
+    /**
+     * Type of tool (always 'function' for now)
+     */
+    type: 'function';
+    /**
+     * Function details
+     */
+    function: {
+        /**
+         * Name of the method to call
+         */
+        name: string;
+        /**
+         * JSON string of arguments to pass to the method
+         */
+        arguments: string;
+    };
+}
+/**
+ * Result of executing a tool call
+ */
+export interface ToolCallResult {
+    /**
+     * Tool call ID for correlation
+     */
+    id: string;
+    /**
+     * Method name that was called
+     */
+    methodName: string;
+    /**
+     * Parsed arguments that were used
+     */
+    arguments: Record<string, any>;
+    /**
+     * Result returned from the method
+     */
+    result: any;
+    /**
+     * Whether the call succeeded
+     */
+    success: boolean;
+    /**
+     * Error message if call failed
+     */
+    error?: string;
+    /**
+     * Execution time in milliseconds
+     */
+    duration?: number;
+}
+/**
+ * Validates tool call arguments against method parameters
+ *
+ * @param methodName - Name of the method being called
+ * @param args - Parsed arguments from tool call
+ * @param allowedMethods - List of methods AI is allowed to call
+ * @throws ValidationError if method not allowed or arguments invalid
+ */
+export declare function validateToolCall(methodName: string, args: Record<string, any>, allowedMethods: string[]): void;
+/**
+ * Executes a tool call on an object instance
+ *
+ * @param instance - Object instance to call method on
+ * @param toolCall - Tool call from AI
+ * @param allowedMethods - List of methods AI is allowed to call
+ * @param signalBus - Optional signal bus for emitting execution events
+ * @returns Result of the tool call execution
+ */
+export declare function executeToolCall(instance: any, toolCall: ToolCall, allowedMethods: string[], signalBus?: SignalBus): Promise<ToolCallResult>;
+/**
+ * Executes multiple tool calls in sequence
+ *
+ * @param instance - Object instance to call methods on
+ * @param toolCalls - Array of tool calls from AI
+ * @param allowedMethods - List of methods AI is allowed to call
+ * @param signalBus - Optional signal bus for emitting execution events
+ * @returns Array of tool call results
+ */
+export declare function executeToolCalls(instance: any, toolCalls: ToolCall[], allowedMethods: string[], signalBus?: SignalBus): Promise<ToolCallResult[]>;
+/**
+ * Formats tool call results into messages for AI
+ *
+ * @param results - Tool call execution results
+ * @returns Array of tool response messages
+ */
+export declare function formatToolResults(results: ToolCallResult[]): Array<{
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+}>;
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/tools/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/tools/tool-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE;QACR;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC;IAEZ;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,cAAc,EAAE,MAAM,EAAE,GACvB,IAAI,CAkBN;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,cAAc,CAAC,CA8GzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAoB3B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EAAE,GACxB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAQhE"}