@fragno-dev/core 0.2.0 → 0.2.2

package/dist/api/fragment-definition-builder.d.ts.map

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

package/dist/api/fragment-definition-builder.js

@@ -13,7 +13,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 	#createRequestStorage;
 	#createThisContext;
 	#getExternalStorage;
-	#linkedFragments;
+	#internalRoutes;
 	constructor(name, state) {
 		this.#name = name;
 		if (state) {
@@ -25,7 +25,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			this.#createRequestStorage = state.createRequestStorage;
 			this.#createThisContext = state.createThisContext;
 			this.#getExternalStorage = state.getExternalStorage;
-			this.#linkedFragments = state.linkedFragments;
+			this.#internalRoutes = state.internalRoutes;
 		}
 	}
 	get name() {
@@ -64,7 +64,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: void 0,
 			createThisContext: void 0,
 			getExternalStorage: void 0,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -81,7 +81,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
 			getExternalStorage: this.#getExternalStorage,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -102,7 +102,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
 			getExternalStorage: this.#getExternalStorage,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -125,7 +125,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			serviceDependencies: this.#serviceDependencies,
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -147,7 +147,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			serviceDependencies: newServiceDependencies,
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -169,7 +169,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			serviceDependencies: newServiceDependencies,
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -205,7 +205,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: initializer,
 			createThisContext: void 0,
 			getExternalStorage: preservedExternalStorage,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -234,7 +234,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: void 0,
 			createThisContext: void 0,
 			getExternalStorage: getStorage,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
@@ -264,20 +264,13 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: fn,
 			getExternalStorage: this.#getExternalStorage,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		});
 	}
 	/**
-	* Register a linked fragment that will be automatically instantiated.
-	* Linked fragments share the same config/options as the parent and their services
-	* are exposed as private services. Routes are not exposed by default, but the
-	* instantiator may mount internal linked fragment routes under an internal prefix.
+	* Define internal routes that will be mounted under /_internal.
 	*/
-	withLinkedFragment(name, callback) {
-		const newLinkedFragments = {
-			...this.#linkedFragments,
-			[name]: callback
-		};
+	withInternalRoutes(routes) {
 		return new FragmentDefinitionBuilder(this.#name, {
 			dependencies: this.#dependencies,
 			baseServices: this.#baseServices,
@@ -287,7 +280,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
 			getExternalStorage: this.#getExternalStorage,
-			linkedFragments: newLinkedFragments
+			internalRoutes: routes
 		});
 	}
 	/**
@@ -311,7 +304,7 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder {
 			createRequestStorage: this.#createRequestStorage,
 			createThisContext: this.#createThisContext,
 			getExternalStorage: this.#getExternalStorage,
-			linkedFragments: this.#linkedFragments
+			internalRoutes: this.#internalRoutes
 		};
 	}
 };

package/dist/api/fragment-definition-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"fragment-definition-builder.js","names":["#name","#dependencies","#baseServices","#namedServices","#privateServices","#serviceDependencies","#createRequestStorage","#createThisContext","#getExternalStorage","#linkedFragments"],"sources":["../../src/api/fragment-definition-builder.ts"],"sourcesContent":["import type { RequestThisContext } from \"./api\";\nimport type { FragnoPublicConfig } from \"./shared-types\";\nimport type { RequestContextStorage } from \"./request-context-storage\";\nimport type {\n  FragnoInstantiatedFragment,\n  AnyFragnoInstantiatedFragment,\n} from \"./fragment-instantiator\";\n\n/**\n * Metadata for a service dependency\n */\ninterface ServiceMetadata {\n  /** Name of the service */\n  name: string;\n  /** Whether this service is required (false means optional) */\n  required: boolean;\n}\n\n/**\n * Callback that instantiates a linked fragment.\n * Receives the same context as the main fragment and returns an instantiated fragment.\n */\nexport type LinkedFragmentCallback<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TServiceDependencies,\n  TFragment extends AnyFragnoInstantiatedFragment = AnyFragnoInstantiatedFragment,\n> = (context: {\n  config: TConfig;\n  options: TOptions;\n  serviceDependencies?: TServiceDependencies;\n}) => TFragment;\n\n/**\n * Extract the services type from a FragnoInstantiatedFragment\n */\nexport type ExtractLinkedServices<T> = T extends (\n  ...args: never[]\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n) => FragnoInstantiatedFragment<any, any, infer TServices, any, any, any, any>\n  ? TServices\n  : never;\n\n/**\n * Context passed to the request context factory function.\n */\nexport type RequestContextFactoryContext<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TRequestStorage,\n> = {\n  config: TConfig;\n  options: TOptions;\n  deps: TDeps;\n  storage: RequestContextStorage<TRequestStorage>;\n};\n\n/**\n * Context object passed to service constructor functions\n */\nexport type ServiceContext<\n  TConfig,\n  TOptions,\n  TDeps,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n> = {\n  config: TConfig;\n  options: TOptions;\n  deps: TDeps;\n  serviceDeps: TServiceDependencies;\n  privateServices: TPrivateServices;\n  /**\n   * Helper to define services with proper `this` context typing.\n   * Use this to wrap your service methods when they need access to `this`.\n   */\n  defineService: <T>(svc: T & ThisType<TServiceThisContext>) => T;\n};\n\n/**\n * Service constructor function type\n */\nexport type ServiceConstructorFn<\n  TConfig,\n  TOptions,\n  TDeps,\n  TServiceDependencies,\n  TPrivateServices,\n  TService,\n  TServiceThisContext extends RequestThisContext,\n> = (\n  context: ServiceContext<\n    TConfig,\n    TOptions,\n    TDeps,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext\n  >,\n) => TService;\n\n/**\n * Fragment definition interface that supports both regular and database fragments.\n * This is the core definition that will be used for fragment instantiation.\n */\nexport interface FragmentDefinition<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage = {},\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n> {\n  name: string;\n\n  // Core callbacks - all take context objects with separate deps and serviceDeps\n  dependencies?: (context: { config: TConfig; options: TOptions }) => TDeps;\n\n  baseServices?: ServiceConstructorFn<\n    TConfig,\n    TOptions,\n    TDeps,\n    TServiceDependencies,\n    TPrivateServices,\n    TBaseServices,\n    TServiceThisContext\n  >;\n\n  // Named services stored as factory functions\n  namedServices?: {\n    [K in keyof TServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TServices[K],\n      TServiceThisContext\n    >;\n  };\n\n  // Private services - only accessible internally when defining other services\n  privateServices?: {\n    [K in keyof TPrivateServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices, // Private services can access other private services\n      TPrivateServices[K],\n      TServiceThisContext\n    >;\n  };\n\n  // Service dependency metadata\n  serviceDependencies?: {\n    [K in keyof TServiceDependencies]: ServiceMetadata;\n  };\n\n  /**\n   * Optional factory function to create the initial request storage data.\n   * This is called at the start of each request to initialize the storage.\n   * The returned object can be mutated throughout the request lifecycle.\n   *\n   * @example\n   * ```ts\n   * createRequestStorage: ({ config, options, deps }) => ({\n   *   counter: 0,\n   *   userId: deps.currentUserId\n   * })\n   * ```\n   */\n  createRequestStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => TRequestStorage;\n\n  /**\n   * Optional factory function to create the this contexts for services and handlers.\n   * Returns separate contexts: serviceContext (may be restricted) and handlerContext (full access).\n   * Both contexts should contain only methods or getters that read from storage.\n   *\n   * @example\n   * ```ts\n   * createThisContext: ({ storage }) => ({\n   *   serviceContext: {\n   *     getUnitOfWork: () => restrictedUOW  // Without execute methods\n   *   },\n   *   handlerContext: {\n   *     getUnitOfWork: () => fullUOW  // With execute methods\n   *   }\n   * })\n   * ```\n   */\n  createThisContext?: (\n    context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>,\n  ) => {\n    serviceContext: TServiceThisContext;\n    handlerContext: THandlerThisContext;\n  };\n\n  /**\n   * Optional factory function to get an external RequestContextStorage instance.\n   * When provided, this storage will be used instead of creating a new one.\n   * This allows multiple fragments to share the same storage (e.g., database fragments sharing adapter storage).\n   *\n   * @example\n   * ```ts\n   * getExternalStorage: ({ options }) => options.databaseAdapter.contextStorage\n   * ```\n   */\n  getExternalStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => RequestContextStorage<TRequestStorage>;\n\n  /**\n   * Optional factory for internal data attached to fragment.$internal.\n   */\n  internalDataFactory?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n    linkedFragments: TLinkedFragments;\n  }) => Record<string, unknown> | void;\n\n  /**\n   * Optional linked fragments that will be automatically instantiated with this fragment.\n   * Linked fragments are service-only and share the same config/options as the parent.\n   */\n  linkedFragments?: {\n    [K in keyof TLinkedFragments]: LinkedFragmentCallback<\n      TConfig,\n      TOptions,\n      TServiceDependencies,\n      TLinkedFragments[K]\n    >;\n  };\n\n  $serviceThisContext?: TServiceThisContext;\n  $handlerThisContext?: THandlerThisContext;\n  $requestStorage?: TRequestStorage;\n  $linkedFragments?: TLinkedFragments;\n}\n\n/**\n * Builder class for creating fragment definitions.\n * This provides a fluent API for defining fragments with type safety.\n */\nexport class FragmentDefinitionBuilder<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage = {},\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n> {\n  #name: string;\n  #dependencies?: (context: { config: TConfig; options: TOptions }) => TDeps;\n  #baseServices?: ServiceConstructorFn<\n    TConfig,\n    TOptions,\n    TDeps,\n    TServiceDependencies,\n    TPrivateServices,\n    TBaseServices,\n    TServiceThisContext\n  >;\n  #namedServices?: {\n    [K in keyof TServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TServices[K],\n      TServiceThisContext\n    >;\n  };\n  #privateServices?: {\n    [K in keyof TPrivateServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TPrivateServices[K],\n      TServiceThisContext\n    >;\n  };\n  #serviceDependencies?: {\n    [K in keyof TServiceDependencies]: ServiceMetadata;\n  };\n  #createRequestStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => TRequestStorage;\n  #createThisContext?: (\n    context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>,\n  ) => {\n    serviceContext: TServiceThisContext;\n    handlerContext: THandlerThisContext;\n  };\n  #getExternalStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => RequestContextStorage<TRequestStorage>;\n  #linkedFragments?: {\n    [K in keyof TLinkedFragments]: LinkedFragmentCallback<\n      TConfig,\n      TOptions,\n      TServiceDependencies,\n      TLinkedFragments[K]\n    >;\n  };\n\n  constructor(\n    name: string,\n    state?: {\n      dependencies?: (context: { config: TConfig; options: TOptions }) => TDeps;\n      baseServices?: ServiceConstructorFn<\n        TConfig,\n        TOptions,\n        TDeps,\n        TServiceDependencies,\n        TPrivateServices,\n        TBaseServices,\n        TServiceThisContext\n      >;\n      namedServices?: {\n        [K in keyof TServices]: ServiceConstructorFn<\n          TConfig,\n          TOptions,\n          TDeps,\n          TServiceDependencies,\n          TPrivateServices,\n          TServices[K],\n          TServiceThisContext\n        >;\n      };\n      privateServices?: {\n        [K in keyof TPrivateServices]: ServiceConstructorFn<\n          TConfig,\n          TOptions,\n          TDeps,\n          TServiceDependencies,\n          TPrivateServices,\n          TPrivateServices[K],\n          TServiceThisContext\n        >;\n      };\n      serviceDependencies?: {\n        [K in keyof TServiceDependencies]: ServiceMetadata;\n      };\n      createRequestStorage?: (context: {\n        config: TConfig;\n        options: TOptions;\n        deps: TDeps;\n      }) => TRequestStorage;\n      createThisContext?: (\n        context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>,\n      ) => {\n        serviceContext: TServiceThisContext;\n        handlerContext: THandlerThisContext;\n      };\n      getExternalStorage?: (context: {\n        config: TConfig;\n        options: TOptions;\n        deps: TDeps;\n      }) => RequestContextStorage<TRequestStorage>;\n      linkedFragments?: {\n        [K in keyof TLinkedFragments]: LinkedFragmentCallback<\n          TConfig,\n          TOptions,\n          TServiceDependencies,\n          TLinkedFragments[K]\n        >;\n      };\n    },\n  ) {\n    this.#name = name;\n    if (state) {\n      this.#dependencies = state.dependencies;\n      this.#baseServices = state.baseServices;\n      this.#namedServices = state.namedServices;\n      this.#privateServices = state.privateServices;\n      this.#serviceDependencies = state.serviceDependencies;\n      this.#createRequestStorage = state.createRequestStorage;\n      this.#createThisContext = state.createThisContext;\n      this.#getExternalStorage = state.getExternalStorage;\n      this.#linkedFragments = state.linkedFragments;\n    }\n  }\n\n  get name(): string {\n    return this.#name;\n  }\n\n  /**\n   * Define dependencies for this fragment.\n   * Dependencies are available to services and handlers.\n   *\n   * **IMPORTANT**: This method resets all services, storage, and context configurations.\n   * Always call `withDependencies` early in the builder chain, before defining services\n   * or request storage/context.\n   *\n   * @example\n   * ```typescript\n   * // ✅ GOOD: Dependencies set first\n   * defineFragment(\"my-fragment\")\n   *   .withDependencies(() => ({ apiKey: \"...\" }))\n   *   .withRequestStorage(({ deps }) => ({ userId: deps.apiKey }))\n   *   .providesService(\"myService\", ...)\n   *\n   * // ❌ BAD: Dependencies set late (erases storage setup)\n   * defineFragment(\"my-fragment\")\n   *   .withRequestStorage(() => ({ userId: \"...\" }))  // This gets erased!\n   *   .withDependencies(() => ({ apiKey: \"...\" }))\n   * ```\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: { config: TConfig; options: TOptions }) => TNewDeps,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TNewDeps,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    // Warn if we're discarding existing configuration\n    if (\n      this.#baseServices ||\n      this.#namedServices ||\n      this.#privateServices ||\n      this.#createRequestStorage ||\n      this.#createThisContext ||\n      this.#getExternalStorage\n    ) {\n      console.warn(\n        `[Fragno] Warning: withDependencies() on fragment \"${this.#name}\" is resetting previously configured services, request storage, or request context. ` +\n          `To avoid this, call withDependencies() earlier in the builder chain, before configuring services or storage.`,\n      );\n    }\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TNewDeps,\n      {},\n      {},\n      TServiceDependencies,\n      {},\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: fn,\n      baseServices: undefined,\n      namedServices: undefined,\n      privateServices: undefined,\n      serviceDependencies: this.#serviceDependencies,\n      // Reset storage/context functions since deps type changed - they must be reconfigured\n      createRequestStorage: undefined,\n      createThisContext: undefined,\n      getExternalStorage: undefined,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Define base (unnamed) services for this fragment.\n   * Base services are accessible directly on the fragment instance.\n   */\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TNewService,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: fn,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Provide a named service that other fragments or users can use.\n   * Named services are accessible as fragment.serviceName.method()\n   */\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newNamedServices = {\n      ...this.#namedServices,\n      [serviceName]: fn,\n    } as {\n      [K in keyof (TServices & { [K in TServiceName]: TService })]: ServiceConstructorFn<\n        TConfig,\n        TOptions,\n        TDeps,\n        TServiceDependencies,\n        TPrivateServices,\n        (TServices & { [K in TServiceName]: TService })[K],\n        TServiceThisContext\n      >;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices & { [K in TServiceName]: TService },\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: newNamedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Provide a private service that is only accessible to the fragment author.\n   * Private services are NOT exposed on the fragment instance, but can be used\n   * when defining other services (baseServices, namedServices, and other privateServices).\n   * Private services are instantiated in order, so earlier private services are available\n   * to later ones.\n   */\n  providesPrivateService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & { [K in TServiceName]: TService },\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newPrivateServices = {\n      ...this.#privateServices,\n      [serviceName]: fn,\n    } as {\n      [K in keyof (TPrivateServices & { [K in TServiceName]: TService })]: ServiceConstructorFn<\n        TConfig,\n        TOptions,\n        TDeps,\n        TServiceDependencies,\n        TPrivateServices & { [K in TServiceName]: TService },\n        (TPrivateServices & { [K in TServiceName]: TService })[K],\n        TServiceThisContext\n      >;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices & { [K in TServiceName]: TService },\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: newPrivateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newServiceDependencies = {\n      ...this.#serviceDependencies,\n      [serviceName]: { name: serviceName, required: true },\n    } as {\n      [K in keyof (TServiceDependencies & { [K in TServiceName]: TService })]: ServiceMetadata;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies & { [K in TServiceName]: TService },\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: newServiceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newServiceDependencies = {\n      ...this.#serviceDependencies,\n      [serviceName]: { name: serviceName, required: false },\n    } as {\n      [K in keyof (TServiceDependencies & {\n        [K in TServiceName]: TService | undefined;\n      })]: ServiceMetadata;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies & { [K in TServiceName]: TService | undefined },\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: newServiceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Define the type and initial data stored in AsyncLocalStorage for per-request isolation.\n   * This should be called before withThisContext if you need to store request-specific data.\n   *\n   * @param initializer Function that returns the initial storage data for each request\n   *\n   * @example\n   * ```typescript\n   * .withRequestStorage(({ config, options, deps }) => ({\n   *   counter: 0,\n   *   userId: deps.currentUserId\n   * }))\n   * .withThisContext(({ storage }) => ({\n   *   serviceContext: {\n   *     get counter() { return storage.getStore()!.counter; }\n   *   },\n   *   handlerContext: {\n   *     get counter() { return storage.getStore()!.counter; }\n   *   }\n   * }))\n   * ```\n   */\n  withRequestStorage<TNewRequestStorage>(\n    initializer: (context: {\n      config: TConfig;\n      options: TOptions;\n      deps: TDeps;\n    }) => TNewRequestStorage,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TNewRequestStorage,\n    TLinkedFragments\n  > {\n    // getExternalStorage can coexist with createRequestStorage (they work together)\n    // Cast is safe when storage type changes: the external storage container adapts to hold the new type\n    const preservedExternalStorage = this.#getExternalStorage\n      ? (this.#getExternalStorage as unknown as (context: {\n          config: TConfig;\n          options: TOptions;\n          deps: TDeps;\n        }) => RequestContextStorage<TNewRequestStorage>)\n      : undefined;\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TNewRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: initializer,\n      // Reset context function since storage type changed - it must be reconfigured\n      createThisContext: undefined,\n      getExternalStorage: preservedExternalStorage,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Use an externally-provided RequestContextStorage instance.\n   * This allows multiple fragments to share the same storage instance.\n   * Useful when fragments need to coordinate (e.g., database fragments sharing adapter storage).\n   * Note: You must still call withRequestStorage to provide the initial storage data.\n   *\n   * @example\n   * ```typescript\n   * .withExternalRequestStorage(({ options }) =>\n   *   options.databaseAdapter.contextStorage\n   * )\n   * .withRequestStorage(({ options }) => ({\n   *   uow: options.databaseAdapter.db.createUnitOfWork()\n   * }))\n   * ```\n   */\n  withExternalRequestStorage<TNewStorage>(\n    getStorage: (context: {\n      config: TConfig;\n      options: TOptions;\n      deps: TDeps;\n    }) => RequestContextStorage<TNewStorage>,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TNewStorage,\n    TLinkedFragments\n  > {\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TNewStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      // Reset storage/context functions since storage type changed - they must be reconfigured\n      createRequestStorage: undefined,\n      createThisContext: undefined,\n      getExternalStorage: getStorage,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Set the this contexts for services and handlers in this fragment.\n   * Both contexts should contain only methods or getters that read from storage.\n   * This ensures proper per-request isolation via AsyncLocalStorage.\n   *\n   * @example\n   * ```ts\n   * .withThisContext(({ storage }) => ({\n   *   serviceContext: {\n   *     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n   *   },\n   *   handlerContext: {\n   *     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n   *   }\n   * }))\n   * ```\n   */\n  withThisContext<\n    TNewServiceThisContext extends RequestThisContext,\n    TNewHandlerThisContext extends RequestThisContext,\n  >(\n    fn: (context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>) => {\n      serviceContext: TNewServiceThisContext;\n      handlerContext: TNewHandlerThisContext;\n    },\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TNewServiceThisContext,\n    TNewHandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  > {\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewServiceThisContext,\n      TNewHandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: fn,\n      getExternalStorage: this.#getExternalStorage,\n      linkedFragments: this.#linkedFragments,\n    });\n  }\n\n  /**\n   * Register a linked fragment that will be automatically instantiated.\n   * Linked fragments share the same config/options as the parent and their services\n   * are exposed as private services. Routes are not exposed by default, but the\n   * instantiator may mount internal linked fragment routes under an internal prefix.\n   */\n  withLinkedFragment<const TName extends string, TFragment extends AnyFragnoInstantiatedFragment>(\n    name: TName,\n    callback: LinkedFragmentCallback<TConfig, TOptions, TServiceDependencies, TFragment>,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & ExtractLinkedServices<() => TFragment>,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments & { [K in TName]: TFragment }\n  > {\n    const newLinkedFragments = {\n      ...this.#linkedFragments,\n      [name]: callback,\n    };\n\n    // Cast is safe: We're declaring that the returned builder has TPrivateServices & ExtractLinkedServices<TFragment>,\n    // even though the runtime privateServices hasn't changed yet. The linked fragment services will be\n    // merged into privateServices at instantiation time by the instantiator.\n    return new FragmentDefinitionBuilder(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      linkedFragments: newLinkedFragments,\n    }) as FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices & ExtractLinkedServices<() => TFragment>,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments & { [K in TName]: TFragment }\n    >;\n  }\n\n  /**\n   * Extend this builder with a transformation function.\n   * This enables fluent API extensions like `.extend(withDatabase(schema))`.\n   */\n  extend<const TNewBuilder>(transformer: (builder: this) => TNewBuilder): TNewBuilder {\n    return transformer(this);\n  }\n\n  /**\n   * Build the final fragment definition\n   */\n  build(): 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    return {\n      name: this.#name,\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      linkedFragments: this.#linkedFragments,\n    };\n  }\n}\n\n/**\n * Create a new fragment definition builder\n */\nexport function defineFragment<\n  TConfig = {},\n  TOptions extends FragnoPublicConfig = FragnoPublicConfig,\n  TServiceThisContext extends RequestThisContext = RequestThisContext,\n  THandlerThisContext extends RequestThisContext = RequestThisContext,\n  TRequestStorage = {},\n>(\n  name: string,\n): FragmentDefinitionBuilder<\n  TConfig,\n  TOptions,\n  {},\n  {},\n  {},\n  {},\n  {},\n  TServiceThisContext,\n  THandlerThisContext,\n  TRequestStorage,\n  {}\n> {\n  return new FragmentDefinitionBuilder(name);\n}\n"],"mappings":"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"}
+{"version":3,"file":"fragment-definition-builder.js","names":["#name","#dependencies","#baseServices","#namedServices","#privateServices","#serviceDependencies","#createRequestStorage","#createThisContext","#getExternalStorage","#internalRoutes"],"sources":["../../src/api/fragment-definition-builder.ts"],"sourcesContent":["import type { RequestThisContext } from \"./api\";\nimport type { BoundServices } from \"./bind-services\";\nimport type { RequestContextStorage } from \"./request-context-storage\";\nimport type { AnyRouteOrFactory } from \"./route\";\nimport type { FragnoPublicConfig } from \"./shared-types\";\n\n/**\n * Metadata for a service dependency\n */\ninterface ServiceMetadata {\n  /** Name of the service */\n  name: string;\n  /** Whether this service is required (false means optional) */\n  required: boolean;\n}\n\n/**\n * Context passed to the request context factory function.\n */\nexport type RequestContextFactoryContext<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TRequestStorage,\n> = {\n  config: TConfig;\n  options: TOptions;\n  deps: TDeps;\n  storage: RequestContextStorage<TRequestStorage>;\n};\n\n/**\n * Context object passed to service constructor functions\n */\nexport type ServiceContext<\n  TConfig,\n  TOptions,\n  TDeps,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n> = {\n  config: TConfig;\n  options: TOptions;\n  deps: TDeps;\n  serviceDeps: TServiceDependencies;\n  privateServices: TPrivateServices;\n  /**\n   * Helper to define services with proper `this` context typing.\n   * Use this to wrap your service methods when they need access to `this`.\n   */\n  defineService: <T>(svc: T & ThisType<TServiceThisContext>) => T;\n};\n\n/**\n * Service constructor function type\n */\nexport type ServiceConstructorFn<\n  TConfig,\n  TOptions,\n  TDeps,\n  TServiceDependencies,\n  TPrivateServices,\n  TService,\n  TServiceThisContext extends RequestThisContext,\n> = (\n  context: ServiceContext<\n    TConfig,\n    TOptions,\n    TDeps,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext\n  >,\n) => TService;\n\n/**\n * Fragment definition interface that supports both regular and database fragments.\n * This is the core definition that will be used for fragment instantiation.\n */\nexport interface FragmentDefinition<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage = {},\n  TInternalRoutes extends readonly AnyRouteOrFactory[] = readonly [],\n> {\n  name: string;\n\n  // Core callbacks - all take context objects with separate deps and serviceDeps\n  dependencies?: (context: { config: TConfig; options: TOptions }) => TDeps;\n\n  baseServices?: ServiceConstructorFn<\n    TConfig,\n    TOptions,\n    TDeps,\n    TServiceDependencies,\n    TPrivateServices,\n    TBaseServices,\n    TServiceThisContext\n  >;\n\n  // Named services stored as factory functions\n  namedServices?: {\n    [K in keyof TServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TServices[K],\n      TServiceThisContext\n    >;\n  };\n\n  // Private services - only accessible internally when defining other services\n  privateServices?: {\n    [K in keyof TPrivateServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices, // Private services can access other private services\n      TPrivateServices[K],\n      TServiceThisContext\n    >;\n  };\n\n  // Service dependency metadata\n  serviceDependencies?: {\n    [K in keyof TServiceDependencies]: ServiceMetadata;\n  };\n\n  /**\n   * Optional factory function to create the initial request storage data.\n   * This is called at the start of each request to initialize the storage.\n   * The returned object can be mutated throughout the request lifecycle.\n   *\n   * @example\n   * ```ts\n   * createRequestStorage: ({ config, options, deps }) => ({\n   *   counter: 0,\n   *   userId: deps.currentUserId\n   * })\n   * ```\n   */\n  createRequestStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => TRequestStorage;\n\n  /**\n   * Optional factory function to create the this contexts for services and handlers.\n   * Returns separate contexts: serviceContext (may be restricted) and handlerContext (full access).\n   * Both contexts should contain only methods or getters that read from storage.\n   *\n   * @example\n   * ```ts\n   * createThisContext: ({ storage }) => ({\n   *   serviceContext: {\n   *     getUnitOfWork: () => restrictedUOW  // Without execute methods\n   *   },\n   *   handlerContext: {\n   *     getUnitOfWork: () => fullUOW  // With execute methods\n   *   }\n   * })\n   * ```\n   */\n  createThisContext?: (\n    context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>,\n  ) => {\n    serviceContext: TServiceThisContext;\n    handlerContext: THandlerThisContext;\n  };\n\n  /**\n   * Optional factory function to get an external RequestContextStorage instance.\n   * When provided, this storage will be used instead of creating a new one.\n   * This allows multiple fragments to share the same storage (e.g., database fragments sharing adapter storage).\n   *\n   * @example\n   * ```ts\n   * getExternalStorage: ({ options }) => options.databaseAdapter.contextStorage\n   * ```\n   */\n  getExternalStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => RequestContextStorage<TRequestStorage>;\n\n  /**\n   * Optional factory for internal data attached to fragment.$internal.\n   */\n  internalDataFactory?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n    services: BoundServices<TBaseServices & TServices>;\n    serviceDeps: TServiceDependencies;\n  }) => Record<string, unknown> | void;\n\n  internalRoutes?: TInternalRoutes;\n\n  $serviceThisContext?: TServiceThisContext;\n  $handlerThisContext?: THandlerThisContext;\n  $requestStorage?: TRequestStorage;\n  $internalRoutes?: TInternalRoutes;\n}\n\n/**\n * Builder class for creating fragment definitions.\n * This provides a fluent API for defining fragments with type safety.\n */\nexport class FragmentDefinitionBuilder<\n  TConfig,\n  TOptions extends FragnoPublicConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage = {},\n  TInternalRoutes extends readonly AnyRouteOrFactory[] = readonly [],\n> {\n  #name: string;\n  #dependencies?: (context: { config: TConfig; options: TOptions }) => TDeps;\n  #baseServices?: ServiceConstructorFn<\n    TConfig,\n    TOptions,\n    TDeps,\n    TServiceDependencies,\n    TPrivateServices,\n    TBaseServices,\n    TServiceThisContext\n  >;\n  #namedServices?: {\n    [K in keyof TServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TServices[K],\n      TServiceThisContext\n    >;\n  };\n  #privateServices?: {\n    [K in keyof TPrivateServices]: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TPrivateServices[K],\n      TServiceThisContext\n    >;\n  };\n  #serviceDependencies?: {\n    [K in keyof TServiceDependencies]: ServiceMetadata;\n  };\n  #createRequestStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => TRequestStorage;\n  #createThisContext?: (\n    context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>,\n  ) => {\n    serviceContext: TServiceThisContext;\n    handlerContext: THandlerThisContext;\n  };\n  #getExternalStorage?: (context: {\n    config: TConfig;\n    options: TOptions;\n    deps: TDeps;\n  }) => RequestContextStorage<TRequestStorage>;\n  #internalRoutes?: TInternalRoutes;\n\n  constructor(\n    name: string,\n    state?: {\n      dependencies?: (context: { config: TConfig; options: TOptions }) => TDeps;\n      baseServices?: ServiceConstructorFn<\n        TConfig,\n        TOptions,\n        TDeps,\n        TServiceDependencies,\n        TPrivateServices,\n        TBaseServices,\n        TServiceThisContext\n      >;\n      namedServices?: {\n        [K in keyof TServices]: ServiceConstructorFn<\n          TConfig,\n          TOptions,\n          TDeps,\n          TServiceDependencies,\n          TPrivateServices,\n          TServices[K],\n          TServiceThisContext\n        >;\n      };\n      privateServices?: {\n        [K in keyof TPrivateServices]: ServiceConstructorFn<\n          TConfig,\n          TOptions,\n          TDeps,\n          TServiceDependencies,\n          TPrivateServices,\n          TPrivateServices[K],\n          TServiceThisContext\n        >;\n      };\n      serviceDependencies?: {\n        [K in keyof TServiceDependencies]: ServiceMetadata;\n      };\n      createRequestStorage?: (context: {\n        config: TConfig;\n        options: TOptions;\n        deps: TDeps;\n      }) => TRequestStorage;\n      createThisContext?: (\n        context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>,\n      ) => {\n        serviceContext: TServiceThisContext;\n        handlerContext: THandlerThisContext;\n      };\n      getExternalStorage?: (context: {\n        config: TConfig;\n        options: TOptions;\n        deps: TDeps;\n      }) => RequestContextStorage<TRequestStorage>;\n      internalRoutes?: TInternalRoutes;\n    },\n  ) {\n    this.#name = name;\n    if (state) {\n      this.#dependencies = state.dependencies;\n      this.#baseServices = state.baseServices;\n      this.#namedServices = state.namedServices;\n      this.#privateServices = state.privateServices;\n      this.#serviceDependencies = state.serviceDependencies;\n      this.#createRequestStorage = state.createRequestStorage;\n      this.#createThisContext = state.createThisContext;\n      this.#getExternalStorage = state.getExternalStorage;\n      this.#internalRoutes = state.internalRoutes;\n    }\n  }\n\n  get name(): string {\n    return this.#name;\n  }\n\n  /**\n   * Define dependencies for this fragment.\n   * Dependencies are available to services and handlers.\n   *\n   * **IMPORTANT**: This method resets all services, storage, and context configurations.\n   * Always call `withDependencies` early in the builder chain, before defining services\n   * or request storage/context.\n   *\n   * @example\n   * ```typescript\n   * // ✅ GOOD: Dependencies set first\n   * defineFragment(\"my-fragment\")\n   *   .withDependencies(() => ({ apiKey: \"...\" }))\n   *   .withRequestStorage(({ deps }) => ({ userId: deps.apiKey }))\n   *   .providesService(\"myService\", ...)\n   *\n   * // ❌ BAD: Dependencies set late (erases storage setup)\n   * defineFragment(\"my-fragment\")\n   *   .withRequestStorage(() => ({ userId: \"...\" }))  // This gets erased!\n   *   .withDependencies(() => ({ apiKey: \"...\" }))\n   * ```\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: { config: TConfig; options: TOptions }) => TNewDeps,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TNewDeps,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    // Warn if we're discarding existing configuration\n    if (\n      this.#baseServices ||\n      this.#namedServices ||\n      this.#privateServices ||\n      this.#createRequestStorage ||\n      this.#createThisContext ||\n      this.#getExternalStorage\n    ) {\n      console.warn(\n        `[Fragno] Warning: withDependencies() on fragment \"${this.#name}\" is resetting previously configured services, request storage, or request context. ` +\n          `To avoid this, call withDependencies() earlier in the builder chain, before configuring services or storage.`,\n      );\n    }\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TNewDeps,\n      {},\n      {},\n      TServiceDependencies,\n      {},\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: fn,\n      baseServices: undefined,\n      namedServices: undefined,\n      privateServices: undefined,\n      serviceDependencies: this.#serviceDependencies,\n      // Reset storage/context functions since deps type changed - they must be reconfigured\n      createRequestStorage: undefined,\n      createThisContext: undefined,\n      getExternalStorage: undefined,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Define base (unnamed) services for this fragment.\n   * Base services are accessible directly on the fragment instance.\n   */\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TNewService,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: fn,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Provide a named service that other fragments or users can use.\n   * Named services are accessible as fragment.serviceName.method()\n   */\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newNamedServices = {\n      ...this.#namedServices,\n      [serviceName]: fn,\n    } as {\n      [K in keyof (TServices & { [K in TServiceName]: TService })]: ServiceConstructorFn<\n        TConfig,\n        TOptions,\n        TDeps,\n        TServiceDependencies,\n        TPrivateServices,\n        (TServices & { [K in TServiceName]: TService })[K],\n        TServiceThisContext\n      >;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices & { [K in TServiceName]: TService },\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: newNamedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Provide a private service that is only accessible to the fragment author.\n   * Private services are NOT exposed on the fragment instance, but can be used\n   * when defining other services (baseServices, namedServices, and other privateServices).\n   * Private services are instantiated in order, so earlier private services are available\n   * to later ones.\n   */\n  providesPrivateService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      TOptions,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & { [K in TServiceName]: TService },\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newPrivateServices = {\n      ...this.#privateServices,\n      [serviceName]: fn,\n    } as {\n      [K in keyof (TPrivateServices & { [K in TServiceName]: TService })]: ServiceConstructorFn<\n        TConfig,\n        TOptions,\n        TDeps,\n        TServiceDependencies,\n        TPrivateServices & { [K in TServiceName]: TService },\n        (TPrivateServices & { [K in TServiceName]: TService })[K],\n        TServiceThisContext\n      >;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices & { [K in TServiceName]: TService },\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: newPrivateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newServiceDependencies = {\n      ...this.#serviceDependencies,\n      [serviceName]: { name: serviceName, required: true },\n    } as {\n      [K in keyof (TServiceDependencies & { [K in TServiceName]: TService })]: ServiceMetadata;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies & { [K in TServiceName]: TService },\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: newServiceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    // Type assertion needed because TypeScript can't verify object spread with mapped types\n    const newServiceDependencies = {\n      ...this.#serviceDependencies,\n      [serviceName]: { name: serviceName, required: false },\n    } as {\n      [K in keyof (TServiceDependencies & {\n        [K in TServiceName]: TService | undefined;\n      })]: ServiceMetadata;\n    };\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies & { [K in TServiceName]: TService | undefined },\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: newServiceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Define the type and initial data stored in AsyncLocalStorage for per-request isolation.\n   * This should be called before withThisContext if you need to store request-specific data.\n   *\n   * @param initializer Function that returns the initial storage data for each request\n   *\n   * @example\n   * ```typescript\n   * .withRequestStorage(({ config, options, deps }) => ({\n   *   counter: 0,\n   *   userId: deps.currentUserId\n   * }))\n   * .withThisContext(({ storage }) => ({\n   *   serviceContext: {\n   *     get counter() { return storage.getStore()!.counter; }\n   *   },\n   *   handlerContext: {\n   *     get counter() { return storage.getStore()!.counter; }\n   *   }\n   * }))\n   * ```\n   */\n  withRequestStorage<TNewRequestStorage>(\n    initializer: (context: {\n      config: TConfig;\n      options: TOptions;\n      deps: TDeps;\n    }) => TNewRequestStorage,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TNewRequestStorage,\n    TInternalRoutes\n  > {\n    // getExternalStorage can coexist with createRequestStorage (they work together)\n    // Cast is safe when storage type changes: the external storage container adapts to hold the new type\n    const preservedExternalStorage = this.#getExternalStorage\n      ? (this.#getExternalStorage as unknown as (context: {\n          config: TConfig;\n          options: TOptions;\n          deps: TDeps;\n        }) => RequestContextStorage<TNewRequestStorage>)\n      : undefined;\n\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TNewRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: initializer,\n      // Reset context function since storage type changed - it must be reconfigured\n      createThisContext: undefined,\n      getExternalStorage: preservedExternalStorage,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Use an externally-provided RequestContextStorage instance.\n   * This allows multiple fragments to share the same storage instance.\n   * Useful when fragments need to coordinate (e.g., database fragments sharing adapter storage).\n   * Note: You must still call withRequestStorage to provide the initial storage data.\n   *\n   * @example\n   * ```typescript\n   * .withExternalRequestStorage(({ options }) =>\n   *   options.databaseAdapter.contextStorage\n   * )\n   * .withRequestStorage(({ options }) => ({\n   *   uow: options.databaseAdapter.db.createUnitOfWork()\n   * }))\n   * ```\n   */\n  withExternalRequestStorage<TNewStorage>(\n    getStorage: (context: {\n      config: TConfig;\n      options: TOptions;\n      deps: TDeps;\n    }) => RequestContextStorage<TNewStorage>,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TNewStorage,\n    TInternalRoutes\n  > {\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TNewStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      // Reset storage/context functions since storage type changed - they must be reconfigured\n      createRequestStorage: undefined,\n      createThisContext: undefined,\n      getExternalStorage: getStorage,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Set the this contexts for services and handlers in this fragment.\n   * Both contexts should contain only methods or getters that read from storage.\n   * This ensures proper per-request isolation via AsyncLocalStorage.\n   *\n   * @example\n   * ```ts\n   * .withThisContext(({ storage }) => ({\n   *   serviceContext: {\n   *     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n   *   },\n   *   handlerContext: {\n   *     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n   *   }\n   * }))\n   * ```\n   */\n  withThisContext<\n    TNewServiceThisContext extends RequestThisContext,\n    TNewHandlerThisContext extends RequestThisContext,\n  >(\n    fn: (context: RequestContextFactoryContext<TConfig, TOptions, TDeps, TRequestStorage>) => {\n      serviceContext: TNewServiceThisContext;\n      handlerContext: TNewHandlerThisContext;\n    },\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TNewServiceThisContext,\n    TNewHandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    return new FragmentDefinitionBuilder<\n      TConfig,\n      TOptions,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewServiceThisContext,\n      TNewHandlerThisContext,\n      TRequestStorage,\n      TInternalRoutes\n    >(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: fn,\n      getExternalStorage: this.#getExternalStorage,\n      internalRoutes: this.#internalRoutes,\n    });\n  }\n\n  /**\n   * Define internal routes that will be mounted under /_internal.\n   */\n  withInternalRoutes<const TNewInternalRoutes extends readonly AnyRouteOrFactory[]>(\n    routes: TNewInternalRoutes,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TNewInternalRoutes\n  > {\n    return new FragmentDefinitionBuilder(this.#name, {\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      internalRoutes: routes,\n    });\n  }\n\n  /**\n   * Extend this builder with a transformation function.\n   * This enables fluent API extensions like `.extend(withDatabase(schema))`.\n   */\n  extend<const TNewBuilder>(transformer: (builder: this) => TNewBuilder): TNewBuilder {\n    return transformer(this);\n  }\n\n  /**\n   * Build the final fragment definition\n   */\n  build(): FragmentDefinition<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TInternalRoutes\n  > {\n    return {\n      name: this.#name,\n      dependencies: this.#dependencies,\n      baseServices: this.#baseServices,\n      namedServices: this.#namedServices,\n      privateServices: this.#privateServices,\n      serviceDependencies: this.#serviceDependencies,\n      createRequestStorage: this.#createRequestStorage,\n      createThisContext: this.#createThisContext,\n      getExternalStorage: this.#getExternalStorage,\n      internalRoutes: this.#internalRoutes,\n    };\n  }\n}\n\n/**\n * Create a new fragment definition builder\n */\nexport function defineFragment<\n  TConfig = {},\n  TOptions extends FragnoPublicConfig = FragnoPublicConfig,\n  TServiceThisContext extends RequestThisContext = RequestThisContext,\n  THandlerThisContext extends RequestThisContext = RequestThisContext,\n  TRequestStorage = {},\n>(\n  name: string,\n): FragmentDefinitionBuilder<\n  TConfig,\n  TOptions,\n  {},\n  {},\n  {},\n  {},\n  {},\n  TServiceThisContext,\n  THandlerThisContext,\n  TRequestStorage,\n  []\n> {\n  return new FragmentDefinitionBuilder(name);\n}\n"],"mappings":"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"}

package/dist/api/fragment-instantiator.d.ts

@@ -1,27 +1,36 @@
 import { InferOrUnknown } from "../util/types-util.js";
-import { RouteHandlerInputOptions } from "./route-handler-input-options.js";
-import { FragnoPublicConfig } from "./shared-types.js";
-import { FragnoRouteConfig, HTTPMethod, RequestThisContext } from "./api.js";
-import { RequestContextStorage } from "./request-context-storage.js";
 import { BoundServices } from "./bind-services.js";
+import { RequestContextStorage } from "./request-context-storage.js";
 import { AnyFragnoRouteConfig, AnyRouteOrFactory, FlattenRouteFactories } from "./route.js";
-import { ExtractRouteByPath, ExtractRoutePath } from "../client/client.js";
-import { FragnoMiddlewareCallback } from "./request-middleware.js";
-import { FragnoResponse } from "./fragno-response.js";
-import { instantiatedFragmentFakeSymbol } from "../internal/symbols.js";
+import { FragnoPublicConfig } from "./shared-types.js";
 import { FragmentDefinition } from "./fragment-definition-builder.js";
+import { instantiatedFragmentFakeSymbol } from "../internal/symbols.js";
+import { FragnoResponse } from "./fragno-response.js";
+import { FragnoMiddlewareCallback } from "./request-middleware.js";
+import { RouteHandlerInputOptions } from "./route-handler-input-options.js";
+import { ExtractRouteByPath, ExtractRoutePath } from "../client/client.js";
+import { FragnoRouteConfig, HTTPMethod, RequestThisContext } from "./api.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/api/fragment-instantiator.d.ts
+type CallRoutePath<TRoutes extends readonly AnyFragnoRouteConfig[], TMethod$1 extends HTTPMethod> = [ExtractRoutePath<TRoutes, TMethod$1>] extends [never] ? string : ExtractRoutePath<TRoutes, TMethod$1>;
+type CallRouteMatch<TRoutes extends readonly AnyFragnoRouteConfig[], TMethod$1 extends HTTPMethod, TPath$1 extends string> = [ExtractRouteByPath<TRoutes, TPath$1, TMethod$1>] extends [never] ? AnyFragnoRouteConfig : ExtractRouteByPath<TRoutes, TPath$1, TMethod$1>;
+type FragnoRequestLifecycleContext = {
+  waitUntil?: (promise: Promise<unknown>) => void;
+};
 type InternalRoutePrefix = "/_internal";
 type JoinInternalRoutePath<TPath$1 extends string> = TPath$1 extends "" | "/" ? InternalRoutePrefix : TPath$1 extends `/${string}` ? `${InternalRoutePrefix}${TPath$1}` : `${InternalRoutePrefix}/${TPath$1}`;
 type PrefixInternalRoute<TRoute> = TRoute extends FragnoRouteConfig<infer TMethod, infer TPath, infer TInputSchema, infer TOutputSchema, infer TErrorCode, infer TQueryParameters, infer TThisContext> ? FragnoRouteConfig<TMethod, JoinInternalRoutePath<TPath>, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters, TThisContext> : never;
-type PrefixInternalRoutes<TRoutes$1 extends readonly AnyFragnoRouteConfig[]> = TRoutes$1 extends readonly [...infer TRoutesTuple] ? { [K in keyof TRoutesTuple]: PrefixInternalRoute<TRoutesTuple[K]> } : readonly AnyFragnoRouteConfig[];
-type ExtractRoutesFromFragment<T> = T extends FragnoInstantiatedFragment<infer TRoutes, infer _TDeps, infer _TServices, infer _TServiceThisContext, infer _THandlerThisContext, infer _TRequestStorage, infer _TOptions, infer _TLinkedFragments> ? TRoutes : never;
-type InternalLinkedRoutes<TLinkedFragments$1> = TLinkedFragments$1 extends Record<string, AnyFragnoInstantiatedFragment> ? TLinkedFragments$1 extends {
-  _fragno_internal: infer TInternal;
-} ? ExtractRoutesFromFragment<TInternal> extends readonly AnyFragnoRouteConfig[] ? PrefixInternalRoutes<ExtractRoutesFromFragment<TInternal>> : readonly [] : readonly [] : readonly [];
-type RoutesWithInternal<TRoutes$1 extends readonly AnyFragnoRouteConfig[], TLinkedFragments$1> = readonly [...TRoutes$1, ...InternalLinkedRoutes<TLinkedFragments$1>];
+type PrefixInternalRoutes<TRoutes extends readonly AnyFragnoRouteConfig[]> = TRoutes extends readonly [...infer TRoutesTuple] ? { [K in keyof TRoutesTuple]: PrefixInternalRoute<TRoutesTuple[K]> } : readonly AnyFragnoRouteConfig[];
+type InternalRoutesFromDefinition<TInternalRoutes$1 extends readonly AnyRouteOrFactory[]> = PrefixInternalRoutes<FlattenRouteFactories<TInternalRoutes$1>>;
+type RoutesWithInternal<TRoutes extends readonly AnyFragnoRouteConfig[], TInternalRoutes$1 extends readonly AnyRouteOrFactory[]> = readonly [...TRoutes, ...InternalRoutesFromDefinition<TInternalRoutes$1>];
+type ExtractServiceCallResult<T> = T extends undefined ? undefined : T extends {
+  _internal: {
+    finalResult?: infer R;
+  };
+} ? R : Awaited<T>;
+type ExtractServiceCallResults<T extends readonly unknown[]> = { [K in keyof T]: ExtractServiceCallResult<T[K]> };
+type ExtractServiceCallResultsOrSingle<T> = T extends readonly unknown[] ? ExtractServiceCallResults<T> : ExtractServiceCallResult<T>;
 /**
  * Helper type to extract the instantiated fragment type from a fragment definition.
  * This is useful for typing functions that accept instantiated fragments based on their definition.
@@ -32,7 +41,7 @@ type RoutesWithInternal<TRoutes$1 extends readonly AnyFragnoRouteConfig[], TLink
  * type MyInstantiatedFragment = InstantiatedFragmentFromDefinition<typeof myFragmentDef>;
  * ```
  */
-type InstantiatedFragmentFromDefinition<TDef extends FragmentDefinition<any, any, any, any, any, any, any, any, any, any, any>> = TDef extends FragmentDefinition<infer _TConfig, infer TOptions, infer TDeps, infer TBaseServices, infer TServices, infer _TServiceDependencies, infer _TPrivateServices, infer TServiceThisContext, infer THandlerThisContext, infer TRequestStorage, infer TLinkedFragments> ? FragnoInstantiatedFragment<RoutesWithInternal<readonly AnyFragnoRouteConfig[], TLinkedFragments>, TDeps, BoundServices<TBaseServices & TServices>, TServiceThisContext, THandlerThisContext, TRequestStorage, TOptions, TLinkedFragments> : never;
+type InstantiatedFragmentFromDefinition<TDef extends FragmentDefinition<any, any, any, any, any, any, any, any, any, any, any>> = TDef extends FragmentDefinition<infer _TConfig, infer TOptions, infer TDeps, infer TBaseServices, infer TServices, infer _TServiceDependencies, infer _TPrivateServices, infer TServiceThisContext, infer THandlerThisContext, infer TRequestStorage, infer TInternalRoutes> ? FragnoInstantiatedFragment<RoutesWithInternal<readonly AnyFragnoRouteConfig[], TInternalRoutes>, TDeps, BoundServices<TBaseServices & TServices>, TServiceThisContext, THandlerThisContext, TRequestStorage, TOptions> : never;
 type AstroHandlers = {
   ALL: (req: Request) => Promise<Response>;
 };
@@ -86,21 +95,21 @@ type HandlersByFramework = {
   "tanstack-start": TanStackStartHandlers;
 };
 type FullstackFrameworks = keyof HandlersByFramework;
-type AnyFragnoInstantiatedFragment = FragnoInstantiatedFragment<any, any, any, any, any, any, any, any>;
-interface FragnoFragmentSharedConfig<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
+type AnyFragnoInstantiatedFragment = FragnoInstantiatedFragment<any, any, any, any, any, any, any>;
+interface FragnoFragmentSharedConfig<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
   name: string;
-  routes: TRoutes$1;
+  routes: TRoutes;
 }
 /**
  * Instantiated fragment class with encapsulated state.
  * Provides the same public API as the old FragnoInstantiatedFragment but with better encapsulation.
  */
-declare class FragnoInstantiatedFragment<TRoutes$1 extends readonly AnyFragnoRouteConfig[], TDeps$1, TServices$1 extends Record<string, unknown>, TServiceThisContext$1 extends RequestThisContext, THandlerThisContext$1 extends RequestThisContext, TRequestStorage$1 = {}, TOptions$1 extends FragnoPublicConfig = FragnoPublicConfig, TLinkedFragments$1 extends Record<string, AnyFragnoInstantiatedFragment> = {}> implements IFragnoInstantiatedFragment {
+declare class FragnoInstantiatedFragment<TRoutes extends readonly AnyFragnoRouteConfig[], TDeps$1, TServices$1 extends Record<string, unknown>, TServiceThisContext$1 extends RequestThisContext, THandlerThisContext$1 extends RequestThisContext, TRequestStorage$1 = {}, TOptions$1 extends FragnoPublicConfig = FragnoPublicConfig> implements IFragnoInstantiatedFragment {
   #private;
   readonly [instantiatedFragmentFakeSymbol]: "$fragno-instantiated-fragment";
   constructor(params: {
     name: string;
-    routes: TRoutes$1;
+    routes: TRoutes;
     deps: TDeps$1;
     services: TServices$1;
     mountRoute: string;
@@ -109,11 +118,10 @@ declare class FragnoInstantiatedFragment<TRoutes$1 extends readonly AnyFragnoRou
     storage: RequestContextStorage<TRequestStorage$1>;
     createRequestStorage?: () => TRequestStorage$1;
     options: TOptions$1;
-    linkedFragments?: TLinkedFragments$1;
     internalData?: Record<string, unknown>;
   });
   get name(): string;
-  get routes(): TRoutes$1;
+  get routes(): TRoutes;
   get services(): TServices$1;
   get mountRoute(): string;
   /**
@@ -122,13 +130,12 @@ declare class FragnoInstantiatedFragment<TRoutes$1 extends readonly AnyFragnoRou
   get $internal(): {
     deps: TDeps$1;
     options: TOptions$1;
-    linkedFragments: TLinkedFragments$1;
   };
   /**
    * Add middleware to this fragment.
    * Middleware can inspect and modify requests before they reach handlers.
    */
-  withMiddleware(handler: FragnoMiddlewareCallback<TRoutes$1, TDeps$1, TServices$1>): this;
+  withMiddleware(handler: FragnoMiddlewareCallback<TRoutes, TDeps$1, TServices$1>): this;
   /**
    * Execute a callback within a request context.
    * Establishes an async context for the duration of the callback, allowing services
@@ -149,6 +156,13 @@ declare class FragnoInstantiatedFragment<TRoutes$1 extends readonly AnyFragnoRou
    */
   inContext<T>(callback: (this: THandlerThisContext$1) => T): T;
   inContext<T>(callback: (this: THandlerThisContext$1) => Promise<T>): Promise<T>;
+  /**
+   * Execute multiple service calls within a handler context.
+   * If called outside a request context, it will create one automatically.
+   * Pass a factory so service calls are created inside the active context.
+   * Primarily used by database fragments (handlerTx).
+   */
+  callServices<TServiceCalls>(serviceCalls: () => TServiceCalls): Promise<ExtractServiceCallResultsOrSingle<TServiceCalls>>;
   /**
    * Get framework-specific handlers for this fragment.
    * Use this to integrate the fragment with different fullstack frameworks.
@@ -158,17 +172,17 @@ declare class FragnoInstantiatedFragment<TRoutes$1 extends readonly AnyFragnoRou
    * Main request handler for this fragment.
    * Handles routing, middleware, and error handling.
    */
-  handler(req: Request): Promise<Response>;
+  handler(req: Request, lifecycleContext?: FragnoRequestLifecycleContext): Promise<Response>;
   /**
    * Call a route directly with typed inputs and outputs.
    * Useful for testing and server-side route calls.
    */
-  callRoute<TMethod$1 extends HTTPMethod, TPath$1 extends ExtractRoutePath<TRoutes$1, TMethod$1>>(method: TMethod$1, path: TPath$1, inputOptions?: RouteHandlerInputOptions<TPath$1, ExtractRouteByPath<TRoutes$1, TPath$1, TMethod$1>["inputSchema"]>): Promise<FragnoResponse<InferOrUnknown<NonNullable<ExtractRouteByPath<TRoutes$1, TPath$1, TMethod$1>["outputSchema"]>>>>;
+  callRoute<TMethod$1 extends HTTPMethod, TPath$1 extends CallRoutePath<TRoutes, TMethod$1>>(method: TMethod$1, path: TPath$1, inputOptions?: RouteHandlerInputOptions<TPath$1, CallRouteMatch<TRoutes, TMethod$1, TPath$1>["inputSchema"]>): Promise<FragnoResponse<InferOrUnknown<NonNullable<CallRouteMatch<TRoutes, TMethod$1, TPath$1>["outputSchema"]>>>>;
   /**
    * Call a route directly and get the raw Response object.
    * Useful for testing and server-side route calls.
    */
-  callRouteRaw<TMethod$1 extends HTTPMethod, TPath$1 extends ExtractRoutePath<TRoutes$1, TMethod$1>>(method: TMethod$1, path: TPath$1, inputOptions?: RouteHandlerInputOptions<TPath$1, ExtractRouteByPath<TRoutes$1, TPath$1, TMethod$1>["inputSchema"]>): Promise<Response>;
+  callRouteRaw<TMethod$1 extends HTTPMethod, TPath$1 extends CallRoutePath<TRoutes, TMethod$1>>(method: TMethod$1, path: TPath$1, inputOptions?: RouteHandlerInputOptions<TPath$1, CallRouteMatch<TRoutes, TMethod$1, TPath$1>["inputSchema"]>): Promise<Response>;
 }
 /**
  * Options for fragment instantiation.
@@ -185,7 +199,7 @@ interface InstantiationOptions {
  * Core instantiation function that creates a fragment instance from a definition.
  * This function validates dependencies, calls all callbacks, and wires everything together.
  */
-declare function instantiateFragment<const TConfig, const TOptions$1 extends FragnoPublicConfig, const TDeps$1, const TBaseServices$1 extends Record<string, unknown>, const TServices$1 extends Record<string, unknown>, const TServiceDependencies, const TPrivateServices extends Record<string, unknown>, const TServiceThisContext$1 extends RequestThisContext, const THandlerThisContext$1 extends RequestThisContext, const TRequestStorage$1, const TRoutesOrFactories extends readonly AnyRouteOrFactory[], const TLinkedFragments$1 extends Record<string, AnyFragnoInstantiatedFragment>>(definition: FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TLinkedFragments$1>, config: TConfig, routesOrFactories: TRoutesOrFactories, options: TOptions$1, serviceImplementations?: TServiceDependencies, instantiationOptions?: InstantiationOptions): FragnoInstantiatedFragment<RoutesWithInternal<FlattenRouteFactories<TRoutesOrFactories>, TLinkedFragments$1>, TDeps$1, BoundServices<TBaseServices$1 & TServices$1>, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TOptions$1, TLinkedFragments$1>;
+declare function instantiateFragment<const TConfig, const TOptions$1 extends FragnoPublicConfig, const TDeps$1, const TBaseServices$1 extends Record<string, unknown>, const TServices$1 extends Record<string, unknown>, const TServiceDependencies, const TPrivateServices extends Record<string, unknown>, const TServiceThisContext$1 extends RequestThisContext, const THandlerThisContext$1 extends RequestThisContext, const TRequestStorage$1, const TRoutesOrFactories extends readonly AnyRouteOrFactory[], const TInternalRoutes$1 extends readonly AnyRouteOrFactory[]>(definition: FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TInternalRoutes$1>, config: TConfig, routesOrFactories: TRoutesOrFactories, options: TOptions$1, serviceImplementations?: TServiceDependencies, instantiationOptions?: InstantiationOptions): FragnoInstantiatedFragment<RoutesWithInternal<FlattenRouteFactories<TRoutesOrFactories>, TInternalRoutes$1>, TDeps$1, BoundServices<TBaseServices$1 & TServices$1>, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TOptions$1>;
 /**
  * Interface that defines the public API for a fragment instantiation builder.
  * Used to ensure consistency between real implementations and stubs.
@@ -241,13 +255,13 @@ interface IFragnoInstantiatedFragment {
   get $internal(): {
     deps: unknown;
     options: unknown;
-    linkedFragments: unknown;
   } & Record<string, unknown>;
   withMiddleware(handler: any): this;
   inContext<T>(callback: any): T;
   inContext<T>(callback: any): Promise<T>;
+  callServices(serviceCalls: () => any): Promise<any>;
   handlersFor(framework: FullstackFrameworks): any;
-  handler(req: Request): Promise<Response>;
+  handler(req: Request, lifecycleContext?: FragnoRequestLifecycleContext): Promise<Response>;
   callRoute(method: HTTPMethod, path: string, inputOptions?: any): Promise<any>;
   callRouteRaw(method: HTTPMethod, path: string, inputOptions?: any): Promise<Response>;
 }
@@ -255,13 +269,13 @@ interface IFragnoInstantiatedFragment {
  * Fluent builder for instantiating fragments.
  * Provides a type-safe API for configuring and building fragment instances.
  */
-declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPublicConfig, TDeps$1, TBaseServices$1 extends Record<string, unknown>, TServices$1 extends Record<string, unknown>, TServiceDependencies, TPrivateServices extends Record<string, unknown>, TServiceThisContext$1 extends RequestThisContext, THandlerThisContext$1 extends RequestThisContext, TRequestStorage$1, TRoutesOrFactories extends readonly AnyRouteOrFactory[], TLinkedFragments$1 extends Record<string, AnyFragnoInstantiatedFragment>> implements IFragmentInstantiationBuilder {
+declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPublicConfig, TDeps$1, TBaseServices$1 extends Record<string, unknown>, TServices$1 extends Record<string, unknown>, TServiceDependencies, TPrivateServices extends Record<string, unknown>, TServiceThisContext$1 extends RequestThisContext, THandlerThisContext$1 extends RequestThisContext, TRequestStorage$1, TRoutesOrFactories extends readonly AnyRouteOrFactory[], TInternalRoutes$1 extends readonly AnyRouteOrFactory[]> implements IFragmentInstantiationBuilder {
   #private;
-  constructor(definition: FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TLinkedFragments$1>, routes?: TRoutesOrFactories);
+  constructor(definition: FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TInternalRoutes$1>, routes?: TRoutesOrFactories);
   /**
    * Get the fragment definition
    */
-  get definition(): FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TLinkedFragments$1>;
+  get definition(): FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TInternalRoutes$1>;
   /**
    * Get the configured routes
    */
@@ -281,7 +295,7 @@ declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPub
   /**
    * Set the routes for the fragment
    */
-  withRoutes<const TNewRoutes extends readonly AnyRouteOrFactory[]>(routes: TNewRoutes): FragmentInstantiationBuilder<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TNewRoutes, TLinkedFragments$1>;
+  withRoutes<const TNewRoutes extends readonly AnyRouteOrFactory[]>(routes: TNewRoutes): FragmentInstantiationBuilder<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TNewRoutes, TInternalRoutes$1>;
   /**
    * Set the options for the fragment (e.g., mountRoute, databaseAdapter)
    */
@@ -293,7 +307,7 @@ declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPub
   /**
    * Build and return the instantiated fragment
    */
-  build(): FragnoInstantiatedFragment<RoutesWithInternal<FlattenRouteFactories<TRoutesOrFactories>, TLinkedFragments$1>, TDeps$1, BoundServices<TBaseServices$1 & TServices$1>, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TOptions$1, TLinkedFragments$1>;
+  build(): FragnoInstantiatedFragment<RoutesWithInternal<FlattenRouteFactories<TRoutesOrFactories>, TInternalRoutes$1>, TDeps$1, BoundServices<TBaseServices$1 & TServices$1>, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TOptions$1>;
 }
 /**
  * Create a fluent builder for instantiating a fragment.
@@ -307,7 +321,7 @@ declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPub
  *   .build();
  * ```
  */
-declare function instantiate<TConfig, TOptions$1 extends FragnoPublicConfig, TDeps$1, TBaseServices$1 extends Record<string, unknown>, TServices$1 extends Record<string, unknown>, TServiceDependencies, TPrivateServices extends Record<string, unknown>, TServiceThisContext$1 extends RequestThisContext, THandlerThisContext$1 extends RequestThisContext, TRequestStorage$1, TLinkedFragments$1 extends Record<string, AnyFragnoInstantiatedFragment>>(definition: FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TLinkedFragments$1>): FragmentInstantiationBuilder<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, readonly [], TLinkedFragments$1>;
+declare function instantiate<TConfig, TOptions$1 extends FragnoPublicConfig, TDeps$1, TBaseServices$1 extends Record<string, unknown>, TServices$1 extends Record<string, unknown>, TServiceDependencies, TPrivateServices extends Record<string, unknown>, TServiceThisContext$1 extends RequestThisContext, THandlerThisContext$1 extends RequestThisContext, TRequestStorage$1, TInternalRoutes$1 extends readonly AnyRouteOrFactory[]>(definition: FragmentDefinition<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TInternalRoutes$1>): FragmentInstantiationBuilder<TConfig, TOptions$1, TDeps$1, TBaseServices$1, TServices$1, TServiceDependencies, TPrivateServices, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, readonly [], TInternalRoutes$1>;
 //#endregion
-export { AnyFragnoInstantiatedFragment, type BoundServices, FragmentInstantiationBuilder, FragnoFragmentSharedConfig, FragnoInstantiatedFragment, type IFragmentInstantiationBuilder, type IFragnoInstantiatedFragment, InstantiatedFragmentFromDefinition, InstantiationOptions, RoutesWithInternal, instantiate, instantiateFragment };
+export { AnyFragnoInstantiatedFragment, type BoundServices, FragmentInstantiationBuilder, FragnoFragmentSharedConfig, FragnoInstantiatedFragment, FragnoRequestLifecycleContext, type IFragmentInstantiationBuilder, type IFragnoInstantiatedFragment, InstantiatedFragmentFromDefinition, InstantiationOptions, RoutesWithInternal, instantiate, instantiateFragment };
 //# sourceMappingURL=fragment-instantiator.d.ts.map