@fragno-dev/core 0.1.11 → 0.2.0

package/dist/client/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["#publicConfig","#fragmentConfig","#fetcherConfig","#cache","#createFetcherStore","#createMutatorStore","#invalidateKeys","#getFetcher","#getFetcherOptions","#createRouteQueryHook","#createRouteQueryMutator","response: Response","mutatorStore: FragnoClientMutatorData<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >[\"mutatorStore\"]","#invalidate","fragmentConfig: FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>"],"sources":["../../src/client/client.ts"],"sourcesContent":["import { nanoquery, type FetcherStore, type MutatorStore } from \"@nanostores/query\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { computed, task, type ReadableAtom, type Store } from \"nanostores\";\nimport type {\n  FragnoRouteConfig,\n  HTTPMethod,\n  NonGetHTTPMethod,\n  RequestThisContext,\n} from \"../api/api\";\nimport {\n  buildPath,\n  extractPathParams,\n  type ExtractPathParams,\n  type ExtractPathParamsOrWiden,\n  type MaybeExtractPathParamsOrWiden,\n} from \"../api/internal/path\";\nimport { getMountRoute } from \"../api/internal/route\";\nimport { RequestInputContext } from \"../api/request-input-context\";\nimport { RequestOutputContext } from \"../api/request-output-context\";\nimport type {\n  FetcherConfig,\n  FragnoFragmentSharedConfig,\n  FragnoPublicClientConfig,\n  FragnoPublicConfig,\n} from \"../api/shared-types\";\nimport { FragnoClientApiError, FragnoClientError, FragnoClientFetchError } from \"./client-error\";\nimport type { InferOr } from \"../util/types-util\";\nimport { parseContentType } from \"../util/content-type\";\nimport {\n  handleNdjsonStreamingFirstItem,\n  type NdjsonStreamingStore,\n} from \"./internal/ndjson-streaming\";\nimport { addStore, getInitialData, SSR_ENABLED } from \"../util/ssr\";\nimport { unwrapObject } from \"../util/nanostores\";\nimport type { FragmentDefinition } from \"../api/fragment-definition-builder\";\nimport {\n  type AnyRouteOrFactory,\n  type FlattenRouteFactories,\n  resolveRouteFactories,\n} from \"../api/route\";\nimport { mergeFetcherConfigs } from \"./internal/fetcher-merge\";\n\n/**\n * Symbols used to identify hook types\n */\nconst GET_HOOK_SYMBOL = Symbol(\"fragno-get-hook\");\nconst MUTATOR_HOOK_SYMBOL = Symbol(\"fragno-mutator-hook\");\nconst STORE_SYMBOL = Symbol(\"fragno-store\");\n\n/**\n * Extract only GET routes from a library config's routes array\n * @internal\n */\nexport type ExtractGetRoutes<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = {\n  [K in keyof T]: T[K] extends FragnoRouteConfig<\n    infer Method,\n    infer Path,\n    infer Input,\n    infer Output,\n    infer ErrorCode,\n    infer QueryParams\n  >\n    ? Method extends \"GET\"\n      ? FragnoRouteConfig<Method, Path, Input, Output, ErrorCode, QueryParams>\n      : never\n    : never;\n}[number][];\n\n/**\n * Extract the path from a route configuration for a given method\n * @internal\n */\nexport type ExtractRoutePath<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TExpectedMethod extends HTTPMethod = HTTPMethod,\n> = {\n  [K in keyof T]: T[K] extends FragnoRouteConfig<\n    infer Method,\n    infer Path,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >\n    ? Method extends TExpectedMethod\n      ? Path\n      : never\n    : never;\n}[number];\n\n/**\n * @internal\n */\nexport type ExtractGetRoutePaths<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = ExtractRoutePath<T, \"GET\">;\n\n/**\n * @internal\n */\nexport type ExtractNonGetRoutePaths<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = ExtractRoutePath<T, NonGetHTTPMethod>;\n\n/**\n * Extract the route configuration type(s) for a given path from a routes array.\n * Optionally narrow by HTTP method via the third type parameter.\n *\n * Defaults to extracting all methods for the matching path, producing a union\n * if multiple methods exist for the same path.\n * @internal\n */\nexport type ExtractRouteByPath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TPath extends string,\n  TMethod extends HTTPMethod = HTTPMethod,\n> = {\n  [K in keyof TRoutes]: TRoutes[K] extends FragnoRouteConfig<\n    infer M,\n    TPath,\n    infer Input,\n    infer Output,\n    infer ErrorCode,\n    infer QueryParams\n  >\n    ? M extends TMethod\n      ? FragnoRouteConfig<M, TPath, Input, Output, ErrorCode, QueryParams>\n      : never\n    : never;\n}[number];\n\n/**\n * Extract the output schema type for a specific route path from a routes array\n * @internal\n */\nexport type ExtractOutputSchemaForPath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined\n  >[],\n  TPath extends string,\n> = {\n  [K in keyof TRoutes]: TRoutes[K] extends FragnoRouteConfig<\n    infer Method,\n    TPath,\n    StandardSchemaV1 | undefined,\n    infer Output\n  >\n    ? Method extends \"GET\"\n      ? Output\n      : never\n    : never;\n}[number];\n\n/**\n * Check if a path exists as a GET route in the routes array\n * @internal\n */\nexport type IsValidGetRoutePath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TPath extends string,\n> = TPath extends ExtractGetRoutePaths<TRoutes> ? true : false;\n\n/**\n * Utility type to ensure only valid GET route paths can be used\n * @internal\n */\nexport type ValidateGetRoutePath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TPath extends string,\n> =\n  TPath extends ExtractGetRoutePaths<TRoutes>\n    ? TPath\n    : `Error: Path '${TPath}' is not a valid GET route. Available GET routes: ${ExtractGetRoutePaths<TRoutes>}`;\n\n/**\n * Helper type to check if a routes array has any GET routes\n * @internal\n */\nexport type HasGetRoutes<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = ExtractGetRoutePaths<T> extends never ? false : true;\n\n/**\n * @internal\n */\nexport type ObjectContainingStoreField<T extends object> = T extends Store\n  ? T\n  : {\n        [K in keyof T]: T[K] extends Store ? { [P in K]: T[P] } & Partial<Omit<T, K>> : never;\n      }[keyof T] extends never\n    ? never\n    : T;\n\n/**\n * @internal\n */\nexport type FragnoStoreData<T extends object> = {\n  obj: T;\n  [STORE_SYMBOL]: true;\n};\n\nexport type FragnoClientHookData<\n  TMethod extends HTTPMethod,\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = {\n  route: FragnoRouteConfig<\n    TMethod,\n    TPath,\n    StandardSchemaV1 | undefined,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >;\n  query(args?: {\n    path?: MaybeExtractPathParamsOrWiden<TPath, string>;\n    query?: Record<TQueryParameters, string | undefined>;\n  }): Promise<StandardSchemaV1.InferOutput<TOutputSchema>>;\n  store(args?: {\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n    query?: Record<TQueryParameters, string | undefined | ReadableAtom<string | undefined>>;\n  }): FetcherStore<StandardSchemaV1.InferOutput<TOutputSchema>, FragnoClientError<TErrorCode>>;\n  [GET_HOOK_SYMBOL]: true;\n} & {\n  // Phantom field that preserves the specific TOutputSchema type parameter\n  // in the structural type. This makes the type covariant, allowing more\n  // specific schema types (like z.ZodString) to be assigned to variables\n  // typed with more general schema types (like StandardSchemaV1<any, any>)\n  readonly _outputSchema?: TOutputSchema;\n};\n\nexport type FragnoClientMutatorData<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = {\n  route: FragnoRouteConfig<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >;\n\n  mutateQuery(args?: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string>;\n    query?: Record<TQueryParameters, string | undefined>;\n  }): Promise<InferOr<TOutputSchema, undefined>>;\n\n  mutatorStore: MutatorStore<\n    {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n      query?: Record<TQueryParameters, string | undefined | ReadableAtom<string | undefined>>;\n    },\n    InferOr<TOutputSchema, undefined>,\n    FragnoClientError<TErrorCode>\n  >;\n  [MUTATOR_HOOK_SYMBOL]: true;\n} & {\n  readonly _inputSchema?: TInputSchema;\n  readonly _outputSchema?: TOutputSchema;\n};\n\n/**\n * @internal\n */\nexport function buildUrl<TPath extends string>(\n  config: {\n    baseUrl?: string;\n    mountRoute: string;\n    path: TPath;\n  },\n  params: {\n    pathParams?: Record<string, string | ReadableAtom<string>>;\n    queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n  },\n): string {\n  const { baseUrl = \"\", mountRoute, path } = config;\n  const { pathParams, queryParams } = params ?? {};\n\n  const normalizedPathParams = unwrapObject(pathParams) as ExtractPathParams<TPath, string>;\n  const normalizedQueryParams = unwrapObject(queryParams) ?? {};\n\n  // Filter out undefined values to prevent URLSearchParams from converting them to string \"undefined\"\n  const filteredQueryParams = Object.fromEntries(\n    Object.entries(normalizedQueryParams).filter(([_, value]) => value !== undefined),\n  ) as Record<string, string>;\n\n  const searchParams = new URLSearchParams(filteredQueryParams);\n  const builtPath = buildPath(path, normalizedPathParams ?? {});\n  const search = searchParams.toString() ? `?${searchParams.toString()}` : \"\";\n  return `${baseUrl}${mountRoute}${builtPath}${search}`;\n}\n\n/**\n * This method returns an array, which can be passed directly to nanostores.\n *\n * The returned array is always: path, pathParams (In order they appear in the path), queryParams (In alphabetical order)\n * Missing pathParams are replaced with \"<missing>\".\n * Atoms with undefined values are wrapped in computed atoms that map undefined to \"\" to avoid nanoquery treating the key as incomplete.\n * @param path\n * @param params\n * @returns\n * @internal\n */\nexport function getCacheKey<TMethod extends HTTPMethod, TPath extends string>(\n  method: TMethod,\n  path: TPath,\n  params?: {\n    pathParams?: Record<string, string | ReadableAtom<string>>;\n    queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n  },\n): (string | ReadableAtom<string>)[] {\n  if (!params) {\n    return [method, path];\n  }\n\n  const { pathParams, queryParams } = params;\n\n  const pathParamNames = extractPathParams(path);\n  const pathParamValues = pathParamNames.map((name) => pathParams?.[name] ?? \"<missing>\");\n\n  const queryParamValues = queryParams\n    ? Object.keys(queryParams)\n        .sort()\n        .map((key) => {\n          const value = queryParams[key];\n          // If it's an atom, wrap it to convert undefined to \"\"\n          if (value && typeof value === \"object\" && \"get\" in value) {\n            return computed(value as ReadableAtom<string | undefined>, (v) => v ?? \"\");\n          }\n          // Plain string value (or undefined)\n          return value ?? \"\";\n        })\n    : [];\n\n  return [method, path, ...pathParamValues, ...queryParamValues];\n}\n\nfunction isStreamingResponse(response: Response): false | \"ndjson\" | \"octet-stream\" {\n  const contentType = parseContentType(response.headers.get(\"content-type\"));\n\n  if (!contentType) {\n    // Always assume 'normal' JSON by default.\n    return false;\n  }\n\n  const isChunked = response.headers.get(\"transfer-encoding\") === \"chunked\";\n\n  if (!isChunked) {\n    return false;\n  }\n\n  if (contentType.subtype === \"octet-stream\") {\n    // TODO(Wilco): This is not actually supported properly\n    return \"octet-stream\";\n  }\n\n  if (contentType.subtype === \"x-ndjson\") {\n    return \"ndjson\";\n  }\n\n  return false;\n}\n\n// Type guard to check if a hook is a GET hook\n/**\n * @internal\n */\nexport function isGetHook<\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: unknown,\n): hook is FragnoClientHookData<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return (\n    typeof hook === \"object\" &&\n    hook !== null &&\n    GET_HOOK_SYMBOL in hook &&\n    hook[GET_HOOK_SYMBOL] === true\n  );\n}\n\n// Type guard to check if a hook is a mutator\n/**\n * @internal\n */\nexport function isMutatorHook<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: unknown,\n): hook is FragnoClientMutatorData<\n  TMethod,\n  TPath,\n  TInputSchema,\n  TOutputSchema,\n  TErrorCode,\n  TQueryParameters\n> {\n  return (\n    typeof hook === \"object\" &&\n    hook !== null &&\n    MUTATOR_HOOK_SYMBOL in hook &&\n    hook[MUTATOR_HOOK_SYMBOL] === true\n  );\n}\n\n/**\n * @internal\n */\nexport function isStore<TStore extends Store>(obj: unknown): obj is FragnoStoreData<TStore> {\n  return (\n    typeof obj === \"object\" && obj !== null && STORE_SYMBOL in obj && obj[STORE_SYMBOL] === true\n  );\n}\n\ntype OnErrorRetryFn = (opts: {\n  error: unknown;\n  key: string;\n  retryCount: number;\n}) => number | undefined;\n\nexport type CreateHookOptions = {\n  /**\n   * A function that will be called when an error occurs. Implements an exponential backoff strategy\n   * when left undefined. When null, retries will be disabled. The number returned (> 0) by the\n   * callback will determine in how many ms to retry next.\n   */\n  onErrorRetry?: OnErrorRetryFn | null;\n};\n\ntype OnInvalidateFn<TPath extends string> = (\n  invalidate: <TInnerPath extends string>(\n    method: HTTPMethod,\n    path: TInnerPath,\n    params: {\n      pathParams?: MaybeExtractPathParamsOrWiden<TInnerPath, string>;\n      queryParams?: Record<string, string>;\n    },\n  ) => void,\n  params: {\n    pathParams: MaybeExtractPathParamsOrWiden<TPath, string>;\n    queryParams?: Record<string, string>;\n  },\n) => void;\n\n/**\n * @internal\n */\nexport type CacheLine = {\n  data: unknown;\n  error: unknown;\n  retryCount: number;\n  created: number;\n  expires: number;\n};\n\nexport class ClientBuilder<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TFragmentConfig extends FragnoFragmentSharedConfig<TRoutes>,\n> {\n  #publicConfig: FragnoPublicClientConfig;\n  #fragmentConfig: TFragmentConfig;\n  #fetcherConfig?: FetcherConfig;\n\n  #cache = new Map<string, CacheLine>();\n\n  #createFetcherStore;\n  #createMutatorStore;\n  #invalidateKeys;\n\n  constructor(publicConfig: FragnoPublicClientConfig, fragmentConfig: TFragmentConfig) {\n    this.#publicConfig = publicConfig;\n    this.#fragmentConfig = fragmentConfig;\n    this.#fetcherConfig = publicConfig.fetcherConfig;\n\n    const [createFetcherStore, createMutatorStore, { invalidateKeys }] = nanoquery({\n      cache: this.#cache,\n    });\n    this.#createFetcherStore = createFetcherStore;\n    this.#createMutatorStore = createMutatorStore;\n    this.#invalidateKeys = invalidateKeys;\n  }\n\n  get cacheEntries(): Readonly<Record<string, CacheLine>> {\n    return Object.fromEntries(this.#cache.entries());\n  }\n\n  createStore<const T extends object>(obj: T): FragnoStoreData<T> {\n    return { obj: obj, [STORE_SYMBOL]: true };\n  }\n\n  /**\n   * Build a URL for a custom backend call using the configured baseUrl and mountRoute.\n   * Useful for fragment authors who need to make custom fetch calls.\n   */\n  buildUrl<TPath extends string>(\n    path: TPath,\n    params?: {\n      path?: MaybeExtractPathParamsOrWiden<TPath, string>;\n      query?: Record<string, string>;\n    },\n  ): string {\n    const baseUrl = this.#publicConfig.baseUrl ?? \"\";\n    const mountRoute = getMountRoute(this.#fragmentConfig);\n\n    return buildUrl(\n      { baseUrl, mountRoute, path },\n      { pathParams: params?.path, queryParams: params?.query },\n    );\n  }\n\n  /**\n   * Get the configured fetcher function for custom backend calls.\n   * Returns fetch with merged options applied.\n   */\n  getFetcher(): {\n    fetcher: typeof fetch;\n    defaultOptions: RequestInit | undefined;\n  } {\n    return {\n      fetcher: this.#getFetcher(),\n      defaultOptions: this.#getFetcherOptions(),\n    };\n  }\n\n  #getFetcher(): typeof fetch {\n    if (this.#fetcherConfig?.type === \"function\") {\n      return this.#fetcherConfig.fetcher;\n    }\n    return fetch;\n  }\n\n  #getFetcherOptions(): RequestInit | undefined {\n    if (this.#fetcherConfig?.type === \"options\") {\n      return this.#fetcherConfig.options;\n    }\n    return undefined;\n  }\n\n  createHook<TPath extends ExtractGetRoutePaths<TFragmentConfig[\"routes\"]>>(\n    path: ValidateGetRoutePath<TFragmentConfig[\"routes\"], TPath>,\n    options?: CreateHookOptions,\n  ): FragnoClientHookData<\n    \"GET\",\n    TPath,\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"outputSchema\"]>,\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"errorCodes\"]>[number],\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"queryParameters\"]>[number]\n  > {\n    const route = this.#fragmentConfig.routes.find(\n      (\n        r,\n      ): r is FragnoRouteConfig<\n        \"GET\",\n        TPath,\n        StandardSchemaV1 | undefined,\n        StandardSchemaV1,\n        string,\n        string\n      > => r.path === path && r.method === \"GET\" && r.outputSchema !== undefined,\n    );\n\n    if (!route) {\n      throw new Error(`Route '${path}' not found or is not a GET route with an output schema.`);\n    }\n\n    return this.#createRouteQueryHook(route, options);\n  }\n\n  createMutator<TPath extends ExtractNonGetRoutePaths<TFragmentConfig[\"routes\"]>>(\n    method: NonGetHTTPMethod,\n    path: TPath,\n    onInvalidate?: OnInvalidateFn<TPath>,\n  ): FragnoClientMutatorData<\n    NonGetHTTPMethod, // TODO: This can be any Method, but should be related to TPath\n    TPath,\n    ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"inputSchema\"],\n    ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"outputSchema\"],\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"errorCodes\"]>[number],\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"queryParameters\"]>[number]\n  > {\n    type TRoute = ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>;\n\n    const route = this.#fragmentConfig.routes.find(\n      (\n        r,\n      ): r is FragnoRouteConfig<\n        NonGetHTTPMethod,\n        TPath,\n        TRoute[\"inputSchema\"],\n        TRoute[\"outputSchema\"],\n        string,\n        string\n      > => r.method !== \"GET\" && r.path === path && r.method === method,\n    );\n\n    if (!route) {\n      throw new Error(\n        `Route '${path}' not found or is a GET route with an input and output schema.`,\n      );\n    }\n\n    return this.#createRouteQueryMutator(route, onInvalidate);\n  }\n\n  #createRouteQueryHook<\n    TPath extends string,\n    TInputSchema extends StandardSchemaV1 | undefined,\n    TOutputSchema extends StandardSchemaV1,\n    TErrorCode extends string,\n    TQueryParameters extends string,\n  >(\n    route: FragnoRouteConfig<\n      \"GET\",\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >,\n    options: CreateHookOptions = {},\n  ): FragnoClientHookData<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n    if (route.method !== \"GET\") {\n      throw new Error(\n        `Only GET routes are supported for hooks. Route '${route.path}' is a ${route.method} route.`,\n      );\n    }\n\n    if (!route.outputSchema) {\n      throw new Error(\n        `Output schema is required for GET routes. Route '${route.path}' has no output schema.`,\n      );\n    }\n\n    const baseUrl = this.#publicConfig.baseUrl ?? \"\";\n    const mountRoute = getMountRoute(this.#fragmentConfig);\n    const fetcher = this.#getFetcher();\n    const fetcherOptions = this.#getFetcherOptions();\n\n    async function callServerSideHandler(params: {\n      pathParams?: Record<string, string | ReadableAtom<string>>;\n      queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n    }): Promise<Response> {\n      const { pathParams, queryParams } = params ?? {};\n\n      const normalizedPathParams = unwrapObject(pathParams) as ExtractPathParams<TPath, string>;\n      const normalizedQueryParams = unwrapObject(queryParams) ?? {};\n\n      // Filter out undefined values to prevent URLSearchParams from converting them to string \"undefined\"\n      const filteredQueryParams = Object.fromEntries(\n        Object.entries(normalizedQueryParams).filter(([_, value]) => value !== undefined),\n      ) as Record<string, string>;\n\n      const searchParams = new URLSearchParams(filteredQueryParams);\n\n      const result = await route.handler(\n        RequestInputContext.fromSSRContext({\n          method: route.method,\n          path: route.path,\n          pathParams: normalizedPathParams,\n          searchParams,\n        }),\n        new RequestOutputContext(route.outputSchema),\n      );\n\n      return result;\n    }\n\n    async function executeQuery(params?: {\n      pathParams?: Record<string, string | ReadableAtom<string>>;\n      queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n    }): Promise<Response> {\n      const { pathParams, queryParams } = params ?? {};\n\n      if (typeof window === \"undefined\") {\n        return task(async () => callServerSideHandler({ pathParams, queryParams }));\n      }\n\n      const url = buildUrl({ baseUrl, mountRoute, path: route.path }, { pathParams, queryParams });\n\n      let response: Response;\n      try {\n        response = fetcherOptions ? await fetcher(url, fetcherOptions) : await fetcher(url);\n      } catch (error) {\n        throw FragnoClientFetchError.fromUnknownFetchError(error);\n      }\n\n      if (!response.ok) {\n        throw await FragnoClientApiError.fromResponse<TErrorCode>(response);\n      }\n\n      return response;\n    }\n\n    return {\n      route,\n      store: (args) => {\n        const { path, query } = args ?? {};\n\n        const key = getCacheKey(route.method, route.path, {\n          pathParams: path,\n          queryParams: query,\n        });\n\n        const store = this.#createFetcherStore<\n          StandardSchemaV1.InferOutput<TOutputSchema>,\n          FragnoClientError<TErrorCode>\n        >(key, {\n          fetcher: async (): Promise<StandardSchemaV1.InferOutput<TOutputSchema>> => {\n            if (SSR_ENABLED) {\n              const initialData = getInitialData(\n                key.map((d) => (typeof d === \"string\" ? d : d.get())).join(\"\"),\n              );\n\n              if (initialData) {\n                return initialData;\n              }\n            }\n\n            const response = await executeQuery({ pathParams: path, queryParams: query });\n            const isStreaming = isStreamingResponse(response);\n\n            if (!isStreaming) {\n              return response.json() as Promise<StandardSchemaV1.InferOutput<TOutputSchema>>;\n            }\n\n            if (typeof window === \"undefined\") {\n              return [];\n            }\n\n            if (isStreaming === \"ndjson\") {\n              const storeAdapter: NdjsonStreamingStore<TOutputSchema, TErrorCode> = {\n                setData: (value) => {\n                  store.set({\n                    ...store.get(),\n                    loading: !(Array.isArray(value) && value.length > 0),\n                    data: value as InferOr<TOutputSchema, undefined>,\n                  });\n                },\n                setError: (value) => {\n                  store.set({\n                    ...store.get(),\n                    error: value,\n                  });\n                },\n              };\n\n              // Start streaming in background and return first item\n              const { firstItem } = await handleNdjsonStreamingFirstItem(response, storeAdapter);\n              return [firstItem];\n            }\n\n            if (isStreaming === \"octet-stream\") {\n              // TODO(Wilco): Implement this\n              throw new Error(\"Octet-stream streaming is not supported.\");\n            }\n\n            throw new Error(\"Unreachable\");\n          },\n\n          onErrorRetry: options?.onErrorRetry,\n          dedupeTime: Infinity,\n        });\n\n        if (typeof window === \"undefined\") {\n          addStore(store);\n        }\n\n        return store;\n      },\n      query: async (args) => {\n        const { path, query } = args ?? {};\n\n        const response = await executeQuery({ pathParams: path, queryParams: query });\n\n        const isStreaming = isStreamingResponse(response);\n\n        if (!isStreaming) {\n          return (await response.json()) as StandardSchemaV1.InferOutput<TOutputSchema>;\n        }\n\n        if (isStreaming === \"ndjson\") {\n          const { streamingPromise } = await handleNdjsonStreamingFirstItem(response);\n          // Resolves once the stream is done\n          return await streamingPromise;\n        }\n\n        if (isStreaming === \"octet-stream\") {\n          // TODO(Wilco): Implement this\n          throw new Error(\"Octet-stream streaming is not supported.\");\n        }\n\n        throw new Error(\"Unreachable\");\n      },\n      [GET_HOOK_SYMBOL]: true,\n    };\n  }\n\n  #createRouteQueryMutator<\n    TPath extends string,\n    TInputSchema extends StandardSchemaV1 | undefined,\n    TOutputSchema extends StandardSchemaV1 | undefined,\n    TErrorCode extends string,\n    TQueryParameters extends string,\n  >(\n    route: FragnoRouteConfig<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >,\n    onInvalidate: OnInvalidateFn<TPath> = (invalidate, params) =>\n      invalidate(\"GET\", route.path, params),\n  ): FragnoClientMutatorData<\n    NonGetHTTPMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  > {\n    const method = route.method;\n\n    const baseUrl = this.#publicConfig.baseUrl ?? \"\";\n    const mountRoute = getMountRoute(this.#fragmentConfig);\n    const fetcher = this.#getFetcher();\n    const fetcherOptions = this.#getFetcherOptions();\n\n    async function executeMutateQuery({\n      body,\n      path,\n      query,\n    }: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: ExtractPathParamsOrWiden<TPath, string>;\n      query?: Record<string, string>;\n    }): Promise<Response> {\n      if (typeof window === \"undefined\") {\n        return task(async () =>\n          route.handler(\n            RequestInputContext.fromSSRContext({\n              inputSchema: route.inputSchema,\n              method,\n              path: route.path,\n              pathParams: (path ?? {}) as ExtractPathParams<TPath, string>,\n              searchParams: new URLSearchParams(query),\n              body,\n            }),\n            new RequestOutputContext(route.outputSchema),\n          ),\n        );\n      }\n\n      const url = buildUrl(\n        { baseUrl, mountRoute, path: route.path },\n        { pathParams: path, queryParams: query },\n      );\n\n      let response: Response;\n      try {\n        const requestOptions: RequestInit = {\n          ...fetcherOptions,\n          method,\n          body: body !== undefined ? JSON.stringify(body) : undefined,\n        };\n        response = await fetcher(url, requestOptions);\n      } catch (error) {\n        throw FragnoClientFetchError.fromUnknownFetchError(error);\n      }\n\n      if (!response.ok) {\n        throw await FragnoClientApiError.fromResponse<TErrorCode>(response);\n      }\n\n      return response;\n    }\n\n    const mutatorStore: FragnoClientMutatorData<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >[\"mutatorStore\"] = this.#createMutatorStore(\n      async ({ data }) => {\n        if (typeof window === \"undefined\") {\n          // TODO(Wilco): Handle server-side rendering.\n        }\n\n        const { body, path, query } = data as {\n          body?: InferOr<TInputSchema, undefined>;\n          path?: ExtractPathParamsOrWiden<TPath, string>;\n          query?: Record<string, string>;\n        };\n\n        if (typeof body === \"undefined\" && route.inputSchema !== undefined) {\n          throw new Error(\"Body is required.\");\n        }\n\n        const response = await executeMutateQuery({ body, path, query });\n\n        onInvalidate(this.#invalidate.bind(this), {\n          pathParams: (path ?? {}) as MaybeExtractPathParamsOrWiden<TPath, string>,\n          queryParams: query,\n        });\n\n        if (response.status === 201 || response.status === 204) {\n          return undefined;\n        }\n\n        const isStreaming = isStreamingResponse(response);\n\n        if (!isStreaming) {\n          return response.json();\n        }\n\n        if (typeof window === \"undefined\") {\n          return [];\n        }\n\n        if (isStreaming === \"ndjson\") {\n          const storeAdapter: NdjsonStreamingStore<NonNullable<TOutputSchema>, TErrorCode> = {\n            setData: (value) => {\n              mutatorStore.set({\n                ...mutatorStore.get(),\n                loading: !(Array.isArray(value) && value.length > 0),\n                data: value as InferOr<TOutputSchema, undefined>,\n              });\n            },\n            setError: (value) => {\n              mutatorStore.set({\n                ...mutatorStore.get(),\n                error: value,\n              });\n            },\n          };\n\n          // Start streaming in background and return first item\n          const { firstItem } = await handleNdjsonStreamingFirstItem(response, storeAdapter);\n\n          // Return the first item immediately. The streaming will continue in the background\n          return [firstItem];\n        }\n\n        if (isStreaming === \"octet-stream\") {\n          // TODO(Wilco): Implement this\n          throw new Error(\"Octet-stream streaming is not supported.\");\n        }\n\n        throw new Error(\"Unreachable\");\n      },\n      {\n        onError: (error) => {\n          console.error(\"Error in mutatorStore\", error);\n        },\n      },\n    );\n\n    const mutateQuery = (async (data) => {\n      // TypeScript infers the fields to not exist, even though they might\n      const { body, path, query } = data as {\n        body?: InferOr<TInputSchema, undefined>;\n        path?: ExtractPathParamsOrWiden<TPath, string>;\n        query?: Record<string, string>;\n      };\n\n      if (typeof body === \"undefined\" && route.inputSchema !== undefined) {\n        throw new Error(\"Body is required for mutateQuery\");\n      }\n\n      const response = await executeMutateQuery({ body, path, query });\n\n      if (response.status === 201 || response.status === 204) {\n        return undefined;\n      }\n\n      const isStreaming = isStreamingResponse(response);\n\n      if (!isStreaming) {\n        return response.json();\n      }\n\n      if (isStreaming === \"ndjson\") {\n        const { streamingPromise } = await handleNdjsonStreamingFirstItem(response);\n        // Resolves once the stream is done, i.e. we block until done\n        return await streamingPromise;\n      }\n\n      if (isStreaming === \"octet-stream\") {\n        throw new Error(\"Octet-stream streaming is not supported for mutations\");\n      }\n\n      throw new Error(\"Unreachable\");\n    }) satisfies FragnoClientMutatorData<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >[\"mutateQuery\"];\n\n    return {\n      route,\n      mutateQuery,\n      mutatorStore,\n      [MUTATOR_HOOK_SYMBOL]: true,\n    };\n  }\n\n  #invalidate<TPath extends string>(\n    method: HTTPMethod,\n    path: TPath,\n    params: {\n      pathParams?: MaybeExtractPathParamsOrWiden<TPath, string>;\n      queryParams?: Record<string, string>;\n    },\n  ) {\n    const prefixArray = getCacheKey(method, path, {\n      pathParams: params?.pathParams,\n      queryParams: params?.queryParams,\n    });\n\n    const prefix = prefixArray.map((k) => (typeof k === \"string\" ? k : k.get())).join(\"\");\n\n    this.#invalidateKeys((key) => key.startsWith(prefix));\n  }\n}\n\n/**\n * Create a client builder for fragments using the new fragment definition API.\n * This is the same as createClientBuilder but works with FragmentDefinition.\n */\nexport function createClientBuilder<\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  const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n>(\n  definition: FragmentDefinition<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage\n  >,\n  publicConfig: FragnoPublicClientConfig,\n  routesOrFactories: TRoutesOrFactories,\n  authorFetcherConfig?: FetcherConfig,\n): ClientBuilder<\n  FlattenRouteFactories<TRoutesOrFactories>,\n  FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>\n> {\n  // For client-side, we resolve route factories with dummy context\n  // This will be removed by the bundle plugin anyway\n  const dummyContext = {\n    config: {} as TConfig,\n    deps: {} as TDeps,\n    services: {} as TBaseServices & TServices,\n    serviceDeps: {},\n  };\n\n  const routes = resolveRouteFactories(dummyContext, routesOrFactories);\n\n  const fragmentConfig: FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>> = {\n    name: definition.name,\n    routes,\n  };\n\n  const mountRoute = publicConfig.mountRoute ?? `/${definition.name}`;\n  const mergedFetcherConfig = mergeFetcherConfigs(authorFetcherConfig, publicConfig.fetcherConfig);\n  const fullPublicConfig = {\n    ...publicConfig,\n    mountRoute,\n    fetcherConfig: mergedFetcherConfig,\n  };\n\n  return new ClientBuilder(fullPublicConfig, fragmentConfig);\n}\n\nexport * from \"./client-error\";\nexport type { FetcherConfig, FragnoPublicClientConfig } from \"../api/shared-types\";\nexport type { FragnoFragmentSharedConfig } from \"../api/fragment-instantiator\";\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":["result: Record<string, string>","#publicConfig","#fragmentConfig","#fetcherConfig","#cache","#createFetcherStore","#createMutatorStore","#invalidateKeys","#getFetcher","#getFetcherOptions","#createRouteQueryHook","#createRouteQueryMutator","response: Response","requestOptions: RequestInit & { duplex?: \"half\" }","mutatorStore: FragnoClientMutatorData<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >[\"mutatorStore\"]","#invalidate","fragmentConfig: FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>"],"sources":["../../src/client/client.ts"],"sourcesContent":["import { nanoquery, type FetcherStore, type MutatorStore } from \"@nanostores/query\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { computed, task, type ReadableAtom, type Store } from \"nanostores\";\nimport type {\n  FragnoRouteConfig,\n  HTTPMethod,\n  NonGetHTTPMethod,\n  RequestThisContext,\n  RouteContentType,\n} from \"../api/api\";\nimport {\n  buildPath,\n  extractPathParams,\n  type ExtractPathParams,\n  type ExtractPathParamsOrWiden,\n  type MaybeExtractPathParamsOrWiden,\n} from \"../api/internal/path\";\nimport { getMountRoute } from \"../api/internal/route\";\nimport { RequestInputContext } from \"../api/request-input-context\";\nimport { RequestOutputContext } from \"../api/request-output-context\";\nimport type {\n  FetcherConfig,\n  FragnoFragmentSharedConfig,\n  FragnoPublicClientConfig,\n  FragnoPublicConfig,\n} from \"../api/shared-types\";\nimport { FragnoClientApiError, FragnoClientError, FragnoClientFetchError } from \"./client-error\";\nimport type { InferOr } from \"../util/types-util\";\nimport { parseContentType } from \"../util/content-type\";\nimport {\n  handleNdjsonStreamingFirstItem,\n  type NdjsonStreamingStore,\n} from \"./internal/ndjson-streaming\";\nimport { addStore, getInitialData, SSR_ENABLED } from \"../util/ssr\";\nimport { unwrapObject } from \"../util/nanostores\";\nimport type { FragmentDefinition } from \"../api/fragment-definition-builder\";\nimport type { AnyFragnoInstantiatedFragment } from \"../api/fragment-instantiator\";\nimport {\n  type AnyRouteOrFactory,\n  type FlattenRouteFactories,\n  resolveRouteFactories,\n} from \"../api/route\";\nimport { mergeFetcherConfigs } from \"./internal/fetcher-merge\";\n\n/**\n * Symbols used to identify hook types\n */\nconst GET_HOOK_SYMBOL = Symbol(\"fragno-get-hook\");\nconst MUTATOR_HOOK_SYMBOL = Symbol(\"fragno-mutator-hook\");\nconst STORE_SYMBOL = Symbol(\"fragno-store\");\n\n/**\n * Check if a value contains files that should be sent as FormData.\n * @internal\n */\nfunction containsFiles(value: unknown): boolean {\n  if (value instanceof File || value instanceof Blob) {\n    return true;\n  }\n\n  if (value instanceof FormData) {\n    return true;\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    return Object.values(value).some(\n      (v) => v instanceof File || v instanceof Blob || v instanceof FormData,\n    );\n  }\n\n  return false;\n}\n\n/**\n * Convert an object containing files to FormData.\n * Handles nested File/Blob values by appending them directly.\n * Other values are JSON-stringified.\n * @internal\n */\nfunction toFormData(value: object): FormData {\n  const formData = new FormData();\n\n  for (const [key, val] of Object.entries(value)) {\n    if (val instanceof File) {\n      formData.append(key, val, val.name);\n    } else if (val instanceof Blob) {\n      formData.append(key, val);\n    } else if (val !== undefined && val !== null) {\n      // For non-file values, stringify if needed\n      formData.append(key, typeof val === \"string\" ? val : JSON.stringify(val));\n    }\n  }\n\n  return formData;\n}\n\n/**\n * Prepare request body and headers for sending.\n * Handles FormData (file uploads) vs JSON data.\n * @internal\n */\nfunction prepareRequestBody(\n  body: unknown,\n  contentType?: RouteContentType,\n): { body: BodyInit | undefined; headers?: HeadersInit } {\n  if (body === undefined) {\n    return { body: undefined };\n  }\n\n  if (contentType === \"application/octet-stream\") {\n    if (\n      body instanceof ReadableStream ||\n      body instanceof Blob ||\n      body instanceof File ||\n      body instanceof ArrayBuffer ||\n      body instanceof Uint8Array\n    ) {\n      return { body: body as BodyInit, headers: { \"Content-Type\": \"application/octet-stream\" } };\n    }\n\n    throw new Error(\n      \"Octet-stream routes only accept Blob, File, ArrayBuffer, Uint8Array, or ReadableStream bodies.\",\n    );\n  }\n\n  // If already FormData, send as-is (browser sets Content-Type with boundary)\n  if (body instanceof FormData) {\n    return { body };\n  }\n\n  // If body is directly a File or Blob, wrap it in FormData\n  if (body instanceof File) {\n    const formData = new FormData();\n    formData.append(\"file\", body, body.name);\n    return { body: formData };\n  }\n\n  if (body instanceof Blob) {\n    const formData = new FormData();\n    formData.append(\"file\", body);\n    return { body: formData };\n  }\n\n  // If object contains files, convert to FormData\n  if (typeof body === \"object\" && body !== null && containsFiles(body)) {\n    return { body: toFormData(body) };\n  }\n\n  // Otherwise, JSON-stringify\n  return {\n    body: JSON.stringify(body),\n    headers: { \"Content-Type\": \"application/json\" },\n  };\n}\n\n/**\n * Merge request headers from multiple sources.\n * Returns undefined if there are no headers to merge.\n * @internal\n */\nfunction mergeRequestHeaders(\n  ...headerSources: (HeadersInit | undefined)[]\n): Record<string, string> | undefined {\n  const result: Record<string, string> = {};\n  let hasHeaders = false;\n\n  for (const source of headerSources) {\n    if (!source) {\n      continue;\n    }\n\n    if (source instanceof Headers) {\n      for (const [key, value] of source.entries()) {\n        result[key] = value;\n        hasHeaders = true;\n      }\n    } else if (Array.isArray(source)) {\n      for (const [key, value] of source) {\n        result[key] = value;\n        hasHeaders = true;\n      }\n    } else {\n      for (const [key, value] of Object.entries(source)) {\n        result[key] = value;\n        hasHeaders = true;\n      }\n    }\n  }\n\n  return hasHeaders ? result : undefined;\n}\n\n/**\n * Extract only GET routes from a library config's routes array\n * @internal\n */\nexport type ExtractGetRoutes<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = {\n  [K in keyof T]: T[K] extends FragnoRouteConfig<\n    infer Method,\n    infer Path,\n    infer Input,\n    infer Output,\n    infer ErrorCode,\n    infer QueryParams\n  >\n    ? Method extends \"GET\"\n      ? FragnoRouteConfig<Method, Path, Input, Output, ErrorCode, QueryParams>\n      : never\n    : never;\n}[number][];\n\n/**\n * Extract the path from a route configuration for a given method\n * @internal\n */\nexport type ExtractRoutePath<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TExpectedMethod extends HTTPMethod = HTTPMethod,\n> = {\n  [K in keyof T]: T[K] extends FragnoRouteConfig<\n    infer Method,\n    infer Path,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >\n    ? Method extends TExpectedMethod\n      ? Path\n      : never\n    : never;\n}[number];\n\n/**\n * @internal\n */\nexport type ExtractGetRoutePaths<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = ExtractRoutePath<T, \"GET\">;\n\n/**\n * @internal\n */\nexport type ExtractNonGetRoutePaths<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = ExtractRoutePath<T, NonGetHTTPMethod>;\n\n/**\n * Extract the route configuration type(s) for a given path from a routes array.\n * Optionally narrow by HTTP method via the third type parameter.\n *\n * Defaults to extracting all methods for the matching path, producing a union\n * if multiple methods exist for the same path.\n * @internal\n */\nexport type ExtractRouteByPath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TPath extends string,\n  TMethod extends HTTPMethod = HTTPMethod,\n> = {\n  [K in keyof TRoutes]: TRoutes[K] extends FragnoRouteConfig<\n    infer M,\n    TPath,\n    infer Input,\n    infer Output,\n    infer ErrorCode,\n    infer QueryParams\n  >\n    ? M extends TMethod\n      ? FragnoRouteConfig<M, TPath, Input, Output, ErrorCode, QueryParams>\n      : never\n    : never;\n}[number];\n\n/**\n * Extract the output schema type for a specific route path from a routes array\n * @internal\n */\nexport type ExtractOutputSchemaForPath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined\n  >[],\n  TPath extends string,\n> = {\n  [K in keyof TRoutes]: TRoutes[K] extends FragnoRouteConfig<\n    infer Method,\n    TPath,\n    StandardSchemaV1 | undefined,\n    infer Output\n  >\n    ? Method extends \"GET\"\n      ? Output\n      : never\n    : never;\n}[number];\n\n/**\n * Check if a path exists as a GET route in the routes array\n * @internal\n */\nexport type IsValidGetRoutePath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TPath extends string,\n> = TPath extends ExtractGetRoutePaths<TRoutes> ? true : false;\n\n/**\n * Utility type to ensure only valid GET route paths can be used\n * @internal\n */\nexport type ValidateGetRoutePath<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TPath extends string,\n> =\n  TPath extends ExtractGetRoutePaths<TRoutes>\n    ? TPath\n    : `Error: Path '${TPath}' is not a valid GET route. Available GET routes: ${ExtractGetRoutePaths<TRoutes>}`;\n\n/**\n * Helper type to check if a routes array has any GET routes\n * @internal\n */\nexport type HasGetRoutes<\n  T extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> = ExtractGetRoutePaths<T> extends never ? false : true;\n\n/**\n * @internal\n */\nexport type ObjectContainingStoreField<T extends object> = T extends Store\n  ? T\n  : {\n        [K in keyof T]: T[K] extends Store ? { [P in K]: T[P] } & Partial<Omit<T, K>> : never;\n      }[keyof T] extends never\n    ? never\n    : T;\n\n/**\n * @internal\n */\nexport type FragnoStoreData<T extends object> = {\n  obj: T;\n  [STORE_SYMBOL]: true;\n};\n\nexport type FragnoClientHookData<\n  TMethod extends HTTPMethod,\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = {\n  route: FragnoRouteConfig<\n    TMethod,\n    TPath,\n    StandardSchemaV1 | undefined,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >;\n  query(args?: {\n    path?: MaybeExtractPathParamsOrWiden<TPath, string>;\n    query?: Record<TQueryParameters, string | undefined>;\n  }): Promise<StandardSchemaV1.InferOutput<TOutputSchema>>;\n  store(args?: {\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n    query?: Record<TQueryParameters, string | undefined | ReadableAtom<string | undefined>>;\n  }): FetcherStore<StandardSchemaV1.InferOutput<TOutputSchema>, FragnoClientError<TErrorCode>>;\n  [GET_HOOK_SYMBOL]: true;\n} & {\n  // Phantom field that preserves the specific TOutputSchema type parameter\n  // in the structural type. This makes the type covariant, allowing more\n  // specific schema types (like z.ZodString) to be assigned to variables\n  // typed with more general schema types (like StandardSchemaV1<any, any>)\n  readonly _outputSchema?: TOutputSchema;\n};\n\nexport type FragnoClientMutatorData<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = {\n  route: FragnoRouteConfig<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >;\n\n  mutateQuery(args?: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string>;\n    query?: Record<TQueryParameters, string | undefined>;\n  }): Promise<InferOr<TOutputSchema, undefined>>;\n\n  mutatorStore: MutatorStore<\n    {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n      query?: Record<TQueryParameters, string | undefined | ReadableAtom<string | undefined>>;\n    },\n    InferOr<TOutputSchema, undefined>,\n    FragnoClientError<TErrorCode>\n  >;\n  [MUTATOR_HOOK_SYMBOL]: true;\n} & {\n  readonly _inputSchema?: TInputSchema;\n  readonly _outputSchema?: TOutputSchema;\n};\n\n/**\n * @internal\n */\nexport function buildUrl<TPath extends string>(\n  config: {\n    baseUrl?: string;\n    mountRoute: string;\n    path: TPath;\n  },\n  params: {\n    pathParams?: Record<string, string | ReadableAtom<string>>;\n    queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n  },\n): string {\n  const { baseUrl = \"\", mountRoute, path } = config;\n  const { pathParams, queryParams } = params ?? {};\n\n  const normalizedPathParams = unwrapObject(pathParams) as ExtractPathParams<TPath, string>;\n  const normalizedQueryParams = unwrapObject(queryParams) ?? {};\n\n  // Filter out undefined values to prevent URLSearchParams from converting them to string \"undefined\"\n  const filteredQueryParams = Object.fromEntries(\n    Object.entries(normalizedQueryParams).filter(([_, value]) => value !== undefined),\n  ) as Record<string, string>;\n\n  const searchParams = new URLSearchParams(filteredQueryParams);\n  const builtPath = buildPath(path, normalizedPathParams ?? {});\n  const search = searchParams.toString() ? `?${searchParams.toString()}` : \"\";\n  return `${baseUrl}${mountRoute}${builtPath}${search}`;\n}\n\n/**\n * This method returns an array, which can be passed directly to nanostores.\n *\n * The returned array is always: path, pathParams (In order they appear in the path), queryParams (In alphabetical order)\n * Missing pathParams are replaced with \"<missing>\".\n * Atoms with undefined values are wrapped in computed atoms that map undefined to \"\" to avoid nanoquery treating the key as incomplete.\n * @param path\n * @param params\n * @returns\n * @internal\n */\nexport function getCacheKey<TMethod extends HTTPMethod, TPath extends string>(\n  method: TMethod,\n  path: TPath,\n  params?: {\n    pathParams?: Record<string, string | ReadableAtom<string>>;\n    queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n  },\n): (string | ReadableAtom<string>)[] {\n  if (!params) {\n    return [method, path];\n  }\n\n  const { pathParams, queryParams } = params;\n\n  const pathParamNames = extractPathParams(path);\n  const pathParamValues = pathParamNames.map((name) => pathParams?.[name] ?? \"<missing>\");\n\n  const queryParamValues = queryParams\n    ? Object.keys(queryParams)\n        .sort()\n        .map((key) => {\n          const value = queryParams[key];\n          // If it's an atom, wrap it to convert undefined to \"\"\n          if (value && typeof value === \"object\" && \"get\" in value) {\n            return computed(value as ReadableAtom<string | undefined>, (v) => v ?? \"\");\n          }\n          // Plain string value (or undefined)\n          return value ?? \"\";\n        })\n    : [];\n\n  return [method, path, ...pathParamValues, ...queryParamValues];\n}\n\nfunction isStreamingResponse(response: Response): false | \"ndjson\" | \"octet-stream\" {\n  const contentType = parseContentType(response.headers.get(\"content-type\"));\n\n  if (!contentType) {\n    // Always assume 'normal' JSON by default.\n    return false;\n  }\n\n  const isChunked = response.headers.get(\"transfer-encoding\") === \"chunked\";\n\n  if (!isChunked) {\n    return false;\n  }\n\n  if (contentType.subtype === \"octet-stream\") {\n    // TODO(Wilco): This is not actually supported properly\n    return \"octet-stream\";\n  }\n\n  if (contentType.subtype === \"x-ndjson\") {\n    return \"ndjson\";\n  }\n\n  return false;\n}\n\n// Type guard to check if a hook is a GET hook\n/**\n * @internal\n */\nexport function isGetHook<\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: unknown,\n): hook is FragnoClientHookData<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return (\n    typeof hook === \"object\" &&\n    hook !== null &&\n    GET_HOOK_SYMBOL in hook &&\n    hook[GET_HOOK_SYMBOL] === true\n  );\n}\n\n// Type guard to check if a hook is a mutator\n/**\n * @internal\n */\nexport function isMutatorHook<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: unknown,\n): hook is FragnoClientMutatorData<\n  TMethod,\n  TPath,\n  TInputSchema,\n  TOutputSchema,\n  TErrorCode,\n  TQueryParameters\n> {\n  return (\n    typeof hook === \"object\" &&\n    hook !== null &&\n    MUTATOR_HOOK_SYMBOL in hook &&\n    hook[MUTATOR_HOOK_SYMBOL] === true\n  );\n}\n\n/**\n * @internal\n */\nexport function isStore<TStore extends Store>(obj: unknown): obj is FragnoStoreData<TStore> {\n  return (\n    typeof obj === \"object\" && obj !== null && STORE_SYMBOL in obj && obj[STORE_SYMBOL] === true\n  );\n}\n\ntype OnErrorRetryFn = (opts: {\n  error: unknown;\n  key: string;\n  retryCount: number;\n}) => number | undefined;\n\nexport type CreateHookOptions = {\n  /**\n   * A function that will be called when an error occurs. Implements an exponential backoff strategy\n   * when left undefined. When null, retries will be disabled. The number returned (> 0) by the\n   * callback will determine in how many ms to retry next.\n   */\n  onErrorRetry?: OnErrorRetryFn | null;\n};\n\ntype OnInvalidateFn<TPath extends string> = (\n  invalidate: <TInnerPath extends string>(\n    method: HTTPMethod,\n    path: TInnerPath,\n    params: {\n      pathParams?: MaybeExtractPathParamsOrWiden<TInnerPath, string>;\n      queryParams?: Record<string, string>;\n    },\n  ) => void,\n  params: {\n    pathParams: MaybeExtractPathParamsOrWiden<TPath, string>;\n    queryParams?: Record<string, string>;\n  },\n) => void;\n\n/**\n * @internal\n */\nexport type CacheLine = {\n  data: unknown;\n  error: unknown;\n  retryCount: number;\n  created: number;\n  expires: number;\n};\n\nexport class ClientBuilder<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n  TFragmentConfig extends FragnoFragmentSharedConfig<TRoutes>,\n> {\n  #publicConfig: FragnoPublicClientConfig;\n  #fragmentConfig: TFragmentConfig;\n  #fetcherConfig?: FetcherConfig;\n\n  #cache = new Map<string, CacheLine>();\n\n  #createFetcherStore;\n  #createMutatorStore;\n  #invalidateKeys;\n\n  constructor(publicConfig: FragnoPublicClientConfig, fragmentConfig: TFragmentConfig) {\n    this.#publicConfig = publicConfig;\n    this.#fragmentConfig = fragmentConfig;\n    this.#fetcherConfig = publicConfig.fetcherConfig;\n\n    const [createFetcherStore, createMutatorStore, { invalidateKeys }] = nanoquery({\n      cache: this.#cache,\n    });\n    this.#createFetcherStore = createFetcherStore;\n    this.#createMutatorStore = createMutatorStore;\n    this.#invalidateKeys = invalidateKeys;\n  }\n\n  get cacheEntries(): Readonly<Record<string, CacheLine>> {\n    return Object.fromEntries(this.#cache.entries());\n  }\n\n  createStore<const T extends object>(obj: T): FragnoStoreData<T> {\n    return { obj: obj, [STORE_SYMBOL]: true };\n  }\n\n  /**\n   * Build a URL for a custom backend call using the configured baseUrl and mountRoute.\n   * Useful for fragment authors who need to make custom fetch calls.\n   */\n  buildUrl<TPath extends string>(\n    path: TPath,\n    params?: {\n      path?: MaybeExtractPathParamsOrWiden<TPath, string>;\n      query?: Record<string, string>;\n    },\n  ): string {\n    const baseUrl = this.#publicConfig.baseUrl ?? \"\";\n    const mountRoute = getMountRoute({\n      name: this.#fragmentConfig.name,\n      mountRoute: this.#publicConfig.mountRoute,\n    });\n\n    return buildUrl(\n      { baseUrl, mountRoute, path },\n      { pathParams: params?.path, queryParams: params?.query },\n    );\n  }\n\n  /**\n   * Get the configured fetcher function for custom backend calls.\n   * Returns fetch with merged options applied.\n   */\n  getFetcher(): {\n    fetcher: typeof fetch;\n    defaultOptions: RequestInit | undefined;\n  } {\n    return {\n      fetcher: this.#getFetcher(),\n      defaultOptions: this.#getFetcherOptions(),\n    };\n  }\n\n  #getFetcher(): typeof fetch {\n    if (this.#fetcherConfig?.type === \"function\") {\n      return this.#fetcherConfig.fetcher;\n    }\n    return fetch;\n  }\n\n  #getFetcherOptions(): RequestInit | undefined {\n    if (this.#fetcherConfig?.type === \"options\") {\n      return this.#fetcherConfig.options;\n    }\n    return undefined;\n  }\n\n  createHook<TPath extends ExtractGetRoutePaths<TFragmentConfig[\"routes\"]>>(\n    path: ValidateGetRoutePath<TFragmentConfig[\"routes\"], TPath>,\n    options?: CreateHookOptions,\n  ): FragnoClientHookData<\n    \"GET\",\n    TPath,\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath, \"GET\">[\"outputSchema\"]>,\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath, \"GET\">[\"errorCodes\"]>[number],\n    NonNullable<\n      ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath, \"GET\">[\"queryParameters\"]\n    >[number]\n  > {\n    const route = this.#fragmentConfig.routes.find(\n      (\n        r,\n      ): r is FragnoRouteConfig<\n        \"GET\",\n        TPath,\n        StandardSchemaV1 | undefined,\n        StandardSchemaV1,\n        string,\n        string\n      > => r.path === path && r.method === \"GET\" && r.outputSchema !== undefined,\n    );\n\n    if (!route) {\n      throw new Error(`Route '${path}' not found or is not a GET route with an output schema.`);\n    }\n\n    return this.#createRouteQueryHook(route, options);\n  }\n\n  createMutator<TPath extends ExtractNonGetRoutePaths<TFragmentConfig[\"routes\"]>>(\n    method: NonGetHTTPMethod,\n    path: TPath,\n    onInvalidate?: OnInvalidateFn<TPath>,\n  ): FragnoClientMutatorData<\n    NonGetHTTPMethod, // TODO: This can be any Method, but should be related to TPath\n    TPath,\n    ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"inputSchema\"],\n    ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"outputSchema\"],\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"errorCodes\"]>[number],\n    NonNullable<ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>[\"queryParameters\"]>[number]\n  > {\n    type TRoute = ExtractRouteByPath<TFragmentConfig[\"routes\"], TPath>;\n\n    const route = this.#fragmentConfig.routes.find(\n      (\n        r,\n      ): r is FragnoRouteConfig<\n        NonGetHTTPMethod,\n        TPath,\n        TRoute[\"inputSchema\"],\n        TRoute[\"outputSchema\"],\n        string,\n        string\n      > => r.method !== \"GET\" && r.path === path && r.method === method,\n    );\n\n    if (!route) {\n      throw new Error(\n        `Route '${path}' not found or is a GET route with an input and output schema.`,\n      );\n    }\n\n    return this.#createRouteQueryMutator(route, onInvalidate);\n  }\n\n  #createRouteQueryHook<\n    TPath extends string,\n    TInputSchema extends StandardSchemaV1 | undefined,\n    TOutputSchema extends StandardSchemaV1,\n    TErrorCode extends string,\n    TQueryParameters extends string,\n  >(\n    route: FragnoRouteConfig<\n      \"GET\",\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >,\n    options: CreateHookOptions = {},\n  ): FragnoClientHookData<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n    if (route.method !== \"GET\") {\n      throw new Error(\n        `Only GET routes are supported for hooks. Route '${route.path}' is a ${route.method} route.`,\n      );\n    }\n\n    if (!route.outputSchema) {\n      throw new Error(\n        `Output schema is required for GET routes. Route '${route.path}' has no output schema.`,\n      );\n    }\n\n    const baseUrl = this.#publicConfig.baseUrl ?? \"\";\n    const mountRoute = getMountRoute({\n      name: this.#fragmentConfig.name,\n      mountRoute: this.#publicConfig.mountRoute,\n    });\n    const fetcher = this.#getFetcher();\n    const fetcherOptions = this.#getFetcherOptions();\n\n    async function callServerSideHandler(params: {\n      pathParams?: Record<string, string | ReadableAtom<string>>;\n      queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n    }): Promise<Response> {\n      const { pathParams, queryParams } = params ?? {};\n\n      const normalizedPathParams = unwrapObject(pathParams) as ExtractPathParams<TPath, string>;\n      const normalizedQueryParams = unwrapObject(queryParams) ?? {};\n\n      // Filter out undefined values to prevent URLSearchParams from converting them to string \"undefined\"\n      const filteredQueryParams = Object.fromEntries(\n        Object.entries(normalizedQueryParams).filter(([_, value]) => value !== undefined),\n      ) as Record<string, string>;\n\n      const searchParams = new URLSearchParams(filteredQueryParams);\n\n      const result = await route.handler(\n        RequestInputContext.fromSSRContext({\n          method: route.method,\n          path: route.path,\n          pathParams: normalizedPathParams,\n          searchParams,\n        }),\n        new RequestOutputContext(route.outputSchema),\n      );\n\n      return result;\n    }\n\n    async function executeQuery(params?: {\n      pathParams?: Record<string, string | ReadableAtom<string>>;\n      queryParams?: Record<string, string | undefined | ReadableAtom<string | undefined>>;\n    }): Promise<Response> {\n      const { pathParams, queryParams } = params ?? {};\n\n      if (typeof window === \"undefined\") {\n        return task(async () => callServerSideHandler({ pathParams, queryParams }));\n      }\n\n      const url = buildUrl({ baseUrl, mountRoute, path: route.path }, { pathParams, queryParams });\n\n      let response: Response;\n      try {\n        response = fetcherOptions ? await fetcher(url, fetcherOptions) : await fetcher(url);\n      } catch (error) {\n        throw FragnoClientFetchError.fromUnknownFetchError(error);\n      }\n\n      if (!response.ok) {\n        throw await FragnoClientApiError.fromResponse<TErrorCode>(response);\n      }\n\n      return response;\n    }\n\n    return {\n      route,\n      store: (args) => {\n        const { path, query } = args ?? {};\n\n        const key = getCacheKey(route.method, route.path, {\n          pathParams: path,\n          queryParams: query,\n        });\n\n        const store = this.#createFetcherStore<\n          StandardSchemaV1.InferOutput<TOutputSchema>,\n          FragnoClientError<TErrorCode>\n        >(key, {\n          fetcher: async (): Promise<StandardSchemaV1.InferOutput<TOutputSchema>> => {\n            if (SSR_ENABLED) {\n              const initialData = getInitialData(\n                key.map((d) => (typeof d === \"string\" ? d : d.get())).join(\"\"),\n              );\n\n              if (initialData) {\n                return initialData;\n              }\n            }\n\n            const response = await executeQuery({ pathParams: path, queryParams: query });\n            const isStreaming = isStreamingResponse(response);\n\n            if (!isStreaming) {\n              return response.json() as Promise<StandardSchemaV1.InferOutput<TOutputSchema>>;\n            }\n\n            if (typeof window === \"undefined\") {\n              return [];\n            }\n\n            if (isStreaming === \"ndjson\") {\n              const storeAdapter: NdjsonStreamingStore<TOutputSchema, TErrorCode> = {\n                setData: (value) => {\n                  store.set({\n                    ...store.get(),\n                    loading: !(Array.isArray(value) && value.length > 0),\n                    data: value as InferOr<TOutputSchema, undefined>,\n                  });\n                },\n                setError: (value) => {\n                  store.set({\n                    ...store.get(),\n                    error: value,\n                  });\n                },\n              };\n\n              // Start streaming in background and return first item\n              const { firstItem } = await handleNdjsonStreamingFirstItem(response, storeAdapter);\n              return [firstItem];\n            }\n\n            if (isStreaming === \"octet-stream\") {\n              // TODO(Wilco): Implement this\n              throw new Error(\"Octet-stream streaming is not supported.\");\n            }\n\n            throw new Error(\"Unreachable\");\n          },\n\n          onErrorRetry: options?.onErrorRetry,\n          dedupeTime: Infinity,\n        });\n\n        if (typeof window === \"undefined\") {\n          addStore(store);\n        }\n\n        return store;\n      },\n      query: async (args) => {\n        const { path, query } = args ?? {};\n\n        const response = await executeQuery({ pathParams: path, queryParams: query });\n\n        const isStreaming = isStreamingResponse(response);\n\n        if (!isStreaming) {\n          return (await response.json()) as StandardSchemaV1.InferOutput<TOutputSchema>;\n        }\n\n        if (isStreaming === \"ndjson\") {\n          const { streamingPromise } = await handleNdjsonStreamingFirstItem(response);\n          // Resolves once the stream is done\n          return await streamingPromise;\n        }\n\n        if (isStreaming === \"octet-stream\") {\n          // TODO(Wilco): Implement this\n          throw new Error(\"Octet-stream streaming is not supported.\");\n        }\n\n        throw new Error(\"Unreachable\");\n      },\n      [GET_HOOK_SYMBOL]: true,\n    };\n  }\n\n  #createRouteQueryMutator<\n    TPath extends string,\n    TInputSchema extends StandardSchemaV1 | undefined,\n    TOutputSchema extends StandardSchemaV1 | undefined,\n    TErrorCode extends string,\n    TQueryParameters extends string,\n  >(\n    route: FragnoRouteConfig<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >,\n    onInvalidate: OnInvalidateFn<TPath> = (invalidate, params) =>\n      invalidate(\"GET\", route.path, params),\n  ): FragnoClientMutatorData<\n    NonGetHTTPMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  > {\n    const method = route.method;\n\n    const baseUrl = this.#publicConfig.baseUrl ?? \"\";\n    const mountRoute = getMountRoute({\n      name: this.#fragmentConfig.name,\n      mountRoute: this.#publicConfig.mountRoute,\n    });\n    const fetcher = this.#getFetcher();\n    const fetcherOptions = this.#getFetcherOptions();\n\n    async function executeMutateQuery({\n      body,\n      path,\n      query,\n    }: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: ExtractPathParamsOrWiden<TPath, string>;\n      query?: Record<string, string>;\n    }): Promise<Response> {\n      if (typeof window === \"undefined\") {\n        return task(async () =>\n          route.handler(\n            RequestInputContext.fromSSRContext({\n              inputSchema: route.inputSchema,\n              method,\n              path: route.path,\n              pathParams: (path ?? {}) as ExtractPathParams<TPath, string>,\n              searchParams: new URLSearchParams(query),\n              body,\n            }),\n            new RequestOutputContext(route.outputSchema),\n          ),\n        );\n      }\n\n      const url = buildUrl(\n        { baseUrl, mountRoute, path: route.path },\n        { pathParams: path, queryParams: query },\n      );\n\n      let response: Response;\n      try {\n        const { body: preparedBody, headers: bodyHeaders } = prepareRequestBody(\n          body,\n          route.contentType,\n        );\n\n        // Merge headers: fetcherOptions headers + body-specific headers (e.g., Content-Type for JSON)\n        // For FormData, bodyHeaders is undefined and browser sets Content-Type with boundary automatically\n        const mergedHeaders = mergeRequestHeaders(\n          fetcherOptions?.headers as HeadersInit | undefined,\n          bodyHeaders,\n        );\n\n        const requestOptions: RequestInit & { duplex?: \"half\" } = {\n          ...fetcherOptions,\n          method,\n          body: preparedBody,\n          ...(mergedHeaders ? { headers: mergedHeaders } : {}),\n        };\n        if (preparedBody instanceof ReadableStream) {\n          requestOptions.duplex = \"half\";\n        }\n        response = await fetcher(url, requestOptions);\n      } catch (error) {\n        throw FragnoClientFetchError.fromUnknownFetchError(error);\n      }\n\n      if (!response.ok) {\n        throw await FragnoClientApiError.fromResponse<TErrorCode>(response);\n      }\n\n      return response;\n    }\n\n    const mutatorStore: FragnoClientMutatorData<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >[\"mutatorStore\"] = this.#createMutatorStore(\n      async ({ data }) => {\n        if (typeof window === \"undefined\") {\n          // TODO(Wilco): Handle server-side rendering.\n        }\n\n        const { body, path, query } = data as {\n          body?: InferOr<TInputSchema, undefined>;\n          path?: ExtractPathParamsOrWiden<TPath, string>;\n          query?: Record<string, string>;\n        };\n\n        if (typeof body === \"undefined\" && route.inputSchema !== undefined) {\n          throw new Error(\"Body is required.\");\n        }\n\n        const response = await executeMutateQuery({ body, path, query });\n\n        onInvalidate(this.#invalidate.bind(this), {\n          pathParams: (path ?? {}) as MaybeExtractPathParamsOrWiden<TPath, string>,\n          queryParams: query,\n        });\n\n        if (response.status === 201 || response.status === 204) {\n          return undefined;\n        }\n\n        const isStreaming = isStreamingResponse(response);\n\n        if (!isStreaming) {\n          return response.json();\n        }\n\n        if (typeof window === \"undefined\") {\n          return [];\n        }\n\n        if (isStreaming === \"ndjson\") {\n          const storeAdapter: NdjsonStreamingStore<NonNullable<TOutputSchema>, TErrorCode> = {\n            setData: (value) => {\n              mutatorStore.set({\n                ...mutatorStore.get(),\n                loading: !(Array.isArray(value) && value.length > 0),\n                data: value as InferOr<TOutputSchema, undefined>,\n              });\n            },\n            setError: (value) => {\n              mutatorStore.set({\n                ...mutatorStore.get(),\n                error: value,\n              });\n            },\n          };\n\n          // Start streaming in background and return first item\n          const { firstItem } = await handleNdjsonStreamingFirstItem(response, storeAdapter);\n\n          // Return the first item immediately. The streaming will continue in the background\n          return [firstItem];\n        }\n\n        if (isStreaming === \"octet-stream\") {\n          // TODO(Wilco): Implement this\n          throw new Error(\"Octet-stream streaming is not supported.\");\n        }\n\n        throw new Error(\"Unreachable\");\n      },\n      {\n        onError: (error) => {\n          console.error(\"Error in mutatorStore\", error);\n        },\n      },\n    );\n\n    const mutateQuery = (async (data) => {\n      // TypeScript infers the fields to not exist, even though they might\n      const { body, path, query } = data as {\n        body?: InferOr<TInputSchema, undefined>;\n        path?: ExtractPathParamsOrWiden<TPath, string>;\n        query?: Record<string, string>;\n      };\n\n      if (typeof body === \"undefined\" && route.inputSchema !== undefined) {\n        throw new Error(\"Body is required for mutateQuery\");\n      }\n\n      const response = await executeMutateQuery({ body, path, query });\n\n      if (response.status === 201 || response.status === 204) {\n        return undefined;\n      }\n\n      const isStreaming = isStreamingResponse(response);\n\n      if (!isStreaming) {\n        return response.json();\n      }\n\n      if (isStreaming === \"ndjson\") {\n        const { streamingPromise } = await handleNdjsonStreamingFirstItem(response);\n        // Resolves once the stream is done, i.e. we block until done\n        return await streamingPromise;\n      }\n\n      if (isStreaming === \"octet-stream\") {\n        throw new Error(\"Octet-stream streaming is not supported for mutations\");\n      }\n\n      throw new Error(\"Unreachable\");\n    }) satisfies FragnoClientMutatorData<\n      NonGetHTTPMethod,\n      TPath,\n      TInputSchema,\n      TOutputSchema,\n      TErrorCode,\n      TQueryParameters\n    >[\"mutateQuery\"];\n\n    return {\n      route,\n      mutateQuery,\n      mutatorStore,\n      [MUTATOR_HOOK_SYMBOL]: true,\n    };\n  }\n\n  #invalidate<TPath extends string>(\n    method: HTTPMethod,\n    path: TPath,\n    params: {\n      pathParams?: MaybeExtractPathParamsOrWiden<TPath, string>;\n      queryParams?: Record<string, string>;\n    },\n  ) {\n    const prefixArray = getCacheKey(method, path, {\n      pathParams: params?.pathParams,\n      queryParams: params?.queryParams,\n    });\n\n    const prefix = prefixArray.map((k) => (typeof k === \"string\" ? k : k.get())).join(\"\");\n\n    this.#invalidateKeys((key) => key.startsWith(prefix));\n  }\n}\n\n/**\n * Create a client builder for fragments using the new fragment definition API.\n * This is the same as createClientBuilder but works with FragmentDefinition.\n */\nexport function createClientBuilder<\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  const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n>(\n  definition: FragmentDefinition<\n    TConfig,\n    TOptions,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  >,\n  publicConfig: FragnoPublicClientConfig,\n  routesOrFactories: TRoutesOrFactories,\n  authorFetcherConfig?: FetcherConfig,\n): ClientBuilder<\n  FlattenRouteFactories<TRoutesOrFactories>,\n  FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>\n> {\n  // For client-side, we resolve route factories with dummy context\n  // This will be removed by the bundle plugin anyway\n  const dummyContext = {\n    config: {} as TConfig,\n    deps: {} as TDeps,\n    services: {} as TBaseServices & TServices,\n    serviceDeps: {},\n  };\n\n  const routes = resolveRouteFactories(dummyContext, routesOrFactories);\n\n  const fragmentConfig: FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>> = {\n    name: definition.name,\n    routes,\n  };\n\n  const mountRoute = getMountRoute({\n    name: definition.name,\n    mountRoute: publicConfig.mountRoute,\n  });\n  const mergedFetcherConfig = mergeFetcherConfigs(authorFetcherConfig, publicConfig.fetcherConfig);\n  const fullPublicConfig = {\n    ...publicConfig,\n    mountRoute,\n    fetcherConfig: mergedFetcherConfig,\n  };\n\n  return new ClientBuilder(fullPublicConfig, fragmentConfig);\n}\n\nexport * from \"./client-error\";\nexport type { FetcherConfig, FragnoPublicClientConfig } from \"../api/shared-types\";\nexport type { FragnoFragmentSharedConfig } from \"../api/fragment-instantiator\";\n"],"mappings":"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"}

package/dist/client/vue.d.ts

@@ -2,7 +2,7 @@ import { MaybeExtractPathParamsOrWiden, QueryParamsHint } from "../api/internal/
 import { InferOr } from "../util/types-util.js";
 import { NonGetHTTPMethod } from "../api/api.js";
 import { FragnoClientError } from "./client-error.js";
-import { FragnoClientHookData, FragnoClientMutatorData } from "./client.js";
+import { FragnoClientHookData, FragnoClientMutatorData, FragnoStoreData } from "./client.js";
 import { ReadableAtom, Store, StoreValue } from "nanostores";
 import { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from "vue";
 import { StandardSchemaV1 } from "@standard-schema/spec";
@@ -26,6 +26,10 @@ type FragnoVueMutator<_TMethod extends NonGetHTTPMethod, TPath$1 extends string,
   error: Ref<FragnoClientError<TErrorCode$1[number]> | undefined>;
   data: Ref<InferOr<TOutputSchema$1, undefined>>;
 };
+/**
+ * Type helper that unwraps any Store fields of the object into StoreValues
+ */
+type FragnoVueStore<T extends object> = () => T extends Store<infer TStore> ? StoreValue<TStore> : { [K in keyof T]: T[K] extends Store ? StoreValue<T[K]> : T[K] };
 /**
  * Converts a Vue Ref to a NanoStore Atom.
  *
@@ -34,8 +38,8 @@ type FragnoVueMutator<_TMethod extends NonGetHTTPMethod, TPath$1 extends string,
  * @private
  */
 declare function refToAtom<T>(ref: Ref<T>): ReadableAtom<T>;
-declare function useFragno<T extends Record<string, unknown>>(clientObj: T): { [K in keyof T]: T[K] extends FragnoClientHookData<"GET", infer TPath, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVueHook<"GET", TPath, TOutputSchema, TErrorCode, TQueryParameters> : T[K] extends FragnoClientMutatorData<infer M, infer TPath, infer TInputSchema, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> : T[K] };
+declare function useFragno<T extends Record<string, unknown>>(clientObj: T): { [K in keyof T]: T[K] extends FragnoClientHookData<"GET", infer TPath, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVueHook<"GET", TPath, TOutputSchema, TErrorCode, TQueryParameters> : T[K] extends FragnoClientMutatorData<infer M, infer TPath, infer TInputSchema, infer TOutputSchema, infer TErrorCode, infer TQueryParameters> ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> : T[K] extends FragnoStoreData<infer TStoreObj> ? FragnoVueStore<TStoreObj> : T[K] };
 declare function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(store: SomeStore): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>>;
 //#endregion
-export { FragnoVueHook, FragnoVueMutator, refToAtom, useFragno, useStore };
+export { FragnoVueHook, FragnoVueMutator, FragnoVueStore, refToAtom, useFragno, useStore };
 //# sourceMappingURL=vue.d.ts.map

package/dist/client/vue.d.ts.map

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

package/dist/client/vue.js

@@ -1,4 +1,5 @@
-import { isGetHook, isMutatorHook } from "./client.js";
+import { isReadableAtom } from "../util/nanostores.js";
+import { isGetHook, isMutatorHook, isStore } from "./client.js";
 import { atom } from "nanostores";
 import { computed as computed$1, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from "vue";
 
@@ -80,6 +81,19 @@ function createVueMutator(hook) {
 		};
 	};
 }
+function createVueStore(hook) {
+	if (isReadableAtom(hook.obj)) return (() => useStore(hook.obj).value);
+	return (() => {
+		const result = {};
+		for (const key in hook.obj) {
+			if (!Object.prototype.hasOwnProperty.call(hook.obj, key)) continue;
+			const value = hook.obj[key];
+			if (isReadableAtom(value)) result[key] = useStore(value).value;
+			else result[key] = value;
+		}
+		return result;
+	});
+}
 function useFragno(clientObj) {
 	const result = {};
 	for (const key in clientObj) {
@@ -87,6 +101,7 @@ function useFragno(clientObj) {
 		const hook = clientObj[key];
 		if (isGetHook(hook)) result[key] = createVueHook(hook);
 		else if (isMutatorHook(hook)) result[key] = createVueMutator(hook);
+		else if (isStore(hook)) result[key] = createVueStore(hook);
 		else result[key] = hook;
 	}
 	return result;

package/dist/client/vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue.js","names":["ref","pathParams: Record<string, string | ReadableAtom<string>>","queryParams: Record<string, string | ReadableAtom<string>>","computed"],"sources":["../../src/client/vue.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { atom, type ReadableAtom, type Store, type StoreValue } from \"nanostores\";\nimport type { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from \"vue\";\nimport { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from \"vue\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  type FragnoClientMutatorData,\n  type FragnoClientHookData,\n} from \"./client\";\nimport type { FragnoClientError } from \"./client-error\";\nimport type { MaybeExtractPathParamsOrWiden, QueryParamsHint } from \"../api/internal/path\";\nimport type { InferOr } from \"../util/types-util\";\n\nexport type FragnoVueHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n  query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n}) => {\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n};\n\nexport type FragnoVueMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: (args: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n    query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean | undefined>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n};\n\n/**\n * Converts a Vue Ref to a NanoStore Atom.\n *\n * This is used to convert Vue refs to atoms, so that we can use them in the store.\n *\n * @private\n */\nexport function refToAtom<T>(ref: Ref<T>): ReadableAtom<T> {\n  const a = atom(ref.value);\n\n  watch(ref, (newVal) => {\n    a.set(newVal);\n  });\n\n  // TODO: Do we need to unsubscribe, or is this handled by `onScopeDispose` below?\n\n  return a;\n}\n\n// Helper function to create a Vue composable from a GET hook\n// We want 1 store per hook, so on updates to params, we need to update the store instead of creating a new one.\n// Nanostores only works with atoms (or strings), so we need to convert vue refs to atoms.\nfunction createVueHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoVueHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParams: Record<string, string | ReadableAtom<string>> = {};\n    const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n    for (const [key, value] of Object.entries(path ?? {})) {\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      pathParams[key] = isRef(v) ? refToAtom(v) : v;\n    }\n\n    for (const [key, value] of Object.entries(query ?? {})) {\n      // Dunno why the cast is necessary\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      queryParams[key] = isRef(v) ? (refToAtom(v) as ReadableAtom<string>) : v;\n    }\n\n    const store = hook.store({\n      path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n      query: queryParams,\n    });\n\n    const data = ref();\n    const loading = ref();\n    const error = ref();\n\n    const unsubscribe = store.subscribe((updatedStoreValue) => {\n      data.value = updatedStoreValue.data;\n      loading.value = updatedStoreValue.loading;\n      error.value = updatedStoreValue.error;\n    });\n\n    if (getCurrentScope()) {\n      onScopeDispose(() => {\n        unsubscribe();\n      });\n    }\n\n    return {\n      data,\n      loading,\n      error,\n    };\n  };\n}\n\n// Helper function to create a Vue mutator from a mutator hook\nfunction createVueMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoVueMutator<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return () => {\n    const store = useStore(hook.mutatorStore);\n\n    // Create a wrapped mutate function that handles Vue refs\n    const mutate = async (args: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n      query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n    }) => {\n      const { body, path, query } = args;\n\n      const pathParams: Record<string, string | ReadableAtom<string>> = {};\n      const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n      for (const [key, value] of Object.entries(path ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        pathParams[key] = isRef(v) ? v.value : v;\n      }\n\n      for (const [key, value] of Object.entries(query ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        queryParams[key] = isRef(v) ? v.value : v;\n      }\n\n      // Call the store's mutate function with normalized params\n      return store.value.mutate({\n        body,\n        path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n        query: queryParams,\n      });\n    };\n\n    // Return the store-like object with Vue reactive refs\n    return {\n      mutate,\n      loading: computed(() => store.value.loading),\n      error: computed(() => store.value.error),\n      data: computed(() => store.value.data) as Ref<InferOr<TOutputSchema, undefined>>,\n    };\n  };\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoVueHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer M,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>\n      : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any;\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createVueHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createVueMutator(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n\nexport function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(\n  store: SomeStore,\n): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>> {\n  const state = shallowRef();\n\n  const unsubscribe = store.subscribe((value) => {\n    state.value = value;\n  });\n\n  if (getCurrentScope()) {\n    onScopeDispose(unsubscribe);\n  }\n\n  return state;\n}\n"],"mappings":";;;;;;;;;;;;AAuDA,SAAgB,UAAa,OAA8B;CACzD,MAAM,IAAI,KAAKA,MAAI,MAAM;AAEzB,OAAMA,QAAM,WAAW;AACrB,IAAE,IAAI,OAAO;GACb;AAIF,QAAO;;AAMT,SAAS,cAOP,MAC4E;AAC5E,SAAQ,EAAE,MAAM,UAAU,EAAE,KAAK;EAC/B,MAAMC,aAA4D,EAAE;EACpE,MAAMC,cAA6D,EAAE;AAErE,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;GACrD,MAAM,IAAI;AACV,cAAW,OAAO,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG;;AAG9C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;GAEtD,MAAM,IAAI;AACV,eAAY,OAAO,MAAM,EAAE,GAAI,UAAU,EAAE,GAA4B;;EAGzE,MAAM,QAAQ,KAAK,MAAM;GACvB,MAAM;GACN,OAAO;GACR,CAAC;EAEF,MAAM,OAAO,KAAK;EAClB,MAAM,UAAU,KAAK;EACrB,MAAM,QAAQ,KAAK;EAEnB,MAAM,cAAc,MAAM,WAAW,sBAAsB;AACzD,QAAK,QAAQ,kBAAkB;AAC/B,WAAQ,QAAQ,kBAAkB;AAClC,SAAM,QAAQ,kBAAkB;IAChC;AAEF,MAAI,iBAAiB,CACnB,sBAAqB;AACnB,gBAAa;IACb;AAGJ,SAAO;GACL;GACA;GACA;GACD;;;AAKL,SAAS,iBAQP,MAQ6F;AAC7F,cAAa;EACX,MAAM,QAAQ,SAAS,KAAK,aAAa;EAGzC,MAAM,SAAS,OAAO,SAIhB;GACJ,MAAM,EAAE,MAAM,MAAM,UAAU;GAE9B,MAAMD,aAA4D,EAAE;GACpE,MAAMC,cAA6D,EAAE;AAErE,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE,CAAC,EAAE;IACrD,MAAM,IAAI;AACV,eAAW,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAGzC,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE,CAAC,EAAE;IACtD,MAAM,IAAI;AACV,gBAAY,OAAO,MAAM,EAAE,GAAG,EAAE,QAAQ;;AAI1C,UAAO,MAAM,MAAM,OAAO;IACxB;IACA,MAAM;IACN,OAAO;IACR,CAAC;;AAIJ,SAAO;GACL;GACA,SAASC,iBAAe,MAAM,MAAM,QAAQ;GAC5C,OAAOA,iBAAe,MAAM,MAAM,MAAM;GACxC,MAAMA,iBAAe,MAAM,MAAM,KAAK;GACvC;;;AAIL,SAAgB,UACd,WAoBA;CAEA,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,OAAO,WAAW;AAC3B,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,CACvD;EAGF,MAAM,OAAO,UAAU;AACvB,MAAI,UAAU,KAAK,CACjB,QAAO,OAAO,cAAc,KAAK;WACxB,cAAc,KAAK,CAC5B,QAAO,OAAO,iBAAiB,KAAK;MAGpC,QAAO,OAAO;;AAIlB,QAAO;;AAGT,SAAgB,SACd,OACmD;CACnD,MAAM,QAAQ,YAAY;CAE1B,MAAM,cAAc,MAAM,WAAW,UAAU;AAC7C,QAAM,QAAQ;GACd;AAEF,KAAI,iBAAiB,CACnB,gBAAe,YAAY;AAG7B,QAAO"}
+{"version":3,"file":"vue.js","names":["ref","pathParams: Record<string, string | ReadableAtom<string>>","queryParams: Record<string, string | ReadableAtom<string>>","computed","result: any"],"sources":["../../src/client/vue.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { atom, type ReadableAtom, type Store, type StoreValue } from \"nanostores\";\nimport type { DeepReadonly, Ref, ShallowRef, UnwrapNestedRefs } from \"vue\";\nimport { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from \"vue\";\nimport type { NonGetHTTPMethod } from \"../api/api\";\nimport {\n  isGetHook,\n  isMutatorHook,\n  isStore,\n  type FragnoClientMutatorData,\n  type FragnoClientHookData,\n  type FragnoStoreData,\n} from \"./client\";\nimport { isReadableAtom } from \"../util/nanostores\";\nimport type { FragnoClientError } from \"./client-error\";\nimport type { MaybeExtractPathParamsOrWiden, QueryParamsHint } from \"../api/internal/path\";\nimport type { InferOr } from \"../util/types-util\";\n\nexport type FragnoVueHook<\n  _TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = (args?: {\n  path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n  query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n}) => {\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n};\n\nexport type FragnoVueMutator<\n  _TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n> = () => {\n  mutate: (args: {\n    body?: InferOr<TInputSchema, undefined>;\n    path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n    query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n  }) => Promise<InferOr<TOutputSchema, undefined>>;\n  loading: Ref<boolean | undefined>;\n  error: Ref<FragnoClientError<TErrorCode[number]> | undefined>;\n  data: Ref<InferOr<TOutputSchema, undefined>>;\n};\n\n/**\n * Type helper that unwraps any Store fields of the object into StoreValues\n */\nexport type FragnoVueStore<T extends object> = () => T extends Store<infer TStore>\n  ? StoreValue<TStore>\n  : {\n      [K in keyof T]: T[K] extends Store ? StoreValue<T[K]> : T[K];\n    };\n\n/**\n * Converts a Vue Ref to a NanoStore Atom.\n *\n * This is used to convert Vue refs to atoms, so that we can use them in the store.\n *\n * @private\n */\nexport function refToAtom<T>(ref: Ref<T>): ReadableAtom<T> {\n  const a = atom(ref.value);\n\n  watch(ref, (newVal) => {\n    a.set(newVal);\n  });\n\n  // TODO: Do we need to unsubscribe, or is this handled by `onScopeDispose` below?\n\n  return a;\n}\n\n// Helper function to create a Vue composable from a GET hook\n// We want 1 store per hook, so on updates to params, we need to update the store instead of creating a new one.\n// Nanostores only works with atoms (or strings), so we need to convert vue refs to atoms.\nfunction createVueHook<\n  TMethod extends \"GET\",\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientHookData<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters>,\n): FragnoVueHook<TMethod, TPath, TOutputSchema, TErrorCode, TQueryParameters> {\n  return ({ path, query } = {}) => {\n    const pathParams: Record<string, string | ReadableAtom<string>> = {};\n    const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n    for (const [key, value] of Object.entries(path ?? {})) {\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      pathParams[key] = isRef(v) ? refToAtom(v) : v;\n    }\n\n    for (const [key, value] of Object.entries(query ?? {})) {\n      // Dunno why the cast is necessary\n      const v = value as string | Ref<string> | ReadableAtom<string>;\n      queryParams[key] = isRef(v) ? (refToAtom(v) as ReadableAtom<string>) : v;\n    }\n\n    const store = hook.store({\n      path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n      query: queryParams,\n    });\n\n    const data = ref();\n    const loading = ref();\n    const error = ref();\n\n    const unsubscribe = store.subscribe((updatedStoreValue) => {\n      data.value = updatedStoreValue.data;\n      loading.value = updatedStoreValue.loading;\n      error.value = updatedStoreValue.error;\n    });\n\n    if (getCurrentScope()) {\n      onScopeDispose(() => {\n        unsubscribe();\n      });\n    }\n\n    return {\n      data,\n      loading,\n      error,\n    };\n  };\n}\n\n// Helper function to create a Vue mutator from a mutator hook\nfunction createVueMutator<\n  TMethod extends NonGetHTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string,\n  TQueryParameters extends string,\n>(\n  hook: FragnoClientMutatorData<\n    TMethod,\n    TPath,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoVueMutator<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return () => {\n    const store = useStore(hook.mutatorStore);\n\n    // Create a wrapped mutate function that handles Vue refs\n    const mutate = async (args: {\n      body?: InferOr<TInputSchema, undefined>;\n      path?: MaybeExtractPathParamsOrWiden<TPath, string | Ref<string> | ReadableAtom<string>>;\n      query?: QueryParamsHint<TQueryParameters, string | Ref<string> | ReadableAtom<string>>;\n    }) => {\n      const { body, path, query } = args;\n\n      const pathParams: Record<string, string | ReadableAtom<string>> = {};\n      const queryParams: Record<string, string | ReadableAtom<string>> = {};\n\n      for (const [key, value] of Object.entries(path ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        pathParams[key] = isRef(v) ? v.value : v;\n      }\n\n      for (const [key, value] of Object.entries(query ?? {})) {\n        const v = value as string | Ref<string> | ReadableAtom<string>;\n        queryParams[key] = isRef(v) ? v.value : v;\n      }\n\n      // Call the store's mutate function with normalized params\n      return store.value.mutate({\n        body,\n        path: pathParams as MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>,\n        query: queryParams,\n      });\n    };\n\n    // Return the store-like object with Vue reactive refs\n    return {\n      mutate,\n      loading: computed(() => store.value.loading),\n      error: computed(() => store.value.error),\n      data: computed(() => store.value.data) as Ref<InferOr<TOutputSchema, undefined>>,\n    };\n  };\n}\n\n// Helper function to create a Vue composable from a store\nfunction createVueStore<const T extends object>(hook: FragnoStoreData<T>): FragnoVueStore<T> {\n  if (isReadableAtom(hook.obj)) {\n    return (() => useStore(hook.obj as Store).value) as FragnoVueStore<T>;\n  }\n\n  return (() => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const result: any = {};\n\n    for (const key in hook.obj) {\n      if (!Object.prototype.hasOwnProperty.call(hook.obj, key)) {\n        continue;\n      }\n\n      const value = hook.obj[key];\n      if (isReadableAtom(value)) {\n        result[key] = useStore(value).value;\n      } else {\n        result[key] = value;\n      }\n    }\n\n    return result;\n  }) as FragnoVueStore<T>;\n}\n\nexport function useFragno<T extends Record<string, unknown>>(\n  clientObj: T,\n): {\n  [K in keyof T]: T[K] extends FragnoClientHookData<\n    \"GET\",\n    infer TPath,\n    infer TOutputSchema,\n    infer TErrorCode,\n    infer TQueryParameters\n  >\n    ? FragnoVueHook<\"GET\", TPath, TOutputSchema, TErrorCode, TQueryParameters>\n    : T[K] extends FragnoClientMutatorData<\n          infer M,\n          infer TPath,\n          infer TInputSchema,\n          infer TOutputSchema,\n          infer TErrorCode,\n          infer TQueryParameters\n        >\n      ? FragnoVueMutator<M, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>\n      : T[K] extends FragnoStoreData<infer TStoreObj>\n        ? FragnoVueStore<TStoreObj>\n        : T[K];\n} {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result = {} as any;\n\n  for (const key in clientObj) {\n    if (!Object.prototype.hasOwnProperty.call(clientObj, key)) {\n      continue;\n    }\n\n    const hook = clientObj[key];\n    if (isGetHook(hook)) {\n      result[key] = createVueHook(hook);\n    } else if (isMutatorHook(hook)) {\n      result[key] = createVueMutator(hook);\n    } else if (isStore(hook)) {\n      result[key] = createVueStore(hook);\n    } else {\n      // Pass through non-hook values unchanged\n      result[key] = hook;\n    }\n  }\n\n  return result;\n}\n\nexport function useStore<SomeStore extends Store, Value extends StoreValue<SomeStore>>(\n  store: SomeStore,\n): DeepReadonly<UnwrapNestedRefs<ShallowRef<Value>>> {\n  const state = shallowRef();\n\n  const unsubscribe = store.subscribe((value) => {\n    state.value = value;\n  });\n\n  if (getCurrentScope()) {\n    onScopeDispose(unsubscribe);\n  }\n\n  return state;\n}\n"],"mappings":"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"}

package/dist/internal/trace-context.d.ts

@@ -0,0 +1,23 @@
+//#region src/internal/trace-context.d.ts
+type FragnoCoreTraceEvent = {
+  type: "route-input";
+  method: string;
+  path: string;
+  pathParams: Record<string, string>;
+  queryParams: [string, string][];
+  headers: [string, string][];
+  body: unknown;
+} | {
+  type: "middleware-decision";
+  method: string;
+  path: string;
+  outcome: "allow" | "deny";
+  status?: number;
+};
+type FragnoTraceRecorder = (event: FragnoCoreTraceEvent) => void;
+declare const runWithTraceRecorder: <T>(recorder: FragnoTraceRecorder, callback: () => T) => T;
+declare const getTraceRecorder: () => FragnoTraceRecorder | undefined;
+declare const recordTraceEvent: (event: FragnoCoreTraceEvent) => void;
+//#endregion
+export { FragnoCoreTraceEvent, FragnoTraceRecorder, getTraceRecorder, recordTraceEvent, runWithTraceRecorder };
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/internal/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","names":[],"sources":["../../src/internal/trace-context.ts"],"sourcesContent":[],"mappings":";KAEY,oBAAA;EAAA,IAAA,EAAA,aAAA;EAkBA,MAAA,EAAA,MAAA;EAIC,IAAA,EAAA,MAAA;EAAqC,UAAA,EAjBhC,MAiBgC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAqC,WAAA,EAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA;EAAI,OAAA,EAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA;EACrD,IAAA,EAAA,OAAA;AAEtC,CAAA,GAAa;EAEA,IAAA,EAAA,qBAKZ;;;;;;KAdW,mBAAA,WAA8B;cAI7B,oCAAqC,qCAAqC,MAAI;cAG9E,wBAAuB;cAEvB,0BAA2B"}

package/dist/internal/trace-context.js

@@ -0,0 +1,14 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/internal/trace-context.ts
+const traceStorage = new AsyncLocalStorage();
+const runWithTraceRecorder = (recorder, callback) => traceStorage.run(recorder, callback);
+const getTraceRecorder = () => traceStorage.getStore();
+const recordTraceEvent = (event) => {
+	const recorder = traceStorage.getStore();
+	if (recorder) recorder(event);
+};
+
+//#endregion
+export { getTraceRecorder, recordTraceEvent, runWithTraceRecorder };
+//# sourceMappingURL=trace-context.js.map

package/dist/internal/trace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.js","names":[],"sources":["../../src/internal/trace-context.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport type FragnoCoreTraceEvent =\n  | {\n      type: \"route-input\";\n      method: string;\n      path: string;\n      pathParams: Record<string, string>;\n      queryParams: [string, string][];\n      headers: [string, string][];\n      body: unknown;\n    }\n  | {\n      type: \"middleware-decision\";\n      method: string;\n      path: string;\n      outcome: \"allow\" | \"deny\";\n      status?: number;\n    };\n\nexport type FragnoTraceRecorder = (event: FragnoCoreTraceEvent) => void;\n\nconst traceStorage = new AsyncLocalStorage<FragnoTraceRecorder>();\n\nexport const runWithTraceRecorder = <T>(recorder: FragnoTraceRecorder, callback: () => T): T =>\n  traceStorage.run(recorder, callback);\n\nexport const getTraceRecorder = (): FragnoTraceRecorder | undefined => traceStorage.getStore();\n\nexport const recordTraceEvent = (event: FragnoCoreTraceEvent): void => {\n  const recorder = traceStorage.getStore();\n  if (recorder) {\n    recorder(event);\n  }\n};\n"],"mappings":";;;AAsBA,MAAM,eAAe,IAAI,mBAAwC;AAEjE,MAAa,wBAA2B,UAA+B,aACrE,aAAa,IAAI,UAAU,SAAS;AAEtC,MAAa,yBAA0D,aAAa,UAAU;AAE9F,MAAa,oBAAoB,UAAsC;CACrE,MAAM,WAAW,aAAa,UAAU;AACxC,KAAI,SACF,UAAS,MAAM"}

package/dist/mod-client.d.ts

@@ -5,25 +5,11 @@ import { RouteFactory, RouteFactoryContext, defineRoute, defineRoutes } from "./
 import { instantiatedFragmentFakeSymbol } from "./internal/symbols.js";
 import { FragmentInstantiationBuilder, FragnoInstantiatedFragment, IFragmentInstantiationBuilder, InstantiatedFragmentFromDefinition } from "./api/fragment-instantiator.js";
 import { FragmentDefinition, FragmentDefinitionBuilder, ServiceConstructorFn, ServiceContext } from "./api/fragment-definition-builder.js";
+import { FragnoRuntime, defaultFragnoRuntime } from "./runtime.js";
 
 //#region src/mod-client.d.ts
-declare function defineFragment(_name: string): {
-  withDependencies: () => /*elided*/any;
-  providesBaseService: () => /*elided*/any;
-  providesService: () => /*elided*/any;
-  providesPrivateService: () => /*elided*/any;
-  usesService: () => /*elided*/any;
-  usesOptionalService: () => /*elided*/any;
-  withRequestStorage: () => /*elided*/any;
-  withExternalRequestStorage: () => /*elided*/any;
-  withThisContext: () => /*elided*/any;
-  withLinkedFragment: () => /*elided*/any;
-  extend: () => /*elided*/any;
-  build: () => {
-    name: string;
-  };
-};
+declare function defineFragment(_name: string): object;
 declare function instantiate(_definition: unknown): IFragmentInstantiationBuilder;
 //#endregion
-export { type BoundServices, type FragmentDefinition, FragmentDefinitionBuilder, type FragmentInstantiationBuilder, type FragnoInstantiatedFragment, type FragnoPublicConfig, type FragnoRouteConfig, type InstantiatedFragmentFromDefinition, type RequestThisContext, type RouteFactory, type RouteFactoryContext, type ServiceConstructorFn, type ServiceContext, defineFragment, defineRoute, defineRoutes, instantiate, instantiatedFragmentFakeSymbol };
+export { type BoundServices, type FragmentDefinition, FragmentDefinitionBuilder, type FragmentInstantiationBuilder, type FragnoInstantiatedFragment, type FragnoPublicConfig, type FragnoRouteConfig, type FragnoRuntime, type InstantiatedFragmentFromDefinition, type RequestThisContext, type RouteFactory, type RouteFactoryContext, type ServiceConstructorFn, type ServiceContext, defaultFragnoRuntime, defineFragment, defineRoute, defineRoutes, instantiate, instantiatedFragmentFakeSymbol };
 //# sourceMappingURL=mod-client.d.ts.map

package/dist/mod-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod-client.d.ts","names":[],"sources":["../src/mod-client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAgCgB,cAAA;;;;;;EAAA,mBAAc,EAAA,GAAA,GAAA,UAAA,GAAA;EA2Bd,kBAAW,EAAA,GAAA,GAAqB,UAAA,GAAA;;;;;;;;;iBAAhC,WAAA,wBAAgC"}
+{"version":3,"file":"mod-client.d.ts","names":[],"sources":["../src/mod-client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAgCgB,cAAA;iBAyCA,WAAA,wBAAgC"}

package/dist/mod-client.js

@@ -1,11 +1,12 @@
 import { instantiatedFragmentFakeSymbol } from "./internal/symbols.js";
 import { FragmentDefinitionBuilder } from "./api/fragment-definition-builder.js";
+import { defaultFragnoRuntime } from "./runtime.js";
 import { defineRoute, defineRoutes } from "./api/route.js";
 
 //#region src/mod-client.ts
 function defineFragment(_name) {
 	const definitionStub = { name: _name };
-	const stub = {
+	const stub = new Proxy({
 		withDependencies: () => stub,
 		providesBaseService: () => stub,
 		providesService: () => stub,
@@ -17,12 +18,16 @@ function defineFragment(_name) {
 		withThisContext: () => stub,
 		withLinkedFragment: () => stub,
 		extend: () => stub,
-		build: () => definitionStub
-	};
+		build: () => definitionStub,
+		provideHooks: () => stub
+	}, { get(target, prop) {
+		if (prop in target) return target[prop];
+		return () => stub;
+	} });
 	return stub;
 }
 function instantiate(_definition) {
-	const fragmentStub = {
+	const fragmentStubMethods = {
 		[instantiatedFragmentFakeSymbol]: instantiatedFragmentFakeSymbol,
 		name: "",
 		routes: [],
@@ -35,9 +40,7 @@ function instantiate(_definition) {
 				linkedFragments: {}
 			};
 		},
-		withMiddleware: () => {
-			return fragmentStub;
-		},
+		withMiddleware: () => fragmentStub,
 		inContext: (callback) => callback(),
 		handlersFor: () => ({}),
 		handler: async () => new Response(),
@@ -48,7 +51,11 @@ function instantiate(_definition) {
 		}),
 		callRouteRaw: async () => new Response()
 	};
-	const builderStub = {
+	const fragmentStub = new Proxy(fragmentStubMethods, { get(target, prop) {
+		if (prop in target) return target[prop];
+		return () => fragmentStub;
+	} });
+	const builderStub = new Proxy({
 		withConfig: () => builderStub,
 		withRoutes: () => builderStub,
 		withOptions: () => builderStub,
@@ -58,10 +65,13 @@ function instantiate(_definition) {
 		routes: [],
 		config: void 0,
 		options: void 0
-	};
+	}, { get(target, prop) {
+		if (prop in target) return target[prop];
+		return () => builderStub;
+	} });
 	return builderStub;
 }
 
 //#endregion
-export { FragmentDefinitionBuilder, defineFragment, defineRoute, defineRoutes, instantiate, instantiatedFragmentFakeSymbol };
+export { FragmentDefinitionBuilder, defaultFragnoRuntime, defineFragment, defineRoute, defineRoutes, instantiate, instantiatedFragmentFakeSymbol };
 //# sourceMappingURL=mod-client.js.map

package/dist/mod-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod-client.js","names":["fragmentStub: IFragnoInstantiatedFragment","builderStub: IFragmentInstantiationBuilder"],"sources":["../src/mod-client.ts"],"sourcesContent":["// ============================================================================\n// Client-side entry point for @fragno-dev/core\n// This file mirrors mod.ts but provides stub implementations for server-side\n// APIs that are stripped by unplugin-fragno during browser builds.\n// ============================================================================\n\n// ============================================================================\n// Fragment Definition and Instantiation\n// ============================================================================\n\n// Re-export types only\nexport type {\n  FragmentDefinition,\n  ServiceContext,\n  ServiceConstructorFn,\n} from \"./api/fragment-definition-builder\";\n\nexport type {\n  FragmentInstantiationBuilder,\n  FragnoInstantiatedFragment,\n  BoundServices,\n  InstantiatedFragmentFromDefinition,\n} from \"./api/fragment-instantiator\";\n\nimport type {\n  IFragmentInstantiationBuilder,\n  IFragnoInstantiatedFragment,\n} from \"./api/fragment-instantiator\";\nimport { instantiatedFragmentFakeSymbol } from \"./internal/symbols\";\n\n// Stub implementation for defineFragment\n// This is stripped by unplugin-fragno in browser builds\nexport function defineFragment(_name: string) {\n  const definitionStub = {\n    name: _name,\n  };\n\n  const stub = {\n    withDependencies: () => stub,\n    providesBaseService: () => stub,\n    providesService: () => stub,\n    providesPrivateService: () => stub,\n    usesService: () => stub,\n    usesOptionalService: () => stub,\n    withRequestStorage: () => stub,\n    withExternalRequestStorage: () => stub,\n    withThisContext: () => stub,\n    withLinkedFragment: () => stub,\n    extend: () => stub,\n    build: () => definitionStub,\n  };\n  return stub;\n}\n\n// Re-export the builder class (for type compatibility)\nexport { FragmentDefinitionBuilder } from \"./api/fragment-definition-builder\";\n\n// Stub implementation for instantiate\n// This is stripped by unplugin-fragno in browser builds\nexport function instantiate(_definition: unknown) {\n  const fragmentStub: IFragnoInstantiatedFragment = {\n    [instantiatedFragmentFakeSymbol]: instantiatedFragmentFakeSymbol,\n    name: \"\",\n    routes: [],\n    services: {},\n    mountRoute: \"\",\n    get $internal() {\n      return {\n        deps: {},\n        options: {},\n        linkedFragments: {},\n      };\n    },\n    withMiddleware: () => {\n      // throw new Error(\"withMiddleware is not supported in browser builds\");\n      return fragmentStub;\n    },\n    inContext: <T>(callback: () => T) => callback(),\n    handlersFor: () => ({}),\n    handler: async () => new Response(),\n    callRoute: async () => ({ ok: true, data: undefined, error: undefined }),\n    callRouteRaw: async () => new Response(),\n  };\n\n  const builderStub: IFragmentInstantiationBuilder = {\n    withConfig: () => builderStub,\n    withRoutes: () => builderStub,\n    withOptions: () => builderStub,\n    withServices: () => builderStub,\n    build: () => fragmentStub,\n    definition: {},\n    routes: [],\n    config: undefined,\n    options: undefined,\n  };\n\n  return builderStub;\n}\n\n// ============================================================================\n// Core Configuration\n// ============================================================================\nexport type { FragnoPublicConfig } from \"./api/shared-types\";\n\n// ============================================================================\n// Route Definition\n// ============================================================================\nexport {\n  defineRoute,\n  defineRoutes,\n  type RouteFactory,\n  type RouteFactoryContext,\n} from \"./api/route\";\n\nexport type { FragnoRouteConfig, RequestThisContext } from \"./api/api\";\n\nexport { instantiatedFragmentFakeSymbol } from \"./internal/symbols\";\n"],"mappings":";;;;;AAgCA,SAAgB,eAAe,OAAe;CAC5C,MAAM,iBAAiB,EACrB,MAAM,OACP;CAED,MAAM,OAAO;EACX,wBAAwB;EACxB,2BAA2B;EAC3B,uBAAuB;EACvB,8BAA8B;EAC9B,mBAAmB;EACnB,2BAA2B;EAC3B,0BAA0B;EAC1B,kCAAkC;EAClC,uBAAuB;EACvB,0BAA0B;EAC1B,cAAc;EACd,aAAa;EACd;AACD,QAAO;;AAQT,SAAgB,YAAY,aAAsB;CAChD,MAAMA,eAA4C;GAC/C,iCAAiC;EAClC,MAAM;EACN,QAAQ,EAAE;EACV,UAAU,EAAE;EACZ,YAAY;EACZ,IAAI,YAAY;AACd,UAAO;IACL,MAAM,EAAE;IACR,SAAS,EAAE;IACX,iBAAiB,EAAE;IACpB;;EAEH,sBAAsB;AAEpB,UAAO;;EAET,YAAe,aAAsB,UAAU;EAC/C,oBAAoB,EAAE;EACtB,SAAS,YAAY,IAAI,UAAU;EACnC,WAAW,aAAa;GAAE,IAAI;GAAM,MAAM;GAAW,OAAO;GAAW;EACvE,cAAc,YAAY,IAAI,UAAU;EACzC;CAED,MAAMC,cAA6C;EACjD,kBAAkB;EAClB,kBAAkB;EAClB,mBAAmB;EACnB,oBAAoB;EACpB,aAAa;EACb,YAAY,EAAE;EACd,QAAQ,EAAE;EACV,QAAQ;EACR,SAAS;EACV;AAED,QAAO"}
+{"version":3,"file":"mod-client.js","names":["stub: object","fragmentStub: IFragnoInstantiatedFragment","builderStub: IFragmentInstantiationBuilder"],"sources":["../src/mod-client.ts"],"sourcesContent":["// ============================================================================\n// Client-side entry point for @fragno-dev/core\n// This file mirrors mod.ts but provides stub implementations for server-side\n// APIs that are stripped by unplugin-fragno during browser builds.\n// ============================================================================\n\n// ============================================================================\n// Fragment Definition and Instantiation\n// ============================================================================\n\n// Re-export types only\nexport type {\n  FragmentDefinition,\n  ServiceContext,\n  ServiceConstructorFn,\n} from \"./api/fragment-definition-builder\";\n\nexport type {\n  FragmentInstantiationBuilder,\n  FragnoInstantiatedFragment,\n  BoundServices,\n  InstantiatedFragmentFromDefinition,\n} from \"./api/fragment-instantiator\";\n\nimport type {\n  IFragmentInstantiationBuilder,\n  IFragnoInstantiatedFragment,\n} from \"./api/fragment-instantiator\";\nimport { instantiatedFragmentFakeSymbol } from \"./internal/symbols\";\n\n// Stub implementation for defineFragment\n// This is stripped by unplugin-fragno in browser builds\nexport function defineFragment(_name: string) {\n  const definitionStub = {\n    name: _name,\n  };\n\n  const stubMethods = {\n    withDependencies: () => stub,\n    providesBaseService: () => stub,\n    providesService: () => stub,\n    providesPrivateService: () => stub,\n    usesService: () => stub,\n    usesOptionalService: () => stub,\n    withRequestStorage: () => stub,\n    withExternalRequestStorage: () => stub,\n    withThisContext: () => stub,\n    withLinkedFragment: () => stub,\n    extend: () => stub,\n    build: () => definitionStub,\n    // From fragno-db\n    provideHooks: () => stub,\n  };\n\n  // Wrap with Proxy to handle any additional methods (e.g. from extend())\n  const stub: object = new Proxy(stubMethods, {\n    get(target, prop) {\n      if (prop in target) {\n        return target[prop as keyof typeof target];\n      }\n      // Return a function that returns the stub for method chaining\n      return () => stub;\n    },\n  });\n\n  return stub;\n}\n\n// Re-export the builder class (for type compatibility)\nexport { FragmentDefinitionBuilder } from \"./api/fragment-definition-builder\";\n\n// Stub implementation for instantiate\n// This is stripped by unplugin-fragno in browser builds\nexport function instantiate(_definition: unknown) {\n  const fragmentStubMethods = {\n    [instantiatedFragmentFakeSymbol]: instantiatedFragmentFakeSymbol,\n    name: \"\",\n    routes: [],\n    services: {},\n    mountRoute: \"\",\n    get $internal() {\n      return {\n        deps: {},\n        options: {},\n        linkedFragments: {},\n      };\n    },\n    withMiddleware: () => fragmentStub,\n    inContext: <T>(callback: () => T) => callback(),\n    handlersFor: () => ({}),\n    handler: async () => new Response(),\n    callRoute: async () => ({ ok: true, data: undefined, error: undefined }),\n    callRouteRaw: async () => new Response(),\n  };\n\n  // Wrap with Proxy to handle any additional methods\n  const fragmentStub: IFragnoInstantiatedFragment = new Proxy(\n    fragmentStubMethods as IFragnoInstantiatedFragment,\n    {\n      get(target, prop) {\n        if (prop in target) {\n          return target[prop as keyof typeof target];\n        }\n        // Return a function that returns the stub for method chaining\n        return () => fragmentStub;\n      },\n    },\n  );\n\n  const builderStubMethods = {\n    withConfig: () => builderStub,\n    withRoutes: () => builderStub,\n    withOptions: () => builderStub,\n    withServices: () => builderStub,\n    build: () => fragmentStub,\n    definition: {},\n    routes: [],\n    config: undefined,\n    options: undefined,\n  };\n\n  // Wrap with Proxy to handle any additional methods\n  const builderStub: IFragmentInstantiationBuilder = new Proxy(\n    builderStubMethods as IFragmentInstantiationBuilder,\n    {\n      get(target, prop) {\n        if (prop in target) {\n          return target[prop as keyof typeof target];\n        }\n        // Return a function that returns the stub for method chaining\n        return () => builderStub;\n      },\n    },\n  );\n\n  return builderStub;\n}\n\n// ============================================================================\n// Core Configuration\n// ============================================================================\nexport type { FragnoPublicConfig } from \"./api/shared-types\";\n\n// ============================================================================\n// Runtime\n// ============================================================================\nexport { defaultFragnoRuntime, type FragnoRuntime } from \"./runtime\";\n\n// ============================================================================\n// Route Definition\n// ============================================================================\nexport {\n  defineRoute,\n  defineRoutes,\n  type RouteFactory,\n  type RouteFactoryContext,\n} from \"./api/route\";\n\nexport type { FragnoRouteConfig, RequestThisContext } from \"./api/api\";\n\nexport { instantiatedFragmentFakeSymbol } from \"./internal/symbols\";\n"],"mappings":";;;;;;AAgCA,SAAgB,eAAe,OAAe;CAC5C,MAAM,iBAAiB,EACrB,MAAM,OACP;CAoBD,MAAMA,OAAe,IAAI,MAlBL;EAClB,wBAAwB;EACxB,2BAA2B;EAC3B,uBAAuB;EACvB,8BAA8B;EAC9B,mBAAmB;EACnB,2BAA2B;EAC3B,0BAA0B;EAC1B,kCAAkC;EAClC,uBAAuB;EACvB,0BAA0B;EAC1B,cAAc;EACd,aAAa;EAEb,oBAAoB;EACrB,EAG2C,EAC1C,IAAI,QAAQ,MAAM;AAChB,MAAI,QAAQ,OACV,QAAO,OAAO;AAGhB,eAAa;IAEhB,CAAC;AAEF,QAAO;;AAQT,SAAgB,YAAY,aAAsB;CAChD,MAAM,sBAAsB;GACzB,iCAAiC;EAClC,MAAM;EACN,QAAQ,EAAE;EACV,UAAU,EAAE;EACZ,YAAY;EACZ,IAAI,YAAY;AACd,UAAO;IACL,MAAM,EAAE;IACR,SAAS,EAAE;IACX,iBAAiB,EAAE;IACpB;;EAEH,sBAAsB;EACtB,YAAe,aAAsB,UAAU;EAC/C,oBAAoB,EAAE;EACtB,SAAS,YAAY,IAAI,UAAU;EACnC,WAAW,aAAa;GAAE,IAAI;GAAM,MAAM;GAAW,OAAO;GAAW;EACvE,cAAc,YAAY,IAAI,UAAU;EACzC;CAGD,MAAMC,eAA4C,IAAI,MACpD,qBACA,EACE,IAAI,QAAQ,MAAM;AAChB,MAAI,QAAQ,OACV,QAAO,OAAO;AAGhB,eAAa;IAEhB,CACF;CAeD,MAAMC,cAA6C,IAAI,MAb5B;EACzB,kBAAkB;EAClB,kBAAkB;EAClB,mBAAmB;EACnB,oBAAoB;EACpB,aAAa;EACb,YAAY,EAAE;EACd,QAAQ,EAAE;EACV,QAAQ;EACR,SAAS;EACV,EAKC,EACE,IAAI,QAAQ,MAAM;AAChB,MAAI,QAAQ,OACV,QAAO,OAAO;AAGhB,eAAa;IAEhB,CACF;AAED,QAAO"}

package/dist/mod.d.ts

@@ -1,7 +1,8 @@
 import { FragnoPublicConfig } from "./api/shared-types.js";
-import { FragnoRouteConfig, RequestThisContext } from "./api/api.js";
+import { FragnoRouteConfig, RequestThisContext, RouteContentType } from "./api/api.js";
 import { BoundServices } from "./api/bind-services.js";
 import { RouteFactory, RouteFactoryContext, defineRoute, defineRoutes } from "./api/route.js";
 import { AnyFragnoInstantiatedFragment, FragmentInstantiationBuilder, FragnoInstantiatedFragment, InstantiatedFragmentFromDefinition, instantiate } from "./api/fragment-instantiator.js";
 import { ExtractLinkedServices, FragmentDefinition, FragmentDefinitionBuilder, LinkedFragmentCallback, ServiceConstructorFn, ServiceContext, defineFragment } from "./api/fragment-definition-builder.js";
-export { type AnyFragnoInstantiatedFragment, type BoundServices, type ExtractLinkedServices, type FragmentDefinition, FragmentDefinitionBuilder, type FragmentInstantiationBuilder, type FragnoInstantiatedFragment, type FragnoPublicConfig, type FragnoRouteConfig, type InstantiatedFragmentFromDefinition, type LinkedFragmentCallback, type RequestThisContext, type RouteFactory, type RouteFactoryContext, type ServiceConstructorFn, type ServiceContext, defineFragment, defineRoute, defineRoutes, instantiate };
+import { FragnoRuntime, defaultFragnoRuntime } from "./runtime.js";
+export { type AnyFragnoInstantiatedFragment, type BoundServices, type ExtractLinkedServices, type FragmentDefinition, FragmentDefinitionBuilder, type FragmentInstantiationBuilder, type FragnoInstantiatedFragment, type FragnoPublicConfig, type FragnoRouteConfig, type FragnoRuntime, type InstantiatedFragmentFromDefinition, type LinkedFragmentCallback, type RequestThisContext, type RouteContentType, type RouteFactory, type RouteFactoryContext, type ServiceConstructorFn, type ServiceContext, defaultFragnoRuntime, defineFragment, defineRoute, defineRoutes, instantiate };

package/dist/mod.js

@@ -1,5 +1,6 @@
 import { FragmentDefinitionBuilder, defineFragment } from "./api/fragment-definition-builder.js";
+import { defaultFragnoRuntime } from "./runtime.js";
 import { defineRoute, defineRoutes } from "./api/route.js";
 import { instantiate } from "./api/fragment-instantiator.js";
 
-export { FragmentDefinitionBuilder, defineFragment, defineRoute, defineRoutes, instantiate };
+export { FragmentDefinitionBuilder, defaultFragnoRuntime, defineFragment, defineRoute, defineRoutes, instantiate };