@lunora/replica 0.0.0 → 1.0.0-alpha.2

package/LICENSE.md

@@ -0,0 +1,231 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 anolilab and contributors
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or service
+that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software that
+   exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee using
+   the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to the
+infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN
+IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following will
+apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.
+
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+
+<!-- TYPE_DEPENDENCIES -->
+
+# Licenses of bundled types
+The published @lunora/replica artifact additionally contains code with the following licenses:
+FSL-1.1-Apache-2.0
+
+# Bundled types:
+## @lunora/server
+License: FSL-1.1-Apache-2.0
+By: Daniel Bannert
+Repository: git+https://github.com/anolilab/lunora.git
+
+> # Functional Source License, Version 1.1, Apache 2.0 Future License
+>
+> ## Abbreviation
+>
+> FSL-1.1-Apache-2.0
+>
+> ## Notice
+>
+> Copyright 2026 anolilab and contributors
+>
+> ## Terms and Conditions
+>
+> ### Licensor ("We")
+>
+> The party offering the Software under these Terms and Conditions.
+>
+> ### The Software
+>
+> The "Software" is each version of the software that we make available under
+> these Terms and Conditions, as indicated by our inclusion of these Terms and
+> Conditions with the Software.
+>
+> ### License Grant
+>
+> Subject to your compliance with this License Grant and the Patents,
+> Redistribution and Trademark clauses below, we hereby grant you the right to
+> use, copy, modify, create derivative works, publicly perform, publicly display
+> and redistribute the Software for any Permitted Purpose identified below.
+>
+> ### Permitted Purpose
+>
+> A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+> means making the Software available to others in a commercial product or service
+> that:
+>
+> 1. substitutes for the Software;
+>
+> 2. substitutes for any other product or service we offer using the Software that
+>    exists as of the date we make the Software available; or
+>
+> 3. offers the same or substantially similar functionality as the Software.
+>
+> Permitted Purposes specifically include using the Software:
+>
+> 1. for your internal use and access;
+>
+> 2. for non-commercial education;
+>
+> 3. for non-commercial research; and
+>
+> 4. in connection with professional services that you provide to a licensee using
+>    the Software in accordance with these Terms and Conditions.
+>
+> ### Patents
+>
+> To the extent your use for a Permitted Purpose would necessarily infringe our
+> patents, the license grant above includes a license under our patents. If you
+> make a claim against any party that the Software infringes or contributes to the
+> infringement of any patent, then your patent license to the Software ends
+> immediately.
+>
+> ### Redistribution
+>
+> The Terms and Conditions apply to all copies, modifications and derivatives of
+> the Software.
+>
+> If you redistribute any copies, modifications or derivatives of the Software,
+> you must include a copy of or a link to these Terms and Conditions and not
+> remove any copyright notices provided in or with the Software.
+>
+> ### Disclaimer
+>
+> THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+> PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+>
+> IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+> SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN
+> IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+>
+> ### Trademarks
+>
+> Except for displaying the License Details and identifying us as the origin of
+> the Software, you have no right under these Terms and Conditions to use our
+> trademarks, trade names, service marks or product names.
+>
+> ## Grant of Future License
+>
+> We hereby irrevocably grant you an additional license to use the Software under
+> the Apache License, Version 2.0 that is effective on the second anniversary of
+> the date we make the Software available. On or after that date, you may use the
+> Software under the Apache License, Version 2.0, in which case the following will
+> apply:
+>
+> Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+> this file except in compliance with the License.
+>
+> You may obtain a copy of the License at
+>
+> http://www.apache.org/licenses/LICENSE-2.0
+>
+> Unless required by applicable law or agreed to in writing, software distributed
+> under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+> CONDITIONS OF ANY KIND, either express or implied. See the License for the
+> specific language governing permissions and limitations under the License.
+>
+> <!-- DEPENDENCIES -->
+> <!-- /DEPENDENCIES -->
+
+<!-- /TYPE_DEPENDENCIES -->

package/README.md

@@ -1,45 +1,208 @@
-# @lunora/replica
+<!-- START_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+<a href="https://www.anolilab.com/open-source" align="center">
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+  <img src="__assets__/package-og.svg" alt="replica" />
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+</a>
 
-## Purpose
+<h3 align="center">Local-first replica runtime + local SQLite mirror for Lunora</h3>
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@lunora/replica`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+<!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
-## What is OIDC Trusted Publishing?
+<br />
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+<div align="center">
 
-## Setup Instructions
+[![typescript-image][typescript-badge]][typescript-url]
+[![FSL-1.1-Apache-2.0 licence][license-badge]][license]
+[![npm version][npm-version-badge]][npm-version]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
-To properly configure OIDC trusted publishing for this package:
+</div>
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+---
 
-## DO NOT USE THIS PACKAGE
+<div align="center">
+    <p>
+        <sup>
+            Daniel Bannert's open source work is supported by the community on <a href="https://github.com/sponsors/prisis">GitHub Sponsors</a>
+        </sup>
+    </p>
+</div>
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+---
 
-## More Information
+Local-first replica runtime and local SQLite mirror for [Lunora](https://lunora.sh).
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+**Events layer** — derive state from an append-only event log via reducers, persist
+events through a Durable Object, and subscribe to typed events.
 
----
+**Local mirror** — a client-side SQLite mirror that maintains a replica
+of server tables by applying typed row-level diffs. Choose the SQLite backend
+that fits your runtime:
+
+| Backend                 | Entry point                               | Runtime                        |
+| ----------------------- | ----------------------------------------- | ------------------------------ |
+| sql.js (WASM)           | `@lunora/replica/adapters/sqljs`          | Browser, Node, Service Workers |
+| better-sqlite3 (native) | `@lunora/replica/adapters/better-sqlite3` | Node.js                        |
+| @sqlite.org/sqlite-wasm | `@lunora/replica/adapters/sqlite-wasm`    | Browser, Node (official WASM)  |
+| Custom                  | Write your own `SqliteAdapter`            | Any                            |
+
+## Install
+
+```bash
+pnpm add @lunora/replica
+# Choose one SQLite backend:
+pnpm add sql.js                       # browser + Node (WASM)
+pnpm add better-sqlite3              # Node.js only (native)
+pnpm add @sqlite.org/sqlite-wasm     # browser (official WASM)
+# @lunora/server is optional — needed only for the EventLogDO:
+pnpm add @lunora/server
+```
+
+## Exports
+
+| Entry point                               | Contents                                                                                                                                                                                                                                                                                                                                              |
+| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@lunora/replica`                         | `EventSource`, `EventEmitter`, `defineEvents`, `defineMaterializer`, `EventLogDO`, `EventLogDOClient`, `SubscriptionManager`, `InMemorySnapshotStore`, `eventsContext`, `LocalMirror`, `EventLog`, `EventsSync`, `subscribeToMirror`, `applyDiff`, `TableDiff` helpers, `createSqlJsAdapter`, `createBetterSqlite3Adapter`, `createSqliteWasmAdapter` |
+| `@lunora/replica/react`                   | `useLocalQuery` React hook                                                                                                                                                                                                                                                                                                                            |
+| `@lunora/replica/adapters/sqljs`          | `createSqlJsAdapter` (sql.js)                                                                                                                                                                                                                                                                                                                         |
+| `@lunora/replica/adapters/better-sqlite3` | `createBetterSqlite3Adapter` (better-sqlite3)                                                                                                                                                                                                                                                                                                         |
+| `@lunora/replica/adapters/sqlite-wasm`    | `createSqliteWasmAdapter` (@sqlite.org/sqlite-wasm)                                                                                                                                                                                                                                                                                                   |
+
+## EventSource
+
+The core runtime — a typed reducer that derives state from an append-only log:
+
+```ts
+import { EventSource } from "@lunora/replica";
+
+interface MyState {
+    count: number;
+    items: string[];
+}
+
+const source = new EventSource<MyState>({ count: 0, items: [] }, (state, entry) => {
+    switch (entry.type) {
+        case "item:added":
+            return { count: state.count + 1, items: [...state.items, entry.payload as string] };
+        default:
+            return state;
+    }
+});
+
+source.applyEvent("item:added", "hello");
+console.log(source.state.count); // 1
+```
+
+## LocalMirror
+
+An SQLite mirror that applies typed row-level diffs. Create it with your
+chosen backend:
+
+```ts
+import initSqlJs from "sql.js";
+import { createSqlJsAdapter, LocalMirror } from "@lunora/replica";
+
+const SQL = await initSqlJs();
+const adapter = createSqlJsAdapter(new SQL.Database());
+const mirror = new LocalMirror({ db: adapter });
+
+mirror.applyDiff({
+    table: "todos",
+    schema: "1.0",
+    changes: [{ type: "insert", data: { id: "1", title: "hello", done: false } }],
+});
+
+const todos = mirror.query<{ id: string; title: string }>("SELECT id, title FROM todos");
+```
+
+For `better-sqlite3`:
+
+```ts
+import Database from "better-sqlite3";
+import { createBetterSqlite3Adapter, LocalMirror } from "@lunora/replica";
+
+const adapter = createBetterSqlite3Adapter(new Database(":memory:"));
+const mirror = new LocalMirror({ db: adapter });
+```
+
+### EventsSync
+
+Periodically polls a server-side event log, replays events through a state
+machine, and pushes the resulting diffs to the mirror:
+
+```ts
+import { EventsSync } from "@lunora/replica";
+
+const sync = new EventsSync({
+    fetchEventsSince: (seq) => eventLogClient.getSince(seq),
+    applyEvents: (events) => {
+        /* feed events into your state machine */
+    },
+    getTableDiffs: () => {
+        /* compare state before/after → TableDiff[] */
+    },
+    mirror,
+    pollInterval: 3000,
+});
+
+sync.start(); // begin polling
+// sync.sync(); // one-shot sync
+// sync.stop(); // halt polling
+```
+
+See the [EventsSync JSDoc](src/sync-events.ts) for full API details.
+
+### useLocalQuery (React)
+
+Live-updating hook that re-queries the mirror whenever a diff is applied.
+Returns `undefined` when the query fails (e.g. table doesn't exist yet),
+and the result rows otherwise.
+
+```tsx
+import { useLocalQuery } from "@lunora/replica/react";
+
+function TodoList() {
+    const todos = useLocalQuery<{ id: string; title: string; done: boolean }>(mirror, "SELECT id, title, done FROM todos WHERE done = ?", [false]);
+
+    if (todos === undefined) {
+        return <p>Waiting for data…</p>;
+    }
+
+    return (
+        <ul>
+            {todos.map((t) => (
+                <li key={t.id}>{t.title}</li>
+            ))}
+        </ul>
+    );
+}
+```
+
+The hook uses `useSyncExternalStore` under the hood, so it integrates with
+React 18+ concurrent features and Suspense-based frameworks (Next.js, Remix).
+
+## EventLogDO
+
+A Durable Object that persists the event log to DO SQLite storage:
+
+```ts
+export { EventLogDO } from "@lunora/replica";
+
+const client = new EventLogDOClient({ namespace: "my-app" });
+await client.append({ type: "order:placed", payload: { orderId: "123" } });
+const events = await client.query({ type: "order:placed", limit: 10 });
+```
+
+## Custom adapters
+
+See the [custom adapter guide](docs/guides/custom-adapter.mdx) for writing
+`SqliteAdapter` implementations for `expo-sqlite`, `bun:sqlite`, or any other
+SQLite runtime.
+
+## License
 
-**Maintained for OIDC setup purposes only**
+[FSL-1.1-Apache-2.0](./LICENSE.md)

package/dist/adapters/better-sqlite3.d.mts

@@ -0,0 +1,27 @@
+import { S as SqliteAdapter } from "../packem_shared/types.d-VfJ76cK4.mjs";
+/**
+* Create a {@link SqliteAdapter} backed by [better-sqlite3](https://github.com/WiseLibs/better-sqlite3)
+* (a synchronous SQLite3 binding for Node.js).
+*
+* The adapter takes a structural projection of better-sqlite3's `Database` so
+* the package never imports from `better-sqlite3` directly — consumers install
+* it themselves and pass in their database instance.
+* @param database An already-initialised better-sqlite3 `Database` instance.
+* @param database.close Tear down the database connection.
+* @param database.exec Execute one or more SQL statements (no params, no results).
+* @param database.prepare Prepare a SQL statement for repeated execution.
+* @param database.transaction Wrap a function so its statements run in a transaction.
+*/
+declare const createBetterSqlite3Adapter: (database: {
+  close: () => void;
+  exec: (sql: string) => void;
+  prepare: (sql: string) => {
+    all: (params?: unknown[]) => unknown[];
+    get: (params?: unknown[]) => unknown;
+    run: (params?: unknown[]) => {
+      lastInsertRowid: number | bigint;
+    };
+  };
+  transaction: (function_: () => void) => () => void;
+}) => SqliteAdapter;
+export { createBetterSqlite3Adapter };

package/dist/adapters/better-sqlite3.d.ts

@@ -0,0 +1,27 @@
+import { S as SqliteAdapter } from "../packem_shared/types.d-VfJ76cK4.js";
+/**
+* Create a {@link SqliteAdapter} backed by [better-sqlite3](https://github.com/WiseLibs/better-sqlite3)
+* (a synchronous SQLite3 binding for Node.js).
+*
+* The adapter takes a structural projection of better-sqlite3's `Database` so
+* the package never imports from `better-sqlite3` directly — consumers install
+* it themselves and pass in their database instance.
+* @param database An already-initialised better-sqlite3 `Database` instance.
+* @param database.close Tear down the database connection.
+* @param database.exec Execute one or more SQL statements (no params, no results).
+* @param database.prepare Prepare a SQL statement for repeated execution.
+* @param database.transaction Wrap a function so its statements run in a transaction.
+*/
+declare const createBetterSqlite3Adapter: (database: {
+  close: () => void;
+  exec: (sql: string) => void;
+  prepare: (sql: string) => {
+    all: (params?: unknown[]) => unknown[];
+    get: (params?: unknown[]) => unknown;
+    run: (params?: unknown[]) => {
+      lastInsertRowid: number | bigint;
+    };
+  };
+  transaction: (function_: () => void) => () => void;
+}) => SqliteAdapter;
+export { createBetterSqlite3Adapter };

package/dist/adapters/better-sqlite3.mjs

@@ -0,0 +1,29 @@
+const createBetterSqlite3Adapter = (database) => {
+  return {
+    exec(sql, params) {
+      if (params && params.length > 0) {
+        database.prepare(sql).run([...params]);
+      } else {
+        database.exec(sql);
+      }
+    },
+    query(sql, params) {
+      const stmt = database.prepare(sql);
+      const rows = params && params.length > 0 ? stmt.all([...params]) : stmt.all();
+      return rows;
+    },
+    transaction(function_) {
+      const wrapped = database.transaction(function_);
+      wrapped();
+    },
+    lastInsertRowId() {
+      const row = database.prepare("SELECT last_insert_rowid() AS id").get();
+      return Number(row?.id ?? -1);
+    },
+    close() {
+      database.close();
+    }
+  };
+};
+
+export { createBetterSqlite3Adapter };

package/dist/adapters/sqlite-wasm.d.mts

@@ -0,0 +1,25 @@
+import { S as SqliteAdapter } from "../packem_shared/types.d-VfJ76cK4.mjs";
+/**
+* Create a {@link SqliteAdapter} backed by the [official SQLite Wasm](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)
+* (a WebAssembly build of SQLite that runs in browsers and Node.js).
+*
+* The adapter takes a structural projection of the OO API (`sqlite3.oo1.DB`) so
+* the package never imports from `@sqlite.org/sqlite-wasm` directly — consumers
+* install it themselves and pass in their database instance.
+* @param database An already-initialised `sqlite3.oo1.DB` instance.
+* @param database.close Tear down the database connection.
+* @param database.exec Execute SQL with optional bind params and return rows
+* as `{ columns, values }` result objects.
+*/
+declare const createSqliteWasmAdapter: (database: {
+  close: () => void;
+  exec: (sql: string, options?: {
+    bind?: unknown[];
+    returnValue?: "resultRows" | "simple";
+    rowMode?: "array" | "object";
+  }) => {
+    columns: string[];
+    values: unknown[][];
+  }[];
+}) => SqliteAdapter;
+export { createSqliteWasmAdapter };

package/dist/adapters/sqlite-wasm.d.ts

@@ -0,0 +1,25 @@
+import { S as SqliteAdapter } from "../packem_shared/types.d-VfJ76cK4.js";
+/**
+* Create a {@link SqliteAdapter} backed by the [official SQLite Wasm](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)
+* (a WebAssembly build of SQLite that runs in browsers and Node.js).
+*
+* The adapter takes a structural projection of the OO API (`sqlite3.oo1.DB`) so
+* the package never imports from `@sqlite.org/sqlite-wasm` directly — consumers
+* install it themselves and pass in their database instance.
+* @param database An already-initialised `sqlite3.oo1.DB` instance.
+* @param database.close Tear down the database connection.
+* @param database.exec Execute SQL with optional bind params and return rows
+* as `{ columns, values }` result objects.
+*/
+declare const createSqliteWasmAdapter: (database: {
+  close: () => void;
+  exec: (sql: string, options?: {
+    bind?: unknown[];
+    returnValue?: "resultRows" | "simple";
+    rowMode?: "array" | "object";
+  }) => {
+    columns: string[];
+    values: unknown[][];
+  }[];
+}) => SqliteAdapter;
+export { createSqliteWasmAdapter };

package/dist/adapters/sqlite-wasm.mjs

@@ -0,0 +1,56 @@
+const createSqliteWasmAdapter = (database) => {
+  return {
+    exec(sql, params) {
+      if (params && params.length > 0) {
+        database.exec(sql, { bind: [...params] });
+      } else {
+        database.exec(sql);
+      }
+    },
+    query(sql, params) {
+      const options = params && params.length > 0 ? { bind: [...params], returnValue: "resultRows" } : { returnValue: "resultRows" };
+      const result = database.exec(sql, options);
+      const first = result[0];
+      if (!first) {
+        return [];
+      }
+      const colNames = first.columns;
+      const rows = [];
+      for (const row of first.values) {
+        const object = {};
+        for (const [i, column] of colNames.entries()) {
+          object[column] = row[i];
+        }
+        rows.push(object);
+      }
+      return rows;
+    },
+    transaction(function_) {
+      database.exec("BEGIN");
+      try {
+        function_();
+        database.exec("COMMIT");
+      } catch (error) {
+        database.exec("ROLLBACK");
+        throw error;
+      }
+    },
+    lastInsertRowId() {
+      const result = database.exec("SELECT last_insert_rowid() AS id", { returnValue: "resultRows" });
+      const firstRow = result[0];
+      if (result.length === 0 || !firstRow || firstRow.values.length === 0) {
+        return -1;
+      }
+      const value = firstRow.values[0];
+      if (!value || value.length === 0) {
+        return -1;
+      }
+      return Number(value[0]);
+    },
+    close() {
+      database.close();
+    }
+  };
+};
+
+export { createSqliteWasmAdapter };

package/dist/adapters/sqljs.d.mts

@@ -0,0 +1,19 @@
+import { S as SqliteAdapter } from "../packem_shared/types.d-VfJ76cK4.mjs";
+/**
+* Create a {@link SqliteAdapter} backed by [sql.js](https://sql.js.org)
+* (a WebAssembly build of SQLite that runs in browsers, Node, and
+* React Native).
+* @param database An already-initialised sql.js database instance.
+* @param database.run Execute a parameterised SQL statement (no results).
+* @param database.exec Execute SQL and return result rows.
+* @param database.close Tear down the database connection.
+*/
+declare const createSqlJsAdapter: (database: {
+  close: () => void;
+  exec: (sql: string, params?: unknown[]) => {
+    columns: string[];
+    values: unknown[][];
+  }[];
+  run: (sql: string, params?: unknown[]) => void;
+}) => SqliteAdapter;
+export { createSqlJsAdapter };