@fragno-dev/test 0.1.11 → 0.1.13

package/dist/db-test.js

@@ -0,0 +1,214 @@
+import { createAdapter } from "./adapters.js";
+
+//#region src/db-test.ts
+/**
+* Builder for creating multiple database fragments for testing
+*/
+var DatabaseFragmentsTestBuilder = class {
+	#adapter;
+	#fragments = /* @__PURE__ */ new Map();
+	/**
+	* Set the test adapter configuration
+	*/
+	withTestAdapter(adapter) {
+		this.#adapter = adapter;
+		return this;
+	}
+	/**
+	* Add a fragment to the test setup
+	*
+	* @param name - Unique name for the fragment
+	* @param builder - Pre-configured instantiation builder
+	* @param options - Additional options (optional)
+	*/
+	withFragment(name, builder, options) {
+		this.#fragments.set(name, {
+			definition: builder.definition,
+			builder,
+			migrateToVersion: options?.migrateToVersion
+		});
+		return this;
+	}
+	/**
+	* Build the test setup and return fragments and test context
+	*/
+	async build() {
+		if (!this.#adapter) throw new Error("Test adapter must be set using withTestAdapter()");
+		if (this.#fragments.size === 0) throw new Error("At least one fragment must be added using withFragment()");
+		const adapterConfig = this.#adapter;
+		const fragmentNames = Array.from(this.#fragments.keys());
+		const fragmentConfigs = Array.from(this.#fragments.values());
+		const schemaConfigs = [];
+		const builderConfigs = [];
+		for (const fragmentConfig of fragmentConfigs) {
+			const builder = fragmentConfig.builder;
+			const definition = builder.definition;
+			let schema;
+			const namespace = definition.name + "-db";
+			if (definition.dependencies) try {
+				const mockAdapter = {
+					createQueryEngine: () => ({ schema: null }),
+					contextStorage: { run: (_data, fn) => fn() }
+				};
+				const actualConfig = builder.config ?? {};
+				const deps = definition.dependencies({
+					config: actualConfig,
+					options: { databaseAdapter: mockAdapter }
+				});
+				if (deps && typeof deps === "object" && "schema" in deps) schema = deps.schema;
+			} catch (error) {
+				const errorMessage = error instanceof Error ? error.message : typeof error === "string" ? error : "Unknown error";
+				throw new Error(`Failed to extract schema from fragment '${definition.name}'.\nOriginal error: ${errorMessage}\n\nMake sure the fragment is a database fragment using defineFragment().extend(withDatabase(schema)).`);
+			}
+			if (!schema) throw new Error(`Fragment '${definition.name}' does not have a database schema. Make sure you're using defineFragment().extend(withDatabase(schema)).`);
+			schemaConfigs.push({
+				schema,
+				namespace,
+				migrateToVersion: fragmentConfig.migrateToVersion
+			});
+			builderConfigs.push({
+				config: builder.config ?? {},
+				routes: builder.routes ?? [],
+				options: builder.options ?? {}
+			});
+		}
+		const { testContext, adapter } = await createAdapter(adapterConfig, schemaConfigs);
+		const createFragments = () => {
+			const providedServicesByName = {};
+			const fragmentResults$1 = [];
+			for (let i = 0; i < fragmentConfigs.length; i++) {
+				const fragmentConfig = fragmentConfigs[i];
+				const builderConfig = builderConfigs[i];
+				const namespace = schemaConfigs[i].namespace;
+				const schema = schemaConfigs[i].schema;
+				const orm = testContext.getOrm(namespace);
+				const mergedOptions = {
+					...builderConfig.options,
+					databaseAdapter: adapter
+				};
+				const fragment = fragmentConfig.builder.withOptions(mergedOptions).build();
+				for (const [serviceName, serviceImpl] of Object.entries(fragment.services)) providedServicesByName[serviceName] = {
+					service: serviceImpl,
+					orm
+				};
+				const deps = fragment.$internal?.deps;
+				fragmentResults$1.push({
+					fragment,
+					services: fragment.services,
+					deps: deps || {},
+					callRoute: fragment.callRoute.bind(fragment),
+					get db() {
+						return orm;
+					},
+					_orm: orm,
+					_schema: schema
+				});
+			}
+			for (let i = 0; i < fragmentConfigs.length; i++) {
+				const fragmentConfig = fragmentConfigs[i];
+				const definition = fragmentConfig.builder.definition;
+				const builderConfig = builderConfigs[i];
+				const namespace = schemaConfigs[i].namespace;
+				const schema = schemaConfigs[i].schema;
+				const orm = testContext.getOrm(namespace);
+				const serviceImplementations = {};
+				const serviceDependencies = definition.serviceDependencies;
+				if (serviceDependencies) {
+					for (const serviceName of Object.keys(serviceDependencies)) if (providedServicesByName[serviceName]) serviceImplementations[serviceName] = providedServicesByName[serviceName].service;
+				}
+				const mergedOptions = {
+					...builderConfig.options,
+					databaseAdapter: adapter
+				};
+				const fragment = fragmentConfig.builder.withOptions(mergedOptions).withServices(serviceImplementations).build();
+				const deps = fragment.$internal?.deps;
+				fragmentResults$1[i] = {
+					fragment,
+					services: fragment.services,
+					deps: deps || {},
+					callRoute: fragment.callRoute.bind(fragment),
+					get db() {
+						return orm;
+					},
+					_orm: orm,
+					_schema: schema
+				};
+			}
+			return fragmentResults$1;
+		};
+		const fragmentResults = createFragments();
+		const originalResetDatabase = testContext.resetDatabase;
+		const resetDatabase = async () => {
+			await originalResetDatabase();
+			createFragments().forEach((newResult, index) => {
+				const result = fragmentResults[index];
+				result.fragment = newResult.fragment;
+				result.services = newResult.services;
+				result.deps = newResult.deps;
+				result.callRoute = newResult.callRoute;
+				result._orm = newResult._orm;
+			});
+		};
+		const firstFragment = fragmentResults[0]?.fragment;
+		if (!firstFragment) throw new Error("At least one fragment must be added");
+		const finalTestContext = {
+			...testContext,
+			resetDatabase,
+			adapter,
+			inContext: firstFragment.inContext.bind(firstFragment)
+		};
+		return {
+			fragments: Object.fromEntries(fragmentNames.map((name, index) => [name, fragmentResults[index]])),
+			test: finalTestContext
+		};
+	}
+};
+/**
+* Create a builder for setting up multiple database fragments for testing.
+* This is the new builder-based API that works with the new fragment instantiation builders.
+*
+* @example
+* ```typescript
+* const userFragmentDef = defineFragment("user")
+*   .extend(withDatabase(userSchema))
+*   .withDependencies(...)
+*   .build();
+*
+* const postFragmentDef = defineFragment("post")
+*   .extend(withDatabase(postSchema))
+*   .withDependencies(...)
+*   .build();
+*
+* const { fragments, test } = await buildDatabaseFragmentsTest()
+*   .withTestAdapter({ type: "kysely-sqlite" })
+*   .withFragment("user",
+*     instantiate(userFragmentDef)
+*       .withConfig({ ... })
+*       .withRoutes([...])
+*   )
+*   .withFragment("post",
+*     instantiate(postFragmentDef)
+*       .withRoutes([...])
+*   )
+*   .build();
+*
+* // Access fragments by name
+* await fragments.user.services.createUser(...);
+* await fragments.post.services.createPost(...);
+*
+* // Access dependencies directly
+* const userDeps = fragments.user.deps;
+*
+* // Shared test context
+* await test.resetDatabase();
+* await test.cleanup();
+* const adapter = test.adapter; // Access the database adapter
+* ```
+*/
+function buildDatabaseFragmentsTest() {
+	return new DatabaseFragmentsTestBuilder();
+}
+
+//#endregion
+export { DatabaseFragmentsTestBuilder, buildDatabaseFragmentsTest };
+//# sourceMappingURL=db-test.js.map

package/dist/db-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-test.js","names":["#adapter","#fragments","schemaConfigs: SchemaConfig[]","builderConfigs: Array<{ config: any; routes: any; options: any }>","schema: AnySchema | undefined","providedServicesByName: Record<string, { service: any; orm: any }>","fragmentResults: any[]","serviceImplementations: Record<string, any>","fragmentResults"],"sources":["../src/db-test.ts"],"sourcesContent":["import type { AnySchema } from \"@fragno-dev/db/schema\";\nimport type {\n  RequestThisContext,\n  FragnoPublicConfig,\n  FragmentInstantiationBuilder,\n  FragnoInstantiatedFragment,\n  FragmentDefinition,\n} from \"@fragno-dev/core\";\nimport type { AnyRouteOrFactory, FlattenRouteFactories } from \"@fragno-dev/core/route\";\nimport {\n  createAdapter,\n  type SupportedAdapter,\n  type AdapterContext,\n  type SchemaConfig,\n} from \"./adapters\";\nimport type { DatabaseAdapter } from \"@fragno-dev/db\";\nimport type { AbstractQuery } from \"@fragno-dev/db/query\";\nimport type { BaseTestContext } from \".\";\n\n// BoundServices is an internal type that strips 'this' parameters from service methods\n// It's used to represent services after they've been bound to a context\ntype BoundServices<T> = {\n  [K in keyof T]: T[K] extends (this: any, ...args: infer A) => infer R // eslint-disable-line @typescript-eslint/no-explicit-any\n    ? (...args: A) => R\n    : T[K] extends Record<string, unknown>\n      ? BoundServices<T[K]>\n      : T[K];\n};\n\n// Extract the schema type from database fragment dependencies\n// Database fragments have ImplicitDatabaseDependencies<TSchema> which includes `schema: TSchema`\ntype ExtractSchemaFromDeps<TDeps> = TDeps extends { schema: infer TSchema extends AnySchema }\n  ? TSchema\n  : AnySchema;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyLinkedFragments = Record<string, any>;\n\n// Forward declarations for recursive type references\ninterface FragmentResult<\n  TDeps,\n  TServices extends Record<string, unknown>,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage,\n  TRoutes extends readonly any[], // eslint-disable-line @typescript-eslint/no-explicit-any\n  TSchema extends AnySchema,\n  TLinkedFragments extends AnyLinkedFragments = {},\n> {\n  fragment: FragnoInstantiatedFragment<\n    TRoutes,\n    TDeps,\n    TServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    FragnoPublicConfig,\n    TLinkedFragments\n  >;\n  services: TServices;\n  deps: TDeps;\n  callRoute: FragnoInstantiatedFragment<\n    TRoutes,\n    TDeps,\n    TServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    FragnoPublicConfig,\n    TLinkedFragments\n  >[\"callRoute\"];\n  db: AbstractQuery<TSchema>;\n}\n\n// Safe: Catch-all for any fragment result type\ntype AnyFragmentResult = FragmentResult<\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any // eslint-disable-line @typescript-eslint/no-explicit-any\n>;\n\n// Safe: Catch-all for any fragment builder config type\ntype AnyFragmentBuilderConfig = FragmentBuilderConfig<\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any, // eslint-disable-line @typescript-eslint/no-explicit-any\n  any // eslint-disable-line @typescript-eslint/no-explicit-any\n>;\n\n/**\n * Configuration for a single fragment in the test builder\n */\ninterface FragmentBuilderConfig<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TBaseServices extends Record<string, unknown>,\n  TServices extends Record<string, unknown>,\n  TServiceDependencies,\n  TPrivateServices extends Record<string, unknown>,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage,\n  TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n  TLinkedFragments extends AnyLinkedFragments,\n> {\n  definition: FragmentDefinition<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  >;\n  builder: FragmentInstantiationBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TRoutesOrFactories,\n    TLinkedFragments\n  >;\n  migrateToVersion?: number;\n}\n\n/**\n * Test context combining base and adapter-specific functionality\n */\ntype TestContext<\n  T extends SupportedAdapter,\n  TFirstFragmentThisContext extends RequestThisContext = RequestThisContext,\n> = BaseTestContext &\n  AdapterContext<T> & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    adapter: DatabaseAdapter<any>;\n    /**\n     * Execute a callback within the first fragment's request context.\n     * This is useful for calling services outside of route handlers in tests.\n     */\n    inContext<TResult>(callback: (this: TFirstFragmentThisContext) => TResult): TResult;\n    inContext<TResult>(\n      callback: (this: TFirstFragmentThisContext) => Promise<TResult>,\n    ): Promise<TResult>;\n  };\n\n/**\n * Result of building the database fragments test\n */\ninterface DatabaseFragmentsTestResult<\n  TFragments extends Record<string, AnyFragmentResult>,\n  TAdapter extends SupportedAdapter,\n  TFirstFragmentThisContext extends RequestThisContext = RequestThisContext,\n> {\n  fragments: TFragments;\n  test: TestContext<TAdapter, TFirstFragmentThisContext>;\n}\n\n/**\n * Internal storage for fragment configurations\n */\ntype FragmentConfigMap = Map<string, AnyFragmentBuilderConfig>;\n\n/**\n * Builder for creating multiple database fragments for testing\n */\nexport class DatabaseFragmentsTestBuilder<\n  TFragments extends Record<string, AnyFragmentResult>,\n  TAdapter extends SupportedAdapter | undefined = undefined,\n  TFirstFragmentThisContext extends RequestThisContext = RequestThisContext,\n> {\n  #adapter?: SupportedAdapter;\n  #fragments: FragmentConfigMap = new Map();\n\n  /**\n   * Set the test adapter configuration\n   */\n  withTestAdapter<TNewAdapter extends SupportedAdapter>(\n    adapter: TNewAdapter,\n  ): DatabaseFragmentsTestBuilder<TFragments, TNewAdapter, TFirstFragmentThisContext> {\n    this.#adapter = adapter;\n    return this as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  }\n\n  /**\n   * Add a fragment to the test setup\n   *\n   * @param name - Unique name for the fragment\n   * @param builder - Pre-configured instantiation builder\n   * @param options - Additional options (optional)\n   */\n  withFragment<\n    TName extends string,\n    TConfig,\n    TOptions extends FragnoPublicConfig,\n    TDeps,\n    TBaseServices extends Record<string, unknown>,\n    TServices extends Record<string, unknown>,\n    TServiceDependencies,\n    TPrivateServices extends Record<string, unknown>,\n    TServiceThisContext extends RequestThisContext,\n    THandlerThisContext extends RequestThisContext,\n    TRequestStorage,\n    TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n    TLinkedFragments extends AnyLinkedFragments,\n  >(\n    name: TName,\n    builder: FragmentInstantiationBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TRoutesOrFactories,\n      TLinkedFragments\n    >,\n    options?: {\n      migrateToVersion?: number;\n    },\n  ): DatabaseFragmentsTestBuilder<\n    TFragments & {\n      [K in TName]: FragmentResult<\n        TDeps,\n        BoundServices<TBaseServices & TServices>,\n        TServiceThisContext,\n        THandlerThisContext,\n        TRequestStorage,\n        FlattenRouteFactories<TRoutesOrFactories>,\n        ExtractSchemaFromDeps<TDeps>, // Extract actual schema type from deps\n        TLinkedFragments\n      >;\n    },\n    TAdapter,\n    // If this is the first fragment (TFragments is empty {}), use THandlerThisContext; otherwise keep existing\n    keyof TFragments extends never ? THandlerThisContext : TFirstFragmentThisContext\n  > {\n    this.#fragments.set(name, {\n      definition: builder.definition,\n      builder,\n      migrateToVersion: options?.migrateToVersion,\n    });\n    return this as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  }\n\n  /**\n   * Build the test setup and return fragments and test context\n   */\n  async build(): Promise<\n    TAdapter extends SupportedAdapter\n      ? DatabaseFragmentsTestResult<TFragments, TAdapter, TFirstFragmentThisContext>\n      : never\n  > {\n    if (!this.#adapter) {\n      throw new Error(\"Test adapter must be set using withTestAdapter()\");\n    }\n\n    if (this.#fragments.size === 0) {\n      throw new Error(\"At least one fragment must be added using withFragment()\");\n    }\n\n    const adapterConfig = this.#adapter;\n\n    // Extract fragment names and configs\n    const fragmentNames = Array.from(this.#fragments.keys());\n    const fragmentConfigs = Array.from(this.#fragments.values());\n\n    // Extract schemas from definitions and prepare schema configs\n    const schemaConfigs: SchemaConfig[] = [];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const builderConfigs: Array<{ config: any; routes: any; options: any }> = [];\n\n    for (const fragmentConfig of fragmentConfigs) {\n      const builder = fragmentConfig.builder;\n      const definition = builder.definition;\n\n      // Extract schema from definition by calling dependencies with a mock adapter\n      let schema: AnySchema | undefined;\n      const namespace = definition.name + \"-db\";\n\n      if (definition.dependencies) {\n        try {\n          // Create a mock adapter to extract the schema\n          const mockAdapter = {\n            createQueryEngine: () => ({ schema: null }),\n            contextStorage: { run: (_data: unknown, fn: () => unknown) => fn() },\n          };\n\n          // Use the actual config from the builder instead of an empty mock\n          // This ensures dependencies can be properly initialized (e.g., Stripe with API keys)\n          const actualConfig = builder.config ?? {};\n\n          const deps = definition.dependencies({\n            config: actualConfig,\n            options: {\n              databaseAdapter: mockAdapter as any, // eslint-disable-line @typescript-eslint/no-explicit-any\n            } as any, // eslint-disable-line @typescript-eslint/no-explicit-any\n          });\n\n          // The schema is in deps.schema for database fragments\n          if (deps && typeof deps === \"object\" && \"schema\" in deps) {\n            schema = (deps as any).schema; // eslint-disable-line @typescript-eslint/no-explicit-any\n          }\n        } catch (error) {\n          // If extraction fails, provide a helpful error message\n          const errorMessage =\n            error instanceof Error\n              ? error.message\n              : typeof error === \"string\"\n                ? error\n                : \"Unknown error\";\n\n          throw new Error(\n            `Failed to extract schema from fragment '${definition.name}'.\\n` +\n              `Original error: ${errorMessage}\\n\\n` +\n              `Make sure the fragment is a database fragment using defineFragment().extend(withDatabase(schema)).`,\n          );\n        }\n      }\n\n      if (!schema) {\n        throw new Error(\n          `Fragment '${definition.name}' does not have a database schema. ` +\n            `Make sure you're using defineFragment().extend(withDatabase(schema)).`,\n        );\n      }\n\n      schemaConfigs.push({\n        schema,\n        namespace,\n        migrateToVersion: fragmentConfig.migrateToVersion,\n      });\n\n      // Extract config, routes, and options from builder using public getters\n      builderConfigs.push({\n        config: builder.config ?? {},\n        routes: builder.routes ?? [],\n        options: builder.options ?? {},\n      });\n    }\n\n    // Create adapter with all schemas\n    const { testContext, adapter } = await createAdapter(adapterConfig, schemaConfigs);\n\n    // Helper to create fragments with service wiring\n    const createFragments = () => {\n      // First pass: create fragments without service dependencies to extract provided services\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const providedServicesByName: Record<string, { service: any; orm: any }> = {};\n      const fragmentResults: any[] = []; // eslint-disable-line @typescript-eslint/no-explicit-any\n\n      for (let i = 0; i < fragmentConfigs.length; i++) {\n        const fragmentConfig = fragmentConfigs[i]!;\n        const builderConfig = builderConfigs[i]!;\n        const namespace = schemaConfigs[i]!.namespace;\n        const schema = schemaConfigs[i]!.schema;\n        const orm = testContext.getOrm(namespace);\n\n        // Merge builder options with database adapter\n        const mergedOptions = {\n          ...builderConfig.options,\n          databaseAdapter: adapter,\n        };\n\n        // Instantiate fragment using the builder\n        const fragment = fragmentConfig.builder.withOptions(mergedOptions).build();\n\n        // Extract provided services based on serviceDependencies metadata\n        // Note: serviceDependencies lists services this fragment USES, not provides\n        // For provided services, we need to check what's actually in fragment.services\n        // and match against other fragments' service dependencies\n\n        // Store all services as potentially provided\n        for (const [serviceName, serviceImpl] of Object.entries(fragment.services)) {\n          providedServicesByName[serviceName] = {\n            service: serviceImpl,\n            orm,\n          };\n        }\n\n        // Store the fragment result\n        const deps = fragment.$internal?.deps;\n\n        fragmentResults.push({\n          fragment,\n          services: fragment.services,\n          deps: deps || {},\n          callRoute: fragment.callRoute.bind(fragment),\n          get db() {\n            return orm;\n          },\n          _orm: orm,\n          _schema: schema,\n        });\n      }\n\n      // Second pass: rebuild fragments with service dependencies wired up\n      for (let i = 0; i < fragmentConfigs.length; i++) {\n        const fragmentConfig = fragmentConfigs[i]!;\n        const definition = fragmentConfig.builder.definition;\n        const builderConfig = builderConfigs[i]!;\n        const namespace = schemaConfigs[i]!.namespace;\n        const schema = schemaConfigs[i]!.schema;\n        const orm = testContext.getOrm(namespace);\n\n        // Build service implementations for services this fragment uses\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const serviceImplementations: Record<string, any> = {};\n        const serviceDependencies = definition.serviceDependencies;\n\n        if (serviceDependencies) {\n          for (const serviceName of Object.keys(serviceDependencies)) {\n            if (providedServicesByName[serviceName]) {\n              serviceImplementations[serviceName] = providedServicesByName[serviceName]!.service;\n            }\n          }\n        }\n\n        // Merge builder options with database adapter\n        const mergedOptions = {\n          ...builderConfig.options,\n          databaseAdapter: adapter,\n        };\n\n        // Rebuild the fragment with service implementations using the builder\n        const fragment = fragmentConfig.builder\n          .withOptions(mergedOptions)\n          .withServices(serviceImplementations as any) // eslint-disable-line @typescript-eslint/no-explicit-any\n          .build();\n\n        // Update the result\n        // Access deps from the internal property\n        const deps = fragment.$internal?.deps;\n\n        fragmentResults[i] = {\n          fragment,\n          services: fragment.services,\n          deps: deps || {},\n          callRoute: fragment.callRoute.bind(fragment),\n          get db() {\n            return orm;\n          },\n          _orm: orm,\n          _schema: schema,\n        };\n      }\n\n      return fragmentResults;\n    };\n\n    const fragmentResults = createFragments();\n\n    // Wrap resetDatabase to also recreate all fragments\n    const originalResetDatabase = testContext.resetDatabase;\n    const resetDatabase = async () => {\n      await originalResetDatabase();\n\n      // Recreate all fragments with service wiring\n      const newFragmentResults = createFragments();\n\n      // Update the result objects\n      newFragmentResults.forEach((newResult, index) => {\n        const result = fragmentResults[index]!;\n        result.fragment = newResult.fragment;\n        result.services = newResult.services;\n        result.deps = newResult.deps;\n        result.callRoute = newResult.callRoute;\n        result._orm = newResult._orm;\n      });\n    };\n\n    // Get the first fragment's inContext method\n    const firstFragment = fragmentResults[0]?.fragment;\n    if (!firstFragment) {\n      throw new Error(\"At least one fragment must be added\");\n    }\n\n    const finalTestContext = {\n      ...testContext,\n      resetDatabase,\n      adapter,\n      inContext: firstFragment.inContext.bind(firstFragment),\n    };\n\n    // Build result object with named fragments\n    const fragmentsObject = Object.fromEntries(\n      fragmentNames.map((name, index) => [name, fragmentResults[index]]),\n    );\n\n    // Safe cast: We've already validated that adapterConfig is SupportedAdapter at the beginning of build()\n    // TypeScript can't infer this through the conditional return type, so we use 'as any'\n    return {\n      fragments: fragmentsObject as TFragments,\n      test: finalTestContext,\n    } as any; // eslint-disable-line @typescript-eslint/no-explicit-any\n  }\n}\n\n/**\n * Create a builder for setting up multiple database fragments for testing.\n * This is the new builder-based API that works with the new fragment instantiation builders.\n *\n * @example\n * ```typescript\n * const userFragmentDef = defineFragment(\"user\")\n *   .extend(withDatabase(userSchema))\n *   .withDependencies(...)\n *   .build();\n *\n * const postFragmentDef = defineFragment(\"post\")\n *   .extend(withDatabase(postSchema))\n *   .withDependencies(...)\n *   .build();\n *\n * const { fragments, test } = await buildDatabaseFragmentsTest()\n *   .withTestAdapter({ type: \"kysely-sqlite\" })\n *   .withFragment(\"user\",\n *     instantiate(userFragmentDef)\n *       .withConfig({ ... })\n *       .withRoutes([...])\n *   )\n *   .withFragment(\"post\",\n *     instantiate(postFragmentDef)\n *       .withRoutes([...])\n *   )\n *   .build();\n *\n * // Access fragments by name\n * await fragments.user.services.createUser(...);\n * await fragments.post.services.createPost(...);\n *\n * // Access dependencies directly\n * const userDeps = fragments.user.deps;\n *\n * // Shared test context\n * await test.resetDatabase();\n * await test.cleanup();\n * const adapter = test.adapter; // Access the database adapter\n * ```\n */\nexport function buildDatabaseFragmentsTest(): DatabaseFragmentsTestBuilder<\n  {},\n  undefined,\n  RequestThisContext\n> {\n  return new DatabaseFragmentsTestBuilder();\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,40 +1,35 @@
-import { DrizzlePgliteAdapter, KyselyPgliteAdapter, KyselySqliteAdapter, SupportedAdapter, TestContext } from "./adapters.js";
-import { CreateFragmentForTestOptions, CreateFragmentForTestOptions as CreateFragmentForTestOptions$1, FragmentForTest, FragmentForTest as FragmentForTest$1, RouteHandlerInputOptions, createFragmentForTest } from "@fragno-dev/core/test";
+import { AdapterContext, DrizzlePgliteAdapter, KyselyPgliteAdapter, KyselySqliteAdapter, SupportedAdapter } from "./adapters.js";
+import { DatabaseFragmentsTestBuilder, buildDatabaseFragmentsTest } from "./db-test.js";
+import { CreateFragmentForTestOptions, RouteHandlerInputOptions, createFragmentForTest } from "@fragno-dev/core/test";
 import { AnySchema } from "@fragno-dev/db/schema";
-import { FragnoPublicConfig } from "@fragno-dev/core/api/fragment-instantiation";
-import { FragmentDefinition } from "@fragno-dev/core/api/fragment-builder";
-import { AnyRouteOrFactory, FlattenRouteFactories } from "@fragno-dev/core/api/route";
-import { FragnoRouteConfig } from "@fragno-dev/core";
-import { HTTPMethod } from "@fragno-dev/core/api";
-import { StandardSchemaV1 } from "@standard-schema/spec";
+import { AbstractQuery } from "@fragno-dev/db/query";
+import { DatabaseAdapter } from "@fragno-dev/db";
 
 //#region src/index.d.ts
 
 /**
- * Options for creating a database fragment for testing
+ * Base test context with common functionality across all adapters
  */
-interface CreateDatabaseFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig, TAdapter extends SupportedAdapter> extends Omit<CreateFragmentForTestOptions$1<TConfig, TDeps, TServices, TAdditionalContext, TOptions>, "config"> {
-  adapter: TAdapter;
-  migrateToVersion?: number;
-  config?: TConfig;
+interface BaseTestContext {
+  readonly adapter: DatabaseAdapter<any>;
+  resetDatabase: () => Promise<void>;
+  cleanup: () => Promise<void>;
 }
 /**
- * Result of creating a database fragment for testing
- * All properties are getters that return the current fragment instance
+ * Internal interface with getOrm for adapter implementations
  */
-interface DatabaseFragmentTestResult<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig, TAdapter extends SupportedAdapter, TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
-  readonly fragment: FragmentForTest$1<TConfig, TDeps, TServices, TAdditionalContext, TOptions, TRoutes>;
-  readonly services: TServices;
-  readonly callRoute: FragmentForTest$1<TConfig, TDeps, TServices, TAdditionalContext, TOptions, TRoutes>["callRoute"];
-  readonly config: TConfig;
-  readonly deps: TDeps;
-  readonly additionalContext: TAdditionalContext;
-  test: TestContext<TAdapter>;
+interface InternalTestContextMethods {
+  getOrm: <TSchema extends AnySchema>(namespace: string) => AbstractQuery<TSchema>;
 }
-declare function createDatabaseFragmentForTest<const TConfig, const TDeps, const TServices extends Record<string, unknown>, const TAdditionalContext extends Record<string, unknown>, const TOptions extends FragnoPublicConfig, const TSchema extends AnySchema, const TAdapter extends SupportedAdapter, const TRoutesOrFactories extends readonly AnyRouteOrFactory[]>(fragmentBuilder: {
-  definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;
-  $requiredOptions: TOptions;
-}, routesOrFactories: TRoutesOrFactories, options: CreateDatabaseFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions, TAdapter>): Promise<DatabaseFragmentTestResult<TConfig, TDeps, TServices, TAdditionalContext, TOptions, TAdapter, FlattenRouteFactories<TRoutesOrFactories>>>;
+/**
+ * Helper to create common test context methods from an ORM map
+ * This is used internally by adapter implementations to avoid code duplication
+ */
+declare function createCommonTestContextMethods(ormMap: Map<string, AbstractQuery<any>>): InternalTestContextMethods;
+/**
+ * Complete test context combining base and adapter-specific functionality
+ */
+type TestContext<T extends SupportedAdapter> = BaseTestContext & AdapterContext<T>;
 //#endregion
-export { CreateDatabaseFragmentForTestOptions, type CreateFragmentForTestOptions, DatabaseFragmentTestResult, type DrizzlePgliteAdapter, type FragmentForTest, type KyselyPgliteAdapter, type KyselySqliteAdapter, type RouteHandlerInputOptions, type SupportedAdapter, type TestContext, createDatabaseFragmentForTest, createFragmentForTest };
+export { type AdapterContext, BaseTestContext, type CreateFragmentForTestOptions, DatabaseFragmentsTestBuilder, type DrizzlePgliteAdapter, InternalTestContextMethods, type KyselyPgliteAdapter, type KyselySqliteAdapter, type RouteHandlerInputOptions, type SupportedAdapter, TestContext, buildDatabaseFragmentsTest, createCommonTestContextMethods, createFragmentForTest };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;AAyCA;;;AAMmB,UANF,oCAME,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BAFU,MAEV,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBADA,kBACA,EAAA,iBAAA,gBAAA,CAAA,SACT,IADS,CAEf,8BAFe,CAEc,OAFd,EAEuB,KAFvB,EAE8B,SAF9B,EAEyC,kBAFzC,EAE6D,QAF7D,CAAA,EAAA,QAAA,CAAA,CAAA;EAEc,OAAA,EAGtB,QAHsB;EAAS,gBAAA,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAKtC,OALsC;;;;;;AADvC,UAaO,0BAbP,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BAiBmB,MAjBnB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBAkBS,kBAlBT,EAAA,iBAmBS,gBAnBT,EAAA,gBAAA,SAoBiB,iBApBjB,CAqBN,UArBM,EAAA,MAAA,EAuBN,gBAvBM,GAAA,SAAA,EAwBN,gBAxBM,GAAA,SAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAAA;EAAI,SAAA,QAAA,EA6BO,iBA7BP,CA8BV,OA9BU,EA+BV,KA/BU,EAgCV,SAhCU,EAiCV,kBAjCU,EAkCV,QAlCU,EAmCV,OAnCU,CAAA;EAaG,SAAA,QAAA,EAwBI,SAxBJ;EAIY,SAAA,SAAA,EAqBP,iBArBO,CAsBzB,OAtByB,EAuBzB,KAvByB,EAwBzB,SAxByB,EAyBzB,kBAzByB,EA0BzB,QA1ByB,EA2BzB,OA3ByB,CAAA,CAAA,WAAA,CAAA;EACV,SAAA,MAAA,EA4BA,OA5BA;EACA,SAAA,IAAA,EA4BF,KA5BE;EAEf,SAAA,iBAAA,EA2B0B,kBA3B1B;EAEA,IAAA,EA0BI,WA1BJ,CA0BgB,QA1BhB,CAAA;;AAHuB,iBAgCL,6BAhCK,CAAA,aAAA,EAAA,WAAA,EAAA,wBAmCD,MAnCC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iCAoCQ,MApCR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,uBAqCF,kBArCE,EAAA,sBAsCH,SAtCG,EAAA,uBAuCF,gBAvCE,EAAA,iCAAA,SAwCiB,iBAxCjB,EAAA,CAAA,CAAA,eAAA,EAAA;EAUvB,UAAA,EAiCY,kBAjCZ,CAiC+B,OAjC/B,EAiCwC,KAjCxC,EAiC+C,SAjC/C,EAiC0D,kBAjC1D,CAAA;EACA,gBAAA,EAiCkB,QAjClB;CACA,EAAA,iBAAA,EAkCiB,kBAlCjB,EAAA,OAAA,EAmCO,oCAnCP,CAoCA,OApCA,EAqCA,KArCA,EAsCA,SAtCA,EAuCA,kBAvCA,EAwCA,QAxCA,EAyCA,QAzCA,CAAA,CAAA,EA2CD,OA3CC,CA4CF,0BA5CE,CA6CA,OA7CA,EA8CA,KA9CA,EA+CA,SA/CA,EAgDA,kBAhDA,EAiDA,QAjDA,EAkDA,QAlDA,EAmDA,qBAnDA,CAmDsB,kBAnDtB,CAAA,CAAA,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAiCA;;AAGuB,UAHN,eAAA,CAGM;EACN,SAAA,OAAA,EAFG,eAEH,CAAA,GAAA,CAAA;EAAO,aAAA,EAAA,GAAA,GADD,OACC,CAAA,IAAA,CAAA;EAMP,OAAA,EAAA,GAAA,GANA,OAMA,CAAA,IAAA,CAAA;;;;;AAQD,UARC,0BAAA,CAQ6B;EAExB,MAAA,EAAA,CAAA,gBATK,SASL,CAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GATsC,aAStC,CAToD,OASpD,CAAA;;;;AAgBtB;;AAAsD,iBAlBtC,8BAAA,CAkBsC,MAAA,EAhB5C,GAgB4C,CAAA,MAAA,EAhBhC,aAgBgC,CAAA,GAAA,CAAA,CAAA,CAAA,EAfnD,0BAemD;;;;KAA1C,sBAAsB,oBAAoB,kBAAkB,eAAe"}

package/dist/index.js

@@ -1,97 +1,19 @@
-import { createAdapter } from "./adapters.js";
-import { createFragmentForTest, createFragmentForTest as createFragmentForTest$1 } from "@fragno-dev/core/test";
+import { DatabaseFragmentsTestBuilder, buildDatabaseFragmentsTest } from "./db-test.js";
+import { createFragmentForTest } from "@fragno-dev/core/test";
 
 //#region src/index.ts
-async function createDatabaseFragmentForTest(fragmentBuilder, routesOrFactories, options) {
-	const { adapter: adapterConfig, migrateToVersion, config, options: fragmentOptions, deps, services, additionalContext } = options;
-	const fragmentAdditionalContext = fragmentBuilder.definition.additionalContext;
-	const schema = fragmentAdditionalContext?.databaseSchema;
-	const namespace = fragmentAdditionalContext?.databaseNamespace ?? "";
-	if (!schema) throw new Error(`Fragment '${fragmentBuilder.definition.name}' does not have a database schema. Make sure you're using defineFragmentWithDatabase().withDatabase(schema).`);
-	const { testContext: originalTestContext, adapter } = await createAdapter(adapterConfig, schema, namespace, migrateToVersion);
-	let mergedOptions = {
-		...fragmentOptions,
-		databaseAdapter: adapter
-	};
-	let fragment = createFragmentForTest$1(fragmentBuilder, routesOrFactories, {
-		config,
-		options: mergedOptions,
-		deps,
-		services,
-		additionalContext
-	});
-	const originalResetDatabase = originalTestContext.resetDatabase;
-	return {
-		get fragment() {
-			return fragment;
-		},
-		get services() {
-			return fragment.services;
-		},
-		get callRoute() {
-			return fragment.callRoute;
-		},
-		get config() {
-			return fragment.config;
-		},
-		get deps() {
-			return fragment.deps;
-		},
-		get additionalContext() {
-			return fragment.additionalContext;
-		},
-		test: Object.create(originalTestContext, {
-			db: {
-				get() {
-					return originalTestContext.db;
-				},
-				enumerable: true
-			},
-			kysely: {
-				get() {
-					return originalTestContext.kysely;
-				},
-				enumerable: true
-			},
-			drizzle: {
-				get() {
-					return originalTestContext.drizzle;
-				},
-				enumerable: true
-			},
-			adapter: {
-				get() {
-					return originalTestContext.adapter;
-				},
-				enumerable: true
-			},
-			resetDatabase: {
-				value: async () => {
-					await originalResetDatabase();
-					mergedOptions = {
-						...fragmentOptions,
-						databaseAdapter: originalTestContext.adapter
-					};
-					fragment = createFragmentForTest$1(fragmentBuilder, routesOrFactories, {
-						config,
-						options: mergedOptions,
-						deps,
-						services,
-						additionalContext
-					});
-				},
-				enumerable: true
-			},
-			cleanup: {
-				value: async () => {
-					await originalTestContext.cleanup();
-				},
-				enumerable: true
-			}
-		})
-	};
+/**
+* Helper to create common test context methods from an ORM map
+* This is used internally by adapter implementations to avoid code duplication
+*/
+function createCommonTestContextMethods(ormMap) {
+	return { getOrm: (namespace) => {
+		const orm = ormMap.get(namespace);
+		if (!orm) throw new Error(`No ORM found for namespace: ${namespace}`);
+		return orm;
+	} };
 }
 
 //#endregion
-export { createDatabaseFragmentForTest, createFragmentForTest };
+export { DatabaseFragmentsTestBuilder, buildDatabaseFragmentsTest, createCommonTestContextMethods, createFragmentForTest };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["createFragmentForTest"],"sources":["../src/index.ts"],"sourcesContent":["import type { AnySchema } from \"@fragno-dev/db/schema\";\nimport {\n  createFragmentForTest,\n  type FragmentForTest,\n  type CreateFragmentForTestOptions,\n} from \"@fragno-dev/core/test\";\nimport type { FragnoPublicConfig } from \"@fragno-dev/core/api/fragment-instantiation\";\nimport type { FragmentDefinition } from \"@fragno-dev/core/api/fragment-builder\";\nimport type { AnyRouteOrFactory, FlattenRouteFactories } from \"@fragno-dev/core/api/route\";\nimport {\n  createAdapter,\n  type SupportedAdapter,\n  type TestContext,\n  type KyselySqliteAdapter,\n  type KyselyPgliteAdapter,\n  type DrizzlePgliteAdapter,\n} from \"./adapters\";\nimport type { FragnoRouteConfig } from \"@fragno-dev/core\";\nimport type { HTTPMethod } from \"@fragno-dev/core/api\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n// Re-export utilities from @fragno-dev/core/test\nexport {\n  createFragmentForTest,\n  type CreateFragmentForTestOptions,\n  type RouteHandlerInputOptions,\n  type FragmentForTest,\n} from \"@fragno-dev/core/test\";\n\n// Re-export adapter types\nexport type {\n  SupportedAdapter,\n  KyselySqliteAdapter,\n  KyselyPgliteAdapter,\n  DrizzlePgliteAdapter,\n  TestContext,\n} from \"./adapters\";\n\n/**\n * Options for creating a database fragment for testing\n */\nexport interface CreateDatabaseFragmentForTestOptions<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n  TAdapter extends SupportedAdapter,\n> extends Omit<\n    CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>,\n    \"config\"\n  > {\n  adapter: TAdapter;\n  migrateToVersion?: number;\n  config?: TConfig;\n}\n\n/**\n * Result of creating a database fragment for testing\n * All properties are getters that return the current fragment instance\n */\nexport interface DatabaseFragmentTestResult<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n  TAdapter extends SupportedAdapter,\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> {\n  readonly fragment: FragmentForTest<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TOptions,\n    TRoutes\n  >;\n  readonly services: TServices;\n  readonly callRoute: FragmentForTest<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TOptions,\n    TRoutes\n  >[\"callRoute\"];\n  readonly config: TConfig;\n  readonly deps: TDeps;\n  readonly additionalContext: TAdditionalContext;\n  test: TestContext<TAdapter>;\n}\n\nexport async function createDatabaseFragmentForTest<\n  const TConfig,\n  const TDeps,\n  const TServices extends Record<string, unknown>,\n  const TAdditionalContext extends Record<string, unknown>,\n  const TOptions extends FragnoPublicConfig,\n  const TSchema extends AnySchema,\n  const TAdapter extends SupportedAdapter,\n  const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n>(\n  fragmentBuilder: {\n    definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;\n    $requiredOptions: TOptions;\n  },\n  routesOrFactories: TRoutesOrFactories,\n  options: CreateDatabaseFragmentForTestOptions<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TOptions,\n    TAdapter\n  >,\n): Promise<\n  DatabaseFragmentTestResult<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TOptions,\n    TAdapter,\n    FlattenRouteFactories<TRoutesOrFactories>\n  >\n> {\n  const {\n    adapter: adapterConfig,\n    migrateToVersion,\n    config,\n    options: fragmentOptions,\n    deps,\n    services,\n    additionalContext,\n  } = options;\n\n  // Get schema and namespace from fragment definition's additionalContext\n  // Safe cast: DatabaseFragmentBuilder adds databaseSchema and databaseNamespace to additionalContext\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const fragmentAdditionalContext = fragmentBuilder.definition.additionalContext as any;\n  const schema = fragmentAdditionalContext?.databaseSchema as TSchema | undefined;\n  const namespace = (fragmentAdditionalContext?.databaseNamespace as string | undefined) ?? \"\";\n\n  if (!schema) {\n    throw new Error(\n      `Fragment '${fragmentBuilder.definition.name}' does not have a database schema. ` +\n        `Make sure you're using defineFragmentWithDatabase().withDatabase(schema).`,\n    );\n  }\n\n  // Create adapter using the factory\n  const { testContext: originalTestContext, adapter } = await createAdapter(\n    adapterConfig,\n    schema,\n    namespace,\n    migrateToVersion,\n  );\n\n  // Create fragment with database adapter in options\n  // Safe cast: We're merging the user's options with the databaseAdapter, which is required by TOptions\n  // The user's TOptions is constrained to FragnoPublicConfig (or a subtype), which we extend with databaseAdapter\n  let mergedOptions = {\n    ...fragmentOptions,\n    databaseAdapter: adapter,\n  } as unknown as TOptions;\n\n  let fragment = createFragmentForTest(fragmentBuilder, routesOrFactories, {\n    // Safe cast: If config is not provided, we pass undefined as TConfig.\n    // The base createFragmentForTest expects config: TConfig, but if TConfig allows undefined\n    // or if the fragment doesn't use config in its dependencies function, this will work correctly.\n    config: config as TConfig,\n    options: mergedOptions,\n    deps,\n    services,\n    additionalContext,\n  });\n\n  // Wrap resetDatabase to also recreate the fragment with the new adapter\n  const originalResetDatabase = originalTestContext.resetDatabase;\n\n  // Create test context with getters that always return current values\n  // We need to cast to any to avoid TypeScript errors when accessing kysely/drizzle properties\n  // that may not exist depending on the adapter type\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const testContext: any = Object.create(originalTestContext, {\n    db: {\n      get() {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        return (originalTestContext as any).db;\n      },\n      enumerable: true,\n    },\n    kysely: {\n      get() {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        return (originalTestContext as any).kysely;\n      },\n      enumerable: true,\n    },\n    drizzle: {\n      get() {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        return (originalTestContext as any).drizzle;\n      },\n      enumerable: true,\n    },\n    adapter: {\n      get() {\n        return originalTestContext.adapter;\n      },\n      enumerable: true,\n    },\n    resetDatabase: {\n      value: async () => {\n        // Call the original reset database function\n        await originalResetDatabase();\n\n        // Recreate the fragment with the new adapter (which has been updated by the factory's resetDatabase)\n        mergedOptions = {\n          ...fragmentOptions,\n          databaseAdapter: originalTestContext.adapter,\n        } as unknown as TOptions;\n\n        fragment = createFragmentForTest(fragmentBuilder, routesOrFactories, {\n          config: config as TConfig,\n          options: mergedOptions,\n          deps,\n          services,\n          additionalContext,\n        });\n      },\n      enumerable: true,\n    },\n    cleanup: {\n      value: async () => {\n        await originalTestContext.cleanup();\n      },\n      enumerable: true,\n    },\n  });\n\n  // Return an object with getters for fragment properties so they always reference the current fragment\n  return {\n    get fragment() {\n      return fragment;\n    },\n    get services() {\n      return fragment.services;\n    },\n    get callRoute() {\n      return fragment.callRoute;\n    },\n    get config() {\n      return fragment.config;\n    },\n    get deps() {\n      return fragment.deps;\n    },\n    get additionalContext() {\n      return fragment.additionalContext;\n    },\n    test: testContext,\n  };\n}\n"],"mappings":";;;;AAoGA,eAAsB,8BAUpB,iBAIA,mBACA,SAkBA;CACA,MAAM,EACJ,SAAS,eACT,kBACA,QACA,SAAS,iBACT,MACA,UACA,sBACE;CAKJ,MAAM,4BAA4B,gBAAgB,WAAW;CAC7D,MAAM,SAAS,2BAA2B;CAC1C,MAAM,YAAa,2BAA2B,qBAA4C;AAE1F,KAAI,CAAC,OACH,OAAM,IAAI,MACR,aAAa,gBAAgB,WAAW,KAAK,8GAE9C;CAIH,MAAM,EAAE,aAAa,qBAAqB,YAAY,MAAM,cAC1D,eACA,QACA,WACA,iBACD;CAKD,IAAI,gBAAgB;EAClB,GAAG;EACH,iBAAiB;EAClB;CAED,IAAI,WAAWA,wBAAsB,iBAAiB,mBAAmB;EAI/D;EACR,SAAS;EACT;EACA;EACA;EACD,CAAC;CAGF,MAAM,wBAAwB,oBAAoB;AAgElD,QAAO;EACL,IAAI,WAAW;AACb,UAAO;;EAET,IAAI,WAAW;AACb,UAAO,SAAS;;EAElB,IAAI,YAAY;AACd,UAAO,SAAS;;EAElB,IAAI,SAAS;AACX,UAAO,SAAS;;EAElB,IAAI,OAAO;AACT,UAAO,SAAS;;EAElB,IAAI,oBAAoB;AACtB,UAAO,SAAS;;EAElB,MA7EuB,OAAO,OAAO,qBAAqB;GAC1D,IAAI;IACF,MAAM;AAEJ,YAAQ,oBAA4B;;IAEtC,YAAY;IACb;GACD,QAAQ;IACN,MAAM;AAEJ,YAAQ,oBAA4B;;IAEtC,YAAY;IACb;GACD,SAAS;IACP,MAAM;AAEJ,YAAQ,oBAA4B;;IAEtC,YAAY;IACb;GACD,SAAS;IACP,MAAM;AACJ,YAAO,oBAAoB;;IAE7B,YAAY;IACb;GACD,eAAe;IACb,OAAO,YAAY;AAEjB,WAAM,uBAAuB;AAG7B,qBAAgB;MACd,GAAG;MACH,iBAAiB,oBAAoB;MACtC;AAED,gBAAWA,wBAAsB,iBAAiB,mBAAmB;MAC3D;MACR,SAAS;MACT;MACA;MACA;MACD,CAAC;;IAEJ,YAAY;IACb;GACD,SAAS;IACP,OAAO,YAAY;AACjB,WAAM,oBAAoB,SAAS;;IAErC,YAAY;IACb;GACF,CAAC;EAuBD"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { AnySchema } from \"@fragno-dev/db/schema\";\nimport type {\n  SupportedAdapter,\n  AdapterContext,\n  KyselySqliteAdapter,\n  KyselyPgliteAdapter,\n  DrizzlePgliteAdapter,\n} from \"./adapters\";\nimport type { DatabaseAdapter } from \"@fragno-dev/db\";\nimport type { AbstractQuery } from \"@fragno-dev/db/query\";\n\n// Re-export utilities from @fragno-dev/core/test\nexport {\n  createFragmentForTest,\n  type CreateFragmentForTestOptions,\n  type RouteHandlerInputOptions,\n} from \"@fragno-dev/core/test\";\n\n// Re-export adapter types\nexport type {\n  SupportedAdapter,\n  KyselySqliteAdapter,\n  KyselyPgliteAdapter,\n  DrizzlePgliteAdapter,\n  AdapterContext,\n} from \"./adapters\";\n\n// Re-export new builder-based database test utilities\nexport { buildDatabaseFragmentsTest, DatabaseFragmentsTestBuilder } from \"./db-test\";\n\n/**\n * Base test context with common functionality across all adapters\n */\nexport interface BaseTestContext {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly adapter: DatabaseAdapter<any>;\n  resetDatabase: () => Promise<void>;\n  cleanup: () => Promise<void>;\n}\n\n/**\n * Internal interface with getOrm for adapter implementations\n */\nexport interface InternalTestContextMethods {\n  getOrm: <TSchema extends AnySchema>(namespace: string) => AbstractQuery<TSchema>;\n}\n\n/**\n * Helper to create common test context methods from an ORM map\n * This is used internally by adapter implementations to avoid code duplication\n */\nexport function createCommonTestContextMethods(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ormMap: Map<string, AbstractQuery<any>>,\n): InternalTestContextMethods {\n  return {\n    getOrm: <TSchema extends AnySchema>(namespace: string) => {\n      const orm = ormMap.get(namespace);\n      if (!orm) {\n        throw new Error(`No ORM found for namespace: ${namespace}`);\n      }\n      return orm as AbstractQuery<TSchema>;\n    },\n  };\n}\n\n/**\n * Complete test context combining base and adapter-specific functionality\n */\nexport type TestContext<T extends SupportedAdapter> = BaseTestContext & AdapterContext<T>;\n"],"mappings":";;;;;;;;AAmDA,SAAgB,+BAEd,QAC4B;AAC5B,QAAO,EACL,SAAoC,cAAsB;EACxD,MAAM,MAAM,OAAO,IAAI,UAAU;AACjC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,+BAA+B,YAAY;AAE7D,SAAO;IAEV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/test",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "exports": {
     ".": {
@@ -15,15 +15,15 @@
   "dependencies": {
     "@standard-schema/spec": "^1.0.0",
     "kysely": "^0.28.7",
-    "sqlocal": "^0.15.2",
-    "@fragno-dev/core": "0.1.7",
-    "@fragno-dev/db": "0.1.13"
+    "sqlocal": "^0.15.2"
   },
   "peerDependencies": {
     "@electric-sql/pglite": "^0.3.11",
     "drizzle-kit": "^0.30.3",
     "drizzle-orm": "^0.44.7",
-    "kysely-pglite": "^0.6.1"
+    "kysely-pglite": "^0.6.1",
+    "@fragno-dev/core": "0.1.9",
+    "@fragno-dev/db": "0.1.15"
   },
   "peerDependenciesMeta": {
     "@electric-sql/pglite": {
@@ -49,6 +49,8 @@
     "kysely-pglite": "^0.6.1",
     "vitest": "^3.2.4",
     "zod": "^4.1.12",
+    "@fragno-dev/core": "0.1.9",
+    "@fragno-dev/db": "0.1.15",
     "@fragno-private/typescript-config": "0.0.1",
     "@fragno-private/vitest-config": "0.0.0"
   },