@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.
- package/.turbo/turbo-build.log +48 -44
- package/CHANGELOG.md +46 -0
- package/dist/api/api.d.ts +2 -2
- package/dist/api/fragment-builder.d.ts +3 -2
- package/dist/api/fragment-instantiation.d.ts +4 -3
- package/dist/api/fragment-instantiation.js +3 -3
- package/dist/api/route.d.ts +3 -0
- package/dist/api/route.js +3 -0
- package/dist/{api-B1-h7jPC.d.ts → api-CoCkNi6h.d.ts} +16 -2
- package/dist/api-CoCkNi6h.d.ts.map +1 -0
- package/dist/api-DngJDcmO.js.map +1 -1
- package/dist/client/client.d.ts +4 -3
- package/dist/client/client.js +3 -3
- package/dist/client/client.svelte.d.ts +3 -3
- package/dist/client/client.svelte.d.ts.map +1 -1
- package/dist/client/client.svelte.js +3 -3
- package/dist/client/react.d.ts +3 -3
- package/dist/client/react.d.ts.map +1 -1
- package/dist/client/react.js +3 -3
- package/dist/client/solid.d.ts +3 -3
- package/dist/client/solid.d.ts.map +1 -1
- package/dist/client/solid.js +3 -3
- package/dist/client/vanilla.d.ts +3 -3
- package/dist/client/vanilla.d.ts.map +1 -1
- package/dist/client/vanilla.js +3 -3
- package/dist/client/vue.d.ts +3 -3
- package/dist/client/vue.d.ts.map +1 -1
- package/dist/client/vue.js +3 -3
- package/dist/{client-YUZaNg5U.js → client-DJfCJiHK.js} +81 -7
- package/dist/client-DJfCJiHK.js.map +1 -0
- package/dist/{fragment-builder-DsqUOfJ5.d.ts → fragment-builder-8-tiECi5.d.ts} +73 -38
- package/dist/fragment-builder-8-tiECi5.d.ts.map +1 -0
- package/dist/{fragment-instantiation-Cp0K8zdS.js → fragment-instantiation-C4wvwl6V.js} +108 -3
- package/dist/fragment-instantiation-C4wvwl6V.js.map +1 -0
- package/dist/mod.d.ts +3 -2
- package/dist/mod.js +3 -3
- package/dist/{route-Dk1GyqHs.js → request-output-context-CdIjwmEN.js} +13 -24
- package/dist/request-output-context-CdIjwmEN.js.map +1 -0
- package/dist/route-C5Uryylh.js +21 -0
- package/dist/route-C5Uryylh.js.map +1 -0
- package/dist/route-mGLYSUvD.d.ts +26 -0
- package/dist/route-mGLYSUvD.d.ts.map +1 -0
- package/dist/test/test.d.ts +24 -70
- package/dist/test/test.d.ts.map +1 -1
- package/dist/test/test.js +27 -115
- package/dist/test/test.js.map +1 -1
- package/package.json +6 -1
- package/src/api/api.ts +1 -0
- package/src/api/fragment-instantiation.test.ts +460 -0
- package/src/api/fragment-instantiation.ts +121 -0
- package/src/api/fragno-response.ts +132 -0
- package/src/api/request-output-context.test.ts +10 -10
- package/src/api/request-output-context.ts +3 -3
- package/src/api/route-handler-input-options.ts +15 -0
- package/src/client/client.test.ts +264 -0
- package/src/client/client.ts +65 -3
- package/src/client/internal/fetcher-merge.ts +59 -0
- package/src/test/test.test.ts +110 -165
- package/src/test/test.ts +56 -266
- package/tsdown.config.ts +1 -0
- package/dist/api-B1-h7jPC.d.ts.map +0 -1
- package/dist/client-YUZaNg5U.js.map +0 -1
- package/dist/fragment-builder-DsqUOfJ5.d.ts.map +0 -1
- package/dist/fragment-instantiation-Cp0K8zdS.js.map +0 -1
- package/dist/route-CTxjMtGZ.js +0 -10
- package/dist/route-CTxjMtGZ.js.map +0 -1
- package/dist/route-Dk1GyqHs.js.map +0 -1
package/dist/client/vue.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vue.d.ts","names":[],"sources":["../../src/client/vue.ts"],"sourcesContent":[],"mappings":";;;;;;;;
|
|
1
|
+
{"version":3,"file":"vue.d.ts","names":[],"sources":["../../src/client/vue.ts"],"sourcesContent":[],"mappings":"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"}
|
package/dist/client/vue.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import "../api-DngJDcmO.js";
|
|
2
|
-
import "../
|
|
3
|
-
import "../route-
|
|
4
|
-
import { a as isGetHook, o as isMutatorHook } from "../client-
|
|
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 {
|
|
2
|
-
import {
|
|
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
|
|
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
|
|
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-
|
|
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 {
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
235
|
+
declare class RequestMiddlewareInputContext<const TRoutes extends readonly AnyFragnoRouteConfig[]> {
|
|
239
236
|
#private;
|
|
240
|
-
constructor(routes: TRoutes
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
373
|
+
interface FragnoFragmentSharedConfig<TRoutes extends readonly FragnoRouteConfig<HTTPMethod, string, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined, string, string>[]> {
|
|
339
374
|
name: string;
|
|
340
|
-
routes: TRoutes
|
|
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 {
|
|
373
|
-
//# sourceMappingURL=fragment-builder-
|
|
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
|