uapi-browser-sdk 0.1.11 → 0.1.13

package/dist/internal/src/runtime.js

@@ -0,0 +1,322 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UAPI
+ * UAPI 官方接口文档
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export const BASE_PATH = "https://uapis.cn/api/v1".replace(/\/+$/, "");
+export class Configuration {
+    constructor(configuration = {}) {
+        this.configuration = configuration;
+    }
+    set config(configuration) {
+        this.configuration = configuration;
+    }
+    get basePath() {
+        return this.configuration.basePath != null ? this.configuration.basePath : BASE_PATH;
+    }
+    get fetchApi() {
+        return this.configuration.fetchApi;
+    }
+    get middleware() {
+        return this.configuration.middleware || [];
+    }
+    get queryParamsStringify() {
+        return this.configuration.queryParamsStringify || querystring;
+    }
+    get username() {
+        return this.configuration.username;
+    }
+    get password() {
+        return this.configuration.password;
+    }
+    get apiKey() {
+        const apiKey = this.configuration.apiKey;
+        if (apiKey) {
+            return typeof apiKey === 'function' ? apiKey : () => apiKey;
+        }
+        return undefined;
+    }
+    get accessToken() {
+        const accessToken = this.configuration.accessToken;
+        if (accessToken) {
+            return typeof accessToken === 'function' ? accessToken : async () => accessToken;
+        }
+        return undefined;
+    }
+    get headers() {
+        return this.configuration.headers;
+    }
+    get credentials() {
+        return this.configuration.credentials;
+    }
+}
+export const DefaultConfig = new Configuration();
+/**
+ * This is the base class for all generated API classes.
+ */
+export class BaseAPI {
+    constructor(configuration = DefaultConfig) {
+        this.configuration = configuration;
+        this.fetchApi = async (url, init) => {
+            let fetchParams = { url, init };
+            for (const middleware of this.middleware) {
+                if (middleware.pre) {
+                    fetchParams = await middleware.pre({
+                        fetch: this.fetchApi,
+                        ...fetchParams,
+                    }) || fetchParams;
+                }
+            }
+            let response = undefined;
+            try {
+                response = await (this.configuration.fetchApi || fetch)(fetchParams.url, fetchParams.init);
+            }
+            catch (e) {
+                for (const middleware of this.middleware) {
+                    if (middleware.onError) {
+                        response = await middleware.onError({
+                            fetch: this.fetchApi,
+                            url: fetchParams.url,
+                            init: fetchParams.init,
+                            error: e,
+                            response: response ? response.clone() : undefined,
+                        }) || response;
+                    }
+                }
+                if (response === undefined) {
+                    if (e instanceof Error) {
+                        throw new FetchError(e, 'The request failed and the interceptors did not return an alternative response');
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }
+            for (const middleware of this.middleware) {
+                if (middleware.post) {
+                    response = await middleware.post({
+                        fetch: this.fetchApi,
+                        url: fetchParams.url,
+                        init: fetchParams.init,
+                        response: response.clone(),
+                    }) || response;
+                }
+            }
+            return response;
+        };
+        this.middleware = configuration.middleware;
+    }
+    withMiddleware(...middlewares) {
+        const next = this.clone();
+        next.middleware = next.middleware.concat(...middlewares);
+        return next;
+    }
+    withPreMiddleware(...preMiddlewares) {
+        const middlewares = preMiddlewares.map((pre) => ({ pre }));
+        return this.withMiddleware(...middlewares);
+    }
+    withPostMiddleware(...postMiddlewares) {
+        const middlewares = postMiddlewares.map((post) => ({ post }));
+        return this.withMiddleware(...middlewares);
+    }
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    isJsonMime(mime) {
+        if (!mime) {
+            return false;
+        }
+        return BaseAPI.jsonRegex.test(mime);
+    }
+    async request(context, initOverrides) {
+        const { url, init } = await this.createFetchParams(context, initOverrides);
+        const response = await this.fetchApi(url, init);
+        if (response && (response.status >= 200 && response.status < 300)) {
+            return response;
+        }
+        throw new ResponseError(response, 'Response returned an error code');
+    }
+    async createFetchParams(context, initOverrides) {
+        let url = this.configuration.basePath + context.path;
+        if (context.query !== undefined && Object.keys(context.query).length !== 0) {
+            // only add the querystring to the URL if there are query parameters.
+            // this is done to avoid urls ending with a "?" character which buggy webservers
+            // do not handle correctly sometimes.
+            url += '?' + this.configuration.queryParamsStringify(context.query);
+        }
+        const headers = Object.assign({}, this.configuration.headers, context.headers);
+        Object.keys(headers).forEach(key => headers[key] === undefined ? delete headers[key] : {});
+        const initOverrideFn = typeof initOverrides === "function"
+            ? initOverrides
+            : async () => initOverrides;
+        const initParams = {
+            method: context.method,
+            headers,
+            body: context.body,
+            credentials: this.configuration.credentials,
+        };
+        const overriddenInit = {
+            ...initParams,
+            ...(await initOverrideFn({
+                init: initParams,
+                context,
+            }))
+        };
+        let body;
+        if (isFormData(overriddenInit.body)
+            || (overriddenInit.body instanceof URLSearchParams)
+            || isBlob(overriddenInit.body)) {
+            body = overriddenInit.body;
+        }
+        else if (this.isJsonMime(headers['Content-Type'])) {
+            body = JSON.stringify(overriddenInit.body);
+        }
+        else {
+            body = overriddenInit.body;
+        }
+        const init = {
+            ...overriddenInit,
+            body
+        };
+        return { url, init };
+    }
+    /**
+     * Create a shallow clone of `this` by constructing a new instance
+     * and then shallow cloning data members.
+     */
+    clone() {
+        const constructor = this.constructor;
+        const next = new constructor(this.configuration);
+        next.middleware = this.middleware.slice();
+        return next;
+    }
+}
+BaseAPI.jsonRegex = new RegExp('^(:?application\/json|[^;/ \t]+\/[^;/ \t]+[+]json)[ \t]*(:?;.*)?$', 'i');
+;
+function isBlob(value) {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+function isFormData(value) {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+}
+export class ResponseError extends Error {
+    constructor(response, msg) {
+        super(msg);
+        this.response = response;
+        this.name = "ResponseError";
+    }
+}
+export class FetchError extends Error {
+    constructor(cause, msg) {
+        super(msg);
+        this.cause = cause;
+        this.name = "FetchError";
+    }
+}
+export class RequiredError extends Error {
+    constructor(field, msg) {
+        super(msg);
+        this.field = field;
+        this.name = "RequiredError";
+    }
+}
+export const COLLECTION_FORMATS = {
+    csv: ",",
+    ssv: " ",
+    tsv: "\t",
+    pipes: "|",
+};
+export function querystring(params, prefix = '') {
+    return Object.keys(params)
+        .map(key => querystringSingleKey(key, params[key], prefix))
+        .filter(part => part.length > 0)
+        .join('&');
+}
+function querystringSingleKey(key, value, keyPrefix = '') {
+    const fullKey = keyPrefix + (keyPrefix.length ? `[${key}]` : key);
+    if (value instanceof Array) {
+        const multiValue = value.map(singleValue => encodeURIComponent(String(singleValue)))
+            .join(`&${encodeURIComponent(fullKey)}=`);
+        return `${encodeURIComponent(fullKey)}=${multiValue}`;
+    }
+    if (value instanceof Set) {
+        const valueAsArray = Array.from(value);
+        return querystringSingleKey(key, valueAsArray, keyPrefix);
+    }
+    if (value instanceof Date) {
+        return `${encodeURIComponent(fullKey)}=${encodeURIComponent(value.toISOString())}`;
+    }
+    if (value instanceof Object) {
+        return querystring(value, fullKey);
+    }
+    return `${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`;
+}
+export function exists(json, key) {
+    const value = json[key];
+    return value !== null && value !== undefined;
+}
+export function mapValues(data, fn) {
+    const result = {};
+    for (const key of Object.keys(data)) {
+        result[key] = fn(data[key]);
+    }
+    return result;
+}
+export function canConsumeForm(consumes) {
+    for (const consume of consumes) {
+        if ('multipart/form-data' === consume.contentType) {
+            return true;
+        }
+    }
+    return false;
+}
+export class JSONApiResponse {
+    constructor(raw, transformer = (jsonValue) => jsonValue) {
+        this.raw = raw;
+        this.transformer = transformer;
+    }
+    async value() {
+        return this.transformer(await this.raw.json());
+    }
+}
+export class VoidApiResponse {
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return undefined;
+    }
+}
+export class BlobApiResponse {
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return await this.raw.blob();
+    }
+    ;
+}
+export class TextApiResponse {
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return await this.raw.text();
+    }
+    ;
+}

package/dist/src/errors.d.ts

@@ -0,0 +1,85 @@
+export interface RateLimitPolicyEntry {
+    name: string;
+    quota?: number;
+    unit?: string;
+    windowSeconds?: number;
+}
+export interface RateLimitStateEntry {
+    name: string;
+    remaining?: number;
+    unit?: string;
+    resetAfterSeconds?: number;
+}
+export interface ResponseMeta {
+    requestId?: string;
+    retryAfterSeconds?: number;
+    debitStatus?: string;
+    creditsRequested?: number;
+    creditsCharged?: number;
+    creditsPricing?: string;
+    activeQuotaBuckets?: number;
+    stopOnEmpty?: boolean;
+    rateLimitPolicyRaw?: string;
+    rateLimitRaw?: string;
+    rateLimitPolicies: Record<string, RateLimitPolicyEntry>;
+    rateLimits: Record<string, RateLimitStateEntry>;
+    balanceLimitCents?: number;
+    balanceRemainingCents?: number;
+    quotaLimitCredits?: number;
+    quotaRemainingCredits?: number;
+    visitorQuotaLimitCredits?: number;
+    visitorQuotaRemainingCredits?: number;
+    rawHeaders: Record<string, string>;
+}
+export declare class UapiError extends Error {
+    code: string;
+    status: number;
+    details?: unknown;
+    payload?: unknown;
+    meta?: ResponseMeta;
+    constructor(code: string, status: number, message: string, details?: unknown, payload?: unknown, meta?: ResponseMeta);
+}
+export declare class ApiErrorError extends UapiError {
+}
+export declare class AvatarNotFoundError extends UapiError {
+}
+export declare class ConversionFailedError extends UapiError {
+}
+export declare class FileOpenErrorError extends UapiError {
+}
+export declare class FileRequiredError extends UapiError {
+}
+export declare class InsufficientCreditsError extends UapiError {
+}
+export declare class InternalServerErrorError extends UapiError {
+}
+export declare class InvalidParameterError extends UapiError {
+}
+export declare class InvalidParamsError extends UapiError {
+}
+export declare class NotFoundError extends UapiError {
+}
+export declare class NoMatchError extends UapiError {
+}
+export declare class NoTrackingDataError extends UapiError {
+}
+export declare class PhoneInfoFailedError extends UapiError {
+}
+export declare class RecognitionFailedError extends UapiError {
+}
+export declare class RequestEntityTooLargeError extends UapiError {
+}
+export declare class ServiceBusyError extends UapiError {
+}
+export declare class TimezoneNotFoundError extends UapiError {
+}
+export declare class UnauthorizedError extends UapiError {
+}
+export declare class UnsupportedCarrierError extends UapiError {
+}
+export declare class UnsupportedFormatError extends UapiError {
+}
+export declare class VisitorMonthlyQuotaExhaustedError extends UapiError {
+}
+export declare function extractMetaFromHeaders(headers: Headers | Record<string, unknown> | undefined): ResponseMeta;
+export declare function mapError(res: Response, body: unknown): UapiError;

package/dist/src/errors.js

@@ -0,0 +1,247 @@
+export class UapiError extends Error {
+    constructor(code, status, message, details, payload, meta) {
+        super(`[${status}] ${code}: ${message}`);
+        this.code = code;
+        this.status = status;
+        this.details = details;
+        this.payload = payload;
+        this.meta = meta;
+    }
+}
+export class ApiErrorError extends UapiError {
+}
+export class AvatarNotFoundError extends UapiError {
+}
+export class ConversionFailedError extends UapiError {
+}
+export class FileOpenErrorError extends UapiError {
+}
+export class FileRequiredError extends UapiError {
+}
+export class InsufficientCreditsError extends UapiError {
+}
+export class InternalServerErrorError extends UapiError {
+}
+export class InvalidParameterError extends UapiError {
+}
+export class InvalidParamsError extends UapiError {
+}
+export class NotFoundError extends UapiError {
+}
+export class NoMatchError extends UapiError {
+}
+export class NoTrackingDataError extends UapiError {
+}
+export class PhoneInfoFailedError extends UapiError {
+}
+export class RecognitionFailedError extends UapiError {
+}
+export class RequestEntityTooLargeError extends UapiError {
+}
+export class ServiceBusyError extends UapiError {
+}
+export class TimezoneNotFoundError extends UapiError {
+}
+export class UnauthorizedError extends UapiError {
+}
+export class UnsupportedCarrierError extends UapiError {
+}
+export class UnsupportedFormatError extends UapiError {
+}
+export class VisitorMonthlyQuotaExhaustedError extends UapiError {
+}
+function defaultCode(status) {
+    switch (status) {
+        case 400:
+            return 'INVALID_PARAMETER';
+        case 401:
+            return 'UNAUTHORIZED';
+        case 402:
+            return 'INSUFFICIENT_CREDITS';
+        case 404:
+            return 'NOT_FOUND';
+        case 413:
+            return 'REQUEST_ENTITY_TOO_LARGE';
+        case 429:
+            return 'SERVICE_BUSY';
+        case 500:
+            return 'INTERNAL_SERVER_ERROR';
+        default:
+            return 'API_ERROR';
+    }
+}
+function toHeaderMap(headers) {
+    const out = {};
+    if (!headers) {
+        return out;
+    }
+    if (typeof headers.forEach === 'function') {
+        ;
+        headers.forEach((value, key) => {
+            out[String(key).toLowerCase()] = String(value);
+        });
+        return out;
+    }
+    for (const [rawKey, rawValue] of Object.entries(headers)) {
+        if (rawValue === undefined || rawValue === null) {
+            continue;
+        }
+        out[String(rawKey).toLowerCase()] = String(rawValue);
+    }
+    return out;
+}
+function parseNumber(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function parseBoolean(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'true') {
+        return true;
+    }
+    if (normalized === 'false') {
+        return false;
+    }
+    return undefined;
+}
+function unquote(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+function parseStructuredItems(raw) {
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean)
+        .map((item) => {
+        const segments = item.split(';').map((segment) => segment.trim()).filter(Boolean);
+        const [head, ...rest] = segments;
+        const params = {};
+        for (const segment of rest) {
+            const eq = segment.indexOf('=');
+            if (eq <= 0) {
+                continue;
+            }
+            const key = segment.slice(0, eq).trim();
+            const value = unquote(segment.slice(eq + 1));
+            params[key] = value;
+        }
+        return { name: unquote(head), params };
+    });
+}
+export function extractMetaFromHeaders(headers) {
+    const rawHeaders = toHeaderMap(headers);
+    const rateLimitPolicies = {};
+    const rateLimits = {};
+    for (const item of parseStructuredItems(rawHeaders['ratelimit-policy'])) {
+        rateLimitPolicies[item.name] = {
+            name: item.name,
+            quota: parseNumber(item.params.q),
+            unit: item.params['uapi-unit'],
+            windowSeconds: parseNumber(item.params.w),
+        };
+    }
+    for (const item of parseStructuredItems(rawHeaders['ratelimit'])) {
+        rateLimits[item.name] = {
+            name: item.name,
+            remaining: parseNumber(item.params.r),
+            unit: item.params['uapi-unit'],
+            resetAfterSeconds: parseNumber(item.params.t),
+        };
+    }
+    return {
+        requestId: rawHeaders['x-request-id'],
+        retryAfterSeconds: parseNumber(rawHeaders['retry-after']),
+        debitStatus: rawHeaders['uapi-debit-status'],
+        creditsRequested: parseNumber(rawHeaders['uapi-credits-requested']),
+        creditsCharged: parseNumber(rawHeaders['uapi-credits-charged']),
+        creditsPricing: rawHeaders['uapi-credits-pricing'],
+        activeQuotaBuckets: parseNumber(rawHeaders['uapi-quota-active-buckets']),
+        stopOnEmpty: parseBoolean(rawHeaders['uapi-stop-on-empty']),
+        rateLimitPolicyRaw: rawHeaders['ratelimit-policy'],
+        rateLimitRaw: rawHeaders['ratelimit'],
+        rateLimitPolicies,
+        rateLimits,
+        balanceLimitCents: rateLimitPolicies['billing-balance']?.quota,
+        balanceRemainingCents: rateLimits['billing-balance']?.remaining,
+        quotaLimitCredits: rateLimitPolicies['billing-quota']?.quota,
+        quotaRemainingCredits: rateLimits['billing-quota']?.remaining,
+        visitorQuotaLimitCredits: rateLimitPolicies['visitor-quota']?.quota,
+        visitorQuotaRemainingCredits: rateLimits['visitor-quota']?.remaining,
+        rawHeaders,
+    };
+}
+function pickDetails(body) {
+    if (!body || typeof body !== 'object') {
+        return undefined;
+    }
+    const payload = body;
+    if (payload.details !== undefined) {
+        return payload.details;
+    }
+    if (payload.quota !== undefined) {
+        return payload.quota;
+    }
+    if (payload.docs !== undefined) {
+        return payload.docs;
+    }
+    return undefined;
+}
+export function mapError(res, body) {
+    const payload = body && typeof body === 'object' ? body : undefined;
+    const code = String(payload?.code || payload?.error || defaultCode(res.status)).toUpperCase();
+    const message = payload?.message ||
+        payload?.errMsg ||
+        (typeof body === 'string' ? body : '') ||
+        res.statusText ||
+        'Request failed';
+    const meta = extractMetaFromHeaders(res.headers);
+    const table = {
+        "API_ERROR": ApiErrorError,
+        "AVATAR_NOT_FOUND": AvatarNotFoundError,
+        "CONVERSION_FAILED": ConversionFailedError,
+        "FILE_OPEN_ERROR": FileOpenErrorError,
+        "FILE_REQUIRED": FileRequiredError,
+        "INSUFFICIENT_CREDITS": InsufficientCreditsError,
+        "INTERNAL_SERVER_ERROR": InternalServerErrorError,
+        "INVALID_PARAMETER": InvalidParameterError,
+        "INVALID_PARAMS": InvalidParamsError,
+        "NOT_FOUND": NotFoundError,
+        "NO_MATCH": NoMatchError,
+        "NO_TRACKING_DATA": NoTrackingDataError,
+        "PHONE_INFO_FAILED": PhoneInfoFailedError,
+        "RECOGNITION_FAILED": RecognitionFailedError,
+        "REQUEST_ENTITY_TOO_LARGE": RequestEntityTooLargeError,
+        "SERVICE_BUSY": ServiceBusyError,
+        "TIMEZONE_NOT_FOUND": TimezoneNotFoundError,
+        "UNAUTHORIZED": UnauthorizedError,
+        "UNSUPPORTED_CARRIER": UnsupportedCarrierError,
+        "UNSUPPORTED_FORMAT": UnsupportedFormatError,
+        "VISITOR_MONTHLY_QUOTA_EXHAUSTED": VisitorMonthlyQuotaExhaustedError,
+    };
+    const fallback = res.status === 401
+        ? UnauthorizedError
+        : res.status === 402
+            ? InsufficientCreditsError
+            : res.status === 404
+                ? NotFoundError
+                : res.status === 429
+                    ? ServiceBusyError
+                    : res.status >= 500
+                        ? InternalServerErrorError
+                        : UapiError;
+    const Ctor = table[code] || fallback;
+    return new Ctor(code, res.status, message, pickDetails(payload), payload ?? body, meta);
+}