python-bsblan 6.1.0__tar.gz → 6.1.2__tar.gz

python_bsblan-6.1.2/.github/agents/pr-review.agent.md

@@ -0,0 +1,39 @@
+---
+description: "Use when reviewing code changes, diffs, or a branch before opening or updating a pull request. Checks that changes are clean, lean, minimal, idiomatic, well-tested, and ready for review. Trigger phrases: review my changes, review the diff, PR review, is this ready to merge, check before pushing."
+name: "PR Reviewer"
+tools: [read, search, execute]
+argument-hint: "What to review (branch, diff, or files) and any specific concerns"
+user-invocable: true
+---
+You are a meticulous code reviewer for the python-bsblan library. Your job is to
+review pending changes and confirm they are clean, lean, and minimal before a
+pull request — nothing more.
+
+## Constraints
+- DO NOT edit, refactor, or write code. You review only; report findings and let the author act.
+- DO NOT suggest features, abstractions, or "improvements" beyond the diff's stated purpose.
+- DO NOT approve changes that add docstrings, comments, or type hints to lines the diff did not already touch.
+- ONLY assess the actual changes (working tree + commits vs the default branch `main`).
+
+## Approach
+1. Establish the diff scope. Run `git fetch` if needed, then `git --no-pager diff main...HEAD` and `git --no-pager diff` to capture committed and uncommitted changes.
+2. Read each changed file's surrounding context so feedback reflects real code, not the diff in isolation.
+3. Evaluate against the checklist below, flagging the smallest set of concrete problems.
+4. Verify the repo quality gate when changes are non-trivial: run `uv run pytest` and confirm coverage stays at 95%+ total with 100% patch coverage (via CI/Codecov), and run `SKIP=no-commit-to-branch uv run prek run --all-files`.
+
+## Review Checklist
+- **Minimal**: every hunk is necessary for the stated goal; no drive-by edits, reformatting, or unrelated files.
+- **Lean**: no dead code, duplication, unused imports/vars, or speculative error handling for cases that can't occur.
+- **Idiomatic**: follows AGENTS.md conventions — type hints, <=88 char lines, `snake_case` params, pydantic for response models, `@dataclass` for set-param payloads, one `/JS` request per populated parameter.
+- **Correct**: logic is sound; edge cases and version gating align with the constants.
+- **Tested**: new behavior has focused tests; patch coverage is 100%.
+- **Docs**: user-visible changes update README/docs/examples to match the code exactly.
+- **Secure**: no secrets, injection risks, or OWASP Top 10 issues.
+
+## Output Format
+Return a single review:
+- **Verdict**: Ready / Needs changes / Blocked.
+- **Must fix**: numbered list, each with `path:line`, the problem, and the minimal fix.
+- **Consider**: optional, lower-priority notes (clearly non-blocking).
+- **Validation**: the commands you ran and their result (pass/fail), or why you skipped them.
+Keep it concise. If the diff is clean, say so plainly without inventing issues.

python_bsblan-6.1.2/.github/agents/tdd-refactor.agent.md

@@ -0,0 +1,97 @@
+---
+description: "Improve code quality, apply security best practices, and enhance design whilst maintaining green tests and GitHub issue compliance."
+name: "TDD Refactor Phase - Improve Quality & Security"
+tools: ["github/*", "search/fileSearch", "edit/editFiles", "execute/runTests", "execute/runInTerminal", "execute/getTerminalOutput", "execute/testFailure", "read/readFile", "read/terminalLastCommand", "read/terminalSelection", "read/problems", "search/codebase"]
+---
+
+# TDD Refactor Phase - Improve Quality & Security
+
+Clean up code, apply security best practices, and enhance design whilst keeping all tests green and maintaining GitHub issue compliance.
+
+## Repository Standards
+Follow `AGENTS.md` for python-bsblan conventions and required validation (at minimum: `uv run prek run --all-files` and `uv run pytest`).
+
+## GitHub Issue Integration
+
+### Issue Completion Validation
+
+- **Verify all acceptance criteria met** - Cross-check implementation against GitHub issue requirements
+- **Update issue status** - Mark issue as completed or identify remaining work
+- **Document design decisions** - Comment on issue with architectural choices made during refactor
+- **Link related issues** - Identify technical debt or follow-up issues created during refactoring
+
+### Quality Gates
+
+- **Definition of Done adherence** - Ensure all issue checklist items are satisfied
+- **Security requirements** - Address any security considerations mentioned in issue
+- **Performance criteria** - Meet any performance requirements specified in issue
+- **Documentation updates** - Update any documentation referenced in issue
+
+## Core Principles
+
+### Code Quality Improvements
+
+- **Remove duplication** - Extract common code into reusable methods or classes
+- **Improve readability** - Use intention-revealing names and clear structure aligned with issue domain
+- **Apply SOLID principles** - Single responsibility, dependency inversion, etc.
+- **Simplify complexity** - Break down large methods, reduce cyclomatic complexity
+
+### Security Hardening
+
+- **Input validation** - Sanitise and validate all external inputs per issue security requirements
+- **Authentication/Authorisation** - Implement proper access controls if specified in issue
+- **Data protection** - Encrypt sensitive data, use secure connection strings
+- **Error handling** - Avoid information disclosure through exception details
+- **Dependency scanning** - Check for vulnerable packages (`npm audit`, `pip audit`, `dotnet list package --vulnerable`, etc.)
+- **Secrets management** - Use environment variables or a secrets manager; never hard-code credentials
+- **OWASP compliance** - Address security concerns mentioned in issue or related security tickets
+
+### Design Excellence
+
+- **Design patterns** - Apply appropriate patterns (Repository, Factory, Strategy, etc.)
+- **Dependency injection** - Use DI container or constructor injection for loose coupling
+- **Configuration management** - Externalise settings using environment variables or config files
+- **Logging and monitoring** - Add structured logging appropriate to your stack for issue troubleshooting
+- **Performance optimisation** - Use async/await or equivalent concurrency primitives, efficient collections, caching
+
+### Language Best Practices (Polyglot)
+
+- **Null safety** - Enable strict null checks (TypeScript), nullable reference types (C#), or Optional types (Java/Kotlin)
+- **Modern language features** - Use pattern matching, destructuring, and idiomatic constructs for your language
+- **Memory & performance** - Apply language-specific optimisations only when profiling reveals a bottleneck
+- **Error handling** - Use specific error/exception types; avoid swallowing errors silently
+
+## Security Checklist
+
+- [ ] Input validation on all public methods
+- [ ] SQL injection prevention (parameterised queries)
+- [ ] XSS protection for web applications
+- [ ] Authorisation checks on sensitive operations
+- [ ] Secure configuration (no secrets in code)
+- [ ] Error handling without information disclosure
+- [ ] Dependency vulnerability scanning
+- [ ] OWASP Top 10 considerations addressed
+
+## Execution Guidelines
+
+1. **Review issue completion** - Ensure GitHub issue acceptance criteria are fully met
+2. **Ensure green tests** - All tests must pass before refactoring
+3. **Confirm your plan with the user** - Ensure understanding of requirements and edge cases. NEVER start making changes without user confirmation
+4. **Small incremental changes** - Refactor in tiny steps, running tests frequently
+5. **Apply one improvement at a time** - Focus on single refactoring technique
+6. **Run security analysis** - Use static analysis tools (SonarQube, Checkmarx)
+7. **Document security decisions** - Add comments for security-critical code
+8. **Update issue** - Comment on final implementation and close issue if complete
+
+## Refactor Phase Checklist
+
+- [ ] GitHub issue acceptance criteria fully satisfied
+- [ ] Code duplication eliminated
+- [ ] Names clearly express intent aligned with issue domain
+- [ ] Methods have single responsibility
+- [ ] Security vulnerabilities addressed per issue requirements
+- [ ] Performance considerations applied
+- [ ] All tests remain green
+- [ ] Code coverage maintained or improved
+- [ ] Issue marked as complete or follow-up issues created
+- [ ] Documentation updated as specified in issue

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/codeql.yaml

@@ -23,10 +23,10 @@ jobs:
       security-events: write
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Initialize CodeQL
-        uses: github/codeql-action/init@9e0d7b8d25671d64c341c19c0152d693099fb5ba # v4.35.5
+        uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2
       - name: 🚀 Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@9e0d7b8d25671d64c341c19c0152d693099fb5ba # v4.35.5
+        uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/dependency-review.yaml

@@ -13,7 +13,7 @@ jobs:
     steps:
       - name: ⤵️ Check out code from GitHub
         # yamllint disable-line rule:line-length
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 👀 Dependency review

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/docs.yaml

@@ -23,11 +23,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/labels.yaml

@@ -21,7 +21,7 @@ jobs:
       issues: write
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🚀 Run Label Syncer

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/linting.yaml

@@ -21,11 +21,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -45,11 +45,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/release.yaml

@@ -25,11 +25,11 @@ jobs:
       id-token: write
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: false
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/scorecard.yml

@@ -34,7 +34,7 @@ jobs:
     steps:
       - name: "Checkout code"
         # yamllint disable-line rule:line-length
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
 
@@ -66,6 +66,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       - name: "Upload to code-scanning"
         # yamllint disable-line rule:line-length
-        uses: github/codeql-action/upload-sarif@9e0d7b8d25671d64c341c19c0152d693099fb5ba # v4.35.5
+        uses: github/codeql-action/upload-sarif@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2
         with:
           sarif_file: results.sarif

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/tests.yaml

@@ -29,11 +29,11 @@ jobs:
         python: ["3.12", "3.13", "3.14"]
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ matrix.python }}
@@ -61,14 +61,14 @@ jobs:
       pull-requests: read
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false
       - name: ⬇️ Download coverage data
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -84,14 +84,14 @@ jobs:
           uv run python -m coverage xml -i
       - name: 🚀 Upload coverage report
         if: env.HAS_CODECOV_TOKEN == 'true'
-        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6.0.1
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
         with:
           fail_ci_if_error: true
           files: coverage.xml
           token: ${{ secrets.CODECOV_TOKEN }}
       - name: 🚀 Upload coverage report (tokenless)
         if: env.HAS_CODECOV_TOKEN != 'true' && github.event_name == 'pull_request'
-        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6.0.1
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
         with:
           fail_ci_if_error: false
           files: coverage.xml

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/.github/workflows/typing.yaml

@@ -22,12 +22,12 @@ jobs:
     steps:
       - name: ⤵️ Check out code from GitHub
         # yamllint disable-line rule:line-length
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
         # yamllint disable-line rule:line-length
-        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bsblan
-Version: 6.1.0
+Version: 6.1.2
 Summary: Asynchronous Python client for BSBLAN API
 Project-URL: Homepage, https://github.com/liudger/python-bsblan
 Project-URL: Repository, https://github.com/liudger/python-bsblan
@@ -83,6 +83,27 @@ asyncio.run(main())
 For more examples, including hot water control, multi-circuit support, and
 authentication setup, see the [Getting Started][docs-getting-started] guide.
 
+## Compatibility
+
+The client automatically detects the device's capabilities during
+`initialize()` and selects a matching configuration based on the BSB-LAN
+JSON-API version reported by the `/JV` endpoint:
+
+- **Full configuration** — JSON-API version 2.0 or newer. All features are
+  available: multiple heating circuits, hot water control, schedules, sensors,
+  and cooling setpoints.
+- **Basic configuration** — JSON-API version 1.x. A reduced, single-circuit
+  configuration covering essential heating, hot water, and sensor parameters.
+
+The JSON-API version is the documented, firmware-independent compatibility
+signal. The adapter firmware version (from `/JI`) is still retrieved and
+exposed via `device_info`, but it is not used to determine support. A device
+that does not expose `/JV`, or reports a JSON-API version below 1.0, is not
+supported and raises `BSBLANVersionError` during `initialize()`.
+
+> Note: basic (JSON-API 1.x) support is best-effort and may not cover every
+> parameter your heating system exposes.
+
 ## Changelog & Releases
 
 This repository keeps a change log using [GitHub's releases][releases]

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/README.md

@@ -51,6 +51,27 @@ asyncio.run(main())
 For more examples, including hot water control, multi-circuit support, and
 authentication setup, see the [Getting Started][docs-getting-started] guide.
 
+## Compatibility
+
+The client automatically detects the device's capabilities during
+`initialize()` and selects a matching configuration based on the BSB-LAN
+JSON-API version reported by the `/JV` endpoint:
+
+- **Full configuration** — JSON-API version 2.0 or newer. All features are
+  available: multiple heating circuits, hot water control, schedules, sensors,
+  and cooling setpoints.
+- **Basic configuration** — JSON-API version 1.x. A reduced, single-circuit
+  configuration covering essential heating, hot water, and sensor parameters.
+
+The JSON-API version is the documented, firmware-independent compatibility
+signal. The adapter firmware version (from `/JI`) is still retrieved and
+exposed via `device_info`, but it is not used to determine support. A device
+that does not expose `/JV`, or reports a JSON-API version below 1.0, is not
+supported and raises `BSBLANVersionError` during `initialize()`.
+
+> Note: basic (JSON-API 1.x) support is best-effort and may not cover every
+> parameter your heating system exposes.
+
 ## Changelog & Releases
 
 This repository keeps a change log using [GitHub's releases][releases]

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/docs/api/models.md

@@ -76,6 +76,10 @@ Data models for BSB-LAN API responses.
 
 ::: bsblan.Device
 
+### ApiVersion
+
+::: bsblan.ApiVersion
+
 ### Info
 
 ::: bsblan.Info

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/docs/getting-started.md

@@ -63,13 +63,37 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
+## Firmware compatibility
+
+On the first request the client lazily runs `initialize()`, which detects the
+device's capabilities and selects a matching configuration based on the BSB-LAN
+JSON-API version reported by the `/JV` endpoint:
+
+- **Full configuration** — JSON-API version 2.0 or newer. All features are
+  available, including multiple heating circuits, hot water control, schedules,
+  sensors, and cooling setpoints.
+- **Basic configuration** — JSON-API version 1.x. A reduced, single-circuit
+  configuration covering essential heating, hot water, and sensor parameters.
+
+The JSON-API version is the documented, firmware-independent compatibility
+signal. The adapter firmware version (from `/JI`) is still retrieved and exposed
+via `device_info`, but it is not used to determine support. A device that does
+not expose `/JV`, or reports a JSON-API version below 1.0, raises
+`BSBLANVersionError`.
+
+Basic (JSON-API 1.x) support is best-effort and may not cover every parameter
+your heating system exposes.
+
 ## Temperature bounds
 
-For heating comfort setpoint writes (`target_temperature`), `min_temp` maps to
-the reduced setpoint (`712` for circuit 1, `1012` for circuit 2). The protective
-setpoints (`714` and `1014`) are exposed separately and are not used as the
-comfort setpoint lower bound. The upper heating bound is `716` for circuit 1 and
-`1016` for circuit 2 when the device exposes those parameters.
+For heating comfort setpoint writes (`target_temperature`), the lower bound is
+the protective (frost) setpoint (`714` for circuit 1, `1014` for circuit 2),
+which allows setpoints down to the frost-protection temperature. The reduced
+setpoint (`712`/`1012`) is exposed as `min_temp` for reference and is used as a
+fallback lower bound only when the protective setpoint is unavailable (for
+example, on PPS devices). The upper heating bound is the comfort maximum (`716`
+for circuit 1 and `1016` for circuit 2) when the device exposes those
+parameters.
 
 ## Cooling setpoint support
 

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/docs/index.md

@@ -9,7 +9,8 @@ Asynchronous Python client for [BSB-LAN](https://github.com/fredlcore/bsb_lan) d
 - Control thermostat settings and hot water parameters
 - Detect optional cooling setpoints for heat/cool range controls
 - Fully typed with PEP 561 support
-- API v3 parameter support
+- Full parameter support, plus basic support for JSON-API 1.x devices
+- Automatic capability detection via the BSB-LAN JSON-API (`/JV`)
 - Lazy loading with per-section validation
 
 ## Quick example

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/examples/control.py

@@ -171,17 +171,24 @@ def print_device_time(device_time: DeviceTime) -> None:
     print_attributes("Device Time", attributes)
 
 
-def print_device_info(device: Device, info: Info) -> None:
+def print_device_info(
+    device: Device,
+    info: Info,
+    json_api_version: str | None = None,
+) -> None:
     """Print device and general information.
 
     Args:
         device (Device): The device information from the BSBLan device.
         info (Info): The general information from the BSBLan device.
+        json_api_version (str | None): The BSB-LAN JSON-API version reported by
+            the ``/JV`` endpoint, if available.
 
     """
     attributes = {
         "Device Name": device.name or "N/A",
         "Version": device.version or "N/A",
+        "JSON-API Version (/JV)": format_optional(json_api_version),
         "Device Identification": get_attribute(info.device_identification),
         "Bus Type": format_optional(device.bus),
         "Bus Writable Flag": format_optional(device.buswritable),
@@ -192,6 +199,22 @@ def print_device_info(device: Device, info: Info) -> None:
     print_attributes("Device Information", attributes)
 
 
+def _first_temperature_attribute(static_state: StaticState) -> Any:
+    """Return the first available temperature attribute for unit detection."""
+    for attribute in (
+        static_state.heating_protective_setpoint,
+        static_state.temp_reduced_setpoint,
+        static_state.comfort_setpoint_max,
+        static_state.min_temp,
+        static_state.max_temp,
+        static_state.cooling_comfort_setpoint_min,
+        static_state.cooling_reduced_setpoint,
+    ):
+        if attribute is not None:
+            return attribute
+    return None
+
+
 def print_static_state(static_state: StaticState) -> None:
     """Print static state information, including heating and cooling bounds.
 
@@ -200,8 +223,10 @@ def print_static_state(static_state: StaticState) -> None:
 
     """
     attributes = {
-        "Min Temperature (heating)": get_attribute(static_state.min_temp),
-        "Max Temperature (heating)": get_attribute(static_state.max_temp),
+        "Reduced Setpoint (eco/night)": get_attribute(
+            static_state.temp_reduced_setpoint
+        ),
+        "Comfort Setpoint Max": get_attribute(static_state.comfort_setpoint_max),
         "Heating Protective Setpoint": get_attribute(
             static_state.heating_protective_setpoint
         ),
@@ -211,7 +236,9 @@ def print_static_state(static_state: StaticState) -> None:
         "Cooling Setpoint Max (reduced)": get_attribute(
             static_state.cooling_reduced_setpoint
         ),
-        "Temperature Unit": get_attribute(static_state.min_temp, "unit"),
+        "Temperature Unit": get_attribute(
+            _first_temperature_attribute(static_state), "unit"
+        ),
     }
     print_attributes("Static State", attributes)
 
@@ -319,7 +346,11 @@ async def main() -> None:
         # Get and print device and general info, including bus metadata
         device: Device = bsblan.device_info or await bsblan.device()
         info: Info = await bsblan.info()
-        print_device_info(device, info)
+        print_device_info(
+            device,
+            info,
+            json_api_version=bsblan.json_api_version,
+        )
 
         # Get and print state
         state: State = await bsblan.state()

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "6.1.0"
+version = "6.1.2"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -196,7 +196,7 @@ dev = [
     # hatch is required to support type hinting and proper packaging of the py.typed file.
     "hatch>=1.14.1",
     "isort==8.0.1",
-    "ty==0.0.40",
+    "ty==0.0.44",
     "prek>=0.3.3",
     "pre-commit-hooks==6.0.0",
     "pylint==4.0.5",
@@ -205,7 +205,7 @@ dev = [
     "pytest-cov==7.1.0",
     "pytest-xdist>=3.8.0",
     "pyupgrade==3.21.2",
-    "ruff==0.15.14",
+    "ruff==0.15.16",
     "safety==3.7.0",
     "vulture==2.16",
     "yamllint==1.38.0",

{python_bsblan-6.1.0 → python_bsblan-6.1.2}/src/bsblan/__init__.py

@@ -8,8 +8,14 @@ from .constants import (
     HVACActionCategory,
     get_hvac_action_category,
 )
-from .exceptions import BSBLANAuthError, BSBLANConnectionError, BSBLANError
+from .exceptions import (
+    BSBLANAuthError,
+    BSBLANConnectionError,
+    BSBLANError,
+    BSBLANVersionError,
+)
 from .models import (
+    ApiVersion,
     DaySchedule,
     Device,
     DeviceTime,
@@ -34,10 +40,12 @@ __all__ = [
     "BSBLAN",
     "UNIT_DEVICE_CLASS_MAP",
     "UNIT_STATE_CLASS_MAP",
+    "ApiVersion",
     "BSBLANAuthError",
     "BSBLANConfig",
     "BSBLANConnectionError",
     "BSBLANError",
+    "BSBLANVersionError",
     "DHWSchedule",
     "DHWTimeSwitchPrograms",
     "DaySchedule",