Upgrade package

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: Luligu

.codex/config.toml

@@ -1,14 +1,16 @@
-# Codex config v.1.0.3
+# Codex config.toml v.1.0.4
 
 approval_policy = "on-request"
+
 approvals_reviewer = "user"
 
 web_search = "live"
 
-default_permissions = ":workspace"
+default_permissions = "matterbridge_safe"
 
 [shell_environment_policy]
 inherit = "core"
+ignore_default_excludes = false
 
 [windows]
 sandbox = "elevated"
@@ -21,7 +23,7 @@ extends = ":workspace"
 enabled = false
 
 [permissions.matterbridge_safe.filesystem]
-glob_scan_max_depth = 4
+glob_scan_max_depth = 5
 
 [permissions.matterbridge_safe.filesystem.":workspace_roots"]
 ".env" = "deny"

.devcontainer/Dockerfile

@@ -0,0 +1,34 @@
+# .devcontainer/Dockerfile v.1.2.0
+
+# This Dockerfile is used to build a development container for Node.js applications.
+# It is based on the official Node.js Docker image and includes additional tools and configurations for a better development experience.
+# Bun is installed.
+# Bash history is configured to be synced across terminals.
+
+FROM node:24-trixie-slim
+
+ENV BUN_INSTALL=/home/node/.bun
+ENV PATH=${BUN_INSTALL}/bin:${PATH}
+ENV HISTFILE=/home/node/.bash-cache/.bash_history
+ENV HISTSIZE=100000
+ENV HISTFILESIZE=200000
+
+RUN apt-get update \
+  && apt-get install --yes --no-install-recommends ca-certificates curl git procps ripgrep sudo unzip bubblewrap \
+  && curl --fail --location --silent --show-error https://bun.sh/install | bash \
+  && mkdir -p /home/node/.bash-cache \
+  && { \
+    echo ''; \
+    echo '# Keep Bash history synced across terminals.'; \
+    echo 'shopt -s histappend'; \
+    echo '__sync_history() {'; \
+    echo '  history -a'; \
+    echo '  history -n'; \
+    echo '}'; \
+    echo 'PROMPT_COMMAND="__sync_history${PROMPT_COMMAND:+;$PROMPT_COMMAND}"'; \
+  } >> /home/node/.bashrc \
+  && chown -R node:node "$BUN_INSTALL" \
+  && chown -R node:node /home/node/.bash-cache /home/node/.bashrc \
+  && echo "node ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/node \
+  && chmod 0440 /etc/sudoers.d/node \
+  && rm -rf /var/lib/apt/lists/*

.devcontainer/devcontainer.json

@@ -1,4 +1,4 @@
-// .devcontainer/devcontainer.json v. 1.0.5
+// .devcontainer/devcontainer.json v.1.2.0
 
 // This file defines the development container configuration for a Matterbridge Plugin.
 
@@ -32,43 +32,59 @@ Dev containers have networking limitations depending on the host OS and Docker s
 {
   // Name of the dev container
   "name": "Matterbridge Plugin Dev Container",
-  // Use the Microsoft pre-built image with Debian (Trixie) and Node.js 24 for a consistent and optimized development environment
-  "image": "mcr.microsoft.com/devcontainers/javascript-node:24-trixie",
+  "build": {
+    "dockerfile": "Dockerfile"
+  },
   // Inherit timezone from the host environment (set TZ on the host, e.g. Europe/Paris)
   "containerEnv": {
     "TZ": "${localEnv:TZ}"
   },
   // Use the non-root node user (passwordless sudo in this image)
   "remoteUser": "node",
-  // Mount the local matterbridge and node_modules workspace folder to the container's workspace volumes to improve performance
   "mounts": [
+    // Package specific volumes for node_modules, .cache, Matterbridge .matterbridge, .mattercert to improve performance
     "source=${localWorkspaceFolderBasename}-node_modules,target=${containerWorkspaceFolder}/node_modules,type=volume",
     "source=${localWorkspaceFolderBasename}-cache,target=${containerWorkspaceFolder}/.cache,type=volume",
     "source=${localWorkspaceFolderBasename}-plugins,target=/home/node/Matterbridge,type=volume",
     "source=${localWorkspaceFolderBasename}-storage,target=/home/node/.matterbridge,type=volume",
     "source=${localWorkspaceFolderBasename}-cert,target=/home/node/.mattercert,type=volume",
+    // Dev container shared volumes for matterbridge, npm cache, bun cache, bash history, claude, codex and agents to improve performance
     "source=matterbridge,target=/matterbridge,type=volume",
+    "source=npm-cache,target=/home/node/.npm,type=volume",
+    "source=bun-cache,target=/home/node/.bun/install/cache,type=volume",
+    "source=bash-cache,target=/home/node/.bash-cache,type=volume",
     "source=claude,target=/home/node/.claude,type=volume",
     "source=codex,target=/home/node/.codex,type=volume",
     "source=agents,target=/home/node/.agents,type=volume"
   ],
-  // 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)
-  "postStartCommand": "bash .devcontainer/postStartCommand.sh",
+  // Set up the Docker environment (runs on the host before the container starts)
+  "initializeCommand": "bash .devcontainer/initialize.sh",
+  // On create, prepare the directories, install and link the dev of matterbridge and install and build the plugin (runs inside the container)
+  "postCreateCommand": "bash .devcontainer/post-create.sh",
+  // On start, install and build the plugin (runs inside the container)
+  "postStartCommand": "bash .devcontainer/post-start.sh",
   "runArgs": [
     // Give the Docker container the same name as the repository (must be unique on host)
     "--name",
     "${localWorkspaceFolderBasename}",
+    // OpenAI sandbox requisites (https://learn.chatgpt.com/docs/sandboxing?surface=cli)
+    "--security-opt",
+    "seccomp=unconfined",
     // Use network host mode if on Docker Engine on Linux or WSL 2 to allow full local network access and mDNS support
     // "--network=host"
     // Use a shared bridge network to allow to access other containers with their names (dns resolution). With the default bridge, dns resolution does not work (only ip:port).
     "--network=matterbridge"
   ],
   // Publish the Matterbridge UI port on the Docker host (so http://localhost:8283 works even without VS Code port forwarding)
-  "appPort": [8283],
+  "forwardPorts": [8283],
+  "portsAttributes": {
+    "8283": {
+      "label": "Matterbridge frontend"
+    }
+  },
+  "otherPortsAttributes": {
+    "onAutoForward": "ignore"
+  },
   "customizations": {
     "vscode": {
       // Extensions to install in the dev container
@@ -83,75 +99,8 @@ Dev containers have networking limitations depending on the host OS and Docker s
         "github.vscode-pull-request-github",
         "openai.chatgpt"
       ],
-      // Settings for the VS Code environment
+      // Settings for the VS Code environment specific to the dev container (overrides user and workspace settings)
       "settings": {
-        // Default .vscode/settings.json
-        "eslint.enable": false,
-        "prettier.enable": false,
-        "oxc.enable": true,
-        "js/ts.experimental.useTsgo": true,
-        "js/ts.tsdk.promptToUseWorkspaceVersion": false,
-        "terminal.integrated.scrollback": 1000,
-        "editor.tabSize": 2,
-        "editor.rulers": [180],
-        "editor.formatOnSave": false,
-        "editor.defaultFormatter": "oxc.oxc-vscode",
-        "[javascript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
-        "[typescript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
-        "[json]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
-        "[jsonc]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
-        "[markdown]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
-        "editor.formatOnSaveMode": "file",
-        "editor.codeActionsOnSave": {
-          "source.format.oxc": "always",
-          "source.fixAll.oxc": "always"
-        },
-        "diffEditor.ignoreTrimWhitespace": false,
-        "files.eol": "\n",
-        "files.insertFinalNewline": true,
-        "files.trimFinalNewlines": true,
-        "files.trimTrailingWhitespace": true,
-        "files.watcherExclude": {
-          "**/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,
-        // VS Code's Copilot Chat extension settings
-        "chat.useCustomizationsInParentRepositories": true, // Default false.
-        "chat.tools.terminal.autoApprove": {
-          "npx tsc": true,
-          "npx oxlint": true,
-          "npx oxfmt": true,
-          "npx vitest": true,
-          "npm run": true,
-          "npm run build": true,
-          "npm run typecheck": true,
-          "npm run lint": true,
-          "npm run format:check": true,
-          "npm run test": true,
-          "npm run test:coverage": true,
-          "npm run update-htmls": true,
-          "git status": true,
-          "git diff": true,
-          "git diff --check": true,
-          "git diff --stat": true,
-          "git log": true,
-          "git show": true,
-          "git branch -vv": true,
-          "git ls-files": true,
-          "git --no-pager diff --stat": true,
-          "git --no-pager diff --check": true
-        },
-        // Dev Container specific settings
         "terminal.integrated.defaultProfile.linux": "bash",
         "js/ts.tsserver.watchOptions": {
           "watchFile": "dynamicPriorityPolling",

.devcontainer/initialize.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+# .devcontainer/initialize.sh v.1.2.0
+
+# This script runs on the host before the Dev Container is created to set up the Docker environment.
+
+set -euo pipefail
+
+echo "Welcome to Matterbridge Plugin Dev Container (initialize.sh)"
+echo ""
+
+echo "1.initialize - Creating the Matterbridge Docker network..."
+docker network inspect matterbridge >/dev/null 2>&1 || docker network create matterbridge
+
+echo "2.initialize - Pulling the base image..."
+docker pull node:24-trixie-slim
+
+echo "3.initialize - Initialization completed!"

.devcontainer/install-matterbridge-dev.sh

@@ -1,26 +1,43 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
-# install-matterbridge-dev.sh
+# .devcontainer/install-matterbridge-dev.sh v.1.2.0
 
 # This script globally installs Matterbridge from the dev branch.
 # To be used only inside the Dev Container with the mounted matterbridge volume.
 
-echo "Installing Matterbridge from the dev branch..."
-set -e
+set -euo pipefail
+
+echo "1.install-matterbridge-dev - Installing Matterbridge from the dev branch..."
 cd /
 if [ ! -d "/workspaces" ]; then
   echo "Directory /workspaces does not exist. Exiting."
   exit 1
 fi
+
+echo "2.install-matterbridge-dev - Preparing Matterbridge directory..."
 sudo chown -R node:node matterbridge
 sudo chmod g+s matterbridge
 sudo rm -rf matterbridge/* matterbridge/.[!.]* matterbridge/..?*
+
+echo "3.install-matterbridge-dev - Cloning Matterbridge from the dev branch..."
 # Shallow clone for speed (history not needed inside dev container). Remove --depth if full history required.
 git clone --depth 1 --single-branch --no-tags -b dev https://github.com/Luligu/matterbridge.git matterbridge
 cd matterbridge
+
+echo "4.install-matterbridge-dev - Setting Matterbridge version..."
 SHA7=$(git rev-parse --short=7 HEAD) && BASE_VERSION=$(node -p "require('./package.json').version.split('-')[0]") && npm pkg set version="${BASE_VERSION}-git-${SHA7}"
+
+echo "5.install-matterbridge-dev - Installing Matterbridge dependencies and building..."
 npm ci --no-fund --no-audit && npm run build
+# bun install --no-fund --no-audit && bun run build
+
+echo "6.install-matterbridge-dev - Building Matterbridge frontend..."
 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 systemd
-echo "Matterbridge has been installed from the dev branch."
+# cd apps/frontend && bun install --no-fund --no-audit && bun run build && cd ../..
+
+echo "7.install-matterbridge-dev - Installing Matterbridge globally..."
+sudo npm install . --global --no-fund --no-audit
+# bun link
+sudo rm -rf .agents .cache .claude .codex .devcontainer .git .github .vscode docker docs reflector screenshots scripts systemd
+
+echo "8.install-matterbridge-dev - Matterbridge has been installed from the dev branch."

.devcontainer/install-matterbridge-main.sh

@@ -1,26 +1,43 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
-# install-matterbridge-dev.sh
+# .devcontainer/install-matterbridge-main.sh v.1.2.0
 
 # This script globally installs Matterbridge from the main branch.
 # To be used only inside the Dev Container with the mounted matterbridge volume.
 
-echo "Installing Matterbridge from the main branch..."
-set -e
+set -euo pipefail
+
+echo "1.install-matterbridge-main - Installing Matterbridge from the main branch..."
 cd /
 if [ ! -d "/workspaces" ]; then
   echo "Directory /workspaces does not exist. Exiting."
   exit 1
 fi
+
+echo "2.install-matterbridge-main - Preparing Matterbridge directory..."
 sudo chown -R node:node matterbridge
 sudo chmod g+s matterbridge
 sudo rm -rf matterbridge/* matterbridge/.[!.]* matterbridge/..?*
+
+echo "3.install-matterbridge-main - Cloning Matterbridge from the main branch..."
 # Shallow clone for speed (history not needed inside dev container). Remove --depth if full history required.
 git clone --depth 1 --single-branch --no-tags https://github.com/Luligu/matterbridge.git matterbridge
 cd matterbridge
+
+echo "4.install-matterbridge-main - Setting Matterbridge version..."
 SHA7=$(git rev-parse --short=7 HEAD) && BASE_VERSION=$(node -p "require('./package.json').version.split('-')[0]") && npm pkg set version="${BASE_VERSION}-git-${SHA7}"
+
+echo "5.install-matterbridge-main - Installing Matterbridge dependencies and building..."
 npm ci --no-fund --no-audit && npm run build
+# bun install --no-fund --no-audit && bun run build
+
+echo "6.install-matterbridge-main - Building Matterbridge frontend..."
 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 systemd
-echo "Matterbridge has been installed from the main branch."
+# cd apps/frontend && bun install --no-fund --no-audit && bun run build && cd ../..
+
+echo "7.install-matterbridge-main - Installing Matterbridge globally..."
+sudo npm install . --global --no-fund --no-audit
+# bun link
+sudo rm -rf .agents .cache .claude .codex .devcontainer .git .github .vscode docker docs reflector screenshots scripts systemd
+
+echo "8.install-matterbridge-main - Matterbridge has been installed from the main branch."

.devcontainer/post-create.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+
+# .devcontainer/post-create.sh v.1.2.0
+
+# This script runs after the Dev Container is created to set up the dev container environment.
+
+set -euo pipefail
+
+echo "Welcome to Matterbridge Plugin Dev Container (post-create.sh)"
+DISTRO=$(awk -F= '/^PRETTY_NAME=/{gsub(/"/, "", $2); print $2}' /etc/os-release)
+CODENAME=$(awk -F= '/^VERSION_CODENAME=/{print $2}' /etc/os-release)
+echo "Distro: $DISTRO ($CODENAME)"
+echo "User: $(whoami)"
+echo "Hostname: $(hostname)"
+echo "Architecture: $(uname -m)"
+echo "Kernel Version: $(uname -r)"
+echo "Uptime: $(uptime -p || echo 'unavailable')"
+echo "Date: $(date)"
+echo "Node.js version: $(node -v)"
+echo "Npm version: $(npm -v)"
+echo "Npm cache: $(npm config get cache)"
+echo "Bun version: $(bun -v)"
+echo "Bun global cache: ${HOME}/.bun/install/cache"
+echo ""
+
+echo "1.post-create - Creating directories..."
+sudo mkdir -p /home/node/Matterbridge /home/node/.matterbridge /home/node/.mattercert
+sudo mkdir -p /home/node/.claude /home/node/.codex /home/node/.agents /home/node/.npm /home/node/.bash-cache /home/node/.bun/install/cache
+
+echo "2.post-create - Setting permissions..."
+sudo chown -R node:node . /home/node/Matterbridge /home/node/.matterbridge /home/node/.mattercert
+sudo chown -R node:node /home/node/.claude /home/node/.codex /home/node/.agents /home/node/.npm /home/node/.bash-cache /home/node/.bun
+
+echo "3.post-create - Building Matterbridge..."
+sudo chmod +x .devcontainer/install-matterbridge-*.sh
+# Use this for the main branch:
+# .devcontainer/install-matterbridge-main.sh
+# Use this for the dev branch:
+.devcontainer/install-matterbridge-dev.sh
+
+echo "4.post-create - Installing the plugin dependencies..."
+npm install --no-fund --no-audit
+
+echo "5.post-create - Linking Matterbridge..."
+if ! npm link matterbridge --no-fund --no-audit; then
+	echo "Retrying link with elevated permissions..."
+	sudo npm link matterbridge --no-fund --no-audit
+	sudo chown -R node:node ./node_modules
+fi
+
+echo "6.post-create - Building the plugin..."
+npm run build
+
+echo "7.post-create - Adding the plugin to Matterbridge..."
+npm run add
+
+echo "8.post-create - Checking for outdated packages..."
+npm outdated || true
+
+echo "9.post-create - Post create setup completed!"