@fragno-dev/test 0.1.12 → 0.1.13

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fragno-dev/test@0.1.12 build /home/runner/work/fragno/fragno/packages/fragno-test
+> @fragno-dev/test@0.1.13 build /home/runner/work/fragno/fragno/packages/fragno-test
 > tsdown
 
 ℹ tsdown v0.15.12 powered by rolldown v1.0.0-beta.45
@@ -7,13 +7,17 @@
 ℹ entry: src/index.ts
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/index.js            5.83 kB │ gzip: 1.61 kB
-ℹ dist/index.js.map       19.40 kB │ gzip: 4.76 kB
+ℹ dist/index.js            0.71 kB │ gzip: 0.40 kB
+ℹ dist/db-test.js.map     23.72 kB │ gzip: 5.83 kB
 ℹ dist/adapters.js.map    18.56 kB │ gzip: 4.04 kB
 ℹ dist/adapters.js         7.97 kB │ gzip: 1.74 kB
-ℹ dist/index.d.ts.map      3.95 kB │ gzip: 1.63 kB
+ℹ dist/db-test.js          7.25 kB │ gzip: 2.14 kB
+ℹ dist/db-test.d.ts.map    3.19 kB │ gzip: 1.47 kB
+ℹ dist/index.js.map        2.44 kB │ gzip: 0.96 kB
+ℹ dist/index.d.ts.map      0.55 kB │ gzip: 0.31 kB
 ℹ dist/adapters.d.ts.map   0.42 kB │ gzip: 0.27 kB
-ℹ dist/index.d.ts          6.22 kB │ gzip: 1.54 kB
+ℹ dist/index.d.ts          1.79 kB │ gzip: 0.68 kB
+ℹ dist/db-test.d.ts        6.67 kB │ gzip: 1.80 kB
 ℹ dist/adapters.d.ts       0.95 kB │ gzip: 0.37 kB
-ℹ 8 files, total: 63.32 kB
-✔ Build complete in 12873ms
+ℹ 12 files, total: 74.22 kB
+✔ Build complete in 1914ms

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @fragno-dev/test
 
+## 0.1.13
+
+### Patch Changes
+
+- e848208: feat: restrict Unit of Work in service contexts
+- 0f4c9fe: fix: move core/db dependencies to peerDependencies
+- 7276378: feat: add providesPrivateService method to Fragment definition
+
+  This allows the Fragment author to define private services that are only accessible within the
+  Fragment's own code.
+
+- 5ea24d2: refactor: improve Fragment builder and instatiator
+- Updated dependencies [d6a7ff5]
+- Updated dependencies [e848208]
+- Updated dependencies [e9b2e7d]
+- Updated dependencies [5e185bc]
+- Updated dependencies [ec622bc]
+- Updated dependencies [219ce35]
+- Updated dependencies [b34917f]
+- Updated dependencies [7276378]
+- Updated dependencies [462004f]
+- Updated dependencies [5ea24d2]
+- Updated dependencies [f22c503]
+- Updated dependencies [3474006]
+  - @fragno-dev/db@0.1.15
+  - @fragno-dev/core@0.1.9
+
 ## 0.1.12
 
 ### Patch Changes

package/dist/db-test.d.ts

@@ -0,0 +1,129 @@
+import { AdapterContext, SupportedAdapter } from "./adapters.js";
+import { BaseTestContext } from "./index.js";
+import { AnySchema } from "@fragno-dev/db/schema";
+import { AbstractQuery } from "@fragno-dev/db/query";
+import { DatabaseAdapter } from "@fragno-dev/db";
+import { FragmentInstantiationBuilder, FragnoInstantiatedFragment, FragnoPublicConfig, RequestThisContext } from "@fragno-dev/core";
+import { AnyRouteOrFactory, FlattenRouteFactories } from "@fragno-dev/core/route";
+
+//#region src/db-test.d.ts
+type BoundServices<T> = { [K in keyof T]: T[K] extends ((this: any, ...args: infer A) => infer R) ? (...args: A) => R : T[K] extends Record<string, unknown> ? BoundServices<T[K]> : T[K] };
+type ExtractSchemaFromDeps<TDeps> = TDeps extends {
+  schema: infer TSchema extends AnySchema;
+} ? TSchema : AnySchema;
+type AnyLinkedFragments = Record<string, any>;
+interface FragmentResult<TDeps, TServices extends Record<string, unknown>, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage, TRoutes extends readonly any[],
+// eslint-disable-line @typescript-eslint/no-explicit-any
+TSchema$1 extends AnySchema, TLinkedFragments extends AnyLinkedFragments = {}> {
+  fragment: FragnoInstantiatedFragment<TRoutes, TDeps, TServices, TServiceThisContext, THandlerThisContext, TRequestStorage, FragnoPublicConfig, TLinkedFragments>;
+  services: TServices;
+  deps: TDeps;
+  callRoute: FragnoInstantiatedFragment<TRoutes, TDeps, TServices, TServiceThisContext, THandlerThisContext, TRequestStorage, FragnoPublicConfig, TLinkedFragments>["callRoute"];
+  db: AbstractQuery<TSchema$1>;
+}
+type AnyFragmentResult = FragmentResult<any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any,
+// eslint-disable-line @typescript-eslint/no-explicit-any
+any>;
+/**
+ * Test context combining base and adapter-specific functionality
+ */
+type TestContext<T extends SupportedAdapter, TFirstFragmentThisContext extends RequestThisContext = RequestThisContext> = BaseTestContext & AdapterContext<T> & {
+  adapter: DatabaseAdapter<any>;
+  /**
+   * Execute a callback within the first fragment's request context.
+   * This is useful for calling services outside of route handlers in tests.
+   */
+  inContext<TResult>(callback: (this: TFirstFragmentThisContext) => TResult): TResult;
+  inContext<TResult>(callback: (this: TFirstFragmentThisContext) => Promise<TResult>): Promise<TResult>;
+};
+/**
+ * Result of building the database fragments test
+ */
+interface DatabaseFragmentsTestResult<TFragments extends Record<string, AnyFragmentResult>, TAdapter extends SupportedAdapter, TFirstFragmentThisContext extends RequestThisContext = RequestThisContext> {
+  fragments: TFragments;
+  test: TestContext<TAdapter, TFirstFragmentThisContext>;
+}
+/**
+ * Builder for creating multiple database fragments for testing
+ */
+declare class DatabaseFragmentsTestBuilder<TFragments extends Record<string, AnyFragmentResult>, TAdapter extends SupportedAdapter | undefined = undefined, TFirstFragmentThisContext extends RequestThisContext = RequestThisContext> {
+  #private;
+  /**
+   * Set the test adapter configuration
+   */
+  withTestAdapter<TNewAdapter extends SupportedAdapter>(adapter: TNewAdapter): DatabaseFragmentsTestBuilder<TFragments, TNewAdapter, TFirstFragmentThisContext>;
+  /**
+   * 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<TName extends string, TConfig, TOptions extends FragnoPublicConfig, TDeps, TBaseServices extends Record<string, unknown>, TServices extends Record<string, unknown>, TServiceDependencies, TPrivateServices extends Record<string, unknown>, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage, TRoutesOrFactories extends readonly AnyRouteOrFactory[], TLinkedFragments extends AnyLinkedFragments>(name: TName, builder: FragmentInstantiationBuilder<TConfig, TOptions, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage, TRoutesOrFactories, TLinkedFragments>, options?: {
+    migrateToVersion?: number;
+  }): DatabaseFragmentsTestBuilder<TFragments & { [K in TName]: FragmentResult<TDeps, BoundServices<TBaseServices & TServices>, TServiceThisContext, THandlerThisContext, TRequestStorage, FlattenRouteFactories<TRoutesOrFactories>, ExtractSchemaFromDeps<TDeps>,
+  // Extract actual schema type from deps
+  TLinkedFragments> }, TAdapter, keyof TFragments extends never ? THandlerThisContext : TFirstFragmentThisContext>;
+  /**
+   * Build the test setup and return fragments and test context
+   */
+  build(): Promise<TAdapter extends SupportedAdapter ? DatabaseFragmentsTestResult<TFragments, TAdapter, TFirstFragmentThisContext> : never>;
+}
+/**
+ * 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
+ * ```
+ */
+declare function buildDatabaseFragmentsTest(): DatabaseFragmentsTestBuilder<{}, undefined, RequestThisContext>;
+//#endregion
+export { DatabaseFragmentsTestBuilder, buildDatabaseFragmentsTest };
+//# sourceMappingURL=db-test.d.ts.map

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

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

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,11 +1,9 @@
 import { AdapterContext, DrizzlePgliteAdapter, KyselyPgliteAdapter, KyselySqliteAdapter, SupportedAdapter } from "./adapters.js";
-import { CreateFragmentForTestOptions, FragmentForTest, FragmentForTest as FragmentForTest$1, RouteHandlerInputOptions, createFragmentForTest } from "@fragno-dev/core/test";
-import { DatabaseAdapter, IUnitOfWorkBase } from "@fragno-dev/db";
+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 { AbstractQuery } from "@fragno-dev/db/query";
+import { DatabaseAdapter } from "@fragno-dev/db";
 
 //#region src/index.d.ts
 
@@ -14,9 +12,6 @@ import { AbstractQuery } from "@fragno-dev/db/query";
  */
 interface BaseTestContext {
   readonly adapter: DatabaseAdapter<any>;
-  createUnitOfWork: (name?: string) => IUnitOfWorkBase;
-  withUnitOfWork: <T>(fn: (uow: IUnitOfWorkBase) => Promise<T>) => Promise<T>;
-  callService: <T>(fn: () => T | Promise<T>) => Promise<T>;
   resetDatabase: () => Promise<void>;
   cleanup: () => Promise<void>;
 }
@@ -24,10 +19,7 @@ interface BaseTestContext {
  * Internal interface with getOrm for adapter implementations
  */
 interface InternalTestContextMethods {
-  getOrm: <TSchema$1 extends AnySchema>(namespace: string) => AbstractQuery<TSchema$1>;
-  createUnitOfWork: (name?: string) => IUnitOfWorkBase;
-  withUnitOfWork: <T>(fn: (uow: IUnitOfWorkBase) => Promise<T>) => Promise<T>;
-  callService: <T>(fn: () => T | Promise<T>) => Promise<T>;
+  getOrm: <TSchema extends AnySchema>(namespace: string) => AbstractQuery<TSchema>;
 }
 /**
  * Helper to create common test context methods from an ORM map
@@ -38,75 +30,6 @@ declare function createCommonTestContextMethods(ormMap: Map<string, AbstractQuer
  * Complete test context combining base and adapter-specific functionality
  */
 type TestContext<T extends SupportedAdapter> = BaseTestContext & AdapterContext<T>;
-/**
- * Helper type to extract the schema from a fragment definition's additional context
- */
-type ExtractSchemaFromAdditionalContext<TAdditionalContext> = TAdditionalContext extends {
-  databaseSchema?: infer TSchema extends AnySchema;
-} ? TSchema : AnySchema;
-/**
- * Fragment configuration for multi-fragment setup
- */
-interface FragmentConfig<TDef extends {
-  definition: FragmentDefinition<any, any, any, any, any, any>;
-  $requiredOptions: any;
-} = {
-  definition: FragmentDefinition<any, any, any, any, any, any>;
-  $requiredOptions: any;
-}, TRoutes extends readonly AnyRouteOrFactory[] = readonly AnyRouteOrFactory[]> {
-  definition: TDef;
-  routes: TRoutes;
-  config?: TDef["definition"] extends FragmentDefinition<infer TConfig, any, any, any, any, any> ? TConfig : never;
-  migrateToVersion?: number;
-}
-/**
- * Options for creating multiple database fragments for testing
- */
-interface MultiFragmentTestOptions<TAdapter extends SupportedAdapter> {
-  adapter: TAdapter;
-}
-/**
- * Result type for a single fragment in a multi-fragment setup
- */
-type FragmentResultFromConfig<TConfig$1 extends FragmentConfig> = TConfig$1["definition"] extends {
-  definition: FragmentDefinition<infer TConf, infer TDeps, infer TServices, infer TAdditionalCtx, any, infer TProvidedServices>;
-  $requiredOptions: infer TOptions extends FragnoPublicConfig;
-} ? {
-  fragment: FragmentForTest$1<TConf, TDeps, TServices & TProvidedServices, TAdditionalCtx, TOptions, FlattenRouteFactories<TConfig$1["routes"]>>;
-  services: TServices & TProvidedServices;
-  callRoute: FragmentForTest$1<TConf, TDeps, TServices & TProvidedServices, TAdditionalCtx, TOptions, FlattenRouteFactories<TConfig$1["routes"]>>["callRoute"];
-  config: TConf;
-  deps: TDeps;
-  additionalContext: TAdditionalCtx;
-  db: AbstractQuery<ExtractSchemaFromAdditionalContext<TAdditionalCtx>>;
-} : never;
-interface SingleFragmentTestResult<TFragment extends FragmentConfig, TAdapter extends SupportedAdapter> {
-  fragment: FragmentResultFromConfig<TFragment>;
-  test: TestContext<TAdapter>;
-}
-/**
- * Result of creating multiple database fragments for testing (array input)
- */
-interface MultiFragmentTestResult<TFragments extends readonly FragmentConfig[], TAdapter extends SupportedAdapter> {
-  fragments: { [K in keyof TFragments]: FragmentResultFromConfig<TFragments[K]> };
-  test: TestContext<TAdapter>;
-}
-/**
- * Result of creating multiple database fragments for testing (object input)
- */
-interface NamedMultiFragmentTestResult<TFragments extends Record<string, FragmentConfig>, TAdapter extends SupportedAdapter> {
-  fragments: { [K in keyof TFragments]: FragmentResultFromConfig<TFragments[K]> };
-  test: TestContext<TAdapter>;
-}
-/**
- * Create multiple database fragments for testing with a shared adapter (array input)
- */
-declare function createDatabaseFragmentsForTest<const TFragments extends readonly FragmentConfig[], const TAdapter extends SupportedAdapter>(fragments: TFragments, options: MultiFragmentTestOptions<TAdapter>): Promise<MultiFragmentTestResult<TFragments, TAdapter>>;
-/**
- * Create multiple database fragments for testing with a shared adapter (object input)
- */
-declare function createDatabaseFragmentsForTest<const TFragments extends Record<string, FragmentConfig>, const TAdapter extends SupportedAdapter>(fragments: TFragments, options: MultiFragmentTestOptions<TAdapter>): Promise<NamedMultiFragmentTestResult<TFragments, TAdapter>>;
-declare function createDatabaseFragmentForTest<const TFragment extends FragmentConfig, const TAdapter extends SupportedAdapter>(fragment: TFragment, options: MultiFragmentTestOptions<TAdapter>): Promise<SingleFragmentTestResult<TFragment, TAdapter>>;
 //#endregion
-export { type AdapterContext, BaseTestContext, type CreateFragmentForTestOptions, type DrizzlePgliteAdapter, FragmentConfig, type FragmentForTest, InternalTestContextMethods, type KyselyPgliteAdapter, type KyselySqliteAdapter, MultiFragmentTestOptions, MultiFragmentTestResult, NamedMultiFragmentTestResult, type RouteHandlerInputOptions, SingleFragmentTestResult, type SupportedAdapter, TestContext, createCommonTestContextMethods, createDatabaseFragmentForTest, createDatabaseFragmentsForTest, 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":"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"}
+{"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"}