@switchbot/homebridge-switchbot 5.0.0-beta.99 → 5.0.0

package/.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@2.3.0/schema.json",
+  "changelog": [
+    "@changesets/cli/changelog",
+    { "repo": "OpenWonderLabs/homebridge-switchbot" }
+  ],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "latest",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.github/copilot-instructions.md

@@ -2,6 +2,45 @@
 
 Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
 
+## Topic-Based Reference Priority
+
+When a prompt includes the topics below, consult these upstream references first before implementation decisions.
+
+### Matter (keyword examples: "Matter", "child bridge", "cluster", "conformance")
+
+Primary references:
+- https://github.com/homebridge-plugins/homebridge-matter
+- https://github.com/homebridge/homebridge/ - only if latest is 2.0.0 or later and contains Matter-related code or reference: 
+   - https://github.com/homebridge/homebridge/tree/beta-2.0.0/
+- https://github.com/matter-js/matter.js
+
+Usage rule:
+- For Matter behavior, conformance, clustering, or registration logic, align implementation with these references before applying local changes.
+
+### SwitchBot BLE (keyword examples: "BLE", "Bluetooth", "RSSI", "advertisement", "scan")
+
+Primary references:
+- https://github.com/OpenWonderLabs/SwitchBotAPI-BLE
+- https://github.com/sblibs/pySwitchbot
+
+Usage rule:
+- For BLE command/state/scan behavior, prefer these references for protocol expectations and payload shape.
+
+### SwitchBot OpenAPI (keyword examples: "OpenAPI", "cloud API", "device list", "command")
+
+Primary reference:
+- https://github.com/OpenWonderLabs/SwitchBotAPI
+
+Usage rule:
+- For OpenAPI device models, commands, and response fields, prioritize this reference for compatibility.
+
+### Conflict Resolution
+
+If references conflict:
+1. Prefer official upstream docs/API specs.
+2. Keep existing plugin behavior unless a clear bug is identified.
+3. Document any intentional deviation in PR notes.
+
 ## Branch Targeting Strategy
 
 When creating pull requests, ALWAYS follow this branch targeting strategy:

package/.github/workflows/ci.yml

@@ -6,12 +6,15 @@ on:
   pull_request:
     branches: ["main", "latest"]
 
+permissions:
+  contents: read
+
 jobs:
   build-and-test:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [20, 22]
+        node-version: [22, 24]
 
     steps:
       - uses: actions/checkout@v4

package/.github/workflows/manual-e2e.yml

@@ -1,5 +1,8 @@
 name: Manual E2E (build + optional E2E)
 
+permissions:
+  contents: read
+
 on:
   workflow_dispatch:
     inputs:
@@ -43,12 +46,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '18'
+          node-version: '22'
 
       - name: Install dependencies
         run: npm ci --prefer-offline --no-audit --progress=false

package/.github/workflows/release.yml

@@ -1,30 +1,78 @@
-name: Unified Release
+name: Release
 
 on:
   push:
     branches:
-      #- "alpha-*"
-      #- "beta-*"
-      - latest
+      - 'beta-*'
+      - 'beta'
+      - 'latest'
   workflow_dispatch:
 
 jobs:
+  # ─── BETA RELEASE (branches starting with "beta") ────────────────────────────
+
+  # 1️⃣ Build and test
+  build_and_test:
+    if: startsWith(github.ref_name, 'beta')
+    uses: homebridge/.github/.github/workflows/nodejs-build-and-test.yml@latest
+    with:
+      enable_coverage: false
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}
+
+  # 2️⃣ Lint
+  lint:
+    if: startsWith(github.ref_name, 'beta')
+    needs: build_and_test
+    uses: homebridge/.github/.github/workflows/eslint.yml@latest
+
+  # 3️⃣ Publish beta to NPM (OIDC — id-token required here and in the reusable workflow)
+  beta-publish:
+    if: startsWith(github.ref_name, 'beta')
+    needs: lint
+    permissions:
+      id-token: write
+    uses: homebridge/.github/.github/workflows/npm-publish-esm-oidc.yml@latest
+    with:
+      tag: 'beta'
+      dynamically_adjust_version: true
+      npm_version_command: 'pre'
+      pre_id: 'beta'
+
+  # 4️⃣ Create GitHub pre-release
+  beta-pre-release:
+    if: startsWith(github.ref_name, 'beta')
+    needs: beta-publish
+    uses: homebridge/.github/.github/workflows/pre-release.yml@latest
+    with:
+      npm_version: ${{ needs.beta-publish.outputs.NPM_VERSION }}
+      body: |
+        **Beta Release**
+        **Version**: v${{ needs.beta-publish.outputs.NPM_VERSION }}
+        [How To Test Beta Releases](https://github.com/OpenWonderLabs/homebridge-switchbot/wiki/Beta-Version)
+
+
+  # ─── STABLE RELEASE (branch: "latest") ───────────────────────────────────────
+
   # 1️⃣ Determine release type, ESM status, and branch name
   determine-release-type:
+    if: github.ref_name == 'latest'
     uses: homebridge/.github/.github/workflows/determine-release-type.yml@latest
     with:
       ref_name: ${{ github.ref_name }}
 
   # 2️⃣ Update version and changelog using the scripts
   update-version:
+    if: github.ref_name == 'latest'
     needs: determine-release-type
     uses: homebridge/.github/.github/workflows/update-version.yml@latest
     with:
       release_type: ${{ needs.determine-release-type.outputs.release_type }}
       is_esm: ${{ needs.determine-release-type.outputs.is_esm == 'true' }}
 
-  # 3️⃣ Publish to NPM and create GitHub release
+  # 3️⃣ Publish to NPM and create GitHub release (OIDC — id-token required here and in the reusable workflow)
   publish-release:
+    if: github.ref_name == 'latest'
     needs: [determine-release-type, update-version]
     permissions:
       id-token: write
@@ -39,17 +87,17 @@ jobs:
 
   # 4️⃣ Promote branch if this is a prerelease (alpha/beta)
   promote-branch:
+    if: ${{ github.ref_name == 'latest' && needs.determine-release-type.outputs.release_type != 'latest' && needs.determine-release-type.outputs.release_type != 'skip' }}
     needs: [determine-release-type, publish-release]
-    if: ${{ needs.determine-release-type.outputs.release_type != 'latest' && needs.determine-release-type.outputs.release_type != 'skip' }}
     uses: homebridge/.github/.github/workflows/promote-branch.yml@latest
     with:
       branch_name: ${{ needs.determine-release-type.outputs.branch_name }}
       release_type: ${{ needs.determine-release-type.outputs.release_type }}
       is_esm: ${{ needs.determine-release-type.outputs.is_esm == 'true' }}
 
-  # 5️⃣ Notify if any previous job fails
+  # 5️⃣ Notify if any stable-release job fails
   workflow-failure:
-    if: ${{ failure() }}
+    if: failure()
     needs: [determine-release-type, update-version, publish-release, promote-branch]
     uses: homebridge/.github/.github/workflows/report-failure.yml@latest
     with:
@@ -57,15 +105,16 @@ jobs:
       job_name: ${{ github.job }}
       run_url: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
 
-  # 6️⃣ Post to Discord
-  github-releases-to-discord:
-    name: Discord Webhooks
-    needs: [determine-release-type, update-version, publish-release]
+  # 6️⃣ Post to Discord (Beta + Stable)
+  discord:
+    name: Release Notifications
+    if: ${{ always() && ((startsWith(github.ref_name, 'beta') && needs.beta-publish.result == 'success') || (github.ref_name == 'latest' && needs.publish-release.result == 'success')) }}
+    needs: [beta-publish, update-version, publish-release]
     uses: homebridge/.github/.github/workflows/discord-webhooks.yml@latest
     with:
-      title: "SwitchBot Release"
+      title: ${{ startsWith(github.ref_name, 'beta') && 'Homebridge SwitchBot Beta Release' || 'Homebridge SwitchBot Release' }}
       description: |
-        Version `v${{ needs.update-version.outputs.version }}`
-      url: "https://github.com/OpenWonderLabs/homebridge-switchbot/releases/tag/v${{ needs.update-version.outputs.version }}"
+        Version `v${{ startsWith(github.ref_name, 'beta') && needs.beta-publish.outputs.NPM_VERSION || needs.update-version.outputs.version }}`
+      url: "https://github.com/OpenWonderLabs/homebridge-switchbot/releases/tag/v${{ startsWith(github.ref_name, 'beta') && needs.beta-publish.outputs.NPM_VERSION || needs.update-version.outputs.version }}"
     secrets:
       DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK_URL_LATEST }}

package/.github/workflows/stale.yml

@@ -3,12 +3,10 @@ name: Stale workflow
 on:
   workflow_dispatch:
   schedule:
-    - cron: '45 11 * * *'
+    - cron: '45 7 * * *'
 
 jobs:
   stale:
-    uses: OpenWonderLabs/.github/.github/workflows/stale.yml@latest
-    with:
-      days-before-issue-stale: 15
+    uses: homebridge/.github/.github/workflows/stale.yml@latest
     secrets:
       token: ${{ secrets.GITHUB_TOKEN }}

package/.husky/pre-push

@@ -0,0 +1,15 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+echo "Running changeset version before push..."
+if npx @changesets/cli version --yes; then
+  git add package.json package-lock.json CHANGELOG.md || true
+  if ! git diff --staged --quiet; then
+    echo "Committing version and changelog updates"
+    git commit -m "chore(release): version packages [skip ci]" || true
+  else
+    echo "No version changes to commit"
+  fi
+else
+  echo "changeset version failed or no changesets present"
+fi