@taladb/node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 thinkgrid-labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @taladb/node
+
+Node.js native module for TalaDB — high-performance local-first storage via a napi-rs Rust binding.
+
+[![npm](https://img.shields.io/npm/v/@taladb/node)](https://www.npmjs.com/package/@taladb/node)
+[![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](LICENSE)
+
+> **Note:** Most users should install [`taladb`](https://www.npmjs.com/package/taladb) instead, which auto-selects this package when running in Node.js.
+
+## What it provides
+
+- TalaDB's Rust core exposed via [napi-rs](https://napi.rs/) — zero marshalling overhead
+- Synchronous hot-path methods + `async` variants for non-blocking server use
+- Pre-built binaries for `linux-x64`, `linux-arm64`, `darwin-x64`, `darwin-arm64`, `win32-x64`
+- No `node-gyp` required — binaries ship with the package
+
+## Requirements
+
+- Node.js 18+
+
+## Installation
+
+```bash
+pnpm add taladb @taladb/node
+```
+
+## Usage
+
+Use through the unified [`taladb`](https://www.npmjs.com/package/taladb) package:
+
+```ts
+import { openDB } from 'taladb';
+
+const db = await openDB('./myapp.db');
+const users = db.collection('users');
+
+await users.createIndex('email');
+await users.insert({ name: 'Alice', email: 'alice@example.com', role: 'admin' });
+
+const alice = await users.findOne({ email: 'alice@example.com' });
+const admins = await users.find({ role: 'admin' });
+```
+
+### CommonJS
+
+```js
+const { openDB } = require('taladb');
+
+async function main() {
+  const db = await openDB('./myapp.db');
+  const col = db.collection('items');
+
+  await col.insert({ name: 'Widget', price: 9.99 });
+  const results = await col.find({ price: { $lt: 20 } });
+  console.log(results);
+
+  await db.close();
+}
+
+main();
+```
+
+## Direct usage (advanced)
+
+```js
+const { TalaDBNode } = require('@taladb/node');
+
+const db = TalaDBNode.open('./myapp.db');
+const col = db.collection('items');
+
+// Synchronous (no await)
+const id = col.insert({ x: 1 });
+const docs = col.find(null);
+
+db.close();
+```
+
+## Building from source
+
+```bash
+# Install napi-rs CLI
+pnpm add -g @napi-rs/cli
+
+# Build for current platform
+pnpm --filter @taladb/node build
+```
+
+## Full Documentation
+
+**[https://thinkgrid-labs.github.io/taladb/guide/node](https://thinkgrid-labs.github.io/taladb/guide/node)**
+
+## License
+
+MIT © [ThinkGrid Labs](https://github.com/thinkgrid-labs)

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@taladb/node",
+  "version": "0.1.0",
+  "description": "TalaDB Node.js native module (napi-rs)",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "napi": {
+    "name": "taladb-node",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-unknown-linux-gnu",
+        "aarch64-apple-darwin",
+        "x86_64-pc-windows-msvc"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/taladb.git",
+    "directory": "packages/taladb-node"
+  },
+  "homepage": "https://thinkgrid-labs.github.io/taladb/guide/node",
+  "bugs": {
+    "url": "https://github.com/thinkgrid-labs/taladb/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "napi build --platform --release --js index.js --dts index.d.ts",
+    "build:debug": "napi build --platform --js index.js --dts index.d.ts",
+    "test": "jest"
+  }
+}