@taladb/web 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,93 @@
+# @taladb/web
+
+Browser WASM bindings for TalaDB — persistent local-first storage via WASM + OPFS.
+
+[![npm](https://img.shields.io/npm/v/@taladb/web)](https://www.npmjs.com/package/@taladb/web)
+[![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 the browser.
+
+## What it provides
+
+- Rust core compiled to WebAssembly via `wasm-bindgen`
+- Persistent storage using [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) (`FileSystemSyncAccessHandle`) — runs on a dedicated SharedWorker so the main thread is never blocked
+- In-memory fallback for environments without OPFS support
+- Bundle size target: < 400 KB gzipped
+
+## Browser support
+
+| Browser | OPFS (persistent) | In-memory fallback |
+|---------|-------------------|-------------------|
+| Chrome 109+ | ✅ | ✅ |
+| Safari 16.4+ | ✅ | ✅ |
+| Firefox | — | ✅ |
+| Edge 109+ | ✅ | ✅ |
+
+## Installation
+
+```bash
+pnpm add taladb @taladb/web
+```
+
+## 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 col = db.collection('notes');
+
+await col.insert({ title: 'Hello', body: 'World' });
+const notes = await col.find();
+```
+
+### Vite setup
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  optimizeDeps: {
+    exclude: ['@taladb/web'],
+  },
+});
+```
+
+### Web Worker (OPFS)
+
+TalaDB spawns a SharedWorker internally to own the OPFS file handle. No extra configuration is required — the worker script is bundled inside this package at `@taladb/web/worker/taladb.worker.js`.
+
+## Direct usage (advanced)
+
+If you need to use the WASM bindings directly:
+
+```ts
+import init, { TalaDBWasm } from '@taladb/web';
+
+await init();
+
+const db = TalaDBWasm.openInMemory();
+const col = db.collection('items');
+col.insert({ x: 1 });
+```
+
+## Building from source
+
+```bash
+# Install wasm-pack
+cargo install wasm-pack
+
+# Build
+pnpm --filter @taladb/web build
+```
+
+## Full Documentation
+
+**[https://thinkgrid-labs.github.io/taladb/guide/web](https://thinkgrid-labs.github.io/taladb/guide/web)**
+
+## License
+
+MIT © [ThinkGrid Labs](https://github.com/thinkgrid-labs)

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@taladb/web",
+  "version": "0.1.0",
+  "description": "TalaDB WASM bindings for browser (wasm-bindgen + OPFS SharedWorker)",
+  "main": "pkg/taladb_web.js",
+  "types": "pkg/taladb_web.d.ts",
+  "exports": {
+    ".": {
+      "import": "./pkg/taladb_web.js",
+      "types": "./pkg/taladb_web.d.ts"
+    },
+    "./pkg/*": "./pkg/*",
+    "./worker/*": "./worker/*"
+  },
+  "files": [
+    "pkg/",
+    "worker/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/taladb.git",
+    "directory": "packages/taladb-web"
+  },
+  "homepage": "https://thinkgrid-labs.github.io/taladb/guide/web",
+  "bugs": {
+    "url": "https://github.com/thinkgrid-labs/taladb/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "wasm-pack build --target web --out-dir pkg --release",
+    "build:dev": "wasm-pack build --target web --out-dir pkg --dev",
+    "test": "wasm-pack test --headless --chrome"
+  }
+}

package/pkg/README.md

@@ -0,0 +1,93 @@
+# @taladb/web
+
+Browser WASM bindings for TalaDB — persistent local-first storage via WASM + OPFS.
+
+[![npm](https://img.shields.io/npm/v/@taladb/web)](https://www.npmjs.com/package/@taladb/web)
+[![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 the browser.
+
+## What it provides
+
+- Rust core compiled to WebAssembly via `wasm-bindgen`
+- Persistent storage using [OPFS](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system) (`FileSystemSyncAccessHandle`) — runs on a dedicated SharedWorker so the main thread is never blocked
+- In-memory fallback for environments without OPFS support
+- Bundle size target: < 400 KB gzipped
+
+## Browser support
+
+| Browser | OPFS (persistent) | In-memory fallback |
+|---------|-------------------|-------------------|
+| Chrome 109+ | ✅ | ✅ |
+| Safari 16.4+ | ✅ | ✅ |
+| Firefox | — | ✅ |
+| Edge 109+ | ✅ | ✅ |
+
+## Installation
+
+```bash
+pnpm add taladb @taladb/web
+```
+
+## 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 col = db.collection('notes');
+
+await col.insert({ title: 'Hello', body: 'World' });
+const notes = await col.find();
+```
+
+### Vite setup
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  optimizeDeps: {
+    exclude: ['@taladb/web'],
+  },
+});
+```
+
+### Web Worker (OPFS)
+
+TalaDB spawns a SharedWorker internally to own the OPFS file handle. No extra configuration is required — the worker script is bundled inside this package at `@taladb/web/worker/taladb.worker.js`.
+
+## Direct usage (advanced)
+
+If you need to use the WASM bindings directly:
+
+```ts
+import init, { TalaDBWasm } from '@taladb/web';
+
+await init();
+
+const db = TalaDBWasm.openInMemory();
+const col = db.collection('items');
+col.insert({ x: 1 });
+```
+
+## Building from source
+
+```bash
+# Install wasm-pack
+cargo install wasm-pack
+
+# Build
+pnpm --filter @taladb/web build
+```
+
+## Full Documentation
+
+**[https://thinkgrid-labs.github.io/taladb/guide/web](https://thinkgrid-labs.github.io/taladb/guide/web)**
+
+## License
+
+MIT © [ThinkGrid Labs](https://github.com/thinkgrid-labs)