Release 1.1.0

## [1.1.0] - 2026-04-10

### Breaking Changes

- [domains] Add `Domain Whitelist` and `Domain Blacklist`.

### Added

- [helpers]: Add `helpers module` to make the platform code easier to read and maintain.
- [helpers]: Add `payload module` to make the platform code easier to read and maintain.
- [helpers]: Add `report module` to make the platform code easier to read and maintain.
- [scripts]: Add script to prune GitHub releases based on tag prefix.

### Changed

- [package]: Update dependencies.
- [package]: Bump package to `automator` v.3.1.5.
- [package]: Bump `eslint` to v.10.2.0.
- [package]: Bump `prettier` to v.3.8.2.
- [package]: Bump `typescript-eslint` to v.8.58.1.
- [devcontainer]: Update VS Code settings.
- [scripts]: Update mb-run script.
- [entity]: Refactor entity helper signatures to be uniform across all helpers.

### Fixed

- [schema]: Fix controllerStrategy schema.
- [devcontainer]: Fix pull of new image.
- [devcontainer]: Fix matterbridge scripts.

<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>

Author: Luligu

.devcontainer/devcontainer.json

@@ -49,8 +49,8 @@ Dev containers have networking limitations depending on the host OS and Docker s
     "source=${localWorkspaceFolderBasename}-cert,target=/home/node/.mattercert,type=volume",
     "source=matterbridge,target=/matterbridge,type=volume"
   ],
-  // Create the matterbridge Docker network if it doesn't exist and pull the base image (runs on the HOST before the container starts).
-  "initializeCommand": "docker network inspect matterbridge || docker network create matterbridge && docker pull mcr.microsoft.com/devcontainers/javascript-node:24-trixie",
+  // Create the matterbridge Docker network if it doesn't exist, then pull the base image (runs on the HOST before the container starts).
+  "initializeCommand": "(docker network inspect matterbridge || docker network create matterbridge) && docker pull mcr.microsoft.com/devcontainers/javascript-node:24-trixie",
   // On create, update npm, install and link the dev of matterbridge and install and build the plugin (runs inside the container)
   "postCreateCommand": "bash .devcontainer/postCreateCommand.sh",
   // On start, run the plugin in watch mode (runs inside the container)
@@ -90,10 +90,33 @@ Dev containers have networking limitations depending on the host OS and Docker s
         "eslint.format.enable": true,
         "eslint.useFlatConfig": true,
         "diffEditor.ignoreTrimWhitespace": false,
-        "git.autofetch": true,
         "files.eol": "\n",
         "files.insertFinalNewline": true,
-        "files.trimFinalNewlines": true
+        "files.trimFinalNewlines": true,
+        "files.watcherExclude": {
+          "**/node_modules/**": true,
+          "**/build/**": true,
+          "**/.cache/**": true,
+          "**/coverage/**": true
+        },
+        "search.exclude": {
+          "**/node_modules": true,
+          "**/dist": true,
+          "**/build": true,
+          "**/.cache": true,
+          "**/coverage": true
+        },
+        "git.autofetch": true,
+        "git.autoRepositoryDetection": false,
+        "git.ignoredRepositories": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.cache/**", "**/coverage/**", "**/docs/**"],
+        "js/ts.tsdk.path": "node_modules/typescript/lib",
+        "js/ts.tsdk.promptToUseWorkspaceVersion": false,
+        "js/ts.tsserver.watchOptions": {
+          "watchFile": "dynamicPriorityPolling",
+          "watchDirectory": "dynamicPriorityPolling",
+          "fallbackPolling": "dynamicPriorityPolling",
+          "excludeDirectories": ["**/.cache/**", "**/node_modules/**", "**/coverage/**", "**/dist/**", "**/build/**", "**/docs/**"]
+        }
       }
     }
   }

.devcontainer/install-matterbridge-dev.sh

@@ -22,5 +22,5 @@ SHA7=$(git rev-parse --short=7 HEAD) && BASE_VERSION=$(node -p "require('./packa
 npm ci --no-fund --no-audit && npm run build
 cd apps/frontend && npm ci --no-fund --no-audit && npm run build && cd ../..
 npm install . --global --no-fund --no-audit
-rm -rf .cache .devcontainer .git .github .vscode docker docs reflector screenshots scripts systemd
+rm -rf .cache .devcontainer .git .github .vscode docker docs reflector screenshots systemd
 echo "Matterbridge has been installed from the dev branch."

.devcontainer/install-matterbridge-main.sh

@@ -22,5 +22,5 @@ SHA7=$(git rev-parse --short=7 HEAD) && BASE_VERSION=$(node -p "require('./packa
 npm ci --no-fund --no-audit && npm run build
 cd apps/frontend && npm ci --no-fund --no-audit && npm run build && cd ../..
 npm install . --global --no-fund --no-audit
-rm -rf .cache .devcontainer .git .github .vscode docker docs reflector screenshots scripts systemd
+rm -rf .cache .devcontainer .git .github .vscode docker docs reflector screenshots systemd
 echo "Matterbridge has been installed from the main branch."

.github/workflows/publish.yml

@@ -21,6 +21,8 @@ jobs:
     name: Publish release to npm and trigger matterbridge docker build latest
     if: github.event_name == 'release'
     runs-on: ubuntu-latest
+    env:
+      PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
 
     steps:
       - name: Checkout repository
@@ -74,9 +76,10 @@ jobs:
         run: npm publish
 
       - name: Trigger Matterbridge Docker Build Main
+        if: env.PAT_TOKEN != ''
         uses: actions/github-script@v8
         with:
-          github-token: ${{ secrets.PAT_TOKEN }}
+          github-token: ${{ env.PAT_TOKEN }}
           script: |
             await github.rest.actions.createWorkflowDispatch({
               owner: 'Luligu',
@@ -89,6 +92,8 @@ jobs:
     name: Publish daily dev to npm and trigger matterbridge docker build dev
     if: github.event_name != 'release'
     runs-on: ubuntu-latest
+    env:
+      PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
 
     steps:
       - name: Select branch dev if exists, else default branch
@@ -170,11 +175,11 @@ jobs:
           DATE=$(date -u +'%Y%m%d')
           SHA=$(git rev-parse --short=7 HEAD)
           DEV_TAG="${BASE}-dev-${DATE}-${SHA}"
-          echo "DEV_TAG=$DEV_TAG" >> $GITHUB_ENV
-          echo "ORIG_SHA=$SHA"    >> $GITHUB_ENV
+          echo "dev_tag=$DEV_TAG"   >> $GITHUB_OUTPUT
+          echo "orig_sha=$SHA"      >> $GITHUB_OUTPUT
 
-      - name: Bump to version-dev-date-commit --no-git-tag-version --ignore-scripts tag ${{ env.DEV_TAG }}
-        run: npm version "${{ env.DEV_TAG }}" --no-git-tag-version --ignore-scripts
+      - name: Bump to version-dev-date-commit --no-git-tag-version --ignore-scripts tag ${{ steps.vars.outputs.dev_tag }}
+        run: npm version "${{ steps.vars.outputs.dev_tag }}" --no-git-tag-version --ignore-scripts
 
       - name: Check if a new dev-publish is needed
         id: check_new
@@ -192,7 +197,7 @@ jobs:
           PUBLISHED_SHA=${PUBLISHED##*-}
 
           # 4) get the current commit short-SHA
-          CURRENT_SHA=${ORIG_SHA}
+          CURRENT_SHA=${{ steps.vars.outputs.orig_sha }}
 
           echo "Published dev tag: $PUBLISHED"
           echo "Published SHA: $PUBLISHED_SHA"
@@ -213,10 +218,10 @@ jobs:
         run: npm publish --tag dev
 
       - name: Trigger Matterbridge Docker Build Dev
-        if: steps.check_new.outputs.should_publish  == 'true'
+        if: steps.check_new.outputs.should_publish  == 'true' && env.PAT_TOKEN != ''
         uses: actions/github-script@v8
         with:
-          github-token: ${{ secrets.PAT_TOKEN }}
+          github-token: ${{ env.PAT_TOKEN }}
           script: |
             await github.rest.actions.createWorkflowDispatch({
               owner: 'Luligu',

CHANGELOG.md

@@ -14,6 +14,38 @@ If you like this project and find it useful, please consider giving it a **star*
 
 > For naming issues (especially upsetting with Alexa), read the explanation and the solution [here](https://github.com/Luligu/matterbridge-hass/discussions/86).
 
+## [1.1.0] - 2026-04-10
+
+### Breaking Changes
+
+- [domains] Add `Domain Whitelist` and `Domain Blacklist`.
+
+### Added
+
+- [helpers]: Add `helpers module` to make the platform code easier to read and maintain.
+- [helpers]: Add `payload module` to make the platform code easier to read and maintain.
+- [helpers]: Add `report module` to make the platform code easier to read and maintain.
+- [scripts]: Add script to prune GitHub releases based on tag prefix.
+
+### Changed
+
+- [package]: Update dependencies.
+- [package]: Bump package to `automator` v.3.1.5.
+- [package]: Bump `eslint` to v.10.2.0.
+- [package]: Bump `prettier` to v.3.8.2.
+- [package]: Bump `typescript-eslint` to v.8.58.1.
+- [devcontainer]: Update VS Code settings.
+- [scripts]: Update mb-run script.
+- [entity]: Refactor entity helper signatures to be uniform across all helpers.
+
+### Fixed
+
+- [schema]: Fix controllerStrategy schema.
+- [devcontainer]: Fix pull of new image.
+- [devcontainer]: Fix matterbridge scripts.
+
+<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
+
 ## [1.0.12] - 2026-04-02
 
 ### Breaking Changes

CONTRIBUTING.md

@@ -28,7 +28,7 @@ This guide is intentionally **repository-agnostic** so it can be reused across M
 ## Submitting a Pull Request
 
 - Open a PR from your fork to the upstream repository.
-- Target the correct base branch (`dev` when used, otherwise the default branch).
+- Target the correct base branch (`dev` when used, otherwise the default branch `main`).
 - Keep the PR focused (one feature/fix per PR when possible).
 - Describe what changed and why, and include:
   - Steps to test the change

README.md

@@ -7,10 +7,10 @@
 ![Node.js CI](https://github.com/Luligu/matterbridge-hass/actions/workflows/build.yml/badge.svg)
 ![CodeQL](https://github.com/Luligu/matterbridge-hass/actions/workflows/codeql.yml/badge.svg)
 [![codecov](https://codecov.io/gh/Luligu/matterbridge-hass/branch/main/graph/badge.svg)](https://codecov.io/gh/Luligu/matterbridge-hass)
-[![styled with prettier](https://img.shields.io/badge/styled_with-Prettier-f8bc45.svg?logo=prettier)](https://github.com/prettier/prettier)
-[![linted with eslint](https://img.shields.io/badge/linted_with-ES_Lint-4B32C3.svg?logo=eslint)](https://github.com/eslint/eslint)
+[![styled with prettier](https://img.shields.io/badge/styled_with-Prettier-f8bc45.svg?logo=prettier)](https://prettier.io/)
+[![linted with eslint](https://img.shields.io/badge/linted_with-ES_Lint-4B32C3.svg?logo=eslint)](https://eslint.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![ESM](https://img.shields.io/badge/ESM-Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/api/esm.html)
+[![ESM](https://img.shields.io/badge/ESM-Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 [![matterbridge.io](https://img.shields.io/badge/matterbridge.io-online-brightgreen)](https://matterbridge.io)
 
 [![powered by](https://img.shields.io/badge/powered%20by-matterbridge-blue)](https://www.npmjs.com/package/matterbridge)
@@ -224,6 +224,14 @@ If the blackList is defined the devices, the individual and split entities inclu
 
 List of entities not to be exposed for a single device. Enter in the first field the name of the device and in the second field add all the entity names you want to exclude for that device.
 
+### domain whiteList
+
+Only entities whose domain is listed here will be exposed. Leave this list empty to expose all domains. Enter the domain name (i.e. switch, light, sensor).
+
+### domain blackList
+
+Entities whose domain is listed here will be excluded. Leave this list empty to exclude no domains. Enter the domain name (i.e. automation, scene, button).
+
 ### splitEntities
 
 The device entities in the list will be exposed like an independent device and removed from their device. Use the entity id (i.e. switch.plug_child_lock).

matterbridge-hass.config.json

@@ -1,7 +1,7 @@
 {
   "name": "matterbridge-hass",
   "type": "DynamicPlatform",
-  "version": "0.5.0",
+  "version": "1.0.0",
   "host": "ws://homeassistant.local:8123",
   "certificatePath": "",
   "rejectUnauthorized": false,
@@ -12,6 +12,7 @@
   "filterByLabel": "",
   "whiteList": [],
   "blackList": [],
+  "entityWhiteList": [],
   "entityBlackList": [],
   "deviceEntityBlackList": {},
   "splitEntities": [],

matterbridge-hass.schema.json

@@ -84,17 +84,6 @@
       "uniqueItems": true,
       "selectFrom": "name"
     },
-    "entityBlackList": {
-      "title": "Entity Blacklist",
-      "description": "Not used in this plugin.",
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "uniqueItems": true,
-      "selectEntityFrom": "description",
-      "ui:widget": "hidden"
-    },
     "deviceEntityBlackList": {
       "title": "Device Entity Blacklist",
       "description": "List of entities not to be exposed for a single device. Enter in the first field the name of the device and in the list add all the entity names you want to exclude for that device. This is only related to device entities, not individual entities or split entities.",
@@ -111,6 +100,62 @@
         "selectDeviceEntityFrom": "name"
       }
     },
+    "entityWhiteList": {
+      "title": "Domain Whitelist",
+      "description": "Only entities whose domain is listed here will be exposed. Leave this list empty to expose all domains. Enter the domain name (i.e. switch, light, sensor).",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "automation",
+          "scene",
+          "script",
+          "input_boolean",
+          "input_button",
+          "switch",
+          "light",
+          "lock",
+          "fan",
+          "cover",
+          "climate",
+          "valve",
+          "vacuum",
+          "sensor",
+          "binary_sensor",
+          "event",
+          "button"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "entityBlackList": {
+      "title": "Domain Blacklist",
+      "description": "Entities whose domain is listed here will be excluded. Leave this list empty to exclude no domains. Enter the domain name (i.e. automation, scene, button).",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "automation",
+          "scene",
+          "script",
+          "input_boolean",
+          "input_button",
+          "switch",
+          "light",
+          "lock",
+          "fan",
+          "cover",
+          "climate",
+          "valve",
+          "vacuum",
+          "sensor",
+          "binary_sensor",
+          "event",
+          "button"
+        ]
+      },
+      "uniqueItems": true
+    },
     "splitEntities": {
       "title": "Split Entities",
       "description": "The device entities in the list will be exposed like an independent device and removed from their device. Enter the entity_id (i.e. switch.computer_plug_child_lock). Split entities must satisfy the filters (if any) and the whiteList (if any).",
@@ -135,8 +180,8 @@
       "default": "Entity name"
     },
     "controllerStrategy": {
-      "title": "Strategy used to expose multiple device types. 'Merge' combines non-overlapping device types on the main endpoint. 'Matter' creates a separate endpoint for each device type. Use the Merge strategy for legacy controllers. Changing this setting may require you to pair the controller again.",
-      "description": "Strategy used for controller.",
+      "title": "Controller Strategy",
+      "description": "Strategy used to expose multiple device types. 'Merge' combines non-overlapping device types on the main endpoint. 'Matter' creates a separate endpoint for each device type. Use the Merge strategy for legacy controllers. Changing this setting may require you to pair the controller again.",
       "type": "string",
       "enum": ["Merge", "Matter"],
       "default": "Merge"