@dolthub/doltlite-wasm 0.11.16

package/LICENSE.md

@@ -0,0 +1,113 @@
+License Information
+===================
+
+Doltlite Extensions — Apache License 2.0
+-----------------------------------------
+
+The Doltlite extensions to SQLite — including the prolly tree storage
+engine, chunk store, version control functions (dolt_commit, dolt_merge,
+dolt_diff, etc.), and all related code in the following files — are
+licensed under the Apache License, Version 2.0:
+
+  * `src/prolly_*.c` and `src/prolly_*.h` — Prolly tree implementation
+  * `src/chunk_store.c` and `src/chunk_store.h` — Content-addressed chunk store
+  * `src/pager_shim.c` — Pager shim for SQLite integration
+  * `src/doltlite*.c` and `src/doltlite*.h` — Version control functions
+  * `.github/` — CI/CD workflows
+
+You may obtain a copy of the Apache License at:
+https://www.apache.org/licenses/LICENSE-2.0
+
+Copyright 2024-2026 DoltHub, Inc.
+
+SQLite Is Public Domain
+-----------------------
+
+The SQLite source code, including all of the files in the directories
+listed in the bullets below are 
+[Public Domain](https://sqlite.org/copyright.html).
+The authors have submitted written affidavits releasing their work to
+the public for any use.  Every byte of the public-domain code can be
+traced back to the original authors.  The files of this repository
+that are public domain include the following:
+
+  *  All of the primary SQLite source code files found in the
+     [src/ directory](https://sqlite.org/src/tree/src?type=tree&expand)
+  *  All of the test cases and testing code in the
+     [test/ directory](https://sqlite.org/src/tree/test?type=tree&expand)
+  *  All of the SQLite extension source code and test cases in the
+     [ext/ directory](https://sqlite.org/src/tree/ext?type=tree&expand)
+  *  All code that ends up in the "sqlite3.c" and "sqlite3.h" build products
+     that actually implement the SQLite RDBMS.
+  *  All of the code used to compile the
+     [command-line interface](https://sqlite.org/cli.html)
+  *  All of the code used to build various utility programs such as
+     "sqldiff", "sqlite3_rsync", and "sqlite3_analyzer".
+
+
+The public domain source files usually contain a header comment
+similar to the following to make it clear that the software is
+public domain.
+
+> The author disclaims copyright to this source code.  In place of
+> a legal notice, here is a blessing:
+> 
+>   *   May you do good and not evil.
+>   *   May you find forgiveness for yourself and forgive others.
+>   *   May you share freely, never taking more than you give.
+
+Almost every file you find in this source repository will be
+public domain.  But there are a small number of exceptions:
+
+Non-Public-Domain Code Included With This Source Repository AS A Convenience
+----------------------------------------------------------------------------
+
+This repository contains a (relatively) small amount of non-public-domain
+code used to help implement the configuration and build logic.  In other
+words, there are some non-public-domain files used to implement:
+
+> ./configure && make
+
+In all cases, the non-public-domain files included with this
+repository have generous BSD-style licenses.  So anyone is free to
+use any of the code in this source repository for any purpose, though
+attribution may be required to reuse or republish the configure and
+build scripts.  None of the non-public-domain code ever actually reaches
+the build products, such as "sqlite3.c", however, so no attribution is
+required to use SQLite itself.  The non-public-domain code consists of
+scripts used to help compile SQLite.  The non-public-domain code is
+technically not part of SQLite.  The non-public-domain code is
+included in this repository as a convenience to developers, so that those
+who want to build SQLite do not need to go download a bunch of
+third-party build scripts in order to compile SQLite.
+
+Non-public-domain code included in this respository includes:
+
+  *  The ["autosetup"](http://msteveb.github.io/autosetup/) configuration
+     system that is contained (mostly) in the autosetup/ directory, but also
+     includes the "./configure" script at the top-level of this archive.
+     Autosetup has a separate BSD-style license.  See the
+     [autosetup/LICENSE](http://msteveb.github.io/autosetup/license/)
+     for details.
+
+  *  There are BSD-style licenses on some of the configuration
+     software found in the legacy autoconf/ directory and its
+     subdirectories.
+
+  *  The vendored BLAKE3 reference implementation under `ext/blake3/`,
+     used by the prolly tree's content-addressing layer. Upstream is
+     dual-licensed under Apache License 2.0 (with LLVM exception) or
+     CC0 1.0 Universal — DoltLite redistributes under Apache 2.0
+     (the project-wide license). Source: BLAKE3 v1.8.5 from
+     https://github.com/BLAKE3-team/BLAKE3. See `ext/blake3/LICENSE`
+     and `ext/blake3/README.md` for the full license texts and a
+     description of DoltLite-specific modifications.
+
+The following unix shell command can be run from the top-level
+of this source repository in order to remove all non-public-domain
+code:
+
+> rm -rf configure autosetup autoconf
+
+If you unpack this source repository and then run the command above, what
+is left will be 100% public domain.

package/README.md

@@ -0,0 +1,74 @@
+# @dolthub/doltlite-wasm
+
+[DoltLite](https://github.com/dolthub/doltlite) compiled to WebAssembly: a
+drop-in SQLite build with Dolt-style version control — `dolt_commit`,
+`dolt_branch`, `dolt_merge`, `dolt_diff`, and the rest — that runs in the
+browser and in any JS runtime.
+
+This is the WebAssembly distribution. For a native Node/Bun addon, use
+[`@dolthub/doltlite`](https://github.com/dolthub/doltlite-node) instead.
+
+## Install
+
+```bash
+npm install @dolthub/doltlite-wasm
+```
+
+## Browser (OPFS-backed, persistent)
+
+OPFS persistence requires the page be served cross-origin isolated (the
+`COOP`/`COEP` headers below); without them you still get an in-memory database.
+
+```js
+import { sqlite3InitModule } from '@dolthub/doltlite-wasm';
+
+const sqlite3 = await sqlite3InitModule();
+
+// Persistent across reloads when OPFS is available, in-memory otherwise.
+const db = ('opfs' in sqlite3)
+  ? new sqlite3.oo1.OpfsDb('/app.db')
+  : new sqlite3.oo1.DB(':memory:');
+
+db.exec(`CREATE TABLE IF NOT EXISTS t(id INTEGER PRIMARY KEY, msg TEXT)`);
+db.exec(`INSERT INTO t(msg) VALUES('hello')`);
+db.exec(`SELECT dolt_commit('-A', '-m', 'first commit')`);
+
+for (const row of db.selectObjects(`SELECT * FROM dolt_log`)) {
+  console.log(row.commit_hash, row.message);
+}
+```
+
+Required headers for OPFS (cross-origin isolation):
+
+```
+Cross-Origin-Opener-Policy: same-origin
+Cross-Origin-Embedder-Policy: require-corp
+```
+
+## Node / Bun
+
+```js
+import { sqlite3InitModule } from '@dolthub/doltlite-wasm';
+
+const sqlite3 = await sqlite3InitModule();
+const db = new sqlite3.oo1.DB('/tmp/app.db');
+db.exec(`CREATE TABLE t(x)`);
+db.exec(`SELECT dolt_commit('-A', '-m', 'init')`);
+```
+
+## Entry points
+
+| Import | Use |
+| --- | --- |
+| `@dolthub/doltlite-wasm` | Default; bundler-friendly ESM init |
+| `@dolthub/doltlite-wasm/sqlite3.mjs` | Plain ESM (no bundler) |
+| `@dolthub/doltlite-wasm/sqlite3-node.mjs` | Node-specific entry |
+| `@dolthub/doltlite-wasm/sqlite3-worker1-promiser.mjs` | Worker promiser API |
+
+The JavaScript API is the upstream SQLite WASM API — see the
+[sqlite3-wasm docs](https://sqlite.org/wasm). Everything there works; DoltLite
+adds the `dolt_*` version-control functions and virtual tables on top.
+
+## License
+
+Apache-2.0. See [LICENSE.md](./LICENSE.md). SQLite itself is public domain.

package/index.mjs

@@ -0,0 +1,10 @@
+// Entry point for @dolthub/doltlite-wasm.
+//
+// Mirrors @sqlite.org/sqlite-wasm: the default export is the async module
+// initializer. Await it to get the sqlite3 namespace, which has the dolt_*
+// version-control functions already registered (the wasm build wires
+// doltliteInstallAutoExt() into sqlite3_wasm_extra_init).
+import sqlite3InitModule from './sqlite3-bundler-friendly.mjs';
+
+export default sqlite3InitModule;
+export { sqlite3InitModule };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@dolthub/doltlite-wasm",
+  "version": "0.11.16",
+  "description": "DoltLite compiled to WebAssembly: SQLite with Dolt-style version control (branches, commits, merge, diff) for the browser and any JS runtime.",
+  "type": "module",
+  "main": "index.mjs",
+  "module": "index.mjs",
+  "exports": {
+    ".": "./index.mjs",
+    "./sqlite3.mjs": "./sqlite3.mjs",
+    "./sqlite3.wasm": "./sqlite3.wasm",
+    "./sqlite3-bundler-friendly.mjs": "./sqlite3-bundler-friendly.mjs",
+    "./sqlite3-node.mjs": "./sqlite3-node.mjs",
+    "./sqlite3-opfs-async-proxy.js": "./sqlite3-opfs-async-proxy.js",
+    "./sqlite3-worker1.mjs": "./sqlite3-worker1.mjs",
+    "./sqlite3-worker1-bundler-friendly.mjs": "./sqlite3-worker1-bundler-friendly.mjs",
+    "./sqlite3-worker1-promiser.mjs": "./sqlite3-worker1-promiser.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.mjs",
+    "sqlite3.mjs",
+    "sqlite3.wasm",
+    "sqlite3-bundler-friendly.mjs",
+    "sqlite3-node.mjs",
+    "sqlite3-opfs-async-proxy.js",
+    "sqlite3-worker1.mjs",
+    "sqlite3-worker1-bundler-friendly.mjs",
+    "sqlite3-worker1-promiser.mjs",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "keywords": [
+    "sqlite",
+    "wasm",
+    "webassembly",
+    "dolt",
+    "doltlite",
+    "version-control",
+    "database",
+    "opfs",
+    "local-first",
+    "git-for-data"
+  ],
+  "homepage": "https://github.com/dolthub/doltlite#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dolthub/doltlite.git",
+    "directory": "packaging/npm"
+  },
+  "bugs": {
+    "url": "https://github.com/dolthub/doltlite/issues"
+  },
+  "author": "DoltHub, Inc.",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}