@qzsy/pdd-platform-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qzsy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/apis/auth.d.ts

@@ -0,0 +1,49 @@
+import type { PddHttpClient } from "@qzsy/pdd-core";
+import type { PlatformAccessTokenResult, PlatformAuthorizeUrlQuery, PlatformCreatePopAuthTokenQuery, PlatformCreateTokenQuery, PlatformPopAuthTokenResult, PlatformRefreshTokenQuery } from "../types/auth.ts";
+/**
+ * 开放平台授权：拼授权地址、用 code 换票、刷新令牌，以及网关换票。
+ */
+export declare class PlatformAuthApi {
+    #private;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http: PddHttpClient);
+    /**
+     * 拼装商家或多多客的 OAuth 授权地址。
+     *
+     * 对应官方入口：`https://mms.pinduoduo.com/open.html`（以及 H5 / 多多进宝授权页）
+     *
+     * @param query 回调地址与可选的授权页类型、state
+     * @returns 完整授权 URL
+     */
+    buildAuthorizeUrl(query: PlatformAuthorizeUrlQuery): string;
+    /**
+     * 用授权回调中的 `code` 换取 `access_token`。
+     *
+     * 对应官方接口：`POST https://open-api.pinduoduo.com/oauth/token`
+     *
+     * @param query 授权码
+     * @returns 令牌与授权主体信息
+     */
+    createToken(query: PlatformCreateTokenQuery): Promise<PlatformAccessTokenResult>;
+    /**
+     * 用 `refresh_token` 刷新 `access_token`。
+     *
+     * 对应官方接口：`POST https://open-api.pinduoduo.com/oauth/token`
+     *
+     * @param query 刷新令牌
+     * @returns 新的令牌与授权主体信息
+     */
+    refreshToken(query: PlatformRefreshTokenQuery): Promise<PlatformAccessTokenResult>;
+    /**
+     * 用授权码通过开放平台网关换取 `access_token`。
+     *
+     * 对应官方接口：`pdd.pop.auth.token.create`
+     *
+     * @param query 授权码
+     * @returns 令牌与授权主体信息
+     */
+    createPopAuthToken(query: PlatformCreatePopAuthTokenQuery): Promise<PlatformPopAuthTokenResult>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/apis/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/apis/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EAEzB,+BAA+B,EAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,kBAAkB,CAAC;AAW1B;;GAEG;AACH,qBAAa,eAAe;;IAG1B;;OAEG;IACH,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAS1D;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAK/E;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAKjF;IAED;;;;;;;OAOG;IACH,kBAAkB,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAM9F;CACF"}

package/dist/apis/auth.js

@@ -0,0 +1,78 @@
+/**
+ * 各授权页的正式环境入口。
+ */
+const AUTHORIZE_URLS = {
+    web: "https://mms.pinduoduo.com/open.html",
+    h5: "https://mai.pinduoduo.com/h5-login.html",
+    ddk: "https://jinbao.pinduoduo.com/open.html",
+};
+/**
+ * 开放平台授权：拼授权地址、用 code 换票、刷新令牌，以及网关换票。
+ */
+export class PlatformAuthApi {
+    #http;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * 拼装商家或多多客的 OAuth 授权地址。
+     *
+     * 对应官方入口：`https://mms.pinduoduo.com/open.html`（以及 H5 / 多多进宝授权页）
+     *
+     * @param query 回调地址与可选的授权页类型、state
+     * @returns 完整授权 URL
+     */
+    buildAuthorizeUrl(query) {
+        const url = new URL(AUTHORIZE_URLS[query.view ?? "web"]);
+        url.searchParams.set("response_type", "code");
+        url.searchParams.set("client_id", this.#http.clientId);
+        url.searchParams.set("redirect_uri", query.redirectUri);
+        if (query.state !== undefined && query.state !== "") {
+            url.searchParams.set("state", query.state);
+        }
+        return url.toString();
+    }
+    /**
+     * 用授权回调中的 `code` 换取 `access_token`。
+     *
+     * 对应官方接口：`POST https://open-api.pinduoduo.com/oauth/token`
+     *
+     * @param query 授权码
+     * @returns 令牌与授权主体信息
+     */
+    createToken(query) {
+        return this.#http.oauthToken({
+            grant_type: "authorization_code",
+            code: query.code,
+        });
+    }
+    /**
+     * 用 `refresh_token` 刷新 `access_token`。
+     *
+     * 对应官方接口：`POST https://open-api.pinduoduo.com/oauth/token`
+     *
+     * @param query 刷新令牌
+     * @returns 新的令牌与授权主体信息
+     */
+    refreshToken(query) {
+        return this.#http.oauthToken({
+            grant_type: "refresh_token",
+            refresh_token: query.refreshToken,
+        });
+    }
+    /**
+     * 用授权码通过开放平台网关换取 `access_token`。
+     *
+     * 对应官方接口：`pdd.pop.auth.token.create`
+     *
+     * @param query 授权码
+     * @returns 令牌与授权主体信息
+     */
+    createPopAuthToken(query) {
+        return this.#http.call("pdd.pop.auth.token.create", { code: query.code }, { auth: "none" });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/apis/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/apis/auth.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,cAAc,GAA0C;IAC5D,GAAG,EAAE,qCAAqC;IAC1C,EAAE,EAAE,yCAAyC;IAC7C,GAAG,EAAE,wCAAwC;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,KAAgC;QAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;QACzD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAC9C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YACpD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAA+B;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC3B,UAAU,EAAE,oBAAoB;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAgC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC3B,UAAU,EAAE,eAAe;YAC3B,aAAa,EAAE,KAAK,CAAC,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,kBAAkB,CAAC,KAAsC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,2BAA2B,EAC3B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EACpB,EAAE,IAAI,EAAE,MAAM,EAAE,CACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/apis/mall.d.ts

@@ -0,0 +1,41 @@
+import type { PddHttpClient } from "@qzsy/pdd-core";
+import type { PlatformPopAuthTokenResult } from "../types/auth.ts";
+import type { PlatformMallGetBindTicketQuery, PlatformMallGetBindTicketResult, PlatformMallGetBindTokenQuery, PlatformMallReportBindRelationQuery, PlatformMallReportBindRelationResult } from "../types/mall.ts";
+/**
+ * 开放平台店铺关联：上报存量关系、取 ticket、换被关联店铺令牌。
+ */
+export declare class PlatformMallApi {
+    #private;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http: PddHttpClient);
+    /**
+     * ISV 上报存量店铺关联关系。
+     *
+     * 对应官方接口：`pdd.pop.mall.bind.relation.report`
+     *
+     * @param query 关联时间、类型、三方用户与双方店铺
+     * @returns 是否上报成功
+     */
+    reportBindRelation(query: PlatformMallReportBindRelationQuery): Promise<PlatformMallReportBindRelationResult>;
+    /**
+     * 获取发起方店铺身份 ticket，用于生成店铺关联链接。
+     *
+     * 对应官方接口：`pdd.pop.mall.bind.ticket.get`
+     *
+     * @param query 三方用户 id 与可选店群
+     * @returns 关联 ticket
+     */
+    getBindTicket(query: PlatformMallGetBindTicketQuery): Promise<PlatformMallGetBindTicketResult>;
+    /**
+     * 用被关联店铺同意后的关联码换取该店 `access_token`。
+     *
+     * 对应官方接口：`pdd.pop.mall.bind.token.get`
+     *
+     * @param query 关联码、三方用户 id 与可选店群
+     * @returns 被关联店铺的令牌
+     */
+    getBindToken(query: PlatformMallGetBindTokenQuery): Promise<PlatformPopAuthTokenResult>;
+}
+//# sourceMappingURL=mall.d.ts.map

package/dist/apis/mall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mall.d.ts","sourceRoot":"","sources":["../../src/apis/mall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,EAC7B,mCAAmC,EACnC,oCAAoC,EACrC,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,qBAAa,eAAe;;IAG1B;;OAEG;IACH,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;;;;;OAOG;IACH,kBAAkB,CAChB,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,oCAAoC,CAAC,CAM/C;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAM7F;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAKtF;CACF"}

package/dist/apis/mall.js

@@ -0,0 +1,49 @@
+/**
+ * 开放平台店铺关联：上报存量关系、取 ticket、换被关联店铺令牌。
+ */
+export class PlatformMallApi {
+    #http;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * ISV 上报存量店铺关联关系。
+     *
+     * 对应官方接口：`pdd.pop.mall.bind.relation.report`
+     *
+     * @param query 关联时间、类型、三方用户与双方店铺
+     * @returns 是否上报成功
+     */
+    reportBindRelation(query) {
+        return this.#http.call("pdd.pop.mall.bind.relation.report", query, { auth: "none", responseKey: "response" });
+    }
+    /**
+     * 获取发起方店铺身份 ticket，用于生成店铺关联链接。
+     *
+     * 对应官方接口：`pdd.pop.mall.bind.ticket.get`
+     *
+     * @param query 三方用户 id 与可选店群
+     * @returns 关联 ticket
+     */
+    getBindTicket(query) {
+        return this.#http.call("pdd.pop.mall.bind.ticket.get", query, { auth: "access_token", responseKey: "response" });
+    }
+    /**
+     * 用被关联店铺同意后的关联码换取该店 `access_token`。
+     *
+     * 对应官方接口：`pdd.pop.mall.bind.token.get`
+     *
+     * @param query 关联码、三方用户 id 与可选店群
+     * @returns 被关联店铺的令牌
+     */
+    getBindToken(query) {
+        return this.#http.call("pdd.pop.mall.bind.token.get", query, {
+            auth: "access_token",
+            responseKey: "pop_auth_token_create_response",
+        });
+    }
+}
+//# sourceMappingURL=mall.js.map

package/dist/apis/mall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mall.js","sourceRoot":"","sources":["../../src/apis/mall.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACH,kBAAkB,CAChB,KAA0C;QAE1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,mCAAmC,EACnC,KAAK,EACL,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,KAAqC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,8BAA8B,EAC9B,KAAK,EACL,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,CAClD,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAoC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,6BAA6B,EAAE,KAAK,EAAE;YACvF,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,gCAAgC;SAC9C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/apis/util.d.ts

@@ -0,0 +1,21 @@
+import type { PddHttpClient } from "@qzsy/pdd-core";
+import type { PlatformTimeGetResult } from "../types/util.ts";
+/**
+ * 开放平台通用接口：服务器时间等不需要店铺授权的方法。
+ */
+export declare class PlatformUtilApi {
+    #private;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http: PddHttpClient);
+    /**
+     * 获取拼多多 POP 服务器时间，可用于校对本地时钟。
+     *
+     * 对应官方接口：`pdd.time.get`
+     *
+     * @returns 服务器时间
+     */
+    getTime(): Promise<PlatformTimeGetResult>;
+}
+//# sourceMappingURL=util.d.ts.map

package/dist/apis/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/apis/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;GAEG;AACH,qBAAa,eAAe;;IAG1B;;OAEG;IACH,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAExC;CACF"}

package/dist/apis/util.js

@@ -0,0 +1,23 @@
+/**
+ * 开放平台通用接口：服务器时间等不需要店铺授权的方法。
+ */
+export class PlatformUtilApi {
+    #http;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * 获取拼多多 POP 服务器时间，可用于校对本地时钟。
+     *
+     * 对应官方接口：`pdd.time.get`
+     *
+     * @returns 服务器时间
+     */
+    getTime() {
+        return this.#http.call("pdd.time.get", {}, { auth: "none" });
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/apis/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/apis/util.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtF,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+import { PddHttpClient, type PddAuthorizerCaller, type PddClientCaller, type PddClientOptions } from "@qzsy/pdd-core";
+import { PlatformAuthApi } from "./apis/auth.ts";
+import { PlatformMallApi } from "./apis/mall.ts";
+import { PlatformUtilApi } from "./apis/util.ts";
+/**
+ * 拼多多开放平台客户端。
+ *
+ * 负责应用级 OAuth、店铺关联与系统时间，不封装商家或多多进宝业务接口。
+ * 换到的 `access_token` 交给 `ShopClient` / `DdkClient` 使用。
+ */
+export declare class PlatformClient {
+    /**
+     * 底层 HTTP 客户端，需要调用尚未封装的接口时可直接使用。
+     */
+    readonly http: PddHttpClient;
+    /**
+     * 授权与换票。
+     */
+    readonly auth: PlatformAuthApi;
+    /**
+     * 店铺关联。
+     */
+    readonly mall: PlatformMallApi;
+    /**
+     * 通用接口，例如服务器时间。
+     */
+    readonly util: PlatformUtilApi;
+    /**
+     * 以调用方注入的店铺令牌访问需要授权的开放平台接口。
+     *
+     * 业务接口与自己持有 `accessToken` 时相同，只是令牌改由 `getAccessToken` 提供。
+     *
+     * @param caller 应用凭据、授权主体与取令牌函数
+     * @param options 可选的令牌存储、超时与 `fetch` 注入
+     */
+    static forAuthorizer(caller: Omit<PddAuthorizerCaller, "callMode">, options?: PddClientOptions): PlatformClient;
+    /**
+     * @param credentials 应用 `clientId` / `clientSecret`，以及可选的店铺令牌（关联接口需要）
+     * @param options 可选的地址、超时与 `fetch` 注入
+     */
+    constructor(credentials: PddClientCaller, options?: PddClientOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAClB,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,EAC7C,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAEhB;IAED;;;OAGG;IACH,YAAY,WAAW,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,EASnE;CACF"}

package/dist/client.js

@@ -0,0 +1,54 @@
+import { PddHttpClient, } from "@qzsy/pdd-core";
+import { PlatformAuthApi } from "./apis/auth.js";
+import { PlatformMallApi } from "./apis/mall.js";
+import { PlatformUtilApi } from "./apis/util.js";
+/**
+ * 拼多多开放平台客户端。
+ *
+ * 负责应用级 OAuth、店铺关联与系统时间，不封装商家或多多进宝业务接口。
+ * 换到的 `access_token` 交给 `ShopClient` / `DdkClient` 使用。
+ */
+export class PlatformClient {
+    /**
+     * 底层 HTTP 客户端，需要调用尚未封装的接口时可直接使用。
+     */
+    http;
+    /**
+     * 授权与换票。
+     */
+    auth;
+    /**
+     * 店铺关联。
+     */
+    mall;
+    /**
+     * 通用接口，例如服务器时间。
+     */
+    util;
+    /**
+     * 以调用方注入的店铺令牌访问需要授权的开放平台接口。
+     *
+     * 业务接口与自己持有 `accessToken` 时相同，只是令牌改由 `getAccessToken` 提供。
+     *
+     * @param caller 应用凭据、授权主体与取令牌函数
+     * @param options 可选的令牌存储、超时与 `fetch` 注入
+     */
+    static forAuthorizer(caller, options) {
+        return new PlatformClient({ ...caller, callMode: "authorizer" }, options);
+    }
+    /**
+     * @param credentials 应用 `clientId` / `clientSecret`，以及可选的店铺令牌（关联接口需要）
+     * @param options 可选的地址、超时与 `fetch` 注入
+     */
+    constructor(credentials, options) {
+        this.http = new PddHttpClient(credentials, {
+            userAgent: "@qzsy/pdd-platform-sdk",
+            tokenKind: "none",
+            ...options,
+        });
+        this.auth = new PlatformAuthApi(this.http);
+        this.mall = new PlatformMallApi(this.http);
+        this.util = new PlatformUtilApi(this.http);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAId,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACzB;;OAEG;IACM,IAAI,CAAgB;IAE7B;;OAEG;IACM,IAAI,CAAkB;IAE/B;;OAEG;IACM,IAAI,CAAkB;IAE/B;;OAEG;IACM,IAAI,CAAkB;IAE/B;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAClB,MAA6C,EAC7C,OAA0B;QAE1B,OAAO,IAAI,cAAc,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,YAAY,WAA4B,EAAE,OAA0B;QAClE,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,WAAW,EAAE;YACzC,SAAS,EAAE,wBAAwB;YACnC,SAAS,EAAE,MAAM;YACjB,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { PlatformClient } from "./client.ts";
+export { PlatformAuthApi } from "./apis/auth.ts";
+export { PlatformMallApi } from "./apis/mall.ts";
+export { PlatformUtilApi } from "./apis/util.ts";
+export type { PlatformAccessTokenResult, PlatformAuthorizeUrlQuery, PlatformAuthorizeView, PlatformCreatePopAuthTokenQuery, PlatformCreateTokenQuery, PlatformPopAuthTokenResult, PlatformRefreshTokenQuery, } from "./types/auth.ts";
+export type { PlatformMallGetBindTicketQuery, PlatformMallGetBindTicketResult, PlatformMallGetBindTokenQuery, PlatformMallReportBindRelationQuery, PlatformMallReportBindRelationResult, } from "./types/mall.ts";
+export type { PlatformTimeGetResult } from "./types/util.ts";
+export { MemoryTokenStore, PddApiError, PddError, PddHttpError, } from "@qzsy/pdd-core";
+export type { PddAppCredentials, PddAuthorizerCaller, PddCallMode, PddClientCaller, PddClientOptions, PddErrorContext, PddMerchantCaller, TokenStore, } from "@qzsy/pdd-core";
+export { isAuthorizerCaller } from "@qzsy/pdd-core";
+//# 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,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EACV,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,+BAA+B,EAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,EAC7B,mCAAmC,EACnC,oCAAoC,GACrC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { PlatformClient } from "./client.js";
+export { PlatformAuthApi } from "./apis/auth.js";
+export { PlatformMallApi } from "./apis/mall.js";
+export { PlatformUtilApi } from "./apis/util.js";
+export { MemoryTokenStore, PddApiError, PddError, PddHttpError, } from "@qzsy/pdd-core";
+export { isAuthorizerCaller } from "@qzsy/pdd-core";
+//# 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,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAmBjD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/auth.d.ts

@@ -0,0 +1,157 @@
+/**
+ * 拼多多 OAuth 授权页类型。
+ *
+ * - `web`：商家后台 PC 授权
+ * - `h5`：移动端授权
+ * - `ddk`：多多进宝授权
+ */
+export type PlatformAuthorizeView = "web" | "h5" | "ddk";
+/**
+ * 拼装商家 / 多多客授权地址时的参数。
+ */
+export interface PlatformAuthorizeUrlQuery {
+    /**
+     * 授权完成后面的回调地址。必须与开放平台应用配置一致。
+     */
+    redirectUri: string;
+    /**
+     * 授权页类型。默认 `web`。
+     */
+    view?: PlatformAuthorizeView;
+    /**
+     * 回传状态，授权完成后原样带回，用于防 CSRF。
+     */
+    state?: string;
+}
+/**
+ * `POST https://open-api.pinduoduo.com/oauth/token` 换票成功响应。
+ */
+export interface PlatformAccessTokenResult {
+    /**
+     * 店铺或授权主体的接口调用凭证。
+     */
+    access_token: string;
+    /**
+     * 凭证有效时间，单位：秒。文档示例为 86400。
+     */
+    expires_in: number;
+    /**
+     * 刷新令牌。
+     */
+    refresh_token: string;
+    /**
+     * 授权接口列表。
+     */
+    scope?: string[];
+    /**
+     * 授权主体标识。
+     */
+    owner_id?: string;
+    /**
+     * 授权主体名称。
+     */
+    owner_name?: string;
+}
+/**
+ * 用授权码换票的参数。
+ */
+export interface PlatformCreateTokenQuery {
+    /**
+     * 授权回调拿到的 `code`。
+     */
+    code: string;
+}
+/**
+ * 刷新令牌的参数。
+ */
+export interface PlatformRefreshTokenQuery {
+    /**
+     * 刷新令牌。
+     */
+    refreshToken: string;
+}
+/**
+ * 通过网关 `pdd.pop.auth.token.create` 换票的参数。
+ */
+export interface PlatformCreatePopAuthTokenQuery {
+    /**
+     * 授权code，grantType==authorization_code 时需要。
+     */
+    code: string;
+}
+/**
+ * 网关换票成功响应。
+ *
+ * 字段与开放平台「获取Access Token」`pdd.pop.auth.token.create` 对齐。
+ */
+export interface PlatformPopAuthTokenResult {
+    /**
+     * access_token。
+     */
+    access_token?: string;
+    /**
+     * access_token过期时间点。
+     */
+    expires_at?: number;
+    /**
+     * access_token过期时间段，10（表示10秒后过期）。
+     */
+    expires_in?: number;
+    /**
+     * 商家店铺id。
+     */
+    owner_id?: string;
+    /**
+     * 商家账号名称。
+     */
+    owner_name?: string;
+    /**
+     * r1级别API或字段的访问过期时间点。
+     */
+    r1_expires_at?: number;
+    /**
+     * r1级别API或字段的访问过期时间；10（表示10秒后过期）。
+     */
+    r1_expires_in?: number;
+    /**
+     * r2级别API或字段的访问过期时间点。
+     */
+    r2_expires_at?: number;
+    /**
+     * r2级别API或字段的访问过期时间；10（表示10秒后过期）。
+     */
+    r2_expires_in?: number;
+    /**
+     * refresh token，可用来刷新access_token。
+     */
+    refresh_token?: string;
+    /**
+     * Refresh token过期时间点。
+     */
+    refresh_token_expires_at?: number;
+    /**
+     * refresh_token过期时间段，10表示10秒后过期。
+     */
+    refresh_token_expires_in?: number;
+    /**
+     * 接口列表。
+     */
+    scope?: string[];
+    /**
+     * w1级别API或字段的访问过期时间点。
+     */
+    w1_expires_at?: number;
+    /**
+     * w1级别API或字段的访问过期时间；10（表示10秒后过期）。
+     */
+    w1_expires_in?: number;
+    /**
+     * w2级别API或字段的访问过期时间点。
+     */
+    w2_expires_at?: number;
+    /**
+     * w2级别API或字段的访问过期时间；10（表示10秒后过期）。
+     */
+    w2_expires_in?: number;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAE7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/auth.js

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

package/dist/types/auth.js.map

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

package/dist/types/mall.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 上报存量店铺关联关系的请求参数。
+ *
+ * 字段与开放平台「店铺关联关系上报」`pdd.pop.mall.bind.relation.report` 对齐。
+ */
+export interface PlatformMallReportBindRelationQuery {
+    /**
+     * 关联时间。
+     */
+    bind_at: number;
+    /**
+     * 关联类型：0-关联码关联，1-授权关联。
+     */
+    bind_type: number;
+    /**
+     * 三方应用的用户id。
+     */
+    external_uid: string;
+    /**
+     * 被关联方的店铺id。
+     */
+    invitee_mall_id: number;
+    /**
+     * 发起关联方的店铺id。
+     */
+    inviter_mall_id: number;
+    /**
+     * 当前店群包含的拼多多店铺id。
+     */
+    mall_list?: number[];
+}
+/**
+ * 上报存量店铺关联关系的结果。
+ */
+export interface PlatformMallReportBindRelationResult {
+    /**
+     * 是否上报成功。
+     */
+    success?: boolean;
+}
+/**
+ * 获取店铺关联 ticket 的请求参数。
+ *
+ * 字段与开放平台「获取店铺关联ticket」`pdd.pop.mall.bind.ticket.get` 对齐。
+ */
+export interface PlatformMallGetBindTicketQuery {
+    /**
+     * 三方应用的用户id。
+     */
+    external_uid: string;
+    /**
+     * 当前店群包含的拼多多店铺id。
+     */
+    mall_list?: number[];
+}
+/**
+ * 获取店铺关联 ticket 的结果。
+ */
+export interface PlatformMallGetBindTicketResult {
+    /**
+     * ticket。
+     */
+    ticket?: string;
+}
+/**
+ * 用关联码换取被关联店铺令牌的请求参数。
+ *
+ * 字段与开放平台「获取被关联店铺Access Token」`pdd.pop.mall.bind.token.get` 对齐。
+ */
+export interface PlatformMallGetBindTokenQuery {
+    /**
+     * 被关联店铺的关联code。
+     */
+    bind_code: string;
+    /**
+     * 三方应用的用户id。
+     */
+    external_uid: string;
+    /**
+     * 当前店群包含的拼多多店铺id。
+     */
+    mall_list?: number[];
+}
+//# sourceMappingURL=mall.d.ts.map

package/dist/types/mall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mall.d.ts","sourceRoot":"","sources":["../../src/types/mall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/types/mall.js

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

package/dist/types/mall.js.map

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

package/dist/types/util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 获取拼多多服务器时间的成功响应。
+ *
+ * 字段与开放平台「获取拼多多系统时间」`pdd.time.get` 对齐。
+ */
+export interface PlatformTimeGetResult {
+    /**
+     * 拼多多系统时间。
+     */
+    time: string;
+}
+//# sourceMappingURL=util.d.ts.map

package/dist/types/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/types/util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types/util.js

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

package/dist/types/util.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@qzsy/pdd-platform-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Pinduoduo open-platform OAuth server SDK",
+  "license": "MIT",
+  "author": "qzsy",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qzsy/pdd-sdk.git",
+    "directory": "packages/pdd-platform"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "bun": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "typecheck": "tsc --build --pretty"
+  },
+  "dependencies": {
+    "@qzsy/pdd-core": "0.1.0"
+  }
+}