@robosystems/client 0.1.10 → 0.1.12

package/core/auth.gen.d.ts

@@ -0,0 +1,18 @@
+export type AuthToken = string | undefined;
+export interface Auth {
+    /**
+     * Which part of the request do we use to send the auth?
+     *
+     * @default 'header'
+     */
+    in?: 'header' | 'query' | 'cookie';
+    /**
+     * Header or query parameter name.
+     *
+     * @default 'Authorization'
+     */
+    name?: string;
+    scheme?: 'basic' | 'bearer';
+    type: 'apiKey' | 'http';
+}
+export declare const getAuthToken: (auth: Auth, callback: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken) => Promise<string | undefined>;

package/core/auth.gen.js

@@ -0,0 +1,18 @@
+"use strict";
+// This file is auto-generated by @hey-api/openapi-ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAuthToken = void 0;
+const getAuthToken = async (auth, callback) => {
+    const token = typeof callback === 'function' ? await callback(auth) : callback;
+    if (!token) {
+        return;
+    }
+    if (auth.scheme === 'bearer') {
+        return `Bearer ${token}`;
+    }
+    if (auth.scheme === 'basic') {
+        return `Basic ${btoa(token)}`;
+    }
+    return token;
+};
+exports.getAuthToken = getAuthToken;

package/core/bodySerializer.gen.d.ts

@@ -0,0 +1,17 @@
+import type { ArrayStyle, ObjectStyle, SerializerOptions } from './pathSerializer.gen';
+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/core/bodySerializer.gen.js

@@ -0,0 +1,57 @@
+"use strict";
+// This file is auto-generated by @hey-api/openapi-ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.urlSearchParamsBodySerializer = exports.jsonBodySerializer = exports.formDataBodySerializer = void 0;
+const serializeFormDataPair = (data, key, value) => {
+    if (typeof value === 'string' || value instanceof Blob) {
+        data.append(key, value);
+    }
+    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));
+    }
+};
+exports.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;
+    },
+};
+exports.jsonBodySerializer = {
+    bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === 'bigint' ? value.toString() : value),
+};
+exports.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/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/core/params.gen.js

@@ -0,0 +1,92 @@
+"use strict";
+// This file is auto-generated by @hey-api/openapi-ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClientParams = void 0;
+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];
+        }
+    }
+};
+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;
+};
+exports.buildClientParams = buildClientParams;

package/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/core/pathSerializer.gen.js

@@ -0,0 +1,123 @@
+"use strict";
+// This file is auto-generated by @hey-api/openapi-ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeObjectParam = exports.serializePrimitiveParam = exports.serializeArrayParam = exports.separatorObjectExplode = exports.separatorArrayNoExplode = exports.separatorArrayExplode = void 0;
+const separatorArrayExplode = (style) => {
+    switch (style) {
+        case 'label':
+            return '.';
+        case 'matrix':
+            return ';';
+        case 'simple':
+            return ',';
+        default:
+            return '&';
+    }
+};
+exports.separatorArrayExplode = separatorArrayExplode;
+const separatorArrayNoExplode = (style) => {
+    switch (style) {
+        case 'form':
+            return ',';
+        case 'pipeDelimited':
+            return '|';
+        case 'spaceDelimited':
+            return '%20';
+        default:
+            return ',';
+    }
+};
+exports.separatorArrayNoExplode = separatorArrayNoExplode;
+const separatorObjectExplode = (style) => {
+    switch (style) {
+        case 'label':
+            return '.';
+        case 'matrix':
+            return ';';
+        case 'simple':
+            return ',';
+        default:
+            return '&';
+    }
+};
+exports.separatorObjectExplode = separatorObjectExplode;
+const serializeArrayParam = ({ allowReserved, explode, name, style, value, }) => {
+    if (!explode) {
+        const joinedValues = (allowReserved ? value : value.map((v) => encodeURIComponent(v))).join((0, exports.separatorArrayNoExplode)(style));
+        switch (style) {
+            case 'label':
+                return `.${joinedValues}`;
+            case 'matrix':
+                return `;${name}=${joinedValues}`;
+            case 'simple':
+                return joinedValues;
+            default:
+                return `${name}=${joinedValues}`;
+        }
+    }
+    const separator = (0, exports.separatorArrayExplode)(style);
+    const joinedValues = value
+        .map((v) => {
+        if (style === 'label' || style === 'simple') {
+            return allowReserved ? v : encodeURIComponent(v);
+        }
+        return (0, exports.serializePrimitiveParam)({
+            allowReserved,
+            name,
+            value: v,
+        });
+    })
+        .join(separator);
+    return style === 'label' || style === 'matrix'
+        ? separator + joinedValues
+        : joinedValues;
+};
+exports.serializeArrayParam = serializeArrayParam;
+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)}`;
+};
+exports.serializePrimitiveParam = serializePrimitiveParam;
+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 = (0, exports.separatorObjectExplode)(style);
+    const joinedValues = Object.entries(value)
+        .map(([key, v]) => (0, exports.serializePrimitiveParam)({
+        allowReserved,
+        name: style === 'deepObject' ? `${name}[${key}]` : key,
+        value: v,
+    }))
+        .join(separator);
+    return style === 'label' || style === 'matrix'
+        ? separator + joinedValues
+        : joinedValues;
+};
+exports.serializeObjectParam = serializeObjectParam;

package/core/types.gen.d.ts

@@ -0,0 +1,78 @@
+import type { Auth, AuthToken } from './auth.gen';
+import type { BodySerializer, QuerySerializer, QuerySerializerOptions } from './bodySerializer.gen';
+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/core/types.gen.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file is auto-generated by @hey-api/openapi-ts
+/* eslint-disable no-undef */
+Object.defineProperty(exports, "__esModule", { value: true });

package/extensions/OperationClient.d.js

@@ -0,0 +1,45 @@
+
+
+
+export declare class OperationClient {
+    private sseClients;
+    private cleanupTimeouts;
+    private config;
+    private cleanupIntervalMs;
+    private cleanupInterval?;
+    constructor(config);
+    monitorOperation(operationId, options?)>;
+    /**
+     * Monitor multiple operations concurrently
+     */
+    monitorMultiple(operationIds, options?)>>;
+    /**
+     * Get the current status of an operation (point-in-time check)
+     */
+    getStatus(operationId);
+    /**
+     * Cancel a pending or running operation
+     */
+    cancelOperation(operationId);
+    /**
+     * Wait for an operation with a simple promise interface
+     */
+    waitForOperation(operationId, timeoutMs?);
+    /**
+     * Monitor operation with async iterator for progress updates
+     */
+    monitorWithProgress(operationId)>;
+    private cleanupClient;
+    /**
+     * Schedule automatic cleanup of SSE client after a delay
+     */
+    private scheduleCleanup;
+    /**
+     * Perform periodic cleanup of stale SSE connections
+     */
+    private performPeriodicCleanup;
+    /**
+     * Close all active SSE connections and clean up resources
+     */
+    closeAll();
+}

package/extensions/OperationClient.d.ts

@@ -0,0 +1,64 @@
+export interface OperationProgress {
+    message: string;
+    progressPercent?: number;
+    details?: Record<string, any>;
+}
+export interface OperationResult<T = any> {
+    success: boolean;
+    result?: T;
+    error?: string;
+    metadata?: Record<string, any>;
+}
+export interface OperationMonitorOptions {
+    onProgress?: (progress: OperationProgress) => void;
+    onQueueUpdate?: (position: number, estimatedWait: number) => void;
+    timeout?: number;
+}
+export declare class OperationClient {
+    private sseClients;
+    private cleanupTimeouts;
+    private config;
+    private cleanupIntervalMs;
+    private cleanupInterval?;
+    constructor(config: {
+        baseUrl: string;
+        credentials?: 'include' | 'same-origin' | 'omit';
+        headers?: Record<string, string>;
+        maxRetries?: number;
+        retryDelay?: number;
+    });
+    monitorOperation<T = any>(operationId: string, options?: OperationMonitorOptions): Promise<OperationResult<T>>;
+    /**
+     * Monitor multiple operations concurrently
+     */
+    monitorMultiple<T = any>(operationIds: string[], options?: OperationMonitorOptions): Promise<Map<string, OperationResult<T>>>;
+    /**
+     * Get the current status of an operation (point-in-time check)
+     */
+    getStatus(operationId: string): Promise<any>;
+    /**
+     * Cancel a pending or running operation
+     */
+    cancelOperation(operationId: string): Promise<void>;
+    /**
+     * Wait for an operation with a simple promise interface
+     */
+    waitForOperation<T = any>(operationId: string, timeoutMs?: number): Promise<T>;
+    /**
+     * Monitor operation with async iterator for progress updates
+     */
+    monitorWithProgress<T = any>(operationId: string): AsyncIterableIterator<OperationProgress | OperationResult<T>>;
+    private cleanupClient;
+    /**
+     * Schedule automatic cleanup of SSE client after a delay
+     */
+    private scheduleCleanup;
+    /**
+     * Perform periodic cleanup of stale SSE connections
+     */
+    private performPeriodicCleanup;
+    /**
+     * Close all active SSE connections and clean up resources
+     */
+    closeAll(): void;
+}