@fragno-dev/pi-fragment 0.0.1

package/LICENSE.md

@@ -0,0 +1,16 @@
+Copyright 2025 - present "ReJot Nederland B.V.", and individual contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the “Software”), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# pi-fragment
+
+A Fragno fragment that runs Pi agents using workflow-backed sessions with registry-based config.
+
+## Features
+
+- Session lifecycle (create, list, fetch)
+- Workflow-backed agent turns (history stored in workflow steps)
+- Registry-driven agent + tool configuration
+- Minimal API surface for sessions + messages
+
+## Server usage
+
+```ts
+import { defaultFragnoRuntime } from "@fragno-dev/core";
+import { SqlAdapter } from "@fragno-dev/db/adapters/sql";
+import { createWorkflowsFragment } from "@fragno-dev/workflows";
+import { getModel } from "@mariozechner/pi-ai";
+import { createPi, createPiFragment, defineAgent } from "@fragno-dev/pi-fragment";
+
+const pi = createPi()
+  .agent(
+    defineAgent("support-agent", {
+      systemPrompt: "You are a helpful support agent.",
+      model: getModel("openai", "gpt-4.1"),
+      tools: ["search"],
+    }),
+  )
+  .tool("search", async () => ({
+    name: "search",
+    description: "Lookup references",
+    inputSchema: { type: "object", properties: { query: { type: "string" } } },
+    handler: async ({ query }: { query: string }) => `Result for ${query}`,
+  }))
+  .build();
+
+const workflowsFragment = createWorkflowsFragment(
+  {
+    workflows: pi.workflows,
+    runtime: defaultFragnoRuntime,
+  },
+  { databaseAdapter: new SqlAdapter({ filename: "./pi.db" }), mountRoute: "/api/workflows" },
+);
+
+const fragment = createPiFragment(
+  pi.config,
+  { databaseAdapter: new SqlAdapter({ filename: "./pi.db" }) },
+  { workflows: workflowsFragment.services },
+);
+
+// Example: Next.js route handlers
+export const { GET, POST, PATCH } = fragment.handlersFor("next-js");
+```
+
+Workflows are executed via the workflows fragment durable hook dispatcher. For a full example, see
+`apps/review-mode/workers/pi-fragment.do.ts`.
+
+### Config highlights
+
+- `agents`: registry of agent definitions (name, system prompt, model, tools)
+- `tools`: registry of tool factories
+- `defaultSteeringMode`: optional default for agent steering mode
+
+## Routes
+
+- `POST /sessions`
+- `GET /sessions`
+- `GET /sessions/:sessionId`
+- `POST /sessions/:sessionId/messages`
+
+`POST /sessions/:sessionId/messages` is asynchronous. It returns `202 Accepted` with a status-only
+ACK payload. Fetch `GET /sessions/:sessionId` to read assistant messages, trace, and summaries once
+the workflow processes the message.
+
+## Client usage
+
+```ts
+import { createPiFragmentClient } from "@fragno-dev/pi-fragment/react";
+
+const pi = createPiFragmentClient({ baseUrl: "/" });
+
+const { data: sessions } = pi.useSessions();
+const createSession = pi.useCreateSession();
+const sendMessage = pi.useSendMessage();
+```
+
+## CLI
+
+Use the CLI to list sessions, create a session, fetch details, or send messages.
+
+```bash
+# From the workspace
+pnpm -C packages/pi-fragment build
+node packages/pi-fragment/bin/run.js --help
+```
+
+```bash
+# Use the CLI
+fragno-pi --help
+```
+
+## Development
+
+```bash
+pnpm --filter @fragno-dev/pi-fragment test
+pnpm --filter @fragno-dev/pi-fragment build
+```

package/bin/run.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const distCli = path.join(__dirname, "..", "dist", "cli", "cli.js");
+const srcCli = path.join(__dirname, "..", "src", "cli", "cli.ts");
+
+const runBuiltCli = async () => {
+  await import(pathToFileURL(distCli).href);
+};
+
+const runSourceCli = async () => {
+  const require = createRequire(import.meta.url);
+  let tsxCli;
+
+  try {
+    tsxCli = require.resolve("tsx/cli");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("fragno-pi: unable to find tsx to run from source.");
+    console.error("Install dependencies or build the CLI before running.");
+    if (message) {
+      console.error(message);
+    }
+    process.exit(1);
+    return;
+  }
+
+  await new Promise((resolve) => {
+    const child = spawn(process.execPath, [tsxCli, srcCli, ...process.argv.slice(2)], {
+      stdio: "inherit",
+    });
+
+    child.on("error", (err) => {
+      console.error(`fragno-pi: failed to start tsx (${err.message})`);
+      process.exit(1);
+      resolve(null);
+    });
+
+    child.on("exit", (code, signal) => {
+      if (signal) {
+        process.kill(process.pid, signal);
+        return;
+      }
+      process.exit(code ?? 0);
+      resolve(null);
+    });
+  });
+};
+
+const main = async () => {
+  if (existsSync(distCli)) {
+    await runBuiltCli();
+    return;
+  }
+
+  await runSourceCli();
+};
+
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error("fragno-pi: unexpected error while running CLI.");
+  if (message) {
+    console.error(message);
+  }
+  process.exit(1);
+});

package/dist/browser/client/react.d.ts

@@ -0,0 +1,264 @@
+import { a as FragnoClientError, c as InferOr, d as MaybeExtractPathParamsOrWiden, f as QueryParamsHint, i as ReadableAtom, l as ExtractPathParamsOrWiden, o as NonGetHTTPMethod, r as FetcherValue, s as FragnoPublicClientConfig, u as HasPathParams } from "../client-Bk-J98pf.js";
+import * as zod from "zod";
+import "react";
+import * as zod_v4_core0 from "zod/v4/core";
+import * as _standard_schema_spec0 from "@standard-schema/spec";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region ../fragno/dist/client/react.d.ts
+//#region src/client/react.d.ts
+type FragnoReactHook<_TMethod extends "GET", TPath$1 extends string, TOutputSchema$1 extends StandardSchemaV1, TErrorCode$1 extends string, TQueryParameters$1 extends string> = (args?: {
+  path?: MaybeExtractPathParamsOrWiden<TPath$1, string | ReadableAtom<string>>;
+  query?: QueryParamsHint<TQueryParameters$1, string | ReadableAtom<string>>;
+}) => FetcherValue<StandardSchemaV1.InferOutput<TOutputSchema$1>, FragnoClientError<NonNullable<TErrorCode$1>>>;
+type FragnoReactMutator<_TMethod extends NonGetHTTPMethod, TPath$1 extends string, TInputSchema extends StandardSchemaV1 | undefined, TOutputSchema$1 extends StandardSchemaV1 | undefined, TErrorCode$1 extends string, TQueryParameters$1 extends string> = () => {
+  mutate: ({
+    body,
+    path,
+    query
+  }: {
+    body?: InferOr<TInputSchema, undefined>;
+    path?: HasPathParams<TPath$1> extends true ? ExtractPathParamsOrWiden<TPath$1, string | ReadableAtom<string>> : undefined;
+    query?: QueryParamsHint<TQueryParameters$1, string | ReadableAtom<string>>;
+  }) => Promise<InferOr<TOutputSchema$1, undefined>>;
+  loading?: boolean | undefined;
+  error?: FragnoClientError<NonNullable<TErrorCode$1>[number]> | undefined;
+  data?: InferOr<TOutputSchema$1, undefined> | undefined;
+};
+/**
+ * Type helper that unwraps any Store fields of the object into StoreValues
+ */
+//#endregion
+//#region src/client/react.d.ts
+declare function createPiFragmentClient(config?: FragnoPublicClientConfig): {
+  useSessions: FragnoReactHook<"GET", "/sessions", zod.ZodArray<zod.ZodObject<{
+    id: zod.ZodString;
+    name: zod.ZodNullable<zod.ZodString>;
+    status: zod.ZodEnum<{
+      active: "active";
+      paused: "paused";
+      errored: "errored";
+      terminated: "terminated";
+      complete: "complete";
+      waiting: "waiting";
+    }>;
+    agent: zod.ZodString;
+    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
+    steeringMode: zod.ZodEnum<{
+      all: "all";
+      "one-at-a-time": "one-at-a-time";
+    }>;
+    metadata: zod.ZodNullable<zod.ZodAny>;
+    tags: zod.ZodArray<zod.ZodString>;
+    createdAt: zod.ZodDate;
+    updatedAt: zod.ZodDate;
+  }, zod_v4_core0.$strip>>, string, "limit">;
+  useSession: FragnoReactHook<"GET", "/sessions/:sessionId", zod.ZodObject<{
+    id: zod.ZodString;
+    name: zod.ZodNullable<zod.ZodString>;
+    status: zod.ZodEnum<{
+      active: "active";
+      paused: "paused";
+      errored: "errored";
+      terminated: "terminated";
+      complete: "complete";
+      waiting: "waiting";
+    }>;
+    agent: zod.ZodString;
+    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
+    steeringMode: zod.ZodEnum<{
+      all: "all";
+      "one-at-a-time": "one-at-a-time";
+    }>;
+    metadata: zod.ZodNullable<zod.ZodAny>;
+    tags: zod.ZodArray<zod.ZodString>;
+    createdAt: zod.ZodDate;
+    updatedAt: zod.ZodDate;
+    workflow: zod.ZodObject<{
+      status: zod.ZodEnum<{
+        active: "active";
+        paused: "paused";
+        errored: "errored";
+        terminated: "terminated";
+        complete: "complete";
+        waiting: "waiting";
+      }>;
+      error: zod.ZodOptional<zod.ZodObject<{
+        name: zod.ZodString;
+        message: zod.ZodString;
+      }, zod_v4_core0.$strip>>;
+      output: zod.ZodOptional<zod.ZodAny>;
+    }, zod_v4_core0.$strip>;
+    messages: zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+      role: zod.ZodLiteral<"user">;
+      content: zod.ZodUnion<readonly [zod.ZodString, zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+        type: zod.ZodLiteral<"text">;
+        text: zod.ZodString;
+        textSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"thinking">;
+        thinking: zod.ZodString;
+        thinkingSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"image">;
+        data: zod.ZodString;
+        mimeType: zod.ZodString;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"toolCall">;
+        id: zod.ZodString;
+        name: zod.ZodString;
+        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+        thoughtSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>]>>]>;
+      timestamp: zod.ZodNumber;
+    }, zod_v4_core0.$strip>, zod.ZodObject<{
+      role: zod.ZodLiteral<"assistant">;
+      content: zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+        type: zod.ZodLiteral<"text">;
+        text: zod.ZodString;
+        textSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"thinking">;
+        thinking: zod.ZodString;
+        thinkingSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"image">;
+        data: zod.ZodString;
+        mimeType: zod.ZodString;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"toolCall">;
+        id: zod.ZodString;
+        name: zod.ZodString;
+        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+        thoughtSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>]>>;
+      api: zod.ZodString;
+      provider: zod.ZodString;
+      model: zod.ZodString;
+      usage: zod.ZodObject<{
+        input: zod.ZodNumber;
+        output: zod.ZodNumber;
+        cacheRead: zod.ZodNumber;
+        cacheWrite: zod.ZodNumber;
+        totalTokens: zod.ZodNumber;
+        cost: zod.ZodObject<{
+          input: zod.ZodNumber;
+          output: zod.ZodNumber;
+          cacheRead: zod.ZodNumber;
+          cacheWrite: zod.ZodNumber;
+          total: zod.ZodNumber;
+        }, zod_v4_core0.$strip>;
+      }, zod_v4_core0.$strip>;
+      stopReason: zod.ZodString;
+      errorMessage: zod.ZodOptional<zod.ZodString>;
+      timestamp: zod.ZodNumber;
+    }, zod_v4_core0.$strip>, zod.ZodObject<{
+      role: zod.ZodLiteral<"toolResult">;
+      toolCallId: zod.ZodString;
+      toolName: zod.ZodString;
+      content: zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
+        type: zod.ZodLiteral<"text">;
+        text: zod.ZodString;
+        textSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"thinking">;
+        thinking: zod.ZodString;
+        thinkingSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"image">;
+        data: zod.ZodString;
+        mimeType: zod.ZodString;
+      }, zod_v4_core0.$strip>, zod.ZodObject<{
+        type: zod.ZodLiteral<"toolCall">;
+        id: zod.ZodString;
+        name: zod.ZodString;
+        arguments: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
+        thoughtSignature: zod.ZodOptional<zod.ZodString>;
+      }, zod_v4_core0.$strip>]>>;
+      details: zod.ZodOptional<zod.ZodUnknown>;
+      isError: zod.ZodBoolean;
+      timestamp: zod.ZodNumber;
+    }, zod_v4_core0.$strip>]>>;
+    trace: zod.ZodArray<zod.ZodObject<{
+      type: zod.ZodString;
+      timestamp: zod.ZodOptional<zod.ZodNumber>;
+    }, zod_v4_core0.$strip>>;
+    summaries: zod.ZodArray<zod.ZodObject<{
+      turn: zod.ZodNumber;
+      assistant: zod.ZodNullable<zod.ZodAny>;
+      summary: zod.ZodNullable<zod.ZodString>;
+    }, zod_v4_core0.$strip>>;
+  }, zod_v4_core0.$strip>, "WORKFLOWS_REQUIRED" | "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
+  useCreateSession: FragnoReactMutator<NonGetHTTPMethod, "/sessions", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | zod.ZodObject<{
+    agent: zod.ZodString;
+    name: zod.ZodOptional<zod.ZodString>;
+    metadata: zod.ZodOptional<zod.ZodAny>;
+    tags: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
+    steeringMode: zod.ZodOptional<zod.ZodEnum<{
+      all: "all";
+      "one-at-a-time": "one-at-a-time";
+    }>>;
+  }, zod_v4_core0.$strip> | undefined, zod.ZodObject<{
+    id: zod.ZodString;
+    name: zod.ZodNullable<zod.ZodString>;
+    status: zod.ZodEnum<{
+      active: "active";
+      paused: "paused";
+      errored: "errored";
+      terminated: "terminated";
+      complete: "complete";
+      waiting: "waiting";
+    }>;
+    agent: zod.ZodString;
+    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
+    steeringMode: zod.ZodEnum<{
+      all: "all";
+      "one-at-a-time": "one-at-a-time";
+    }>;
+    metadata: zod.ZodNullable<zod.ZodAny>;
+    tags: zod.ZodArray<zod.ZodString>;
+    createdAt: zod.ZodDate;
+    updatedAt: zod.ZodDate;
+  }, zod_v4_core0.$strip> | zod.ZodArray<zod.ZodObject<{
+    id: zod.ZodString;
+    name: zod.ZodNullable<zod.ZodString>;
+    status: zod.ZodEnum<{
+      active: "active";
+      paused: "paused";
+      errored: "errored";
+      terminated: "terminated";
+      complete: "complete";
+      waiting: "waiting";
+    }>;
+    agent: zod.ZodString;
+    workflowInstanceId: zod.ZodNullable<zod.ZodString>;
+    steeringMode: zod.ZodEnum<{
+      all: "all";
+      "one-at-a-time": "one-at-a-time";
+    }>;
+    metadata: zod.ZodNullable<zod.ZodAny>;
+    tags: zod.ZodArray<zod.ZodString>;
+    createdAt: zod.ZodDate;
+    updatedAt: zod.ZodDate;
+  }, zod_v4_core0.$strip>> | undefined, string, string>;
+  useSendMessage: FragnoReactMutator<NonGetHTTPMethod, "/sessions/:sessionId/messages", zod.ZodObject<{
+    text: zod.ZodString;
+    done: zod.ZodOptional<zod.ZodBoolean>;
+    steeringMode: zod.ZodOptional<zod.ZodEnum<{
+      all: "all";
+      "one-at-a-time": "one-at-a-time";
+    }>>;
+  }, zod_v4_core0.$strip> | undefined, zod.ZodObject<{
+    status: zod.ZodEnum<{
+      active: "active";
+      paused: "paused";
+      errored: "errored";
+      terminated: "terminated";
+      complete: "complete";
+      waiting: "waiting";
+    }>;
+  }, zod_v4_core0.$strip> | undefined, "WORKFLOWS_REQUIRED" | "SESSION_NOT_FOUND" | "WORKFLOW_INSTANCE_MISSING", string>;
+};
+//#endregion
+export { createPiFragmentClient };
+//# sourceMappingURL=react.d.ts.map

package/dist/browser/client/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":["ExtractPathParamsOrWiden","HasPathParams","MaybeExtractPathParamsOrWiden","QueryParamsHint","InferOr","NonGetHTTPMethod","FragnoClientError","FragnoClientHookData","FragnoClientMutatorData","FragnoStoreData","ReadableAtom","Store","StoreValue","FetcherValue","react0","DependencyList","StandardSchemaV1","FragnoReactHook","_TMethod","TPath$1","TOutputSchema$1","TErrorCode$1","TQueryParameters$1","InferOutput","NonNullable","path","query","args","FragnoReactMutator","TInputSchema","body","Promise","mutate","loading","error","data","FragnoReactStore","T","TStore","K","useFragno","Record","TPath","TOutputSchema","TErrorCode","TQueryParameters","TMethod","TInput","TOutput","TError","TStoreObj","clientObj","StoreKeys","setKey","k","v","UseStoreOptions","SomeStore","deps","keys","useStore","store","options","FragnoHydrator","children","React","ReactNode"],"sources":["../../../../fragno/dist/client/react.d.ts","../../../src/client/react.ts"],"mappings":";;;;;;;;;KAYKiB,eAAAA,yEAAwFD,gBAAAA,qEAAqFW,IAAAA;EAChLF,IAAAA,GAAOvB,6BAAAA,CAA8BiB,OAAAA,WAAkBT,YAAAA;EACvDgB,KAAAA,GAAQvB,eAAAA,CAAgBmB,kBAAAA,WAA6BZ,YAAAA;AAAAA,MACjDG,YAAAA,CAAaG,gBAAAA,CAAiBO,WAAAA,CAAYH,eAAAA,GAAkBd,iBAAAA,CAAkBkB,WAAAA,CAAYH,YAAAA;AAAAA,KAC3FO,kBAAAA,kBAAoCvB,gBAAAA,+CAA+DW,gBAAAA,sCAAsDA,gBAAAA;EAC5JgB,MAAAA;IACEF,IAAAA;IACAL,IAAAA;IACAC;EAAAA;IAEAI,IAAAA,GAAO1B,OAAAA,CAAQyB,YAAAA;IACfJ,IAAAA,GAAOxB,aAAAA,CAAckB,OAAAA,iBAAwBnB,wBAAAA,CAAyBmB,OAAAA,WAAkBT,YAAAA;IACxFgB,KAAAA,GAAQvB,eAAAA,CAAgBmB,kBAAAA,WAA6BZ,YAAAA;EAAAA,MACjDqB,OAAAA,CAAQ3B,OAAAA,CAAQgB,eAAAA;EACtBa,OAAAA;EACAC,KAAAA,GAAQ5B,iBAAAA,CAAkBkB,WAAAA,CAAYH,YAAAA;EACtCc,IAAAA,GAAO/B,OAAAA,CAAQgB,eAAAA;AAAAA;;;;;;iBCxBD,sBAAA,CAAuB,MAAA,GAAQ,wBAAA;;QAA6B,GAAA,CAAA,SAAA"}

package/dist/browser/client/react.js

@@ -0,0 +1,84 @@
+import { f as isGetHook, h as isReadableAtom, m as isStore, o as createPiFragmentClients, p as isMutatorHook } from "../factory-DKoO_lRA.js";
+import "../index.js";
+import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
+
+//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/listen-keys/index.js
+function listenKeys($store, keys, listener) {
+	let keysSet = new Set(keys).add(void 0);
+	return $store.listen((value, oldValue, changed) => {
+		if (keysSet.has(changed)) listener(value, oldValue, changed);
+	});
+}
+
+//#endregion
+//#region ../fragno/dist/client/react.js
+function createReactHook(hook) {
+	return ({ path, query } = {}) => {
+		const pathParamValues = path ? Object.values(path) : [];
+		const queryParamValues = query ? Object.values(query) : [];
+		const store = useMemo(() => hook.store({
+			path,
+			query
+		}), [hook, ...[...pathParamValues, ...queryParamValues]]);
+		if (typeof window === "undefined") return store.get();
+		return useStore(store);
+	};
+}
+function createReactMutator(hook) {
+	return () => {
+		return useStore(useMemo(() => hook.mutatorStore, [hook]));
+	};
+}
+function createReactStore(hook) {
+	if (isReadableAtom(hook.obj)) return () => useStore(hook.obj);
+	return () => {
+		const result = {};
+		for (const key in hook.obj) {
+			if (!Object.prototype.hasOwnProperty.call(hook.obj, key)) continue;
+			const value = hook.obj[key];
+			if (isReadableAtom(value)) result[key] = useStore(value);
+			else result[key] = value;
+		}
+		return result;
+	};
+}
+function useFragno(clientObj) {
+	const result = {};
+	for (const key in clientObj) {
+		if (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;
+		const hook = clientObj[key];
+		if (isGetHook(hook)) result[key] = createReactHook(hook);
+		else if (isMutatorHook(hook)) result[key] = createReactMutator(hook);
+		else if (isStore(hook)) result[key] = createReactStore(hook);
+		else result[key] = hook;
+	}
+	return result;
+}
+function useStore(store, options = {}) {
+	const snapshotRef = useRef(store.get());
+	const { keys, deps = [store, keys] } = options;
+	const subscribe = useCallback((onChange) => {
+		const emitChange = (value) => {
+			if (snapshotRef.current === value) return;
+			snapshotRef.current = value;
+			onChange();
+		};
+		emitChange(store.value);
+		if (keys?.length) return listenKeys(store, keys, emitChange);
+		return store.listen(emitChange);
+	}, deps);
+	const get = () => snapshotRef.current;
+	return useSyncExternalStore(subscribe, get, () => {
+		return get();
+	});
+}
+
+//#endregion
+//#region src/client/react.ts
+function createPiFragmentClient(config = {}) {
+	return useFragno(createPiFragmentClients(config));
+}
+
+//#endregion
+export { createPiFragmentClient };
+//# sourceMappingURL=react.js.map

package/dist/browser/client/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":["listenKeys","$store","keys","listener","keysSet","Set","add","undefined","listen","value","oldValue","changed","has","subscribeKeys","unbind","hydrateFromWindow","isReadableAtom","isGetHook","isMutatorHook","isStore","listenKeys","useCallback","useMemo","useRef","useSyncExternalStore","createReactHook","hook","path","query","pathParamValues","Object","values","queryParamValues","store","window","get","useStore","createReactMutator","mutatorStore","createReactStore","obj","result","key","prototype","hasOwnProperty","call","value","useFragno","clientObj","options","snapshotRef","keys","deps","subscribe","onChange","emitChange","current","length","listen","FragnoHydrator","children","useFragno","FragnoPublicClientConfig","createPiFragmentClients","createPiFragmentClient","config"],"sources":["../../../../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/listen-keys/index.js","../../../../fragno/dist/client/react.js","../../../src/client/react.ts"],"sourcesContent":["export function listenKeys($store, keys, listener) {\n  let keysSet = new Set(keys).add(undefined)\n  return $store.listen((value, oldValue, changed) => {\n    if (keysSet.has(changed)) {\n      listener(value, oldValue, changed)\n    }\n  })\n}\n\nexport function subscribeKeys($store, keys, listener) {\n  let unbind = listenKeys($store, keys, listener)\n  listener($store.value)\n  return unbind\n}\n","import { hydrateFromWindow } from \"../util/ssr.js\";\nimport { isReadableAtom } from \"../util/nanostores.js\";\nimport { isGetHook, isMutatorHook, isStore } from \"./client.js\";\nimport { listenKeys } from \"nanostores\";\nimport { useCallback, useMemo, useRef, useSyncExternalStore } from \"react\";\n\n//#region src/client/react.ts\nfunction createReactHook(hook) {\n\treturn ({ path, query } = {}) => {\n\t\tconst pathParamValues = path ? Object.values(path) : [];\n\t\tconst queryParamValues = query ? Object.values(query) : [];\n\t\tconst store = useMemo(() => hook.store({\n\t\t\tpath,\n\t\t\tquery\n\t\t}), [hook, ...[...pathParamValues, ...queryParamValues]]);\n\t\tif (typeof window === \"undefined\") return store.get();\n\t\treturn useStore(store);\n\t};\n}\nfunction createReactMutator(hook) {\n\treturn () => {\n\t\treturn useStore(useMemo(() => hook.mutatorStore, [hook]));\n\t};\n}\nfunction createReactStore(hook) {\n\tif (isReadableAtom(hook.obj)) return () => useStore(hook.obj);\n\treturn () => {\n\t\tconst result = {};\n\t\tfor (const key in hook.obj) {\n\t\t\tif (!Object.prototype.hasOwnProperty.call(hook.obj, key)) continue;\n\t\t\tconst value = hook.obj[key];\n\t\t\tif (isReadableAtom(value)) result[key] = useStore(value);\n\t\t\telse result[key] = value;\n\t\t}\n\t\treturn result;\n\t};\n}\nfunction useFragno(clientObj) {\n\tconst result = {};\n\tfor (const key in clientObj) {\n\t\tif (!Object.prototype.hasOwnProperty.call(clientObj, key)) continue;\n\t\tconst hook = clientObj[key];\n\t\tif (isGetHook(hook)) result[key] = createReactHook(hook);\n\t\telse if (isMutatorHook(hook)) result[key] = createReactMutator(hook);\n\t\telse if (isStore(hook)) result[key] = createReactStore(hook);\n\t\telse result[key] = hook;\n\t}\n\treturn result;\n}\nfunction useStore(store, options = {}) {\n\tconst snapshotRef = useRef(store.get());\n\tconst { keys, deps = [store, keys] } = options;\n\tconst subscribe = useCallback((onChange) => {\n\t\tconst emitChange = (value) => {\n\t\t\tif (snapshotRef.current === value) return;\n\t\t\tsnapshotRef.current = value;\n\t\t\tonChange();\n\t\t};\n\t\temitChange(store.value);\n\t\tif (keys?.length) return listenKeys(store, keys, emitChange);\n\t\treturn store.listen(emitChange);\n\t}, deps);\n\tconst get = () => snapshotRef.current;\n\treturn useSyncExternalStore(subscribe, get, () => {\n\t\treturn get();\n\t});\n}\nfunction FragnoHydrator({ children }) {\n\tuseMemo(() => {\n\t\thydrateFromWindow();\n\t}, []);\n\treturn children;\n}\n\n//#endregion\nexport { FragnoHydrator, useFragno, useStore };\n//# sourceMappingURL=react.js.map","import { useFragno } from \"@fragno-dev/core/react\";\nimport type { FragnoPublicClientConfig } from \"@fragno-dev/core/client\";\nimport { createPiFragmentClients } from \"..\";\n\nexport function createPiFragmentClient(config: FragnoPublicClientConfig = {}) {\n  return useFragno(createPiFragmentClients(config));\n}\n"],"x_google_ignoreList":[0],"mappings":";;;;;AAAA,SAAgBA,WAAWC,QAAQC,MAAMC,UAAU;CACjD,IAAIC,UAAU,IAAIC,IAAIH,KAAK,CAACI,IAAIC,OAAU;AAC1C,QAAON,OAAOO,QAAQC,OAAOC,UAAUC,YAAY;AACjD,MAAIP,QAAQQ,IAAID,QAAQ,CACtBR,UAASM,OAAOC,UAAUC,QAAQ;GAEpC;;;;;ACCJ,SAASc,gBAAgBC,MAAM;AAC9B,SAAQ,EAAEC,MAAMC,UAAU,EAAE,KAAK;EAChC,MAAMC,kBAAkBF,OAAOG,OAAOC,OAAOJ,KAAK,GAAG,EAAE;EACvD,MAAMK,mBAAmBJ,QAAQE,OAAOC,OAAOH,MAAM,GAAG,EAAE;EAC1D,MAAMK,QAAQX,cAAcI,KAAKO,MAAM;GACtCN;GACAC;GACA,CAAC,EAAE,CAACF,MAAM,GAAG,CAAC,GAAGG,iBAAiB,GAAGG,iBAAiB,CAAC,CAAC;AACzD,MAAI,OAAOE,WAAW,YAAa,QAAOD,MAAME,KAAK;AACrD,SAAOC,SAASH,MAAM;;;AAGxB,SAASI,mBAAmBX,MAAM;AACjC,cAAa;AACZ,SAAOU,SAASd,cAAcI,KAAKY,cAAc,CAACZ,KAAK,CAAC,CAAC;;;AAG3D,SAASa,iBAAiBb,MAAM;AAC/B,KAAIV,eAAeU,KAAKc,IAAI,CAAE,cAAaJ,SAASV,KAAKc,IAAI;AAC7D,cAAa;EACZ,MAAMC,SAAS,EAAE;AACjB,OAAK,MAAMC,OAAOhB,KAAKc,KAAK;AAC3B,OAAI,CAACV,OAAOa,UAAUC,eAAeC,KAAKnB,KAAKc,KAAKE,IAAI,CAAE;GAC1D,MAAMI,QAAQpB,KAAKc,IAAIE;AACvB,OAAI1B,eAAe8B,MAAM,CAAEL,QAAOC,OAAON,SAASU,MAAM;OACnDL,QAAOC,OAAOI;;AAEpB,SAAOL;;;AAGT,SAASM,UAAUC,WAAW;CAC7B,MAAMP,SAAS,EAAE;AACjB,MAAK,MAAMC,OAAOM,WAAW;AAC5B,MAAI,CAAClB,OAAOa,UAAUC,eAAeC,KAAKG,WAAWN,IAAI,CAAE;EAC3D,MAAMhB,OAAOsB,UAAUN;AACvB,MAAIzB,UAAUS,KAAK,CAAEe,QAAOC,OAAOjB,gBAAgBC,KAAK;WAC/CR,cAAcQ,KAAK,CAAEe,QAAOC,OAAOL,mBAAmBX,KAAK;WAC3DP,QAAQO,KAAK,CAAEe,QAAOC,OAAOH,iBAAiBb,KAAK;MACvDe,QAAOC,OAAOhB;;AAEpB,QAAOe;;AAER,SAASL,SAASH,OAAOgB,UAAU,EAAE,EAAE;CACtC,MAAMC,cAAc3B,OAAOU,MAAME,KAAK,CAAC;CACvC,MAAM,EAAEgB,MAAMC,OAAO,CAACnB,OAAOkB,KAAI,KAAMF;CACvC,MAAMI,YAAYhC,aAAaiC,aAAa;EAC3C,MAAMC,cAAcT,UAAU;AAC7B,OAAII,YAAYM,YAAYV,MAAO;AACnCI,eAAYM,UAAUV;AACtBQ,aAAU;;AAEXC,aAAWtB,MAAMa,MAAM;AACvB,MAAIK,MAAMM,OAAQ,QAAOrC,WAAWa,OAAOkB,MAAMI,WAAW;AAC5D,SAAOtB,MAAMyB,OAAOH,WAAW;IAC7BH,KAAK;CACR,MAAMjB,YAAYe,YAAYM;AAC9B,QAAOhC,qBAAqB6B,WAAWlB,WAAW;AACjD,SAAOA,KAAK;GACX;;;;;AC7DH,SAAgB6B,uBAAuBC,SAAmC,EAAE,EAAE;AAC5E,QAAOJ,UAAUE,wBAAwBE,OAAO,CAAC"}