notefeed 0.3.0 → 0.5.0

package/README.md

@@ -1,21 +1,24 @@
 # notefeed
 
-Post markdown notes to a [notefeed](https://github.com/Marceltov/notefeed) server from Node or the command line. No dependencies; Node 20 or newer.
+Post and read markdown notes on a [notefeed](https://github.com/Marceltov/notefeed) server from Node or the command line. No dependencies; Node 20 or newer.
 
 ```sh
 npm install notefeed
-export NOTEFEED_URL=https://notes.example.com NOTEFEED_TOKEN=...
+export NOTEFEED_URL=https://notes.example.com NOTEFEED_FEED=homelab-7f3k2q9x4m8wz
 npx notefeed post "# Backup finished"
 backup.sh 2>&1 | npx notefeed post -
+npx notefeed notes --limit 5
 ```
 
 ```js
 import { Client } from "notefeed";
 
-const client = new Client({ url: "https://notes.example.com", token }); // URL and token set once
-console.log((await client.post("# Deploy done\nversion 1.4.2")).url);
+const client = new Client({ url: "https://notes.example.com", feed: "homelab-7f3k2q9x4m8wz" }); // password: "..." if the instance has one
+const created = await client.post("# Deploy done\nversion 1.4.2");
+console.log(created.url, created.read_url);
+for await (const note of client.notes()) console.log(note.created_at, note.title); // newest first, page by page
 ```
 
-The `notefeed` command reads `--url` / `--token`, or `NOTEFEED_URL` / `NOTEFEED_TOKEN`. The library itself never reads the environment.
+`Client.fromEnv()` reads `NOTEFEED_URL` / `NOTEFEED_FEED` / `NOTEFEED_PASSWORD`; so does the `notefeed` command, unless given `--url` / `--feed` / `--password`.
 
-Full documentation: https://notefeed.me/clients/
+Full documentation: https://docs.notefeed.me/clients/

package/dist/bin.js

@@ -1,3 +1,9 @@
 #!/usr/bin/env node
 import { main } from "./cli.js";
+// The reader went away (`notefeed notes | head -1`): stop quietly instead of crashing on EPIPE.
+process.stdout.on("error", (e) => {
+    if (e.code === "EPIPE")
+        process.exit(0);
+    throw e;
+});
 process.exitCode = await main(process.argv.slice(2));

package/dist/cli.js

@@ -1,11 +1,14 @@
-/** `notefeed post ...` — post a note from the command line. */
+/** `notefeed post ...` and `notefeed notes ...`: post and read notes from the command line. */
 import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { parseArgs } from "node:util";
 import { Client, ConfigError, NotefeedError } from "./client.js";
 class UsageError extends Error {
 }
-const USAGE = 'usage: notefeed post <text | - | --file PATH> [--url URL] [--token TOKEN]';
+const USAGE = [
+    "usage: notefeed post <text | - | --file PATH> [--url URL] [--feed FEED] [--password PASSWORD]",
+    "       notefeed notes [--limit N] [--json] [--url URL] [--feed FEED] [--password PASSWORD]",
+].join("\n");
 /** Returns the exit code: 0 ok, 1 server/network error, 2 usage/config error. */
 export async function main(argv, io = process) {
     try {
@@ -14,8 +17,11 @@ export async function main(argv, io = process) {
             allowPositionals: true,
             options: {
                 url: { type: "string" },
-                token: { type: "string" },
+                feed: { type: "string" },
+                password: { type: "string" },
                 file: { type: "string" },
+                limit: { type: "string" },
+                json: { type: "boolean" },
                 version: { type: "boolean" },
                 help: { type: "boolean", short: "h" },
             },
@@ -30,18 +36,29 @@ export async function main(argv, io = process) {
             return 0;
         }
         const [command, text, ...rest] = positionals;
-        if (command !== "post" || rest.length)
-            throw new UsageError(USAGE);
-        const markdown = await read(text, values.file, io);
-        const url = values.url || process.env.NOTEFEED_URL;
-        const token = values.token || process.env.NOTEFEED_TOKEN;
-        if (!url)
-            throw new UsageError("no URL given; pass --url or set NOTEFEED_URL");
-        if (!token)
-            throw new UsageError("no token given; pass --token or set NOTEFEED_TOKEN");
-        const note = await new Client({ url, token }).post(markdown);
-        io.stdout.write(`${note.url}\n`);
-        return 0;
+        if (command === "post" && !rest.length) {
+            const markdown = await read(text, values.file, io);
+            const note = await client(values).post(markdown);
+            io.stdout.write(`${note.url}\n`);
+            return 0;
+        }
+        if (command === "notes" && text === undefined) {
+            const limit = Number(values.limit ?? 20);
+            if (!Number.isInteger(limit) || limit < 1)
+                throw new UsageError("--limit must be a whole number, 1 or more");
+            let left = limit;
+            for await (const n of client(values).notes({ pageSize: Math.min(limit, 100) })) {
+                // To the second, UTC: the same form as the Python CLI, so scripts read either the same way.
+                const when = new Date(n.created_at).toISOString().replace(/\.\d+Z$/, "Z");
+                // --json: exactly the documented fields, like the Python CLI, even if the server adds more.
+                const fields = { id: n.id, title: n.title, markdown: n.markdown, created_at: when, url: n.url };
+                io.stdout.write(values.json ? `${JSON.stringify(fields)}\n` : `${when}  ${n.title || n.id}  ${n.url}\n`);
+                if (--left === 0)
+                    break;
+            }
+            return 0;
+        }
+        throw new UsageError(USAGE);
     }
     catch (e) {
         io.stderr.write(`notefeed: ${e.message.split("\n")[0]}\n`);
@@ -52,6 +69,16 @@ export async function main(argv, io = process) {
         return 2; // parseArgs rejects unknown options with a TypeError
     }
 }
+// Flags win over NOTEFEED_URL, NOTEFEED_FEED and NOTEFEED_PASSWORD.
+function client(values) {
+    const url = values.url || process.env.NOTEFEED_URL;
+    const feed = values.feed || process.env.NOTEFEED_FEED;
+    if (!url)
+        throw new UsageError("no URL given; pass --url or set NOTEFEED_URL");
+    if (!feed)
+        throw new UsageError("no feed given; pass --feed or set NOTEFEED_FEED");
+    return new Client({ url, feed, password: values.password || process.env.NOTEFEED_PASSWORD });
+}
 async function read(text, file, io) {
     if (file) {
         try {

package/dist/client.d.ts

@@ -1,35 +1,70 @@
-/** A tiny client for notefeed's POST /api/notes. No dependencies; uses the global fetch. */
-export type Note = {
-    id: string;
-    url: string;
-};
+import type { Created, Error as ApiError, Note } from "./generated/types.gen.js";
+/** The stable error codes the API answers with. */
+export type ErrorCode = NonNullable<ApiError["code"]>;
+export type { Created, Note };
+/** `timeoutMs` (default 10000) limits each whole request, including reading the answer. */
 export type ClientOptions = {
     url: string;
-    token: string;
+    feed?: string;
+    password?: string;
     timeoutMs?: number;
 };
-/** Any failure talking to notefeed. `status` is the HTTP status, or null (network, config). */
+/** Any failure talking to notefeed. `status` and `code` are null when there was no API answer. */
 export declare class NotefeedError extends Error {
     readonly status: number | null;
-    constructor(message: string, status?: number | null);
+    readonly code: ErrorCode | null;
+    constructor(message: string, status?: number | null, code?: ErrorCode | null);
 }
-/** URL or token missing. */
+/** Raised before sending: no URL, no feed, an invalid feed name or password. */
 export declare class ConfigError extends NotefeedError {
 }
-/** The server rejected the note (400, 415): empty, not UTF-8, wrong type. */
-export declare class InvalidNoteError extends NotefeedError {
-}
-/** Missing or wrong token (401). */
+/** Missing or wrong password on a locked instance. */
 export declare class AuthError extends NotefeedError {
 }
-/** The note is over the server's size limit (413). */
+/** Too many posts or wrong passwords. `retryAfter` is the wait in seconds, or null if none was given. */
+export declare class RateLimitedError extends NotefeedError {
+    readonly retryAfter: number | null;
+    constructor(message: string, status: number | null, code: ErrorCode | null, retryAfter: number | null);
+}
+/** No such note, or a malformed read id. */
+export declare class NotFoundError extends NotefeedError {
+}
+/** The instance's feed or note limit is reached. */
+export declare class LimitReachedError extends NotefeedError {
+}
+/** The note is over the server's size limit. */
 export declare class NoteTooLargeError extends NotefeedError {
 }
+/** The server refused the request itself: invalid or reserved feed, empty note, bad body or parameter. */
+export declare class InvalidRequestError extends NotefeedError {
+}
 export declare class Client {
     readonly url: string;
-    private readonly token;
+    readonly feed: string | null;
+    private readonly api;
     private readonly timeoutMs;
-    /** A notefeed server. URL and token are set once here; post() takes only the note. */
+    /** A notefeed server. The feed set here is the default for every call; each call can override it. */
     constructor(options: ClientOptions);
-    post(markdown: string): Promise<Note>;
+    /** NOTEFEED_URL, NOTEFEED_FEED and NOTEFEED_PASSWORD. */
+    static fromEnv(env?: Record<string, string | undefined>): Client;
+    post(markdown: string, options?: {
+        feed?: string;
+    }): Promise<Created>;
+    /** Every note in the feed, newest first, fetched a page at a time; stop iterating whenever you like. */
+    notes(options?: {
+        feed?: string;
+        pageSize?: number;
+    }): AsyncGenerator<Note>;
+    note(id: string, options?: {
+        feed?: string;
+    }): Promise<Note>;
+    /** Like notes(), by the feed's read id: public, read-only, needs no password. */
+    readNotes(readId: string, options?: {
+        pageSize?: number;
+    }): AsyncGenerator<Note>;
+    readNote(readId: string, id: string): Promise<Note>;
+    private feedFor;
+    private opts;
+    private pages;
+    private call;
 }

package/dist/client.js

@@ -1,83 +1,157 @@
-/** A tiny client for notefeed's POST /api/notes. No dependencies; uses the global fetch. */
-/** Any failure talking to notefeed. `status` is the HTTP status, or null (network, config). */
+/**
+ * The notefeed client: a small convenience layer over the API client generated from the server's
+ * OpenAPI description (./generated, `npm run generate` in the repo). No runtime dependencies.
+ */
+import { createClient, createConfig } from "./generated/client/index.js";
+import { getNote, getReadNote, listNotes, listReadNotes, postNote } from "./generated/sdk.gen.js";
+/** Any failure talking to notefeed. `status` and `code` are null when there was no API answer. */
 export class NotefeedError extends Error {
     status;
-    constructor(message, status = null) {
+    code;
+    constructor(message, status = null, code = null) {
         super(message);
         this.status = status;
+        this.code = code;
         this.name = new.target.name;
     }
 }
-/** URL or token missing. */
+/** Raised before sending: no URL, no feed, an invalid feed name or password. */
 export class ConfigError extends NotefeedError {
 }
-/** The server rejected the note (400, 415): empty, not UTF-8, wrong type. */
-export class InvalidNoteError extends NotefeedError {
-}
-/** Missing or wrong token (401). */
+/** Missing or wrong password on a locked instance. */
 export class AuthError extends NotefeedError {
 }
-/** The note is over the server's size limit (413). */
+/** Too many posts or wrong passwords. `retryAfter` is the wait in seconds, or null if none was given. */
+export class RateLimitedError extends NotefeedError {
+    retryAfter;
+    constructor(message, status, code, retryAfter) {
+        super(message, status, code);
+        this.retryAfter = retryAfter;
+    }
+}
+/** No such note, or a malformed read id. */
+export class NotFoundError extends NotefeedError {
+}
+/** The instance's feed or note limit is reached. */
+export class LimitReachedError extends NotefeedError {
+}
+/** The note is over the server's size limit. */
 export class NoteTooLargeError extends NotefeedError {
 }
-const ERRORS = {
-    400: InvalidNoteError,
-    415: InvalidNoteError,
-    401: AuthError,
-    413: NoteTooLargeError,
+/** The server refused the request itself: invalid or reserved feed, empty note, bad body or parameter. */
+export class InvalidRequestError extends NotefeedError {
+}
+const BY_CODE = {
+    auth: AuthError,
+    not_found: NotFoundError,
+    feed_limit: LimitReachedError,
+    note_limit: LimitReachedError,
+    too_large: NoteTooLargeError,
+    invalid_feed: InvalidRequestError,
+    reserved_feed: InvalidRequestError,
+    empty_note: InvalidRequestError,
+    invalid_body: InvalidRequestError,
+    invalid_request: InvalidRequestError,
+    unsupported_type: InvalidRequestError,
 };
+const FEED_RE = /^[a-z0-9_-]{1,64}$/; // same rule as the server; reserved names still come back as a 400
 export class Client {
     url;
-    token;
+    feed;
+    api;
     timeoutMs;
-    /** A notefeed server. URL and token are set once here; post() takes only the note. */
+    /** A notefeed server. The feed set here is the default for every call; each call can override it. */
     constructor(options) {
-        const { url, token, timeoutMs } = options ?? {};
+        const { url, feed, password, timeoutMs } = options ?? {};
         if (!url)
             throw new ConfigError("no url given");
-        if (!token?.trim())
-            throw new ConfigError("no token given");
         this.url = url.replace(/\/+$/, "");
-        this.token = token.trim();
+        this.feed = feed ? checkFeed(feed) : null;
+        const pw = password?.trim() || null;
         // Never echo the value: it would end up in terminals and CI logs.
-        if (/[\x00-\x1f\x7f]/.test(this.token))
-            throw new ConfigError("token contains invalid characters");
+        if (pw && /[\x00-\x1f\x7f]/.test(pw))
+            throw new ConfigError("password contains invalid characters");
         this.timeoutMs = timeoutMs ?? 10_000;
+        this.api = createClient(createConfig({ baseUrl: this.url, headers: pw ? { Authorization: `Bearer ${pw}` } : {} }));
     }
-    async post(markdown) {
-        let res;
-        try {
-            res = await fetch(`${this.url}/api/notes`, {
-                method: "POST",
-                headers: { Authorization: `Bearer ${this.token}`, "Content-Type": "text/markdown; charset=utf-8" },
-                body: new TextEncoder().encode(markdown),
-                signal: AbortSignal.timeout(this.timeoutMs),
-            });
-        }
-        catch (e) {
-            const cause = e.cause;
-            const reason = cause?.code ?? cause?.message ?? e.message;
+    /** NOTEFEED_URL, NOTEFEED_FEED and NOTEFEED_PASSWORD. */
+    static fromEnv(env = process.env) {
+        return new Client({ url: env.NOTEFEED_URL ?? "", feed: env.NOTEFEED_FEED || undefined, password: env.NOTEFEED_PASSWORD });
+    }
+    async post(markdown, options = {}) {
+        const feed = this.feedFor(options.feed);
+        return this.call(postNote({ client: this.api, path: { feed }, body: { markdown }, ...this.opts() }));
+    }
+    /** Every note in the feed, newest first, fetched a page at a time; stop iterating whenever you like. */
+    notes(options = {}) {
+        const feed = this.feedFor(options.feed);
+        return this.pages((before) => listNotes({ client: this.api, path: { feed }, query: { limit: options.pageSize, before }, ...this.opts() }));
+    }
+    async note(id, options = {}) {
+        const feed = this.feedFor(options.feed);
+        return this.call(getNote({ client: this.api, path: { feed, id }, ...this.opts() }));
+    }
+    /** Like notes(), by the feed's read id: public, read-only, needs no password. */
+    readNotes(readId, options = {}) {
+        return this.pages((before) => listReadNotes({ client: this.api, path: { readId }, query: { limit: options.pageSize, before }, ...this.opts() }));
+    }
+    async readNote(readId, id) {
+        return this.call(getReadNote({ client: this.api, path: { readId, id }, ...this.opts() }));
+    }
+    feedFor(feed) {
+        const f = feed || this.feed;
+        if (!f)
+            throw new ConfigError("no feed given");
+        return checkFeed(f);
+    }
+    opts() {
+        return { signal: AbortSignal.timeout(this.timeoutMs) };
+    }
+    // `before` is the previous page's `next`: older notes only, so notes posted meanwhile never repeat.
+    async *pages(fetchPage) {
+        let before;
+        do {
+            const page = await this.call(fetchPage(before));
+            yield* page.notes;
+            before = page.next ?? undefined;
+        } while (before);
+    }
+    // Anything but a JSON object from the API itself is an error, never a success: a POST that was
+    // redirected (http → https) came back as a GET of the list, so the note was never stored.
+    async call(request) {
+        const { data, error, response } = await request;
+        if (!response) {
+            const cause = error?.cause;
+            const reason = cause?.code ?? cause?.message ?? error?.message ?? "unknown error";
             throw new NotefeedError(`could not reach ${this.url}: ${reason}`);
         }
-        const text = await res.text();
-        if (!res.ok) {
-            let message;
-            try {
-                message = JSON.parse(text).error;
-                if (typeof message !== "string")
-                    throw new Error();
-            }
-            catch {
-                message = `HTTP ${res.status}: ${text.slice(0, 200).replace(/\s+/g, " ").trim()}`;
-            }
-            throw new (ERRORS[res.status] ?? NotefeedError)(message, res.status);
+        if (response.redirected) {
+            throw new NotefeedError(`${this.url} redirected to ${new URL(response.url).origin}: use that address as the URL`, response.status);
+        }
+        if (response.ok) {
+            if (error === undefined && isObject(data))
+                return data;
+            throw new NotefeedError(`unexpected response from ${this.url} (not a notefeed server?)`, response.status);
         }
-        try {
-            const { id, url } = JSON.parse(text);
-            if (typeof id === "string" && typeof url === "string")
-                return { id, url };
+        const body = isObject(error) ? error : null;
+        const code = typeof body?.code === "string" ? body.code : null;
+        let message = typeof body?.error === "string" ? body.error : "";
+        if (!message) {
+            const raw = typeof error === "string" ? error : isObject(error) && Object.keys(error).length ? JSON.stringify(error) : "";
+            message = `HTTP ${response.status}: ${raw.slice(0, 200).replace(/\s+/g, " ").trim()}`.replace(/: $/, "");
         }
-        catch { }
-        throw new NotefeedError(`unexpected response from ${this.url} (not a notefeed server?)`, res.status);
+        if (code === "rate_limited" || code === "too_many_attempts" || response.status === 429) {
+            const retry = response.headers.get("retry-after")?.trim() ?? "";
+            throw new RateLimitedError(message, response.status, code, /^\d+$/.test(retry) ? Number(retry) : null);
+        }
+        const Cls = (code && BY_CODE[code]) || NotefeedError;
+        throw new Cls(message, response.status, code);
     }
 }
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function checkFeed(feed) {
+    // Never echo the name: it is the write key.
+    if (!FEED_RE.test(feed))
+        throw new ConfigError("invalid feed name: use 1-64 of a-z, 0-9, _ and -");
+    return feed;
+}

package/dist/generated/client/client.gen.d.ts

@@ -0,0 +1,2 @@
+import type { Client, Config } from './types.gen.js';
+export declare const createClient: (config?: Config) => Client;

package/dist/generated/client/client.gen.js

@@ -0,0 +1,216 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { createSseClient } from '../core/serverSentEvents.gen.js';
+import { getValidRequestBody } from '../core/utils.gen.js';
+import { buildUrl, createConfig, createInterceptors, getParseAs, mergeConfigs, mergeHeaders, setAuthParams, } from './utils.gen.js';
+export const createClient = (config = {}) => {
+    let _config = mergeConfigs(createConfig(), config);
+    const getConfig = () => ({ ..._config });
+    const setConfig = (config) => {
+        _config = mergeConfigs(_config, config);
+        return getConfig();
+    };
+    const interceptors = createInterceptors();
+    const beforeRequest = async (options) => {
+        const opts = {
+            ..._config,
+            ...options,
+            fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,
+            headers: mergeHeaders(_config.headers, options.headers),
+            serializedBody: undefined,
+        };
+        if (opts.security) {
+            await setAuthParams(opts);
+        }
+        if (opts.requestValidator) {
+            await opts.requestValidator(opts);
+        }
+        if (opts.body !== undefined && opts.bodySerializer) {
+            opts.serializedBody = opts.bodySerializer(opts.body);
+        }
+        // remove Content-Type header if body is empty to avoid sending invalid requests
+        if (opts.body === undefined || opts.serializedBody === '') {
+            opts.headers.delete('Content-Type');
+        }
+        const resolvedOpts = opts;
+        const url = buildUrl(resolvedOpts);
+        return { opts: resolvedOpts, url };
+    };
+    const request = async (options) => {
+        const throwOnError = options.throwOnError ?? _config.throwOnError;
+        const responseStyle = options.responseStyle ?? _config.responseStyle;
+        let request;
+        let response;
+        try {
+            const { opts, url } = await beforeRequest(options);
+            const requestInit = {
+                redirect: 'follow',
+                ...opts,
+                body: getValidRequestBody(opts),
+            };
+            request = new Request(url, requestInit);
+            for (const fn of interceptors.request.fns) {
+                if (fn) {
+                    request = await fn(request, opts);
+                }
+            }
+            // fetch must be assigned here, otherwise it would throw the error:
+            // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
+            const _fetch = opts.fetch;
+            response = await _fetch(request);
+            for (const fn of interceptors.response.fns) {
+                if (fn) {
+                    response = await fn(response, request, opts);
+                }
+            }
+            const result = {
+                request,
+                response,
+            };
+            if (response.ok) {
+                const parseAs = (opts.parseAs === 'auto'
+                    ? getParseAs(response.headers.get('Content-Type'))
+                    : opts.parseAs) ?? 'json';
+                if (response.status === 204 || response.headers.get('Content-Length') === '0') {
+                    let emptyData;
+                    switch (parseAs) {
+                        case 'arrayBuffer':
+                        case 'blob':
+                        case 'text':
+                            emptyData = await response[parseAs]();
+                            break;
+                        case 'formData':
+                            emptyData = new FormData();
+                            break;
+                        case 'stream':
+                            emptyData = response.body;
+                            break;
+                        case 'json':
+                        default:
+                            emptyData = {};
+                            break;
+                    }
+                    return opts.responseStyle === 'data'
+                        ? emptyData
+                        : {
+                            data: emptyData,
+                            ...result,
+                        };
+                }
+                let data;
+                switch (parseAs) {
+                    case 'arrayBuffer':
+                    case 'blob':
+                    case 'formData':
+                    case 'text':
+                        data = await response[parseAs]();
+                        break;
+                    case 'json': {
+                        // Some servers return 200 with no Content-Length and empty body.
+                        // response.json() would throw; read as text and parse if non-empty.
+                        const text = await response.text();
+                        data = text ? JSON.parse(text) : {};
+                        break;
+                    }
+                    case 'stream':
+                        return opts.responseStyle === 'data'
+                            ? response.body
+                            : {
+                                data: response.body,
+                                ...result,
+                            };
+                }
+                if (parseAs === 'json') {
+                    if (opts.responseValidator) {
+                        await opts.responseValidator(data);
+                    }
+                    if (opts.responseTransformer) {
+                        data = await opts.responseTransformer(data);
+                    }
+                }
+                return opts.responseStyle === 'data'
+                    ? data
+                    : {
+                        data,
+                        ...result,
+                    };
+            }
+            const textError = await response.text();
+            let jsonError;
+            try {
+                jsonError = JSON.parse(textError);
+            }
+            catch {
+                // noop
+            }
+            throw jsonError ?? textError;
+        }
+        catch (error) {
+            let finalError = error;
+            for (const fn of interceptors.error.fns) {
+                if (fn) {
+                    finalError = await fn(finalError, response, request, options);
+                }
+            }
+            finalError = finalError || {};
+            if (throwOnError) {
+                throw finalError;
+            }
+            // TODO: we probably want to return error and improve types
+            return responseStyle === 'data'
+                ? undefined
+                : {
+                    error: finalError,
+                    request,
+                    response,
+                };
+        }
+    };
+    const makeMethodFn = (method) => (options) => request({ ...options, method });
+    const makeSseFn = (method) => async (options) => {
+        const { opts, url } = await beforeRequest(options);
+        return createSseClient({
+            ...opts,
+            body: opts.body,
+            method,
+            onRequest: async (url, init) => {
+                let request = new Request(url, init);
+                for (const fn of interceptors.request.fns) {
+                    if (fn) {
+                        request = await fn(request, opts);
+                    }
+                }
+                return request;
+            },
+            serializedBody: getValidRequestBody(opts),
+            url,
+        });
+    };
+    const _buildUrl = (options) => buildUrl({ ..._config, ...options });
+    return {
+        buildUrl: _buildUrl,
+        connect: makeMethodFn('CONNECT'),
+        delete: makeMethodFn('DELETE'),
+        get: makeMethodFn('GET'),
+        getConfig,
+        head: makeMethodFn('HEAD'),
+        interceptors,
+        options: makeMethodFn('OPTIONS'),
+        patch: makeMethodFn('PATCH'),
+        post: makeMethodFn('POST'),
+        put: makeMethodFn('PUT'),
+        request,
+        setConfig,
+        sse: {
+            connect: makeSseFn('CONNECT'),
+            delete: makeSseFn('DELETE'),
+            get: makeSseFn('GET'),
+            head: makeSseFn('HEAD'),
+            options: makeSseFn('OPTIONS'),
+            patch: makeSseFn('PATCH'),
+            post: makeSseFn('POST'),
+            put: makeSseFn('PUT'),
+            trace: makeSseFn('TRACE'),
+        },
+        trace: makeMethodFn('TRACE'),
+    };
+};