@fragno-dev/core 0.1.8 → 0.1.9

package/dist/util/async.js

@@ -0,0 +1,40 @@
+//#region src/util/async.ts
+/**
+* Creates an async iterator from a subscribe function that follows the observable pattern.
+*
+* @template T The type of values produced by the store.
+* @param subscribe A function that subscribes to store updates. It receives a callback to be
+*          called on each update, and returns an unsubscribe function.
+* @returns An async generator that yields store values as they are produced.
+*/
+function createAsyncIteratorFromCallback(subscribe) {
+	const queue = [];
+	let unsubscribe = null;
+	let resolveNext = null;
+	const unsubscribeFunc = subscribe((value) => {
+		if (resolveNext) {
+			resolveNext({
+				value,
+				done: false
+			});
+			resolveNext = null;
+		} else queue.push(value);
+	});
+	if (typeof unsubscribeFunc === "function") unsubscribe = unsubscribeFunc;
+	return (async function* () {
+		try {
+			while (true) if (queue.length > 0) yield queue.shift();
+			else yield await new Promise((resolve) => {
+				resolveNext = (result) => {
+					if (!result.done) resolve(result.value);
+				};
+			});
+		} finally {
+			if (unsubscribe) unsubscribe();
+		}
+	})();
+}
+
+//#endregion
+export { createAsyncIteratorFromCallback };
+//# sourceMappingURL=async.js.map

package/dist/util/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","names":["queue: T[]","unsubscribe: UnsubscribeFn | null","resolveNext: ((value: IteratorResult<T>) => void) | null"],"sources":["../../src/util/async.ts"],"sourcesContent":["type SubscribeFn<T> = (callback: (value: T) => void) => UnsubscribeFn | void;\ntype UnsubscribeFn = () => void;\n\n/**\n * Creates an async iterator from a subscribe function that follows the observable pattern.\n *\n * @template T The type of values produced by the store.\n * @param subscribe A function that subscribes to store updates. It receives a callback to be\n *          called on each update, and returns an unsubscribe function.\n * @returns An async generator that yields store values as they are produced.\n */\nexport function createAsyncIteratorFromCallback<T>(\n  subscribe: SubscribeFn<T>,\n): AsyncGenerator<T, void, unknown> {\n  const queue: T[] = [];\n  let unsubscribe: UnsubscribeFn | null = null;\n  let resolveNext: ((value: IteratorResult<T>) => void) | null = null;\n\n  const unsubscribeFunc = subscribe((value) => {\n    if (resolveNext) {\n      // If there's a pending promise, resolve it immediately\n      resolveNext({ value, done: false });\n      resolveNext = null;\n    } else {\n      // Otherwise, queue the value\n      queue.push(value);\n    }\n  });\n\n  // Store unsubscribe function if one was returned\n  if (typeof unsubscribeFunc === \"function\") {\n    unsubscribe = unsubscribeFunc;\n  }\n\n  return (async function* () {\n    try {\n      while (true) {\n        if (queue.length > 0) {\n          // Yield queued values\n          yield queue.shift()!;\n        } else {\n          // Wait for the next value\n          yield await new Promise<T>((resolve) => {\n            resolveNext = (result) => {\n              if (!result.done) {\n                resolve(result.value);\n              }\n            };\n          });\n        }\n      }\n    } finally {\n      // Clean up subscription on iterator termination\n      if (unsubscribe) {\n        unsubscribe();\n      }\n    }\n  })();\n}\n\n/**\n * Waits for an async iterator to yield a value that meets a condition.\n *\n * @template T The type of values produced by the iterator.\n * @param iterable The async iterable to wait for.\n * @param condition A function that checks if a value meets the condition.\n * @param options Optional configuration options.\n * @returns A promise that resolves to the first value that meets the condition.\n */\nexport async function waitForAsyncIterator<T>(\n  iterable: AsyncIterable<T>,\n  condition: (value: T) => boolean,\n  options: { timeout?: number } = {},\n): Promise<T> {\n  const { timeout = 1000 } = options;\n\n  // Create a timeout promise that rejects after the specified time\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(new Error(`waitForAsyncIterator: Timeout after ${timeout}ms`));\n    }, timeout);\n  });\n\n  // Create a promise that resolves when the condition is met\n  const iteratorPromise = (async () => {\n    for await (const value of iterable) {\n      if (condition(value)) {\n        return value;\n      }\n    }\n    throw new Error(\"waitForAsyncIterator: Iterator completed without meeting condition\");\n  })();\n\n  // Race between the timeout and the iterator\n  return Promise.race([iteratorPromise, timeoutPromise]);\n}\n"],"mappings":";;;;;;;;;AAWA,SAAgB,gCACd,WACkC;CAClC,MAAMA,QAAa,EAAE;CACrB,IAAIC,cAAoC;CACxC,IAAIC,cAA2D;CAE/D,MAAM,kBAAkB,WAAW,UAAU;AAC3C,MAAI,aAAa;AAEf,eAAY;IAAE;IAAO,MAAM;IAAO,CAAC;AACnC,iBAAc;QAGd,OAAM,KAAK,MAAM;GAEnB;AAGF,KAAI,OAAO,oBAAoB,WAC7B,eAAc;AAGhB,SAAQ,mBAAmB;AACzB,MAAI;AACF,UAAO,KACL,KAAI,MAAM,SAAS,EAEjB,OAAM,MAAM,OAAO;OAGnB,OAAM,MAAM,IAAI,SAAY,YAAY;AACtC,mBAAe,WAAW;AACxB,SAAI,CAAC,OAAO,KACV,SAAQ,OAAO,MAAM;;KAGzB;YAGE;AAER,OAAI,YACF,cAAa;;KAGf"}

package/dist/util/content-type.js

@@ -0,0 +1,49 @@
+//#region src/util/content-type.ts
+/**
+* Parses a content-type header string into its components
+*
+* @param contentType - The content-type header value to parse
+* @returns A ParsedContentType object or null if the input is invalid
+*
+* @example
+* ```ts
+* const { type, subtype, mediaType, parameters }
+*        = parseContentType("application/json; charset=utf-8");
+* console.assert(type === "application");
+* console.assert(subtype === "json");
+* console.assert(mediaType === "application/json");
+* console.assert(parameters["charset"] === "utf-8");
+*/
+function parseContentType(contentType) {
+	if (!contentType || typeof contentType !== "string") return null;
+	const trimmed = contentType.trim();
+	if (!trimmed) return null;
+	const parts = trimmed.split(";").map((part) => part.trim());
+	const mediaType = parts[0];
+	if (!mediaType) return null;
+	const typeParts = mediaType.split("/");
+	if (typeParts.length !== 2) return null;
+	const [type, subtype] = typeParts.map((part) => part.trim().toLowerCase());
+	if (!type || !subtype) return null;
+	const parameters = {};
+	for (let i = 1; i < parts.length; i++) {
+		const param = parts[i];
+		const equalIndex = param.indexOf("=");
+		if (equalIndex > 0) {
+			const key = param.slice(0, equalIndex).trim().toLowerCase();
+			let value = param.slice(equalIndex + 1).trim();
+			if (value.startsWith("\"") && value.endsWith("\"")) value = value.slice(1, -1);
+			if (key) parameters[key] = value;
+		}
+	}
+	return {
+		type,
+		subtype,
+		mediaType: `${type}/${subtype}`,
+		parameters
+	};
+}
+
+//#endregion
+export { parseContentType };
+//# sourceMappingURL=content-type.js.map

package/dist/util/content-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.js","names":["parameters: Record<string, string>"],"sources":["../../src/util/content-type.ts"],"sourcesContent":["/**\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"],"mappings":";;;;;;;;;;;;;;;;AA6BA,SAAgB,iBAAiB,aAAkE;AACjG,KAAI,CAAC,eAAe,OAAO,gBAAgB,SACzC,QAAO;CAGT,MAAM,UAAU,YAAY,MAAM;AAClC,KAAI,CAAC,QACH,QAAO;CAGT,MAAM,QAAQ,QAAQ,MAAM,IAAI,CAAC,KAAK,SAAS,KAAK,MAAM,CAAC;CAC3D,MAAM,YAAY,MAAM;AAExB,KAAI,CAAC,UACH,QAAO;CAGT,MAAM,YAAY,UAAU,MAAM,IAAI;AACtC,KAAI,UAAU,WAAW,EACvB,QAAO;CAGT,MAAM,CAAC,MAAM,WAAW,UAAU,KAAK,SAAS,KAAK,MAAM,CAAC,aAAa,CAAC;AAE1E,KAAI,CAAC,QAAQ,CAAC,QACZ,QAAO;CAGT,MAAMA,aAAqC,EAAE;AAE7C,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,QAAQ,MAAM;EACpB,MAAM,aAAa,MAAM,QAAQ,IAAI;AAErC,MAAI,aAAa,GAAG;GAClB,MAAM,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,aAAa;GAC3D,IAAI,QAAQ,MAAM,MAAM,aAAa,EAAE,CAAC,MAAM;AAE9C,OAAI,MAAM,WAAW,KAAI,IAAI,MAAM,SAAS,KAAI,CAC9C,SAAQ,MAAM,MAAM,GAAG,GAAG;AAG5B,OAAI,IACF,YAAW,OAAO;;;AAKxB,QAAO;EACL;EACA;EACA,WAAW,GAAG,KAAK,GAAG;EACtB;EACD"}

package/dist/util/nanostores.js

@@ -0,0 +1,31 @@
+//#region src/util/nanostores.ts
+/**
+* Normalizes a value that could be a plain value, an Atom, or a Vue Ref to a plain value.
+*/
+function unwrapAtom(value) {
+	if (value && typeof value === "object" && "get" in value && typeof value.get === "function") return value.get();
+	return value;
+}
+/**
+* Normalizes an object where values can be plain values, Atoms, or Vue Refs.
+* Returns a new object with all values normalized to plain values.
+*/
+function unwrapObject(params) {
+	if (!params) return;
+	return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, unwrapAtom(value)]));
+}
+function isReadableAtom(value) {
+	if (!value) return false;
+	if (typeof value !== "object" || value === null) return false;
+	if (!("get" in value) || typeof value.get !== "function") return false;
+	if (!("lc" in value) || typeof value.lc !== "number") return false;
+	if (!("notify" in value) || typeof value.notify !== "function") return false;
+	if (!("off" in value) || typeof value.off !== "function") return false;
+	if (!("subscribe" in value) || typeof value.subscribe !== "function") return false;
+	if (!("value" in value)) return false;
+	return true;
+}
+
+//#endregion
+export { isReadableAtom, unwrapObject };
+//# sourceMappingURL=nanostores.js.map

package/dist/util/nanostores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nanostores.js","names":[],"sources":["../../src/util/nanostores.ts"],"sourcesContent":["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"],"mappings":";;;;AAOA,SAAgB,WAAc,OAAwB;AAEpD,KAAI,SAAS,OAAO,UAAU,YAAY,SAAS,SAAS,OAAO,MAAM,QAAQ,WAC/E,QAAO,MAAM,KAAK;AAGpB,QAAO;;;;;;AAOT,SAAgB,aACd,QAC+B;AAC/B,KAAI,CAAC,OACH;AAGF,QAAO,OAAO,YAAY,OAAO,QAAQ,OAAO,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,WAAW,MAAM,CAAC,CAAC,CAAC;;AAGnG,SAAgB,eAAe,OAAgD;AAC7E,KAAI,CAAC,MACH,QAAO;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO;AAGT,KAAI,EAAE,SAAS,UAAU,OAAO,MAAM,QAAQ,WAC5C,QAAO;AAGT,KAAI,EAAE,QAAQ,UAAU,OAAO,MAAM,OAAO,SAC1C,QAAO;AAGT,KAAI,EAAE,YAAY,UAAU,OAAO,MAAM,WAAW,WAClD,QAAO;AAGT,KAAI,EAAE,SAAS,UAAU,OAAO,MAAM,QAAQ,WAC5C,QAAO;AAGT,KAAI,EAAE,eAAe,UAAU,OAAO,MAAM,cAAc,WACxD,QAAO;AAGT,KAAI,EAAE,WAAW,OACf,QAAO;AAGT,QAAO"}

package/dist/{ssr-kyKI7pqH.js → util/ssr.js}

@@ -44,5 +44,5 @@ async function getFinalStoreValues() {
 }
 
 //#endregion
-export { getInitialData as a, getFinalStoreValues as i, addStore as n, hydrateFromWindow as o, cleanStores as r, SSR_ENABLED as t };
-//# sourceMappingURL=ssr-kyKI7pqH.js.map
+export { SSR_ENABLED, addStore, cleanStores, getFinalStoreValues, getInitialData, hydrateFromWindow };
+//# sourceMappingURL=ssr.js.map

package/dist/util/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","names":["stores: FetcherStore[]","clientInitialData: Map<string, unknown> | undefined","stores"],"sources":["../../src/util/ssr.ts"],"sourcesContent":["import { allTasks } from \"nanostores\";\nimport type { FetcherStore } from \"@nanostores/query\";\n\nlet stores: FetcherStore[] = [];\n\nexport const SSR_ENABLED = false;\n\nexport function getStores() {\n  return stores;\n}\n\nexport function addStore(store: FetcherStore) {\n  stores.push(store);\n}\n\nexport function cleanStores() {\n  stores = [];\n}\n\n// Client side\ndeclare global {\n  interface Window {\n    __FRAGNO_INITIAL_DATA__?: [string, unknown][];\n  }\n}\n\nlet clientInitialData: Map<string, unknown> | undefined;\n\nexport function hydrateFromWindow() {\n  if (typeof window !== \"undefined\" && window.__FRAGNO_INITIAL_DATA__) {\n    clientInitialData = new Map(window.__FRAGNO_INITIAL_DATA__);\n    delete window.__FRAGNO_INITIAL_DATA__;\n    console.warn(\"hydrateFromWindow\", {\n      clientInitialData: Array.from(clientInitialData.entries()),\n    });\n  }\n}\n\nexport function getInitialData(key: string): unknown | undefined {\n  if (clientInitialData?.has(key)) {\n    const data = clientInitialData.get(key);\n    clientInitialData.delete(key);\n    return data;\n  }\n  return undefined;\n}\n\nfunction listenToStores(): void {\n  for (const store of getStores()) {\n    // By calling `listen`, we trigger the fetcher function of the store.\n    // This will start the data fetching process on the server.\n    // We don't need to do anything with the return value of `listen`, as we\n    // are only interested in starting the data fetching.\n    store.listen(() => {});\n  }\n}\n\n// Server side\nexport async function getFinalStoreValues(): Promise<Map<string, unknown>> {\n  listenToStores();\n  await allTasks();\n\n  const stores = getStores();\n  const storesInitialValue = new Map<string, unknown>();\n\n  for (const store of stores) {\n    const value = store.get();\n    if (!value || !store.key || value.loading) {\n      continue;\n    }\n    storesInitialValue.set(store.key, value.data);\n  }\n\n  return storesInitialValue;\n}\n"],"mappings":";;;AAGA,IAAIA,SAAyB,EAAE;AAE/B,MAAa,cAAc;AAE3B,SAAgB,YAAY;AAC1B,QAAO;;AAGT,SAAgB,SAAS,OAAqB;AAC5C,QAAO,KAAK,MAAM;;AAGpB,SAAgB,cAAc;AAC5B,UAAS,EAAE;;AAUb,IAAIC;AAEJ,SAAgB,oBAAoB;AAClC,KAAI,OAAO,WAAW,eAAe,OAAO,yBAAyB;AACnE,sBAAoB,IAAI,IAAI,OAAO,wBAAwB;AAC3D,SAAO,OAAO;AACd,UAAQ,KAAK,qBAAqB,EAChC,mBAAmB,MAAM,KAAK,kBAAkB,SAAS,CAAC,EAC3D,CAAC;;;AAIN,SAAgB,eAAe,KAAkC;AAC/D,KAAI,mBAAmB,IAAI,IAAI,EAAE;EAC/B,MAAM,OAAO,kBAAkB,IAAI,IAAI;AACvC,oBAAkB,OAAO,IAAI;AAC7B,SAAO;;;AAKX,SAAS,iBAAuB;AAC9B,MAAK,MAAM,SAAS,WAAW,CAK7B,OAAM,aAAa,GAAG;;AAK1B,eAAsB,sBAAqD;AACzE,iBAAgB;AAChB,OAAM,UAAU;CAEhB,MAAMC,WAAS,WAAW;CAC1B,MAAM,qCAAqB,IAAI,KAAsB;AAErD,MAAK,MAAM,SAASA,UAAQ;EAC1B,MAAM,QAAQ,MAAM,KAAK;AACzB,MAAI,CAAC,SAAS,CAAC,MAAM,OAAO,MAAM,QAChC;AAEF,qBAAmB,IAAI,MAAM,KAAK,MAAM,KAAK;;AAG/C,QAAO"}

package/dist/util/types-util.d.ts

@@ -0,0 +1,8 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/util/types-util.d.ts
+type InferOr<T, U> = T extends NonNullable<StandardSchemaV1> ? StandardSchemaV1.InferOutput<T> : T extends undefined ? U : U;
+type InferOrUnknown<T> = InferOr<T, unknown>;
+//#endregion
+export { InferOr, InferOrUnknown };
+//# sourceMappingURL=types-util.d.ts.map

package/dist/util/types-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-util.d.ts","names":[],"sources":["../../src/util/types-util.ts"],"sourcesContent":[],"mappings":";;;KAEY,gBACV,UAAU,YAAY,oBAClB,gBAAA,CAAiB,YAAY,KAC7B,sBACE,IACA;KAEI,oBAAoB,QAAQ"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@fragno-dev/core",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "exports": {
     ".": {
       "development": "./src/mod.ts",
+      "browser": "./dist/mod-client.js",
       "types": "./dist/mod.d.ts",
       "default": "./dist/mod.js"
     },
@@ -17,21 +18,26 @@
       "types": "./dist/test/test.d.ts",
       "default": "./dist/test/test.js"
     },
-    "./api/fragment-builder": {
-      "development": "./src/api/fragment-builder.ts",
-      "types": "./dist/api/fragment-builder.d.ts",
-      "default": "./dist/api/fragment-builder.js"
-    },
-    "./api/fragment-instantiation": {
-      "development": "./src/api/fragment-instantiation.ts",
-      "types": "./dist/api/fragment-instantiation.d.ts",
-      "default": "./dist/api/fragment-instantiation.js"
-    },
-    "./api/route": {
+    "./route": {
       "development": "./src/api/route.ts",
       "types": "./dist/api/route.d.ts",
       "default": "./dist/api/route.js"
     },
+    "./request": {
+      "development": "./src/request/request.ts",
+      "types": "./dist/request/request.d.ts",
+      "default": "./dist/request/request.js"
+    },
+    "./internal/request-context-storage": {
+      "development": "./src/api/request-context-storage.ts",
+      "types": "./dist/api/request-context-storage.d.ts",
+      "default": "./dist/api/request-context-storage.js"
+    },
+    "./internal/symbols": {
+      "development": "./src/internal/symbols.ts",
+      "types": "./dist/internal/symbols.d.ts",
+      "default": "./dist/internal/symbols.js"
+    },
     "./client": {
       "development": "./src/client/client.ts",
       "types": "./dist/client/client.d.ts",
@@ -73,6 +79,7 @@
   "module": "./dist/mod.js",
   "types": "./dist/mod.d.ts",
   "type": "module",
+  "sideEffects": false,
   "dependencies": {
     "@nanostores/query": "^0.3.4",
     "@nanostores/solid": "^1.1.1",

package/src/api/api.ts

@@ -23,10 +23,6 @@ export type ValidPath<T extends string = string> = T extends `/${infer Rest}`
       : T
   : PathError<T, "Path must start with '/'.">; // Excludes paths not starting with "/"
 
-/**
- * Base ServiceContext interface. Can be augmented by packages like @fragno-dev/db.
- */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface RequestThisContext {}
 
 export interface FragnoRouteConfig<
@@ -143,4 +139,4 @@ export function addRoute<
 
 export { FragnoApiError, FragnoApiValidationError } from "./error";
 export type { RouteHandlerInputOptions } from "./route-handler-input-options";
-export { instantiateFragment, FragmentInstantiationBuilder } from "./fragment-instantiation";
+export type { FragnoPublicConfig } from "./shared-types";

package/src/api/bind-services.ts

@@ -0,0 +1,42 @@
+// Type helper to remove 'this' parameter from functions
+type OmitThisParameter<T> = T extends (this: infer _This, ...args: infer A) => infer R
+  ? (...args: A) => R
+  : T;
+
+// Recursively remove 'this' parameter from all functions in an object
+export type BoundServices<T> = {
+  [K in keyof T]: T[K] extends (...args: never[]) => unknown
+    ? OmitThisParameter<T[K]>
+    : T[K] extends Record<string, unknown>
+      ? BoundServices<T[K]>
+      : T[K];
+};
+
+/**
+ * Bind all functions in a service object to a specific context.
+ * This allows services to use `this` to access the context.
+ *
+ * @param services - The service object to bind
+ * @param context - The context to bind to (e.g., { getUnitOfWork })
+ * @returns A new object with all functions bound to the context
+ */
+export function bindServicesToContext<T extends object, TContext extends object>(
+  services: T,
+  context: TContext,
+): BoundServices<T> {
+  const bound = {} as BoundServices<T>;
+
+  for (const [key, value] of Object.entries(services)) {
+    if (typeof value === "function") {
+      // Bind function to the provided context
+      bound[key as keyof T] = value.bind(context) as BoundServices<T>[keyof T];
+    } else if (value && typeof value === "object" && !Array.isArray(value)) {
+      // Recursively bind nested service objects
+      bound[key as keyof T] = bindServicesToContext(value, context) as BoundServices<T>[keyof T];
+    } else {
+      bound[key as keyof T] = value as BoundServices<T>[keyof T];
+    }
+  }
+
+  return bound;
+}