@fragno-dev/core 0.0.6 → 0.0.7

package/dist/{ssr-tJHqcNSw.js.map → ssr-BAhbA_3q.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ssr-tJHqcNSw.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"}
+{"version":3,"file":"ssr-BAhbA_3q.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/core",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "exports": {
     ".": {
       "bun": "./src/mod.ts",
@@ -21,7 +21,7 @@
       "default": "./dist/client/client.js"
     },
     "./react": {
-      "bun": "./src/client/react.tsx",
+      "bun": "./src/client/react.ts",
       "development": "./src/client/react.ts",
       "types": "./dist/client/react.d.ts",
       "default": "./dist/client/react.js"
@@ -44,6 +44,12 @@
       "types": "./dist/client/client.svelte.d.ts",
       "default": "./dist/client/client.svelte.js"
     },
+    "./solid": {
+      "bun": "./src/client/solid.ts",
+      "development": "./src/client/solid.ts",
+      "types": "./dist/client/solid.d.ts",
+      "default": "./dist/client/solid.js"
+    },
     "./react-ssr": {
       "bun": "./src/integrations/react-ssr.ts",
       "development": "./src/integrations/react-ssr.ts",
@@ -58,17 +64,21 @@
   "scripts": {
     "build": "tsdown",
     "build:watch": "tsdown --watch",
-    "types:check": "tsc --noEmit"
+    "types:check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest --watch"
   },
   "type": "module",
   "dependencies": {
     "@nanostores/query": "^0.3.4",
+    "@nanostores/solid": "^1.1.1",
     "@standard-schema/spec": "^1.0.0",
     "nanostores": "^1.0.1",
     "rou3": "^0.7.3"
   },
   "devDependencies": {
     "@fragno-private/typescript-config": "0.0.1",
+    "@fragno-private/vitest-config": "0.0.0",
     "@sveltejs/vite-plugin-svelte": "^6.2.0",
     "@testing-library/react": "^16.3.0",
     "@testing-library/svelte": "^5.2.8",
@@ -76,17 +86,21 @@
     "@types/node": "^22",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "happy-dom": "^18.0.1",
+    "@vitest/coverage-istanbul": "^3.2.4",
+    "happy-dom": "^20.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "svelte": "^5.1.0",
+    "solid-js": "^1.9.3",
+    "vitest": "^3.2.4",
     "vue": "^3",
     "zod": "^4.0.5"
   },
   "peerDependencies": {
     "react": "^19.0.0",
     "vue": "^3",
-    "svelte": "^5"
+    "svelte": "^5",
+    "solid-js": "^1.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -97,6 +111,9 @@
     },
     "svelte": {
       "optional": true
+    },
+    "solid-js": {
+      "optional": true
     }
   },
   "repository": {

package/src/api/fragment.ts

@@ -7,7 +7,6 @@ import { RequestInputContext } from "./request-input-context";
 import type { ExtractPathParams } from "./internal/path";
 import { RequestOutputContext } from "./request-output-context";
 import {
-  type EmptyObject,
   type AnyFragnoRouteConfig,
   type AnyRouteOrFactory,
   type FlattenRouteFactories,
@@ -37,6 +36,16 @@ type ReactRouterHandlers = {
   action: (args: { request: Request }) => Promise<Response>;
 };
 
+type SolidStartHandlers = {
+  GET: (args: { request: Request }) => Promise<Response>;
+  POST: (args: { request: Request }) => Promise<Response>;
+  PUT: (args: { request: Request }) => Promise<Response>;
+  DELETE: (args: { request: Request }) => Promise<Response>;
+  PATCH: (args: { request: Request }) => Promise<Response>;
+  HEAD: (args: { request: Request }) => Promise<Response>;
+  OPTIONS: (args: { request: Request }) => Promise<Response>;
+};
+
 type StandardHandlers = {
   GET: (req: Request) => Promise<Response>;
   POST: (req: Request) => Promise<Response>;
@@ -52,13 +61,14 @@ type HandlersByFramework = {
   "react-router": ReactRouterHandlers;
   "next-js": StandardHandlers;
   "svelte-kit": StandardHandlers;
+  "solid-start": SolidStartHandlers;
 };
 
 type FullstackFrameworks = keyof HandlersByFramework;
 
 export interface FragnoInstantiatedFragment<
   TRoutes extends readonly AnyFragnoRouteConfig[] = [],
-  TDeps = EmptyObject,
+  TDeps = {},
   TServices extends Record<string, unknown> = Record<string, unknown>,
 > {
   config: FragnoFragmentSharedConfig<TRoutes>;
@@ -90,21 +100,13 @@ export type AnyFragnoFragmentSharedConfig = FragnoFragmentSharedConfig<
   readonly AnyFragnoRouteConfig[]
 >;
 
-interface FragmentDefinition<
-  TConfig,
-  TDeps = EmptyObject,
-  TServices extends Record<string, unknown> = EmptyObject,
-> {
+interface FragmentDefinition<TConfig, TDeps = {}, TServices extends Record<string, unknown> = {}> {
   name: string;
   dependencies?: (config: TConfig) => TDeps;
   services?: (config: TConfig, deps: TDeps) => TServices;
 }
 
-export class FragmentBuilder<
-  TConfig,
-  TDeps = EmptyObject,
-  TServices extends Record<string, unknown> = EmptyObject,
-> {
+export class FragmentBuilder<TConfig, TDeps = {}, TServices extends Record<string, unknown> = {}> {
   #definition: FragmentDefinition<TConfig, TDeps, TServices>;
 
   constructor(definition: FragmentDefinition<TConfig, TDeps, TServices>) {
@@ -134,7 +136,6 @@ export class FragmentBuilder<
   }
 }
 
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export function defineFragment<TConfig = {}>(name: string): FragmentBuilder<TConfig> {
   return new FragmentBuilder({
     name,
@@ -210,6 +211,14 @@ export function createFragment<
     },
     handlersFor: <T extends FullstackFrameworks>(framework: T): HandlersByFramework[T] => {
       const handler = fragment.handler;
+
+      // LLMs hallucinate these values sometimes, solution isn't obvious so we throw this error
+      // @ts-expect-error TS2367
+      if (framework === "h3" || framework === "nuxt") {
+        throw new Error(`To get handlers for h3, use the 'fromWebHandler' utility function:
+          import { fromWebHandler } from "h3";
+          export default fromWebHandler(myFragment().handler);`);
+      }
       const allHandlers = {
         astro: { ALL: handler },
         "react-router": {
@@ -234,6 +243,15 @@ export function createFragment<
           HEAD: handler,
           OPTIONS: handler,
         },
+        "solid-start": {
+          GET: ({ request }: { request: Request }) => handler(request),
+          POST: ({ request }: { request: Request }) => handler(request),
+          PUT: ({ request }: { request: Request }) => handler(request),
+          DELETE: ({ request }: { request: Request }) => handler(request),
+          PATCH: ({ request }: { request: Request }) => handler(request),
+          HEAD: ({ request }: { request: Request }) => handler(request),
+          OPTIONS: ({ request }: { request: Request }) => handler(request),
+        },
       } satisfies HandlersByFramework;
 
       return allHandlers[framework];

package/src/api/request-middleware.test.ts

@@ -45,7 +45,7 @@ describe("Request Middleware", () => {
     expect(unauthorizedRes.status).toBe(401);
     const unauthorizedBody = await unauthorizedRes.json();
     expect(unauthorizedBody).toEqual({
-      error: "Unauthorized",
+      message: "Unauthorized",
       code: "UNAUTHORIZED",
     });
 
@@ -134,7 +134,7 @@ describe("Request Middleware", () => {
     expect(res.status).toBe(403);
 
     expect(await res.json()).toEqual({
-      error: "Creating users has been disabled.",
+      message: "Creating users has been disabled.",
       code: "CREATE_USERS_DISABLED",
     });
 
@@ -439,7 +439,7 @@ describe("Request Middleware", () => {
 
     const body = await res.json();
     expect(body).toEqual({
-      error: "Request validation failed in middleware",
+      message: "Request validation failed in middleware",
       code: "MIDDLEWARE_VALIDATION_ERROR",
     });
   });

package/src/api/request-output-context.ts

@@ -51,16 +51,16 @@ export abstract class OutputContext<const TOutput, const TErrorCode extends stri
     headers?: HeadersInit,
   ): Response {
     if (typeof initOrStatus === "undefined") {
-      return Response.json({ error: message, code }, { status: 500, headers });
+      return Response.json({ message: message, code }, { status: 500, headers });
     }
 
     if (typeof initOrStatus === "number") {
-      return Response.json({ error: message, code }, { status: initOrStatus, headers });
+      return Response.json({ message: message, code }, { status: initOrStatus, headers });
     }
 
     const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);
     return Response.json(
-      { error: message, code },
+      { message: message, code },
       { status: initOrStatus.status, headers: mergedHeaders },
     );
   }

package/src/api/route.ts

@@ -125,14 +125,7 @@ export function defineRoute<
   return config;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
-export type EmptyObject = {}; //Record<string, never>;
-
-export function defineRoutes<
-  TConfig = EmptyObject,
-  TDeps = EmptyObject,
-  TServices = EmptyObject,
->() {
+export function defineRoutes<TConfig = {}, TDeps = {}, TServices = {}>() {
   return {
     create: <
       const TRoutes extends readonly FragnoRouteConfig<

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

@@ -1,6 +1,7 @@
 import { test, expect, describe } from "vitest";
-import { FragnoClientApiError } from "./client-error";
+import { FragnoClientApiError, FragnoClientUnknownApiError } from "./client-error";
 import { FragnoApiError } from "../api/error";
+import { RequestOutputContext } from "../api/request-output-context";
 
 describe("Error Conversion", () => {
   test("should convert API error to client error", async () => {
@@ -12,4 +13,19 @@ describe("Error Conversion", () => {
     expect(clientError.code).toBe("API_ERROR");
     expect(clientError.status).toBe(500);
   });
+
+  test("error() should never result in an unknown error", async () => {
+    const ctx = new RequestOutputContext();
+    const response = ctx.error({ message: "test", code: "MY_TEST_ERROR" }, { status: 400 });
+
+    expect(response).toBeInstanceOf(Response);
+    expect(response.status).toBe(400);
+
+    const clientError = await FragnoClientApiError.fromResponse(response);
+    expect(clientError).toBeInstanceOf(FragnoClientApiError);
+    expect(clientError).not.toBeInstanceOf(FragnoClientUnknownApiError);
+    expect(clientError.message).toBe("test");
+    expect(clientError.code).toBe("MY_TEST_ERROR");
+    expect(clientError.status).toBe(400);
+  });
 });