@manta-eu/horns-client 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { AppRoutes, hornsRoutes } from "./app/routes.tsx";
+export { HornsApp } from "./standalone/app.tsx";
 export { AppShell } from "./components/app-shell.tsx";
 export { signInHref } from "./lib/manta/sign-in.ts";
 export { useSparqlSelect } from "./lib/manta/sparql-select.ts";

package/dist/index.js

@@ -1,9 +1,15 @@
 // The Horns app, as a library.
 //
-// A host mounts `<HornsRoutes />` inside its own router, or takes `mountHorns` for a page of its own. What
-// the browser needs beyond this is the stylesheet: `@manta-eu/horns-client/styles.css`, built here rather
-// than compiled by the host, so a host with no Tailwind still gets the app looking like Manta.
+// Horns is a page rather than a subtree: `Providers` renders the SDK's own <Router>, scoped by basename to
+// /d/<datastore>, and React Router allows no second one. So a host takes `mountHorns` for a page of its own,
+// or renders `<HornsApp />` under providers it builds itself. `hornsRoutes()` is for a host doing the latter
+// and wanting its own 404 — spliced into a <Routes> under that basename, never nested in a second router.
+// What the browser needs beyond this is the stylesheet: `@manta-eu/horns-client/styles.css`, built here
+// rather than compiled by the host, so a host with no Tailwind still gets the app looking like Manta.
 export { AppRoutes, hornsRoutes } from "./app/routes.js";
+// The session gate, and the only thing that provides the AuthContext every Horns page reads. A host
+// splicing `hornsRoutes()` into a router of its own mounts this above them, or provides that context itself.
+export { HornsApp } from "./standalone/app.js";
 export { AppShell } from "./components/app-shell.js";
 export { signInHref } from "./lib/manta/sign-in.js";
 export { useSparqlSelect } from "./lib/manta/sparql-select.js";

package/dist/lib/manta/sparql-select.d.ts

@@ -1,6 +1,16 @@
 import { SparqlReadError, type SparqlSelect } from "@manta-eu/horns";
-import type { GraphQLClient } from "graphql-request";
-export declare function graphqlSparqlSelect(client: GraphQLClient): SparqlSelect;
-/** The reader this app's pages use. The datastore rides on the client, from the route. */
+import { useMantaClient } from "@manta-eu/react/providers";
+type SparqlFetch = ReturnType<typeof useMantaClient>["sparqlFetch"];
+/**
+ * Reads over `/sparql`, which is the endpoint that checks them.
+ *
+ * Not agents' `sparqlQuery` field: a query travelling as a GraphQL variable is not a request body, so no
+ * proxy's read-only check sees it, and a host would have to allow `/graphql` to let a Horn draw at all.
+ *
+ * Imperative rather than a hook: a `SparqlSelect` is called from inside query functions and from readers
+ * that issue one query after another, which a hook cannot serve.
+ */
+export declare function httpSparqlSelect(sparqlFetch: SparqlFetch): SparqlSelect;
+/** The reader this app's pages use. The datastore rides on the fetch, from the route. */
 export declare function useSparqlSelect(): SparqlSelect;
 export { SparqlReadError };

package/dist/lib/manta/sparql-select.js

@@ -1,22 +1,38 @@
 import { useMemo } from "react";
-import { sparqlResultsOfGraphqlField, SparqlReadError } from "@manta-eu/horns";
-import { SparqlQueryDocument } from "@manta-eu/client";
+import { SparqlReadError, sparqlResultsSchema } from "@manta-eu/horns";
 import { useMantaClient } from "@manta-eu/react/providers";
-// Imperative rather than `useSparqlQueryQuery`: a `SparqlSelect` is called from inside query functions and
-// from readers that issue one query after another, which a hook cannot serve.
-export function graphqlSparqlSelect(client) {
+/** What a refused or failed read says, where the worker answered `{ error }` rather than results. */
+async function refusalOf(response) {
+    const body = await response.json().catch(() => undefined);
+    if (typeof body === "object" && body !== null && "error" in body && typeof body.error === "string") {
+        return body.error;
+    }
+    return `The read failed (${response.status}).`;
+}
+/**
+ * Reads over `/sparql`, which is the endpoint that checks them.
+ *
+ * Not agents' `sparqlQuery` field: a query travelling as a GraphQL variable is not a request body, so no
+ * proxy's read-only check sees it, and a host would have to allow `/graphql` to let a Horn draw at all.
+ *
+ * Imperative rather than a hook: a `SparqlSelect` is called from inside query functions and from readers
+ * that issue one query after another, which a hook cannot serve.
+ */
+export function httpSparqlSelect(sparqlFetch) {
     return async (query, signal) => {
-        const answer = await client.request({
-            document: SparqlQueryDocument,
-            variables: { query },
-            ...(signal ? { signal } : {}),
-        });
-        return sparqlResultsOfGraphqlField(answer.sparqlQuery);
+        const response = await sparqlFetch(query, signal ? { signal } : {});
+        if (!response.ok)
+            throw new SparqlReadError(await refusalOf(response));
+        const body = await response.json().catch(() => undefined);
+        const parsed = sparqlResultsSchema.safeParse(body);
+        if (!parsed.success)
+            throw new SparqlReadError("The query answered something other than results.");
+        return parsed.data;
     };
 }
-/** The reader this app's pages use. The datastore rides on the client, from the route. */
+/** The reader this app's pages use. The datastore rides on the fetch, from the route. */
 export function useSparqlSelect() {
-    const { mantaClient } = useMantaClient();
-    return useMemo(() => graphqlSparqlSelect(mantaClient), [mantaClient]);
+    const { sparqlFetch } = useMantaClient();
+    return useMemo(() => httpSparqlSelect(sparqlFetch), [sparqlFetch]);
 }
 export { SparqlReadError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manta-eu/horns-client",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "The Manta Horns app as a library: routes, providers and the written-view runtime for a React host.",
   "license": "MIT",
   "repository": {
@@ -60,15 +60,14 @@
     "@manta-eu/lib": "0.1.5",
     "@ulb-darmstadt/shacl-form": "^2.1.1-rc1",
     "@xyflow/react": "^12.4.4",
-    "graphql-request": "^7.3.0",
     "html-to-image": "1.11.13",
     "ldkit": "2.9.0",
     "lucide-react": "^0.525.0",
     "ts-pattern": "^5.9.0",
     "zod": "^4.5.4",
-    "@manta-eu/horns": "0.1.2",
-    "@manta-eu/horns-kit": "0.1.2",
-    "@manta-eu/horns-server": "0.1.2"
+    "@manta-eu/horns": "0.1.4",
+    "@manta-eu/horns-kit": "0.1.4",
+    "@manta-eu/horns-server": "0.1.4"
   },
   "devDependencies": {
     "@manta-eu/ldo": "0.1.5",