@cpajs/cpa 0.0.0-stage → 0.0.1-alpha-2

package/dist/client/resources/server.js

@@ -0,0 +1,49 @@
+import { CpaHttpError } from '../errors.js';
+function readInfo(headers) {
+    const version = headers.get('X-CPA-VERSION');
+    if (version === null)
+        return undefined;
+    return {
+        version,
+        commit: headers.get('X-CPA-COMMIT') ?? '',
+        buildDate: headers.get('X-CPA-BUILD-DATE') ?? '',
+        supportPlugin: headers.get('X-CPA-SUPPORT-PLUGIN') === '1',
+    };
+}
+/** Server information: `/healthz`, version headers and `/v8/management/server/*`. */
+export class ServerResource {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** `GET /healthz` (no management key needed). */
+    async health(options = {}) {
+        return (await this.#t.request({ ...options, method: 'GET', path: '/healthz', root: true, anonymous: true })).data;
+    }
+    /**
+     * Version, commit, build date and plugin support of the running server,
+     * read from the `X-CPA-*` headers of a cheap authenticated request.
+     */
+    async info(options = {}) {
+        let headers;
+        try {
+            headers = (await this.#t.request({ ...options, method: 'GET', path: '/config/config-version' })).headers;
+        }
+        catch (error) {
+            // A config without `config-version` answers 404, which still carries the headers.
+            if (!(error instanceof CpaHttpError) || error.status !== 404)
+                throw error;
+            headers = error.headers;
+        }
+        const info = readInfo(headers);
+        if (!info)
+            throw new TypeError('The server did not send X-CPA-VERSION; is management enabled?');
+        return info;
+    }
+    /** Latest CLIProxyAPI release tag on GitHub (e.g. `"v8.0.43"`), fetched by the server. */
+    async latestVersion(options = {}) {
+        const res = await this.#t.request({ ...options, method: 'GET', path: '/server/latest-version' });
+        return res.data['latest-version'];
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/client/resources/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/client/resources/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,SAAS,QAAQ,CAAC,OAAgB;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO;QACL,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;QACzC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAChD,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,GAAG;KAC3D,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,OAAO,cAAc;IAChB,EAAE,CAAY;IAEvB,YAAY,SAAoB;QAC9B,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,MAAM,CAAC,OAAO,GAAmB,EAAE;QACvC,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAkB,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrI,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,OAAO,GAAmB,EAAE;QACrC,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAU,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACpH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kFAAkF;YAClF,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;gBAAE,MAAM,KAAK,CAAC;YAC1E,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,aAAa,CAAC,OAAO,GAAmB,EAAE;QAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAwB,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACxH,OAAO,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/client/resources/usage.d.ts

@@ -0,0 +1,16 @@
+import type { ApiKeyUsageResponse, UsageQueueResponse } from '../types/observability.ts';
+import type { RequestOptions, Transport } from '../transport.ts';
+/** `/v8/management/observability/usage/*`. */
+export declare class UsageResource {
+    #private;
+    constructor(transport: Transport);
+    /** Request counters per config API key. Map keys are `"<base-url>|<api-key>"` with the raw key. */
+    apiKeys(options?: RequestOptions): Promise<ApiKeyUsageResponse>;
+    /**
+     * Removes and returns up to `count` (default 1) of the oldest queued usage
+     * records. Destructive: concurrent consumers split the records between them.
+     * Records are only queued while `observability.usage.usage-statistics-enabled` is on.
+     */
+    popQueue(count?: number, options?: RequestOptions): Promise<UsageQueueResponse>;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/client/resources/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/client/resources/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjE,8CAA8C;AAC9C,qBAAa,aAAa;;IAGxB,YAAY,SAAS,EAAE,SAAS,EAE/B;IAED,mGAAmG;IAC7F,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAExE;IAED;;;;OAIG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIxF;CACF"}

package/dist/client/resources/usage.js

@@ -0,0 +1,20 @@
+/** `/v8/management/observability/usage/*`. */
+export class UsageResource {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Request counters per config API key. Map keys are `"<base-url>|<api-key>"` with the raw key. */
+    async apiKeys(options = {}) {
+        return (await this.#t.request({ ...options, method: 'GET', path: '/observability/usage/api-keys' })).data;
+    }
+    /**
+     * Removes and returns up to `count` (default 1) of the oldest queued usage
+     * records. Destructive: concurrent consumers split the records between them.
+     * Records are only queued while `observability.usage.usage-statistics-enabled` is on.
+     */
+    async popQueue(count, options = {}) {
+        return (await this.#t.request({ ...options, method: 'GET', path: '/observability/usage/queue', query: { count } })).data;
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/client/resources/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/client/resources/usage.ts"],"names":[],"mappings":"AAGA,8CAA8C;AAC9C,MAAM,OAAO,aAAa;IACf,EAAE,CAAY;IAEvB,YAAY,SAAoB;QAC9B,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,mGAAmG;IACnG,KAAK,CAAC,OAAO,CAAC,OAAO,GAAmB,EAAE;QACxC,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAsB,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjI,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAc,EAAE,OAAO,GAAmB,EAAE;QACzD,OAAO,CACL,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAqB,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAC/H,CAAC,IAAI,CAAC;IACT,CAAC;CACF"}

package/dist/client/transport.d.ts

@@ -0,0 +1,60 @@
+export declare const MANAGEMENT_PREFIX = "/v8/management";
+export type FetchLike = (input: Request) => Promise<Response>;
+export type QueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
+export type Query = Readonly<Record<string, QueryValue>>;
+export interface ClientOptions {
+    /**
+     * Server root, e.g. `http://127.0.0.1:8317` or `https://example.com/cpa`.
+     * A path prefix (reverse proxy) is kept; `/v8/management` is appended to it.
+     */
+    baseUrl: string | URL;
+    /** Management key (`management.secret-key` or `MANAGEMENT_PASSWORD`), not a model API key. */
+    managementKey: string;
+    /** Custom fetch. Defaults to the global `fetch`. */
+    fetch?: (input: Request) => Promise<Response>;
+    /** Headers sent with every request. */
+    headers?: HeadersInit;
+    /** Default per-request timeout in ms. `0` or omitted disables it. */
+    timeoutMs?: number;
+}
+/** Per-call options accepted by every client method. */
+export interface RequestOptions {
+    signal?: AbortSignal | undefined;
+    /** Overrides the client's default timeout; `0` disables it. */
+    timeoutMs?: number | undefined;
+    headers?: HeadersInit | undefined;
+}
+export type ResponseType = 'json' | 'text' | 'blob' | 'response';
+export interface RawRequest extends RequestOptions {
+    method: string;
+    /** Path below `/v8/management` (e.g. `/config`), already encoded. */
+    path: string;
+    query?: Query;
+    /** Serialised with `JSON.stringify`, including strings and `null`. */
+    json?: unknown;
+    /** Sent as-is. Mutually exclusive with `json`. */
+    body?: BodyInit;
+    /** Content type for `body`. FormData sets its own. */
+    contentType?: string;
+    responseType?: ResponseType;
+    /** Skip the management key, for unauthenticated routes. */
+    anonymous?: boolean;
+    /** Resolve `path` against the server root instead of `/v8/management`. */
+    root?: boolean;
+}
+export interface TransportResponse<T> {
+    data: T;
+    status: number;
+    headers: Headers;
+}
+/** Joins the base URL and a management path while keeping any base path prefix. */
+export declare function managementUrl(baseUrl: string | URL, path: string, root?: boolean): URL;
+export declare class Transport {
+    #private;
+    constructor(options: ClientOptions);
+    get baseUrl(): URL;
+    request<T>(req: RawRequest): Promise<TransportResponse<T>>;
+}
+/** Encodes `a/b/c` or `['a', 'b', 'c']` as URL path segments. */
+export declare function encodePath(path: string | readonly string[], what?: string): string;
+//# sourceMappingURL=transport.d.ts.map

package/dist/client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;AAC/G,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IACtB,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,uCAAuC;IACvC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAWD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,GAAG,CAMpF;AAED,qBAAa,SAAS;;IAOpB,YAAY,OAAO,EAAE,aAAa,EAYjC;IAED,IAAI,OAAO,IAAI,GAAG,CAEjB;IAEK,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAmG/D;CACF;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAAE,IAAI,SAAS,GAAG,MAAM,CASlF"}

package/dist/client/transport.js

@@ -0,0 +1,170 @@
+import { CpaAbortError, CpaHttpError, CpaNetworkError, CpaResponseError, CpaTimeoutError } from './errors.js';
+export const MANAGEMENT_PREFIX = '/v8/management';
+function appendQuery(url, query) {
+    if (!query)
+        return;
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value))
+            for (const item of value)
+                url.searchParams.append(key, String(item));
+        else
+            url.searchParams.append(key, String(value));
+    }
+}
+/** Joins the base URL and a management path while keeping any base path prefix. */
+export function managementUrl(baseUrl, path, root = false) {
+    const base = new URL(baseUrl);
+    const prefix = base.pathname.replace(/\/+$/, '');
+    const url = new URL(base.origin);
+    url.pathname = `${prefix}${root ? '' : MANAGEMENT_PREFIX}${path}`;
+    return url;
+}
+export class Transport {
+    #baseUrl;
+    #managementKey;
+    #fetch;
+    #headers;
+    #timeoutMs;
+    constructor(options) {
+        if (!options.baseUrl)
+            throw new TypeError('baseUrl is required.');
+        if (!options.managementKey)
+            throw new TypeError('managementKey is required.');
+        this.#baseUrl = new URL(options.baseUrl);
+        if (this.#baseUrl.protocol !== 'http:' && this.#baseUrl.protocol !== 'https:') {
+            throw new TypeError(`baseUrl must be http(s), got ${this.#baseUrl.protocol}`);
+        }
+        this.#managementKey = options.managementKey;
+        const custom = options.fetch;
+        this.#fetch = custom ? (request) => custom(request) : (request) => fetch(request);
+        this.#headers = new Headers(options.headers);
+        this.#timeoutMs = options.timeoutMs ?? 0;
+    }
+    get baseUrl() {
+        return new URL(this.#baseUrl);
+    }
+    async request(req) {
+        const url = managementUrl(this.#baseUrl, req.path, req.root);
+        appendQuery(url, req.query);
+        const target = { method: req.method, url: url.toString() };
+        const headers = new Headers(this.#headers);
+        new Headers(req.headers).forEach((value, key) => headers.set(key, value));
+        if (!req.anonymous)
+            headers.set('Authorization', `Bearer ${this.#managementKey}`);
+        let body;
+        if ('json' in req) {
+            body = JSON.stringify(req.json);
+            headers.set('Content-Type', 'application/json');
+        }
+        else if (req.body !== undefined) {
+            body = req.body;
+            if (req.contentType)
+                headers.set('Content-Type', req.contentType);
+        }
+        if (!headers.has('Accept'))
+            headers.set('Accept', req.responseType === 'json' || !req.responseType ? 'application/json' : '*/*');
+        const timeoutMs = req.timeoutMs ?? this.#timeoutMs;
+        const userSignal = req.signal;
+        let timedOut = false;
+        const classify = (error) => {
+            if (userSignal?.aborted)
+                return new CpaAbortError(`${target.method} ${target.url} was aborted`, target, { cause: userSignal.reason });
+            if (timedOut)
+                return new CpaTimeoutError(target, timeoutMs, { cause: error });
+            return new CpaNetworkError(`${target.method} ${target.url} failed: ${error?.message ?? String(error)}`, target, {
+                cause: error,
+            });
+        };
+        if (userSignal?.aborted)
+            throw classify(userSignal.reason);
+        // One controller owned by this call, rather than AbortSignal.any/timeout: on some Node
+        // versions signals derived that way can be garbage-collected before they fire.
+        const controller = new AbortController();
+        let rejectAborted = () => { };
+        const aborted = new Promise((_, reject) => {
+            rejectAborted = reject;
+        });
+        aborted.catch(() => { });
+        const abort = (reason) => {
+            controller.abort(reason);
+            rejectAborted(classify(reason));
+        };
+        const onUserAbort = () => abort(userSignal.reason);
+        userSignal?.addEventListener('abort', onUserAbort, { once: true });
+        let timer;
+        if (timeoutMs > 0) {
+            timer = setTimeout(() => {
+                timedOut = true;
+                abort(new DOMException(`Timed out after ${timeoutMs} ms`, 'TimeoutError'));
+            }, timeoutMs);
+        }
+        const release = () => {
+            clearTimeout(timer);
+            userSignal?.removeEventListener('abort', onUserAbort);
+        };
+        // Every await below races the abort, so a fetch that ignores its signal still settles.
+        const guard = (promise) => Promise.race([promise, aborted]);
+        const init = { method: req.method, headers, redirect: 'manual', signal: controller.signal };
+        if (body !== undefined)
+            init.body = body;
+        const responseType = req.responseType ?? 'json';
+        try {
+            let response;
+            try {
+                response = await guard(this.#fetch(new Request(url, init)));
+            }
+            catch (error) {
+                throw error instanceof CpaAbortError || error instanceof CpaTimeoutError ? error : classify(error);
+            }
+            if (!response.ok) {
+                throw new CpaHttpError(target, response, await guard(response.text()));
+            }
+            if (responseType === 'response') {
+                return { data: response, status: response.status, headers: response.headers };
+            }
+            if (responseType === 'blob') {
+                return { data: (await guard(response.blob())), status: response.status, headers: response.headers };
+            }
+            const text = await guard(response.text());
+            if (responseType === 'text')
+                return { data: text, status: response.status, headers: response.headers };
+            if (text === '')
+                return { data: undefined, status: response.status, headers: response.headers };
+            try {
+                return { data: JSON.parse(text), status: response.status, headers: response.headers };
+            }
+            catch (cause) {
+                throw new CpaResponseError(`${target.method} ${target.url} returned invalid JSON`, target, response.status, text, { cause });
+            }
+        }
+        catch (error) {
+            if (error instanceof CpaHttpError || error instanceof CpaResponseError || error instanceof CpaAbortError || error instanceof CpaTimeoutError) {
+                throw error;
+            }
+            throw classify(error);
+        }
+        finally {
+            // For `response`, the caller reads the body; the timeout covers the headers only,
+            // while the caller's own signal keeps working through the request's signal.
+            if (responseType === 'response')
+                clearTimeout(timer);
+            else
+                release();
+        }
+    }
+}
+/** Encodes `a/b/c` or `['a', 'b', 'c']` as URL path segments. */
+export function encodePath(path, what = 'path') {
+    const segments = typeof path === 'string' ? path.split('/').filter((s, i, all) => s !== '' || (i > 0 && i < all.length - 1)) : [...path];
+    for (const segment of segments) {
+        if (segment === '')
+            throw new TypeError(`${what} contains an empty segment.`);
+        if (typeof path !== 'string' && segment.includes('/')) {
+            throw new TypeError(`${what} segment "${segment}" contains "/", which CPA cannot address; edit its parent instead.`);
+        }
+    }
+    return segments.map(encodeURIComponent).join('/');
+}
+//# sourceMappingURL=transport.js.map

package/dist/client/transport.js.map

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

package/dist/client/types/common.d.ts

@@ -0,0 +1,38 @@
+export interface StatusErrorBody {
+    status: 'error';
+    error: string;
+}
+export interface OkStatus {
+    status: 'ok';
+}
+export type AuthStatus = 'unknown' | 'active' | 'pending' | 'refreshing' | 'error' | 'disabled';
+export type SIWCStatus = 'off' | 'valid' | 'invalid';
+export type CooldownReason = 'credential_quota' | 'quota' | 'cloudflare_challenge' | 'model_not_supported' | 'invalid_grant' | 'unauthorized' | 'payment_required' | 'not_found' | 'transient_error' | 'unknown';
+/** Any JSON value. */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Ten-minute request bucket; `time` is `"HH:MM-HH:MM"` in the server's local time. */
+export interface RecentRequestBucket {
+    time: string;
+    success: number;
+    failed: number;
+}
+export interface PartialFailure {
+    name: string;
+    error: string;
+}
+/** Error body from the auth middleware and most ops handlers. */
+export interface CpaSimpleError {
+    error: string;
+}
+/** Error body from latest-version, plugins, plugin store, plugin delete. */
+export interface CpaCodedError {
+    error: string;
+    message: string;
+    [extra: string]: unknown;
+}
+export type CpaErrorBody = CpaSimpleError | CpaCodedError;
+/** Auth outcomes: 401 missing/invalid key; 403 banned / remote disabled / key not set; 404 management disabled (empty body). */
+export type ManagementAuthErrorMessage = "missing management key" | "invalid management key" | "remote management disabled" | "remote management key not set" | `IP banned due to too many failed attempts. Try again in ${string}`;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/client/types/common.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAAG,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACnE,MAAM,WAAW,QAAQ;IAAG,MAAM,EAAE,IAAI,CAAA;CAAE;AAE1C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;AAChG,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;AACrD,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAAG,OAAO,GAAG,sBAAsB,GAAG,qBAAqB,GAC7E,eAAe,GAAG,cAAc,GAAG,kBAAkB,GAAG,WAAW,GACnE,iBAAiB,GAAG,SAAS,CAAC;AAElC,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtG,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAEtF,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAE/D,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,MAAM,CAAA;CAAE;AACjD,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AACD,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AAE1D,gIAAgI;AAChI,MAAM,MAAM,0BAA0B,GAClC,wBAAwB,GACxB,wBAAwB,GACxB,4BAA4B,GAC5B,+BAA+B,GAC/B,2DAA2D,MAAM,EAAE,CAAC"}

package/dist/client/types/common.js

@@ -0,0 +1,4 @@
+// Shared response types.
+// Derived from CLIProxyAPI v8.0.43; see docs/api-coverage.md.
+export {};
+//# sourceMappingURL=common.js.map

package/dist/client/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/client/types/common.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,8DAA8D"}