@longzai-intelligence-transport/http-adapter-taro 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,166 @@
+import { ApiError, ApiResponse, ApiResponse as ApiResponse$1, AuthStrategy, CsrfProvider, HttpAdapter, HttpAdapter as HttpAdapter$1, HttpClient, HttpClient as HttpClient$1, HttpClientConfig, HttpClientConfig as HttpClientConfig$1, RequestConfig, RequestConfig as RequestConfig$1, RequestInterceptor, RequestInterceptorContext, ResponseInterceptor, ResponseInterceptorContext, TaroAdapterConfig, TaroAdapterConfig as TaroAdapterConfig$1, TokenProvider, TokenProvider as TokenProvider$1, createAuthStrategyInterceptor, createAuthTokenInterceptor, createCsrfInterceptor, createLoggingRequestInterceptor, createLoggingResponseInterceptor, createResponseTransformerInterceptor, createRetryInterceptor, createValidationInterceptor } from "@longzai-intelligence-transport/http-core";
+import Taro from "@tarojs/taro";
+
+//#region src/taro.adapter.d.ts
+/**
+ * 创建 Taro 适配器
+ *
+ * @example
+ *   ```typescript
+ *   import Taro from '@tarojs/taro';
+ *   import { createTaroAdapter } from '@longzai-intelligence-transport/http-adapter-taro';
+ *
+ *   const adapter = createTaroAdapter({ timeout: 30000 }, Taro);
+ *   ```;
+ *
+ * @param config - 适配器配置
+ * @param taro - Taro 实例（用于依赖注入，方便测试）
+ * @returns HTTP 适配器实例
+ */
+declare function createTaroAdapter(config?: TaroAdapterConfig$1, taro?: typeof Taro): HttpAdapter$1;
+//#endregion
+//#region src/token.provider.d.ts
+/**
+ * Taro Token 存储配置
+ */
+type TaroTokenStorageConfig = {
+  /**
+   * Token 存储键名
+   */
+  tokenKey?: string;
+  /**
+   * 存储方式，默认 'storage'（持久化）
+   */
+  storageType?: 'storage' | 'asyncStorage';
+};
+/**
+ * 创建 Taro Token 提供者
+ *
+ * 使用 Taro.getStorageSync 或 Taro.getStorage 实现 Token 获取
+ *
+ * @example
+ *   ```typescript
+ *   import { createTaroTokenProvider } from '@longzai-intelligence-transport/http-adapter-taro';
+ *
+ *   const tokenProvider = createTaroTokenProvider({
+ *     tokenKey: 'auth_token',
+ *   });
+ *
+ *   // 在 createHttpClient 中使用
+ *   const client = createHttpClient({
+ *     baseUrl: 'https://api.example.com',
+ *     tokenProvider,
+ *   });
+ *   ```;
+ *
+ * @param config - 配置选项
+ * @returns Token 提供者实例
+ */
+declare function createTaroTokenProvider(config?: TaroTokenStorageConfig): TokenProvider$1;
+/**
+ * 创建 Taro Token 设置器
+ *
+ * 提供设置和删除 Token 的方法
+ *
+ * @param config - 配置选项
+ * @returns Token 设置器实例
+ */
+declare function createTaroTokenSetter(config?: TaroTokenStorageConfig): {
+  setToken: (token: string | null) => Promise<void>;
+  removeToken: () => Promise<void>;
+};
+//#endregion
+//#region src/create-taro-http-client.client.d.ts
+/**
+ * Taro HTTP 客户端类型
+ *
+ * 扩展基础 HttpClient，增加 REST 便捷方法
+ */
+type TaroHttpClient = HttpClient$1 & {
+  /**
+   * 发送 GET 请求
+   *
+   * @typeParam T - 响应数据类型
+   * @param path - 请求路径
+   * @param params - 查询参数
+   * @param config - 请求配置
+   * @returns API 响应
+   */
+  get<T = unknown>(path: string, params?: QueryParams, config?: RequestConfig$1): Promise<ApiResponse$1<T>>;
+  /**
+   * 发送 POST 请求
+   *
+   * @typeParam T - 响应数据类型
+   * @param path - 请求路径
+   * @param data - 请求体数据
+   * @param config - 请求配置
+   * @returns API 响应
+   */
+  post<T = unknown>(path: string, data?: unknown, config?: RequestConfig$1): Promise<ApiResponse$1<T>>;
+  /**
+   * 发送 PUT 请求
+   *
+   * @typeParam T - 响应数据类型
+   * @param path - 请求路径
+   * @param data - 请求体数据
+   * @param config - 请求配置
+   * @returns API 响应
+   */
+  put<T = unknown>(path: string, data?: unknown, config?: RequestConfig$1): Promise<ApiResponse$1<T>>;
+  /**
+   * 发送 PATCH 请求
+   *
+   * @typeParam T - 响应数据类型
+   * @param path - 请求路径
+   * @param data - 请求体数据
+   * @param config - 请求配置
+   * @returns API 响应
+   */
+  patch<T = unknown>(path: string, data?: unknown, config?: RequestConfig$1): Promise<ApiResponse$1<T>>;
+  /**
+   * 发送 DELETE 请求
+   *
+   * @typeParam T - 响应数据类型
+   * @param path - 请求路径
+   * @param config - 请求配置
+   * @returns API 响应
+   */
+  delete<T = unknown>(path: string, config?: RequestConfig$1): Promise<ApiResponse$1<T>>;
+};
+/**
+ * 查询参数类型
+ */
+type QueryParams = Record<string, string | number | boolean | undefined>;
+/**
+ * 创建 Taro HTTP 客户端
+ *
+ * 创建基于 Taro.request 的 HTTP 客户端实例
+ *
+ * @example
+ *   ```typescript
+ *   import {
+ *     createTaroHttpClient,
+ *     createTaroTokenProvider,
+ *   } from '@longzai-intelligence-transport/http-adapter-taro';
+ *   import { createAuthTokenInterceptor } from '@longzai-intelligence-transport/http-core';
+ *
+ *   const tokenProvider = createTaroTokenProvider({ tokenKey: 'auth_token' });
+ *
+ *   const client = createTaroHttpClient({
+ *     baseUrl: 'https://api.example.com',
+ *     requestInterceptors: [createAuthTokenInterceptor(tokenProvider)],
+ *   });
+ *
+ *   // 使用类型安全的 request 方法
+ *   const response = await client.request({ route: userRoutes.list });
+ *
+ *   // 使用便捷方法
+ *   const data = await client.get('/users');
+ *   ```;
+ *
+ * @param config - 客户端配置
+ * @returns HTTP 客户端实例
+ */
+declare function createTaroHttpClient(config: HttpClientConfig$1): TaroHttpClient;
+//#endregion
+export { type ApiError, type ApiResponse, type AuthStrategy, type CsrfProvider, type HttpAdapter, type HttpClient, type HttpClientConfig, type RequestConfig, type RequestInterceptor, type RequestInterceptorContext, type ResponseInterceptor, type ResponseInterceptorContext, type TaroAdapterConfig, type TaroHttpClient, type TaroTokenStorageConfig, type TokenProvider, createAuthStrategyInterceptor, createAuthTokenInterceptor, createCsrfInterceptor, createLoggingRequestInterceptor, createLoggingResponseInterceptor, createResponseTransformerInterceptor, createRetryInterceptor, createTaroAdapter, createTaroHttpClient, createTaroTokenProvider, createTaroTokenSetter, createValidationInterceptor };

package/dist/index.js

@@ -0,0 +1 @@
+import{createAuthStrategyInterceptor as e,createAuthTokenInterceptor as t,createCsrfInterceptor as n,createInterceptorExecutor as r,createLoggingRequestInterceptor as i,createLoggingResponseInterceptor as a,createRequestInterceptorsFromConfig as o,createResponseInterceptorsFromConfig as s,createResponseTransformerInterceptor as c,createRetryInterceptor as l,createValidationInterceptor as u,isLegacyConfig as d,warnDeprecatedConfig as f}from"@longzai-intelligence-transport/http-core";function p(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function m(e){return e!=null}const h={GET:`GET`,POST:`POST`,PUT:`PUT`,PATCH:`PATCH`,DELETE:`DELETE`,HEAD:`HEAD`,OPTIONS:`OPTIONS`};function g(e){return e in h}function _(e){if(e!=null)return typeof e==`string`||e instanceof ArrayBuffer||p(e)?e:JSON.stringify(e)}function v(e){if(e)return e;let t=globalThis;if(p(t)&&`Taro`in t){let e=t.Taro;if(m(e))return e}throw Error(`Taro 实例未找到，请确保已安装 @tarojs/taro 或通过参数传入 Taro 实例`)}function y(e,t){let n=e?.timeout??3e4,r=v(t);return{async execute(e){let t=e.method.toUpperCase(),i=g(t)?h[t]:`GET`,a={url:e.url,method:i,header:e.headers,timeout:n,data:_(e.body)};if(e.params){let t=Object.entries(e.params).map(([e,t])=>`${encodeURIComponent(e)}=${encodeURIComponent(String(t))}`).join(`&`);a.url=`${a.url}?${t}`}let o=await r.request(a),s={};if(o.header)for(let[e,t]of Object.entries(o.header))s[e.toLowerCase()]=String(t);return{status:o.statusCode,headers:s,data:o.data}}}}function b(){let e=globalThis;if(p(e)&&`Taro`in e){let t=e.Taro;if(m(t))return t}throw Error(`Taro 未找到，请确保已安装 @tarojs/taro 或通过全局注入 Taro 实例`)}function x(e){let t=e?.tokenKey??`access_token`,n=e?.storageType??`storage`;return{getToken:async()=>{try{let e=b();return n===`asyncStorage`?(await e.getStorage({key:t})).data??null:e.getStorageSync(t)??null}catch{return null}}}}function S(e){let t=e?.tokenKey??`access_token`,n=e?.storageType??`storage`,r=async e=>{let r=b();if(e===null){n===`asyncStorage`?await r.removeStorage({key:t}):r.removeStorageSync(t);return}n===`asyncStorage`?await r.setStorage({key:t,data:e}):r.setStorageSync(t,e)};return{setToken:r,removeToken:async()=>{await r(null)}}}function C(e,t){if(!t)return e;let n=new URLSearchParams;Object.entries(t).forEach(([e,t])=>{t!==void 0&&n.append(e,String(t))});let r=n.toString();return r?`${e}?${r}`:e}function w(e,t,n,r,i){return{url:`${e}${t}`,method:n,headers:i?.headers??{},body:r,config:i,metadata:{}}}function T(e,t,n){let r=e.path;if(t&&Object.entries(t).forEach(([e,t])=>{r=r.replace(`:${e}`,String(t))}),n){let e=new URLSearchParams;Object.entries(n).forEach(([t,n])=>{n!==void 0&&e.append(t,String(n))});let t=e.toString();t&&(r=`${r}?${t}`)}return r}async function E(e,t,n,r,i,a,o){let s=w(t,i,r,a,{...o,headers:{...n,...o?.headers}});return e.execute(s)}function D(e){if(m(e))return e;throw Error(`响应类型不匹配`)}function O(e,t,n){return async(r,i,a)=>D(await E(e,t,n,`GET`,C(r,i),void 0,a))}function k(e,t,n,r){return async(i,a,o)=>D(await E(e,t,n,r,i,a,o))}function A(e,t,n){return async(r,i)=>D(await E(e,t,n,`DELETE`,r,void 0,i))}function j(e,t,n){return{get:O(e,t,n),post:k(e,t,n,`POST`),put:k(e,t,n,`PUT`),patch:k(e,t,n,`PATCH`),delete:A(e,t,n)}}function M(e){let{baseUrl:t,timeout:n=3e4,headers:i,onUnauthorized:a}=e;d(e)&&f(e);let c=o(e),l=s(e),u=y({timeout:n}),p=r({requestInterceptors:c,responseInterceptors:l,onUnauthorized:a},u);return{request:async e=>{let{route:n,params:r,query:a,body:o,config:s}=e,c=T(n,r,a);return D(await E(p,t,i,n.method,c,o,s))},...j(p,t,i)}}export{e as createAuthStrategyInterceptor,t as createAuthTokenInterceptor,n as createCsrfInterceptor,i as createLoggingRequestInterceptor,a as createLoggingResponseInterceptor,c as createResponseTransformerInterceptor,l as createRetryInterceptor,y as createTaroAdapter,M as createTaroHttpClient,x as createTaroTokenProvider,S as createTaroTokenSetter,u as createValidationInterceptor};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@longzai-intelligence-transport/http-adapter-taro",
+  "version": "0.1.0",
+  "keywords": [
+    "adapter",
+    "http",
+    "miniprogram",
+    "taro",
+    "utils"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsgo --build tsconfig/build.json && resolve-aliases -p tsconfig/build.json",
+    "build:prod": "NODE_ENV=production tsdown",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "tsgo --noEmit -p tsconfig/app.json",
+    "typecheck:node": "tsgo --noEmit -p tsconfig/node.json",
+    "typecheck:test": "tsgo --noEmit -p tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "clean": "rimraf dist out .cache"
+  },
+  "dependencies": {
+    "@longzai-intelligence-transport/http-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@tarojs/taro": "^4.2.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@tarojs/taro": ">=3.6.0",
+    "zod": "^4.4.3"
+  }
+}