@lucra/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 On Lucra, Inc.
+
+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,116 @@
+# @lucra/sdk
+
+Lucra's server client and embeddable components.
+
+- `@lucra/sdk`: server client for the whole public API, with typed methods and models generated from Lucra's OpenAPI document.
+- `@lucra/sdk/embed`: mounts Lucra components in your page (iframes, styled to match your app).
+- `@lucra/sdk/react`: the same components for React.
+
+```sh
+npm install @lucra/sdk
+```
+
+Runs anywhere with `fetch` (Node 18+, Bun, Deno, Workers). Full API reference: https://www.onlucra.com/docs?page=api-reference
+
+## The API
+
+```ts
+import { Lucra, LucraError, paginate } from "@lucra/sdk"
+
+const lucra = new Lucra(process.env.LUCRA_API_KEY!)
+
+const { data: creator } = await lucra.creators.create({ body: { email: "sam@example.com", name: "Sam" } })
+const { data: page } = await lucra.programs.list({ query: { limit: 50 } })
+for await (const payment of paginate((options) => lucra.payments.list(options))) console.log(payment.id)
+
+// Act for a brand you manage, or a roster creator:
+await lucra.as("acct_…").programs.retrieve({ path: { id: "prog_…" } })
+
+try {
+  await lucra.payments.create({ body: { creator: creator.id, net: 5000 }, headers: { "Idempotency-Key": orderId } })
+} catch (error) {
+  if (error instanceof LucraError) console.log(error.code, error.fix, error.requestId)
+}
+```
+
+Methods are named after the resource and action (`list`, `create`, `retrieve`, `update`); every model (`Creator`,
+`Program`, `Payment`…) is exported as a type. Each method resolves to `{ data, response }` and throws a `LucraError` on failure.
+Writes that move money (payments, deposits, refunds, usage, withdrawals) require an `Idempotency-Key` header; money
+resources read `amount` (gross), `fee` and `net`, in cents, and a body names the same field it means (a payment sends the `net`
+the creator receives).
+
+## 1. Allow your origins
+
+When you create the API key in **Settings → Developer**, list the origins that will embed Lucra, such as `https://app.example.com`. A client secret only works from those origins. The hosted `url` works without them.
+
+## 2. Open an embed on your server
+
+```ts
+import { Lucra } from "@lucra/sdk"
+
+const lucra = new Lucra(process.env.LUCRA_API_KEY!)
+
+// A brand you manage: setup (profile, card, store and ad accounts), then its programs.
+const { data: embed } = await lucra.as("acct_…").embeds.create({ body: { components: ["onboarding", "programs"] } })
+// A creator: setup (about you, socials, identity, photo), programs and wallet.
+// await lucra.as("crtr_…").embeds.create({ body: { components: ["onboarding", "creator_programs", "wallet"] } })
+
+// Return embed.clientSecret to your frontend, or send the person to embed.url.
+```
+
+Manage the embeds you've opened for an account with `lucra.as(account).embeds.list()` and `.retrieve({ path: { id } })`,
+and end one early with `.update({ path: { id }, body: { status: "expired" } })`: its url and mounted components stop working.
+
+## 3. Mount components in your frontend
+
+```ts
+import { loadLucra } from "@lucra/sdk/embed"
+
+const lucra = loadLucra({
+  fetchClientSecret: () => fetch("/lucra/embed", { method: "POST" }).then((r) => r.json()).then((r) => r.clientSecret),
+  appearance: { theme: "auto", colors: { primary: "#4f46e5" }, radius: 10 },
+})
+
+lucra.mount("onboarding", document.querySelector("#setup")!)
+lucra.on("complete", ({ component }) => console.log(`${component} finished`))
+
+// Or as elements:
+lucra.defineElements() // <lucra-wallet></lucra-wallet>
+```
+
+React:
+
+```tsx
+import { loadLucra, LucraProvider, LucraOnboarding } from "@lucra/sdk/react"
+
+const lucra = loadLucra({ fetchClientSecret })
+
+export function Setup() {
+  return (
+    <LucraProvider lucra={lucra}>
+      <LucraOnboarding onComplete={() => router.push("/dashboard")} />
+    </LucraProvider>
+  )
+}
+```
+
+Each mount calls `fetchClientSecret` once, because a client secret works for one component load.
+
+Components look like Lucra's app. Appearance is `theme` (`light`, `dark`, `auto`), `colors.primary` and `radius`.
+
+Components (each a whole job, built from Lucra's own screens):
+
+- `onboarding` (either side): a creator answers about-you, connects Instagram or TikTok, verifies identity with Stripe inline and adds a city and photo; a brand adds its profile, a card, then its store and ad accounts.
+- `creator_programs` (creators): explore programs, read the brief and agreements, apply, submit work and follow each submission.
+- `wallet` (creators): balance, withdraw or instant withdraw (the bank account is added on the first), earnings and withdrawal history.
+- `programs` (brands): the programs table, each program's creators and applications, submission review, and the program builder.
+- `payments` (brands): the payments ledger, paying a creator, and retainers.
+- `ads` (brands): campaigns, the campaign builder and results.
+- `messages` (either side): conversations and replies.
+
+Events: `ready`, `change`, `complete`, `error`, `close`; components also say what happened in `event` with the object's `id`: `application.created`, `submission.created`, `withdrawal.created`, `program.created`, `program.updated`, `payment.created`, `campaign.created`, `message.sent`.
+
+## Developing this package
+
+`npm run build` writes ESM and types to `dist/`. `npm run generate` regenerates `src/generated` from
+`lucra-backend/openapi/core.openapi.json` (itself generated from the API's routes with `npm run reference:generate`).

package/dist/embed.d.ts

@@ -0,0 +1,37 @@
+import type { LucraAppearance, LucraComponent, LucraObjectEvent } from "./types.js";
+export type { LucraAppearance, LucraComponent, LucraObjectEvent } from "./types.js";
+export type LucraEvent = "ready" | "change" | "complete" | "error" | "close";
+export type LucraEventDetail = {
+    component: LucraComponent;
+    step?: string;
+    steps?: string[];
+    message?: string;
+    /** What happened, e.g. submission.created, with the new object's `id`. */
+    event?: LucraObjectEvent;
+    id?: string;
+};
+type Listener = (detail: LucraEventDetail) => void;
+export type LoadLucraOptions = {
+    /** Calls your server, which opens an embed (POST /v1/embeds) and returns its clientSecret. Called once per mount. */
+    fetchClientSecret: () => Promise<string>;
+    appearance?: LucraAppearance;
+    locale?: string;
+    /** Where components are served; defaults to Lucra's app. */
+    baseUrl?: string;
+};
+export type MountedComponent = {
+    unmount: () => void;
+    update: (appearance: LucraAppearance) => void;
+};
+export type LucraEmbed = {
+    mount: (component: LucraComponent, element: HTMLElement, options?: {
+        appearance?: LucraAppearance;
+    }) => MountedComponent;
+    /** Restyles every mounted component. */
+    update: (appearance: LucraAppearance) => void;
+    on: (event: LucraEvent, listener: Listener) => () => void;
+    /** Registers <lucra-onboarding>, <lucra-creator-programs>, <lucra-wallet>, <lucra-programs>, <lucra-payments>, <lucra-ads> and <lucra-messages>. */
+    defineElements: () => void;
+};
+/** Embeds Lucra components in iframes; each talks to your page only through postMessage from Lucra's origin. */
+export declare function loadLucra(options: LoadLucraOptions): LucraEmbed;

package/dist/embed.js

@@ -0,0 +1,84 @@
+const components = ["onboarding", "creator_programs", "wallet", "programs", "payments", "ads", "messages"];
+const tagName = (component) => `lucra-${component.replace("_", "-")}`;
+/** Embeds Lucra components in iframes; each talks to your page only through postMessage from Lucra's origin. */
+export function loadLucra(options) {
+    const origin = new URL(options.baseUrl ?? "https://api.onlucra.com").origin;
+    let appearance = options.appearance ?? {};
+    const listeners = new Map();
+    const frames = new Set();
+    const emit = (event, detail) => listeners.get(event)?.forEach((listener) => listener(detail));
+    const mount = (component, element, mountOptions = {}) => {
+        const frame = document.createElement("iframe");
+        const url = new URL(`/embed/${component}`, origin);
+        if (options.locale)
+            url.searchParams.set("locale", options.locale);
+        frame.src = url.toString();
+        frame.title = component.replace("_", " ");
+        frame.allow = "payment; camera; fullscreen";
+        frame.style.cssText = "width:100%;border:0;display:block;height:0;color-scheme:normal";
+        const own = { ...appearance, ...mountOptions.appearance };
+        const post = (message) => frame.contentWindow?.postMessage({ source: "lucra", ...message }, origin);
+        const onMessage = async (event) => {
+            if (event.origin !== origin || event.source !== frame.contentWindow)
+                return;
+            const data = event.data;
+            if (data?.source !== "lucra")
+                return;
+            if (data.type === "loaded") {
+                try {
+                    post({ type: "init", clientSecret: await options.fetchClientSecret(), appearance: own });
+                }
+                catch (error) {
+                    emit("error", { component, message: error instanceof Error ? error.message : "fetchClientSecret failed." });
+                }
+            }
+            else if (data.type === "resize" && typeof data.height === "number") {
+                frame.style.height = `${data.height}px`;
+            }
+            else if (data.type && ["ready", "change", "complete", "error", "close"].includes(data.type)) {
+                emit(data.type, { component, step: data.step, steps: data.steps, message: data.message, event: data.event, id: data.id });
+                element.dispatchEvent(new CustomEvent(`lucra:${data.type}`, { detail: { ...data, component }, bubbles: true }));
+            }
+        };
+        window.addEventListener("message", onMessage);
+        element.replaceChildren(frame);
+        frames.add(frame);
+        return {
+            unmount: () => {
+                window.removeEventListener("message", onMessage);
+                frames.delete(frame);
+                frame.remove();
+            },
+            update: (next) => post({ type: "appearance", appearance: next }),
+        };
+    };
+    const embed = {
+        mount,
+        update: (next) => {
+            appearance = { ...appearance, ...next };
+            frames.forEach((frame) => frame.contentWindow?.postMessage({ source: "lucra", type: "appearance", appearance: next }, origin));
+        },
+        on: (event, listener) => {
+            const set = listeners.get(event) ?? new Set();
+            set.add(listener);
+            listeners.set(event, set);
+            return () => set.delete(listener);
+        },
+        defineElements: () => {
+            for (const component of components) {
+                if (customElements.get(tagName(component)))
+                    continue;
+                customElements.define(tagName(component), class extends HTMLElement {
+                    mounted;
+                    connectedCallback() {
+                        this.mounted = mount(component, this);
+                    }
+                    disconnectedCallback() {
+                        this.mounted?.unmount();
+                    }
+                });
+            }
+        },
+    };
+    return embed;
+}

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'),
+    };
+};

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

@@ -0,0 +1,10 @@
+export type { Auth } from '../core/auth.gen.js';
+export type { QuerySerializerOptions } from '../core/bodySerializer.gen.js';
+export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen.js';
+export { buildClientParams } from '../core/params.gen.js';
+export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen.js';
+export type { ServerSentEventsResult } from '../core/serverSentEvents.gen.js';
+export type { ClientMeta } from '../core/types.gen.js';
+export { createClient } from './client.gen.js';
+export type { Client, ClientOptions, Config, CreateClientConfig, Options, RequestOptions, RequestResult, ResolvedRequestOptions, ResponseStyle, TDataShape, } from './types.gen.js';
+export { createConfig, mergeHeaders } from './utils.gen.js';

package/dist/generated/client/index.js

@@ -0,0 +1,6 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen.js';
+export { buildClientParams } from '../core/params.gen.js';
+export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen.js';
+export { createClient } from './client.gen.js';
+export { createConfig, mergeHeaders } from './utils.gen.js';

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

@@ -0,0 +1,120 @@
+import type { Auth } from '../core/auth.gen.js';
+import type { ServerSentEventsOptions, ServerSentEventsResult } from '../core/serverSentEvents.gen.js';
+import type { Client as CoreClient, Config as CoreConfig } from '../core/types.gen.js';
+import type { Middleware } from './utils.gen.js';
+export type ResponseStyle = 'data' | 'fields';
+export interface Config<T extends ClientOptions = ClientOptions> extends Omit<RequestInit, 'body' | 'headers' | 'method'>, CoreConfig {
+    /**
+     * Base URL for all requests made by this client.
+     */
+    baseUrl?: T['baseUrl'];
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Please don't use the Fetch client for Next.js applications. The `next`
+     * options won't have any effect.
+     *
+     * Install {@link https://www.npmjs.com/package/@hey-api/client-next `@hey-api/client-next`} instead.
+     */
+    next?: never;
+    /**
+     * Return the response data parsed in a specified format. By default, `auto`
+     * will infer the appropriate method from the `Content-Type` response header.
+     * You can override this behavior with any of the {@link Body} methods.
+     * Select `stream` if you don't want to parse response data at all.
+     *
+     * @default 'auto'
+     */
+    parseAs?: 'arrayBuffer' | 'auto' | 'blob' | 'formData' | 'json' | 'stream' | 'text';
+    /**
+     * Should we return only data or multiple fields (data, error, response, etc.)?
+     *
+     * @default 'fields'
+     */
+    responseStyle?: ResponseStyle;
+    /**
+     * Throw an error instead of returning it in the response?
+     *
+     * @default false
+     */
+    throwOnError?: T['throwOnError'];
+}
+export interface RequestOptions<TData = unknown, TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config<{
+    responseStyle: TResponseStyle;
+    throwOnError: ThrowOnError;
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+    /**
+     * Any body that you want to add to your request.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}
+     */
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    /**
+     * Security mechanism(s) to use for the request.
+     */
+    security?: ReadonlyArray<Auth>;
+    url: Url;
+}
+export interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
+    headers: Headers;
+    serializedBody?: string;
+}
+export type RequestResult<TData = unknown, TError = unknown, ThrowOnError extends boolean = boolean, TResponseStyle extends ResponseStyle = 'fields'> = ThrowOnError extends true ? Promise<TResponseStyle extends 'data' ? TData extends Record<string, unknown> ? TData[keyof TData] : TData : {
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    request: Request;
+    response: Response;
+}> : Promise<TResponseStyle extends 'data' ? (TData extends Record<string, unknown> ? TData[keyof TData] : TData) | undefined : ({
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    error: undefined;
+} | {
+    data: undefined;
+    error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
+}) & {
+    /** request may be undefined, because error may be from building the request object itself */
+    request?: Request;
+    /** response may be undefined, because error may be from building the request object itself or from a network error */
+    response?: Response;
+}>;
+export interface ClientOptions {
+    baseUrl?: string;
+    responseStyle?: ResponseStyle;
+    throwOnError?: boolean;
+}
+type MethodFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type SseFn = <TData = unknown, _TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<never, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData>>;
+type RequestFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type BuildUrlFn = <TData extends {
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    url: string;
+}>(options: TData & Options<TData>) => string;
+export type Client = CoreClient<RequestFn, Config, MethodFn, BuildUrlFn, SseFn> & {
+    interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
+};
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends ClientOptions = ClientOptions> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
+export interface TDataShape {
+    body?: unknown;
+    headers?: unknown;
+    path?: unknown;
+    query?: unknown;
+    url: string;
+}
+type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
+export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
+export {};

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

@@ -0,0 +1,2 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export {};

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

@@ -0,0 +1,37 @@
+import type { QuerySerializerOptions } from '../core/bodySerializer.gen.js';
+import type { Client, ClientOptions, Config, RequestOptions } from './types.gen.js';
+export declare const createQuerySerializer: <T = unknown>({ parameters, ...args }?: QuerySerializerOptions) => ((queryParams: T) => string);
+/**
+ * Infers parseAs value from provided Content-Type header.
+ */
+export declare const getParseAs: (contentType: string | null) => Exclude<Config["parseAs"], "auto">;
+export declare function setAuthParams(options: Pick<RequestOptions, 'auth' | 'query' | 'security'> & {
+    headers: Headers;
+}): Promise<void>;
+export declare const buildUrl: Client['buildUrl'];
+export declare const mergeConfigs: (a: Config, b: Config) => Config;
+export declare const mergeHeaders: (...headers: Array<Required<Config>["headers"] | undefined>) => Headers;
+type ErrInterceptor<Err, Res, Req, Options> = (error: Err, 
+/** response may be undefined due to a network error where no response object is produced */
+response: Res | undefined, 
+/** request may be undefined, because error may be from building the request object itself */
+request: Req | undefined, options: Options) => Err | Promise<Err>;
+type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
+type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
+declare class Interceptors<Interceptor> {
+    fns: Array<Interceptor | null>;
+    clear(): void;
+    eject(id: number | Interceptor): void;
+    exists(id: number | Interceptor): boolean;
+    getInterceptorIndex(id: number | Interceptor): number;
+    update(id: number | Interceptor, fn: Interceptor): number | Interceptor | false;
+    use(fn: Interceptor): number;
+}
+export interface Middleware<Req, Res, Err, Options> {
+    error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
+    request: Interceptors<ReqInterceptor<Req, Options>>;
+    response: Interceptors<ResInterceptor<Res, Req, Options>>;
+}
+export declare const createInterceptors: <Req, Res, Err, Options>() => Middleware<Req, Res, Err, Options>;
+export declare const createConfig: <T extends ClientOptions = ClientOptions>(override?: Config<Omit<ClientOptions, keyof T> & T>) => Config<Omit<ClientOptions, keyof T> & T>;
+export {};