@fragno-dev/core 0.1.7 → 0.1.9

package/src/client/client-builder.test.ts

@@ -1,33 +1,33 @@
 import { test, expect, expectTypeOf, describe } from "vitest";
 import { z } from "zod";
 import { createClientBuilder } from "./client";
-import { addRoute } from "../api/api";
-import { defineFragment } from "../api/fragment-builder";
-import type { FragnoPublicClientConfig } from "../api/fragment-instantiation";
+import { defineRoute } from "../api/route";
+import { defineFragment } from "../api/fragment-definition-builder";
+import type { FragnoPublicClientConfig } from "../api/shared-types";
 
 // Test route configurations
-const testFragment = defineFragment("test-fragment");
+const testFragment = defineFragment("test-fragment").build();
 const testRoutes = [
   // GET routes
-  addRoute({
+  defineRoute({
     method: "GET",
     path: "/home",
     outputSchema: z.string(),
     handler: async (_ctx, { json }) => json("ok"),
   }),
-  addRoute({
+  defineRoute({
     method: "GET",
     path: "/users",
     outputSchema: z.array(z.object({ id: z.number(), name: z.string() })),
     handler: async (_ctx, { json }) => json([{ id: 1, name: "" }]),
   }),
-  addRoute({
+  defineRoute({
     method: "GET",
     path: "/users/:id" as const,
     outputSchema: z.object({ id: z.number(), name: z.string() }),
     handler: async ({ pathParams }, { json }) => json({ id: Number(pathParams.id), name: "" }),
   }),
-  addRoute({
+  defineRoute({
     method: "GET",
     path: "/ai-config",
     outputSchema: z.object({
@@ -43,14 +43,14 @@ const testRoutes = [
       }),
   }),
   // Non-GET routes (should not be available for hooks)
-  addRoute({
+  defineRoute({
     method: "POST",
     path: "/users",
     inputSchema: z.object({ name: z.string() }),
     outputSchema: z.object({ id: z.number(), name: z.string() }),
     handler: async (_ctx, { json }) => json({ id: 1, name: "" }),
   }),
-  addRoute({
+  defineRoute({
     method: "PUT",
     path: "/users/:id",
     inputSchema: z.object({ name: z.string() }),
@@ -58,7 +58,7 @@ const testRoutes = [
       return empty();
     },
   }),
-  addRoute({
+  defineRoute({
     method: "DELETE",
     path: "/users/:id",
     handler: async (_ctx, { empty }) => {
@@ -73,18 +73,18 @@ const testPublicConfig: FragnoPublicClientConfig = {
 };
 
 // Empty fragment config for edge case testing
-const _emptyFragment = defineFragment("empty-fragment");
+const _emptyFragment = defineFragment("empty-fragment").build();
 const _emptyRoutes = [] as const;
 
 // Fragment config with no GET routes
-const noGetFragment = defineFragment("no-get-fragment");
+const noGetFragment = defineFragment("no-get-fragment").build();
 const noGetRoutes = [
-  addRoute({
+  defineRoute({
     method: "POST",
     path: "/create",
     handler: async (_ctx, { json }) => json({}),
   }),
-  addRoute({
+  defineRoute({
     method: "DELETE",
     path: "/delete/:id",
     handler: async (_ctx, { empty }) => {
@@ -141,15 +141,15 @@ describe("Hook builder (createHookBuilder) and createFragmentHook", () => {
     });
 
     test("should handle complex route paths", () => {
-      const complexFragment = defineFragment("complex-fragment");
+      const complexFragment = defineFragment("complex-fragment").build();
       const complexRoutes = [
-        addRoute({
+        defineRoute({
           method: "GET",
           path: "/api/v1/users/:userId/posts/:postId/comments/:commentId",
           outputSchema: z.object({ id: z.number(), content: z.string() }),
           handler: async (_ctx, { json }) => json({ id: 1, content: "" }),
         }),
-        addRoute({
+        defineRoute({
           method: "GET",
           path: "/files/**:filepath",
           outputSchema: z.string(),
@@ -194,30 +194,30 @@ describe("type safety tests", () => {
 
 describe("real-world usage scenarios", () => {
   test("should work with Chatno-like configuration", () => {
-    const chatnoFragment = defineFragment("chatno");
+    const chatnoFragment = defineFragment("chatno").build();
     const chatnoRoutes = [
-      addRoute({
+      defineRoute({
         method: "GET",
         path: "/home",
         handler: async (_ctx, { empty }) => {
           return empty();
         },
       }),
-      addRoute({
+      defineRoute({
         method: "GET",
         path: "/thing/**:path",
         handler: async (_ctx, { empty }) => {
           return empty();
         },
       }),
-      addRoute({
+      defineRoute({
         method: "POST",
         path: "/echo",
         inputSchema: z.object({ number: z.number() }),
         outputSchema: z.string(),
         handler: async (_ctx, { json }) => json(""),
       }),
-      addRoute({
+      defineRoute({
         method: "GET",
         path: "/ai-config",
         outputSchema: z.object({

package/src/client/client.ssr.test.ts

@@ -7,15 +7,15 @@
  */
 
 import { describe, expect, test } from "vitest";
-import { type FragnoPublicClientConfig } from "../mod";
+import { type FragnoPublicClientConfig } from "./client";
 import { createClientBuilder } from "./client";
 import { defineRoute } from "../api/route";
-import { defineFragment } from "../api/fragment-builder";
+import { defineFragment } from "../api/fragment-definition-builder";
 import { z } from "zod";
 import { createAsyncIteratorFromCallback, waitForAsyncIterator } from "../util/async";
 
 describe("server side rendering", () => {
-  const testFragmentDefinition = defineFragment("test-fragment");
+  const testFragmentDefinition = defineFragment("test-fragment").build();
   const testRoutes = [
     defineRoute({
       method: "GET",

package/src/client/client.svelte.test.ts

@@ -1,9 +1,9 @@
 import { test, expect, describe, vi, beforeEach, afterEach, assert } from "vitest";
-import { type FragnoPublicClientConfig } from "../mod";
+import { type FragnoPublicClientConfig } from "./client";
 import { createClientBuilder } from "./client";
 import { render } from "@testing-library/svelte";
 import { defineRoute } from "../api/route";
-import { defineFragment } from "../api/fragment-builder";
+import { defineFragment } from "../api/fragment-definition-builder";
 import { z } from "zod";
 import { readableToAtom, useFragno } from "./client.svelte";
 import { writable, readable, get, derived } from "svelte/store";
@@ -89,7 +89,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Hook should function", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -124,7 +124,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should support path parameters and update reactively when Svelte store changes", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     type TestData = {
       id: number;
       name: string;
@@ -183,7 +183,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should support path parameters and update reactively when Nanostores Atom changes", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     type TestData = { id: number; name: string };
     const testRoutes = [
       defineRoute({
@@ -239,7 +239,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should handle errors gracefully", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -277,7 +277,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should track loading states correctly", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -322,7 +322,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should handle query parameters", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -376,7 +376,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should handle multiple hooks together", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -432,7 +432,7 @@ describe("createSvelteHook", () => {
   });
 
   test("Should handle mixed reactive parameters - writable path param, atom and writable query params, with reactive updates", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -561,7 +561,7 @@ describe("createSvelteMutator", () => {
   });
 
   test("Should handle mutator hooks", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "POST",
@@ -605,7 +605,7 @@ describe("createSvelteMutator", () => {
   });
 
   test("Should handle mutator with path parameters", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "PUT",
@@ -663,7 +663,7 @@ describe("useFragno", () => {
     baseUrl: "http://localhost:3000",
   };
 
-  const testFragmentDefinition = defineFragment("test-fragment");
+  const testFragmentDefinition = defineFragment("test-fragment").build();
   const testRoutes = [
     defineRoute({
       method: "GET",
@@ -711,7 +711,7 @@ describe("useFragno", () => {
   });
 
   test("Should support path parameters and update reactively when using Svelte runes", async () => {
-    const testFragmentDefinition = defineFragment("test-fragment");
+    const testFragmentDefinition = defineFragment("test-fragment").build();
     type TestData = {
       id: number;
       name: string;
@@ -785,7 +785,7 @@ describe("createSvelteStore", () => {
   });
 
   test("streaming routes", async () => {
-    const streamFragmentDefinition = defineFragment("stream-fragment");
+    const streamFragmentDefinition = defineFragment("stream-fragment").build();
     const streamRoutes = [
       defineRoute({
         method: "GET",

package/src/client/client.test.ts

@@ -4,9 +4,9 @@ import { defineRoute } from "../api/route";
 import { buildUrl, createClientBuilder, getCacheKey, isGetHook, isMutatorHook } from "./client";
 import { useFragno } from "./vanilla";
 import { createAsyncIteratorFromCallback, waitForAsyncIterator } from "../util/async";
-import type { FragnoPublicClientConfig } from "../mod";
+import type { FragnoPublicClientConfig } from "./client";
 import { atom, computed, effect } from "nanostores";
-import { defineFragment } from "../api/fragment-builder";
+import { defineFragment } from "../api/fragment-definition-builder";
 import { RequestOutputContext } from "../api/request-output-context";
 import { FragnoClientUnknownApiError } from "./client-error";
 
@@ -112,7 +112,7 @@ describe("getCacheKey", () => {
 });
 
 describe("invalidation", () => {
-  const testFragment = defineFragment("test-fragment");
+  const testFragment = defineFragment("test-fragment").build();
   const testRoutes = [
     defineRoute({
       method: "GET",
@@ -269,7 +269,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should react to path parameters", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -343,7 +343,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should react to query parameters", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -446,7 +446,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should react to optional query parameters", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -523,7 +523,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should react to combined path and query parameters", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -632,7 +632,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should handle mixed atoms and non-atoms in parameters", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -752,7 +752,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should not refetch when non-atom parameters remain unchanged", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -859,7 +859,7 @@ describe("hook parameter reactivity", () => {
   });
 
   test("should handle multiple reactive query parameters independently", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "GET",
@@ -1039,7 +1039,7 @@ describe("createHook - streaming", () => {
   });
 
   test("Should be able to stream data and receive updates in store (store.listen)", async () => {
-    const streamFragmentDefinition = defineFragment("stream-fragment");
+    const streamFragmentDefinition = defineFragment("stream-fragment").build();
     const streamRoutes = [
       defineRoute({
         method: "GET",
@@ -1112,7 +1112,7 @@ describe("createHook - streaming", () => {
   });
 
   test("throws FragnoClientUnknownApiError when the stream is not valid JSON", async () => {
-    const streamErrorFragmentDefinition = defineFragment("stream-error-fragment");
+    const streamErrorFragmentDefinition = defineFragment("stream-error-fragment").build();
     const streamErrorRoutes = [
       defineRoute({
         method: "GET",
@@ -1152,7 +1152,7 @@ describe("createHook - streaming", () => {
   });
 
   test("throws FragnoClientUnknownApiError when the stream is new lines only", async () => {
-    const streamErrorFragmentDefinition = defineFragment("stream-error-fragment");
+    const streamErrorFragmentDefinition = defineFragment("stream-error-fragment").build();
     const streamErrorRoutes = [
       defineRoute({
         method: "GET",
@@ -1192,7 +1192,7 @@ describe("createHook - streaming", () => {
   });
 
   test("throws FragnoClientUnknownApiError with cause SyntaxError when the stream is not valid JSON (multiple empty lines)", async () => {
-    const streamErrorFragmentDefinition = defineFragment("stream-error-fragment");
+    const streamErrorFragmentDefinition = defineFragment("stream-error-fragment").build();
     const streamErrorRoutes = [
       defineRoute({
         method: "GET",
@@ -1249,7 +1249,7 @@ describe("createMutator", () => {
   });
 
   test("body is optional when no inputSchema in route", async () => {
-    const testFragment = defineFragment("test-fragment");
+    const testFragment = defineFragment("test-fragment").build();
     const testRoutes = [
       defineRoute({
         method: "DELETE",
@@ -1288,7 +1288,7 @@ describe("createMutator - streaming", () => {
   });
 
   test("should support streaming responses for mutations", async () => {
-    const mutationStreamFragmentDefinition = defineFragment("mutation-stream-fragment");
+    const mutationStreamFragmentDefinition = defineFragment("mutation-stream-fragment").build();
     const mutationStreamRoutes = [
       defineRoute({
         method: "POST",
@@ -1354,7 +1354,7 @@ describe("createMutator - streaming", () => {
   });
 
   test("Should be able to mutate data and receive updates in store (store.subscribe)", async () => {
-    const streamFragmentDefinition = defineFragment("stream-fragment");
+    const streamFragmentDefinition = defineFragment("stream-fragment").build();
     const streamRoutes = [
       defineRoute({
         method: "POST",
@@ -1459,7 +1459,7 @@ describe("createMutator - streaming", () => {
   });
 
   test("Should be able to mutate data and receive updates in store (store.listen)", async () => {
-    const streamFragmentDefinition = defineFragment("stream-fragment");
+    const streamFragmentDefinition = defineFragment("stream-fragment").build();
     const streamRoutes = [
       defineRoute({
         method: "POST",
@@ -1570,7 +1570,7 @@ describe("computed", () => {
   });
 
   test("Derived from streaming route", async () => {
-    const streamFragmentDefinition = defineFragment("stream-fragment");
+    const streamFragmentDefinition = defineFragment("stream-fragment").build();
     const streamRoutes = [
       defineRoute({
         method: "GET",
@@ -1617,7 +1617,7 @@ describe("computed", () => {
   });
 
   test("Derived from streaming route with atom usage", async () => {
-    const streamFragmentDefinition = defineFragment("stream-fragment");
+    const streamFragmentDefinition = defineFragment("stream-fragment").build();
     const streamRoutes = [
       defineRoute({
         method: "GET",
@@ -1694,7 +1694,7 @@ describe("computed", () => {
 });
 
 describe("type guards", () => {
-  const testFragment = defineFragment("test-fragment");
+  const testFragment = defineFragment("test-fragment").build();
   const testRoutes = [
     defineRoute({
       method: "GET",
@@ -1767,7 +1767,7 @@ describe("type guards", () => {
 });
 
 describe("Custom Fetcher Configuration", () => {
-  const testFragment = defineFragment("test-fragment");
+  const testFragment = defineFragment("test-fragment").build();
   const testRoutes = [
     defineRoute({
       method: "GET",