@toapi/client 0.12.1

package/dist/cache.d.ts

@@ -0,0 +1,38 @@
+import type { Logger } from "@toapi/common";
+import type { Observable } from "./client-types.js";
+type ObservablePromise = Promise<unknown> & Observable<unknown>;
+type Subscription = (data: Promise<unknown>) => void;
+interface CacheEntry {
+    current?: {
+        value: ObservablePromise;
+        expiresAt?: number;
+        tags: Set<string>;
+    };
+    next?: ObservablePromise;
+    queuedRevalidation?: Promise<void>;
+    fetch: () => Promise<Response>;
+    subscriptions: Set<Subscription>;
+    timeout: ReturnType<typeof setTimeout> | null;
+}
+interface Options {
+    minTTL?: number;
+    maxOverdueTTL?: number;
+    logger?: Logger;
+}
+export declare class Cache {
+    private storage;
+    private tagIndex;
+    private minTTL;
+    private maxOverdueTTL;
+    private errorLog;
+    constructor(options: Options);
+    private emplace;
+    private revalidateRequest;
+    request(url: string, fetch: () => Promise<Response>): ObservablePromise;
+    queueRevalidation(url: string, entry: CacheEntry): Promise<void>;
+    revalidateUrl(url: string): Promise<void>;
+    revalidateTags(tags: string[]): Promise<void>;
+    queueClearEntry(url: string): void;
+}
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,KAAK,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAChE,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AAErD,UAAU,UAAU;IAClB,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,iBAAiB,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;CAC/C;AAED,UAAU,OAAO;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,OAAO,EAAE,OAAO;IAM5B,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,iBAAiB;IA+HzB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,iBAAiB;IAqBjE,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAMhD,aAAa,CAAC,GAAG,EAAE,MAAM;IAuBzB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE;IAcnC,eAAe,CAAC,GAAG,EAAE,MAAM;CAiB5B"}

package/dist/cache.js

@@ -0,0 +1,207 @@
+import { EXPIRES_AT_HEADER, TAGS_HEADER } from "@toapi/common";
+import { handleResponse } from "./handle-response.js";
+const DEFAULT_MIN_TTL = 5 * 1000;
+const DEFAULT_MAX_OVERDUE_TTL = 1000;
+export class Cache {
+    storage = new Map();
+    tagIndex = new Map();
+    minTTL;
+    maxOverdueTTL;
+    errorLog;
+    constructor(options) {
+        this.minTTL = options.minTTL ?? DEFAULT_MIN_TTL;
+        this.maxOverdueTTL = options.maxOverdueTTL ?? DEFAULT_MAX_OVERDUE_TTL;
+        this.errorLog = options.logger?.error ?? console.error;
+    }
+    emplace(url, fetch) {
+        const currentEntry = this.storage.get(url);
+        if (currentEntry) {
+            currentEntry.fetch = fetch;
+            return currentEntry;
+        }
+        const newEntry = {
+            subscriptions: new Set(),
+            timeout: null,
+            fetch,
+        };
+        this.storage.set(url, newEntry);
+        return newEntry;
+    }
+    revalidateRequest(url, entry) {
+        if (entry.timeout) {
+            // clear timeout to make sure it the entry doesn't get revalidated again or removed based on TTL
+            clearTimeout(entry.timeout);
+        }
+        // actually load fresh data
+        const responsePromise = entry.fetch();
+        const observable = Object.assign(responsePromise.then(handleResponse), {
+            subscribe: (callback) => {
+                if (entry.subscriptions.size === 0) {
+                    if (entry.timeout) {
+                        clearTimeout(entry.timeout);
+                    }
+                    if (entry.current?.expiresAt) {
+                        entry.timeout = setTimeout(() => {
+                            this.revalidateRequest(url, entry);
+                        }, entry.current.expiresAt - Date.now() +
+                            Math.round(Math.random() * this.maxOverdueTTL));
+                    }
+                }
+                entry.subscriptions.add(callback);
+                // If there's a newer revalidation in-flight or completed since
+                // this observable was created, notify the new subscriber immediately
+                // so it doesn't miss the update.
+                if (entry.next && entry.next !== observable) {
+                    callback(entry.next);
+                }
+                else if (entry.current && entry.current.value !== observable) {
+                    // A revalidation completed between cache.request() returning this
+                    // observable and subscribe() being called — notify with the newer value.
+                    callback(entry.current.value);
+                }
+                return () => {
+                    entry.subscriptions.delete(callback);
+                    if (entry.subscriptions.size === 0) {
+                        this.queueClearEntry(url);
+                    }
+                };
+            },
+        });
+        entry.next = observable;
+        // notify subscribers
+        for (const callback of entry.subscriptions) {
+            callback(observable);
+        }
+        const next = entry.next;
+        const waitForRevalidation = async () => {
+            try {
+                // wait for request to finish
+                const response = await responsePromise;
+                // this will throw an error if the response is not ok
+                await observable;
+                if (entry.next !== next) {
+                    // request was superseded by a new request
+                    return;
+                }
+                // update entry
+                const oldTags = entry.current?.tags ?? new Set();
+                const newTags = new Set(response.headers.get(TAGS_HEADER)?.split(" ") ?? []);
+                const expiresAtHeader = response.headers.get(EXPIRES_AT_HEADER);
+                const expiresAt = expiresAtHeader
+                    ? parseInt(expiresAtHeader, 10)
+                    : undefined;
+                entry.current = {
+                    value: observable,
+                    tags: newTags,
+                    expiresAt,
+                };
+                entry.next = undefined;
+                // add url to tagIndex for new tags
+                for (const tag of newTags.difference(oldTags)) {
+                    const urls = this.tagIndex.get(tag);
+                    if (urls) {
+                        urls.add(url);
+                    }
+                    else {
+                        this.tagIndex.set(tag, new Set([url]));
+                    }
+                }
+                // remove url from tagIndex for removed tags
+                for (const tag of oldTags.difference(newTags)) {
+                    this.tagIndex.get(tag)?.delete(url);
+                }
+            }
+            catch (error) {
+                if (!entry.current) {
+                    // no current value, we are stuck with the rejected promise
+                    entry.current = {
+                        value: observable,
+                        tags: new Set(),
+                    };
+                }
+                // there is a current valid value, we'll keep that an drop the error
+                entry.next = undefined;
+                await this.errorLog(error);
+            }
+            finally {
+                if (entry.subscriptions.size === 0) {
+                    // clear response after minTTL if no subscribers active
+                    this.queueClearEntry(url);
+                }
+            }
+        };
+        return { observable, revalidated: waitForRevalidation() };
+    }
+    request(url, fetch) {
+        const now = Date.now();
+        let entry = this.emplace(url, fetch);
+        if (entry.current) {
+            // has cached value, serve from cache
+            return entry.current.value;
+        }
+        // no cached value
+        if (entry.next) {
+            // already loading, serve from next
+            return entry.next;
+        }
+        // nothing cached, load fresh
+        const { observable } = this.revalidateRequest(url, entry);
+        return observable;
+    }
+    async queueRevalidation(url, entry) {
+        await entry.next;
+        const { revalidated } = this.revalidateRequest(url, entry);
+        await revalidated;
+    }
+    async revalidateUrl(url) {
+        const entry = this.storage.get(url);
+        if (!entry)
+            return;
+        if (entry.next) {
+            // we are currently fetching that url
+            if (entry.queuedRevalidation) {
+                // another revalidation is already queued, wait for it to finish
+                await entry.queuedRevalidation;
+            }
+            else {
+                // queue another revalidation
+                const queuedRevalidation = this.queueRevalidation(url, entry);
+                entry.queuedRevalidation = queuedRevalidation;
+                await queuedRevalidation;
+            }
+        }
+        else {
+            // there is no request in flight, revalidate immediately
+            const { revalidated } = this.revalidateRequest(url, entry);
+            await revalidated;
+        }
+    }
+    async revalidateTags(tags) {
+        // collect urls to revalidate
+        let urls = new Set();
+        for (const tag of tags) {
+            const taggedUrls = this.tagIndex.get(tag);
+            if (!taggedUrls)
+                continue;
+            urls = urls.union(taggedUrls);
+        }
+        // revalidate urls and wait until all are resolved or rejected
+        await Promise.allSettled(Array.from(urls).map((url) => this.revalidateUrl(url)));
+    }
+    queueClearEntry(url) {
+        const entry = this.storage.get(url);
+        if (!entry)
+            return;
+        if (entry.timeout) {
+            clearTimeout(entry.timeout);
+        }
+        entry.timeout = setTimeout(() => {
+            if (entry.current) {
+                for (const tag of entry.current.tags) {
+                    this.tagIndex.get(tag)?.delete(url);
+                }
+            }
+            this.storage.delete(url);
+        }, this.minTTL);
+    }
+}

package/dist/client-types.d.ts

@@ -0,0 +1,55 @@
+import type { Path as BasePath } from "@toapi/common";
+import type { BaseRoute } from "@toapi/common";
+import type { Handler as BaseHandler } from "@toapi/common";
+import type { MaybePromise } from "@toapi/common";
+type Segment<Path> = Path extends `/${infer Segment}/${string}` ? Segment : Path extends `/${infer Segment}` ? Segment : never;
+type Rest<Path, Segment extends string> = Path extends `/${Segment}/${infer Rest}` ? `/${Rest}` : never;
+export type Client<Routes extends Record<BasePath, MaybePromise<BaseRoute>>> = {
+    [segment in Segment<keyof Routes> as segment extends `:${string}` ? string | number : segment extends `*${string}` ? string | number : segment]: (Extract<keyof Routes, `/${segment}`> extends never ? {} : ClientRoute<Routes[`/${segment}`]>) & (Exclude<keyof Routes, `/${segment}`> extends never ? {} : Client<{
+        [rest in Rest<keyof Routes, segment>]: Routes[`/${segment}${rest}`];
+    }>);
+};
+type ClientRoute<Route extends MaybePromise<BaseRoute>> = {
+    get: QueryWithoutBody<Awaited<Route>["GET"]>;
+    post: MutationWithBody<Awaited<Route>["POST"]>;
+    delete: MutationWithoutBody<Awaited<Route>["DELETE"]>;
+    put: MutationWithBody<Awaited<Route>["PUT"]>;
+    patch: MutationWithBody<Awaited<Route>["PATCH"]>;
+    revalidate: () => Promise<void>;
+};
+export type QueryWithoutBody<Handler extends BaseHandler<any, any, any, undefined> | undefined> = Handler extends undefined ? never : RequiredKeys<QueryType<Handler>> extends never ? (query?: Partial<QueryType<Handler>>, req?: RequestInit) => Promise<ResponseType<Handler>> & Observable<ResponseType<Handler>> : (query: OptionalizeUndefined<QueryType<Handler>>, req?: RequestInit) => Promise<ResponseType<Handler>> & Observable<ResponseType<Handler>>;
+export type Observable<T> = {
+    subscribe(callback: (value: Promise<T>) => void): () => void;
+};
+export type Revalidating = {
+    revalidated: Promise<void>;
+};
+export type MutationWithoutBody<Handler extends BaseHandler<any, any, any, undefined> | undefined> = Handler extends undefined ? never : RequiredKeys<QueryType<Handler>> extends never ? (query?: Partial<QueryType<Handler>>, req?: RequestInit) => Promise<ResponseType<Handler>> & Revalidating : (query: OptionalizeUndefined<QueryType<Handler>>, req?: RequestInit) => Promise<ResponseType<Handler>> & Revalidating;
+export type MutationWithBody<Handler extends BaseHandler<any, any, any, unknown> | undefined> = Handler extends undefined ? never : (body?: BodyType<Handler> | FormData, req?: RequestInit & {
+    query?: OptionalizeUndefined<QueryType<Handler>>;
+}) => Promise<ResponseType<Handler>> & Revalidating;
+type QueryType<Handler extends {
+    schema: {
+        __q?: any;
+    };
+} | undefined> = NonNullable<NonNullable<Handler>["schema"]["__q"]>;
+type RequiredKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? never : K;
+}[keyof T];
+type OptionalizeUndefined<T> = {
+    [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+} & {
+    [K in keyof T as undefined extends T[K] ? K : never]?: T[K];
+};
+type BodyType<Handler extends {
+    schema: {
+        __b?: any;
+    };
+} | undefined> = NonNullable<NonNullable<Handler>["schema"]["__b"]>;
+type ResponseType<Handler extends {
+    schema: {
+        __r?: any;
+    };
+} | undefined> = NonNullable<NonNullable<Handler>["schema"]["__r"]>;
+export {};
+//# sourceMappingURL=client-types.d.ts.map

package/dist/client-types.d.ts.map

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

package/dist/create-fetch-client.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from "@toapi/common";
+import type { MaybePromise } from "@toapi/common";
+import type { Path as BasePath } from "@toapi/common";
+import type { BaseRoute } from "@toapi/common";
+import type { Client } from "./client-types.js";
+interface Options {
+    fetch?: (url: string, init: RequestInit) => Promise<Response>;
+    minTTL?: number;
+    maxOverdueTTL?: number;
+    logger?: Logger;
+    invalidationsUrl?: string | false;
+}
+export declare function createFetchClient<Routes extends Record<BasePath, MaybePromise<BaseRoute>>>(apiUrl: string, options?: Options): Client<Routes>;
+export {};
+//# sourceMappingURL=create-fetch-client.d.ts.map

package/dist/create-fetch-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fetch-client.d.ts","sourceRoot":"","sources":["../src/create-fetch-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,mBAAmB,CAAC;AAiC9D,UAAU,OAAO;IACf,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,SAAS,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,EACxD,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAY,GAyGpB,MAAM,CAAC,MAAM,CAAC,CAChC"}

package/dist/create-fetch-client.js

@@ -0,0 +1,152 @@
+import { INVALIDATION_POST_EVENT, INVALIDATIONS_ROUTE, TAGS_HEADER, } from "@toapi/common";
+import { Cache } from "./cache.js";
+import { handleResponse } from "./handle-response.js";
+const globalFetch = fetch;
+async function listenForInvalidations(url, cache) {
+    const MAX_ATTEMPTS = 1000;
+    for (let retry = 0; retry < MAX_ATTEMPTS; retry++) {
+        try {
+            const res = await globalFetch(url);
+            if (!res.ok || !res.body)
+                break;
+            let buffer = "";
+            const decoder = new TextDecoder();
+            for await (const chunk of res.body) {
+                buffer += decoder.decode(chunk);
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    const rawTags = line.trim();
+                    if (!rawTags)
+                        continue;
+                    await cache.revalidateTags(rawTags.split(" "));
+                }
+            }
+        }
+        catch {
+            // network error — retry below
+        }
+        await new Promise((resolve) => setTimeout(resolve, 500 * Math.pow(2, Math.min(retry, 10))));
+    }
+}
+export function createFetchClient(apiUrl, options = {}) {
+    const fetch = options.fetch ?? globalFetch;
+    const cache = new Cache({
+        minTTL: options.minTTL,
+        maxOverdueTTL: options.maxOverdueTTL,
+        logger: options.logger,
+    });
+    const invalidationsUrl = options.invalidationsUrl === false
+        ? null
+        : (options.invalidationsUrl ?? apiUrl + INVALIDATIONS_ROUTE);
+    if ("serviceWorker" in navigator) {
+        navigator.serviceWorker.addEventListener("message", async (event) => {
+            if (typeof event.data === "object" &&
+                event.data !== null &&
+                "type" in event.data &&
+                event.data.type === INVALIDATION_POST_EVENT) {
+                try {
+                    await cache.revalidateTags(event.data.tags);
+                }
+                catch (error) {
+                    console.warn("TApi: Failed to revalidate tags: received invalid post message", event.data);
+                }
+            }
+        });
+        if (invalidationsUrl && !navigator.serviceWorker.controller) {
+            listenForInvalidations(invalidationsUrl, cache);
+        }
+    }
+    else if (invalidationsUrl && typeof window !== "undefined") {
+        listenForInvalidations(invalidationsUrl, cache);
+    }
+    function load(url, init = {}) {
+        return cache.request(url, () => fetch(url, {
+            method: "GET",
+            ...init,
+        }));
+    }
+    async function revalidate(url) {
+        await cache.revalidateUrl(url);
+    }
+    function mutate(method, url, data, init = {}) {
+        const headers = new Headers(init.headers);
+        if (!(data instanceof FormData) && !headers.has("Content-Type")) {
+            headers.set("Content-Type", "application/json");
+        }
+        const res = fetch(url, {
+            method,
+            body: typeof data === "undefined"
+                ? undefined
+                : data instanceof FormData
+                    ? data
+                    : JSON.stringify(data),
+            ...init,
+            headers,
+        });
+        const revalidationPromise = res.then((res) => cache.revalidateTags(res.headers.get(TAGS_HEADER)?.split(" ") ?? []));
+        return Object.assign(res
+            .then((res) => handleResponse(res))
+            .catch(async (error) => {
+            await options?.logger?.error?.(error);
+            throw error;
+        }), {
+            revalidated: revalidationPromise,
+        });
+    }
+    return new Proxy(() => { }, {
+        get(_target, prop) {
+            return createProxy({
+                revalidate,
+                load,
+                mutate,
+            }, apiUrl, prop);
+        },
+    });
+}
+function buildUrl(baseUrl, query) {
+    if (!query || typeof query !== "object")
+        return baseUrl;
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (typeof value === "undefined")
+            continue;
+        searchParams.append(key, value);
+    }
+    return searchParams.size > 0 ? baseUrl + "?" + searchParams : baseUrl;
+}
+function createProxy(methods, baseUrl, lastProp) {
+    return new Proxy(() => { }, {
+        get(_target, prop) {
+            if (typeof prop === "symbol") {
+                if (prop === Symbol.toPrimitive) {
+                    return function toPrimitive() {
+                        return `[TApi Route ${baseUrl}/${lastProp}]`;
+                    };
+                }
+                return undefined;
+            }
+            return createProxy(methods, baseUrl + "/" + lastProp, prop);
+        },
+        apply(_target, _thisArg, args) {
+            switch (lastProp) {
+                case "revalidate": {
+                    return methods.revalidate(buildUrl(baseUrl, args[0]));
+                }
+                case "get": {
+                    return methods.load(buildUrl(baseUrl, args[0]), args[1]);
+                }
+                case "delete": {
+                    return methods.mutate("DELETE", buildUrl(baseUrl, args[0]), undefined, args[1]);
+                }
+                case "post":
+                case "put":
+                case "patch": {
+                    return methods.mutate(lastProp.toUpperCase(), buildUrl(baseUrl, args[1]?.query), args[0], args[1]);
+                }
+                default:
+                    throw new Error(`Tapi: Unsupported method: ${lastProp}`);
+            }
+        },
+    });
+}

package/dist/handle-response.d.ts

@@ -0,0 +1,2 @@
+export declare function handleResponse(res: Response): Promise<any>;
+//# sourceMappingURL=handle-response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle-response.d.ts","sourceRoot":"","sources":["../src/handle-response.ts"],"names":[],"mappings":"AAGA,wBAAsB,cAAc,CAAC,GAAG,EAAE,QAAQ,gBAmBjD"}

package/dist/handle-response.js

@@ -0,0 +1,54 @@
+import { ZodError } from "zod";
+import { HttpError } from "@toapi/common";
+export async function handleResponse(res) {
+    switch (res.status) {
+        case 200:
+            return parseBody(res);
+        // @ts-expect-error explicit fallthrough
+        case 400:
+            if (res.headers.get("Content-Type") === "application/json+zodissues") {
+                const issues = await res.json();
+                throw new ZodError(issues);
+            }
+        default:
+            if (res.headers.get("Content-Type") === "application/json+httperror") {
+                const { message, data } = await res.json();
+                throw new HttpError(res.status, message, data);
+            }
+            throw new HttpError(res.status, res.statusText);
+    }
+}
+async function parseBody(res) {
+    const contentType = res.headers.get("Content-Type");
+    if (contentType == "application/x-ndjson") {
+        return streamBody(res);
+    }
+    if (contentType?.startsWith("application/json")) {
+        return await res.json();
+    }
+    if (contentType?.startsWith("text/plain")) {
+        return await res.text();
+    }
+    const contentLength = res.headers.get("Content-Length");
+    if (contentLength === "0") {
+        return undefined;
+    }
+    throw new Error(`Tapi: Unsupported content type: ${contentType}`);
+}
+async function* streamBody(res) {
+    if (!res.body)
+        return;
+    let buffer = "";
+    const textDecoder = new TextDecoder();
+    for await (const chunk of res.body) {
+        buffer += textDecoder.decode(chunk);
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            yield JSON.parse(line);
+        }
+    }
+    if (buffer) {
+        yield JSON.parse(buffer);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { Client, Observable } from "./client-types.js";
+export { createFetchClient } from "./create-fetch-client.js";
+export type { GetRoute, PostRoute } from "./route-types.js";
+export { HttpError } from "@toapi/common";
+export { INVALIDATIONS_ROUTE } from "@toapi/common";
+export type { Logger } from "@toapi/common";
+//# 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,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createFetchClient } from "./create-fetch-client.js";
+export { HttpError } from "@toapi/common";
+export { INVALIDATIONS_ROUTE } from "@toapi/common";

package/dist/pub-sub.d.ts

@@ -0,0 +1,11 @@
+export declare class PubSub {
+    private subscriptions;
+    private onClear;
+    constructor({ onClear }: {
+        onClear: (url: string) => void;
+    });
+    subscribe(url: string, callback: (data: Promise<unknown>) => void): () => void;
+    publish(url: string, data: Promise<unknown>): void;
+    has(url: string): boolean;
+}
+//# sourceMappingURL=pub-sub.d.ts.map

package/dist/pub-sub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pub-sub.d.ts","sourceRoot":"","sources":["../src/pub-sub.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IACjB,OAAO,CAAC,aAAa,CAGjB;IACJ,OAAO,CAAC,OAAO,CAAwB;gBAE3B,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE;IAI3D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI;IAgBjE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;IAS3C,GAAG,CAAC,GAAG,EAAE,MAAM;CAGhB"}

package/dist/pub-sub.js

@@ -0,0 +1,33 @@
+export class PubSub {
+    subscriptions = new Map();
+    onClear;
+    constructor({ onClear }) {
+        this.onClear = onClear;
+    }
+    subscribe(url, callback) {
+        let urlSubscriptions = this.subscriptions.get(url);
+        if (!urlSubscriptions) {
+            urlSubscriptions = new Set();
+            this.subscriptions.set(url, urlSubscriptions);
+        }
+        urlSubscriptions.add(callback);
+        return () => {
+            urlSubscriptions.delete(callback);
+            if (urlSubscriptions.size === 0) {
+                this.subscriptions.delete(url);
+                this.onClear(url);
+            }
+        };
+    }
+    publish(url, data) {
+        const urlSubscriptions = this.subscriptions.get(url);
+        if (urlSubscriptions) {
+            for (const callback of urlSubscriptions.values()) {
+                callback(data);
+            }
+        }
+    }
+    has(url) {
+        return this.subscriptions.has(url);
+    }
+}

package/dist/route-types.d.ts

@@ -0,0 +1,4 @@
+import type { Observable } from "./client-types.js";
+export type GetRoute<R, Q = undefined> = Q extends undefined ? (query?: {}, req?: RequestInit) => Promise<R> & Observable<R> : (query: Q, req?: RequestInit) => Promise<R> & Observable<R>;
+export type PostRoute<R, Q = unknown, B = unknown> = (query: Q | FormData, body: B | FormData, req?: RequestInit) => Promise<R>;
+//# sourceMappingURL=route-types.d.ts.map

package/dist/route-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-types.d.ts","sourceRoot":"","sources":["../src/route-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,IAAI,CAAC,SAAS,SAAS,GACxD,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAC7D,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAIhE,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CACnD,KAAK,EAAE,CAAC,GAAG,QAAQ,EACnB,IAAI,EAAE,CAAC,GAAG,QAAQ,EAClB,GAAG,CAAC,EAAE,WAAW,KACd,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@toapi/client",
+  "version": "0.12.1",
+  "author": {
+    "name": "Michel Smola",
+    "email": "michel.smola@farbenmeer.de"
+  },
+  "type": "module",
+  "module": "dist/index.js",
+  "main": "dist/index.js",
+  "private": false,
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@toapi/common": "^0.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "vitest": "^4.0.16",
+    "zod": "^4.0.17"
+  },
+  "peerDependencies": {
+    "typescript": "^5 || ^6.0.0",
+    "zod": "^4.0.17"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/farbenmeer/tapi.git"
+  },
+  "scripts": {
+    "build": "tsc --noEmit false",
+    "release": "pnpm build && pnpm publish --no-git-checks",
+    "test": "vitest run --passWithNoTests"
+  }
+}