v2.3.0: OpenHarmony compatibility + Recovery hardening

- Replace ES2020 0n BigInt literals with BigInt(0) in the TypeScript
  wrapper so the same bqlog package on ohpm works on OpenHarmony 4.1+
  (API 11+) as well as HarmonyOS NEXT - no separate package needed.
- Strengthen data validation during recovery to detect malformed entries
  earlier and avoid potential crashes when consuming a corrupted ring buffer.
- Bump version to 2.3.0; refresh README/CHANGELOG and integration guide
  to note HarmonyOS / OpenHarmony share the same package.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: pippocao

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## [v2.3.0] - 2026-06-03
+- **OpenHarmony compatibility**: Replaced ES2020 `0n` BigInt literals with `BigInt(0)` in the TypeScript wrapper so the same `bqlog` package on ohpm works on **OpenHarmony 4.1+ (API 11+)** as well as HarmonyOS NEXT — no separate package needed.
+- **Recovery hardening**: Strengthened data validation during recovery to detect malformed entries earlier and avoid potential crashes when consuming a corrupted ring buffer.
+
 ## [v2.2.9] - 2026-05-06
 - **Compatibility**: Improved code compatibility with earlier Clang toolchains and frameworks such as MFC.
 - **Compatibility**: Improved code compatibility across all supported Unreal Engine versions.

README.md

@@ -2,17 +2,17 @@
   <img src="banner.jpg" alt="BqLog Banner" width="100%">
 </p>
 
-# BqLog (BianQue Log) V 2.2.9
+# BqLog (BianQue Log) V 2.3.0
 
 **English** | [简体中文](./README_CHS.md)
 
 [![license](https://img.shields.io/badge/license-APACHE2.0-brightgreen.svg?style=flat)](LICENSE.txt)
-[![Release Version](https://img.shields.io/badge/release-2.2.9-red.svg)](https://github.com/Tencent/BqLog/releases)
-[![ChangeLog](https://img.shields.io/badge/📋_ChangeLog-v2.2.9-orange.svg?style=flat)](CHANGELOG.md)
+[![Release Version](https://img.shields.io/badge/release-2.3.0-red.svg)](https://github.com/Tencent/BqLog/releases)
+[![ChangeLog](https://img.shields.io/badge/📋_ChangeLog-v2.3.0-orange.svg?style=flat)](CHANGELOG.md)
 [![GitHub Stars](https://img.shields.io/github/stars/Tencent/BqLog?style=flat&logo=github)](https://github.com/Tencent/BqLog/stargazers)
 [![GitHub Forks](https://img.shields.io/github/forks/Tencent/BqLog?style=flat&logo=github)](https://github.com/Tencent/BqLog/network/members)
 [![GitHub Issues](https://img.shields.io/github/issues/Tencent/BqLog?style=flat&logo=github)](https://github.com/Tencent/BqLog/issues)
-[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20iOS%20%7C%20Android%20%7C%20HarmonyOS%20%7C%20Unix-lightgrey.svg?style=flat)]()
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20iOS%20%7C%20Android%20%7C%20HarmonyOS%20%7C%20OpenHarmony%20%7C%20Unix-lightgrey.svg?style=flat)]()
 [![Language](https://img.shields.io/badge/language-C%2B%2B%20%7C%20Java%20%7C%20C%23%20%7C%20Kotlin%20%7C%20TypeScript%20%7C%20Python-blue.svg?style=flat)]()
 
 > BqLog is a lightweight, high-performance, industrial-grade logging system that has been widely used in online projects such as "Honor of Kings".
@@ -22,12 +22,12 @@
 
 ---
 
-[![Download](https://img.shields.io/badge/⬇_Download-Release_2.2.9-blue.svg?style=for-the-badge)](https://github.com/Tencent/BqLog/releases/tag/Release_2.2.9)
+[![Download](https://img.shields.io/badge/⬇_Download-Release_2.3.0-blue.svg?style=for-the-badge)](https://github.com/Tencent/BqLog/releases/tag/Release_2.3.0)
 
-## 📋 What's New in v2.2.9
+## 📋 What's New in v2.3.0
 
-- **Compatibility** — Improved code compatibility with earlier Clang toolchains and frameworks such as MFC.
-- **Compatibility** — Improved code compatibility across all supported Unreal Engine versions.
+- **OpenHarmony compatibility** — Replaced `0n` BigInt literals with `BigInt(0)` in the TypeScript wrapper. The same `bqlog` package on ohpm now works on **OpenHarmony 4.1+ (API 11+)** as well as HarmonyOS NEXT.
+- **Recovery hardening** — Strengthened data validation during recovery to detect malformed entries earlier and avoid potential crashes when consuming a corrupted ring buffer.
 
 > Full changelog → [CHANGELOG.md](CHANGELOG.md)
 
@@ -67,7 +67,7 @@
 
 | Platforms | Languages |
 |-----------|-----------|
-| Windows 64-bit, macOS, Linux (incl. embedded), iOS, Android, HarmonyOS, Unix (FreeBSD, NetBSD, OpenBSD, Solaris, etc.) | C++ (C++11+), Java / Kotlin, C# (Unity, .NET), ArkTS / C++ (HarmonyOS), JavaScript / TypeScript (Node.js), Python 3.7+, Unreal Engine (UE4 & UE5) |
+| Windows 64-bit, macOS, Linux (incl. embedded), iOS, Android, HarmonyOS, OpenHarmony, Unix (FreeBSD, NetBSD, OpenBSD, Solaris, etc.) | C++ (C++11+), Java / Kotlin, C# (Unity, .NET), ArkTS / C++ (HarmonyOS & OpenHarmony share the same package), JavaScript / TypeScript (Node.js), Python 3.7+, Unreal Engine (UE4 & UE5) |
 
 **Hardware architectures**: x86, x86_64, ARM32, ARM64
 **Integration methods**: Dynamic library, Static library, Source code
@@ -160,7 +160,9 @@ my_log.info("Hello from Python! params: {}, {}", "text", 123)
 log.force_flush_all_logs()
 ```
 
-### TypeScript (HarmonyOS ArkTS)
+### TypeScript (HarmonyOS / OpenHarmony ArkTS)
+
+> The same `bqlog` package on ohpm works for both **HarmonyOS** (NEXT) and **OpenHarmony** (4.1+ / API 11+). Same install, same import, same code.
 
 ```typescript
 import { bq } from "bqlog";
@@ -169,7 +171,7 @@ const config = `
     appenders_config.console.levels=[all]
 `;
 const log = bq.log.create_log("ohos_log", config);
-log.info("Hello from HarmonyOS! params: {}, {}", "text", 123);
+log.info("Hello from HarmonyOS / OpenHarmony! params: {}, {}", "text", 123);
 bq.log.force_flush_all_logs();
 ```
 

README_CHS.md

@@ -2,17 +2,17 @@
   <img src="banner.jpg" alt="BqLog Banner" width="100%">
 </p>
 
-# BqLog (扁鹊日志) V 2.2.9
+# BqLog (扁鹊日志) V 2.3.0
 
 [English](./README.md) | **简体中文**
 
 [![license](https://img.shields.io/badge/license-APACHE2.0-brightgreen.svg?style=flat)](LICENSE.txt)
-[![Release Version](https://img.shields.io/badge/release-2.2.9-red.svg)](https://github.com/Tencent/BqLog/releases)
-[![ChangeLog](https://img.shields.io/badge/📋_更新日志-v2.2.9-orange.svg?style=flat)](CHANGELOG.md)
+[![Release Version](https://img.shields.io/badge/release-2.3.0-red.svg)](https://github.com/Tencent/BqLog/releases)
+[![ChangeLog](https://img.shields.io/badge/📋_更新日志-v2.3.0-orange.svg?style=flat)](CHANGELOG.md)
 [![GitHub Stars](https://img.shields.io/github/stars/Tencent/BqLog?style=flat&logo=github)](https://github.com/Tencent/BqLog/stargazers)
 [![GitHub Forks](https://img.shields.io/github/forks/Tencent/BqLog?style=flat&logo=github)](https://github.com/Tencent/BqLog/network/members)
 [![GitHub Issues](https://img.shields.io/github/issues/Tencent/BqLog?style=flat&logo=github)](https://github.com/Tencent/BqLog/issues)
-[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20iOS%20%7C%20Android%20%7C%20HarmonyOS%20%7C%20Unix-lightgrey.svg?style=flat)]()
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20iOS%20%7C%20Android%20%7C%20HarmonyOS%20%7C%20OpenHarmony%20%7C%20Unix-lightgrey.svg?style=flat)]()
 [![Language](https://img.shields.io/badge/language-C%2B%2B%20%7C%20Java%20%7C%20C%23%20%7C%20Kotlin%20%7C%20TypeScript%20%7C%20Python-blue.svg?style=flat)]()
 
 > BqLog 是一个轻量级、高性能的工业级日志系统，已在线上广泛应用于《王者荣耀》等项目。
@@ -22,12 +22,12 @@
 
 ---
 
-[![Download](https://img.shields.io/badge/⬇_下载-Release_2.2.9-blue.svg?style=for-the-badge)](https://github.com/Tencent/BqLog/releases/tag/Release_2.2.9)
+[![Download](https://img.shields.io/badge/⬇_下载-Release_2.3.0-blue.svg?style=for-the-badge)](https://github.com/Tencent/BqLog/releases/tag/Release_2.3.0)
 
-## 📋 v2.2.9 更新亮点
+## 📋 v2.3.0 更新亮点
 
-- **兼容性优化** — 改进对早期 Clang 工具链以及 MFC 等框架的代码兼容性。
-- **兼容性优化** — 完善对 Unreal Engine 各版本的代码兼容性。
+- **OpenHarmony 兼容性** — 把 TypeScript Wrapper 中的 `0n` BigInt 字面量替换为 `BigInt(0)`，ohpm 上同一个 `bqlog` 包现已可在 **OpenHarmony 4.1+（API 11+）** 和 HarmonyOS NEXT 上通用，无需单独发包。
+- **Recovery 加固** — 强化 Recovery 过程中的数据校验，能更早识别异常 entry，避免读取损坏 ring buffer 时潜在的 Crash。
 
 > 完整更新日志 → [CHANGELOG.md](CHANGELOG.md)
 
@@ -68,7 +68,7 @@
 
 | 平台 | 语言 |
 |------|------|
-| Windows 64-bit、macOS、Linux（含嵌入式）、iOS、Android、HarmonyOS、Unix（FreeBSD、NetBSD、OpenBSD、Solaris 等） | C++（C++11+）、Java / Kotlin、C#（Unity、.NET）、ArkTS / C++（HarmonyOS）、JavaScript / TypeScript（Node.js）、Python 3.7+、Unreal Engine（UE4 & UE5） |
+| Windows 64-bit、macOS、Linux（含嵌入式）、iOS、Android、HarmonyOS、OpenHarmony、Unix（FreeBSD、NetBSD、OpenBSD、Solaris 等） | C++（C++11+）、Java / Kotlin、C#（Unity、.NET）、ArkTS / C++（HarmonyOS 与 OpenHarmony 同一份包）、JavaScript / TypeScript（Node.js）、Python 3.7+、Unreal Engine（UE4 & UE5） |
 
 **硬件架构**：x86、x86_64、ARM32、ARM64
 **引入方式**：动态库、静态库、源代码
@@ -161,7 +161,9 @@ my_log.info("Hello from Python! params: {}, {}", "text", 123)
 log.force_flush_all_logs()
 ```
 
-### TypeScript (鸿蒙 ArkTS)
+### TypeScript (鸿蒙 / OpenHarmony ArkTS)
+
+> 同一个 ohpm 上的 `bqlog` 包同时适用于 **HarmonyOS**（NEXT）和 **OpenHarmony**（4.1+ / API 11+）。安装、引用、API 完全一致。
 
 ```typescript
 import { bq } from "bqlog";
@@ -170,7 +172,7 @@ const config = `
     appenders_config.console.levels=[all]
 `;
 const log = bq.log.create_log("ohos_log", config);
-log.info("Hello from HarmonyOS! params: {}, {}", "text", 123);
+log.info("Hello from HarmonyOS / OpenHarmony! params: {}, {}", "text", 123);
 bq.log.force_flush_all_logs();
 ```
 

demo/nodejs/src/demo_category_log.ts

@@ -132,11 +132,11 @@
                 if (result.get_categories_count() != demo_category_log.categories_count) {
                     console.log("expected:" + demo_category_log.categories_count + ", but:" + result.get_categories_count());
 
-                    return new demo_category_log(0n);
+                    return new demo_category_log(BigInt(0));
                 }
                 for (let i = 0; i < result.get_categories_count(); ++i) {
                     if (demo_category_log.category_names[i] != demo_category_log.category_names[i]) {
-                        return new demo_category_log(0n);
+                        return new demo_category_log(BigInt(0));
                     }
                 }
                 return result;

docs/INTEGRATION_GUIDE.md

@@ -173,7 +173,9 @@ target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE
 
 ---
 
-## HarmonyOS (ArkTS / C++)
+## HarmonyOS / OpenHarmony (ArkTS / C++)
+
+> **HarmonyOS NEXT** and **OpenHarmony** (4.1+ / API 11+) share the **same** `bqlog` package on ohpm. The native `.so` is binary-compatible across both runtimes, and the ArkTS wrapper uses only common APIs. No separate package or build is needed.
 
 ### Integration
 
@@ -201,7 +203,7 @@ target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE
   }
   ```
 
-Supports direct calling from ArkTS side, also supports calling from Native C++ side.
+Supports direct calling from ArkTS side, also supports calling from Native C++ side. Works identically on HarmonyOS NEXT and OpenHarmony.
 
 ### C++ (Native) usage
 

docs/INTEGRATION_GUIDE_CHS.md

@@ -174,7 +174,9 @@ target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE
 
 ---
 
-## HarmonyOS（ArkTS / C++）
+## HarmonyOS / OpenHarmony（ArkTS / C++）
+
+> **HarmonyOS NEXT** 和 **OpenHarmony**（4.1+ / API 11+）共用 ohpm 上**同一个** `bqlog` 包：底层 `.so` 在两边二进制兼容，ArkTS Wrapper 只用公共 API，**不需要单独发包或单独配置**。
 
 ### 集成方式
 
@@ -202,7 +204,7 @@ target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE
   }
   ```
 
-支持在 ArkTS 侧直接调用，也支持在 Native C++ 侧调用。
+支持在 ArkTS 侧直接调用，也支持在 Native C++ 侧调用。**HarmonyOS NEXT 和 OpenHarmony 上行为一致，使用方式完全相同。**
 
 ### C++（Native）使用方式
 

src/bq_log/global/version.cpp

@@ -10,7 +10,7 @@
  */
 #include "bq_log/global/version.h"
 namespace bq {
-    const char* const BQ_LOG_VERSION = "2.2.9";
+    const char* const BQ_LOG_VERSION = "2.3.0";
 
     const char* get_bq_log_version()
     {

test/typescript/src/bq/test/test_category_log.ts

@@ -102,11 +102,11 @@
                 if (result.get_categories_count() != test_category_log.categories_count) {
                     console.log("expected:" + test_category_log.categories_count + ", but:" + result.get_categories_count());
 
-                    return new test_category_log(0n);
+                    return new test_category_log(BigInt(0));
                 }
                 for (let i = 0; i < result.get_categories_count(); ++i) {
                     if (test_category_log.category_names[i] != test_category_log.category_names[i]) {
-                        return new test_category_log(0n);
+                        return new test_category_log(BigInt(0));
                     }
                 }
                 return result;

test/typescript/src/bq/test/test_log_2.ts

@@ -74,7 +74,7 @@ export class test_log_2 extends test_base {
                     `);
         bq.log.set_console_buffer_enable(false);
         bq.log.register_console_callback((log_id: bigint, category_idx: number, log_level: any, content: string) => {
-            if(log_id != 0n)
+            if(log_id != BigInt(0))
             {
                 result.add_result(log_id == log_inst_console.get_id(), "console callback test 1");
                 result.add_result(log_level == bq.log_level.debug, "console callback test 2");

wrapper/typescript/src/bq/category_log.ts

@@ -47,7 +47,7 @@ export class category_log extends log {
      */
     protected static call_api_create_category_log(name: string, config: string, categories_count: number, categories: string[] | null): bigint {
         if (!config || config.length == 0) {
-            return 0n;
+            return BigInt(0);
         }
         let log_handle: bigint = log_invoker.__api_create_log(name, config, categories_count, categories);
         return log_handle;