@fragno-dev/example-fragment 0.0.5

package/.turbo/turbo-build.log

@@ -0,0 +1,21 @@
+$ tsdown
+ℹ tsdown v0.15.5 powered by rolldown v1.0.0-beta.40
+rollup
+ℹ Using tsdown config: /home/runner/work/fragno/fragno/packages/example-fragment/tsdown.config.ts
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/browser/index.js        1.58 kB │ gzip: 0.64 kB
+ℹ dist/browser/index.js.map    5.66 kB │ gzip: 1.93 kB
+ℹ dist/browser/index.d.ts.map  0.51 kB │ gzip: 0.26 kB
+ℹ dist/browser/index.d.ts      1.82 kB │ gzip: 0.62 kB
+ℹ 4 files, total: 9.57 kB
+ℹ dist/node/index.js        2.90 kB │ gzip: 1.15 kB
+ℹ dist/node/index.js.map    5.69 kB │ gzip: 1.96 kB
+ℹ dist/node/index.d.ts.map  0.51 kB │ gzip: 0.26 kB
+ℹ dist/node/index.d.ts      1.82 kB │ gzip: 0.62 kB
+ℹ 4 files, total: 10.93 kB
+✔ Build complete in 11747ms
+✔ Build complete in 11755ms

package/.turbo/turbo-types$colon$check.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# @fragno-dev/example-fragment
+
+## 0.0.5
+
+### Patch Changes
+
+- Updated dependencies [b9450b1]
+  - @fragno-dev/core@0.0.5
+
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [1dae6f9]
+  - @fragno-dev/core@0.0.4
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [604caff]
+  - @fragno-dev/core@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [2052919]
+  - @fragno-dev/core@0.0.2

package/dist/browser/index.d.ts

@@ -0,0 +1,31 @@
+import * as _fragno_dev_core0 from "@fragno-dev/core";
+import { FragnoPublicClientConfig, FragnoPublicConfig } from "@fragno-dev/core";
+import * as _fragno_dev_core_client0 from "@fragno-dev/core/client";
+import { z } from "zod";
+import * as _fragno_dev_core_api0 from "@fragno-dev/core/api";
+import { FragnoRouteConfig } from "@fragno-dev/core/api";
+
+//#region src/index.d.ts
+interface ExampleFragmentServerConfig {
+  initialData?: string;
+}
+declare function createExampleFragment(serverConfig?: ExampleFragmentServerConfig, fragnoConfig?: FragnoPublicConfig): _fragno_dev_core0.FragnoInstantiatedFragment<[_fragno_dev_core0.FragnoRouteConfig<"GET", "/hash", undefined, z.ZodString, string, string>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/data", undefined, z.ZodString, string, "error">, _fragno_dev_core0.FragnoRouteConfig<"POST", "/sample", z.ZodObject<{
+  message: z.ZodString;
+}, z.core.$strip>, z.ZodString, "MESSAGE_CANNOT_BE_DIGITS_ONLY", string>], {
+  serverSideData: {
+    value: string;
+  };
+}, {
+  getData: () => string;
+  getHashFromHostsFileData: () => Promise<string | null>;
+}>;
+declare function createExampleFragmentClient(fragnoConfig?: FragnoPublicClientConfig): {
+  useHash: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/hash", z.ZodString, string, string>;
+  useData: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/data", z.ZodString, string, "error">;
+  useSampleMutator: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api0.NonGetHTTPMethod, "/sample", z.ZodObject<{
+    message: z.ZodString;
+  }, z.core.$strip> | undefined, z.ZodString | undefined, "MESSAGE_CANNOT_BE_DIGITS_ONLY", string>;
+};
+//#endregion
+export { ExampleFragmentServerConfig, type FragnoRouteConfig, createExampleFragment, createExampleFragmentClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAeiB,2BAAA;;;iBAkGD,qBAAA,gBACA,4CACA,uCAAuB,4BAAA,iBAAA,CAAA,6CAAA,CAAA,CAAA,4BAAA,iBAAA,CAAA,6CAAA,CAAA,CAAA,+CAAA,qCAAA,CAAA,CAAA;;;EApGtB,cAAA,EAAA;IAkGD,KAAA,EAAA,MAAA;EAAqB,CAAA;;SAErB,EAAA,GAAA,GAAA,MAAA;0BAAuB,EAAA,GAAA,UAAA,CAAA,MAAA,GAAA,IAAA,CAAA;;AAAA,iBAcvB,2BAAA,CAduB,YAAA,CAAA,EAcmB,wBAdnB,CAAA,EAAA;SAAA,+CAAA,CAAA,KAAA,EAAA,OAAA,aAAA,EAAA,MAAA,EAAA,MAAA,CAAA;;;IAAA,OAAA,aAAA"}

package/dist/browser/index.js

@@ -0,0 +1,50 @@
+import { createFragment, defineFragment, defineRoute, defineRoutes } from "@fragno-dev/core";
+import { createClientBuilder } from "@fragno-dev/core/client";
+import { z } from "zod";
+
+//#region src/index.ts
+const exampleRoutesFactory = defineRoutes().create(({ deps }) => {
+	return [
+		defineRoute({
+			method: "GET",
+			path: "/hash",
+			outputSchema: z.string(),
+			handler: () => {}
+		}),
+		defineRoute({
+			method: "GET",
+			path: "/data",
+			outputSchema: z.string(),
+			queryParameters: ["error"],
+			handler: () => {}
+		}),
+		defineRoute({
+			method: "POST",
+			path: "/sample",
+			inputSchema: z.object({ message: z.string() }),
+			outputSchema: z.string(),
+			errorCodes: ["MESSAGE_CANNOT_BE_DIGITS_ONLY"],
+			handler: () => {}
+		})
+	];
+});
+const exampleFragmentDefinition = defineFragment("example-fragment").withDependencies(() => {}).withServices(() => {});
+function createExampleFragment(serverConfig = {}, fragnoConfig = {}) {
+	const config = { initialData: serverConfig.initialData ?? "Hello World! This is a server-side data." };
+	return createFragment(exampleFragmentDefinition, {
+		...serverConfig,
+		...config
+	}, [exampleRoutesFactory], fragnoConfig);
+}
+function createExampleFragmentClient(fragnoConfig = {}) {
+	const b = createClientBuilder(exampleFragmentDefinition, fragnoConfig, [exampleRoutesFactory]);
+	return {
+		useHash: b.createHook("/hash"),
+		useData: b.createHook("/data"),
+		useSampleMutator: b.createMutator("POST", "/sample")
+	};
+}
+
+//#endregion
+export { createExampleFragment, createExampleFragmentClient };
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["defineFragment","defineRoute","defineRoutes","createFragment","FragnoPublicClientConfig","FragnoPublicConfig","createClientBuilder","z","ExampleFragmentServerConfig","initialData","ExampleRouteConfig","ExampleRouteDeps","serverSideData","value","exampleRoutesFactory","create","deps","method","path","outputSchema","string","handler","queryParameters","inputSchema","object","message","errorCodes","exampleFragmentDefinition","withDependencies","withServices","createExampleFragment","serverConfig","fragnoConfig","config","createExampleFragmentClient","b","useHash","createHook","useData","useSampleMutator","createMutator","FragnoRouteConfig"],"sources":["../../src/index.ts"],"sourcesContent":["import {\n  defineFragment,\n  defineRoute,\n  defineRoutes,\n  createFragment,\n  type FragnoPublicClientConfig,\n  type FragnoPublicConfig,\n} from \"@fragno-dev/core\";\nimport { createClientBuilder } from \"@fragno-dev/core/client\";\nimport { z } from \"zod\";\n\nimport { readFile } from \"node:fs/promises\";\nimport { platform } from \"node:os\";\nimport { createHash } from \"node:crypto\";\n\nexport interface ExampleFragmentServerConfig {\n  initialData?: string;\n}\n\ntype ExampleRouteConfig = {\n  initialData: string;\n};\n\ntype ExampleRouteDeps = {\n  serverSideData: { value: string };\n};\n\nconst getHashFromHostsFileData = async () => {\n  const hostsPath =\n    platform() === \"win32\" ? \"C:\\\\Windows\\\\System32\\\\drivers\\\\etc\\\\hosts\" : \"/etc/hosts\";\n\n  try {\n    const data = await readFile(hostsPath, { encoding: \"utf8\" });\n    return createHash(\"sha256\").update(data).digest(\"hex\");\n  } catch {\n    return null;\n  }\n};\n\nconst exampleRoutesFactory = defineRoutes<ExampleRouteConfig, ExampleRouteDeps>().create(\n  ({ deps }) => {\n    const { serverSideData } = deps;\n\n    return [\n      defineRoute({\n        method: \"GET\",\n        path: \"/hash\",\n        outputSchema: z.string(),\n        handler: async (_, { json }) => {\n          const hash = await getHashFromHostsFileData();\n          return json(hash ? `The hash of your 'hosts' file is: ${hash}` : \"No hash found :(\");\n        },\n      }),\n\n      defineRoute({\n        method: \"GET\",\n        path: \"/data\",\n        outputSchema: z.string(),\n        queryParameters: [\"error\"],\n        handler: async ({ query }, { json, error }) => {\n          if (query.get(\"error\")) {\n            return error(\n              {\n                message: \"An error was triggered\",\n                code: \"TEST_ERROR\",\n              },\n              400,\n            );\n          }\n          return json(serverSideData.value);\n        },\n      }),\n\n      defineRoute({\n        method: \"POST\",\n        path: \"/sample\",\n        inputSchema: z.object({ message: z.string() }),\n        outputSchema: z.string(),\n        errorCodes: [\"MESSAGE_CANNOT_BE_DIGITS_ONLY\"],\n        handler: async ({ input }, { json, error }) => {\n          const { message } = await input.valid();\n\n          if (/^\\d+$/.test(message)) {\n            return error(\n              {\n                message: \"Message cannot be digits only\",\n                code: \"MESSAGE_CANNOT_BE_DIGITS_ONLY\",\n              },\n              400,\n            );\n          }\n          serverSideData.value = message;\n\n          return json(message);\n        },\n      }),\n    ];\n  },\n);\n\nconst exampleFragmentDefinition = defineFragment<ExampleFragmentServerConfig>(\"example-fragment\")\n  .withDependencies((config: ExampleFragmentServerConfig) => {\n    return {\n      serverSideData: { value: config.initialData ?? \"Hello World! This is a server-side data.\" },\n    };\n  })\n  .withServices((_cfg, deps) => {\n    return {\n      getData: () => deps.serverSideData.value,\n      getHashFromHostsFileData,\n    };\n  });\n\nexport function createExampleFragment(\n  serverConfig: ExampleFragmentServerConfig = {},\n  fragnoConfig: FragnoPublicConfig = {},\n) {\n  const config: ExampleRouteConfig = {\n    initialData: serverConfig.initialData ?? \"Hello World! This is a server-side data.\",\n  };\n\n  return createFragment(\n    exampleFragmentDefinition,\n    { ...serverConfig, ...config },\n    [exampleRoutesFactory],\n    fragnoConfig,\n  );\n}\n\nexport function createExampleFragmentClient(fragnoConfig: FragnoPublicClientConfig = {}) {\n  const b = createClientBuilder(exampleFragmentDefinition, fragnoConfig, [exampleRoutesFactory]);\n\n  return {\n    useHash: b.createHook(\"/hash\"),\n    useData: b.createHook(\"/data\"),\n    useSampleMutator: b.createMutator(\"POST\", \"/sample\"),\n  };\n}\nexport type { FragnoRouteConfig } from \"@fragno-dev/core/api\";\n"],"mappings":";;;;;AAuCA,MAAMc,uBAAuBZ,cAAoD,CAACa,QAC/E,EAAEC,WAAW;AAGZ,QAAO;EACLf,YAAY;GACVgB,QAAQ;GACRC,MAAM;GACNC,cAAcZ,EAAEa,QAAQ;GACxBC,eAAO;GAIR,CAAC;EAEFpB,YAAY;GACVgB,QAAQ;GACRC,MAAM;GACNC,cAAcZ,EAAEa,QAAQ;GACxBE,iBAAiB,CAAC,QAAQ;GAC1BD,eAAO;GAYR,CAAC;EAEFpB,YAAY;GACVgB,QAAQ;GACRC,MAAM;GACNK,aAAahB,EAAEiB,OAAO,EAAEC,SAASlB,EAAEa,QAAO,EAAG,CAAC;GAC9CD,cAAcZ,EAAEa,QAAQ;GACxBM,YAAY,CAAC,gCAAgC;GAC7CL,eAAO;GAgBR,CAAC;EACH;EAEJ;AAED,MAAMM,4BAA4B3B,eAA4C,mBAAmB,CAC9F4B,uBAAgB,GAIf,CACDC,mBAAY,GAKX;AAEJ,SAAgBC,sBACdC,eAA4C,EAAE,EAC9CC,eAAmC,EAAE,EACrC;CACA,MAAMC,SAA6B,EACjCxB,aAAasB,aAAatB,eAAe,4CAC1C;AAED,QAAON,eACLwB,2BACA;EAAE,GAAGI;EAAc,GAAGE;EAAQ,EAC9B,CAACnB,qBAAqB,EACtBkB,aACD;;AAGH,SAAgBE,4BAA4BF,eAAyC,EAAE,EAAE;CACvF,MAAMG,IAAI7B,oBAAoBqB,2BAA2BK,cAAc,CAAClB,qBAAqB,CAAC;AAE9F,QAAO;EACLsB,SAASD,EAAEE,WAAW,QAAQ;EAC9BC,SAASH,EAAEE,WAAW,QAAQ;EAC9BE,kBAAkBJ,EAAEK,cAAc,QAAQ,UAAS;EACpD"}

package/dist/node/index.d.ts

@@ -0,0 +1,31 @@
+import * as _fragno_dev_core0 from "@fragno-dev/core";
+import { FragnoPublicClientConfig, FragnoPublicConfig } from "@fragno-dev/core";
+import * as _fragno_dev_core_client0 from "@fragno-dev/core/client";
+import { z } from "zod";
+import * as _fragno_dev_core_api0 from "@fragno-dev/core/api";
+import { FragnoRouteConfig } from "@fragno-dev/core/api";
+
+//#region src/index.d.ts
+interface ExampleFragmentServerConfig {
+  initialData?: string;
+}
+declare function createExampleFragment(serverConfig?: ExampleFragmentServerConfig, fragnoConfig?: FragnoPublicConfig): _fragno_dev_core0.FragnoInstantiatedFragment<[_fragno_dev_core0.FragnoRouteConfig<"GET", "/hash", undefined, z.ZodString, string, string>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/data", undefined, z.ZodString, string, "error">, _fragno_dev_core0.FragnoRouteConfig<"POST", "/sample", z.ZodObject<{
+  message: z.ZodString;
+}, z.core.$strip>, z.ZodString, "MESSAGE_CANNOT_BE_DIGITS_ONLY", string>], {
+  serverSideData: {
+    value: string;
+  };
+}, {
+  getData: () => string;
+  getHashFromHostsFileData: () => Promise<string | null>;
+}>;
+declare function createExampleFragmentClient(fragnoConfig?: FragnoPublicClientConfig): {
+  useHash: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/hash", z.ZodString, string, string>;
+  useData: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/data", z.ZodString, string, "error">;
+  useSampleMutator: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api0.NonGetHTTPMethod, "/sample", z.ZodObject<{
+    message: z.ZodString;
+  }, z.core.$strip> | undefined, z.ZodString | undefined, "MESSAGE_CANNOT_BE_DIGITS_ONLY", string>;
+};
+//#endregion
+export { ExampleFragmentServerConfig, type FragnoRouteConfig, createExampleFragment, createExampleFragmentClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAeiB,2BAAA;;;iBAkGD,qBAAA,gBACA,4CACA,uCAAuB,4BAAA,iBAAA,CAAA,6CAAA,CAAA,CAAA,4BAAA,iBAAA,CAAA,6CAAA,CAAA,CAAA,+CAAA,qCAAA,CAAA,CAAA;;;EApGtB,cAAA,EAAA;IAkGD,KAAA,EAAA,MAAA;EAAqB,CAAA;;SAErB,EAAA,GAAA,GAAA,MAAA;0BAAuB,EAAA,GAAA,UAAA,CAAA,MAAA,GAAA,IAAA,CAAA;;AAAA,iBAcvB,2BAAA,CAduB,YAAA,CAAA,EAcmB,wBAdnB,CAAA,EAAA;SAAA,+CAAA,CAAA,KAAA,EAAA,OAAA,aAAA,EAAA,MAAA,EAAA,MAAA,CAAA;;;IAAA,OAAA,aAAA"}

package/dist/node/index.js

@@ -0,0 +1,87 @@
+import { createFragment, defineFragment, defineRoute, defineRoutes } from "@fragno-dev/core";
+import { createClientBuilder } from "@fragno-dev/core/client";
+import { z } from "zod";
+import { readFile } from "node:fs/promises";
+import { platform } from "node:os";
+import { createHash } from "node:crypto";
+
+//#region src/index.ts
+const getHashFromHostsFileData = async () => {
+	const hostsPath = platform() === "win32" ? "C:\\Windows\\System32\\drivers\\etc\\hosts" : "/etc/hosts";
+	try {
+		const data = await readFile(hostsPath, { encoding: "utf8" });
+		return createHash("sha256").update(data).digest("hex");
+	} catch {
+		return null;
+	}
+};
+const exampleRoutesFactory = defineRoutes().create(({ deps }) => {
+	const { serverSideData } = deps;
+	return [
+		defineRoute({
+			method: "GET",
+			path: "/hash",
+			outputSchema: z.string(),
+			handler: async (_, { json }) => {
+				const hash = await getHashFromHostsFileData();
+				return json(hash ? `The hash of your 'hosts' file is: ${hash}` : "No hash found :(");
+			}
+		}),
+		defineRoute({
+			method: "GET",
+			path: "/data",
+			outputSchema: z.string(),
+			queryParameters: ["error"],
+			handler: async ({ query }, { json, error }) => {
+				if (query.get("error")) return error({
+					message: "An error was triggered",
+					code: "TEST_ERROR"
+				}, 400);
+				return json(serverSideData.value);
+			}
+		}),
+		defineRoute({
+			method: "POST",
+			path: "/sample",
+			inputSchema: z.object({ message: z.string() }),
+			outputSchema: z.string(),
+			errorCodes: ["MESSAGE_CANNOT_BE_DIGITS_ONLY"],
+			handler: async ({ input }, { json, error }) => {
+				const { message } = await input.valid();
+				if (/^\d+$/.test(message)) return error({
+					message: "Message cannot be digits only",
+					code: "MESSAGE_CANNOT_BE_DIGITS_ONLY"
+				}, 400);
+				serverSideData.value = message;
+				return json(message);
+			}
+		})
+	];
+});
+const exampleFragmentDefinition = defineFragment("example-fragment").withDependencies((config) => {
+	return { serverSideData: { value: config.initialData ?? "Hello World! This is a server-side data." } };
+}).withServices((_cfg, deps) => {
+	return {
+		getData: () => deps.serverSideData.value,
+		getHashFromHostsFileData
+	};
+});
+function createExampleFragment(serverConfig = {}, fragnoConfig = {}) {
+	const config = { initialData: serverConfig.initialData ?? "Hello World! This is a server-side data." };
+	return createFragment(exampleFragmentDefinition, {
+		...serverConfig,
+		...config
+	}, [exampleRoutesFactory], fragnoConfig);
+}
+function createExampleFragmentClient(fragnoConfig = {}) {
+	const b = createClientBuilder(exampleFragmentDefinition, fragnoConfig, [exampleRoutesFactory]);
+	return {
+		useHash: b.createHook("/hash"),
+		useData: b.createHook("/data"),
+		useSampleMutator: b.createMutator("POST", "/sample")
+	};
+}
+
+//#endregion
+export { createExampleFragment, createExampleFragmentClient };
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["config: ExampleRouteConfig"],"sources":["../../src/index.ts"],"sourcesContent":["import {\n  defineFragment,\n  defineRoute,\n  defineRoutes,\n  createFragment,\n  type FragnoPublicClientConfig,\n  type FragnoPublicConfig,\n} from \"@fragno-dev/core\";\nimport { createClientBuilder } from \"@fragno-dev/core/client\";\nimport { z } from \"zod\";\n\nimport { readFile } from \"node:fs/promises\";\nimport { platform } from \"node:os\";\nimport { createHash } from \"node:crypto\";\n\nexport interface ExampleFragmentServerConfig {\n  initialData?: string;\n}\n\ntype ExampleRouteConfig = {\n  initialData: string;\n};\n\ntype ExampleRouteDeps = {\n  serverSideData: { value: string };\n};\n\nconst getHashFromHostsFileData = async () => {\n  const hostsPath =\n    platform() === \"win32\" ? \"C:\\\\Windows\\\\System32\\\\drivers\\\\etc\\\\hosts\" : \"/etc/hosts\";\n\n  try {\n    const data = await readFile(hostsPath, { encoding: \"utf8\" });\n    return createHash(\"sha256\").update(data).digest(\"hex\");\n  } catch {\n    return null;\n  }\n};\n\nconst exampleRoutesFactory = defineRoutes<ExampleRouteConfig, ExampleRouteDeps>().create(\n  ({ deps }) => {\n    const { serverSideData } = deps;\n\n    return [\n      defineRoute({\n        method: \"GET\",\n        path: \"/hash\",\n        outputSchema: z.string(),\n        handler: async (_, { json }) => {\n          const hash = await getHashFromHostsFileData();\n          return json(hash ? `The hash of your 'hosts' file is: ${hash}` : \"No hash found :(\");\n        },\n      }),\n\n      defineRoute({\n        method: \"GET\",\n        path: \"/data\",\n        outputSchema: z.string(),\n        queryParameters: [\"error\"],\n        handler: async ({ query }, { json, error }) => {\n          if (query.get(\"error\")) {\n            return error(\n              {\n                message: \"An error was triggered\",\n                code: \"TEST_ERROR\",\n              },\n              400,\n            );\n          }\n          return json(serverSideData.value);\n        },\n      }),\n\n      defineRoute({\n        method: \"POST\",\n        path: \"/sample\",\n        inputSchema: z.object({ message: z.string() }),\n        outputSchema: z.string(),\n        errorCodes: [\"MESSAGE_CANNOT_BE_DIGITS_ONLY\"],\n        handler: async ({ input }, { json, error }) => {\n          const { message } = await input.valid();\n\n          if (/^\\d+$/.test(message)) {\n            return error(\n              {\n                message: \"Message cannot be digits only\",\n                code: \"MESSAGE_CANNOT_BE_DIGITS_ONLY\",\n              },\n              400,\n            );\n          }\n          serverSideData.value = message;\n\n          return json(message);\n        },\n      }),\n    ];\n  },\n);\n\nconst exampleFragmentDefinition = defineFragment<ExampleFragmentServerConfig>(\"example-fragment\")\n  .withDependencies((config: ExampleFragmentServerConfig) => {\n    return {\n      serverSideData: { value: config.initialData ?? \"Hello World! This is a server-side data.\" },\n    };\n  })\n  .withServices((_cfg, deps) => {\n    return {\n      getData: () => deps.serverSideData.value,\n      getHashFromHostsFileData,\n    };\n  });\n\nexport function createExampleFragment(\n  serverConfig: ExampleFragmentServerConfig = {},\n  fragnoConfig: FragnoPublicConfig = {},\n) {\n  const config: ExampleRouteConfig = {\n    initialData: serverConfig.initialData ?? \"Hello World! This is a server-side data.\",\n  };\n\n  return createFragment(\n    exampleFragmentDefinition,\n    { ...serverConfig, ...config },\n    [exampleRoutesFactory],\n    fragnoConfig,\n  );\n}\n\nexport function createExampleFragmentClient(fragnoConfig: FragnoPublicClientConfig = {}) {\n  const b = createClientBuilder(exampleFragmentDefinition, fragnoConfig, [exampleRoutesFactory]);\n\n  return {\n    useHash: b.createHook(\"/hash\"),\n    useData: b.createHook(\"/data\"),\n    useSampleMutator: b.createMutator(\"POST\", \"/sample\"),\n  };\n}\nexport type { FragnoRouteConfig } from \"@fragno-dev/core/api\";\n"],"mappings":";;;;;;;;AA2BA,MAAM,2BAA2B,YAAY;CAC3C,MAAM,YACJ,UAAU,KAAK,UAAU,+CAA+C;AAE1E,KAAI;EACF,MAAM,OAAO,MAAM,SAAS,WAAW,EAAE,UAAU,QAAQ,CAAC;AAC5D,SAAO,WAAW,SAAS,CAAC,OAAO,KAAK,CAAC,OAAO,MAAM;SAChD;AACN,SAAO;;;AAIX,MAAM,uBAAuB,cAAoD,CAAC,QAC/E,EAAE,WAAW;CACZ,MAAM,EAAE,mBAAmB;AAE3B,QAAO;EACL,YAAY;GACV,QAAQ;GACR,MAAM;GACN,cAAc,EAAE,QAAQ;GACxB,SAAS,OAAO,GAAG,EAAE,WAAW;IAC9B,MAAM,OAAO,MAAM,0BAA0B;AAC7C,WAAO,KAAK,OAAO,qCAAqC,SAAS,mBAAmB;;GAEvF,CAAC;EAEF,YAAY;GACV,QAAQ;GACR,MAAM;GACN,cAAc,EAAE,QAAQ;GACxB,iBAAiB,CAAC,QAAQ;GAC1B,SAAS,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY;AAC7C,QAAI,MAAM,IAAI,QAAQ,CACpB,QAAO,MACL;KACE,SAAS;KACT,MAAM;KACP,EACD,IACD;AAEH,WAAO,KAAK,eAAe,MAAM;;GAEpC,CAAC;EAEF,YAAY;GACV,QAAQ;GACR,MAAM;GACN,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;GAC9C,cAAc,EAAE,QAAQ;GACxB,YAAY,CAAC,gCAAgC;GAC7C,SAAS,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY;IAC7C,MAAM,EAAE,YAAY,MAAM,MAAM,OAAO;AAEvC,QAAI,QAAQ,KAAK,QAAQ,CACvB,QAAO,MACL;KACE,SAAS;KACT,MAAM;KACP,EACD,IACD;AAEH,mBAAe,QAAQ;AAEvB,WAAO,KAAK,QAAQ;;GAEvB,CAAC;EACH;EAEJ;AAED,MAAM,4BAA4B,eAA4C,mBAAmB,CAC9F,kBAAkB,WAAwC;AACzD,QAAO,EACL,gBAAgB,EAAE,OAAO,OAAO,eAAe,4CAA4C,EAC5F;EACD,CACD,cAAc,MAAM,SAAS;AAC5B,QAAO;EACL,eAAe,KAAK,eAAe;EACnC;EACD;EACD;AAEJ,SAAgB,sBACd,eAA4C,EAAE,EAC9C,eAAmC,EAAE,EACrC;CACA,MAAMA,SAA6B,EACjC,aAAa,aAAa,eAAe,4CAC1C;AAED,QAAO,eACL,2BACA;EAAE,GAAG;EAAc,GAAG;EAAQ,EAC9B,CAAC,qBAAqB,EACtB,aACD;;AAGH,SAAgB,4BAA4B,eAAyC,EAAE,EAAE;CACvF,MAAM,IAAI,oBAAoB,2BAA2B,cAAc,CAAC,qBAAqB,CAAC;AAE9F,QAAO;EACL,SAAS,EAAE,WAAW,QAAQ;EAC9B,SAAS,EAAE,WAAW,QAAQ;EAC9B,kBAAkB,EAAE,cAAc,QAAQ,UAAU;EACrD"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@fragno-dev/example-fragment",
+  "version": "0.0.5",
+  "exports": {
+    ".": {
+      "development": {
+        "browser": "./dist/browser/index.js",
+        "default": "./src/index.ts"
+      },
+      "bun": "./src/index.ts",
+      "browser": "./dist/browser/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/node/index.js"
+    }
+  },
+  "main": "./dist/node/index.js",
+  "module": "./dist/node/index.js",
+  "types": "./dist/node/index.d.ts",
+  "scripts": {
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "types:check": "tsc --noEmit"
+  },
+  "type": "module",
+  "dependencies": {
+    "@fragno-dev/core": "0.0.5",
+    "zod": "^4.0.5"
+  },
+  "devDependencies": {
+    "@fragno-private/typescript-config": "0.0.1",
+    "@fragno-dev/unplugin-fragno": "0.0.1",
+    "@types/node": "^20"
+  }
+}

package/src/index.ts

@@ -0,0 +1,139 @@
+import {
+  defineFragment,
+  defineRoute,
+  defineRoutes,
+  createFragment,
+  type FragnoPublicClientConfig,
+  type FragnoPublicConfig,
+} from "@fragno-dev/core";
+import { createClientBuilder } from "@fragno-dev/core/client";
+import { z } from "zod";
+
+import { readFile } from "node:fs/promises";
+import { platform } from "node:os";
+import { createHash } from "node:crypto";
+
+export interface ExampleFragmentServerConfig {
+  initialData?: string;
+}
+
+type ExampleRouteConfig = {
+  initialData: string;
+};
+
+type ExampleRouteDeps = {
+  serverSideData: { value: string };
+};
+
+const getHashFromHostsFileData = async () => {
+  const hostsPath =
+    platform() === "win32" ? "C:\\Windows\\System32\\drivers\\etc\\hosts" : "/etc/hosts";
+
+  try {
+    const data = await readFile(hostsPath, { encoding: "utf8" });
+    return createHash("sha256").update(data).digest("hex");
+  } catch {
+    return null;
+  }
+};
+
+const exampleRoutesFactory = defineRoutes<ExampleRouteConfig, ExampleRouteDeps>().create(
+  ({ deps }) => {
+    const { serverSideData } = deps;
+
+    return [
+      defineRoute({
+        method: "GET",
+        path: "/hash",
+        outputSchema: z.string(),
+        handler: async (_, { json }) => {
+          const hash = await getHashFromHostsFileData();
+          return json(hash ? `The hash of your 'hosts' file is: ${hash}` : "No hash found :(");
+        },
+      }),
+
+      defineRoute({
+        method: "GET",
+        path: "/data",
+        outputSchema: z.string(),
+        queryParameters: ["error"],
+        handler: async ({ query }, { json, error }) => {
+          if (query.get("error")) {
+            return error(
+              {
+                message: "An error was triggered",
+                code: "TEST_ERROR",
+              },
+              400,
+            );
+          }
+          return json(serverSideData.value);
+        },
+      }),
+
+      defineRoute({
+        method: "POST",
+        path: "/sample",
+        inputSchema: z.object({ message: z.string() }),
+        outputSchema: z.string(),
+        errorCodes: ["MESSAGE_CANNOT_BE_DIGITS_ONLY"],
+        handler: async ({ input }, { json, error }) => {
+          const { message } = await input.valid();
+
+          if (/^\d+$/.test(message)) {
+            return error(
+              {
+                message: "Message cannot be digits only",
+                code: "MESSAGE_CANNOT_BE_DIGITS_ONLY",
+              },
+              400,
+            );
+          }
+          serverSideData.value = message;
+
+          return json(message);
+        },
+      }),
+    ];
+  },
+);
+
+const exampleFragmentDefinition = defineFragment<ExampleFragmentServerConfig>("example-fragment")
+  .withDependencies((config: ExampleFragmentServerConfig) => {
+    return {
+      serverSideData: { value: config.initialData ?? "Hello World! This is a server-side data." },
+    };
+  })
+  .withServices((_cfg, deps) => {
+    return {
+      getData: () => deps.serverSideData.value,
+      getHashFromHostsFileData,
+    };
+  });
+
+export function createExampleFragment(
+  serverConfig: ExampleFragmentServerConfig = {},
+  fragnoConfig: FragnoPublicConfig = {},
+) {
+  const config: ExampleRouteConfig = {
+    initialData: serverConfig.initialData ?? "Hello World! This is a server-side data.",
+  };
+
+  return createFragment(
+    exampleFragmentDefinition,
+    { ...serverConfig, ...config },
+    [exampleRoutesFactory],
+    fragnoConfig,
+  );
+}
+
+export function createExampleFragmentClient(fragnoConfig: FragnoPublicClientConfig = {}) {
+  const b = createClientBuilder(exampleFragmentDefinition, fragnoConfig, [exampleRoutesFactory]);
+
+  return {
+    useHash: b.createHook("/hash"),
+    useData: b.createHook("/data"),
+    useSampleMutator: b.createMutator("POST", "/sample"),
+  };
+}
+export type { FragnoRouteConfig } from "@fragno-dev/core/api";

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@fragno-private/typescript-config/tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "composite": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsdown.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig } from "tsdown";
+import unpluginFragno from "@fragno-dev/unplugin-fragno/rollup";
+
+export default defineConfig([
+  {
+    entry: "./src/index.ts",
+    dts: true,
+    platform: "browser",
+    outDir: "./dist/browser",
+    plugins: [unpluginFragno({ platform: "browser" })],
+  },
+  {
+    entry: "./src/index.ts",
+    dts: true,
+    platform: "node",
+    outDir: "./dist/node",
+  },
+]);