@fragno-dev/core 0.1.11 → 0.2.0

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> = (context: {\n  config: TConfig;\n  options: TOptions;\n  serviceDependencies?: TServiceDependencies;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n}) => FragnoInstantiatedFragment<any, any, any, any, any, any, any>;\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 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<TConfig, TOptions, TServiceDependencies>;\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<TConfig, TOptions, TServiceDependencies>;\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        >;\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 are service-only (no routes) and share the same config/options as the parent.\n   * All services from the linked fragment will be available as private services.\n   */\n  withLinkedFragment<\n    const TName extends string,\n    TCallback extends LinkedFragmentCallback<TConfig, TOptions, TServiceDependencies>,\n  >(\n    name: TName,\n    callback: TCallback,\n  ): FragmentDefinitionBuilder<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & ExtractLinkedServices<TCallback>,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments & { [K in TName]: ReturnType<TCallback> }\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<TCallback>,\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<TCallback>,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments & { [K in TName]: ReturnType<TCallback> }\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","#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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"}

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

@@ -13,7 +13,15 @@ import { FragmentDefinition } from "./fragment-definition-builder.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/api/fragment-instantiator.d.ts
-
+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>];
 /**
  * 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.
@@ -24,9 +32,7 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
  * 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<readonly AnyFragnoRouteConfig[],
-// Routes are dynamic, so we use a generic array
-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 TLinkedFragments> ? FragnoInstantiatedFragment<RoutesWithInternal<readonly AnyFragnoRouteConfig[], TLinkedFragments>, TDeps, BoundServices<TBaseServices & TServices>, TServiceThisContext, THandlerThisContext, TRequestStorage, TOptions, TLinkedFragments> : never;
 type AstroHandlers = {
   ALL: (req: Request) => Promise<Response>;
 };
@@ -81,20 +87,20 @@ type HandlersByFramework = {
 };
 type FullstackFrameworks = keyof HandlersByFramework;
 type AnyFragnoInstantiatedFragment = FragnoInstantiatedFragment<any, any, any, any, any, any, any, any>;
-interface FragnoFragmentSharedConfig<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
+interface FragnoFragmentSharedConfig<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
   name: string;
-  routes: TRoutes;
+  routes: TRoutes$1;
 }
 /**
  * Instantiated fragment class with encapsulated state.
  * Provides the same public API as the old FragnoInstantiatedFragment but with better encapsulation.
  */
-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, TLinkedFragments$1 extends Record<string, AnyFragnoInstantiatedFragment> = {}> implements IFragnoInstantiatedFragment {
+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 {
   #private;
   readonly [instantiatedFragmentFakeSymbol]: "$fragno-instantiated-fragment";
   constructor(params: {
     name: string;
-    routes: TRoutes;
+    routes: TRoutes$1;
     deps: TDeps$1;
     services: TServices$1;
     mountRoute: string;
@@ -104,9 +110,10 @@ declare class FragnoInstantiatedFragment<TRoutes extends readonly AnyFragnoRoute
     createRequestStorage?: () => TRequestStorage$1;
     options: TOptions$1;
     linkedFragments?: TLinkedFragments$1;
+    internalData?: Record<string, unknown>;
   });
   get name(): string;
-  get routes(): TRoutes;
+  get routes(): TRoutes$1;
   get services(): TServices$1;
   get mountRoute(): string;
   /**
@@ -121,7 +128,7 @@ declare class FragnoInstantiatedFragment<TRoutes extends readonly AnyFragnoRoute
    * Add middleware to this fragment.
    * Middleware can inspect and modify requests before they reach handlers.
    */
-  withMiddleware(handler: FragnoMiddlewareCallback<TRoutes, TDeps$1, TServices$1>): this;
+  withMiddleware(handler: FragnoMiddlewareCallback<TRoutes$1, TDeps$1, TServices$1>): this;
   /**
    * Execute a callback within a request context.
    * Establishes an async context for the duration of the callback, allowing services
@@ -156,12 +163,12 @@ declare class FragnoInstantiatedFragment<TRoutes extends readonly AnyFragnoRoute
    * Call a route directly with typed inputs and outputs.
    * Useful for testing and server-side route calls.
    */
-  callRoute<TMethod extends HTTPMethod, TPath extends ExtractRoutePath<TRoutes, TMethod>>(method: TMethod, path: TPath, inputOptions?: RouteHandlerInputOptions<TPath, ExtractRouteByPath<TRoutes, TPath, TMethod>["inputSchema"]>): Promise<FragnoResponse<InferOrUnknown<NonNullable<ExtractRouteByPath<TRoutes, TPath, TMethod>["outputSchema"]>>>>;
+  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"]>>>>;
   /**
    * Call a route directly and get the raw Response object.
    * Useful for testing and server-side route calls.
    */
-  callRouteRaw<TMethod extends HTTPMethod, TPath extends ExtractRoutePath<TRoutes, TMethod>>(method: TMethod, path: TPath, inputOptions?: RouteHandlerInputOptions<TPath, ExtractRouteByPath<TRoutes, TPath, TMethod>["inputSchema"]>): Promise<Response>;
+  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>;
 }
 /**
  * Options for fragment instantiation.
@@ -178,7 +185,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<FlattenRouteFactories<TRoutesOrFactories>, 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 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>;
 /**
  * Interface that defines the public API for a fragment instantiation builder.
  * Used to ensure consistency between real implementations and stubs.
@@ -235,7 +242,7 @@ interface IFragnoInstantiatedFragment {
     deps: unknown;
     options: unknown;
     linkedFragments: unknown;
-  };
+  } & Record<string, unknown>;
   withMiddleware(handler: any): this;
   inContext<T>(callback: any): T;
   inContext<T>(callback: any): Promise<T>;
@@ -286,7 +293,7 @@ declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPub
   /**
    * Build and return the instantiated fragment
    */
-  build(): FragnoInstantiatedFragment<FlattenRouteFactories<TRoutesOrFactories>, TDeps$1, BoundServices<TBaseServices$1 & TServices$1>, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TOptions$1, TLinkedFragments$1>;
+  build(): FragnoInstantiatedFragment<RoutesWithInternal<FlattenRouteFactories<TRoutesOrFactories>, TLinkedFragments$1>, TDeps$1, BoundServices<TBaseServices$1 & TServices$1>, TServiceThisContext$1, THandlerThisContext$1, TRequestStorage$1, TOptions$1, TLinkedFragments$1>;
 }
 /**
  * Create a fluent builder for instantiating a fragment.
@@ -302,5 +309,5 @@ declare class FragmentInstantiationBuilder<TConfig, TOptions$1 extends FragnoPub
  */
 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>;
 //#endregion
-export { AnyFragnoInstantiatedFragment, type BoundServices, FragmentInstantiationBuilder, FragnoFragmentSharedConfig, FragnoInstantiatedFragment, type IFragmentInstantiationBuilder, type IFragnoInstantiatedFragment, InstantiatedFragmentFromDefinition, InstantiationOptions, instantiate, instantiateFragment };
+export { AnyFragnoInstantiatedFragment, type BoundServices, FragmentInstantiationBuilder, FragnoFragmentSharedConfig, FragnoInstantiatedFragment, type IFragmentInstantiationBuilder, type IFragnoInstantiatedFragment, InstantiatedFragmentFromDefinition, InstantiationOptions, RoutesWithInternal, instantiate, instantiateFragment };
 //# sourceMappingURL=fragment-instantiator.d.ts.map

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

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