firebird-wasm 0.9.0 → 0.10.1

package/CHANGELOG.md

@@ -4,6 +4,118 @@ 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.1 — 2026-10-25
+
+### Fixed
+
+- **Rebuilt WASM binaries in the published npm tarball.** The `0.10.0` npm
+  package was packed before the local WASM rebuild ran and shipped the `0.9.0`
+  `dist/wasm/firebird-embedded.{js,wasm}` and
+  `dist/wasm/firebird-embedded-st.{js,wasm}` binaries (missing
+  `_fb_cursor_open` / `_fb_cursor_fetch` / `_fb_cursor_close` for
+  `queryStream()`, `DECFLOAT` decoding, and C bridge formatting fast paths).
+  `0.10.1` ships the rebuilt `0.10.x` WASM artifacts in both the npm package
+  and the GitHub release.
+- **Multi-row `INSERT`s in Kysely and Drizzle now execute via `execBatch`.**
+  Multi-row `INSERT` statements without `RETURNING` in `firebird-wasm/kysely`
+  and `firebird-wasm/drizzle` now route through `db.execBatch('INSERT INTO …
+  VALUES (?, …)', rows)` instead of `INSERT INTO … SELECT ? FROM RDB$DATABASE
+  UNION ALL …`, avoiding Firebird SQL error `-804` (`Data type unknown`) on
+  untyped `?` parameter markers in `SELECT` projection lists.
+- **WASM build script (`wasm/build.sh`) and CI fixes.** Passes `-C1` to
+  `git apply --reverse --check` when verifying already-applied patches, passes
+  `-DCMAKE_C_FLAGS="-std=gnu11 -Wno-implicit-int"` during the native host
+  bootstrap configure for GCC 15 compatibility, and pins Playwright CI jobs to
+  `ubuntu-24.04`.
+
+## 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`.
+- **Native `IBatch` in `FirebirdLite.execBatch` (`node-firebird-drivers#178`).**
+  When `statementHandle.createBatchAsync` is available on the native client
+  (merged upstream in [`asfernandes/node-firebird-drivers#178`](https://github.com/asfernandes/node-firebird-drivers/pull/178)),
+  `FirebirdLite.execBatch` and `FirebirdTransaction.execBatch` execute batches
+  through Firebird 4.0+'s `IBatch` API (including `addBlobAsync` with
+  `TAG_BLOB_POLICY = BLOB_ID_ENGINE` so `BLOB` parameters take no per-row round
+  trips), falling back automatically to `EXECUTE BLOCK` on older drivers or
+  Firebird 3.0 servers.
+
+### 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, GCC 15 host bootstrap, 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, passes `-DCMAKE_C_FLAGS="-std=gnu11 -Wno-implicit-int"` so
+  Firebird's `Configure.cmake` checks succeed under GCC 15 (`-std=gnu23`),
+  checks already-applied patches with `-C1`, 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