@wevu/api 0.0.1 → 0.1.1

package/dist/index.mjs

@@ -1,14 +1,508 @@
-//#region src/index.ts
+//#region src/core/adapter.ts
+const GLOBAL_ADAPTER_KEYS = [
+	{
+		platform: "wx",
+		key: "wx"
+	},
+	{
+		platform: "my",
+		key: "my"
+	},
+	{
+		platform: "tt",
+		key: "tt"
+	},
+	{
+		platform: "qq",
+		key: "qq"
+	},
+	{
+		platform: "swan",
+		key: "swan"
+	},
+	{
+		platform: "ks",
+		key: "ks"
+	},
+	{
+		platform: "jd",
+		key: "jd"
+	},
+	{
+		platform: "xhs",
+		key: "xhs"
+	},
+	{
+		platform: "dd",
+		key: "dd"
+	},
+	{
+		platform: "qa",
+		key: "qa"
+	},
+	{
+		platform: "qapp",
+		key: "qapp"
+	},
+	{
+		platform: "uni",
+		key: "uni"
+	}
+];
+function resolveGlobalThis() {
+	if (typeof globalThis !== "undefined") return globalThis;
+	if (typeof window !== "undefined") return window;
+}
+function isAdapterCandidate(value) {
+	return typeof value === "object" || typeof value === "function";
+}
+/**
+* @description 侦测当前运行环境的全局 API 对象
+*/
+function detectGlobalAdapter() {
+	const root = resolveGlobalThis();
+	if (!root) return {};
+	for (const item of GLOBAL_ADAPTER_KEYS) {
+		const candidate = root[item.key];
+		if (isAdapterCandidate(candidate)) return {
+			adapter: candidate,
+			platform: item.platform
+		};
+	}
+	return {};
+}
+
+//#endregion
+//#region src/core/utils.ts
+function isPlainObject(value) {
+	return Object.prototype.toString.call(value) === "[object Object]";
+}
+function hasCallbacks(value) {
+	if (!isPlainObject(value)) return false;
+	return typeof value.success === "function" || typeof value.fail === "function" || typeof value.complete === "function";
+}
+function isSyncMethod(name) {
+	return name.endsWith("Sync");
+}
+function isEventMethod(name) {
+	return /^on[A-Z]/.test(name) || /^off[A-Z]/.test(name);
+}
+function shouldSkipPromise(name) {
+	return isSyncMethod(name) || isEventMethod(name);
+}
+function createNotSupportedError(methodName, platform) {
+	return { errMsg: `${platform ? `${platform}.${methodName}` : methodName}:fail method not supported` };
+}
+
+//#endregion
+//#region src/core/methodMapping.ts
+const PLATFORM_ALIASES$1 = {
+	alipay: "my",
+	douyin: "tt"
+};
+function mapToastType(type) {
+	if (type === "error") return "fail";
+	if (type === "loading") return "none";
+	return type;
+}
+function mapToastArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "content") && Object.prototype.hasOwnProperty.call(nextOptions, "title")) nextOptions.content = nextOptions.title;
+	if (Object.prototype.hasOwnProperty.call(nextOptions, "icon")) nextOptions.type = mapToastType(nextOptions.icon);
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapDouyinToastArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (nextOptions.icon === "error") nextOptions.icon = "fail";
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapLoadingArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "content") && Object.prototype.hasOwnProperty.call(nextOptions, "title")) nextOptions.content = nextOptions.title;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapActionSheetArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "items") && Array.isArray(nextOptions.itemList)) nextOptions.items = nextOptions.itemList;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapActionSheetResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "tapIndex") && Object.prototype.hasOwnProperty.call(result, "index")) return {
+		...result,
+		tapIndex: result.index
+	};
+	return result;
+}
+function mapModalArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "confirmButtonText") && Object.prototype.hasOwnProperty.call(nextOptions, "confirmText")) nextOptions.confirmButtonText = nextOptions.confirmText;
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "cancelButtonText") && Object.prototype.hasOwnProperty.call(nextOptions, "cancelText")) nextOptions.cancelButtonText = nextOptions.cancelText;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapModalResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "cancel") && Object.prototype.hasOwnProperty.call(result, "confirm")) return {
+		...result,
+		cancel: !result.confirm
+	};
+	return result;
+}
+function mapChooseImageResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "tempFilePaths") && Array.isArray(result.apFilePaths)) return {
+		...result,
+		tempFilePaths: result.apFilePaths
+	};
+	return result;
+}
+function mapDouyinChooseImageResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (typeof result.tempFilePaths === "string") return {
+		...result,
+		tempFilePaths: [result.tempFilePaths]
+	};
+	if (!Array.isArray(result.tempFilePaths) && Array.isArray(result.tempFiles)) {
+		const fallbackPaths = result.tempFiles.map((item) => {
+			if (!isPlainObject(item)) return;
+			const path = item.path;
+			if (typeof path === "string" && path) return path;
+			const filePath = item.filePath;
+			if (typeof filePath === "string" && filePath) return filePath;
+		}).filter((item) => typeof item === "string");
+		if (fallbackPaths.length > 0) return {
+			...result,
+			tempFilePaths: fallbackPaths
+		};
+	}
+	return result;
+}
+function mapSaveFileArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "apFilePath") && Object.prototype.hasOwnProperty.call(nextOptions, "tempFilePath")) nextOptions.apFilePath = nextOptions.tempFilePath;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapSaveFileResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "savedFilePath") && Object.prototype.hasOwnProperty.call(result, "apFilePath")) return {
+		...result,
+		savedFilePath: result.apFilePath
+	};
+	return result;
+}
+function mapDouyinSaveFileResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "savedFilePath") && Object.prototype.hasOwnProperty.call(result, "filePath")) return {
+		...result,
+		savedFilePath: result.filePath
+	};
+	return result;
+}
+function normalizePlatformName$1(value) {
+	if (!value) return;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized) return;
+	return PLATFORM_ALIASES$1[normalized] ?? normalized;
+}
+function mapSetClipboardArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "text") && Object.prototype.hasOwnProperty.call(nextOptions, "data")) nextOptions.text = nextOptions.data;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapClipboardResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "data") && Object.prototype.hasOwnProperty.call(result, "text")) return {
+		...result,
+		data: result.text
+	};
+	return result;
+}
+const METHOD_MAPPINGS = {
+	my: {
+		showToast: {
+			target: "showToast",
+			mapArgs: mapToastArgs
+		},
+		showLoading: {
+			target: "showLoading",
+			mapArgs: mapLoadingArgs
+		},
+		showActionSheet: {
+			target: "showActionSheet",
+			mapArgs: mapActionSheetArgs,
+			mapResult: mapActionSheetResult
+		},
+		showModal: {
+			target: "confirm",
+			mapArgs: mapModalArgs,
+			mapResult: mapModalResult
+		},
+		chooseImage: {
+			target: "chooseImage",
+			mapResult: mapChooseImageResult
+		},
+		saveFile: {
+			target: "saveFile",
+			mapArgs: mapSaveFileArgs,
+			mapResult: mapSaveFileResult
+		},
+		setClipboardData: {
+			target: "setClipboard",
+			mapArgs: mapSetClipboardArgs
+		},
+		getClipboardData: {
+			target: "getClipboard",
+			mapResult: mapClipboardResult
+		}
+	},
+	tt: {
+		showToast: {
+			target: "showToast",
+			mapArgs: mapDouyinToastArgs
+		},
+		showLoading: { target: "showLoading" },
+		showActionSheet: {
+			target: "showActionSheet",
+			mapResult: mapActionSheetResult
+		},
+		showModal: { target: "showModal" },
+		chooseImage: {
+			target: "chooseImage",
+			mapResult: mapDouyinChooseImageResult
+		},
+		saveFile: {
+			target: "saveFile",
+			mapResult: mapDouyinSaveFileResult
+		},
+		setClipboardData: { target: "setClipboardData" },
+		getClipboardData: { target: "getClipboardData" }
+	}
+};
+/**
+* @description 解析平台 API 映射规则
+*/
+function resolveMethodMapping(platform, methodName) {
+	const normalizedPlatform = normalizePlatformName$1(platform);
+	if (!normalizedPlatform) return;
+	const platformMappings = METHOD_MAPPINGS[normalizedPlatform];
+	if (!platformMappings) return;
+	return platformMappings[methodName];
+}
+
+//#endregion
+//#region src/core/createWeapi.ts
+const INTERNAL_KEYS = new Set([
+	"setAdapter",
+	"getAdapter",
+	"platform",
+	"raw"
+]);
+const PLATFORM_ALIASES = {
+	alipay: "my",
+	douyin: "tt"
+};
+function normalizePlatformName(value) {
+	if (!value) return;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized) return;
+	return PLATFORM_ALIASES[normalized] ?? normalized;
+}
+function resolveOptionsArg(args) {
+	const nextArgs = args.slice();
+	const lastArg = nextArgs.length > 0 ? nextArgs[nextArgs.length - 1] : void 0;
+	if (isPlainObject(lastArg)) {
+		const options = { ...lastArg };
+		nextArgs[nextArgs.length - 1] = options;
+		return {
+			args: nextArgs,
+			options
+		};
+	}
+	const options = {};
+	nextArgs.push(options);
+	return {
+		args: nextArgs,
+		options
+	};
+}
+function callWithPromise(context, method, args, mapResult) {
+	return new Promise((resolve, reject) => {
+		const { args: nextArgs, options } = resolveOptionsArg(args);
+		let settled = false;
+		options.success = (res) => {
+			settled = true;
+			resolve(mapResult ? mapResult(res) : res);
+		};
+		options.fail = (err) => {
+			settled = true;
+			reject(err);
+		};
+		options.complete = (res) => {
+			if (!settled) resolve(mapResult ? mapResult(res) : res);
+		};
+		try {
+			method.apply(context, nextArgs);
+		} catch (err) {
+			reject(err);
+		}
+	});
+}
+function callMissingApi(methodName, platform, args) {
+	const lastArg = args.length > 0 ? args[args.length - 1] : void 0;
+	const error = createNotSupportedError(methodName, platform);
+	if (hasCallbacks(lastArg)) {
+		lastArg.fail?.(error);
+		lastArg.complete?.(error);
+		return;
+	}
+	return Promise.reject(error);
+}
 /**
-* @description 简单的问候函数
+* @description 创建跨平台 API 实例
 */
-function greet(name) {
-	return `hello ${name}`;
+function createWeapi(options = {}) {
+	let adapter = options.adapter;
+	let platformName = normalizePlatformName(options.platform);
+	const cache = /* @__PURE__ */ new Map();
+	const resolveAdapter = () => {
+		if (adapter) return adapter;
+		const detected = detectGlobalAdapter();
+		if (detected.adapter) {
+			adapter = detected.adapter;
+			platformName = platformName ?? normalizePlatformName(detected.platform);
+		}
+		return adapter;
+	};
+	const setAdapter = (nextAdapter, nextPlatform) => {
+		adapter = nextAdapter;
+		platformName = normalizePlatformName(nextPlatform);
+		cache.clear();
+	};
+	const getAdapter = () => {
+		if (!adapter) resolveAdapter();
+		return adapter;
+	};
+	const getPlatform = () => {
+		if (!platformName) resolveAdapter();
+		return platformName;
+	};
+	return new Proxy({}, { get(_target, prop) {
+		if (prop === Symbol.toStringTag) return "Weapi";
+		if (prop === "then") return;
+		if (INTERNAL_KEYS.has(prop)) {
+			if (prop === "setAdapter") return setAdapter;
+			if (prop === "getAdapter") return getAdapter;
+			if (prop === "platform") return getPlatform();
+			if (prop === "raw") return getAdapter();
+		}
+		if (cache.has(prop)) return cache.get(prop);
+		const currentAdapter = resolveAdapter();
+		if (!currentAdapter) {
+			if (typeof prop !== "string") return;
+			return (...args) => callMissingApi(prop, getPlatform(), args);
+		}
+		const platform = getPlatform();
+		const value = currentAdapter[(typeof prop === "string" ? resolveMethodMapping(platform, prop) : void 0)?.target ?? prop];
+		if (typeof value !== "function") {
+			if (value === void 0 && typeof prop === "string") {
+				const missing = (...args) => callMissingApi(prop, getPlatform(), args);
+				cache.set(prop, missing);
+				return missing;
+			}
+			cache.set(prop, value);
+			return value;
+		}
+		const wrapped = (...args) => {
+			const runtimeAdapter = resolveAdapter();
+			const mappingRule = resolveMethodMapping(getPlatform(), prop);
+			const methodName = mappingRule?.target ?? prop;
+			const runtimeMethod = runtimeAdapter ? runtimeAdapter[methodName] : void 0;
+			const runtimeArgs = mappingRule?.mapArgs ? mappingRule.mapArgs(args) : args;
+			if (typeof runtimeMethod !== "function") return callMissingApi(prop, getPlatform(), args);
+			if (shouldSkipPromise(prop)) {
+				const result = runtimeMethod.apply(runtimeAdapter, runtimeArgs);
+				return mappingRule?.mapResult ? mappingRule.mapResult(result) : result;
+			}
+			const lastArg = runtimeArgs.length > 0 ? runtimeArgs[runtimeArgs.length - 1] : void 0;
+			if (hasCallbacks(lastArg)) {
+				if (mappingRule?.mapResult && isPlainObject(lastArg)) {
+					const options = lastArg;
+					const originalSuccess = options.success;
+					const originalComplete = options.complete;
+					options.success = (res) => {
+						originalSuccess?.(mappingRule.mapResult(res));
+					};
+					options.complete = (res) => {
+						originalComplete?.(mappingRule.mapResult(res));
+					};
+				}
+				const result = runtimeMethod.apply(runtimeAdapter, runtimeArgs);
+				return mappingRule?.mapResult ? mappingRule.mapResult(result) : result;
+			}
+			return callWithPromise(runtimeAdapter, runtimeMethod, runtimeArgs, mappingRule?.mapResult);
+		};
+		cache.set(prop, wrapped);
+		return wrapped;
+	} });
 }
+
+//#endregion
+//#region src/index.ts
 /**
-* @description 当前包版本号
+* @description 默认跨平台 API 实例（推荐使用）
+*
+* @generated weapi-platform-matrix:start
+* | 平台 | 类型来源 | 支持度 |
+* | --- | --- | --- |
+* | 微信小程序 (`wx`) | `miniprogram-api-typings` | ✅ 全量 |
+* | 支付宝小程序 (`my`) | `@mini-types/alipay` | ✅ 全量 |
+* | 抖音小程序 (`tt`) | `@douyin-microapp/typings` | ✅ 全量 |
+* | 其他平台对象 (`swan/jd/xhs/...`) | 运行时对象透传 | ⚠️ 按宿主能力支持 |
+* @generated weapi-platform-matrix:end
 */
-const VERSION = "0.0.0";
+const wpi = createWeapi();
 
 //#endregion
-export { VERSION, greet };
+export { createWeapi, wpi };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wevu/api",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "description": "tsdown bundler template",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -17,23 +17,29 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.mts",
+      "types": "./types/index.d.ts",
       "import": {
-        "types": "./dist/index.d.mts",
+        "types": "./types/index.d.ts",
         "default": "./dist/index.mjs"
       },
       "require": {
-        "types": "./dist/index.d.cts",
+        "types": "./types/index.d.ts",
         "default": "./dist/index.cjs"
       }
     }
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./types/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "types"
   ],
+  "dependencies": {
+    "@douyin-microapp/typings": "^1.3.1",
+    "@mini-types/alipay": "^3.0.14",
+    "miniprogram-api-typings": "^5.0.0"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -42,8 +48,12 @@
     "build": "tsdown",
     "test": "vitest run",
     "test:dev": "vitest",
+    "test:types": "tsd",
     "release": "pnpm publish",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "docs:sync": "node --experimental-strip-types ./scripts/sync-support-matrix.ts",
+    "docs:check": "node --experimental-strip-types ./scripts/sync-support-matrix.ts --check",
+    "prebuild": "pnpm run docs:check"
   }
 }

package/types/index.d.ts

@@ -0,0 +1,54 @@
+/// <reference types="miniprogram-api-typings" />
+/// <reference types="@mini-types/alipay" />
+/// <reference types="@douyin-microapp/typings" />
+
+// eslint-disable-next-line antfu/no-import-dist
+import type {
+  CreateWeapiOptions,
+  WeapiAdapter,
+  WeapiAlipayAdapter,
+  WeapiAlipayRawAdapter,
+  WeapiCrossPlatformAdapter,
+  WeapiCrossPlatformRawAdapter,
+  WeapiDouyinAdapter,
+  WeapiDouyinRawAdapter,
+  WeapiInstance,
+  WeapiPromisify,
+  WeapiWxAdapter,
+  WeapiWxRawAdapter,
+} from '../dist/index.d.mts'
+
+export type {
+  CreateWeapiOptions,
+  WeapiAdapter,
+  WeapiAlipayAdapter,
+  WeapiAlipayRawAdapter,
+  WeapiCrossPlatformAdapter,
+  WeapiCrossPlatformRawAdapter,
+  WeapiDouyinAdapter,
+  WeapiDouyinRawAdapter,
+  WeapiInstance,
+  WeapiPromisify,
+  WeapiWxAdapter,
+  WeapiWxRawAdapter,
+}
+
+export function createWeapi<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter>(
+  options?: CreateWeapiOptions<TAdapter>,
+): WeapiInstance<TAdapter>
+
+export type WeapiDefaultInstance = WeapiInstance<WeapiCrossPlatformRawAdapter>
+
+/**
+ * 默认跨平台 API 实例。
+ *
+ * @generated weapi-platform-matrix:start
+ * | 平台 | 全局对象 | 类型来源 | 对齐状态 |
+ * | --- | --- | --- | --- |
+ * | 微信小程序 | `wx` | `miniprogram-api-typings` | ✅ 全量 |
+ * | 支付宝小程序 | `my` | `@mini-types/alipay` | ✅ 全量 |
+ * | 抖音小程序 | `tt` | `@douyin-microapp/typings` | ✅ 全量 |
+ * | 其他平台（swan/jd/xhs 等） | 运行时宿主对象 | 运行时透传 | ⚠️ 按宿主能力支持 |
+ * @generated weapi-platform-matrix:end
+ */
+export const wpi: WeapiDefaultInstance