@fragno-dev/test 0.1.1 → 0.1.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fragno-dev/test@0.1.1 build /home/runner/work/fragno/fragno/packages/fragno-test
+> @fragno-dev/test@0.1.2 build /home/runner/work/fragno/fragno/packages/fragno-test
 > tsdown
 
 ℹ tsdown v0.15.10 powered by rolldown v1.0.0-beta.44
@@ -7,9 +7,9 @@
 ℹ entry: src/index.ts
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/index.js        1.64 kB │ gzip: 0.67 kB
-ℹ dist/index.js.map    5.90 kB │ gzip: 1.93 kB
-ℹ dist/index.d.ts.map  1.21 kB │ gzip: 0.57 kB
-ℹ dist/index.d.ts      2.29 kB │ gzip: 0.68 kB
-ℹ 4 files, total: 11.04 kB
-✔ Build complete in 11624ms
+ℹ dist/index.js        2.63 kB │ gzip: 0.89 kB
+ℹ dist/index.js.map    8.17 kB │ gzip: 2.51 kB
+ℹ dist/index.d.ts.map  1.28 kB │ gzip: 0.59 kB
+ℹ dist/index.d.ts      2.55 kB │ gzip: 0.80 kB
+ℹ 4 files, total: 14.63 kB
+✔ Build complete in 4126ms

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @fragno-dev/test
 
+## 0.1.2
+
+### Patch Changes
+
+- 6fd2528: feat(testing): add resetDatabase method to test Fragment instance
+- Updated dependencies [70bdcb2]
+  - @fragno-dev/db@0.1.6
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -21,6 +21,11 @@ interface CreateDatabaseFragmentForTestOptions<TConfig, TDeps, TServices, TAddit
 interface DatabaseFragmentForTest<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig> extends FragmentForTest$1<TConfig, TDeps, TServices, TAdditionalContext, TOptions> {
   kysely: Kysely<any>;
   adapter: DatabaseAdapter<any>;
+  /**
+   * Resets the database by creating a fresh in-memory database instance and re-running migrations.
+   * After calling this, you should re-initialize any routes to ensure they use the new database instance.
+   */
+  resetDatabase: () => Promise<void>;
 }
 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>(fragmentBuilder: {
   definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA0BA;;AAKmB,UALF,oCAKE,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BADU,MACV,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBAAA,kBAAA,CAAA,SACT,IADS,CAEf,8BAFe,CAEc,OAFd,EAEuB,KAFvB,EAE8B,SAF9B,EAEyC,kBAFzC,EAE6D,QAF7D,CAAA,EAAA,QAAA,CAAA,CAAA;EAEc,YAAA,CAAA,EAAA,MAAA;EAAS,gBAAA,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAKtC,OALsC;;;;;AADvC,UAYO,uBAZP,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BAgBmB,MAhBnB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBAiBS,kBAjBT,CAAA,SAkBA,iBAlBA,CAkBgB,OAlBhB,EAkByB,KAlBzB,EAkBgC,SAlBhC,EAkB2C,kBAlB3C,EAkB+D,QAlB/D,CAAA,CAAA;EAAI,MAAA,EAoBJ,MApBI,CAAA,GAAA,CAAA;EAYG,OAAA,EAUN,eAVM,CAAA,GAAuB,CAAA;;AAKrB,iBAQG,6BARH,CAAA,aAAA,EAAA,WAAA,EAAA,wBAWO,MAXP,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iCAYgB,MAZhB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,uBAaM,kBAbN,EAAA,sBAcK,SAdL,CAAA,CAAA,eAAA,EAAA;EACO,UAAA,EAgBV,kBAhBU,CAgBS,OAhBT,EAgBkB,KAhBlB,EAgByB,SAhBzB,EAgBoC,kBAhBpC,CAAA;EAAS,gBAAA,EAiBb,QAjBa;CAAO,EAAA,OAAA,CAAA,EAmB9B,oCAnB8B,CAoBtC,OApBsC,EAqBtC,KArBsC,EAsBtC,SAtBsC,EAuBtC,kBAvBsC,EAwBtC,QAxBsC,CAAA,CAAA,EA0BvC,OA1BuC,CA0B/B,uBA1B+B,CA0BP,OA1BO,EA0BE,KA1BF,EA0BS,SA1BT,EA0BoB,kBA1BpB,EA0BwC,QA1BxC,CAAA,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA0BA;;AAKmB,UALF,oCAKE,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BADU,MACV,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBAAA,kBAAA,CAAA,SACT,IADS,CAEf,8BAFe,CAEc,OAFd,EAEuB,KAFvB,EAE8B,SAF9B,EAEyC,kBAFzC,EAE6D,QAF7D,CAAA,EAAA,QAAA,CAAA,CAAA;EAEc,YAAA,CAAA,EAAA,MAAA;EAAS,gBAAA,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAKtC,OALsC;;;;;AADvC,UAYO,uBAZP,CAAA,OAAA,EAAA,KAAA,EAAA,SAAA,EAAA,2BAgBmB,MAhBnB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iBAiBS,kBAjBT,CAAA,SAkBA,iBAlBA,CAkBgB,OAlBhB,EAkByB,KAlBzB,EAkBgC,SAlBhC,EAkB2C,kBAlB3C,EAkB+D,QAlB/D,CAAA,CAAA;EAAI,MAAA,EAoBJ,MApBI,CAAA,GAAA,CAAA;EAYG,OAAA,EAUN,eAVM,CAAA,GAAuB,CAAA;EAIX;;;;EAEa,aAAA,EAAA,GAAA,GASnB,OATmB,CAAA,IAAA,CAAA;;AAA+B,iBAYnD,6BAZmD,CAAA,aAAA,EAAA,WAAA,EAAA,wBAe/C,MAf+C,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,iCAgBtC,MAhBsC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,uBAiBhD,kBAjBgD,EAAA,sBAkBjD,SAlBiD,CAAA,CAAA,eAAA,EAAA;EAE/D,UAAA,EAmBM,kBAnBN,CAmByB,OAnBzB,EAmBkC,KAnBlC,EAmByC,SAnBzC,EAmBoD,kBAnBpD,CAAA;EAEC,gBAAA,EAkBW,QAlBX;CAKY,EAAA,OAAA,CAAA,EAeX,oCAfW,CAgBnB,OAhBmB,EAiBnB,KAjBmB,EAkBnB,SAlBmB,EAmBnB,kBAnBmB,EAoBnB,QApBmB,CAAA,CAAA,EAsBpB,OAtBoB,CAsBZ,uBAtBY,CAsBY,OAtBZ,EAsBqB,KAtBrB,EAsB4B,SAtB5B,EAsBuC,kBAtBvC,EAsB2D,QAtB3D,CAAA,CAAA"}

package/dist/index.js

@@ -6,31 +6,79 @@ import { createFragmentForTest, createFragmentForTest as createFragmentForTest$1
 //#region src/index.ts
 async function createDatabaseFragmentForTest(fragmentBuilder, options) {
 	const { databasePath = ":memory:", migrateToVersion, config, options: fragmentOptions, deps, services, additionalContext } = options ?? {};
-	const { dialect } = new SQLocalKysely(databasePath);
-	const kysely = new Kysely({ dialect });
-	const adapter = new KyselyAdapter({
-		db: kysely,
-		provider: "sqlite"
-	});
 	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 migrator = adapter.createMigrationEngine(schema, namespace);
-	await (migrateToVersion ? await migrator.prepareMigrationTo(migrateToVersion, { updateSettings: false }) : await migrator.prepareMigration({ updateSettings: false })).execute();
-	return {
-		...createFragmentForTest$1(fragmentBuilder, {
+	const createDatabase = async () => {
+		const { dialect } = new SQLocalKysely(databasePath);
+		const kysely$1 = new Kysely({ dialect });
+		const adapter$1 = new KyselyAdapter({
+			db: kysely$1,
+			provider: "sqlite"
+		});
+		const migrator = adapter$1.createMigrationEngine(schema, namespace);
+		await (migrateToVersion ? await migrator.prepareMigrationTo(migrateToVersion, { updateSettings: false }) : await migrator.prepareMigration({ updateSettings: false })).execute();
+		return {
+			kysely: kysely$1,
+			adapter: adapter$1
+		};
+	};
+	let { kysely, adapter } = await createDatabase();
+	let mergedOptions = {
+		...fragmentOptions,
+		databaseAdapter: adapter
+	};
+	let fragment = createFragmentForTest$1(fragmentBuilder, {
+		config,
+		options: mergedOptions,
+		deps,
+		services,
+		additionalContext
+	});
+	const resetDatabase = async () => {
+		await kysely.destroy();
+		const newDb = await createDatabase();
+		kysely = newDb.kysely;
+		adapter = newDb.adapter;
+		mergedOptions = {
+			...fragmentOptions,
+			databaseAdapter: adapter
+		};
+		fragment = createFragmentForTest$1(fragmentBuilder, {
 			config,
-			options: {
-				...fragmentOptions,
-				databaseAdapter: adapter
-			},
+			options: mergedOptions,
 			deps,
 			services,
 			additionalContext
-		}),
-		kysely,
-		adapter
+		});
+	};
+	return {
+		get services() {
+			return fragment.services;
+		},
+		get initRoutes() {
+			return fragment.initRoutes;
+		},
+		get handler() {
+			return fragment.handler;
+		},
+		get config() {
+			return fragment.config;
+		},
+		get deps() {
+			return fragment.deps;
+		},
+		get additionalContext() {
+			return fragment.additionalContext;
+		},
+		get kysely() {
+			return kysely;
+		},
+		get adapter() {
+			return adapter;
+		},
+		resetDatabase
 	};
 }
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["createFragmentForTest"],"sources":["../src/index.ts"],"sourcesContent":["import { Kysely } from \"kysely\";\nimport { SQLocalKysely } from \"sqlocal/kysely\";\nimport { KyselyAdapter } from \"@fragno-dev/db/adapters/kysely\";\nimport type { AnySchema } from \"@fragno-dev/db/schema\";\nimport type { DatabaseAdapter } from \"@fragno-dev/db/adapters\";\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\";\n\n// Re-export utilities from @fragno-dev/core/test\nexport {\n  createFragmentForTest,\n  type TestResponse,\n  type CreateFragmentForTestOptions,\n  type RouteHandlerInputOptions,\n  type FragmentForTest,\n  type InitRoutesOverrides,\n} from \"@fragno-dev/core/test\";\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> extends Omit<\n    CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>,\n    \"config\"\n  > {\n  databasePath?: string;\n  migrateToVersion?: number;\n  config?: TConfig;\n}\n\n/**\n * Extended fragment test instance with database adapter and Kysely instance\n */\nexport interface DatabaseFragmentForTest<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n> extends FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  kysely: Kysely<any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  adapter: DatabaseAdapter<any>;\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>(\n  fragmentBuilder: {\n    definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;\n    $requiredOptions: TOptions;\n  },\n  options?: CreateDatabaseFragmentForTestOptions<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TOptions\n  >,\n): Promise<DatabaseFragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions>> {\n  const {\n    databasePath = \":memory:\",\n    migrateToVersion,\n    config,\n    options: fragmentOptions,\n    deps,\n    services,\n    additionalContext,\n  } = options ?? {};\n\n  // Create SQLocalKysely instance\n  const { dialect } = new SQLocalKysely(databasePath);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const kysely = new Kysely<any>({\n    dialect,\n  });\n\n  // Create KyselyAdapter\n  const adapter = new KyselyAdapter({\n    db: kysely,\n    provider: \"sqlite\",\n  });\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  // Run migrations automatically\n  const migrator = adapter.createMigrationEngine(schema, namespace);\n  const preparedMigration = migrateToVersion\n    ? await migrator.prepareMigrationTo(migrateToVersion, {\n        updateSettings: false,\n      })\n    : await migrator.prepareMigration({\n        updateSettings: false,\n      });\n  await preparedMigration.execute();\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  const mergedOptions = {\n    ...fragmentOptions,\n    databaseAdapter: adapter,\n  } as unknown as TOptions;\n\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  const fragment = createFragmentForTest(fragmentBuilder, {\n    config: config as TConfig,\n    options: mergedOptions,\n    deps,\n    services,\n    additionalContext,\n  });\n\n  return {\n    ...fragment,\n    kysely,\n    adapter,\n  };\n}\n"],"mappings":";;;;;;AAyDA,eAAsB,8BAQpB,iBAIA,SAO2F;CAC3F,MAAM,EACJ,eAAe,YACf,kBACA,QACA,SAAS,iBACT,MACA,UACA,sBACE,WAAW,EAAE;CAGjB,MAAM,EAAE,YAAY,IAAI,cAAc,aAAa;CAEnD,MAAM,SAAS,IAAI,OAAY,EAC7B,SACD,CAAC;CAGF,MAAM,UAAU,IAAI,cAAc;EAChC,IAAI;EACJ,UAAU;EACX,CAAC;CAKF,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,WAAW,QAAQ,sBAAsB,QAAQ,UAAU;AAQjE,QAP0B,mBACtB,MAAM,SAAS,mBAAmB,kBAAkB,EAClD,gBAAgB,OACjB,CAAC,GACF,MAAM,SAAS,iBAAiB,EAC9B,gBAAgB,OACjB,CAAC,EACkB,SAAS;AAqBjC,QAAO;EACL,GATeA,wBAAsB,iBAAiB;GAC9C;GACR,SAVoB;IACpB,GAAG;IACH,iBAAiB;IAClB;GAQC;GACA;GACA;GACD,CAAC;EAIA;EACA;EACD"}
+{"version":3,"file":"index.js","names":["kysely","adapter","createFragmentForTest"],"sources":["../src/index.ts"],"sourcesContent":["import { Kysely } from \"kysely\";\nimport { SQLocalKysely } from \"sqlocal/kysely\";\nimport { KyselyAdapter } from \"@fragno-dev/db/adapters/kysely\";\nimport type { AnySchema } from \"@fragno-dev/db/schema\";\nimport type { DatabaseAdapter } from \"@fragno-dev/db/adapters\";\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\";\n\n// Re-export utilities from @fragno-dev/core/test\nexport {\n  createFragmentForTest,\n  type TestResponse,\n  type CreateFragmentForTestOptions,\n  type RouteHandlerInputOptions,\n  type FragmentForTest,\n  type InitRoutesOverrides,\n} from \"@fragno-dev/core/test\";\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> extends Omit<\n    CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>,\n    \"config\"\n  > {\n  databasePath?: string;\n  migrateToVersion?: number;\n  config?: TConfig;\n}\n\n/**\n * Extended fragment test instance with database adapter and Kysely instance\n */\nexport interface DatabaseFragmentForTest<\n  TConfig,\n  TDeps,\n  TServices,\n  TAdditionalContext extends Record<string, unknown>,\n  TOptions extends FragnoPublicConfig,\n> extends FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  kysely: Kysely<any>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  adapter: DatabaseAdapter<any>;\n  /**\n   * Resets the database by creating a fresh in-memory database instance and re-running migrations.\n   * After calling this, you should re-initialize any routes to ensure they use the new database instance.\n   */\n  resetDatabase: () => Promise<void>;\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>(\n  fragmentBuilder: {\n    definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;\n    $requiredOptions: TOptions;\n  },\n  options?: CreateDatabaseFragmentForTestOptions<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TOptions\n  >,\n): Promise<DatabaseFragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions>> {\n  const {\n    databasePath = \":memory:\",\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  // Helper to create a new database instance and run migrations\n  const createDatabase = async () => {\n    // Create SQLocalKysely instance\n    const { dialect } = new SQLocalKysely(databasePath);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const kysely = new Kysely<any>({\n      dialect,\n    });\n\n    // Create KyselyAdapter\n    const adapter = new KyselyAdapter({\n      db: kysely,\n      provider: \"sqlite\",\n    });\n\n    // Run migrations\n    const migrator = adapter.createMigrationEngine(schema, namespace);\n    const preparedMigration = migrateToVersion\n      ? await migrator.prepareMigrationTo(migrateToVersion, {\n          updateSettings: false,\n        })\n      : await migrator.prepareMigration({\n          updateSettings: false,\n        });\n    await preparedMigration.execute();\n\n    return { kysely, adapter };\n  };\n\n  // Create initial database\n  let { kysely, adapter } = await createDatabase();\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  // 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  let fragment = createFragmentForTest(fragmentBuilder, {\n    config: config as TConfig,\n    options: mergedOptions,\n    deps,\n    services,\n    additionalContext,\n  });\n\n  // Reset database function - creates a fresh in-memory database and re-runs migrations\n  const resetDatabase = async () => {\n    // Destroy the old Kysely instance\n    await kysely.destroy();\n\n    // Create a new database instance\n    const newDb = await createDatabase();\n    kysely = newDb.kysely;\n    adapter = newDb.adapter;\n\n    // Recreate the fragment with the new adapter\n    mergedOptions = {\n      ...fragmentOptions,\n      databaseAdapter: adapter,\n    } as unknown as TOptions;\n\n    fragment = createFragmentForTest(fragmentBuilder, {\n      config: config as TConfig,\n      options: mergedOptions,\n      deps,\n      services,\n      additionalContext,\n    });\n  };\n\n  return {\n    get services() {\n      return fragment.services;\n    },\n    get initRoutes() {\n      return fragment.initRoutes;\n    },\n    get handler() {\n      return fragment.handler;\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    get kysely() {\n      return kysely;\n    },\n    get adapter() {\n      return adapter;\n    },\n    resetDatabase,\n  };\n}\n"],"mappings":";;;;;;AA8DA,eAAsB,8BAQpB,iBAIA,SAO2F;CAC3F,MAAM,EACJ,eAAe,YACf,kBACA,QACA,SAAS,iBACT,MACA,UACA,sBACE,WAAW,EAAE;CAKjB,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,iBAAiB,YAAY;EAEjC,MAAM,EAAE,YAAY,IAAI,cAAc,aAAa;EAEnD,MAAMA,WAAS,IAAI,OAAY,EAC7B,SACD,CAAC;EAGF,MAAMC,YAAU,IAAI,cAAc;GAChC,IAAID;GACJ,UAAU;GACX,CAAC;EAGF,MAAM,WAAWC,UAAQ,sBAAsB,QAAQ,UAAU;AAQjE,SAP0B,mBACtB,MAAM,SAAS,mBAAmB,kBAAkB,EAClD,gBAAgB,OACjB,CAAC,GACF,MAAM,SAAS,iBAAiB,EAC9B,gBAAgB,OACjB,CAAC,EACkB,SAAS;AAEjC,SAAO;GAAE;GAAQ;GAAS;;CAI5B,IAAI,EAAE,QAAQ,YAAY,MAAM,gBAAgB;CAKhD,IAAI,gBAAgB;EAClB,GAAG;EACH,iBAAiB;EAClB;CAKD,IAAI,WAAWC,wBAAsB,iBAAiB;EAC5C;EACR,SAAS;EACT;EACA;EACA;EACD,CAAC;CAGF,MAAM,gBAAgB,YAAY;AAEhC,QAAM,OAAO,SAAS;EAGtB,MAAM,QAAQ,MAAM,gBAAgB;AACpC,WAAS,MAAM;AACf,YAAU,MAAM;AAGhB,kBAAgB;GACd,GAAG;GACH,iBAAiB;GAClB;AAED,aAAWA,wBAAsB,iBAAiB;GACxC;GACR,SAAS;GACT;GACA;GACA;GACD,CAAC;;AAGJ,QAAO;EACL,IAAI,WAAW;AACb,UAAO,SAAS;;EAElB,IAAI,aAAa;AACf,UAAO,SAAS;;EAElB,IAAI,UAAU;AACZ,UAAO,SAAS;;EAElB,IAAI,SAAS;AACX,UAAO,SAAS;;EAElB,IAAI,OAAO;AACT,UAAO,SAAS;;EAElB,IAAI,oBAAoB;AACtB,UAAO,SAAS;;EAElB,IAAI,SAAS;AACX,UAAO;;EAET,IAAI,UAAU;AACZ,UAAO;;EAET;EACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/test",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "exports": {
     ".": {
@@ -16,7 +16,7 @@
     "kysely": "^0.28.7",
     "sqlocal": "^0.15.2",
     "@fragno-dev/core": "0.1.3",
-    "@fragno-dev/db": "0.1.5"
+    "@fragno-dev/db": "0.1.6"
   },
   "devDependencies": {
     "@types/node": "^22",

package/src/index.test.ts

@@ -3,6 +3,8 @@ import { column, idColumn, schema } from "@fragno-dev/db/schema";
 import { defineFragmentWithDatabase } from "@fragno-dev/db/fragment";
 import { createDatabaseFragmentForTest } from "./index";
 import { unlinkSync, existsSync } from "node:fs";
+import { defineRoute, defineRoutes } from "@fragno-dev/core";
+import { z } from "zod";
 
 // Test schema with multiple versions
 const testSchema = schema((s) => {
@@ -260,4 +262,143 @@ describe("createDatabaseFragmentForTest", () => {
       ).rejects.toThrow("Fragment 'non-db-fragment' does not have a database schema");
     });
   });
+
+  describe("route handling with defineRoutes", () => {
+    it("should handle route factory with multiple routes", async () => {
+      const fragment = await createDatabaseFragmentForTest(testFragmentDef);
+
+      type Config = {};
+      type Deps = {};
+      type Services = {
+        createUser: (data: { name: string; email: string; age?: number | null }) => Promise<{
+          name: string;
+          email: string;
+          age?: number | null;
+          id: string;
+        }>;
+        getUsers: () => Promise<{ name: string; email: string; age: number | null; id: string }[]>;
+      };
+
+      const routeFactory = defineRoutes<Config, Deps, Services>().create(({ services }) => [
+        defineRoute({
+          method: "POST",
+          path: "/users",
+          inputSchema: z.object({
+            name: z.string(),
+            email: z.string(),
+            age: z.number().nullable().optional(),
+          }),
+          outputSchema: z.object({
+            id: z.string(),
+            name: z.string(),
+            email: z.string(),
+            age: z.number().nullable().optional(),
+          }),
+          handler: async ({ input }, { json }) => {
+            if (input) {
+              const data = await input.valid();
+              const user = await services.createUser(data);
+              return json(user);
+            }
+            return json({ id: "", name: "", email: "", age: null });
+          },
+        }),
+        defineRoute({
+          method: "GET",
+          path: "/users",
+          outputSchema: z.array(
+            z.object({
+              id: z.string(),
+              name: z.string(),
+              email: z.string(),
+              age: z.number().nullable(),
+            }),
+          ),
+          handler: async (_ctx, { json }) => {
+            const users = await services.getUsers();
+            return json(users);
+          },
+        }),
+      ]);
+
+      const routes = [routeFactory] as const;
+      const [createUserRoute, getUsersRoute] = fragment.initRoutes(routes);
+
+      // Test creating a user
+      const createResponse = await fragment.handler(createUserRoute, {
+        body: { name: "John Doe", email: "john@example.com", age: 30 },
+      });
+
+      expect(createResponse.type).toBe("json");
+      if (createResponse.type === "json") {
+        expect(createResponse.data).toMatchObject({
+          id: expect.any(String),
+          name: "John Doe",
+          email: "john@example.com",
+          age: 30,
+        });
+      }
+
+      // Test getting users
+      const getUsersResponse = await fragment.handler(getUsersRoute);
+
+      expect(getUsersResponse.type).toBe("json");
+      if (getUsersResponse.type === "json") {
+        expect(getUsersResponse.data).toHaveLength(1);
+        expect(getUsersResponse.data[0]).toMatchObject({
+          id: expect.any(String),
+          name: "John Doe",
+          email: "john@example.com",
+          age: 30,
+        });
+      }
+    });
+  });
+
+  describe("resetDatabase", () => {
+    it("should clear all data and recreate a fresh database", async () => {
+      const fragment = await createDatabaseFragmentForTest(testFragmentDef);
+
+      // Create some users
+      await fragment.services.createUser({
+        name: "User 1",
+        email: "user1@example.com",
+        age: 25,
+      });
+      await fragment.services.createUser({
+        name: "User 2",
+        email: "user2@example.com",
+        age: 30,
+      });
+
+      // Verify users exist
+      let users = await fragment.services.getUsers();
+      expect(users).toHaveLength(2);
+
+      // Reset the database
+      await fragment.resetDatabase();
+
+      // Verify database is empty
+      users = await fragment.services.getUsers();
+      expect(users).toHaveLength(0);
+
+      // Verify we can still create new users after reset
+      const newUser = await fragment.services.createUser({
+        name: "User After Reset",
+        email: "after@example.com",
+        age: 35,
+      });
+
+      expect(newUser).toMatchObject({
+        id: expect.any(String),
+        name: "User After Reset",
+        email: "after@example.com",
+        age: 35,
+      });
+
+      users = await fragment.services.getUsers();
+      expect(users).toHaveLength(1);
+      expect(users[0]).toMatchObject(newUser);
+    });
+  });
 });

package/src/index.ts

@@ -53,6 +53,11 @@ export interface DatabaseFragmentForTest<
   kysely: Kysely<any>;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   adapter: DatabaseAdapter<any>;
+  /**
+   * Resets the database by creating a fresh in-memory database instance and re-running migrations.
+   * After calling this, you should re-initialize any routes to ensure they use the new database instance.
+   */
+  resetDatabase: () => Promise<void>;
 }
 
 export async function createDatabaseFragmentForTest<
@@ -85,19 +90,6 @@ export async function createDatabaseFragmentForTest<
     additionalContext,
   } = options ?? {};
 
-  // Create SQLocalKysely instance
-  const { dialect } = new SQLocalKysely(databasePath);
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const kysely = new Kysely<any>({
-    dialect,
-  });
-
-  // Create KyselyAdapter
-  const adapter = new KyselyAdapter({
-    db: kysely,
-    provider: "sqlite",
-  });
-
   // Get schema and namespace from fragment definition's additionalContext
   // Safe cast: DatabaseFragmentBuilder adds databaseSchema and databaseNamespace to additionalContext
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -112,21 +104,42 @@ export async function createDatabaseFragmentForTest<
     );
   }
 
-  // Run migrations automatically
-  const migrator = adapter.createMigrationEngine(schema, namespace);
-  const preparedMigration = migrateToVersion
-    ? await migrator.prepareMigrationTo(migrateToVersion, {
-        updateSettings: false,
-      })
-    : await migrator.prepareMigration({
-        updateSettings: false,
-      });
-  await preparedMigration.execute();
+  // Helper to create a new database instance and run migrations
+  const createDatabase = async () => {
+    // Create SQLocalKysely instance
+    const { dialect } = new SQLocalKysely(databasePath);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const kysely = new Kysely<any>({
+      dialect,
+    });
+
+    // Create KyselyAdapter
+    const adapter = new KyselyAdapter({
+      db: kysely,
+      provider: "sqlite",
+    });
+
+    // Run migrations
+    const migrator = adapter.createMigrationEngine(schema, namespace);
+    const preparedMigration = migrateToVersion
+      ? await migrator.prepareMigrationTo(migrateToVersion, {
+          updateSettings: false,
+        })
+      : await migrator.prepareMigration({
+          updateSettings: false,
+        });
+    await preparedMigration.execute();
+
+    return { kysely, adapter };
+  };
+
+  // Create initial database
+  let { kysely, adapter } = await createDatabase();
 
   // Create fragment with database adapter in options
   // Safe cast: We're merging the user's options with the databaseAdapter, which is required by TOptions
   // The user's TOptions is constrained to FragnoPublicConfig (or a subtype), which we extend with databaseAdapter
-  const mergedOptions = {
+  let mergedOptions = {
     ...fragmentOptions,
     databaseAdapter: adapter,
   } as unknown as TOptions;
@@ -134,7 +147,7 @@ export async function createDatabaseFragmentForTest<
   // Safe cast: If config is not provided, we pass undefined as TConfig.
   // The base createFragmentForTest expects config: TConfig, but if TConfig allows undefined
   // or if the fragment doesn't use config in its dependencies function, this will work correctly.
-  const fragment = createFragmentForTest(fragmentBuilder, {
+  let fragment = createFragmentForTest(fragmentBuilder, {
     config: config as TConfig,
     options: mergedOptions,
     deps,
@@ -142,9 +155,56 @@ export async function createDatabaseFragmentForTest<
     additionalContext,
   });
 
+  // Reset database function - creates a fresh in-memory database and re-runs migrations
+  const resetDatabase = async () => {
+    // Destroy the old Kysely instance
+    await kysely.destroy();
+
+    // Create a new database instance
+    const newDb = await createDatabase();
+    kysely = newDb.kysely;
+    adapter = newDb.adapter;
+
+    // Recreate the fragment with the new adapter
+    mergedOptions = {
+      ...fragmentOptions,
+      databaseAdapter: adapter,
+    } as unknown as TOptions;
+
+    fragment = createFragmentForTest(fragmentBuilder, {
+      config: config as TConfig,
+      options: mergedOptions,
+      deps,
+      services,
+      additionalContext,
+    });
+  };
+
   return {
-    ...fragment,
-    kysely,
-    adapter,
+    get services() {
+      return fragment.services;
+    },
+    get initRoutes() {
+      return fragment.initRoutes;
+    },
+    get handler() {
+      return fragment.handler;
+    },
+    get config() {
+      return fragment.config;
+    },
+    get deps() {
+      return fragment.deps;
+    },
+    get additionalContext() {
+      return fragment.additionalContext;
+    },
+    get kysely() {
+      return kysely;
+    },
+    get adapter() {
+      return adapter;
+    },
+    resetDatabase,
   };
 }