@qzsy/pdd-ddk-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/util.d.ts

@@ -0,0 +1,21 @@
+import type { PddHttpClient } from "@qzsy/pdd-core";
+import type { DdkTimeGetResult } from "../types/util.ts";
+/**
+ * 多多进宝通用接口：服务器时间等不需要授权的方法。
+ */
+export declare class DdkUtilApi {
+    #private;
+    /**
+     * @param http 共享的拼多多 HTTP 客户端
+     */
+    constructor(http: PddHttpClient);
+    /**
+     * 获取拼多多 POP 服务器时间，可用于校对本地时钟。
+     *
+     * 对应官方接口：`pdd.time.get`
+     *
+     * @returns 服务器时间
+     */
+    getTime(): Promise<DdkTimeGetResult>;
+}
+//# 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,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,qBAAa,UAAU;;IAGrB;;OAEG;IACH,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAEnC;CACF"}

package/dist/apis/util.js

@@ -0,0 +1,23 @@
+/**
+ * 多多进宝通用接口：服务器时间等不需要授权的方法。
+ */
+export class DdkUtilApi {
+    #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,UAAU;IACZ,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,CAAmB,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,24 @@
+import { PddHttpClient, type PddClientCaller, type PddClientOptions } from "@qzsy/pdd-core";
+import { DdkUtilApi } from "./apis/util.ts";
+/**
+ * 拼多多多多进宝服务端客户端。
+ *
+ * 默认不注入 `access_token`。需要店铺授权的进宝接口，调用 `http.call` 时显式传入 `{ auth: "access_token" }`，
+ * 或在构造时提供 `accessToken` / `getAccessToken`。
+ */
+export declare class DdkClient {
+    /**
+     * 底层 HTTP 客户端，需要调用尚未封装的接口时可直接使用。
+     */
+    readonly http: PddHttpClient;
+    /**
+     * 通用接口，例如服务器时间。
+     */
+    readonly util: DdkUtilApi;
+    /**
+     * @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,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;;OAGG;IACH,YAAY,WAAW,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAOnE;CACF"}

package/dist/client.js

@@ -0,0 +1,31 @@
+import { PddHttpClient, } from "@qzsy/pdd-core";
+import { DdkUtilApi } from "./apis/util.js";
+/**
+ * 拼多多多多进宝服务端客户端。
+ *
+ * 默认不注入 `access_token`。需要店铺授权的进宝接口，调用 `http.call` 时显式传入 `{ auth: "access_token" }`，
+ * 或在构造时提供 `accessToken` / `getAccessToken`。
+ */
+export class DdkClient {
+    /**
+     * 底层 HTTP 客户端，需要调用尚未封装的接口时可直接使用。
+     */
+    http;
+    /**
+     * 通用接口，例如服务器时间。
+     */
+    util;
+    /**
+     * @param credentials 应用 `clientId` / `clientSecret`，以及可选的授权令牌
+     * @param options 可选的令牌存储、超时与 `fetch` 注入
+     */
+    constructor(credentials, options) {
+        this.http = new PddHttpClient(credentials, {
+            userAgent: "@qzsy/pdd-ddk-sdk",
+            tokenKind: "none",
+            ...options,
+        });
+        this.util = new DdkUtilApi(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,GAGd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACpB;;OAEG;IACM,IAAI,CAAgB;IAE7B;;OAEG;IACM,IAAI,CAAa;IAE1B;;;OAGG;IACH,YAAY,WAA4B,EAAE,OAA0B;QAClE,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,WAAW,EAAE;YACzC,SAAS,EAAE,mBAAmB;YAC9B,SAAS,EAAE,MAAM;YACjB,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DdkClient } from "./client.ts";
+export { DdkUtilApi } from "./apis/util.ts";
+export type { DdkTimeGetResult } 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,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,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,5 @@
+export { DdkClient } from "./client.js";
+export { DdkUtilApi } 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,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/util.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 获取拼多多服务器时间的成功响应。
+ */
+export interface DdkTimeGetResult {
+    /**
+     * 服务器时间，格式 `yyyy-MM-dd HH:mm:ss`。
+     */
+    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;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;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-ddk-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Pinduoduo Duo Duo Jinbao (多多进宝) server SDK",
+  "license": "MIT",
+  "author": "qzsy",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qzsy/pdd-sdk.git",
+    "directory": "packages/pdd-ddk"
+  },
+  "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"
+  }
+}