dixous 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dixous 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,114 @@
+# Dixous
+
+A minimal, fully typed, extendable fetch client.
+
+Start with a simple request, then add validation, middleware, and custom response handlers as you need them.
+
+## Installation
+
+```sh
+npm install dixous
+```
+
+Or from JSR: `deno add jsr:@asguho/dixous` / `npx jsr add @asguho/dixous`.
+Requires a runtime with native Fetch (Node.js 22+, Deno, or a modern browser).
+
+## Usage
+
+```ts
+import { createDixous } from "dixous";
+const dixous = createDixous();
+import { z } from "zod";
+
+const image = await dixous.fetch("https://example.com/image.png").blob();
+
+const User = z.object({
+  id: z.number(),
+  name: z.string(),
+});
+
+const api = dixous({
+  baseUrl: "https://api.example.com/",
+  headers: { Authorization: "Bearer YOUR_API_TOKEN" },
+});
+const user = await api.fetch("users/1").json(User);
+
+console.log(user.name); // string, validated at runtime
+```
+
+Requests run when you call `.json(schema)`, `.text()`, `.blob()`, `.arrayBuffer()`, or `.response()`. JSON accepts any Standard Schema v1 validator.
+
+## Fully extensible
+
+Define your client once. Add response methods, middleware, and typed options with `defineExtension`.
+
+```ts
+// lib/dixous.ts
+import { createDixous, defineExtension } from "dixous";
+import { parseXml } from "schema-xml";
+import { z } from "zod";
+
+// Parse and validate XML with Schema XML.
+const xml = defineExtension({
+  methods: {
+    xml: (fetchResponse) =>
+      async <S extends z.ZodType>(schema: S): Promise<z.output<S>> =>
+        parseXml(await (await fetchResponse()).text(), schema),
+  },
+});
+
+// Retry GET requests up to three times in total on a 503 response.
+const retry = defineExtension({
+  async request({ request }, next) {
+    for (let attempt = 1; ; attempt++) {
+      request.signal.throwIfAborted();
+      const response = await next();
+      if (request.method !== "GET" || response.status !== 503 || attempt === 3) {
+        return response;
+      }
+      await response.body?.cancel();
+    }
+  },
+});
+
+// Add a typed query option.
+const query = defineExtension<{ query?: Record<string, string> }>()({
+  async request(context, next) {
+    const url = new URL(context.request.url);
+    for (const [key, value] of Object.entries(context.options.query ?? {})) {
+      url.searchParams.append(key, value);
+    }
+    context.request = new Request(url, context.request);
+    return next();
+  },
+});
+
+export const dixous = createDixous({ extensions: [xml, query, retry] });
+```
+Use the extended client anywhere:
+
+```ts
+import { dixous } from "./lib/dixous";
+import { z } from "zod";
+
+const Catalog = z.object({
+  catalog: z.object({ book: z.array(z.object({ title: z.string() })) }),
+});
+
+const result = await dixous.fetch("https://example.com/catalog", {
+  query: { author: "Ursula K. Le Guin" },
+}).xml(Catalog);
+
+console.log(result.catalog.book); // { title: string }[]
+```
+
+The XML example uses [Schema XML](https://github.com/Asguho/schema-xml) and Zod (`npm install schema-xml zod`). 
+
+## Development
+
+```sh
+npm ci
+npm test
+```
+
+See [RELEASING.md](./RELEASING.md) for npm and JSR publishing.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { type DefaultResponseMethods } from "./response-methods.ts";
+import type { ContextKey, Dixous, Extension, ExtensionClientOptions, ExtensionDefinition, ExtensionMeta, ExtensionMethods, ExtensionRequestOptions, NoClientOptionOverrides, NoRequestInitOverrides, ResponseMethods } from "./types.ts";
+export { SchemaValidationError } from "./response-methods.ts";
+export type { DefaultResponseMethods, InferOutput } from "./response-methods.ts";
+export type { BaseClientOptions, ClientOptions, Context, ContextKey, Dixous, Extension, Fetcher, FetchResponse, Middleware, Next, RequestContext, RequestOptions, } from "./types.ts";
+export declare function createContextKey<T>(): ContextKey<T>;
+export declare function defineExtension<const Methods extends ResponseMethods = {}>(extension: ExtensionDefinition<{}, {}, Methods>): Extension<{}, {}, Methods>;
+export declare function defineExtension<RequestExtra extends object & NoRequestInitOverrides = {}, ClientExtra extends object & NoClientOptionOverrides = {}>(): <const Methods extends ResponseMethods = {}>(extension: ExtensionDefinition<RequestExtra, ClientExtra, Methods>) => Extension<RequestExtra, ClientExtra, Methods>;
+export declare class HttpError extends Error {
+    readonly request: Request;
+    readonly response: Response;
+    readonly status: number;
+    constructor(request: Request, response: Response);
+}
+export declare function createDixous<const Extensions extends readonly ExtensionMeta[] = []>(options?: {
+    extensions?: Extensions;
+    fetch?: typeof globalThis.fetch;
+}): Dixous<ExtensionRequestOptions<Extensions>, ExtensionClientOptions<Extensions>, DefaultResponseMethods & ExtensionMethods<Extensions>>;
+//# 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":"AAAA,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAGV,UAAU,EACV,MAAM,EACN,SAAS,EACT,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EAIvB,uBAAuB,EACvB,sBAAsB,EAGtB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEjF,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,UAAU,EACV,MAAM,EACN,SAAS,EACT,OAAO,EACP,aAAa,EACb,UAAU,EACV,IAAI,EACJ,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAEnD;AAcD,wBAAgB,eAAe,CAAC,KAAK,CAAC,OAAO,SAAS,eAAe,GAAG,EAAE,EACxE,SAAS,EAAE,mBAAmB,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,GAC9C,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9B,wBAAgB,eAAe,CAC7B,YAAY,SAAS,MAAM,GAAG,sBAAsB,GAAG,EAAE,EACzD,WAAW,SAAS,MAAM,GAAG,uBAAuB,GAAG,EAAE,KACtD,CAAC,KAAK,CAAC,OAAO,SAAS,eAAe,GAAG,EAAE,EAC9C,SAAS,EAAE,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,KAC/D,SAAS,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAMnD,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAM/C;CACF;AAoFD,wBAAgB,YAAY,CAC1B,KAAK,CAAC,UAAU,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,EACtD,OAAO,CAAC,EAAE;IACV,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,GAAG,MAAM,CACR,uBAAuB,CAAC,UAAU,CAAC,EACnC,sBAAsB,CAAC,UAAU,CAAC,EAClC,sBAAsB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CACtD,CA2CA"}

package/dist/index.js

@@ -0,0 +1,138 @@
+import { defaultResponseMethods } from "./response-methods.js";
+export { SchemaValidationError } from "./response-methods.js";
+export function createContextKey() {
+    return Symbol();
+}
+function createContext() {
+    const values = new Map();
+    return {
+        get(key) {
+            return values.get(key);
+        },
+        set(key, value) {
+            values.set(key, value);
+        },
+    };
+}
+export function defineExtension(extension) {
+    // Extension metadata is a type-only brand; composition uses the captured values.
+    return extension === undefined ? (definition) => definition : extension;
+}
+export class HttpError extends Error {
+    request;
+    response;
+    status;
+    constructor(request, response) {
+        super(`HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ""}`);
+        this.name = "HttpError";
+        this.request = request;
+        this.response = response;
+        this.status = response.status;
+    }
+}
+function snapshotClient(options = {}) {
+    const client = { ...options };
+    if (client.baseUrl !== undefined)
+        client.baseUrl = client.baseUrl.toString();
+    if (client.headers !== undefined)
+        client.headers = new Headers(client.headers);
+    return Object.freeze(client);
+}
+function snapshotOptions(options = {}) {
+    const snapshot = { ...options };
+    if (snapshot.headers !== undefined)
+        snapshot.headers = new Headers(snapshot.headers);
+    return Object.freeze(snapshot);
+}
+function createTemplate(input, options, client) {
+    const headers = new Headers(client.headers);
+    if (input instanceof Request) {
+        input.headers.forEach((value, name) => headers.set(name, value));
+    }
+    if (options.headers !== undefined) {
+        new Headers(options.headers).forEach((value, name) => headers.set(name, value));
+    }
+    const source = !(input instanceof Request) && client.baseUrl !== undefined
+        ? new URL(input.toString(), client.baseUrl)
+        : input;
+    return new Request(source, { ...options, headers });
+}
+function runMiddleware(middleware, context, fetchImpl) {
+    async function dispatch(index) {
+        const current = middleware[index];
+        if (current === undefined)
+            return fetchImpl(context.request.clone());
+        // Each middleware invocation owns its guard. Sequential retries re-enter
+        // the downstream chain with the same context and new downstream guards.
+        let running = false;
+        return current(context, async () => {
+            if (running)
+                throw new Error("Overlapping next() calls are not allowed");
+            running = true;
+            try {
+                return await dispatch(index + 1);
+            }
+            finally {
+                running = false;
+            }
+        });
+    }
+    return dispatch(0);
+}
+function createFetchResponse(template, options, client, middleware, fetchImpl) {
+    let execution;
+    return () => {
+        // Defer execution until after storing the promise, including when a
+        // synchronous middleware re-enters its operation's FetchResponse.
+        execution ??= Promise.resolve().then(async () => {
+            const context = {
+                request: template.clone(),
+                options,
+                client,
+                state: createContext(),
+            };
+            const response = await runMiddleware(middleware, context, fetchImpl);
+            if (!response.ok)
+                throw new HttpError(context.request, response);
+            return response;
+        });
+        return execution;
+    };
+}
+export function createDixous(options) {
+    const fetchImpl = options?.fetch ?? globalThis.fetch;
+    const middleware = [];
+    const methods = new Map(Object.entries(defaultResponseMethods));
+    for (const entry of options?.extensions ?? []) {
+        // Contributions are erased only inside the kernel; the public signature
+        // intersects their exact types when constructing the resulting client.
+        const extension = entry;
+        if (extension.request !== undefined)
+            middleware.push(extension.request);
+        for (const [name, factory] of Object.entries(extension.methods ?? {})) {
+            if (methods.has(name))
+                throw new Error(`Duplicate response method: ${name}`);
+            methods.set(name, factory);
+        }
+    }
+    function configured(clientOptions) {
+        const client = snapshotClient(clientOptions);
+        return {
+            fetch(input, requestOptions) {
+                const snapshot = snapshotOptions(requestOptions);
+                const template = createTemplate(input, snapshot, client);
+                const pending = Object.create(null);
+                for (const [name, factory] of methods) {
+                    pending[name] = (...args) => {
+                        const fetchResponse = createFetchResponse(template, snapshot, client, middleware, fetchImpl);
+                        // Factories and method work are lazy too, and run once per call.
+                        return factory(fetchResponse)(...args);
+                    };
+                }
+                return Object.freeze(pending);
+            },
+        };
+    }
+    return Object.assign(configured, { fetch: configured().fetch });
+}
+//# 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/response-methods.d.ts

@@ -0,0 +1,16 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { FetchResponse } from "./types.ts";
+export type InferOutput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
+export declare class SchemaValidationError extends Error {
+    readonly issues: readonly StandardSchemaV1.Issue[];
+    constructor(issues: readonly StandardSchemaV1.Issue[]);
+}
+export declare const defaultResponseMethods: {
+    json: (fetchResponse: FetchResponse) => <Schema extends StandardSchemaV1>(schema: Schema) => Promise<InferOutput<Schema>>;
+    text: (fetchResponse: FetchResponse) => () => Promise<string>;
+    blob: (fetchResponse: FetchResponse) => () => Promise<Blob>;
+    arrayBuffer: (fetchResponse: FetchResponse) => () => Promise<ArrayBuffer>;
+    response: (fetchResponse: FetchResponse) => () => Promise<Response>;
+};
+export type DefaultResponseMethods = typeof defaultResponseMethods;
+//# sourceMappingURL=response-methods.d.ts.map

package/dist/response-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-methods.d.ts","sourceRoot":"","sources":["../src/response-methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,gBAAgB,IACrD,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AAEvC,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAEnD,YAAY,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,EAIpD;CACF;AAGD,eAAO,MAAM,sBAAsB;0BACX,aAAa,MAC1B,MAAM,SAAS,gBAAgB,UAAU,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;0BAMjE,aAAa,WAAe,OAAO,CAAC,MAAM,CAAC;0BAE3C,aAAa,WAAe,OAAO,CAAC,IAAI,CAAC;iCAElC,aAAa,WAAe,OAAO,CAAC,WAAW,CAAC;8BAEnD,aAAa,WAAS,OAAO,CAAC,QAAQ,CAAC;CAExC,CAAC;AAE5B,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC"}

package/dist/response-methods.js

@@ -0,0 +1,23 @@
+export class SchemaValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super("Response failed schema validation");
+        this.name = "SchemaValidationError";
+        this.issues = issues;
+    }
+}
+// Built-ins use the same per-operation factories as extension methods.
+export const defaultResponseMethods = {
+    json: (fetchResponse) => async (schema) => {
+        const response = await fetchResponse();
+        const result = await schema["~standard"].validate(await response.json());
+        if (result.issues)
+            throw new SchemaValidationError(result.issues);
+        return result.value;
+    },
+    text: (fetchResponse) => async () => (await fetchResponse()).text(),
+    blob: (fetchResponse) => async () => (await fetchResponse()).blob(),
+    arrayBuffer: (fetchResponse) => async () => (await fetchResponse()).arrayBuffer(),
+    response: (fetchResponse) => () => fetchResponse(),
+};
+//# sourceMappingURL=response-methods.js.map

package/dist/response-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-methods.js","sourceRoot":"","sources":["../src/response-methods.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,MAAM,CAAoC;IAEnD,YAAY,MAAyC;QACnD,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,CAAC,aAA4B,EAAE,EAAE,CACrC,KAAK,EAAmC,MAAc,EAAgC,EAAE;QACtF,MAAM,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC,KAA4B,CAAC;IAC7C,CAAC;IACH,IAAI,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,KAAK,IAAqB,EAAE,CAClE,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;IAChC,IAAI,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,KAAK,IAAmB,EAAE,CAChE,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;IAChC,WAAW,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,KAAK,IAA0B,EAAE,CAC9E,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,WAAW,EAAE;IACvC,QAAQ,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,GAAsB,EAAE,CAClE,aAAa,EAAE;CACQ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,66 @@
+declare const contextKeyType: unique symbol;
+export type ContextKey<T> = symbol & {
+    readonly [contextKeyType]: (value: T) => T;
+};
+export interface Context {
+    get<T>(key: ContextKey<T>): T | undefined;
+    set<T>(key: ContextKey<T>, value: T): void;
+}
+export type RequestOptions<Extra extends object = {}> = RequestInit & Extra;
+export interface BaseClientOptions {
+    baseUrl?: string | URL;
+    headers?: HeadersInit;
+}
+export type ClientOptions<Extra extends object = {}> = BaseClientOptions & Extra;
+export interface RequestContext<RequestExtra extends object = {}, ClientExtra extends object = {}> {
+    request: Request;
+    readonly options: Readonly<RequestOptions<RequestExtra>>;
+    readonly client: Readonly<ClientOptions<ClientExtra>>;
+    readonly state: Context;
+}
+export type Next = () => Promise<Response>;
+export type Middleware<RequestExtra extends object = {}, ClientExtra extends object = {}> = (context: RequestContext<RequestExtra, ClientExtra>, next: Next) => Promise<Response>;
+export type FetchResponse = () => Promise<Response>;
+export type ResponseMethod = (fetchResponse: FetchResponse) => (...args: never[]) => Promise<unknown>;
+export type ResponseMethods = Record<string, ResponseMethod>;
+type InstantiateMethods<Methods extends ResponseMethods> = {
+    readonly [K in keyof Methods]: ReturnType<Methods[K]>;
+};
+declare const extensionType: unique symbol;
+export interface ExtensionMeta {
+    readonly [extensionType]: {
+        request: object;
+        client: object;
+        methods: ResponseMethods;
+    };
+}
+export interface Extension<RequestExtra extends object = {}, ClientExtra extends object = {}, Methods extends ResponseMethods = {}> {
+    readonly [extensionType]: {
+        request: RequestExtra;
+        client: ClientExtra;
+        methods: Methods;
+    };
+    request?: Middleware<RequestExtra, ClientExtra>;
+    methods?: Methods;
+}
+export type ExtensionDefinition<RequestExtra extends object, ClientExtra extends object, Methods extends ResponseMethods> = Pick<Extension<RequestExtra, ClientExtra, Methods>, "request"> & {
+    methods?: Methods & Record<string, (fetchResponse: FetchResponse) => unknown>;
+};
+export type NoRequestInitOverrides = {
+    [K in keyof RequestInit]?: never;
+};
+export type NoClientOptionOverrides = {
+    [K in keyof BaseClientOptions]?: never;
+};
+type UnionToIntersection<T> = [T] extends [never] ? {} : (T extends unknown ? (value: T) => void : never) extends (value: infer Result) => void ? Result : never;
+export type ExtensionRequestOptions<Extensions extends readonly ExtensionMeta[]> = UnionToIntersection<Extensions[number][typeof extensionType]["request"]> extends infer Result extends object ? Result : never;
+export type ExtensionClientOptions<Extensions extends readonly ExtensionMeta[]> = UnionToIntersection<Extensions[number][typeof extensionType]["client"]> extends infer Result extends object ? Result : never;
+export type ExtensionMethods<Extensions extends readonly ExtensionMeta[]> = UnionToIntersection<Extensions[number][typeof extensionType]["methods"]> extends infer Result extends ResponseMethods ? Result : never;
+export interface Fetcher<RequestExtra extends object, Methods extends ResponseMethods> {
+    fetch(input: string | URL | Request, options?: RequestOptions<RequestExtra>): InstantiateMethods<Methods>;
+}
+export interface Dixous<RequestExtra extends object, ClientExtra extends object, Methods extends ResponseMethods> extends Fetcher<RequestExtra, Methods> {
+    (options?: ClientOptions<ClientExtra>): Fetcher<RequestExtra, Methods>;
+}
+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

@@ -0,0 +1,50 @@
+{
+  "name": "dixous",
+  "version": "0.1.0",
+  "description": "A minimal, extension-driven query client built on native Fetch.",
+  "type": "module",
+  "files": [
+    "dist/*.js",
+    "dist/*.js.map",
+    "dist/*.d.ts",
+    "dist/*.d.ts.map",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "npm run build && npm run typecheck && node --test test/*.test.mjs",
+    "prepack": "npm run build",
+    "test:package": "node scripts/test-package.mjs",
+    "check:release": "node scripts/check-release.mjs"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Asguho/Dixous.git"
+  },
+  "homepage": "https://github.com/Asguho/Dixous#readme",
+  "bugs": {
+    "url": "https://github.com/Asguho/Dixous/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,219 @@
+import { defaultResponseMethods, type DefaultResponseMethods } from "./response-methods.ts";
+import type {
+  ClientOptions,
+  Context,
+  ContextKey,
+  Dixous,
+  Extension,
+  ExtensionClientOptions,
+  ExtensionDefinition,
+  ExtensionMeta,
+  ExtensionMethods,
+  ExtensionRequestOptions,
+  Fetcher,
+  FetchResponse,
+  Middleware,
+  NoClientOptionOverrides,
+  NoRequestInitOverrides,
+  RequestContext,
+  RequestOptions,
+  ResponseMethods,
+} from "./types.ts";
+
+export { SchemaValidationError } from "./response-methods.ts";
+export type { DefaultResponseMethods, InferOutput } from "./response-methods.ts";
+
+export type {
+  BaseClientOptions,
+  ClientOptions,
+  Context,
+  ContextKey,
+  Dixous,
+  Extension,
+  Fetcher,
+  FetchResponse,
+  Middleware,
+  Next,
+  RequestContext,
+  RequestOptions,
+} from "./types.ts";
+
+export function createContextKey<T>(): ContextKey<T> {
+  return Symbol() as ContextKey<T>;
+}
+
+function createContext(): Context {
+  const values = new Map<symbol, unknown>();
+  return {
+    get<T>(key: ContextKey<T>) {
+      return values.get(key) as T | undefined;
+    },
+    set<T>(key: ContextKey<T>, value: T) {
+      values.set(key, value);
+    },
+  };
+}
+
+export function defineExtension<const Methods extends ResponseMethods = {}>(
+  extension: ExtensionDefinition<{}, {}, Methods>,
+): Extension<{}, {}, Methods>;
+export function defineExtension<
+  RequestExtra extends object & NoRequestInitOverrides = {},
+  ClientExtra extends object & NoClientOptionOverrides = {},
+>(): <const Methods extends ResponseMethods = {}>(
+  extension: ExtensionDefinition<RequestExtra, ClientExtra, Methods>,
+) => Extension<RequestExtra, ClientExtra, Methods>;
+export function defineExtension(extension?: object): unknown {
+  // Extension metadata is a type-only brand; composition uses the captured values.
+  return extension === undefined ? (definition: object) => definition : extension;
+}
+
+export class HttpError extends Error {
+  readonly request: Request;
+  readonly response: Response;
+  readonly status: number;
+
+  constructor(request: Request, response: Response) {
+    super(`HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ""}`);
+    this.name = "HttpError";
+    this.request = request;
+    this.response = response;
+    this.status = response.status;
+  }
+}
+
+function snapshotClient(options: ClientOptions = {}): Readonly<ClientOptions> {
+  const client = { ...options };
+  if (client.baseUrl !== undefined) client.baseUrl = client.baseUrl.toString();
+  if (client.headers !== undefined) client.headers = new Headers(client.headers);
+  return Object.freeze(client);
+}
+
+function snapshotOptions(options: RequestOptions = {}): Readonly<RequestOptions> {
+  const snapshot = { ...options };
+  if (snapshot.headers !== undefined) snapshot.headers = new Headers(snapshot.headers);
+  return Object.freeze(snapshot);
+}
+
+function createTemplate(
+  input: string | URL | Request,
+  options: Readonly<RequestOptions>,
+  client: Readonly<ClientOptions>,
+): Request {
+  const headers = new Headers(client.headers);
+  if (input instanceof Request) {
+    input.headers.forEach((value, name) => headers.set(name, value));
+  }
+  if (options.headers !== undefined) {
+    new Headers(options.headers).forEach((value, name) => headers.set(name, value));
+  }
+  const source = !(input instanceof Request) && client.baseUrl !== undefined
+    ? new URL(input.toString(), client.baseUrl)
+    : input;
+  return new Request(source, { ...options, headers });
+}
+
+function runMiddleware(
+  middleware: readonly Middleware[],
+  context: RequestContext,
+  fetchImpl: typeof globalThis.fetch,
+): Promise<Response> {
+  async function dispatch(index: number): Promise<Response> {
+    const current = middleware[index];
+    if (current === undefined) return fetchImpl(context.request.clone());
+
+    // Each middleware invocation owns its guard. Sequential retries re-enter
+    // the downstream chain with the same context and new downstream guards.
+    let running = false;
+    return current(context, async () => {
+      if (running) throw new Error("Overlapping next() calls are not allowed");
+      running = true;
+      try {
+        return await dispatch(index + 1);
+      } finally {
+        running = false;
+      }
+    });
+  }
+  return dispatch(0);
+}
+
+function createFetchResponse(
+  template: Request,
+  options: Readonly<RequestOptions>,
+  client: Readonly<ClientOptions>,
+  middleware: readonly Middleware[],
+  fetchImpl: typeof globalThis.fetch,
+): FetchResponse {
+  let execution: Promise<Response> | undefined;
+  return () => {
+    // Defer execution until after storing the promise, including when a
+    // synchronous middleware re-enters its operation's FetchResponse.
+    execution ??= Promise.resolve().then(async () => {
+      const context: RequestContext = {
+        request: template.clone(),
+        options,
+        client,
+        state: createContext(),
+      };
+      const response = await runMiddleware(middleware, context, fetchImpl);
+      if (!response.ok) throw new HttpError(context.request, response);
+      return response;
+    });
+    return execution;
+  };
+}
+
+export function createDixous<
+  const Extensions extends readonly ExtensionMeta[] = [],
+>(options?: {
+  extensions?: Extensions;
+  fetch?: typeof globalThis.fetch;
+}): Dixous<
+  ExtensionRequestOptions<Extensions>,
+  ExtensionClientOptions<Extensions>,
+  DefaultResponseMethods & ExtensionMethods<Extensions>
+> {
+  const fetchImpl = options?.fetch ?? globalThis.fetch;
+  const middleware: Middleware[] = [];
+  const methods = new Map<string, ResponseMethods[string]>(Object.entries(defaultResponseMethods));
+
+  for (const entry of options?.extensions ?? []) {
+    // Contributions are erased only inside the kernel; the public signature
+    // intersects their exact types when constructing the resulting client.
+    const extension = entry as Extension<{}, {}, ResponseMethods>;
+    if (extension.request !== undefined) middleware.push(extension.request);
+    for (const [name, factory] of Object.entries(extension.methods ?? {})) {
+      if (methods.has(name)) throw new Error(`Duplicate response method: ${name}`);
+      methods.set(name, factory);
+    }
+  }
+
+  function configured(clientOptions?: ClientOptions): Fetcher<{}, ResponseMethods> {
+    const client = snapshotClient(clientOptions);
+    return {
+      fetch(input, requestOptions) {
+        const snapshot = snapshotOptions(requestOptions);
+        const template = createTemplate(input, snapshot, client);
+        const pending: Record<string, (...args: never[]) => Promise<unknown>> =
+          Object.create(null);
+        for (const [name, factory] of methods) {
+          pending[name] = (...args) => {
+            const fetchResponse = createFetchResponse(
+              template, snapshot, client, middleware, fetchImpl,
+            );
+            // Factories and method work are lazy too, and run once per call.
+            return factory(fetchResponse)(...args);
+          };
+        }
+        return Object.freeze(pending);
+      },
+    };
+  }
+
+  return Object.assign(configured, { fetch: configured().fetch }) as Dixous<
+    ExtensionRequestOptions<Extensions>,
+    ExtensionClientOptions<Extensions>,
+    DefaultResponseMethods & ExtensionMethods<Extensions>
+  >;
+}

package/src/response-methods.ts

@@ -0,0 +1,36 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { FetchResponse, ResponseMethods } from "./types.ts";
+
+export type InferOutput<Schema extends StandardSchemaV1> =
+  StandardSchemaV1.InferOutput<Schema>;
+
+export class SchemaValidationError extends Error {
+  readonly issues: readonly StandardSchemaV1.Issue[];
+
+  constructor(issues: readonly StandardSchemaV1.Issue[]) {
+    super("Response failed schema validation");
+    this.name = "SchemaValidationError";
+    this.issues = issues;
+  }
+}
+
+// Built-ins use the same per-operation factories as extension methods.
+export const defaultResponseMethods = {
+  json: (fetchResponse: FetchResponse) =>
+    async <Schema extends StandardSchemaV1>(schema: Schema): Promise<InferOutput<Schema>> => {
+      const response = await fetchResponse();
+      const result = await schema["~standard"].validate(await response.json());
+      if (result.issues) throw new SchemaValidationError(result.issues);
+      return result.value as InferOutput<Schema>;
+    },
+  text: (fetchResponse: FetchResponse) => async (): Promise<string> =>
+    (await fetchResponse()).text(),
+  blob: (fetchResponse: FetchResponse) => async (): Promise<Blob> =>
+    (await fetchResponse()).blob(),
+  arrayBuffer: (fetchResponse: FetchResponse) => async (): Promise<ArrayBuffer> =>
+    (await fetchResponse()).arrayBuffer(),
+  response: (fetchResponse: FetchResponse) => (): Promise<Response> =>
+    fetchResponse(),
+} satisfies ResponseMethods;
+
+export type DefaultResponseMethods = typeof defaultResponseMethods;

package/src/types.ts

@@ -0,0 +1,141 @@
+declare const contextKeyType: unique symbol;
+
+export type ContextKey<T> = symbol & {
+  readonly [contextKeyType]: (value: T) => T;
+};
+
+export interface Context {
+  get<T>(key: ContextKey<T>): T | undefined;
+  set<T>(key: ContextKey<T>, value: T): void;
+}
+
+export type RequestOptions<Extra extends object = {}> = RequestInit & Extra;
+
+export interface BaseClientOptions {
+  baseUrl?: string | URL;
+  headers?: HeadersInit;
+}
+
+export type ClientOptions<Extra extends object = {}> = BaseClientOptions & Extra;
+
+export interface RequestContext<
+  RequestExtra extends object = {},
+  ClientExtra extends object = {},
+> {
+  request: Request;
+  readonly options: Readonly<RequestOptions<RequestExtra>>;
+  readonly client: Readonly<ClientOptions<ClientExtra>>;
+  readonly state: Context;
+}
+
+export type Next = () => Promise<Response>;
+
+export type Middleware<
+  RequestExtra extends object = {},
+  ClientExtra extends object = {},
+> = (
+  context: RequestContext<RequestExtra, ClientExtra>,
+  next: Next,
+) => Promise<Response>;
+
+export type FetchResponse = () => Promise<Response>;
+
+export type ResponseMethod = (
+  fetchResponse: FetchResponse,
+) => (...args: never[]) => Promise<unknown>;
+
+export type ResponseMethods = Record<string, ResponseMethod>;
+
+type InstantiateMethods<Methods extends ResponseMethods> = {
+  readonly [K in keyof Methods]: ReturnType<Methods[K]>;
+};
+
+declare const extensionType: unique symbol;
+
+export interface ExtensionMeta {
+  readonly [extensionType]: {
+    request: object;
+    client: object;
+    methods: ResponseMethods;
+  };
+}
+
+export interface Extension<
+  RequestExtra extends object = {},
+  ClientExtra extends object = {},
+  Methods extends ResponseMethods = {},
+> {
+  readonly [extensionType]: {
+    request: RequestExtra;
+    client: ClientExtra;
+    methods: Methods;
+  };
+  request?: Middleware<RequestExtra, ClientExtra>;
+  methods?: Methods;
+}
+
+export type ExtensionDefinition<
+  RequestExtra extends object,
+  ClientExtra extends object,
+  Methods extends ResponseMethods,
+> = Pick<Extension<RequestExtra, ClientExtra, Methods>, "request"> & {
+  // Contextually type factory parameters while preserving each method's signature.
+  methods?: Methods & Record<string, (fetchResponse: FetchResponse) => unknown>;
+};
+
+export type NoRequestInitOverrides = {
+  [K in keyof RequestInit]?: never;
+};
+
+export type NoClientOptionOverrides = {
+  [K in keyof BaseClientOptions]?: never;
+};
+
+type UnionToIntersection<T> = [T] extends [never]
+  ? {}
+  : (T extends unknown ? (value: T) => void : never) extends (
+        value: infer Result,
+      ) => void
+    ? Result
+    : never;
+
+export type ExtensionRequestOptions<
+  Extensions extends readonly ExtensionMeta[],
+> = UnionToIntersection<
+  Extensions[number][typeof extensionType]["request"]
+> extends infer Result extends object
+  ? Result
+  : never;
+
+export type ExtensionClientOptions<
+  Extensions extends readonly ExtensionMeta[],
+> = UnionToIntersection<
+  Extensions[number][typeof extensionType]["client"]
+> extends infer Result extends object
+  ? Result
+  : never;
+
+export type ExtensionMethods<Extensions extends readonly ExtensionMeta[]> =
+  UnionToIntersection<
+    Extensions[number][typeof extensionType]["methods"]
+  > extends infer Result extends ResponseMethods
+    ? Result
+    : never;
+
+export interface Fetcher<
+  RequestExtra extends object,
+  Methods extends ResponseMethods,
+> {
+  fetch(
+    input: string | URL | Request,
+    options?: RequestOptions<RequestExtra>,
+  ): InstantiateMethods<Methods>;
+}
+
+export interface Dixous<
+  RequestExtra extends object,
+  ClientExtra extends object,
+  Methods extends ResponseMethods,
+> extends Fetcher<RequestExtra, Methods> {
+  (options?: ClientOptions<ClientExtra>): Fetcher<RequestExtra, Methods>;
+}