@fragno-dev/core 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/.turbo/turbo-build.log +48 -44
  2. package/CHANGELOG.md +46 -0
  3. package/dist/api/api.d.ts +2 -2
  4. package/dist/api/fragment-builder.d.ts +3 -2
  5. package/dist/api/fragment-instantiation.d.ts +4 -3
  6. package/dist/api/fragment-instantiation.js +3 -3
  7. package/dist/api/route.d.ts +3 -0
  8. package/dist/api/route.js +3 -0
  9. package/dist/{api-B1-h7jPC.d.ts → api-CoCkNi6h.d.ts} +16 -2
  10. package/dist/api-CoCkNi6h.d.ts.map +1 -0
  11. package/dist/api-DngJDcmO.js.map +1 -1
  12. package/dist/client/client.d.ts +4 -3
  13. package/dist/client/client.js +3 -3
  14. package/dist/client/client.svelte.d.ts +3 -3
  15. package/dist/client/client.svelte.d.ts.map +1 -1
  16. package/dist/client/client.svelte.js +3 -3
  17. package/dist/client/react.d.ts +3 -3
  18. package/dist/client/react.d.ts.map +1 -1
  19. package/dist/client/react.js +3 -3
  20. package/dist/client/solid.d.ts +3 -3
  21. package/dist/client/solid.d.ts.map +1 -1
  22. package/dist/client/solid.js +3 -3
  23. package/dist/client/vanilla.d.ts +3 -3
  24. package/dist/client/vanilla.d.ts.map +1 -1
  25. package/dist/client/vanilla.js +3 -3
  26. package/dist/client/vue.d.ts +3 -3
  27. package/dist/client/vue.d.ts.map +1 -1
  28. package/dist/client/vue.js +3 -3
  29. package/dist/{client-YUZaNg5U.js → client-DJfCJiHK.js} +81 -7
  30. package/dist/client-DJfCJiHK.js.map +1 -0
  31. package/dist/{fragment-builder-DsqUOfJ5.d.ts → fragment-builder-8-tiECi5.d.ts} +73 -38
  32. package/dist/fragment-builder-8-tiECi5.d.ts.map +1 -0
  33. package/dist/{fragment-instantiation-Cp0K8zdS.js → fragment-instantiation-C4wvwl6V.js} +108 -3
  34. package/dist/fragment-instantiation-C4wvwl6V.js.map +1 -0
  35. package/dist/mod.d.ts +3 -2
  36. package/dist/mod.js +3 -3
  37. package/dist/{route-Dk1GyqHs.js → request-output-context-CdIjwmEN.js} +13 -24
  38. package/dist/request-output-context-CdIjwmEN.js.map +1 -0
  39. package/dist/route-C5Uryylh.js +21 -0
  40. package/dist/route-C5Uryylh.js.map +1 -0
  41. package/dist/route-mGLYSUvD.d.ts +26 -0
  42. package/dist/route-mGLYSUvD.d.ts.map +1 -0
  43. package/dist/test/test.d.ts +24 -70
  44. package/dist/test/test.d.ts.map +1 -1
  45. package/dist/test/test.js +27 -115
  46. package/dist/test/test.js.map +1 -1
  47. package/package.json +6 -1
  48. package/src/api/api.ts +1 -0
  49. package/src/api/fragment-instantiation.test.ts +460 -0
  50. package/src/api/fragment-instantiation.ts +121 -0
  51. package/src/api/fragno-response.ts +132 -0
  52. package/src/api/request-output-context.test.ts +10 -10
  53. package/src/api/request-output-context.ts +3 -3
  54. package/src/api/route-handler-input-options.ts +15 -0
  55. package/src/client/client.test.ts +264 -0
  56. package/src/client/client.ts +65 -3
  57. package/src/client/internal/fetcher-merge.ts +59 -0
  58. package/src/test/test.test.ts +110 -165
  59. package/src/test/test.ts +56 -266
  60. package/tsdown.config.ts +1 -0
  61. package/dist/api-B1-h7jPC.d.ts.map +0 -1
  62. package/dist/client-YUZaNg5U.js.map +0 -1
  63. package/dist/fragment-builder-DsqUOfJ5.d.ts.map +0 -1
  64. package/dist/fragment-instantiation-Cp0K8zdS.js.map +0 -1
  65. package/dist/route-CTxjMtGZ.js +0 -10
  66. package/dist/route-CTxjMtGZ.js.map +0 -1
  67. package/dist/route-Dk1GyqHs.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"vue.d.ts","names":[],"sources":["../../src/client/vue.ts"],"sourcesContent":[],"mappings":"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"}
1
+ {"version":3,"file":"vue.d.ts","names":[],"sources":["../../src/client/vue.ts"],"sourcesContent":[],"mappings":"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"}
@@ -1,7 +1,7 @@
1
1
  import "../api-DngJDcmO.js";
2
- import "../route-CTxjMtGZ.js";
3
- import "../route-Dk1GyqHs.js";
4
- import { a as isGetHook, o as isMutatorHook } from "../client-YUZaNg5U.js";
2
+ import "../request-output-context-CdIjwmEN.js";
3
+ import "../route-C5Uryylh.js";
4
+ import { a as isGetHook, o as isMutatorHook } from "../client-DJfCJiHK.js";
5
5
  import "../ssr-BByDVfFD.js";
6
6
  import { atom } from "nanostores";
7
7
  import { computed, getCurrentScope, isRef, onScopeDispose, ref, shallowRef, watch } from "vue";
@@ -1,5 +1,5 @@
1
- import { t as getMountRoute } from "./route-CTxjMtGZ.js";
2
- import { a as RequestOutputContext, o as RequestInputContext, r as resolveRouteFactories } from "./route-Dk1GyqHs.js";
1
+ import { i as getMountRoute, n as RequestOutputContext, r as RequestInputContext } from "./request-output-context-CdIjwmEN.js";
2
+ import { r as resolveRouteFactories } from "./route-C5Uryylh.js";
3
3
  import { a as getInitialData, n as addStore, t as SSR_ENABLED } from "./ssr-BByDVfFD.js";
4
4
  import { task } from "nanostores";
5
5
  import { nanoquery } from "@nanostores/query";
@@ -378,6 +378,40 @@ function isReadableAtom(value) {
378
378
  return true;
379
379
  }
380
380
 
381
+ //#endregion
382
+ //#region src/client/internal/fetcher-merge.ts
383
+ /**
384
+ * Merge two fetcher configurations, with user config taking precedence.
385
+ * If user provides a custom function, it takes full precedence.
386
+ * Otherwise, deep merge RequestInit options.
387
+ */
388
+ function mergeFetcherConfigs(authorConfig, userConfig) {
389
+ if (userConfig?.type === "function") return userConfig;
390
+ if (!userConfig && authorConfig?.type === "function") return authorConfig;
391
+ const authorOpts = authorConfig?.type === "options" ? authorConfig.options : {};
392
+ const userOpts = userConfig?.type === "options" ? userConfig.options : {};
393
+ if (Object.keys(authorOpts).length === 0 && Object.keys(userOpts).length === 0) return;
394
+ return {
395
+ type: "options",
396
+ options: {
397
+ ...authorOpts,
398
+ ...userOpts,
399
+ headers: mergeHeaders(authorOpts.headers, userOpts.headers)
400
+ }
401
+ };
402
+ }
403
+ /**
404
+ * Merge headers from author and user configs.
405
+ * User headers override author headers.
406
+ */
407
+ function mergeHeaders(author, user) {
408
+ if (!author && !user) return;
409
+ const merged = new Headers(author);
410
+ new Headers(user).forEach((value, key) => merged.set(key, value));
411
+ if (merged.keys().next().done) return;
412
+ return merged;
413
+ }
414
+
381
415
  //#endregion
382
416
  //#region src/client/client.ts
383
417
  /**
@@ -435,6 +469,7 @@ function isStore(obj) {
435
469
  var ClientBuilder = class {
436
470
  #publicConfig;
437
471
  #fragmentConfig;
472
+ #fetcherConfig;
438
473
  #cache = /* @__PURE__ */ new Map();
439
474
  #createFetcherStore;
440
475
  #createMutatorStore;
@@ -442,6 +477,7 @@ var ClientBuilder = class {
442
477
  constructor(publicConfig, fragmentConfig) {
443
478
  this.#publicConfig = publicConfig;
444
479
  this.#fragmentConfig = fragmentConfig;
480
+ this.#fetcherConfig = publicConfig.fetcherConfig;
445
481
  const [createFetcherStore, createMutatorStore, { invalidateKeys }] = nanoquery({ cache: this.#cache });
446
482
  this.#createFetcherStore = createFetcherStore;
447
483
  this.#createMutatorStore = createMutatorStore;
@@ -456,6 +492,37 @@ var ClientBuilder = class {
456
492
  [STORE_SYMBOL]: true
457
493
  };
458
494
  }
495
+ /**
496
+ * Build a URL for a custom backend call using the configured baseUrl and mountRoute.
497
+ * Useful for fragment authors who need to make custom fetch calls.
498
+ */
499
+ buildUrl(path, params) {
500
+ return buildUrl({
501
+ baseUrl: this.#publicConfig.baseUrl ?? "",
502
+ mountRoute: getMountRoute(this.#fragmentConfig),
503
+ path
504
+ }, {
505
+ pathParams: params?.path,
506
+ queryParams: params?.query
507
+ });
508
+ }
509
+ /**
510
+ * Get the configured fetcher function for custom backend calls.
511
+ * Returns fetch with merged options applied.
512
+ */
513
+ getFetcher() {
514
+ return {
515
+ fetcher: this.#getFetcher(),
516
+ defaultOptions: this.#getFetcherOptions()
517
+ };
518
+ }
519
+ #getFetcher() {
520
+ if (this.#fetcherConfig?.type === "function") return this.#fetcherConfig.fetcher;
521
+ return fetch;
522
+ }
523
+ #getFetcherOptions() {
524
+ if (this.#fetcherConfig?.type === "options") return this.#fetcherConfig.options;
525
+ }
459
526
  createHook(path, options) {
460
527
  const route = this.#fragmentConfig.routes.find((r) => r.path === path && r.method === "GET" && r.outputSchema !== void 0);
461
528
  if (!route) throw new Error(`Route '${path}' not found or is not a GET route with an output schema.`);
@@ -471,6 +538,8 @@ var ClientBuilder = class {
471
538
  if (!route.outputSchema) throw new Error(`Output schema is required for GET routes. Route '${route.path}' has no output schema.`);
472
539
  const baseUrl = this.#publicConfig.baseUrl ?? "";
473
540
  const mountRoute = getMountRoute(this.#fragmentConfig);
541
+ const fetcher = this.#getFetcher();
542
+ const fetcherOptions = this.#getFetcherOptions();
474
543
  async function callServerSideHandler(params) {
475
544
  const { pathParams, queryParams } = params ?? {};
476
545
  const normalizedPathParams = unwrapObject(pathParams);
@@ -499,7 +568,7 @@ var ClientBuilder = class {
499
568
  });
500
569
  let response;
501
570
  try {
502
- response = await fetch(url);
571
+ response = fetcherOptions ? await fetcher(url, fetcherOptions) : await fetcher(url);
503
572
  } catch (error) {
504
573
  throw FragnoClientFetchError.fromUnknownFetchError(error);
505
574
  }
@@ -576,6 +645,8 @@ var ClientBuilder = class {
576
645
  const method = route.method;
577
646
  const baseUrl = this.#publicConfig.baseUrl ?? "";
578
647
  const mountRoute = getMountRoute(this.#fragmentConfig);
648
+ const fetcher = this.#getFetcher();
649
+ const fetcherOptions = this.#getFetcherOptions();
579
650
  async function executeMutateQuery({ body, path, query }) {
580
651
  if (typeof window === "undefined") return task(async () => route.handler(RequestInputContext.fromSSRContext({
581
652
  inputSchema: route.inputSchema,
@@ -595,7 +666,8 @@ var ClientBuilder = class {
595
666
  });
596
667
  let response;
597
668
  try {
598
- response = await fetch(url, {
669
+ response = await fetcher(url, {
670
+ ...fetcherOptions,
599
671
  method,
600
672
  body: body !== void 0 ? JSON.stringify(body) : void 0
601
673
  });
@@ -678,7 +750,7 @@ var ClientBuilder = class {
678
750
  this.#invalidateKeys((key) => key.startsWith(prefix));
679
751
  }
680
752
  };
681
- function createClientBuilder(fragmentBuilder, publicConfig, routesOrFactories) {
753
+ function createClientBuilder(fragmentBuilder, publicConfig, routesOrFactories, authorFetcherConfig) {
682
754
  const definition = fragmentBuilder.definition;
683
755
  const routes = resolveRouteFactories({
684
756
  config: {},
@@ -690,12 +762,14 @@ function createClientBuilder(fragmentBuilder, publicConfig, routesOrFactories) {
690
762
  routes
691
763
  };
692
764
  const mountRoute = publicConfig.mountRoute ?? `/${definition.name}`;
765
+ const mergedFetcherConfig = mergeFetcherConfigs(authorFetcherConfig, publicConfig.fetcherConfig);
693
766
  return new ClientBuilder({
694
767
  ...publicConfig,
695
- mountRoute
768
+ mountRoute,
769
+ fetcherConfig: mergedFetcherConfig
696
770
  }, fragmentConfig);
697
771
  }
698
772
 
699
773
  //#endregion
700
774
  export { isGetHook as a, isReadableAtom as c, FragnoClientFetchAbortError as d, FragnoClientFetchError as f, getCacheKey as i, FragnoClientApiError as l, FragnoClientUnknownApiError as m, buildUrl as n, isMutatorHook as o, FragnoClientFetchNetworkError as p, createClientBuilder as r, isStore as s, ClientBuilder as t, FragnoClientError as u };
701
- //# sourceMappingURL=client-YUZaNg5U.js.map
775
+ //# sourceMappingURL=client-DJfCJiHK.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client-DJfCJiHK.js","names":["names: string[]","builtSegments: string[]","#code","#status","parameters: Record<string, string>","firstItem: StandardSchemaV1.InferOutput<TOutputSchema> | null","items: StandardSchemaV1.InferOutput<TOutputSchema>[]","lines","#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/api/internal/path.ts","../src/client/client-error.ts","../src/util/content-type.ts","../src/client/internal/ndjson-streaming.ts","../src/util/nanostores.ts","../src/client/internal/fetcher-merge.ts","../src/client/client.ts"],"sourcesContent":["// Helper type to split a string by '/'\ntype SplitPath<T extends string> = T extends `${infer First}/${infer Rest}`\n ? First extends \"\"\n ? SplitPath<Rest>\n : [First, ...SplitPath<Rest>]\n : T extends \"\"\n ? []\n : [T];\n\n// Helper type to extract parameter name from a single segment\ntype ExtractParam<T extends string> = T extends `:${infer Name}`\n ? Name\n : T extends `**:${infer Name}`\n ? Name\n : T extends \"**\"\n ? \"**\"\n : never;\n\n// Helper type to extract all parameter names from path segments\ntype ExtractParamsFromSegments<T extends readonly string[]> = T extends readonly [\n infer First,\n ...infer Rest,\n]\n ? First extends string\n ? Rest extends readonly string[]\n ? ExtractParam<First> | ExtractParamsFromSegments<Rest>\n : ExtractParam<First>\n : never\n : never;\n\n/**\n * Type helper to extract path parameters from a const string path\n *\n * Supports:\n * - Regular paths: \"/path\" -> never\n * - Named parameters: \"/path/:name\" -> \"name\"\n * - Wildcard paths: \"/path/foo/**\" -> \"**\"\n * - Named wildcard paths: \"/path/foo/**:name\" -> \"name\"\n * - String (narrows): string -> never\n */\nexport type ExtractPathParams<T extends string, ValueType = string> =\n ExtractParamsFromSegments<SplitPath<T>> extends never\n ? Record<string, never>\n : Record<ExtractParamsFromSegments<SplitPath<T>>, ValueType>;\n\n/**\n * Same as @see ExtractPathParams, but returns `Record<string, ValueType>` when a string is\n * passed in.\n */\nexport type ExtractPathParamsOrWiden<T extends string, ValueType = string> = string extends T\n ? Record<string, ValueType>\n : ExtractPathParams<T, ValueType>;\n\n// TODO: MaybeExtractPathParamsOrWiden<string> --> undefined, should that be Record<string, string>?\n/**\n * Same as @see ExtractPathParamsOrWiden, but returns `undefined` when no path parameters in the\n * const.\n */\nexport type MaybeExtractPathParamsOrWiden<T extends string, ValueType = string> =\n HasPathParams<T> extends true ? ExtractPathParamsOrWiden<T, ValueType> : undefined;\n\n// Alternative version that returns the parameter names as a union type\nexport type ExtractPathParamNames<T extends string> = ExtractParamsFromSegments<SplitPath<T>>;\n\n// Helper type to extract parameter names as an ordered tuple from path segments\ntype ExtractParamNamesAsTuple<T extends readonly string[]> = T extends readonly [\n infer First,\n ...infer Rest,\n]\n ? First extends string\n ? Rest extends readonly string[]\n ? ExtractParam<First> extends never\n ? ExtractParamNamesAsTuple<Rest>\n : [ExtractParam<First>, ...ExtractParamNamesAsTuple<Rest>]\n : ExtractParam<First> extends never\n ? []\n : [ExtractParam<First>]\n : []\n : [];\n\n// Type to convert ExtractPathParamNames result to a string tuple with the same number of elements\nexport type ExtractPathParamNamesAsTuple<T extends string> = ExtractParamNamesAsTuple<SplitPath<T>>;\n\n// Helper type to create labeled tuple from parameter names\ntype CreateLabeledTuple<T extends readonly string[], ElementType = string> = T extends readonly [\n infer First,\n ...infer Rest,\n]\n ? First extends string\n ? Rest extends readonly string[]\n ? [{ [K in First]: ElementType }[First], ...CreateLabeledTuple<Rest, ElementType>]\n : [{ [K in First]: ElementType }[First]]\n : []\n : [];\n\n// Type to convert path parameters to a labeled tuple\nexport type ExtractPathParamsAsLabeledTuple<\n T extends string,\n ElementType = string,\n> = CreateLabeledTuple<ExtractParamNamesAsTuple<SplitPath<T>>, ElementType>;\n\n// Type to check if a path has parameters\nexport type HasPathParams<T extends string> = ExtractPathParamNames<T> extends never ? false : true;\n\n/**\n * Creates a query parameters type where the specified keys are hints (optional)\n * and additional string keys are also allowed.\n *\n * This allows for flexible query parameter typing where:\n * - All hinted parameters are optional\n * - Additional parameters beyond the hints are allowed\n * - Values can be of any specified type (defaults to string)\n *\n * @example\n * ```ts\n * type MyQuery = QueryParamsHint<\"page\" | \"limit\", string>;\n * // Allows: { page?: string, limit?: string, [key: string]: string }\n *\n * const query1: MyQuery = {}; // Valid - no params required\n * const query2: MyQuery = { page: \"1\" }; // Valid - hinted param\n * const query3: MyQuery = { page: \"1\", sort: \"asc\" }; // Valid - additional param\n * ```\n */\nexport type QueryParamsHint<TQueryParameters extends string, ValueType = string> = Partial<\n Record<TQueryParameters, ValueType>\n> &\n Record<string, ValueType>;\n\n// Runtime utilities\n\n/**\n * Extract parameter names from a path pattern at runtime.\n * Examples:\n * - \"/users/:id\" => [\"id\"]\n * - \"/files/**\" => [\"**\"]\n * - \"/files/**:rest\" => [\"rest\"]\n */\nexport function extractPathParams<TPath extends string>(\n pathPattern: TPath,\n): ExtractPathParamNames<TPath>[] {\n const segments = pathPattern.split(\"/\").filter((s) => s.length > 0);\n const names: string[] = [];\n\n for (const segment of segments) {\n if (segment.startsWith(\":\")) {\n names.push(segment.slice(1));\n continue;\n }\n\n if (segment === \"**\") {\n names.push(\"**\");\n continue;\n }\n\n if (segment.startsWith(\"**:\")) {\n names.push(segment.slice(3));\n continue;\n }\n }\n\n return names as ExtractPathParamNames<TPath>[];\n}\n\n/**\n * Match an actual path against a path pattern and return extracted params.\n *\n * Notes and limitations:\n * - Named segment \":name\" captures a single path segment.\n * - Wildcard \"**\" or \"**:name\" greedily captures the remainder of the path and\n * should be placed at the end of the pattern.\n * - If the path does not match the pattern, an empty object is returned.\n */\nexport function matchPathParams<TPath extends string>(\n pathPattern: TPath,\n actualPath: string,\n): ExtractPathParams<TPath> {\n const patternSegments = pathPattern.split(\"/\").filter((s) => s.length > 0);\n const actualSegments = actualPath.split(\"/\").filter((s) => s.length > 0);\n\n const params: Record<string, string> = {};\n\n let i = 0;\n let j = 0;\n\n while (i < patternSegments.length && j < actualSegments.length) {\n const patternSegment = patternSegments[i];\n const actualSegment = actualSegments[j];\n\n if (patternSegment.startsWith(\":\")) {\n const name = patternSegment.slice(1);\n params[name] = decodeURIComponent(actualSegment);\n i += 1;\n j += 1;\n continue;\n }\n\n if (patternSegment === \"**\") {\n const remainder = actualSegments.slice(j).join(\"/\");\n params[\"**\"] = remainder ? decodeURIComponent(remainder) : \"\";\n // Wildcard consumes the rest; pattern should end here\n i = patternSegments.length;\n j = actualSegments.length;\n break;\n }\n\n if (patternSegment.startsWith(\"**:\")) {\n const name = patternSegment.slice(3);\n const remainder = actualSegments.slice(j).join(\"/\");\n params[name] = remainder ? decodeURIComponent(remainder) : \"\";\n // Wildcard consumes the rest; pattern should end here\n i = patternSegments.length;\n j = actualSegments.length;\n break;\n }\n\n // Literal segment must match exactly\n if (patternSegment === actualSegment) {\n i += 1;\n j += 1;\n continue;\n }\n\n // Mismatch\n return {} as ExtractPathParams<TPath>;\n }\n\n // If there are remaining pattern segments\n while (i < patternSegments.length) {\n const remaining = patternSegments[i];\n if (remaining === \"**\") {\n params[\"**\"] = \"\";\n i += 1;\n continue;\n }\n if (remaining.startsWith(\":\")) {\n const name = remaining.slice(1);\n params[name] = \"\";\n i += 1;\n continue;\n }\n if (remaining.startsWith(\"**:\")) {\n const name = remaining.slice(3);\n params[name] = \"\";\n i += 1;\n continue;\n }\n // Non-parameter remaining segment without corresponding actual segment → mismatch\n return {} as ExtractPathParams<TPath>;\n }\n\n // If there are remaining actual segments without pattern to match → mismatch\n if (j < actualSegments.length) {\n return {} as ExtractPathParams<TPath>;\n }\n\n return params as ExtractPathParams<TPath>;\n}\n\n/**\n * Build a concrete path by replacing placeholders in a path pattern with values.\n *\n * Supports the same placeholder syntax as the matcher:\n * - Named parameter \":name\" is URL-encoded as a single segment\n * - Anonymous wildcard \"**\" inserts the remainder as-is (slashes preserved)\n * - Named wildcard \"**:name\" inserts the remainder from the named key\n *\n * Examples:\n * - buildPath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n * - buildPath(\"/files/**\", { \"**\": \"a/b\" }) => \"/files/a/b\"\n * - buildPath(\"/files/**:rest\", { rest: \"a/b\" }) => \"/files/a/b\"\n */\nexport function buildPath<TPath extends string>(\n pathPattern: TPath,\n params: ExtractPathParams<TPath>,\n): string {\n const patternSegments = pathPattern.split(\"/\");\n\n const builtSegments: string[] = [];\n\n for (const segment of patternSegments) {\n if (segment.length === 0) {\n // Preserve leading/trailing/duplicate slashes\n builtSegments.push(\"\");\n continue;\n }\n\n if (segment.startsWith(\":\")) {\n const name = segment.slice(1);\n const value = (params as Record<string, string | undefined>)[name];\n if (value === undefined) {\n throw new Error(`Missing value for path parameter :${name}`);\n }\n builtSegments.push(encodeURIComponent(value));\n continue;\n }\n\n if (segment === \"**\") {\n const value = (params as Record<string, string | undefined>)[\"**\"];\n if (value === undefined) {\n throw new Error(\"Missing value for path wildcard **\");\n }\n builtSegments.push(value);\n continue;\n }\n\n if (segment.startsWith(\"**:\")) {\n const name = segment.slice(3);\n const value = (params as Record<string, string | undefined>)[name];\n if (value === undefined) {\n throw new Error(`Missing value for path wildcard **:${name}`);\n }\n builtSegments.push(value);\n continue;\n }\n\n // Literal segment\n builtSegments.push(segment);\n }\n\n // Join with '/'. Empty segments preserve leading/trailing slashes\n return builtSegments.join(\"/\");\n}\n","import type { StatusCode } from \"../http/http-status\";\n\nexport type FragnoErrorOptions = {\n cause?: Error | unknown;\n};\n\n/**\n * Base error class for all Fragno client errors.\n */\nexport abstract class FragnoClientError<TCode extends string = string> extends Error {\n readonly #code: TCode;\n\n constructor(message: string, code: TCode, options: FragnoErrorOptions = {}) {\n super(message, { cause: options.cause });\n this.name = \"FragnoClientError\";\n this.#code = code;\n }\n\n get code(): TCode | (string & {}) {\n return this.#code;\n }\n}\n\nexport class FragnoClientFetchError extends FragnoClientError<\n \"NO_BODY\" | \"NETWORK_ERROR\" | \"ABORT_ERROR\"\n> {\n constructor(\n message: string,\n code: \"NO_BODY\" | \"NETWORK_ERROR\" | \"ABORT_ERROR\",\n options: FragnoErrorOptions = {},\n ) {\n super(message, code, options);\n this.name = \"FragnoClientFetchError\";\n }\n\n static fromUnknownFetchError(error: unknown): FragnoClientFetchError {\n if (!(error instanceof Error)) {\n return new FragnoClientFetchNetworkError(\"Network request failed\", { cause: error });\n }\n\n if (error.name === \"AbortError\") {\n return new FragnoClientFetchAbortError(\"Request was aborted\", { cause: error });\n }\n\n return new FragnoClientFetchNetworkError(\"Network request failed\", { cause: error });\n }\n}\n\n/**\n * Error thrown when a network request fails (e.g., no internet connection, DNS failure).\n */\nexport class FragnoClientFetchNetworkError extends FragnoClientFetchError {\n constructor(message: string = \"Network request failed\", options: FragnoErrorOptions = {}) {\n super(message, \"NETWORK_ERROR\", options);\n this.name = \"FragnoClientFetchNetworkError\";\n }\n}\n\n/**\n * Error thrown when a request is aborted (e.g., user cancels request, timeout).\n */\nexport class FragnoClientFetchAbortError extends FragnoClientFetchError {\n constructor(message: string = \"Request was aborted\", options: FragnoErrorOptions = {}) {\n super(message, \"ABORT_ERROR\", options);\n this.name = \"FragnoClientFetchAbortError\";\n }\n}\n\n/**\n * Error thrown when the API result is unexpected, e.g. no json is returned.\n */\nexport class FragnoClientUnknownApiError extends FragnoClientError<\"UNKNOWN_API_ERROR\"> {\n readonly #status: StatusCode;\n\n constructor(\n message: string = \"Unknown API error\",\n status: StatusCode,\n options: FragnoErrorOptions = {},\n ) {\n super(message, \"UNKNOWN_API_ERROR\", options);\n this.name = \"FragnoClientUnknownApiError\";\n this.#status = status;\n }\n\n get status(): StatusCode {\n return this.#status;\n }\n}\n\nexport class FragnoClientApiError<\n TErrorCode extends string = string,\n> extends FragnoClientError<TErrorCode> {\n readonly #status: StatusCode;\n\n constructor(\n { message, code }: { message: string; code: TErrorCode },\n status: StatusCode,\n options: FragnoErrorOptions = {},\n ) {\n super(message, code, options);\n this.name = \"FragnoClientApiError\";\n this.#status = status;\n }\n\n get status(): StatusCode {\n return this.#status;\n }\n\n /**\n * The error code returned by the API.\n *\n * The type is `TErrorCode` (the set of known error codes for this route), but may also be a string\n * for forward compatibility with future error codes.\n */\n get code(): TErrorCode | (string & {}) {\n return super.code as TErrorCode | (string & {});\n }\n\n static async fromResponse<TErrorCode extends string = string>(\n response: Response,\n ): Promise<FragnoClientApiError<TErrorCode> | FragnoClientUnknownApiError> {\n const unknown = await response.json();\n const status = response.status as StatusCode;\n\n if (!(\"message\" in unknown || \"code\" in unknown)) {\n return new FragnoClientUnknownApiError(\"Unknown API error\", status);\n }\n\n if (!(typeof unknown.message === \"string\" && typeof unknown.code === \"string\")) {\n return new FragnoClientUnknownApiError(\"Unknown API error\", status);\n }\n\n return new FragnoClientApiError(\n {\n message: unknown.message,\n code: unknown.code as TErrorCode,\n },\n status,\n );\n }\n}\n","/**\n * Represents a parsed content-type header\n */\nexport interface ParsedContentType {\n /** The main type (e.g., \"application\", \"text\", \"image\") */\n type: string;\n /** The subtype (e.g., \"json\", \"html\", \"png\") */\n subtype: string;\n /** The full media type (e.g., \"application/json\") */\n mediaType: string;\n /** Additional parameters like charset, boundary, etc. */\n parameters: Record<string, string>;\n}\n\n/**\n * Parses a content-type header string into its components\n *\n * @param contentType - The content-type header value to parse\n * @returns A ParsedContentType object or null if the input is invalid\n *\n * @example\n * ```ts\n * const { type, subtype, mediaType, parameters }\n * = parseContentType(\"application/json; charset=utf-8\");\n * console.assert(type === \"application\");\n * console.assert(subtype === \"json\");\n * console.assert(mediaType === \"application/json\");\n * console.assert(parameters[\"charset\"] === \"utf-8\");\n */\nexport function parseContentType(contentType: string | null | undefined): ParsedContentType | null {\n if (!contentType || typeof contentType !== \"string\") {\n return null;\n }\n\n const trimmed = contentType.trim();\n if (!trimmed) {\n return null;\n }\n\n const parts = trimmed.split(\";\").map((part) => part.trim());\n const mediaType = parts[0];\n\n if (!mediaType) {\n return null;\n }\n\n const typeParts = mediaType.split(\"/\");\n if (typeParts.length !== 2) {\n return null;\n }\n\n const [type, subtype] = typeParts.map((part) => part.trim().toLowerCase());\n\n if (!type || !subtype) {\n return null;\n }\n\n const parameters: Record<string, string> = {};\n\n for (let i = 1; i < parts.length; i++) {\n const param = parts[i];\n const equalIndex = param.indexOf(\"=\");\n\n if (equalIndex > 0) {\n const key = param.slice(0, equalIndex).trim().toLowerCase();\n let value = param.slice(equalIndex + 1).trim();\n\n if (value.startsWith('\"') && value.endsWith('\"')) {\n value = value.slice(1, -1);\n }\n\n if (key) {\n parameters[key] = value;\n }\n }\n }\n\n return {\n type,\n subtype,\n mediaType: `${type}/${subtype}`,\n parameters,\n };\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport {\n FragnoClientError,\n FragnoClientFetchError,\n FragnoClientFetchAbortError,\n FragnoClientUnknownApiError,\n} from \"../client-error\";\n\n/**\n * Creates a promise that rejects when the abort signal is triggered\n */\nfunction createAbortPromise(abortSignal: AbortSignal): Promise<never> {\n return new Promise<never>((_, reject) => {\n const abortHandler = () => {\n reject(new FragnoClientFetchAbortError(\"Operation was aborted\"));\n };\n\n if (abortSignal.aborted) {\n abortHandler();\n } else {\n abortSignal.addEventListener(\"abort\", abortHandler, { once: true });\n }\n });\n}\n\n/**\n * Result of NDJSON streaming that includes the first item and a promise for the streaming continuation\n */\nexport interface NdjsonStreamingResult<T> {\n firstItem: T;\n streamingPromise: Promise<T[]>;\n}\n\nexport interface NdjsonStreamingStore<\n TOutputSchema extends StandardSchemaV1,\n TErrorCode extends string,\n> {\n setData(value: StandardSchemaV1.InferOutput<TOutputSchema>): void;\n setError(value: FragnoClientError<TErrorCode>): void;\n}\n\n/**\n * Handles NDJSON streaming responses by returning the first item from the fetcher\n * and then continuing to stream updates via the store's mutate method.\n *\n * This makes it so that we can wait until the first chunk before updating the store, if we did\n * not do this, `loading` would briefly be false before the first item would be populated in the\n * result.\n *\n * @param response - The fetch Response object containing the NDJSON stream\n * @param store - The fetcher store to update with streaming data\n * @param abortSignal - Optional AbortSignal to cancel the streaming operation\n * @returns A promise that resolves to an object containing the first item and a streaming promise\n */\nexport async function handleNdjsonStreamingFirstItem<\n TOutputSchema extends StandardSchemaV1,\n TErrorCode extends string,\n>(\n response: Response,\n store?: NdjsonStreamingStore<TOutputSchema, TErrorCode>,\n options: { abortSignal?: AbortSignal } = {},\n): Promise<NdjsonStreamingResult<StandardSchemaV1.InferOutput<TOutputSchema>>> {\n if (!response.body) {\n throw new FragnoClientFetchError(\"Streaming response has no body\", \"NO_BODY\");\n }\n\n const { abortSignal } = options;\n\n if (abortSignal?.aborted) {\n throw new FragnoClientFetchAbortError(\"Operation was aborted\");\n }\n\n const decoder = new TextDecoder();\n const reader = response.body.getReader();\n let buffer = \"\";\n let firstItem: StandardSchemaV1.InferOutput<TOutputSchema> | null = null;\n const items: StandardSchemaV1.InferOutput<TOutputSchema>[] = [];\n\n try {\n // Read until we get the first item\n while (firstItem === null) {\n // Check for abort signal before each read\n if (abortSignal?.aborted) {\n reader.releaseLock();\n throw new FragnoClientFetchAbortError(\"Operation was aborted\");\n }\n\n const { done, value } = await (abortSignal\n ? Promise.race([reader.read(), createAbortPromise(abortSignal)])\n : reader.read());\n\n if (done) {\n break;\n }\n\n // Decode the chunk and add to buffer\n buffer += decoder.decode(value, { stream: true });\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() || \"\"; // Keep incomplete line in buffer\n\n for (const line of lines) {\n if (!line.trim()) {\n continue;\n }\n\n try {\n const jsonObject = JSON.parse(line) as StandardSchemaV1.InferOutput<TOutputSchema>;\n items.push(jsonObject);\n\n if (firstItem === null) {\n firstItem = jsonObject;\n // We don't call store.setKey here for the first item\n // The caller will handle it via the return value\n\n // Start background streaming for remaining items and return the promise\n const streamingPromise = continueStreaming(\n reader,\n decoder,\n buffer,\n items,\n store,\n abortSignal,\n );\n return {\n firstItem,\n streamingPromise,\n };\n }\n } catch (parseError) {\n throw new FragnoClientUnknownApiError(\"Failed to parse NDJSON line\", 500, {\n cause: parseError,\n });\n }\n }\n }\n\n // If we get here and haven't returned a first item, the stream was empty\n if (firstItem === null) {\n reader.releaseLock();\n throw new FragnoClientUnknownApiError(\"NDJSON stream contained no valid items\", 500);\n }\n\n // This should never be reached, but TypeScript needs it\n reader.releaseLock();\n throw new FragnoClientFetchError(\"Unexpected end of stream processing\", \"NO_BODY\");\n } catch (error) {\n // Handle errors during streaming\n if (error instanceof FragnoClientError) {\n store?.setError(error);\n throw error;\n } else {\n // TODO: Not sure about the typing here\n const clientError = new FragnoClientUnknownApiError(\"Unknown streaming error\", 500, {\n cause: error,\n }) as unknown as FragnoClientError<TErrorCode>;\n store?.setError(clientError);\n throw clientError;\n }\n }\n}\n\n/**\n * Continues streaming the remaining items in the background\n */\n// FIXME: Shitty code\nasync function continueStreaming<TOutputSchema extends StandardSchemaV1, TErrorCode extends string>(\n reader: ReadableStreamDefaultReader<Uint8Array>,\n decoder: TextDecoder,\n initialBuffer: string,\n items: StandardSchemaV1.InferOutput<TOutputSchema>[],\n store?: NdjsonStreamingStore<TOutputSchema, TErrorCode>,\n abortSignal?: AbortSignal,\n): Promise<StandardSchemaV1.InferOutput<TOutputSchema>[]> {\n let buffer = initialBuffer;\n\n try {\n while (true) {\n // Check for abort signal before each read\n if (abortSignal?.aborted) {\n throw new FragnoClientFetchAbortError(\"Operation was aborted\");\n }\n\n const { done, value } = await (abortSignal\n ? Promise.race([reader.read(), createAbortPromise(abortSignal)])\n : reader.read());\n\n if (done) {\n // Process any remaining buffer content\n if (buffer.trim()) {\n const lines = buffer.split(\"\\n\");\n for (const line of lines) {\n if (!line.trim()) {\n continue;\n }\n\n try {\n const jsonObject = JSON.parse(line) as StandardSchemaV1.InferOutput<TOutputSchema>;\n items.push(jsonObject);\n store?.setData([...items]);\n } catch (parseError) {\n throw new FragnoClientUnknownApiError(\"Failed to parse NDJSON line\", 400, {\n cause: parseError,\n });\n }\n }\n }\n break;\n }\n\n // Decode the chunk and add to buffer\n buffer += decoder.decode(value, { stream: true });\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() || \"\"; // Keep incomplete line in buffer\n\n for (const line of lines) {\n if (!line.trim()) {\n continue;\n }\n\n try {\n const jsonObject = JSON.parse(line) as StandardSchemaV1.InferOutput<TOutputSchema>;\n items.push(jsonObject);\n store?.setData([...items]);\n } catch (parseError) {\n throw new FragnoClientUnknownApiError(\"Failed to parse NDJSON line\", 400, {\n cause: parseError,\n });\n }\n }\n }\n } catch (error) {\n if (error instanceof FragnoClientError) {\n store?.setError(error);\n } else {\n const clientError = new FragnoClientUnknownApiError(\"Unknown streaming error\", 400, {\n cause: error,\n }) as unknown as FragnoClientError<TErrorCode>;\n store?.setError(clientError);\n throw clientError;\n }\n\n throw error;\n } finally {\n reader.releaseLock();\n }\n\n return items;\n}\n","import type { ReadableAtom } from \"nanostores\";\n\ntype MaybeAtom<T> = T | ReadableAtom<T>;\n\n/**\n * Normalizes a value that could be a plain value, an Atom, or a Vue Ref to a plain value.\n */\nexport function unwrapAtom<T>(value: MaybeAtom<T>): T {\n // Check if it's an Atom (has .get method)\n if (value && typeof value === \"object\" && \"get\" in value && typeof value.get === \"function\") {\n return value.get();\n }\n\n return value as T;\n}\n\n/**\n * Normalizes an object where values can be plain values, Atoms, or Vue Refs.\n * Returns a new object with all values normalized to plain values.\n */\nexport function unwrapObject<T>(\n params: Record<string, MaybeAtom<T>> | undefined,\n): Record<string, T> | undefined {\n if (!params) {\n return undefined;\n }\n\n return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, unwrapAtom(value)]));\n}\n\nexport function isReadableAtom(value: unknown): value is ReadableAtom<unknown> {\n if (!value) {\n return false;\n }\n\n if (typeof value !== \"object\" || value === null) {\n return false;\n }\n\n if (!(\"get\" in value) || typeof value.get !== \"function\") {\n return false;\n }\n\n if (!(\"lc\" in value) || typeof value.lc !== \"number\") {\n return false;\n }\n\n if (!(\"notify\" in value) || typeof value.notify !== \"function\") {\n return false;\n }\n\n if (!(\"off\" in value) || typeof value.off !== \"function\") {\n return false;\n }\n\n if (!(\"subscribe\" in value) || typeof value.subscribe !== \"function\") {\n return false;\n }\n\n if (!(\"value\" in value)) {\n return false;\n }\n\n return true;\n}\n","import type { FetcherConfig } from \"../../api/fragment-instantiation\";\n\n/**\n * Merge two fetcher configurations, with user config taking precedence.\n * If user provides a custom function, it takes full precedence.\n * Otherwise, deep merge RequestInit options.\n */\nexport function mergeFetcherConfigs(\n authorConfig?: FetcherConfig,\n userConfig?: FetcherConfig,\n): FetcherConfig | undefined {\n // If user provides custom function, it takes full precedence\n if (userConfig?.type === \"function\") {\n return userConfig;\n }\n\n if (!userConfig && authorConfig?.type === \"function\") {\n return authorConfig;\n }\n\n // Deep merge RequestInit options\n const authorOpts = authorConfig?.type === \"options\" ? authorConfig.options : {};\n const userOpts = userConfig?.type === \"options\" ? userConfig.options : {};\n\n // If both are empty, return undefined\n if (Object.keys(authorOpts).length === 0 && Object.keys(userOpts).length === 0) {\n return undefined;\n }\n\n return {\n type: \"options\",\n options: {\n ...authorOpts,\n ...userOpts,\n headers: mergeHeaders(authorOpts.headers, userOpts.headers),\n },\n };\n}\n\n/**\n * Merge headers from author and user configs.\n * User headers override author headers.\n */\nfunction mergeHeaders(author?: HeadersInit, user?: HeadersInit): HeadersInit | undefined {\n if (!author && !user) {\n return undefined;\n }\n\n // Convert to Headers objects and merge\n const merged = new Headers(author);\n new Headers(user).forEach((value, key) => merged.set(key, value));\n\n // If no headers after merge, return undefined\n if (merged.keys().next().done) {\n return undefined;\n }\n\n return merged;\n}\n","import { nanoquery, type FetcherStore, type MutatorStore } from \"@nanostores/query\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { task, type ReadableAtom, type Store } from \"nanostores\";\nimport type { FragnoRouteConfig, HTTPMethod, NonGetHTTPMethod } 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} from \"../api/fragment-instantiation\";\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-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 */\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 */\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\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\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 */\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 */\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 */\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 */\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 */\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\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\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>;\n }): Promise<StandardSchemaV1.InferOutput<TOutputSchema>>;\n store(args?: {\n path?: MaybeExtractPathParamsOrWiden<TPath, string | ReadableAtom<string>>;\n query?: Record<TQueryParameters, string | ReadableAtom<string>>;\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>;\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 | ReadableAtom<string>>;\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\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 | ReadableAtom<string>>;\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 const searchParams = new URLSearchParams(normalizedQueryParams);\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 * @param path\n * @param params\n * @returns\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 | ReadableAtom<string>>;\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) => queryParams[key])\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\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\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\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\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 | ReadableAtom<string>>;\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 const searchParams = new URLSearchParams(normalizedQueryParams);\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 | ReadableAtom<string>>;\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\nexport function createClientBuilder<\n TConfig,\n TDeps,\n TServices extends Record<string, unknown>,\n const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n const TAdditionalContext extends Record<string, unknown>,\n>(\n fragmentBuilder: {\n definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;\n },\n publicConfig: FragnoPublicClientConfig,\n routesOrFactories: TRoutesOrFactories,\n authorFetcherConfig?: FetcherConfig,\n): ClientBuilder<\n FlattenRouteFactories<TRoutesOrFactories>,\n FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>\n> {\n const definition = fragmentBuilder.definition;\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 TServices,\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 };\n"],"mappings":"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"}
@@ -1,28 +1,9 @@
1
- import { c as OutputContext, d as MutableRequestState, h as MaybeExtractPathParamsOrWiden, l as InferOr, n as HTTPMethod, r as NonGetHTTPMethod, t as FragnoRouteConfig, u as StatusCode } from "./api-B1-h7jPC.js";
1
+ import { d as InferOrUnknown, f as StatusCode, g as MaybeExtractPathParamsOrWiden, l as OutputContext, n as HTTPMethod, o as RouteHandlerInputOptions, p as MutableRequestState, r as NonGetHTTPMethod, t as FragnoRouteConfig, u as InferOr } from "./api-CoCkNi6h.js";
2
+ import { n as AnyRouteOrFactory, r as FlattenRouteFactories, t as AnyFragnoRouteConfig } from "./route-mGLYSUvD.js";
2
3
  import { ReadableAtom, Store } from "nanostores";
3
4
  import { FetcherStore, MutatorStore } from "@nanostores/query";
4
5
  import { StandardSchemaV1 } from "@standard-schema/spec";
5
6
 
6
- //#region src/api/route.d.ts
7
- type AnyFragnoRouteConfig = FragnoRouteConfig<HTTPMethod, string, any, any, any, any>;
8
- interface RouteFactoryContext<TConfig, TDeps, TServices> {
9
- config: TConfig;
10
- deps: TDeps;
11
- services: TServices;
12
- }
13
- type RouteFactory<TConfig, TDeps, TServices, TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> = (context: RouteFactoryContext<TConfig, TDeps, TServices>) => TRoutes$1;
14
- type AnyRouteOrFactory = AnyFragnoRouteConfig | RouteFactory<any, any, any, any>;
15
- type FlattenRouteFactories<T extends readonly AnyRouteOrFactory[]> = T extends readonly [infer First, ...infer Rest extends readonly AnyRouteOrFactory[]] ? First extends RouteFactory<any, any, any, infer TRoutes> ? [...TRoutes, ...FlattenRouteFactories<Rest>] : [First, ...FlattenRouteFactories<Rest>] : [];
16
- declare function defineRoute<const TMethod extends HTTPMethod, const TPath extends string, const TOutputSchema extends StandardSchemaV1 | undefined, const TErrorCode extends string = string, const TQueryParameters extends string = string>(config: FragnoRouteConfig<TMethod, TPath, undefined, TOutputSchema, TErrorCode, TQueryParameters> & {
17
- inputSchema?: undefined;
18
- }): FragnoRouteConfig<TMethod, TPath, undefined, TOutputSchema, TErrorCode, TQueryParameters>;
19
- declare function defineRoute<const TMethod extends HTTPMethod, const TPath extends string, const TInputSchema extends StandardSchemaV1, const TOutputSchema extends StandardSchemaV1 | undefined, const TErrorCode extends string = string, const TQueryParameters extends string = string>(config: FragnoRouteConfig<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> & {
20
- inputSchema: TInputSchema;
21
- }): FragnoRouteConfig<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>;
22
- declare function defineRoutes<TConfig = {}, TDeps = {}, TServices = {}>(): {
23
- create: <const TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]>(fn: (context: RouteFactoryContext<TConfig, TDeps, TServices>) => TRoutes$1) => RouteFactory<TConfig, TDeps, TServices, TRoutes$1>;
24
- };
25
- //#endregion
26
7
  //#region src/client/client-error.d.ts
27
8
  type FragnoErrorOptions = {
28
9
  cause?: Error | unknown;
@@ -103,19 +84,19 @@ type ExtractNonGetRoutePaths<T extends readonly FragnoRouteConfig<HTTPMethod, st
103
84
  * Defaults to extracting all methods for the matching path, producing a union
104
85
  * if multiple methods exist for the same path.
105
86
  */
106
- type ExtractRouteByPath<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TPath extends string, TMethod extends HTTPMethod = HTTPMethod> = { [K in keyof TRoutes$1]: TRoutes$1[K] extends FragnoRouteConfig<infer M, TPath, infer Input, infer Output, infer ErrorCode, infer QueryParams> ? M extends TMethod ? FragnoRouteConfig<M, TPath, Input, Output, ErrorCode, QueryParams> : never : never }[number];
87
+ type ExtractRouteByPath<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TPath extends string, TMethod extends HTTPMethod = HTTPMethod> = { [K in keyof TRoutes]: TRoutes[K] extends FragnoRouteConfig<infer M, TPath, infer Input, infer Output, infer ErrorCode, infer QueryParams> ? M extends TMethod ? FragnoRouteConfig<M, TPath, Input, Output, ErrorCode, QueryParams> : never : never }[number];
107
88
  /**
108
89
  * Extract the output schema type for a specific route path from a routes array
109
90
  */
110
- type ExtractOutputSchemaForPath<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined>[], TPath extends string> = { [K in keyof TRoutes$1]: TRoutes$1[K] extends FragnoRouteConfig<infer Method, TPath, StandardSchemaV1 | undefined, infer Output> ? Method extends "GET" ? Output : never : never }[number];
91
+ type ExtractOutputSchemaForPath<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined>[], TPath extends string> = { [K in keyof TRoutes]: TRoutes[K] extends FragnoRouteConfig<infer Method, TPath, StandardSchemaV1 | undefined, infer Output> ? Method extends "GET" ? Output : never : never }[number];
111
92
  /**
112
93
  * Check if a path exists as a GET route in the routes array
113
94
  */
114
- type IsValidGetRoutePath<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TPath extends string> = TPath extends ExtractGetRoutePaths<TRoutes$1> ? true : false;
95
+ type IsValidGetRoutePath<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TPath extends string> = TPath extends ExtractGetRoutePaths<TRoutes> ? true : false;
115
96
  /**
116
97
  * Utility type to ensure only valid GET route paths can be used
117
98
  */
118
- type ValidateGetRoutePath<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TPath extends string> = TPath extends ExtractGetRoutePaths<TRoutes$1> ? TPath : `Error: Path '${TPath}' is not a valid GET route. Available GET routes: ${ExtractGetRoutePaths<TRoutes$1>}`;
99
+ type ValidateGetRoutePath<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TPath extends string> = TPath extends ExtractGetRoutePaths<TRoutes> ? TPath : `Error: Path '${TPath}' is not a valid GET route. Available GET routes: ${ExtractGetRoutePaths<TRoutes>}`;
119
100
  /**
120
101
  * Helper type to check if a routes array has any GET routes
121
102
  */
@@ -207,11 +188,27 @@ type CacheLine = {
207
188
  created: number;
208
189
  expires: number;
209
190
  };
210
- declare class ClientBuilder<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TFragmentConfig extends FragnoFragmentSharedConfig<TRoutes$1>> {
191
+ declare class ClientBuilder<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[], TFragmentConfig extends FragnoFragmentSharedConfig<TRoutes>> {
211
192
  #private;
212
193
  constructor(publicConfig: FragnoPublicClientConfig, fragmentConfig: TFragmentConfig);
213
194
  get cacheEntries(): Readonly<Record<string, CacheLine>>;
214
195
  createStore<const T extends object>(obj: T): FragnoStoreData<T>;
196
+ /**
197
+ * Build a URL for a custom backend call using the configured baseUrl and mountRoute.
198
+ * Useful for fragment authors who need to make custom fetch calls.
199
+ */
200
+ buildUrl<TPath extends string>(path: TPath, params?: {
201
+ path?: MaybeExtractPathParamsOrWiden<TPath, string>;
202
+ query?: Record<string, string>;
203
+ }): string;
204
+ /**
205
+ * Get the configured fetcher function for custom backend calls.
206
+ * Returns fetch with merged options applied.
207
+ */
208
+ getFetcher(): {
209
+ fetcher: typeof fetch;
210
+ defaultOptions: RequestInit | undefined;
211
+ };
215
212
  createHook<TPath extends ExtractGetRoutePaths<TFragmentConfig["routes"]>>(path: ValidateGetRoutePath<TFragmentConfig["routes"], TPath>, options?: CreateHookOptions): FragnoClientHookData<"GET", TPath, NonNullable<ExtractRouteByPath<TFragmentConfig["routes"], TPath>["outputSchema"]>, NonNullable<ExtractRouteByPath<TFragmentConfig["routes"], TPath>["errorCodes"]>[number], NonNullable<ExtractRouteByPath<TFragmentConfig["routes"], TPath>["queryParameters"]>[number]>;
216
213
  createMutator<TPath extends ExtractNonGetRoutePaths<TFragmentConfig["routes"]>>(method: NonGetHTTPMethod, path: TPath, onInvalidate?: OnInvalidateFn<TPath>): FragnoClientMutatorData<NonGetHTTPMethod,
217
214
  // TODO: This can be any Method, but should be related to TPath
@@ -219,10 +216,10 @@ declare class ClientBuilder<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMet
219
216
  }
220
217
  declare function createClientBuilder<TConfig, TDeps, TServices extends Record<string, unknown>, const TRoutesOrFactories extends readonly AnyRouteOrFactory[], const TAdditionalContext extends Record<string, unknown>>(fragmentBuilder: {
221
218
  definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;
222
- }, publicConfig: FragnoPublicClientConfig, routesOrFactories: TRoutesOrFactories): ClientBuilder<FlattenRouteFactories<TRoutesOrFactories>, FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>>;
219
+ }, publicConfig: FragnoPublicClientConfig, routesOrFactories: TRoutesOrFactories, authorFetcherConfig?: FetcherConfig): ClientBuilder<FlattenRouteFactories<TRoutesOrFactories>, FragnoFragmentSharedConfig<FlattenRouteFactories<TRoutesOrFactories>>>;
223
220
  //#endregion
224
221
  //#region src/api/request-middleware.d.ts
225
- type FragnoMiddlewareCallback<TRoutes$1 extends readonly AnyFragnoRouteConfig[], TDeps, TServices extends Record<string, unknown>> = (inputContext: RequestMiddlewareInputContext<TRoutes$1>, outputContext: RequestMiddlewareOutputContext<TDeps, TServices>) => Promise<Response | undefined> | Response | undefined;
222
+ type FragnoMiddlewareCallback<TRoutes extends readonly AnyFragnoRouteConfig[], TDeps, TServices extends Record<string, unknown>> = (inputContext: RequestMiddlewareInputContext<TRoutes>, outputContext: RequestMiddlewareOutputContext<TDeps, TServices>) => Promise<Response | undefined> | Response | undefined;
226
223
  interface RequestMiddlewareOptions {
227
224
  path: string;
228
225
  method: HTTPMethod;
@@ -235,9 +232,9 @@ declare class RequestMiddlewareOutputContext<const TDeps, const TServices extend
235
232
  get deps(): TDeps;
236
233
  get services(): TServices;
237
234
  }
238
- declare class RequestMiddlewareInputContext<const TRoutes$1 extends readonly AnyFragnoRouteConfig[]> {
235
+ declare class RequestMiddlewareInputContext<const TRoutes extends readonly AnyFragnoRouteConfig[]> {
239
236
  #private;
240
- constructor(routes: TRoutes$1, options: RequestMiddlewareOptions);
237
+ constructor(routes: TRoutes, options: RequestMiddlewareOptions);
241
238
  get path(): string;
242
239
  get method(): HTTPMethod;
243
240
  get pathParams(): Record<string, string>;
@@ -259,16 +256,52 @@ declare class RequestMiddlewareInputContext<const TRoutes$1 extends readonly Any
259
256
  * ```
260
257
  */
261
258
  get requestState(): MutableRequestState;
262
- ifMatchesRoute: <const TMethod extends HTTPMethod, const TPath extends ExtractRoutePath<TRoutes$1>, const TRoute extends ExtractRouteByPath<TRoutes$1, TPath, TMethod> = ExtractRouteByPath<TRoutes$1, TPath, TMethod>>(method: TMethod, path: TPath, handler: (...args: Parameters<TRoute["handler"]>) => Promise<Response | undefined | void> | Response | undefined | void) => Promise<Response | undefined>;
259
+ ifMatchesRoute: <const TMethod extends HTTPMethod, const TPath extends ExtractRoutePath<TRoutes>, const TRoute extends ExtractRouteByPath<TRoutes, TPath, TMethod> = ExtractRouteByPath<TRoutes, TPath, TMethod>>(method: TMethod, path: TPath, handler: (...args: Parameters<TRoute["handler"]>) => Promise<Response | undefined | void> | Response | undefined | void) => Promise<Response | undefined>;
263
260
  }
264
261
  //#endregion
262
+ //#region src/api/fragno-response.d.ts
263
+ /**
264
+ * Discriminated union representing all possible Fragno response types
265
+ */
266
+ type FragnoResponse<T> = {
267
+ type: "empty";
268
+ status: number;
269
+ headers: Headers;
270
+ } | {
271
+ type: "error";
272
+ status: number;
273
+ headers: Headers;
274
+ error: {
275
+ message: string;
276
+ code: string;
277
+ };
278
+ } | {
279
+ type: "json";
280
+ status: number;
281
+ headers: Headers;
282
+ data: T;
283
+ } | {
284
+ type: "jsonStream";
285
+ status: number;
286
+ headers: Headers;
287
+ stream: AsyncGenerator<T extends unknown[] ? T[number] : T>;
288
+ };
289
+ //#endregion
265
290
  //#region src/api/fragment-instantiation.d.ts
266
291
  interface FragnoPublicConfig {
267
292
  mountRoute?: string;
268
293
  }
294
+ type FetcherConfig = {
295
+ type: "options";
296
+ options: RequestInit;
297
+ } | {
298
+ type: "function";
299
+ fetcher: typeof fetch;
300
+ };
269
301
  interface FragnoPublicClientConfig {
270
302
  mountRoute?: string;
271
303
  baseUrl?: string;
304
+ fetcherConfig?: FetcherConfig;
272
305
  }
273
306
  type AstroHandlers = {
274
307
  ALL: (req: Request) => Promise<Response>;
@@ -324,20 +357,22 @@ type HandlersByFramework = {
324
357
  };
325
358
  declare const instantiatedFragmentFakeSymbol: "$fragno-instantiated-fragment";
326
359
  type FullstackFrameworks = keyof HandlersByFramework;
327
- interface FragnoInstantiatedFragment<TRoutes$1 extends readonly AnyFragnoRouteConfig[] = [], TDeps = {}, TServices extends Record<string, unknown> = Record<string, unknown>, TAdditionalContext extends Record<string, unknown> = {}> {
360
+ interface FragnoInstantiatedFragment<TRoutes extends readonly AnyFragnoRouteConfig[] = [], TDeps = {}, TServices extends Record<string, unknown> = Record<string, unknown>, TAdditionalContext extends Record<string, unknown> = {}> {
328
361
  [instantiatedFragmentFakeSymbol]: typeof instantiatedFragmentFakeSymbol;
329
- config: FragnoFragmentSharedConfig<TRoutes$1>;
362
+ config: FragnoFragmentSharedConfig<TRoutes>;
330
363
  deps: TDeps;
331
364
  services: TServices;
332
365
  additionalContext?: TAdditionalContext;
333
366
  handlersFor: <T extends FullstackFrameworks>(framework: T) => HandlersByFramework[T];
334
367
  handler: (req: Request) => Promise<Response>;
335
368
  mountRoute: string;
336
- withMiddleware: (handler: FragnoMiddlewareCallback<TRoutes$1, TDeps, TServices>) => FragnoInstantiatedFragment<TRoutes$1, TDeps, TServices, TAdditionalContext>;
369
+ callRoute: <TMethod extends HTTPMethod, TPath extends ExtractRoutePath<TRoutes, TMethod>>(method: TMethod, path: TPath, inputOptions?: RouteHandlerInputOptions<TPath, ExtractRouteByPath<TRoutes, TPath, TMethod>["inputSchema"]>) => Promise<FragnoResponse<InferOrUnknown<NonNullable<ExtractRouteByPath<TRoutes, TPath, TMethod>["outputSchema"]>>>>;
370
+ callRouteRaw: <TMethod extends HTTPMethod, TPath extends ExtractRoutePath<TRoutes, TMethod>>(method: TMethod, path: TPath, inputOptions?: RouteHandlerInputOptions<TPath, ExtractRouteByPath<TRoutes, TPath, TMethod>["inputSchema"]>) => Promise<Response>;
371
+ withMiddleware: (handler: FragnoMiddlewareCallback<TRoutes, TDeps, TServices>) => FragnoInstantiatedFragment<TRoutes, TDeps, TServices, TAdditionalContext>;
337
372
  }
338
- interface FragnoFragmentSharedConfig<TRoutes$1 extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
373
+ interface FragnoFragmentSharedConfig<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
339
374
  name: string;
340
- routes: TRoutes$1;
375
+ routes: TRoutes;
341
376
  }
342
377
  type AnyFragnoFragmentSharedConfig = FragnoFragmentSharedConfig<readonly AnyFragnoRouteConfig[]>;
343
378
  declare function createFragment<const TConfig, const TDeps, const TServices extends Record<string, unknown>, const TRoutesOrFactories extends readonly AnyRouteOrFactory[], const TAdditionalContext extends Record<string, unknown>, const TOptions extends FragnoPublicConfig>(fragmentBuilder: {
@@ -369,5 +404,5 @@ declare class FragmentBuilder<const TConfig, const TDeps = {}, const TServices e
369
404
  }
370
405
  declare function defineFragment<TConfig = {}>(name: string): FragmentBuilder<TConfig, {}, {}, {}>;
371
406
  //#endregion
372
- export { isGetHook as A, AnyRouteOrFactory as B, HasGetRoutes as C, buildUrl as D, ValidateGetRoutePath as E, FragnoClientFetchAbortError as F, defineRoutes as G, RouteFactory as H, FragnoClientFetchError as I, FragnoClientFetchNetworkError as L, isStore as M, FragnoClientApiError as N, createClientBuilder as O, FragnoClientError as P, FragnoClientUnknownApiError as R, FragnoStoreData as S, ObjectContainingStoreField as T, RouteFactoryContext as U, FlattenRouteFactories as V, defineRoute as W, ExtractOutputSchemaForPath as _, FragnoFragmentSharedConfig as a, FragnoClientHookData as b, FragnoPublicConfig as c, CacheLine as d, ClientBuilder as f, ExtractNonGetRoutePaths as g, ExtractGetRoutes as h, AnyFragnoFragmentSharedConfig as i, isMutatorHook as j, getCacheKey as k, createFragment as l, ExtractGetRoutePaths as m, FragmentDefinition as n, FragnoInstantiatedFragment as o, CreateHookOptions as p, defineFragment as r, FragnoPublicClientConfig as s, FragmentBuilder as t, instantiatedFragmentFakeSymbol as u, ExtractRouteByPath as v, IsValidGetRoutePath as w, FragnoClientMutatorData as x, ExtractRoutePath as y, FragnoErrorOptions as z };
373
- //# sourceMappingURL=fragment-builder-DsqUOfJ5.d.ts.map
407
+ export { createClientBuilder as A, FragnoClientUnknownApiError as B, FragnoClientMutatorData as C, ObjectContainingStoreField as D, IsValidGetRoutePath as E, FragnoClientApiError as F, FragnoClientError as I, FragnoClientFetchAbortError as L, isGetHook as M, isMutatorHook as N, ValidateGetRoutePath as O, isStore as P, FragnoClientFetchError as R, FragnoClientHookData as S, HasGetRoutes as T, FragnoErrorOptions as V, ExtractGetRoutes as _, FetcherConfig as a, ExtractRouteByPath as b, FragnoPublicClientConfig as c, instantiatedFragmentFakeSymbol as d, FragnoResponse as f, ExtractGetRoutePaths as g, CreateHookOptions as h, AnyFragnoFragmentSharedConfig as i, getCacheKey as j, buildUrl as k, FragnoPublicConfig as l, ClientBuilder as m, FragmentDefinition as n, FragnoFragmentSharedConfig as o, CacheLine as p, defineFragment as r, FragnoInstantiatedFragment as s, FragmentBuilder as t, createFragment as u, ExtractNonGetRoutePaths as v, FragnoStoreData as w, ExtractRoutePath as x, ExtractOutputSchemaForPath as y, FragnoClientFetchNetworkError as z };
408
+ //# sourceMappingURL=fragment-builder-8-tiECi5.d.ts.map