@qzsy/pdd-shop-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,22 @@
+import type { PddHttpClient } from "@qzsy/pdd-core";
+/**
+ * 商家基础支持：读取接口调用凭据。
+ */
+export declare class ShopAuthApi {
+    #private;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http: PddHttpClient);
+    /**
+     * 读取当前店铺 `access_token`。
+     *
+     * 令牌来自构造时传入的 `accessToken` / `refreshToken`，或 `ShopClient.forAuthorizer` 的回调。
+     * 拼多多没有 `client_id + client_secret` 直接换商家票的接口。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存并重新申请
+     * @returns `access_token`
+     */
+    getAccessToken(forceRefresh?: boolean): Promise<string>;
+}
+//# 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;AAEpD;;GAEG;AACH,qBAAa,WAAW;;IAGtB;;OAEG;IACH,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpD;CACF"}

package/dist/apis/auth.js

@@ -0,0 +1,25 @@
+/**
+ * 商家基础支持：读取接口调用凭据。
+ */
+export class ShopAuthApi {
+    #http;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * 读取当前店铺 `access_token`。
+     *
+     * 令牌来自构造时传入的 `accessToken` / `refreshToken`，或 `ShopClient.forAuthorizer` 的回调。
+     * 拼多多没有 `client_id + client_secret` 直接换商家票的接口。
+     *
+     * @param forceRefresh 为 `true` 时忽略缓存并重新申请
+     * @returns `access_token`
+     */
+    getAccessToken(forceRefresh = false) {
+        return this.#http.getAccessToken(forceRefresh);
+    }
+}
+//# 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":"AAEA;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,YAAY,GAAG,KAAK;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/apis/express.d.ts

@@ -0,0 +1,58 @@
+import type { PddHttpClient } from "@qzsy/pdd-core";
+import type { ShopExpressAddDepotQuery, ShopExpressChangeDepotInfoQuery, ShopExpressDepotInfo, ShopExpressDepotInfoGetQuery, ShopExpressDepotList, ShopExpressDepotListGetQuery, ShopExpressSearchDepotQuery, ShopExpressSearchDepotResult } from "../types/express.ts";
+/**
+ * 仓储仓库：新增、修改、查询仓库。
+ */
+export declare class ShopExpressApi {
+    #private;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http: PddHttpClient);
+    /**
+     * 增加仓库。
+     *
+     * 对应官方接口：`pdd.express.add.depot`
+     *
+     * @param query 仓库地址、编码与覆盖区域
+     * @returns 操作结果，成功时为 `success`
+     */
+    addDepot(query: ShopExpressAddDepotQuery): Promise<string>;
+    /**
+     * 修改仓库信息。
+     *
+     * 对应官方接口：`pdd.express.change.depot.info`
+     *
+     * @param query 仓库 id 及要更新的字段
+     * @returns 响应结果
+     */
+    changeDepotInfo(query: ShopExpressChangeDepotInfoQuery): Promise<string>;
+    /**
+     * 查询仓库详细信息。
+     *
+     * 对应官方接口：`pdd.express.depot.info.get`
+     *
+     * @param query 仓库 id
+     * @returns 仓库详情
+     */
+    getDepotInfo(query: ShopExpressDepotInfoGetQuery): Promise<ShopExpressDepotInfo>;
+    /**
+     * 分页查询仓库列表。
+     *
+     * 对应官方接口：`pdd.express.depot.list.get`
+     *
+     * @param query 分页起始位置与 size
+     * @returns 仓库数量与列表
+     */
+    getDepotList(query: ShopExpressDepotListGetQuery): Promise<ShopExpressDepotList>;
+    /**
+     * 根据仓库名称和仓库编码查询仓库。
+     *
+     * 对应官方接口：`pdd.express.search.depot`
+     *
+     * @param query 仓库编码、名称与分页
+     * @returns 匹配的仓库数量与列表
+     */
+    searchDepot(query: ShopExpressSearchDepotQuery): Promise<ShopExpressSearchDepotResult>;
+}
+//# sourceMappingURL=express.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/apis/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,+BAA+B,EAC/B,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,qBAAa,cAAc;;IAGzB;;OAEG;IACH,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzD;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvE;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE/E;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE/E;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAErF;CACF"}

package/dist/apis/express.js

@@ -0,0 +1,68 @@
+/**
+ * 仓储仓库：新增、修改、查询仓库。
+ */
+export class ShopExpressApi {
+    #http;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * 增加仓库。
+     *
+     * 对应官方接口：`pdd.express.add.depot`
+     *
+     * @param query 仓库地址、编码与覆盖区域
+     * @returns 操作结果，成功时为 `success`
+     */
+    addDepot(query) {
+        return this.#http.call("pdd.express.add.depot", query);
+    }
+    /**
+     * 修改仓库信息。
+     *
+     * 对应官方接口：`pdd.express.change.depot.info`
+     *
+     * @param query 仓库 id 及要更新的字段
+     * @returns 响应结果
+     */
+    changeDepotInfo(query) {
+        return this.#http.call("pdd.express.change.depot.info", query);
+    }
+    /**
+     * 查询仓库详细信息。
+     *
+     * 对应官方接口：`pdd.express.depot.info.get`
+     *
+     * @param query 仓库 id
+     * @returns 仓库详情
+     */
+    getDepotInfo(query) {
+        return this.#http.call("pdd.express.depot.info.get", query);
+    }
+    /**
+     * 分页查询仓库列表。
+     *
+     * 对应官方接口：`pdd.express.depot.list.get`
+     *
+     * @param query 分页起始位置与 size
+     * @returns 仓库数量与列表
+     */
+    getDepotList(query) {
+        return this.#http.call("pdd.express.depot.list.get", query);
+    }
+    /**
+     * 根据仓库名称和仓库编码查询仓库。
+     *
+     * 对应官方接口：`pdd.express.search.depot`
+     *
+     * @param query 仓库编码、名称与分页
+     * @returns 匹配的仓库数量与列表
+     */
+    searchDepot(query) {
+        return this.#http.call("pdd.express.search.depot", query);
+    }
+}
+//# sourceMappingURL=express.js.map

package/dist/apis/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/apis/express.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAO,cAAc;IAChB,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,KAA+B;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAS,uBAAuB,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,KAAsC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAS,+BAA+B,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAmC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,KAAmC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAAkC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA+B,0BAA0B,EAAE,KAAK,CAAC,CAAC;IAC1F,CAAC;CACF"}