@qzsy/pdd-core 0.1.0

package/dist/errors.js

@@ -0,0 +1,187 @@
+/**
+ * 调用方式的中文标签，写入 `message` 方便肉眼排查。
+ */
+const CALL_MODE_LABEL = {
+    merchant: "商家调用",
+    authorizer: "代调用",
+    app: "应用调用",
+};
+/**
+ * 把上下文拼进错误文案。
+ *
+ * @param fallback 没有上下文时的兜底文案
+ * @param ctx 排查字段
+ */
+export function formatPddErrorMessage(fallback, ctx) {
+    const who = ctx.callMode ? CALL_MODE_LABEL[ctx.callMode] : undefined;
+    const head = [who, ctx.clientId].filter(Boolean).join(" ");
+    const target = [ctx.method, ctx.type].filter(Boolean).join(" ");
+    const prefix = [head ? `[${head}]` : undefined, target].filter(Boolean).join(" ");
+    if (ctx.kind === "api") {
+        const detail = `${ctx.errorCode ?? ""} ${ctx.errorMsg ?? ""}`.trim();
+        const sub = [ctx.subCode, ctx.subMsg].filter((item) => item !== undefined && item !== "").join(" ");
+        const text = sub ? `${detail} (${sub})` : detail;
+        return prefix ? `${prefix} → ${text}` : fallback;
+    }
+    if (ctx.kind === "http") {
+        const status = ctx.status === undefined ? fallback : `HTTP ${ctx.status}`;
+        const detail = ctx.bodyText ? `${status}: ${ctx.bodyText}` : status;
+        return prefix ? `${prefix} → ${detail}` : fallback;
+    }
+    return prefix ? `${prefix} → ${fallback}` : fallback;
+}
+/**
+ * SDK 错误基类。HTTP / 业务 / 配置错误都挂在这棵树上，可用 `instanceof PddError` 统一捕获。
+ */
+export class PddError extends Error {
+    name = "PddError";
+    /**
+     * 错误分类。
+     */
+    kind;
+    /**
+     * 官方接口名。
+     */
+    type;
+    /**
+     * HTTP 方法。
+     */
+    method;
+    /**
+     * 发起方式。
+     */
+    callMode;
+    /**
+     * 应用 `client_id`。
+     */
+    clientId;
+    /**
+     * 本次请求的鉴权方式。
+     */
+    auth;
+    /**
+     * 拼多多主错误码。
+     */
+    errorCode;
+    /**
+     * 拼多多主错误信息。
+     */
+    errorMsg;
+    /**
+     * 子错误码。
+     */
+    subCode;
+    /**
+     * 子错误信息。
+     */
+    subMsg;
+    /**
+     * 平台返回的请求追踪 ID。
+     */
+    requestId;
+    /**
+     * HTTP 状态码。
+     */
+    status;
+    /**
+     * 响应正文截断预览。
+     */
+    bodyText;
+    /**
+     * @param message 错误说明
+     * @param init 排查上下文字段
+     */
+    constructor(message, init = {}) {
+        const kind = init.kind ?? "config";
+        const ctx = {
+            kind,
+            type: init.type,
+            method: init.method,
+            callMode: init.callMode,
+            clientId: init.clientId,
+            auth: init.auth,
+            errorCode: init.errorCode,
+            errorMsg: init.errorMsg,
+            subCode: init.subCode,
+            subMsg: init.subMsg,
+            requestId: init.requestId,
+            status: init.status,
+            bodyText: init.bodyText,
+        };
+        super(formatPddErrorMessage(message, ctx), { cause: init.cause });
+        this.kind = kind;
+        this.type = init.type;
+        this.method = init.method;
+        this.callMode = init.callMode;
+        this.clientId = init.clientId;
+        this.auth = init.auth;
+        this.errorCode = init.errorCode;
+        this.errorMsg = init.errorMsg;
+        this.subCode = init.subCode;
+        this.subMsg = init.subMsg;
+        this.requestId = init.requestId;
+        this.status = init.status;
+        this.bodyText = init.bodyText;
+    }
+    /**
+     * 序列化为结构化字段，便于打日志。
+     *
+     * @returns 名称、文案与排查上下文
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            kind: this.kind,
+            type: this.type,
+            method: this.method,
+            callMode: this.callMode,
+            clientId: this.clientId,
+            auth: this.auth,
+            errorCode: this.errorCode,
+            errorMsg: this.errorMsg,
+            subCode: this.subCode,
+            subMsg: this.subMsg,
+            requestId: this.requestId,
+            status: this.status,
+            bodyText: this.bodyText,
+        };
+    }
+}
+/**
+ * HTTP 层失败：网络错误、非 2xx、或响应不是 JSON。
+ */
+export class PddHttpError extends PddError {
+    name = "PddHttpError";
+    /**
+     * @param message 错误说明
+     * @param init.status HTTP 状态码
+     * @param init.type 官方接口名
+     * @param init.bodyText 响应正文截断
+     * @param init.cause 原始异常
+     */
+    constructor(message, init) {
+        super(message, { ...init, kind: "http" });
+    }
+}
+/**
+ * 拼多多业务错误：HTTP 成功但存在 `error_response`。
+ */
+export class PddApiError extends PddError {
+    name = "PddApiError";
+    /**
+     * @param init.errorCode 主错误码
+     * @param init.errorMsg 主错误信息
+     * @param init.type 官方接口名
+     */
+    constructor(init) {
+        super(`Pinduoduo API error ${init.errorCode}: ${init.errorMsg}`, { ...init, kind: "api" });
+    }
+}
+/**
+ * 视为令牌失效、需要刷新后重试一次的错误码。
+ *
+ * - `10019`：access_token 已过期
+ */
+export const STALE_ACCESS_TOKEN_CODES = new Set([10019]);
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { PddApiError, PddError, PddHttpError, formatPddErrorMessage, STALE_ACCESS_TOKEN_CODES, } from "./errors.ts";
+export type { PddErrorContext, PddErrorInit, PddErrorKind } from "./errors.ts";
+export { PddHttpClient } from "./client.ts";
+export { MemoryTokenStore, accessTokenKey, authorizerAccessTokenKey, } from "./token.ts";
+export { AuthorizerAccessTokenStrategy, MerchantAccessTokenStrategy, } from "./token-strategy.ts";
+export type { PddAccessTokenStrategy } from "./token-strategy.ts";
+export { isPddFile, pddResponseKey, signPddParams, stringifyPddParams, stringifyPddValue, } from "./sign.ts";
+export type { AuthMode, HttpMethod, PddAccessTokenResponse, PddAppCredentials, PddAuthorizerCaller, PddCallMode, PddCallerKind, PddClientCaller, PddClientOptions, PddErrorBody, PddErrorResponse, PddMerchantCaller, PddOAuthTokenRequest, PddRequestOptions, QueryRecord, QueryValue, TokenKind, TokenStore, } from "./types.ts";
+export { isAuthorizerCaller } from "./types.ts";
+export { DEFAULT_ACCESS_TOKEN_EXPIRES_IN, DEFAULT_PDD_BASE_URL, DEFAULT_PDD_TOKEN_URL, DEFAULT_TIMEOUT_MS, TOKEN_EXPIRY_SKEW_MS, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { PddApiError, PddError, PddHttpError, formatPddErrorMessage, STALE_ACCESS_TOKEN_CODES, } from "./errors.js";
+export { PddHttpClient } from "./client.js";
+export { MemoryTokenStore, accessTokenKey, authorizerAccessTokenKey, } from "./token.js";
+export { AuthorizerAccessTokenStrategy, MerchantAccessTokenStrategy, } from "./token-strategy.js";
+export { isPddFile, pddResponseKey, signPddParams, stringifyPddParams, stringifyPddValue, } from "./sign.js";
+export { isAuthorizerCaller } from "./types.js";
+export { DEFAULT_ACCESS_TOKEN_EXPIRES_IN, DEFAULT_PDD_BASE_URL, DEFAULT_PDD_TOKEN_URL, DEFAULT_TIMEOUT_MS, TOKEN_EXPIRY_SKEW_MS, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAqBnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/sign.d.ts

@@ -0,0 +1,46 @@
+import type { QueryValue } from "./types.ts";
+/**
+ * 把业务参数收成可签名的字符串表。
+ *
+ * 跳过 `undefined` / `null` / 空字符串。数组和对象序列化为 JSON。
+ *
+ * @param params 业务参数
+ * @returns 仅含字符串值的参数表
+ */
+/**
+ * 官方 `FILE` 参数：二进制不参与 MD5 签名，走 multipart。
+ *
+ * @param value 请求参数值
+ * @returns 是否为浏览器 / Node 18+ 的 `Blob`
+ */
+export declare function isPddFile(value: unknown): value is Blob;
+export declare function stringifyPddParams(params: object): Record<string, string>;
+/**
+ * 单个参数值转字符串。
+ *
+ * @param value 原始值
+ * @returns 可签名字符串；应跳过时返回 `undefined`
+ */
+export declare function stringifyPddValue(value: QueryValue): string | undefined;
+/**
+ * 按官方规则生成大写 MD5 签名。
+ *
+ * 1. 去掉 `sign`，并跳过空字符串
+ * 2. 参数名按字典序排列
+ * 3. 拼接 `clientSecret + 参数名 + 参数值 + clientSecret`
+ * 4. MD5 后转大写
+ *
+ * @param params 已收成字符串的全部请求参数（含公共参数，不含 `sign`）
+ * @param clientSecret 应用密钥
+ * @returns 大写 MD5 签名
+ */
+export declare function signPddParams(params: Record<string, string>, clientSecret: string): string;
+/**
+ * 由官方接口名推导成功响应信封字段。
+ *
+ * `pdd.mall.info.get` → `mall_info_get_response`。
+ *
+ * @param type 官方接口名
+ */
+export declare function pddResponseKey(type: string): string;
+//# sourceMappingURL=sign.d.ts.map

package/dist/sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAazE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAU1F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/sign.js

@@ -0,0 +1,81 @@
+import { createHash } from "node:crypto";
+/**
+ * 把业务参数收成可签名的字符串表。
+ *
+ * 跳过 `undefined` / `null` / 空字符串。数组和对象序列化为 JSON。
+ *
+ * @param params 业务参数
+ * @returns 仅含字符串值的参数表
+ */
+/**
+ * 官方 `FILE` 参数：二进制不参与 MD5 签名，走 multipart。
+ *
+ * @param value 请求参数值
+ * @returns 是否为浏览器 / Node 18+ 的 `Blob`
+ */
+export function isPddFile(value) {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+}
+export function stringifyPddParams(params) {
+    const out = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (isPddFile(value)) {
+            continue;
+        }
+        const text = stringifyPddValue(value);
+        if (text === undefined) {
+            continue;
+        }
+        out[key] = text;
+    }
+    return out;
+}
+/**
+ * 单个参数值转字符串。
+ *
+ * @param value 原始值
+ * @returns 可签名字符串；应跳过时返回 `undefined`
+ */
+export function stringifyPddValue(value) {
+    if (value === undefined || value === null || value === "") {
+        return undefined;
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * 按官方规则生成大写 MD5 签名。
+ *
+ * 1. 去掉 `sign`，并跳过空字符串
+ * 2. 参数名按字典序排列
+ * 3. 拼接 `clientSecret + 参数名 + 参数值 + clientSecret`
+ * 4. MD5 后转大写
+ *
+ * @param params 已收成字符串的全部请求参数（含公共参数，不含 `sign`）
+ * @param clientSecret 应用密钥
+ * @returns 大写 MD5 签名
+ */
+export function signPddParams(params, clientSecret) {
+    const keys = Object.keys(params)
+        .filter((key) => key !== "sign" && params[key] !== "")
+        .sort();
+    let raw = clientSecret;
+    for (const key of keys) {
+        raw += key + (params[key] ?? "");
+    }
+    raw += clientSecret;
+    return createHash("md5").update(raw, "utf8").digest("hex").toUpperCase();
+}
+/**
+ * 由官方接口名推导成功响应信封字段。
+ *
+ * `pdd.mall.info.get` → `mall_info_get_response`。
+ *
+ * @param type 官方接口名
+ */
+export function pddResponseKey(type) {
+    return `${type.replace(/^pdd\./, "").replaceAll(".", "_")}_response`;
+}
+//# sourceMappingURL=sign.js.map

package/dist/sign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.js","sourceRoot":"","sources":["../src/sign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;GAOG;AACH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAmB,CAAC,CAAC;QACpD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,MAA8B,EAAE,YAAoB;IAChF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;SACrD,IAAI,EAAE,CAAC;IACV,IAAI,GAAG,GAAG,YAAY,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,IAAI,YAAY,CAAC;IACpB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC;AACvE,CAAC"}

package/dist/token-strategy.d.ts

@@ -0,0 +1,89 @@
+import type { PddAccessTokenResponse, PddCallMode, TokenStore } from "./types.ts";
+/**
+ * 业务接口的 `access_token` 获取策略。
+ *
+ * 商家自己持有令牌与调用方注入令牌的请求形态完全相同，只是令牌从哪来不同。
+ */
+export interface PddAccessTokenStrategy {
+    /**
+     * 发起方式。
+     */
+    readonly callMode: PddCallMode;
+    /**
+     * 读取或刷新 `access_token`。写入请求时字段名仍是 `access_token`。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存并重新申请
+     */
+    getAccessToken(forceRefresh?: boolean): Promise<string>;
+    /**
+     * 丢掉本地缓存。令牌失效重试前调用。
+     */
+    invalidate(): Promise<void>;
+}
+/**
+ * 商家自己调用：使用已有 `accessToken`，可选地用 `refreshToken` 走 OAuth 刷新。
+ */
+export declare class MerchantAccessTokenStrategy implements PddAccessTokenStrategy {
+    #private;
+    readonly callMode: "merchant";
+    /**
+     * @param options.clientId 应用 `client_id`
+     * @param options.ownerId 授权主体
+     * @param options.tokenStore 令牌缓存
+     * @param options.accessToken 当前令牌
+     * @param options.refreshToken 刷新令牌
+     * @param options.expiresIn 当前令牌有效秒数
+     * @param options.refresh 用 `refresh_token` 换新票
+     */
+    constructor(options: {
+        clientId: string;
+        ownerId?: string;
+        tokenStore: TokenStore;
+        accessToken?: string;
+        refreshToken?: string;
+        expiresIn?: number;
+        refresh: (refreshToken: string) => Promise<PddAccessTokenResponse>;
+    });
+    /**
+     * 读取或刷新商家 `access_token`。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存
+     */
+    getAccessToken(forceRefresh?: boolean): Promise<string>;
+    /**
+     * 丢掉商家 `access_token` 缓存。
+     */
+    invalidate(): Promise<void>;
+}
+/**
+ * 调用方注入令牌：由外部提供 `access_token`。
+ *
+ * 写入请求时字段名仍是 `access_token`，与商家自己调用相同。
+ */
+export declare class AuthorizerAccessTokenStrategy implements PddAccessTokenStrategy {
+    #private;
+    readonly callMode: "authorizer";
+    /**
+     * @param options.clientId 应用 `client_id`
+     * @param options.ownerId 授权主体
+     * @param options.tokenStore 令牌缓存
+     * @param options.getAccessToken 读取授权令牌；失效重试时传入 `forceRefresh = true`
+     */
+    constructor(options: {
+        clientId: string;
+        ownerId?: string;
+        tokenStore: TokenStore;
+        getAccessToken: (forceRefresh?: boolean) => Promise<string>;
+    });
+    /**
+     * 读取授权店铺令牌。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存并要求调用方换新
+     */
+    getAccessToken(forceRefresh?: boolean): Promise<string>;
+    /**
+     * 丢掉授权令牌缓存。
+     */
+    invalidate(): Promise<void>;
+}
+//# sourceMappingURL=token-strategy.d.ts.map

package/dist/token-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-strategy.d.ts","sourceRoot":"","sources":["../src/token-strategy.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B;;;;OAIG;IACH,cAAc,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AA6DD;;GAEG;AACH,qBAAa,2BAA4B,YAAW,sBAAsB;;IACxE,QAAQ,CAAC,QAAQ,EAAG,UAAU,CAAU;IASxC;;;;;;;;OAQG;IACH,YAAY,OAAO,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,UAAU,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;KACpE,EAUA;IAED;;;;OAIG;IACH,cAAc,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BpD;IAED;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF;AAED;;;;GAIG;AACH,qBAAa,6BAA8B,YAAW,sBAAsB;;IAC1E,QAAQ,CAAC,QAAQ,EAAG,YAAY,CAAU;IAK1C;;;;;OAKG;IACH,YAAY,OAAO,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,UAAU,CAAC;QACvB,cAAc,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KAC7D,EAMA;IAED;;;;OAIG;IACH,cAAc,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpD;IAED;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF"}

package/dist/token-strategy.js

@@ -0,0 +1,159 @@
+import { PddError } from "./errors.js";
+import { accessTokenKey, authorizerAccessTokenKey } from "./token.js";
+import { DEFAULT_ACCESS_TOKEN_EXPIRES_IN, TOKEN_EXPIRY_SKEW_MS, } from "./types.js";
+/**
+ * 令牌获取过程中的共享缓存与单飞。
+ */
+class CachedTokenStrategy {
+    #store;
+    #key;
+    #inflight;
+    /**
+     * @param store 令牌存储
+     * @param key 存储键
+     */
+    constructor(store, key) {
+        this.#store = store;
+        this.#key = key;
+    }
+    /**
+     * 读缓存或执行换票，并发调用合并为一次。
+     *
+     * @param forceRefresh 是否强制换票
+     * @param fetchToken 实际换票
+     */
+    async getCached(forceRefresh, fetchToken) {
+        if (!forceRefresh) {
+            const cached = await this.#store.get(this.#key);
+            if (cached) {
+                return cached;
+            }
+        }
+        if (!this.#inflight) {
+            this.#inflight = fetchToken().finally(() => {
+                this.#inflight = undefined;
+            });
+        }
+        return this.#inflight;
+    }
+    /**
+     * 写入缓存。
+     *
+     * @param token 令牌
+     * @param expiresIn 有效秒数
+     */
+    async save(token, expiresIn) {
+        const ttlMs = Math.max(expiresIn * 1000 - TOKEN_EXPIRY_SKEW_MS, 1_000);
+        await this.#store.set(this.#key, token, ttlMs);
+    }
+    /**
+     * 删除缓存。
+     */
+    invalidate() {
+        return this.#store.delete(this.#key);
+    }
+}
+/**
+ * 商家自己调用：使用已有 `accessToken`，可选地用 `refreshToken` 走 OAuth 刷新。
+ */
+export class MerchantAccessTokenStrategy {
+    callMode = "merchant";
+    #cache;
+    #clientId;
+    #initialToken;
+    #initialExpiresIn;
+    #refreshToken;
+    #refresh;
+    /**
+     * @param options.clientId 应用 `client_id`
+     * @param options.ownerId 授权主体
+     * @param options.tokenStore 令牌缓存
+     * @param options.accessToken 当前令牌
+     * @param options.refreshToken 刷新令牌
+     * @param options.expiresIn 当前令牌有效秒数
+     * @param options.refresh 用 `refresh_token` 换新票
+     */
+    constructor(options) {
+        this.#cache = new CachedTokenStrategy(options.tokenStore, accessTokenKey(options.clientId, options.ownerId));
+        this.#clientId = options.clientId;
+        this.#initialToken = options.accessToken;
+        this.#initialExpiresIn = options.expiresIn ?? DEFAULT_ACCESS_TOKEN_EXPIRES_IN;
+        this.#refreshToken = options.refreshToken;
+        this.#refresh = options.refresh;
+    }
+    /**
+     * 读取或刷新商家 `access_token`。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存
+     */
+    getAccessToken(forceRefresh = false) {
+        return this.#cache.getCached(forceRefresh, async () => {
+            if (!forceRefresh && this.#initialToken) {
+                const token = this.#initialToken;
+                this.#initialToken = undefined;
+                await this.#cache.save(token, this.#initialExpiresIn);
+                return token;
+            }
+            if (!this.#refreshToken) {
+                if (this.#initialToken && !forceRefresh) {
+                    return this.#initialToken;
+                }
+                throw new PddError("缺少 access_token。商家接口需要先完成 OAuth 授权，或传入 refreshToken 以便过期后刷新。", {
+                    kind: "config",
+                    callMode: "merchant",
+                    clientId: this.#clientId,
+                    auth: "access_token",
+                });
+            }
+            const data = await this.#refresh(this.#refreshToken);
+            this.#refreshToken = data.refresh_token;
+            await this.#cache.save(data.access_token, data.expires_in);
+            return data.access_token;
+        });
+    }
+    /**
+     * 丢掉商家 `access_token` 缓存。
+     */
+    invalidate() {
+        return this.#cache.invalidate();
+    }
+}
+/**
+ * 调用方注入令牌：由外部提供 `access_token`。
+ *
+ * 写入请求时字段名仍是 `access_token`，与商家自己调用相同。
+ */
+export class AuthorizerAccessTokenStrategy {
+    callMode = "authorizer";
+    #cache;
+    #getAccessToken;
+    /**
+     * @param options.clientId 应用 `client_id`
+     * @param options.ownerId 授权主体
+     * @param options.tokenStore 令牌缓存
+     * @param options.getAccessToken 读取授权令牌；失效重试时传入 `forceRefresh = true`
+     */
+    constructor(options) {
+        this.#cache = new CachedTokenStrategy(options.tokenStore, authorizerAccessTokenKey(options.clientId, options.ownerId));
+        this.#getAccessToken = options.getAccessToken;
+    }
+    /**
+     * 读取授权店铺令牌。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存并要求调用方换新
+     */
+    getAccessToken(forceRefresh = false) {
+        return this.#cache.getCached(forceRefresh, async () => {
+            const token = await this.#getAccessToken(forceRefresh);
+            await this.#cache.save(token, DEFAULT_ACCESS_TOKEN_EXPIRES_IN);
+            return token;
+        });
+    }
+    /**
+     * 丢掉授权令牌缓存。
+     */
+    invalidate() {
+        return this.#cache.invalidate();
+    }
+}
+//# sourceMappingURL=token-strategy.js.map

package/dist/token-strategy.js.map

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

package/dist/token.d.ts

@@ -0,0 +1,45 @@
+import type { TokenStore } from "./types.ts";
+/**
+ * 进程内令牌缓存。
+ *
+ * 仅适合单进程开发与测试。生产环境请换成 Redis 等跨进程实现。
+ */
+export declare class MemoryTokenStore implements TokenStore {
+    #private;
+    /**
+     * 读取未过期的值。
+     *
+     * @param key 存储键
+     * @returns 缓存值；不存在或已过期时返回 `undefined`
+     */
+    get(key: string): Promise<string | undefined>;
+    /**
+     * 写入值。
+     *
+     * @param key 存储键
+     * @param token 令牌
+     * @param ttlMs 存活毫秒数
+     */
+    set(key: string, token: string, ttlMs: number): Promise<void>;
+    /**
+     * 删除指定键。
+     *
+     * @param key 存储键
+     */
+    delete(key: string): Promise<void>;
+}
+/**
+ * 店铺 `access_token` 的存储键。
+ *
+ * @param clientId 应用 `client_id`
+ * @param ownerId 授权主体，未传时使用 `default`
+ */
+export declare function accessTokenKey(clientId: string, ownerId?: string): string;
+/**
+ * 调用方注入令牌时的存储键。
+ *
+ * @param clientId 应用 `client_id`
+ * @param ownerId 授权主体，未传时使用 `default`
+ */
+export declare function authorizerAccessTokenKey(clientId: string, ownerId?: string): string;
+//# sourceMappingURL=token.d.ts.map

package/dist/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiB7C;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,UAAU;;IAGjD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAUlD;IAED;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;IAED;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvC;CACF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,CAEtF"}