@nxara/olio-client 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nxara 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

@@ -1,3 +1,281 @@
-# Temporary Holding Version
+# @nxara/olio-client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A typed GraphQL client for Nxara apps. You write operations in `.graphql` files; codegen turns them into typed documents, the way graphql-codegen does; the client gives you one call per operation:
+
+```ts
+const { data } = await client.mutation.login({ email, password }, { headers });
+```
+
+```sh
+bun add @nxara/olio-client graphql@16
+```
+
+`graphql` 16 is a peer dependency (not 17, which is about 4× slower on small queries). For subscriptions, add [graphql-ws](https://github.com/enisdenjo/graphql-ws) and/or [graphql-sse](https://github.com/enisdenjo/graphql-sse): the client takes your own clients of them.
+
+## Operations
+
+```graphql
+# src/operations/auth.graphql
+mutation Login($email: String!, $password: String!) {
+  login(email: $email, password: $password) {
+    __typename
+    ... on Session {
+      token
+    }
+    ... on UserError {
+      message
+    }
+  }
+}
+```
+
+## Codegen
+
+`codegenClient` reads the schema (a file, or the running server's URL by introspection) and the operations, checks the operations against the schema (errors point at `file:line:column`), and writes the types:
+
+```ts
+import { codegenClient } from "@nxara/olio-codegen";
+
+await codegenClient({
+  schema: "../server/src/schema.gql", // or "http://localhost:4000/graphql"
+  documents: "src/operations/*.graphql",
+  output: "src/generated.ts",
+  headers: { authorization: "Bearer …" } // only for a URL that needs it
+});
+```
+
+Per operation, named the way graphql-codegen names them: `LoginMutation` (the result), `LoginMutationVariables` and `LoginDocument`. Plus `operations`, every document by root and name, which the client takes.
+
+## Calls
+
+```ts
+import { createClient } from "@nxara/olio-client";
+
+import { operations } from "./generated.js";
+
+const client = createClient(operations, {
+  url: "https://erp.example/graphql",
+  // Nothing before sign-in: an `undefined` value is left out, not sent as text.
+  headers: () => ({ authorization: token && `Bearer ${token}` })
+});
+
+const { data, errors } = await client.mutation.login({ email, password });
+if (data?.login.__typename === "Session") data.login.token;
+```
+
+- `client.<query | mutation | subscription>.<operation>(variables?, options?)`. The operation's name with its first letter lowercased: `mutation Login` is `client.mutation.login`.
+- Variables are typed from the operation; they may be left out when none are required.
+- `data` is the operation's result, typed from its selection: fragments narrow on `__typename`, fields under `@include` / `@skip` are optional. `errors` are the GraphQL errors as the server sent them. A response that isn't GraphQL at all (a proxy's 502 page) rejects.
+- `options` takes per-call `headers` and a `signal`.
+- Headers, on the client or per call, are an object, a `Headers`, or entries; in an object, `undefined` values are left out (`token ? { authorization } : {}` works too). The call's win.
+
+## Custom fetch
+
+`fetch` takes anything fetch-shaped, such as a ky instance:
+
+```ts
+import ky from "ky";
+
+createClient(operations, { url, fetch: ky.create({ throwHttpErrors: false }) });
+```
+
+GraphQL errors can come with 4xx/5xx statuses, so ky needs `throwHttpErrors: false`. A library that isn't fetch-shaped, such as axios, needs a few lines that return a `Response`:
+
+```ts
+import type { Fetch } from "@nxara/olio-client";
+
+const axiosFetch: Fetch = async (url, init) => {
+  const res = await axios.request({
+    url,
+    method: init.method,
+    headers: Object.fromEntries(new Headers(init.headers)),
+    data: init.body,
+    signal: init.signal ?? undefined,
+    responseType: "text",
+    validateStatus: () => true // GraphQL errors come with 4xx/5xx too
+  });
+  return new Response(res.data, {
+    status: res.status,
+    headers: res.headers as Record<string, string>
+  });
+};
+```
+
+`fetch` is for queries and mutations; subscriptions go through your own clients.
+
+## Uploading files
+
+The client sends JSON, and a `File` in JSON is `{}`. `fetch` also gets the request before JSON, with the variables as you passed them, so it can send them the [multipart request spec](https://github.com/jaydenseric/graphql-multipart-request-spec)'s way instead:
+
+```ts
+import type { Fetch } from "@nxara/olio-client";
+
+const multipart: Fetch = (url, init, { query, variables, operationName }) => {
+  const files = new Map<File, string[]>();
+  // Files leave the variables (null in their place); `map` says where each goes back.
+  const strip = (value: unknown, path: string): unknown => {
+    if (value instanceof File) {
+      files.set(value, [...(files.get(value) ?? []), path]);
+      return null;
+    }
+    if (Array.isArray(value)) {
+      return value.map((v, i) => strip(v, `${path}.${i}`));
+    }
+    if (value && typeof value === "object") {
+      return Object.fromEntries(
+        Object.entries(value).map(([k, v]) => [k, strip(v, `${path}.${k}`)])
+      );
+    }
+    return value;
+  };
+  const stripped = strip(variables, "variables");
+  if (files.size === 0) return fetch(url, init);
+
+  const form = new FormData();
+  form.set(
+    "operations",
+    JSON.stringify({ query, variables: stripped, operationName })
+  );
+  form.set(
+    "map",
+    JSON.stringify(Object.fromEntries([...files.values()].entries()))
+  );
+  for (const [i, file] of [...files.keys()].entries())
+    form.set(String(i), file);
+
+  const headers = new Headers(init.headers);
+  headers.delete("content-type"); // fetch sets it, with the boundary
+  headers.set("x-upload", "1"); // browsers can't add it cross-site, so the server can refuse CSRF
+  return fetch(url, { ...init, headers, body: form });
+};
+
+const client = createClient(operations, { url, fetch: multipart });
+await client.mutation.uploadAvatar({ file });
+```
+
+Register the scalar as `File` (`interface ClientScalars { Upload: File }`). On the server, `@nxara/olio-http` passes graphql-http's `parseRequestParams` through, which puts the files back:
+
+```ts
+fetchHandler(app, {
+  context,
+  parseRequestParams: async (req) => {
+    const request = req.raw as Request;
+    if (!request.headers.get("content-type")?.startsWith("multipart/form-data"))
+      return; // JSON, as usual
+    if (!request.headers.get("x-upload"))
+      return new Response(null, { status: 400 });
+    const form = await request.formData();
+    const params = JSON.parse(String(form.get("operations")));
+    const map: Record<string, string[]> = JSON.parse(String(form.get("map")));
+    for (const [key, paths] of Object.entries(map)) {
+      for (const path of paths) setPath(params, path, form.get(key)); // e.g. lodash's set
+    }
+    return params;
+  }
+});
+```
+
+with `scalar Upload` in the SDL, typed `File` in `CustomScalars`. Size limits are the server's (or its proxy's). Many apps skip all this: a mutation returns a signed upload URL, and the browser sends the file straight to storage.
+
+## Scalars
+
+The way the server's `CustomScalars` works: one type, or `{ input; output }` when variables and results differ. Custom scalars are `unknown` until registered:
+
+```ts
+declare module "@nxara/olio-client" {
+  interface ClientScalars {
+    DateTime: { input: Date | string; output: string };
+  }
+}
+```
+
+Put it in a `.ts` file, or a `.d.ts` with an `import` or `export {}`.
+
+Enums arrive by name (`"CONFIRMED"`), not as the server's internal values.
+
+## Subscriptions
+
+Over WebSocket by default ([graphql-ws](https://github.com/enisdenjo/graphql-ws)), or as server-sent events on the same URL ([graphql-sse](https://github.com/enisdenjo/graphql-sse)) for an operation marked `@sse`. The choice lives in the operation; the directive is the client's, and codegen removes it from the query the server receives:
+
+```graphql
+subscription StockChanged($sku: String) {
+  # WebSocket
+  stockChanged(sku: $sku) {
+    sku
+    onHand
+  }
+}
+
+subscription Notifications @sse {
+  # server-sent events
+  notifications {
+    message
+  }
+}
+```
+
+```ts
+for await (const { data } of client.subscription.stockChanged({ sku: "CHAIR-01" })) {
+  console.log(data?.stockChanged.onHand);
+}
+```
+
+They go through your own [graphql-ws](https://github.com/enisdenjo/graphql-ws) and [graphql-sse](https://github.com/enisdenjo/graphql-sse) clients, which `createClient` requires as `ws` and `sse` once an operation uses that transport (and rejects when none does):
+
+```ts
+import { createClient as createSseClient } from "graphql-sse";
+import { createClient as createWsClient } from "graphql-ws";
+
+const headers = () => ({ authorization: token && `Bearer ${token}` });
+const ws = createWsClient({
+  url: "wss://erp.example/graphql",
+  // Browsers can't set headers on a WebSocket: send them here.
+  connectionParams: () => ({ headers: headers() })
+});
+const client = createClient(operations, {
+  url: "https://erp.example/graphql",
+  headers,
+  ws,
+  sse: createSseClient({ url: "https://erp.example/graphql", headers })
+});
+```
+
+The client calls their `iterate` and types the results; the rest is theirs and yours to configure: connecting, retries, keep-alive. Breaking out of the loop, or aborting `signal`, ends the subscription.
+
+- **New credentials:** graphql-ws sends `connectionParams` each time the socket connects. After the token changes, `ws.terminate()` reconnects, and graphql-ws resubscribes live subscriptions on the new socket. It waits out its retry backoff first (`retryWait`, about 1.3 to 4 s by default), and events sent in between are lost. An open SSE stream keeps its headers until you subscribe again.
+- **Refusals:** by default both libraries retry a refused connection for about 40 s before reporting it (graphql-ws on a 4403 close, graphql-sse on any response that isn't 2xx); `retryAttempts: 0` or graphql-ws's `shouldRetry` reports it at once. Then a WebSocket closed with a 4xxx code is an error result (`extensions: { code: "WEBSOCKET_CLOSED", closeCode }`), and graphql-sse throws its `NetworkError` (its `response` holds the status).
+- **Rejected operations** (the server's `onSubscribe` returning errors) are an error result on both, as over HTTP.
+
+## Bundle size
+
+The client imports neither library: an app bundles only the ones it creates clients with. The client's own code is about 1 KB gzipped.
+
+## Tests
+
+`testClient` from `@nxara/olio-client/test` is the same client, answered in-process like Hono's `testClient`, through the app's own servers: its fetch handler for queries and mutations, and for subscriptions the graphql-ws options it passes to `useServer` (run over an in-memory socket) and its graphql-sse handler. So tests run production's context, `onConnect`, `onSubscribe`, error masking and cleanup. No server is started:
+
+```ts
+import { testClient } from "@nxara/olio-client/test";
+
+// The same objects the server uses.
+import { graphqlHandler } from "../src/http.js";
+import { sseHandler, wsOptions } from "../src/subscriptions.js";
+
+const client = testClient(
+  operations,
+  { http: graphqlHandler, ws: wsOptions, sse: sseHandler },
+  { headers: { authorization: `Bearer ${token}` } }
+);
+expect((await client.query.me()).data).toEqual({ me: { name: "Mia" } });
+```
+
+`ws` and `sse` are required exactly when an operation uses that transport; without subscriptions, the fetch handler alone is enough: `testClient(operations, graphqlHandler)`. Over WebSocket, the headers arrive as `connectionParams: { headers }`, and `ctx.extra` is empty (no socket or request in memory). Its clients never retry, since a failure in memory is final: a refusal over SSE throws at once. It's a separate import, so it never ends up in an app's bundle.
+
+## API
+
+|  |  |
+| --- | --- |
+| `createClient(operations, { url, headers?, fetch?, ws?, sse? })` | `headers`: an object, or a function for values that change. `fetch`: default the global one; called with `(url, init, params)`, `params` being the request before JSON (see Uploading files). `ws` / `sse`: your graphql-ws / graphql-sse client, required once an operation uses that transport |
+| `testClient(operations, handler \| { http, ws?, sse? }, { headers?, url? })` | From `@nxara/olio-client/test`: the same client, answered in-process |
+| `ClientScalars` | Augment it with how custom scalars arrive and are sent |
+| `TypedDocument`, `Result`, `Client`, `ClientOptions`, `Operations`, `SubscriptionClient` | The types behind the calls |

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Client, ClientOptions, Operations } from "./types.js";
+export type { Fetch, HeadersSource, RequestParams } from "./transport.js";
+export type { CallOptions, Client, ClientOptions, ClientScalars, GraphQLErrorJSON, Operations, Result, Scalar, SubscriptionClient, TypedDocument } from "./types.js";
+export declare function createClient<O extends Operations>(operations: O, options: ClientOptions<O>): Client<O>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,MAAM,EACN,aAAa,EACb,UAAU,EAIX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,MAAM,EACN,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,MAAM,EACN,MAAM,EACN,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAYpB,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAC/C,UAAU,EAAE,CAAC,EACb,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,MAAM,CAAC,CAAC,CAAC,CA+EX"}

package/dist/index.js

@@ -0,0 +1,58 @@
+import { asResult, errorResult, resolveHeaders, stream } from "./transport.js";
+const ACCEPT = "application/graphql-response+json, application/json";
+export function createClient(operations, options) {
+    const send = options.fetch ?? ((target, init) => fetch(target, init));
+    const subscriptionClients = options;
+    const request = async (document, variables, call = {}) => {
+        const headers = await resolveHeaders(options.headers, call.headers);
+        headers.set("accept", ACCEPT);
+        headers.set("content-type", "application/json");
+        const params = {
+            query: document.query,
+            variables,
+            operationName: document.name
+        };
+        const response = await send(String(options.url), {
+            method: "POST",
+            headers,
+            body: JSON.stringify(params),
+            signal: call.signal
+        }, params);
+        if (!response.headers.get("content-type")?.includes("json")) {
+            throw new Error(`${document.name}: HTTP ${response.status} ${response.statusText}`.trim());
+        }
+        return asResult((await response.json()));
+    };
+    async function* subscribe(document, variables, signal) {
+        const kind = document.transport ?? "ws";
+        const client = subscriptionClients[kind];
+        if (!client) {
+            throw new Error(`${document.name} subscribes over ${kind}: pass createClient a graphql-${kind} client as \`${kind}\``);
+        }
+        const events = client.iterate({
+            query: document.query,
+            variables: variables,
+            operationName: document.name
+        });
+        try {
+            for await (const event of stream(events, signal))
+                yield asResult(event);
+        }
+        catch (error) {
+            const result = errorResult(error);
+            if (!result)
+                throw error;
+            yield result;
+        }
+    }
+    return Object.fromEntries(["query", "mutation", "subscription"].map((root) => [
+        root,
+        Object.fromEntries(Object.entries((operations[root] ?? {})).map(([name, document]) => [
+            name,
+            (variables, call) => root === "subscription"
+                ? subscribe(document, variables, call?.signal)
+                : request(document, variables, call)
+        ]))
+    ]));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/test.d.ts

@@ -0,0 +1,15 @@
+import type { ServerOptions } from "graphql-ws";
+import { type HeadersSource, type MaybePromise } from "./transport.js";
+import type { Client, Operations, Transports } from "./types.js";
+type Handler = (request: Request) => MaybePromise<Response>;
+export type TestServer<O extends Operations = Operations> = {
+    http: Handler;
+} & {
+    readonly [K in Transports<O>]: K extends "ws" ? ServerOptions<never, never> : Handler;
+};
+export declare function testClient<O extends Operations>(operations: O, server: TestServer<O> | ([Transports<O>] extends [never] ? Handler : never), options?: {
+    url?: string | URL;
+    headers?: HeadersSource;
+}): Client<O>;
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAiB,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhF,KAAK,OAAO,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;AAmB5D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IAAI;IAE1D,IAAI,EAAE,OAAO,CAAC;CACf,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,GAKzC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,GAE3B,OAAO;CACZ,CAAC;AAuFF,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAC7C,UAAU,EAAE,CAAC,EACb,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC,EAC3E,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAO,GAC5D,MAAM,CAAC,CAAC,CAAC,CA6CX"}

package/dist/test.js

@@ -0,0 +1,97 @@
+import { createClient } from "./index.js";
+import { resolveHeaders } from "./transport.js";
+const graphqlWs = await import("graphql-ws").catch(() => undefined);
+const graphqlSse = await import("graphql-sse").catch(() => undefined);
+const installed = (module, name) => {
+    if (!module) {
+        throw new Error(`testClient: install ${name} to test subscriptions over it`);
+    }
+    return module;
+};
+function memoryWebSocket(ws, options) {
+    const graphqlWs = ws.makeServer(options);
+    return class Socket {
+        static CONNECTING = 0;
+        static OPEN = 1;
+        static CLOSING = 2;
+        static CLOSED = 3;
+        readyState = Socket.CONNECTING;
+        protocol = ws.GRAPHQL_TRANSPORT_WS_PROTOCOL;
+        onopen = null;
+        onmessage = null;
+        onclose = null;
+        onerror = null;
+        #receive;
+        #closed;
+        constructor() {
+            queueMicrotask(() => {
+                this.#closed = graphqlWs.opened({
+                    protocol: this.protocol,
+                    send: (data) => {
+                        if (this.readyState !== Socket.OPEN)
+                            return;
+                        queueMicrotask(() => this.onmessage?.({ data }));
+                    },
+                    close: (code, reason) => this.#finish(code, reason),
+                    onMessage: (receive) => {
+                        this.#receive = receive;
+                    }
+                }, {});
+                this.readyState = Socket.OPEN;
+                this.onopen?.({});
+            });
+        }
+        send(data) {
+            queueMicrotask(() => {
+                this.#receive?.(data).catch((error) => this.#finish(ws.CloseCode.InternalServerError, error instanceof Error ? error.message : String(error)));
+            });
+        }
+        close(code = 1000, reason = "") {
+            this.#finish(code, reason);
+        }
+        #finish(code = 1000, reason = "") {
+            if (this.readyState === Socket.CLOSED)
+                return;
+            this.readyState = Socket.CLOSED;
+            void this.#closed?.(code, reason);
+            queueMicrotask(() => this.onclose?.({ code, reason, wasClean: true }));
+        }
+    };
+}
+export function testClient(operations, server, options = {}) {
+    const handlers = (typeof server === "function" ? { http: server } : server);
+    for (const kind of operations.transports ?? []) {
+        if (!handlers[kind]) {
+            throw new Error(`These operations subscribe over ${kind}: pass testClient(operations, { http, ${kind} }) the app's own ${kind === "ws" ? "graphql-ws server options" : "graphql-sse handler"}`);
+        }
+    }
+    const url = String(options.url ?? "http://localhost/graphql");
+    const headers = async () => Object.fromEntries(await resolveHeaders(options.headers));
+    const fetch = async (target, init) => {
+        const request = new Request(target, init);
+        const streams = request.headers
+            .get("accept")
+            ?.includes("text/event-stream");
+        return handlers.sse && streams
+            ? handlers.sse(request)
+            : handlers.http(request);
+    };
+    const ws = handlers.ws && installed(graphqlWs, "graphql-ws");
+    const sse = handlers.sse && installed(graphqlSse, "graphql-sse");
+    return createClient(operations, {
+        url,
+        headers: options.headers,
+        fetch,
+        ws: ws &&
+            handlers.ws &&
+            ws.createClient({
+                url: url.replace(/^http/, "ws"),
+                webSocketImpl: memoryWebSocket(ws, handlers.ws),
+                retryAttempts: 0,
+                connectionParams: async () => ({ headers: await headers() })
+            }),
+        sse: sse &&
+            sse.createClient({ url, fetchFn: fetch, headers, retryAttempts: 0 })
+    });
+}
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,17 @@
+import type { GraphQLErrorJSON, HeadersValue, Result } from "./types.js";
+export interface RequestParams {
+    query: string;
+    variables: unknown;
+    operationName: string;
+}
+export type Fetch = (url: string, init: RequestInit, params: RequestParams) => Promise<Response>;
+export type MaybePromise<T> = T | Promise<T>;
+export type HeadersSource = HeadersValue | (() => MaybePromise<HeadersValue>);
+export declare const asResult: (body: {
+    data?: unknown;
+    errors?: readonly GraphQLErrorJSON[];
+}) => Result<never>;
+export declare function resolveHeaders(...sources: (HeadersSource | undefined)[]): Promise<Headers>;
+export declare function stream<T>(events: AsyncIterableIterator<T>, signal: AbortSignal | undefined): AsyncGenerator<T>;
+export declare function errorResult(error: unknown): Result<never> | undefined;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAKD,MAAM,MAAM,KAAK,GAAG,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,KAClB,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvB,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;AAE9E,eAAO,MAAM,QAAQ,SAAU;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACtC,KAAG,MAAM,CAAC,KAAK,CAGd,CAAC;AAkBH,wBAAsB,cAAc,CAClC,GAAG,OAAO,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC,EAAE,GACxC,OAAO,CAAC,OAAO,CAAC,CASlB;AAGD,wBAAuB,MAAM,CAAC,CAAC,EAC7B,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,cAAc,CAAC,CAAC,CAAC,CAQnB;AAkBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAcrE"}

package/dist/transport.js

@@ -0,0 +1,52 @@
+export const asResult = (body) => ({
+    data: (body.data ?? null),
+    ...(body.errors ? { errors: body.errors } : {})
+});
+function entries(headers) {
+    if (headers === undefined ||
+        Array.isArray(headers) ||
+        headers instanceof Headers) {
+        return new Headers(headers);
+    }
+    return Object.entries(headers).filter((entry) => entry[1] !== undefined);
+}
+export async function resolveHeaders(...sources) {
+    const resolved = await Promise.all(sources.map((source) => (typeof source === "function" ? source() : source)));
+    const merged = new Headers();
+    for (const headers of resolved) {
+        for (const [key, value] of entries(headers))
+            merged.set(key, value);
+    }
+    return merged;
+}
+export async function* stream(events, signal) {
+    const stop = () => void events.return?.();
+    signal?.addEventListener("abort", stop, { once: true });
+    try {
+        yield* events;
+    }
+    finally {
+        signal?.removeEventListener("abort", stop);
+    }
+}
+const isClose = (error) => typeof error === "object" &&
+    error !== null &&
+    "code" in error &&
+    "reason" in error;
+export function errorResult(error) {
+    if (Array.isArray(error)) {
+        return asResult({ errors: error });
+    }
+    if (!isClose(error) || error.code < 4000 || error.code > 4999)
+        return;
+    return {
+        data: null,
+        errors: [
+            {
+                message: error.reason || `WebSocket closed (${error.code})`,
+                extensions: { code: "WEBSOCKET_CLOSED", closeCode: error.code }
+            }
+        ]
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAGxB,EAAiB,EAAE,CAAC,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAU;IAClC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAGH,SAAS,OAAO,CACd,OAAiC;IAEjC,IACE,OAAO,KAAK,SAAS;QACrB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACtB,OAAO,YAAY,OAAO,EAC1B,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAA6B,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAG,OAAsC;IAEzC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAC5E,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAC3B,MAAgC,EAChC,MAA+B;IAE/B,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IAChD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,KAAK,CAAC,CAAC,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAOD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAuB,EAAE,CACtD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACf,QAAQ,IAAI,KAAK,CAAC;AAOpB,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,EAAE,MAAM,EAAE,KAA2B,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI;QAAE,OAAO;IACtE,OAAO;QACL,IAAI,EAAE,IAAI;QACV,MAAM,EAAE;YACN;gBACE,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,qBAAqB,KAAK,CAAC,IAAI,GAAG;gBAC3D,UAAU,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE;aAChE;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+import type { Fetch, HeadersSource } from "./transport.js";
+export interface ClientScalars {
+}
+interface DefaultScalars {
+    ID: string;
+    String: string;
+    Int: number;
+    Float: number;
+    Boolean: boolean;
+}
+export type Scalar<N extends string, D extends "input" | "output" = "output"> = N extends keyof ClientScalars ? ClientScalars[N] extends {
+    input: infer I;
+    output: infer O;
+} ? D extends "input" ? I : O : ClientScalars[N] : N extends keyof DefaultScalars ? DefaultScalars[N] : unknown;
+export type Operation = "query" | "mutation" | "subscription";
+export interface TypedDocument<Result, Variables, Op extends Operation = Operation> {
+    readonly operation: Op;
+    readonly name: string;
+    readonly query: string;
+    readonly transport?: "ws" | "sse";
+    readonly "~types"?: {
+        result: Result;
+        variables: Variables;
+    };
+}
+export interface GraphQLErrorJSON {
+    message: string;
+    locations?: readonly {
+        line: number;
+        column: number;
+    }[];
+    path?: readonly (string | number)[];
+    extensions?: Record<string, unknown>;
+}
+export interface Result<T> {
+    data: T | null;
+    errors?: readonly GraphQLErrorJSON[];
+}
+export type HeadersInit = ConstructorParameters<typeof Headers>[0];
+export type HeadersValue = HeadersInit | Readonly<Record<string, string | undefined>>;
+export interface CallOptions {
+    signal?: AbortSignal;
+    headers?: HeadersValue;
+}
+type RequiredKeys<T> = {
+    [K in keyof T]-?: object extends Pick<T, K> ? never : K;
+}[keyof T];
+export type VariablesArgs<V, O> = [RequiredKeys<V>] extends [never] ? [variables?: V, options?: O] : [variables: V, options?: O];
+interface AnyDocument<Op extends Operation> {
+    readonly operation: Op;
+    readonly name: string;
+    readonly query: string;
+    readonly transport?: "ws" | "sse";
+}
+export interface Operations {
+    readonly query?: Readonly<Record<string, AnyDocument<"query">>>;
+    readonly mutation?: Readonly<Record<string, AnyDocument<"mutation">>>;
+    readonly subscription?: Readonly<Record<string, AnyDocument<"subscription">>>;
+    readonly transports?: readonly ("ws" | "sse")[];
+}
+export interface SubscriptionClient {
+    iterate(request: {
+        query: string;
+        variables?: Record<string, unknown>;
+        operationName?: string;
+    }): AsyncIterableIterator<{
+        data?: unknown;
+        errors?: readonly GraphQLErrorJSON[];
+    }>;
+}
+type Call<D> = D extends TypedDocument<infer R, infer V, infer Op> ? Op extends "subscription" ? (...args: VariablesArgs<V, Pick<CallOptions, "signal">>) => AsyncIterableIterator<Result<R>> : (...args: VariablesArgs<V, CallOptions>) => Promise<Result<R>> : never;
+export type Client<O extends Operations> = {
+    readonly [Op in keyof O & Operation]: {
+        readonly [K in keyof O[Op]]: Call<O[Op][K]>;
+    };
+};
+export type Transports<O extends Operations> = O extends {
+    transports: readonly (infer K)[];
+} ? K & ("ws" | "sse") : never;
+export type ClientOptions<O extends Operations> = {
+    url: string | URL;
+    headers?: HeadersSource;
+    fetch?: Fetch;
+} & {
+    readonly [K in Transports<O>]: SubscriptionClient;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@nxara/olio-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A typed GraphQL client for Nxara apps: select fields, get typed results.",
+  "keywords": [
+    "client",
+    "graphql",
+    "nxara",
+    "rpc"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nxara-hub/olio.git",
+    "directory": "packages/client"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./test": {
+      "types": "./dist/test.d.ts",
+      "default": "./dist/test.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "check-types": "bun test/generate.ts && tsc -p tsconfig.test.json"
+  },
+  "devDependencies": {
+    "@nxara/olio": "0.1.0",
+    "@nxara/olio-codegen": "0.1.0",
+    "@nxara/olio-http": "0.1.0",
+    "graphql": "^16.14.2",
+    "graphql-sse": "2.6.3",
+    "graphql-ws": "^6.4.1",
+    "ky": "^2.2.0"
+  },
+  "peerDependencies": {
+    "graphql": "^16.13.0",
+    "graphql-sse": "^2.6.3",
+    "graphql-ws": "^6.4.1"
+  },
+  "peerDependenciesMeta": {
+    "graphql-sse": {
+      "optional": true
+    },
+    "graphql-ws": {
+      "optional": true
+    }
+  }
+}