Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Proposal: use the chdb npm package instead of direct libchdb FFI

Đang mở
  • Có gì không ổn?
#789 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@ShawnChen-Sirius đang làm issue này rồi.

Từ ngày 7/9/2026.

  • #791 của @ShawnChen-Sirius — đang mở

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
nodejs, typescript
Lĩnh vực
backend, infrastructure

Hướng nghiên cứu

Start by tracing Maple's direct FFI integration with libchdb.so and compare it with the official chdb npm package (chdb-node). Check the open pull request #791 before starting, since it may already cover this proposal. Done means the internal access path uses chdb-node while Maple's existing UI/API behavior and local chDB support remain unchanged; durable mode is explicitly out of scope.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Maple currently talks to chDB through direct FFI against libchdb.so. That works, but it means Maple has to maintain its own native loading path, ABI assumptions, and release packaging around chDB.

I would like to propose a small migration step: make Maple use the official chdb npm package as the chDB integration layer, while keeping Maple current user-facing behavior the same.

The first PR would not add durable mode yet. It would only replace the internal chDB access path:

  • keep the same Maple UI/API behavior
  • keep local chDB working as it does today
  • move native addon loading and platform packaging to chdb-node
  • add a thin Maple wrapper if needed so the rest of Maple does not change much

Why this helps:

  • Maple can follow the maintained chDB Node addon instead of carrying a separate FFI path.
  • Durable support can be implemented once in chdb-node, then used by Maple later.
  • Future chDB Node improvements, such as async API work, ABI updates, packaging fixes, and platform support, can reach Maple without reimplementing them in Maple.
  • The release surface gets smaller because Maple no longer needs to own as much native binding logic.

After that migration is in place, a later PR can add optional Maple durable support on top of the chdb-node durable APIs.

Does this direction make sense for Maple?

Ngôn ngữ chính
TypeScript
Star
1.8k
Fork
120
Merge trung bình
8 giờ 15 phút
Pull request đã merge (30 ngày)
659

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của MapleTechLabs/maple

Tất cả issue của MapleTechLabs/maple

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.