Merge branch 'main' into mt-gateway-driver

Author: Gioee

.github/workflows/publish-docs.yml

@@ -0,0 +1,37 @@
+name: 'Publish docs'
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build_and_docs:
+    name: 'Build and Docs'
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: latest
+      - name: Setup Dependencies
+        run: |
+          corepack enable
+          npm install
+      - name: Build App and Typedoc
+        run: |
+          npm run build
+          npm run typedoc
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./docs
+      - name: Deploy Typedoc to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -1,37 +1,51 @@
 name: 'Release'
+
 on:
-  push:
-    branches: [main]
+  release:
+    types: [created]
+  workflow_dispatch:
 
 permissions:
   contents: read
-  pages: write
   id-token: write
 
+concurrency:
+  group: release
+  cancel-in-progress: false
+
 jobs:
-  build_and_docs:
-    name: 'Build and Docs'
-    timeout-minutes: 5
+  publish:
+    name: 'Publish to npm'
+    if: github.event_name == 'workflow_dispatch' || (github.event_name == 'release' && !github.event.release.draft)
+    timeout-minutes: 10
     runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-node@v4
         with:
-          node-version: latest
+          node-version: 22.14.0
+          registry-url: 'https://registry.npmjs.org'
+
       - name: Setup Dependencies
         run: |
           corepack enable
           npm install
-      - name: Build App and Typedoc
+
+      - name: Validate release tag
+        if: github.event_name == 'release'
         run: |
-          npm run build
-          npm run typedoc
-      - uses: actions/upload-pages-artifact@v3
-        with:
-          path: ./docs
-      - name: Deploy Typedoc to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
+          package_version=$(node -p "require('./package.json').version")
+          expected_tag="v${package_version}"
+          actual_tag="${{ github.event.release.tag_name }}"
+          if [ "$actual_tag" != "$expected_tag" ]; then
+            echo "Release tag $actual_tag does not match package version $expected_tag"
+            exit 1
+          fi
+
+      - name: Build package
+        run: npm run build
+
+      - name: Publish package
+        run: npm publish --access public

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqlitecloud/drivers",
-  "version": "1.0.872",
+  "version": "1.0.877",
   "description": "SQLiteCloud drivers for Typescript/Javascript in edge, web and node clients",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -12,7 +12,7 @@
     "build": "rm -rf ./lib/ && tsc --project tsconfig.build.json && npx webpack",
     "publish": "npm run build && npm publish --access public",
     "prettier": "prettier --write 'src/**/*'",
-    "typedoc": "rm -rf ./docs/ && typedoc --out docs && typedoc --plugin typedoc-plugin-markdown --out docs/markdown",
+    "typedoc": "rm -rf ./docs/ && typedoc --tsconfig tsconfig.build.json --plugin typedoc-plugin-markdown --out docs/markdown",
     "npmgui": "npx npm-gui@latest",
     "prepare": "husky"
   },

package.json

@@ -15,7 +15,13 @@ import {
   SQLiteCloudError,
   SQLiteCloudWebsocketBlobTransferFormat
 } from './types'
-import { decodeBigIntMarkers, decodeWebsocketRowsetData, encodeBigIntMarkers, parseWebsocketBlobTransferFormat, parseWebsocketMaxAttachments } from './utilities'
+import {
+  decodeBigIntMarkers,
+  decodeWebsocketRowsetData,
+  encodeBigIntMarkers,
+  parseWebsocketBlobTransferFormat,
+  parseWebsocketMaxAttachments
+} from './utilities'
 
 const SocketIODecoderBase = SocketIODecoder as unknown as new (...args: any[]) => { opts?: { maxAttachments?: number } }