firebird-wasm 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -4,6 +4,84 @@ All notable changes to `firebird-wasm`. This project follows
 [semantic versioning](https://semver.org/); while the major version is 0 the
 API may still move between minor releases.
 
+## 0.10.0 — 2026-10-24
+
+### Added
+
+- **Kysely and Drizzle ORM dialects (`firebird-wasm/kysely` and
+  `firebird-wasm/drizzle`).** Both run against `FirebirdBrowser` and
+  `FirebirdLite`:
+  - `firebird-wasm/kysely` exports `FirebirdDialect`, `FirebirdDriver`,
+    `FirebirdQueryCompiler`, `FirebirdAdapter`, `FirebirdIntrospector`, and
+    `createKysely(db, config?)`. Compiles `?` positional parameters, Firebird
+    `OFFSET ? ROWS FETCH NEXT ? ROWS ONLY` pagination (and `ROWS ?` on
+    `UPDATE` / `DELETE`), multi-row `INSERT INTO … SELECT … FROM RDB$DATABASE
+    UNION ALL …`, `UPDATE OR INSERT INTO … MATCHING (…)` upserts on
+    `onConflict`, `INSERT` / `UPDATE` / `DELETE … RETURNING`, Firebird DDL
+    (`GENERATED BY DEFAULT AS IDENTITY` before `PRIMARY KEY`, `CREATE GLOBAL
+    TEMPORARY TABLE`, `ALTER TABLE … ADD / DROP / ALTER COLUMN … TO …`),
+    transactions with Firebird isolation levels and savepoints, cursor
+    streaming over `queryStream()`, system-table introspection
+    (`RDB$RELATIONS` / `RDB$RELATION_FIELDS`), and bijective lowercase/uppercase
+    identifier folding (`identifierCase: 'lower' | 'preserve'`).
+  - `firebird-wasm/drizzle` exports `drizzle(db, config?)`,
+    `FirebirdDrizzleDialect`, `FirebirdDrizzleSession`,
+    `FirebirdDrizzlePreparedQuery`, `FirebirdDrizzleTransaction`,
+    `FirebirdDrizzleDatabase`, `firebirdTable`, column builders, and query
+    operators. Supports relational queries (`db.query.*.findMany()`),
+    multi-row inserts, omitted identity/default columns, `onConflictDoUpdate`
+    via `UPDATE OR INSERT … MATCHING`, `RETURNING`, `db.$count()`,
+    transactions, and nested savepoints.
+- **Cursor / streaming query API (`queryStream()`).** `queryStream(sql,
+  params?, options?)` on `FirebirdBrowser`, `FirebirdBrowserTransaction`,
+  `FirebirdLite`, and `FirebirdTransaction` (including `sql` tagged-template
+  overloads) returns an `AsyncIterable<QueryResult<T>>` yielding batches of
+  `batchSize` rows (default `500`) over an open cursor (`_fb_cursor_open`,
+  `_fb_cursor_fetch`, `_fb_cursor_close` in the WASM C bridge;
+  `ResultSet.fetch({ fetchSize })` on Node). Breaking out of `for await` early
+  closes the cursor and finishes its autocommit transaction immediately without
+  fetching the rest of the table.
+- **Node backend `types` and `FieldInfo` parity.** `FirebirdLite` and
+  `FirebirdTransaction` now accept `types: { bigint, dates, binary, parsers,
+  serializers }` at database construction and per-query (`QueryOptions.types`),
+  populate full `FieldInfo` metadata (`type`, `typeName`, `subType`, `scale`,
+  `length`, `nullable`) from the native statement metadata, and normalize wire
+  values (`BIGINT`, `INT128`, scaled `NUMERIC` / `DECIMAL`, `DATE`, `TIME`,
+  `TIMESTAMP`, `TIME WITH TIME ZONE`, `TIMESTAMP WITH TIME ZONE`, `DECFLOAT`,
+  text/binary `BLOB`s, and `OCTETS`) to match `FirebirdBrowser`.
+- **Shape server `replica=full`, `applyWrite`, `DECFLOAT`, and batched change
+  fetches.**
+  - `firebird-wasm/electric-server` now supports `?replica=full`: the update
+    and delete triggers record prior column values in `OLD_VALUES` on
+    `ELECTRIC_CHANGES`, and `replica=full` responses include `old_value` on
+    updates (changed columns) and deletes (all non-key columns).
+  - `server.applyWrite(write)` executes a `PendingWrite` from
+    `createWriteQueue` directly against the Firebird source table in one
+    transaction and returns `{ txid }` for immediate write-queue confirmation.
+  - `changesAfter` batches row fetches for changed keys with `IN (?, …)` in
+    chunks of 200 instead of issuing one `SELECT` per changed key.
+  - `DECFLOAT(16)` and `DECFLOAT(34)` (`SQL_DEC16 = 260`, `SQL_DEC34 = 262`)
+    are decoded in the C bridge, mapped in `firebird-wasm/electric-server`, and
+    accepted by `firebird-wasm/electric`.
+
+### Changed
+
+- **Zero-copy OPFS reads and writes on the default single-threaded build.**
+  When `HEAPU8.buffer` is a plain `ArrayBuffer` (`firebird-embedded-st`),
+  `mountOpfs` passes the WASM heap subarray directly to
+  `FileSystemSyncAccessHandle.read` and `.write` without allocating or copying
+  through an intermediate scratch buffer.
+- **Faster C bridge value formatting.** `SQL_FLOAT` uses `std::to_chars`,
+  offset-based `SQL_TIME_TZ` and `SQL_TIMESTAMP_TZ` (`0..2878`) are decoded in
+  C without `IUtil`, and `appendScaledDecimal` writes directly into the JSON
+  buffer without temporary string shifts.
+- **Incremental WASM rebuilds and CI verification.** `wasm/build.sh` preserves
+  the timestamps of unchanged `autoconfig.h`, `parse.h` / `parse.cpp`, and
+  `epp-generated` outputs across native bootstrap rebuilds, and
+  `build-wasm.yml` runs an incremental rebuild check after wiping
+  `build-native-config` and `.wasm-patches-applied` and touching
+  `fb_wasm_api.cpp`.
+
 ## 0.9.0 — 2026-10-19
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebird-wasm",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Firebird embedded database in WebAssembly — runs in the browser and Node, like PGlite for PostgreSQL",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,6 +38,14 @@
       "types": "./dist/electric-server/index.d.ts",
       "default": "./dist/electric-server/index.js"
     },
+    "./kysely": {
+      "types": "./dist/kysely/index.d.ts",
+      "default": "./dist/kysely/index.js"
+    },
+    "./drizzle": {
+      "types": "./dist/drizzle/index.d.ts",
+      "default": "./dist/drizzle/index.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -66,9 +74,11 @@
     "node-firebird-driver": "^3.5.0"
   },
   "peerDependencies": {
+    "@electric-sql/client": ">=1.5",
+    "drizzle-orm": ">=0.30",
+    "kysely": ">=0.27",
     "react": ">=18",
-    "vue": ">=3.3",
-    "@electric-sql/client": ">=1.5"
+    "vue": ">=3.3"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -79,6 +89,12 @@
     },
     "@electric-sql/client": {
       "optional": true
+    },
+    "kysely": {
+      "optional": true
+    },
+    "drizzle-orm": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -89,8 +105,10 @@
     "@types/react-dom": "^19.2.2",
     "@typescript-eslint/eslint-plugin": "^7.17.0",
     "@typescript-eslint/parser": "^7.17.0",
+    "drizzle-orm": "^0.45.4",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
+    "kysely": "^0.28.14",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "ts-jest": "^29.2.2",