@pixelml/sdk 0.0.0-dev-202512250746

package/dist/gen/core/bodySerializer.gen.d.ts

@@ -0,0 +1,17 @@
+import type { ArrayStyle, ObjectStyle, SerializerOptions } from "./pathSerializer.gen.js";
+export type QuerySerializer = (query: Record<string, unknown>) => string;
+export type BodySerializer = (body: any) => any;
+export interface QuerySerializerOptions {
+    allowReserved?: boolean;
+    array?: SerializerOptions<ArrayStyle>;
+    object?: SerializerOptions<ObjectStyle>;
+}
+export declare const formDataBodySerializer: {
+    bodySerializer: <T extends Record<string, any> | Array<Record<string, any>>>(body: T) => FormData;
+};
+export declare const jsonBodySerializer: {
+    bodySerializer: <T>(body: T) => string;
+};
+export declare const urlSearchParamsBodySerializer: {
+    bodySerializer: <T extends Record<string, any> | Array<Record<string, any>>>(body: T) => string;
+};

package/dist/gen/core/bodySerializer.gen.js

@@ -0,0 +1,57 @@
+// This file is auto-generated by @hey-api/openapi-ts
+const serializeFormDataPair = (data, key, value) => {
+    if (typeof value === "string" || value instanceof Blob) {
+        data.append(key, value);
+    }
+    else if (value instanceof Date) {
+        data.append(key, value.toISOString());
+    }
+    else {
+        data.append(key, JSON.stringify(value));
+    }
+};
+const serializeUrlSearchParamsPair = (data, key, value) => {
+    if (typeof value === "string") {
+        data.append(key, value);
+    }
+    else {
+        data.append(key, JSON.stringify(value));
+    }
+};
+export const formDataBodySerializer = {
+    bodySerializer: (body) => {
+        const data = new FormData();
+        Object.entries(body).forEach(([key, value]) => {
+            if (value === undefined || value === null) {
+                return;
+            }
+            if (Array.isArray(value)) {
+                value.forEach((v) => serializeFormDataPair(data, key, v));
+            }
+            else {
+                serializeFormDataPair(data, key, value);
+            }
+        });
+        return data;
+    },
+};
+export const jsonBodySerializer = {
+    bodySerializer: (body) => JSON.stringify(body, (_key, value) => (typeof value === "bigint" ? value.toString() : value)),
+};
+export const urlSearchParamsBodySerializer = {
+    bodySerializer: (body) => {
+        const data = new URLSearchParams();
+        Object.entries(body).forEach(([key, value]) => {
+            if (value === undefined || value === null) {
+                return;
+            }
+            if (Array.isArray(value)) {
+                value.forEach((v) => serializeUrlSearchParamsPair(data, key, v));
+            }
+            else {
+                serializeUrlSearchParamsPair(data, key, value);
+            }
+        });
+        return data.toString();
+    },
+};

package/dist/gen/core/params.gen.d.ts

@@ -0,0 +1,33 @@
+type Slot = "body" | "headers" | "path" | "query";
+export type Field = {
+    in: Exclude<Slot, "body">;
+    /**
+     * Field name. This is the name we want the user to see and use.
+     */
+    key: string;
+    /**
+     * Field mapped name. This is the name we want to use in the request.
+     * If omitted, we use the same value as `key`.
+     */
+    map?: string;
+} | {
+    in: Extract<Slot, "body">;
+    /**
+     * Key isn't required for bodies.
+     */
+    key?: string;
+    map?: string;
+};
+export interface Fields {
+    allowExtra?: Partial<Record<Slot, boolean>>;
+    args?: ReadonlyArray<Field>;
+}
+export type FieldsConfig = ReadonlyArray<Field | Fields>;
+interface Params {
+    body: unknown;
+    headers: Record<string, unknown>;
+    path: Record<string, unknown>;
+    query: Record<string, unknown>;
+}
+export declare const buildClientParams: (args: ReadonlyArray<unknown>, fields: FieldsConfig) => Params;
+export {};

package/dist/gen/core/params.gen.js

@@ -0,0 +1,89 @@
+// This file is auto-generated by @hey-api/openapi-ts
+const extraPrefixesMap = {
+    $body_: "body",
+    $headers_: "headers",
+    $path_: "path",
+    $query_: "query",
+};
+const extraPrefixes = Object.entries(extraPrefixesMap);
+const buildKeyMap = (fields, map) => {
+    if (!map) {
+        map = new Map();
+    }
+    for (const config of fields) {
+        if ("in" in config) {
+            if (config.key) {
+                map.set(config.key, {
+                    in: config.in,
+                    map: config.map,
+                });
+            }
+        }
+        else if (config.args) {
+            buildKeyMap(config.args, map);
+        }
+    }
+    return map;
+};
+const stripEmptySlots = (params) => {
+    for (const [slot, value] of Object.entries(params)) {
+        if (value && typeof value === "object" && !Object.keys(value).length) {
+            delete params[slot];
+        }
+    }
+};
+export const buildClientParams = (args, fields) => {
+    const params = {
+        body: {},
+        headers: {},
+        path: {},
+        query: {},
+    };
+    const map = buildKeyMap(fields);
+    let config;
+    for (const [index, arg] of args.entries()) {
+        if (fields[index]) {
+            config = fields[index];
+        }
+        if (!config) {
+            continue;
+        }
+        if ("in" in config) {
+            if (config.key) {
+                const field = map.get(config.key);
+                const name = field.map || config.key;
+                params[field.in][name] = arg;
+            }
+            else {
+                params.body = arg;
+            }
+        }
+        else {
+            for (const [key, value] of Object.entries(arg ?? {})) {
+                const field = map.get(key);
+                if (field) {
+                    const name = field.map || key;
+                    params[field.in][name] = value;
+                }
+                else {
+                    const extra = extraPrefixes.find(([prefix]) => key.startsWith(prefix));
+                    if (extra) {
+                        const [prefix, slot] = extra;
+                        params[slot][key.slice(prefix.length)] = value;
+                    }
+                    else {
+                        for (const [slot, allowed] of Object.entries(config.allowExtra ?? {})) {
+                            if (allowed) {
+                                ;
+                                params[slot][key] = value;
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    stripEmptySlots(params);
+    return params;
+};

package/dist/gen/core/pathSerializer.gen.d.ts

@@ -0,0 +1,33 @@
+interface SerializeOptions<T> extends SerializePrimitiveOptions, SerializerOptions<T> {
+}
+interface SerializePrimitiveOptions {
+    allowReserved?: boolean;
+    name: string;
+}
+export interface SerializerOptions<T> {
+    /**
+     * @default true
+     */
+    explode: boolean;
+    style: T;
+}
+export type ArrayStyle = "form" | "spaceDelimited" | "pipeDelimited";
+export type ArraySeparatorStyle = ArrayStyle | MatrixStyle;
+type MatrixStyle = "label" | "matrix" | "simple";
+export type ObjectStyle = "form" | "deepObject";
+type ObjectSeparatorStyle = ObjectStyle | MatrixStyle;
+interface SerializePrimitiveParam extends SerializePrimitiveOptions {
+    value: string;
+}
+export declare const separatorArrayExplode: (style: ArraySeparatorStyle) => "." | ";" | "," | "&";
+export declare const separatorArrayNoExplode: (style: ArraySeparatorStyle) => "," | "|" | "%20";
+export declare const separatorObjectExplode: (style: ObjectSeparatorStyle) => "." | ";" | "," | "&";
+export declare const serializeArrayParam: ({ allowReserved, explode, name, style, value, }: SerializeOptions<ArraySeparatorStyle> & {
+    value: unknown[];
+}) => string;
+export declare const serializePrimitiveParam: ({ allowReserved, name, value }: SerializePrimitiveParam) => string;
+export declare const serializeObjectParam: ({ allowReserved, explode, name, style, value, valueOnly, }: SerializeOptions<ObjectSeparatorStyle> & {
+    value: Record<string, unknown> | Date;
+    valueOnly?: boolean;
+}) => string;
+export {};

package/dist/gen/core/pathSerializer.gen.js

@@ -0,0 +1,106 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export const separatorArrayExplode = (style) => {
+    switch (style) {
+        case "label":
+            return ".";
+        case "matrix":
+            return ";";
+        case "simple":
+            return ",";
+        default:
+            return "&";
+    }
+};
+export const separatorArrayNoExplode = (style) => {
+    switch (style) {
+        case "form":
+            return ",";
+        case "pipeDelimited":
+            return "|";
+        case "spaceDelimited":
+            return "%20";
+        default:
+            return ",";
+    }
+};
+export const separatorObjectExplode = (style) => {
+    switch (style) {
+        case "label":
+            return ".";
+        case "matrix":
+            return ";";
+        case "simple":
+            return ",";
+        default:
+            return "&";
+    }
+};
+export const serializeArrayParam = ({ allowReserved, explode, name, style, value, }) => {
+    if (!explode) {
+        const joinedValues = (allowReserved ? value : value.map((v) => encodeURIComponent(v))).join(separatorArrayNoExplode(style));
+        switch (style) {
+            case "label":
+                return `.${joinedValues}`;
+            case "matrix":
+                return `;${name}=${joinedValues}`;
+            case "simple":
+                return joinedValues;
+            default:
+                return `${name}=${joinedValues}`;
+        }
+    }
+    const separator = separatorArrayExplode(style);
+    const joinedValues = value
+        .map((v) => {
+        if (style === "label" || style === "simple") {
+            return allowReserved ? v : encodeURIComponent(v);
+        }
+        return serializePrimitiveParam({
+            allowReserved,
+            name,
+            value: v,
+        });
+    })
+        .join(separator);
+    return style === "label" || style === "matrix" ? separator + joinedValues : joinedValues;
+};
+export const serializePrimitiveParam = ({ allowReserved, name, value }) => {
+    if (value === undefined || value === null) {
+        return "";
+    }
+    if (typeof value === "object") {
+        throw new Error("Deeply-nested arrays/objects aren’t supported. Provide your own `querySerializer()` to handle these.");
+    }
+    return `${name}=${allowReserved ? value : encodeURIComponent(value)}`;
+};
+export const serializeObjectParam = ({ allowReserved, explode, name, style, value, valueOnly, }) => {
+    if (value instanceof Date) {
+        return valueOnly ? value.toISOString() : `${name}=${value.toISOString()}`;
+    }
+    if (style !== "deepObject" && !explode) {
+        let values = [];
+        Object.entries(value).forEach(([key, v]) => {
+            values = [...values, key, allowReserved ? v : encodeURIComponent(v)];
+        });
+        const joinedValues = values.join(",");
+        switch (style) {
+            case "form":
+                return `${name}=${joinedValues}`;
+            case "label":
+                return `.${joinedValues}`;
+            case "matrix":
+                return `;${name}=${joinedValues}`;
+            default:
+                return joinedValues;
+        }
+    }
+    const separator = separatorObjectExplode(style);
+    const joinedValues = Object.entries(value)
+        .map(([key, v]) => serializePrimitiveParam({
+        allowReserved,
+        name: style === "deepObject" ? `${name}[${key}]` : key,
+        value: v,
+    }))
+        .join(separator);
+    return style === "label" || style === "matrix" ? separator + joinedValues : joinedValues;
+};

package/dist/gen/core/serverSentEvents.gen.d.ts

@@ -0,0 +1,59 @@
+import type { Config } from "./types.gen.js";
+export type ServerSentEventsOptions<TData = unknown> = Omit<RequestInit, "method"> & Pick<Config, "method" | "responseTransformer" | "responseValidator"> & {
+    /**
+     * Callback invoked when a network or parsing error occurs during streaming.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param error The error that occurred.
+     */
+    onSseError?: (error: unknown) => void;
+    /**
+     * Callback invoked when an event is streamed from the server.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param event Event streamed from the server.
+     * @returns Nothing (void).
+     */
+    onSseEvent?: (event: StreamEvent<TData>) => void;
+    /**
+     * Default retry delay in milliseconds.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 3000
+     */
+    sseDefaultRetryDelay?: number;
+    /**
+     * Maximum number of retry attempts before giving up.
+     */
+    sseMaxRetryAttempts?: number;
+    /**
+     * Maximum retry delay in milliseconds.
+     *
+     * Applies only when exponential backoff is used.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 30000
+     */
+    sseMaxRetryDelay?: number;
+    /**
+     * Optional sleep function for retry backoff.
+     *
+     * Defaults to using `setTimeout`.
+     */
+    sseSleepFn?: (ms: number) => Promise<void>;
+    url: string;
+};
+export interface StreamEvent<TData = unknown> {
+    data: TData;
+    event?: string;
+    id?: string;
+    retry?: number;
+}
+export type ServerSentEventsResult<TData = unknown, TReturn = void, TNext = unknown> = {
+    stream: AsyncGenerator<TData extends Record<string, unknown> ? TData[keyof TData] : TData, TReturn, TNext>;
+};
+export declare const createSseClient: <TData = unknown>({ onSseError, onSseEvent, responseTransformer, responseValidator, sseDefaultRetryDelay, sseMaxRetryAttempts, sseMaxRetryDelay, sseSleepFn, url, ...options }: ServerSentEventsOptions) => ServerSentEventsResult<TData>;

package/dist/gen/core/serverSentEvents.gen.js

@@ -0,0 +1,117 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export const createSseClient = ({ onSseError, onSseEvent, responseTransformer, responseValidator, sseDefaultRetryDelay, sseMaxRetryAttempts, sseMaxRetryDelay, sseSleepFn, url, ...options }) => {
+    let lastEventId;
+    const sleep = sseSleepFn ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const createStream = async function* () {
+        let retryDelay = sseDefaultRetryDelay ?? 3000;
+        let attempt = 0;
+        const signal = options.signal ?? new AbortController().signal;
+        while (true) {
+            if (signal.aborted)
+                break;
+            attempt++;
+            const headers = options.headers instanceof Headers
+                ? options.headers
+                : new Headers(options.headers);
+            if (lastEventId !== undefined) {
+                headers.set("Last-Event-ID", lastEventId);
+            }
+            try {
+                const response = await fetch(url, { ...options, headers, signal });
+                if (!response.ok)
+                    throw new Error(`SSE failed: ${response.status} ${response.statusText}`);
+                if (!response.body)
+                    throw new Error("No body in SSE response");
+                const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
+                let buffer = "";
+                const abortHandler = () => {
+                    try {
+                        reader.cancel();
+                    }
+                    catch {
+                        // noop
+                    }
+                };
+                signal.addEventListener("abort", abortHandler);
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += value;
+                        const chunks = buffer.split("\n\n");
+                        buffer = chunks.pop() ?? "";
+                        for (const chunk of chunks) {
+                            const lines = chunk.split("\n");
+                            const dataLines = [];
+                            let eventName;
+                            for (const line of lines) {
+                                if (line.startsWith("data:")) {
+                                    dataLines.push(line.replace(/^data:\s*/, ""));
+                                }
+                                else if (line.startsWith("event:")) {
+                                    eventName = line.replace(/^event:\s*/, "");
+                                }
+                                else if (line.startsWith("id:")) {
+                                    lastEventId = line.replace(/^id:\s*/, "");
+                                }
+                                else if (line.startsWith("retry:")) {
+                                    const parsed = Number.parseInt(line.replace(/^retry:\s*/, ""), 10);
+                                    if (!Number.isNaN(parsed)) {
+                                        retryDelay = parsed;
+                                    }
+                                }
+                            }
+                            let data;
+                            let parsedJson = false;
+                            if (dataLines.length) {
+                                const rawData = dataLines.join("\n");
+                                try {
+                                    data = JSON.parse(rawData);
+                                    parsedJson = true;
+                                }
+                                catch {
+                                    data = rawData;
+                                }
+                            }
+                            if (parsedJson) {
+                                if (responseValidator) {
+                                    await responseValidator(data);
+                                }
+                                if (responseTransformer) {
+                                    data = await responseTransformer(data);
+                                }
+                            }
+                            onSseEvent?.({
+                                data,
+                                event: eventName,
+                                id: lastEventId,
+                                retry: retryDelay,
+                            });
+                            if (dataLines.length) {
+                                yield data;
+                            }
+                        }
+                    }
+                }
+                finally {
+                    signal.removeEventListener("abort", abortHandler);
+                    reader.releaseLock();
+                }
+                break; // exit loop on normal completion
+            }
+            catch (error) {
+                // connection failed or aborted; retry after delay
+                onSseError?.(error);
+                if (sseMaxRetryAttempts !== undefined && attempt >= sseMaxRetryAttempts) {
+                    break; // stop after firing error
+                }
+                // exponential backoff: double retry each attempt, cap at 30s
+                const backoff = Math.min(retryDelay * 2 ** (attempt - 1), sseMaxRetryDelay ?? 30000);
+                await sleep(backoff);
+            }
+        }
+    };
+    const stream = createStream();
+    return { stream };
+};

package/dist/gen/core/types.gen.d.ts

@@ -0,0 +1,78 @@
+import type { Auth, AuthToken } from "./auth.gen.js";
+import type { BodySerializer, QuerySerializer, QuerySerializerOptions } from "./bodySerializer.gen.js";
+export interface Client<RequestFn = never, Config = unknown, MethodFn = never, BuildUrlFn = never> {
+    /**
+     * Returns the final request URL.
+     */
+    buildUrl: BuildUrlFn;
+    connect: MethodFn;
+    delete: MethodFn;
+    get: MethodFn;
+    getConfig: () => Config;
+    head: MethodFn;
+    options: MethodFn;
+    patch: MethodFn;
+    post: MethodFn;
+    put: MethodFn;
+    request: RequestFn;
+    setConfig: (config: Config) => Config;
+    trace: MethodFn;
+}
+export interface Config {
+    /**
+     * Auth token or a function returning auth token. The resolved value will be
+     * added to the request payload as defined by its `security` array.
+     */
+    auth?: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken;
+    /**
+     * A function for serializing request body parameter. By default,
+     * {@link JSON.stringify()} will be used.
+     */
+    bodySerializer?: BodySerializer | null;
+    /**
+     * An object containing any HTTP headers that you want to pre-populate your
+     * `Headers` object with.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/Headers/Headers#init See more}
+     */
+    headers?: RequestInit["headers"] | Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined | unknown>;
+    /**
+     * The request method.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#method See more}
+     */
+    method?: "CONNECT" | "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT" | "TRACE";
+    /**
+     * A function for serializing request query parameters. By default, arrays
+     * will be exploded in form style, objects will be exploded in deepObject
+     * style, and reserved characters are percent-encoded.
+     *
+     * This method will have no effect if the native `paramsSerializer()` Axios
+     * API function is used.
+     *
+     * {@link https://swagger.io/docs/specification/serialization/#query View examples}
+     */
+    querySerializer?: QuerySerializer | QuerySerializerOptions;
+    /**
+     * A function validating request data. This is useful if you want to ensure
+     * the request conforms to the desired shape, so it can be safely sent to
+     * the server.
+     */
+    requestValidator?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function transforming response data before it's returned. This is useful
+     * for post-processing data, e.g. converting ISO strings into Date objects.
+     */
+    responseTransformer?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function validating response data. This is useful if you want to ensure
+     * the response conforms to the desired shape, so it can be safely passed to
+     * the transformers and returned to the user.
+     */
+    responseValidator?: (data: unknown) => Promise<unknown>;
+}
+type IsExactlyNeverOrNeverUndefined<T> = [T] extends [never] ? true : [T] extends [never | undefined] ? [undefined] extends [T] ? false : true : false;
+export type OmitNever<T extends Record<string, unknown>> = {
+    [K in keyof T as IsExactlyNeverOrNeverUndefined<T[K]> extends true ? never : K]: T[K];
+};
+export {};

package/dist/gen/core/types.gen.js

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

package/dist/gen/core/utils.gen.d.ts

@@ -0,0 +1,14 @@
+import type { QuerySerializer } from "./bodySerializer.gen.js";
+export interface PathSerializer {
+    path: Record<string, unknown>;
+    url: string;
+}
+export declare const PATH_PARAM_RE: RegExp;
+export declare const defaultPathSerializer: ({ path, url: _url }: PathSerializer) => string;
+export declare const getUrl: ({ baseUrl, path, query, querySerializer, url: _url, }: {
+    baseUrl?: string;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    querySerializer: QuerySerializer;
+    url: string;
+}) => string;

package/dist/gen/core/utils.gen.js

@@ -0,0 +1,69 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { serializeArrayParam, serializeObjectParam, serializePrimitiveParam, } from "./pathSerializer.gen.js";
+export const PATH_PARAM_RE = /\{[^{}]+\}/g;
+export const defaultPathSerializer = ({ path, url: _url }) => {
+    let url = _url;
+    const matches = _url.match(PATH_PARAM_RE);
+    if (matches) {
+        for (const match of matches) {
+            let explode = false;
+            let name = match.substring(1, match.length - 1);
+            let style = "simple";
+            if (name.endsWith("*")) {
+                explode = true;
+                name = name.substring(0, name.length - 1);
+            }
+            if (name.startsWith(".")) {
+                name = name.substring(1);
+                style = "label";
+            }
+            else if (name.startsWith(";")) {
+                name = name.substring(1);
+                style = "matrix";
+            }
+            const value = path[name];
+            if (value === undefined || value === null) {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                url = url.replace(match, serializeArrayParam({ explode, name, style, value }));
+                continue;
+            }
+            if (typeof value === "object") {
+                url = url.replace(match, serializeObjectParam({
+                    explode,
+                    name,
+                    style,
+                    value: value,
+                    valueOnly: true,
+                }));
+                continue;
+            }
+            if (style === "matrix") {
+                url = url.replace(match, `;${serializePrimitiveParam({
+                    name,
+                    value: value,
+                })}`);
+                continue;
+            }
+            const replaceValue = encodeURIComponent(style === "label" ? `.${value}` : value);
+            url = url.replace(match, replaceValue);
+        }
+    }
+    return url;
+};
+export const getUrl = ({ baseUrl, path, query, querySerializer, url: _url, }) => {
+    const pathUrl = _url.startsWith("/") ? _url : `/${_url}`;
+    let url = (baseUrl ?? "") + pathUrl;
+    if (path) {
+        url = defaultPathSerializer({ path, url });
+    }
+    let search = query ? querySerializer(query) : "";
+    if (search.startsWith("?")) {
+        search = search.substring(1);
+    }
+    if (search) {
+        url += `?${search}`;
+    }
+    return url;
+};