AGLake Node.js SDK

The transport-neutral Node.js client, written in TypeScript, for AGLake V1. AGLakeClient.open() selects Local or Server only from configuration; application call sites and logical request/result types stay the same.

Local mode loads aglake-local-native lazily. Server mode never loads the native addon; it uses PostgreSQL TLS for SQL and the versioned HTTPS API for every other operation.

writeBlob(request, source) accepts an AsyncIterable<Uint8Array> in both modes. It does not buffer the complete object in the SDK or encode it into JSON. Set expected_bytes and expected_sha256 when the producer knows them; the commit fails before publication if either value differs. Use readBlob for streamed/ranged reads.

0.2.0

This release includes the updated Rust Core with resident MemWAL, concurrent inserts, atomic columnar bulk ingest, and adaptive SQL memory and spill budgets.

Compaction rebuilds and validates active indexes with the new table version, preserving full-text and vector search availability after completion and restart.

The SDK adds insertArrow() for atomic bulk inserts. The former resourceLinks() and agentFsLinks() methods, their ResourceLink* types, and ProvenanceInput are no longer exported.

New tables default to content_receipt = 'off'; their content_hash is nullable. Create tables with WITH (content_receipt = 'sha256_v1') when callers require content receipts. Existing tables retain their receipt mode.

The current root format is v9. Opening a supported older root can upgrade its format; keep a backup before upgrading because older AGLake versions cannot open the upgraded root.

Install with npm install [email protected] on Node.js 24 or later. Local mode includes the Windows x64 MSVC native package. Linux and macOS Local packages remain unadvertised; Server mode uses the configured remote server.