[refactor] objectify HTTPRequest and utility tool functions into Injectable-runtime classes (#23)

Co-authored-by: TechQuery <shiy2008@gmail.com>

Author: Copilot

.github/workflows/main.yml

@@ -3,8 +3,11 @@ on:
     push:
         tags:
             - v*
+env:
+    PUBLISH_TAG: ${{ contains(github.ref_name, '-') && 'next' || 'latest' }}
+
 jobs:
-    Build-and-Publish:
+    Test-Build-Publish-Deploy:
         runs-on: ubuntu-latest
         permissions:
             contents: write
@@ -24,11 +27,12 @@ jobs:
               run: pnpm i --frozen-lockfile
 
             - name: Build & Publish
-              run: npm publish --access public --provenance
+              run: npm publish --access public --provenance --tag ${{ env.PUBLISH_TAG }}
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-            - name: Update document
+            - name: Deploy document
+              if: ${{ env.PUBLISH_TAG == 'latest' }}
               uses: peaceiris/actions-gh-pages@v4
               with:
                   publish_dir: ./docs

ReadMe.md

@@ -87,7 +87,35 @@ npx tsx index.ts
 
 ### Non-polyfillable runtimes
 
-1. https://github.com/idea2app/KoAJAX-Taro-adapter
+#### Taro (Mini Program, Open Harmony, etc.)
+
+##### 1. Install Polyfill
+
+```shell
+npm install event-target-shim taro-fetch-polyfill
+```
+
+##### 2. Inject Runtime
+
+Following Example comes from https://github.com/idea2app/Taro-Vant-MobX-ts/blob/70f33be5b2365b8126ed93663905329eae25fbf0/src/store/service.ts
+
+```typescript
+import { Event, EventTarget } from 'event-target-shim';
+import { defaultHTTPRuntime, HTTPToolkit } from 'koajax';
+import { Blob, Headers, ReadableStream, fetch } from 'taro-fetch-polyfill';
+
+const { request } = new HTTPToolkit({
+    ...defaultHTTPRuntime,
+    Event: Event as typeof globalThis.Event,
+    EventTarget: EventTarget as typeof globalThis.EventTarget,
+    Headers,
+    Blob,
+    ReadableStream,
+    fetch: fetch as typeof globalThis.fetch
+});
+
+export const httpClient = new HTTPClient({ baseRequest: request });
+```
 
 ## Example
 

package.json

@@ -1,6 +1,6 @@
 {
     "name": "koajax",
-    "version": "3.2.0",
+    "version": "3.3.0",
     "license": "LGPL-3.0",
     "author": "shiy2008@gmail.com",
     "description": "HTTP Client based on Koa-like middlewares",