@qjp88995/provider-client 0.2.0 → 0.4.0

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

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

package/dist/justone/client.js

@@ -0,0 +1,272 @@
+import { parseCenterError, ProviderClientError } from '../errors.js';
+import { PC_HEADERS } from '../types.js';
+import { JUSTONE_ENDPOINTS } from './endpoints.generated.js';
+import { classifyCode, JustOneParamsError, JustOneUpstreamError, } from './errors.js';
+import { normalizeParams } from './params.js';
+import { justOnePriceFen } from './pricing.js';
+export const JUSTONE_BASE_URL = 'https://api.justoneapi.com';
+/** 官方建议 120 秒：服务端是现场去平台采集的，60 秒以下会有一部分请求等不到结果。 */
+export const JUSTONE_TIMEOUT_MS = 120_000;
+/** 两次尝试之间的间隔。 */
+const RETRY_DELAY_MS = 1_000;
+/** 绑好连接的 JustOne 客户端。中心模式用 `ProviderClient.justOne`；这里是直连与中心模式共用的底层。 */
+export function createJustOne(options) {
+    const conn = options.connection;
+    const base = (conn.baseUrl ?? JUSTONE_BASE_URL).replace(/\/+$/, '');
+    const doFetch = conn.fetch ?? globalThis.fetch;
+    const record = async (r) => {
+        if (!options.onAttempt)
+            return;
+        try {
+            await options.onAttempt(r);
+        }
+        catch (err) {
+            console.error(`[provider-client] JustOne onAttempt threw (${r.endpoint}, attempt ${r.attempt}): ${String(err)}`);
+        }
+    };
+    const attempt = async (spec, values, opts) => {
+        const fields = new URLSearchParams(conn.token ? { ...values, token: conn.token } : values);
+        const query = fields.toString();
+        const url = spec.paramsIn === 'query' && query
+            ? `${base}${spec.path}?${query}`
+            : `${base}${spec.path}`;
+        const timeout = AbortSignal.timeout(opts.timeoutMs ?? JUSTONE_TIMEOUT_MS);
+        const signal = opts.signal
+            ? AbortSignal.any([opts.signal, timeout])
+            : timeout;
+        const started = Date.now();
+        let res;
+        let text;
+        try {
+            res = await doFetch(url, {
+                method: spec.method,
+                headers: { accept: 'application/json' },
+                ...(spec.paramsIn === 'form' ? { body: fields } : {}),
+                signal,
+            });
+            text = await res.text();
+        }
+        catch (err) {
+            const failure = {
+                code: null,
+                httpStatus: null,
+                requestId: null,
+                credential: null,
+                elapsedMs: Date.now() - started,
+            };
+            // 请求可能已经到了对方那里（可能扣了费），所以取消也要记一行；由调用循环记完再抛。
+            if (opts.signal?.aborted) {
+                return {
+                    ok: false,
+                    kind: 'aborted',
+                    reason: '调用方取消了这次请求',
+                    retryable: false,
+                    ...failure,
+                };
+            }
+            if (timeout.aborted) {
+                return {
+                    ok: false,
+                    kind: 'timeout',
+                    reason: `等了 ${Math.round((Date.now() - started) / 1000)} 秒没有返回`,
+                    retryable: false,
+                    ...failure,
+                };
+            }
+            // 只取错误类名与 cause 的 code（`UND_ERR_SOCKET` 之类）：直连时 GET 的 token 就在 URL 里。
+            return {
+                ok: false,
+                kind: 'network',
+                reason: `连接失败（${describeNetworkError(err)}）`,
+                retryable: true,
+                ...failure,
+            };
+        }
+        const elapsedMs = Date.now() - started;
+        const credential = res.headers.get(PC_HEADERS.credential);
+        const httpStatus = res.status;
+        // 中心自己的错误体（`{ code: '<字符串>', message }`，没有 `x-pc-credential`）：请求没到 JustOne。
+        if (!res.ok && !credential) {
+            const center = centerError(text);
+            if (center?.code === 'upstream_error') {
+                return {
+                    ok: false,
+                    kind: 'network',
+                    reason: `中心连不上 JustOne（${center.message}）`,
+                    code: null,
+                    httpStatus,
+                    requestId: null,
+                    retryable: true,
+                    elapsedMs,
+                    credential: null,
+                };
+            }
+            if (center) {
+                throw new ProviderClientError(center.code, center.message, httpStatus);
+            }
+        }
+        // 对方的报错里万一回显了 token：先抹掉再往下走，于是记录里的返回体、错误信息都从这份抹过的文本来。
+        const response = conn.token ? text.split(conn.token).join('***') : text;
+        let body;
+        try {
+            body = JSON.parse(response);
+        }
+        catch {
+            return invalidResponse(httpStatus, `不是 JSON：${response.slice(0, 120)}`, elapsedMs, response, credential);
+        }
+        if (!isEnvelope(body)) {
+            return invalidResponse(httpStatus, 'JSON 里没有数字型的 code', elapsedMs, response, credential);
+        }
+        const requestId = typeof body.requestId === 'string' ? body.requestId : null;
+        const message = typeof body.message === 'string' ? body.message : null;
+        if (body.code !== 0) {
+            return {
+                ok: false,
+                ...classifyCode(body.code, message),
+                code: body.code,
+                httpStatus,
+                requestId,
+                elapsedMs,
+                response,
+                credential,
+            };
+        }
+        return {
+            ok: true,
+            response,
+            credential,
+            result: {
+                data: body.data ?? null,
+                message,
+                requestId,
+                recordTime: typeof body.recordTime === 'string' ? body.recordTime : null,
+                elapsedMs,
+                httpStatus,
+            },
+        };
+    };
+    const callDynamic = async (endpoint, params, opts = {}) => {
+        const spec = justOneEndpointSpec(endpoint);
+        if (!spec) {
+            throw new JustOneParamsError(endpoint, ['登记表里没有这个接口']);
+        }
+        const normalized = normalizeParams(spec, params);
+        if (!normalized.ok) {
+            throw new JustOneParamsError(endpoint, normalized.problems);
+        }
+        const retries = Math.max(0, opts.retries ?? 1);
+        const unitPriceFen = justOnePriceFen(endpoint);
+        for (let n = 1;; n++) {
+            opts.signal?.throwIfAborted();
+            const out = await attempt(spec, normalized.values, opts);
+            await record({
+                endpoint,
+                params: normalized.values,
+                attempt: n,
+                response: out.response,
+                credential: out.credential,
+                unitPriceFen,
+                context: opts.context,
+                ...(out.ok
+                    ? {
+                        ok: true,
+                        code: 0,
+                        httpStatus: out.result.httpStatus,
+                        requestId: out.result.requestId,
+                        elapsedMs: out.result.elapsedMs,
+                    }
+                    : {
+                        ok: false,
+                        failureKind: out.kind,
+                        code: out.code,
+                        httpStatus: out.httpStatus,
+                        requestId: out.requestId,
+                        error: out.reason,
+                        elapsedMs: out.elapsedMs,
+                    }),
+            });
+            if (out.ok) {
+                const { httpStatus: _http, ...result } = out.result;
+                return { endpoint, ...result, attempts: n };
+            }
+            if (out.kind === 'aborted') {
+                // 只有调用方的信号已中止时 attempt 才给 aborted：原样抛出取消原因。
+                opts.signal?.throwIfAborted();
+                throw new Error('JustOne attempt reported aborted without a signal');
+            }
+            if (!out.retryable || n > retries) {
+                throw new JustOneUpstreamError(endpoint, out.kind, out.reason, {
+                    code: out.code,
+                    httpStatus: out.httpStatus,
+                    requestId: out.requestId,
+                    retryable: out.retryable,
+                    attempts: n,
+                });
+            }
+            await sleep(RETRY_DELAY_MS, opts.signal);
+        }
+    };
+    return {
+        call: (endpoint, params, opts) => callDynamic(endpoint, params, opts),
+        callDynamic,
+    };
+}
+/** 按键查登记表；不在表里返回 undefined（`hasOwn` 不走原型链上的同名属性）。 */
+export function justOneEndpointSpec(key) {
+    return Object.hasOwn(JUSTONE_ENDPOINTS, key)
+        ? JUSTONE_ENDPOINTS[key]
+        : undefined;
+}
+function centerError(text) {
+    try {
+        return parseCenterError(JSON.parse(text));
+    }
+    catch {
+        return null;
+    }
+}
+function isEnvelope(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        typeof v.code === 'number');
+}
+function invalidResponse(httpStatus, what, elapsedMs, response, credential) {
+    return {
+        ok: false,
+        kind: 'invalid-response',
+        reason: `HTTP ${httpStatus}，响应${what}`,
+        code: null,
+        httpStatus,
+        requestId: null,
+        // 网关层的 5xx（还没到 JustOne 的业务层）值得再试一次。
+        retryable: httpStatus >= 500,
+        elapsedMs,
+        response,
+        credential,
+    };
+}
+function describeNetworkError(err) {
+    if (!(err instanceof Error))
+        return 'unknown';
+    const cause = err.cause;
+    return typeof cause?.code === 'string'
+        ? `${err.name} ${cause.code}`
+        : err.name;
+}
+/** 可被调用方取消的等待：取消时原样抛出信号的 reason。 */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(signal.reason);
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/justone/client.js.map

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

package/dist/justone/endpoint-spec.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 登记表里一个接口的形状（`justone-endpoints.generated.ts` 由脚本从官方 OpenAPI
+ * 生成，见 `packages/client/scripts/generate-justone-endpoints.mjs`）。
+ *
+ * 文字（`title` / `description` / `notes` / 参数说明）都是官方中文文档的原文，
+ * 将来给模型看的工具说明可以直接取用，不必再抄一遍。
+ */
+export interface JustOneEndpointSpec {
+    method: 'GET' | 'POST';
+    path: string;
+    /**
+     * 参数与 token 放哪：`query` 或 `form`（`application/x-www-form-urlencoded`
+     * 请求体）。不能按方法推断——官方有几个 POST 接口没有请求体、参数全在 query。
+     */
+    paramsIn: 'query' | 'form';
+    /** 官方分类（中文 tag），如「小红书」「抖音巨量星图」。 */
+    platform: string;
+    /** 如「笔记详情 (V1)」。 */
+    title: string;
+    description: string;
+    docsUrl: string;
+    deprecated?: boolean;
+    /** 官方在同一能力的多个版本里推荐的那个。 */
+    recommended?: boolean;
+    /** 官方标注的限制与用法提示（「此版本不支持视频下载」……）。 */
+    notes?: readonly string[];
+    /** 不含 `token`——它由客户端统一放。 */
+    params: Readonly<Record<string, JustOneParamSpec>>;
+}
+export interface JustOneParamSpec {
+    type: 'string' | 'integer' | 'number' | 'boolean';
+    required: boolean;
+    enum?: readonly string[];
+    default?: string | number | boolean;
+    description?: string;
+}
+/** 单个参数的 TS 值类型：有枚举就收窄成字面量。 */
+type ParamValue<P extends JustOneParamSpec> = P['enum'] extends readonly (infer E)[] ? E : P['type'] extends 'integer' | 'number' ? number : P['type'] extends 'boolean' ? boolean : string;
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** 一个接口的入参类型：必填的必填、可选的可选，名字与取值都按登记表收窄。 */
+export type JustOneParamsOf<S extends JustOneEndpointSpec> = Simplify<{
+    -readonly [K in keyof S['params'] as S['params'][K]['required'] extends true ? K : never]: ParamValue<S['params'][K]>;
+} & {
+    -readonly [K in keyof S['params'] as S['params'][K]['required'] extends true ? never : K]?: ParamValue<S['params'][K]>;
+}>;
+export {};
+//# sourceMappingURL=endpoint-spec.d.ts.map

package/dist/justone/endpoint-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-spec.d.ts","sourceRoot":"","sources":["../../src/justone/endpoint-spec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+BAA+B;AAC/B,KAAK,UAAU,CAAC,CAAC,SAAS,gBAAgB,IACxC,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAClC,CAAC,GACD,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,QAAQ,GACpC,MAAM,GACN,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GACzB,OAAO,GACP,MAAM,CAAC;AAEjB,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,mBAAmB,IAAI,QAAQ,CACnE;IACE,CAAC,UACC,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC7D,CAAC,GACD,KAAK,GACR,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9B,GAAG;IACF,CAAC,UACC,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC7D,KAAK,GACL,CAAC,CACN,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/B,CACF,CAAC"}

package/dist/justone/endpoint-spec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=endpoint-spec.js.map

package/dist/justone/endpoint-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-spec.js","sourceRoot":"","sources":["../../src/justone/endpoint-spec.ts"],"names":[],"mappings":""}