firebird-wasm 0.7.0 → 0.8.0

package/dist/repl/index.js

@@ -0,0 +1,328 @@
+"use strict";
+/**
+ * firebird-wasm/repl – an interactive SQL console as a custom element.
+ *
+ * ```js
+ * import { defineFirebirdRepl } from 'firebird-wasm/repl';
+ *
+ * defineFirebirdRepl();                       // registers <firebird-repl>
+ * document.querySelector('firebird-repl').db = db;
+ * ```
+ *
+ * A custom element, so it works the same in plain pages, React and Vue: give
+ * it a database through its `db` property.  Type SQL, run it with
+ * Ctrl+Enter (⌘+Enter on a Mac) or the Run button; a script runs statement by
+ * statement (`SET TERM` included) and stops at the first error.  ArrowUp on
+ * the first line and ArrowDown on the last walk the history.
+ *
+ * Every value is written as text, never as HTML, so a row cannot inject
+ * markup into the page.  The element draws in its own shadow root; colours
+ * follow `color-scheme` and can be set with `--firebird-repl-*` properties.
+ *
+ * Nothing runs on import: the class is made by {@link defineFirebirdRepl},
+ * so importing this module where there is no DOM (Node, server rendering) is
+ * harmless.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFirebirdRepl = defineFirebirdRepl;
+const sql_script_1 = require("../browser/sql-script");
+/** At most this many rows of one result are drawn; the rest are counted. */
+const MAX_ROWS = 500;
+const STYLE = `
+:host {
+  --firebird-repl-bg: Canvas;
+  --firebird-repl-fg: CanvasText;
+  --firebird-repl-muted: color-mix(in srgb, CanvasText 55%, Canvas);
+  --firebird-repl-border: color-mix(in srgb, CanvasText 18%, Canvas);
+  --firebird-repl-error: #c62828;
+  --firebird-repl-accent: #b71c1c;
+  --firebird-repl-font: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  display: flex;
+  flex-direction: column;
+  color-scheme: light dark;
+  background: var(--firebird-repl-bg);
+  color: var(--firebird-repl-fg);
+  font: 13px/1.45 var(--firebird-repl-font);
+  border: 1px solid var(--firebird-repl-border);
+  border-radius: 6px;
+  min-height: 12rem;
+  overflow: hidden;
+}
+.output { flex: 1; overflow: auto; padding: 0.5rem 0.75rem; }
+.entry { margin: 0 0 0.75rem; }
+.sql { white-space: pre-wrap; margin: 0; }
+.sql::before { content: '> '; color: var(--firebird-repl-muted); }
+.meta { color: var(--firebird-repl-muted); margin: 0.15rem 0 0; }
+.error { color: var(--firebird-repl-error); white-space: pre-wrap; margin: 0.15rem 0 0; }
+.table { overflow-x: auto; margin-top: 0.25rem; }
+table { border-collapse: collapse; }
+th, td { border: 1px solid var(--firebird-repl-border); padding: 0.1rem 0.5rem; text-align: left; vertical-align: top; white-space: pre; }
+th { font-weight: 600; }
+td.num { text-align: right; }
+.null { color: var(--firebird-repl-muted); font-style: italic; }
+.input { display: flex; border-top: 1px solid var(--firebird-repl-border); }
+textarea {
+  flex: 1; resize: vertical; min-height: 3.5rem; border: 0; padding: 0.5rem 0.75rem;
+  background: transparent; color: inherit; font: inherit; outline: none;
+}
+button {
+  font: inherit; border: 0; border-left: 1px solid var(--firebird-repl-border);
+  background: transparent; color: var(--firebird-repl-accent); padding: 0 1rem; cursor: pointer;
+}
+button:disabled { color: var(--firebird-repl-muted); cursor: default; }
+`;
+/**
+ * Register the element under `tag` (default `firebird-repl`) and return its
+ * class.  Calling it again returns the class already registered.
+ */
+function defineFirebirdRepl(tag = 'firebird-repl') {
+    const existing = customElements.get(tag);
+    if (existing)
+        return existing;
+    class FirebirdRepl extends HTMLElement {
+        constructor() {
+            super();
+            this.database = null;
+            this.history = [];
+            /** Position in `history` while walking it; `history.length` is the draft. */
+            this.cursor = 0;
+            this.draft = '';
+            this.busy = false;
+            const root = this.attachShadow({ mode: 'open' });
+            const style = document.createElement('style');
+            style.textContent = STYLE;
+            this.output = el('div', 'output');
+            this.output.setAttribute('role', 'log');
+            this.output.setAttribute('aria-live', 'polite');
+            const input = el('div', 'input');
+            this.editor = document.createElement('textarea');
+            this.editor.spellcheck = false;
+            this.editor.placeholder = 'SQL; Ctrl+Enter runs it';
+            this.editor.setAttribute('aria-label', 'SQL');
+            this.button = document.createElement('button');
+            this.button.type = 'button';
+            this.button.textContent = 'Run';
+            input.append(this.editor, this.button);
+            root.append(style, this.output, input);
+            this.button.addEventListener('click', () => void this.run());
+            this.editor.addEventListener('keydown', (event) => this.onKey(event));
+            // A property set before the element was defined (React and Vue both
+            // set properties as they render) sits on the instance and would hide
+            // the accessor: take it over.
+            for (const name of ['db', 'value']) {
+                if (Object.prototype.hasOwnProperty.call(this, name)) {
+                    const early = this[name];
+                    delete this[name];
+                    this[name] = early;
+                }
+            }
+        }
+        get db() {
+            return this.database;
+        }
+        set db(db) {
+            this.database = db;
+        }
+        get value() {
+            return this.editor.value;
+        }
+        set value(text) {
+            this.editor.value = text;
+        }
+        clear() {
+            this.output.replaceChildren();
+        }
+        async run(script) {
+            const text = script ?? this.editor.value;
+            if (this.busy || text.trim() === '')
+                return [];
+            if (!this.db) {
+                const entry = {
+                    sql: text.trim(), line: 1, ms: 0,
+                    error: new Error('No database: set the element’s db property first'),
+                };
+                this.show(entry);
+                return [entry];
+            }
+            this.busy = true;
+            this.button.disabled = true;
+            if (this.history[this.history.length - 1] !== text)
+                this.history.push(text);
+            this.cursor = this.history.length;
+            this.draft = '';
+            if (script === undefined)
+                this.editor.value = '';
+            const entries = [];
+            try {
+                let statements;
+                try {
+                    statements = (0, sql_script_1.splitStatements)(text);
+                }
+                catch (err) {
+                    statements = [];
+                    const entry = { sql: text.trim(), line: 1, ms: 0, error: asError(err) };
+                    entries.push(entry);
+                    this.show(entry);
+                }
+                for (const statement of statements) {
+                    const started = performance.now();
+                    const entry = { sql: statement.sql, line: statement.line, ms: 0 };
+                    try {
+                        const db = this.db;
+                        const { hasResultSet } = await db.describeQuery(statement.sql);
+                        if (hasResultSet) {
+                            const result = await db.query(statement.sql, [], { rowMode: 'array' });
+                            entry.fields = result.fields;
+                            entry.rows = result.rows;
+                        }
+                        else {
+                            entry.affectedRows = (await db.transaction((tx) => tx.exec(statement.sql))).affectedRows;
+                        }
+                    }
+                    catch (err) {
+                        entry.error = asError(err);
+                    }
+                    entry.ms = performance.now() - started;
+                    entries.push(entry);
+                    this.show(entry);
+                    if (entry.error)
+                        break;
+                }
+            }
+            finally {
+                this.busy = false;
+                this.button.disabled = false;
+            }
+            this.dispatchEvent(new CustomEvent('firebird-repl-run', { detail: entries, bubbles: true, composed: true }));
+            return entries;
+        }
+        onKey(event) {
+            if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {
+                event.preventDefault();
+                void this.run();
+                return;
+            }
+            if (event.key !== 'ArrowUp' && event.key !== 'ArrowDown')
+                return;
+            if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey)
+                return;
+            const { value, selectionStart, selectionEnd } = this.editor;
+            if (selectionStart !== selectionEnd)
+                return;
+            const onFirstLine = !value.slice(0, selectionStart).includes('\n');
+            const onLastLine = !value.slice(selectionEnd).includes('\n');
+            if (event.key === 'ArrowUp' && onFirstLine && this.cursor > 0) {
+                if (this.cursor === this.history.length)
+                    this.draft = value;
+                this.cursor--;
+            }
+            else if (event.key === 'ArrowDown' && onLastLine && this.cursor < this.history.length) {
+                this.cursor++;
+            }
+            else {
+                return;
+            }
+            event.preventDefault();
+            this.editor.value = this.cursor === this.history.length ? this.draft : this.history[this.cursor];
+            const end = this.editor.value.length;
+            this.editor.setSelectionRange(end, end);
+        }
+        show(entry) {
+            const block = el('div', 'entry');
+            const sql = el('pre', 'sql');
+            sql.textContent = entry.sql;
+            block.append(sql);
+            if (entry.error) {
+                const error = el('pre', 'error');
+                error.textContent = entry.error.message;
+                block.append(error);
+            }
+            else {
+                const fields = entry.fields ?? [];
+                const rows = entry.rows ?? [];
+                if (fields.length > 0)
+                    block.append(table(fields, rows));
+                const meta = el('p', 'meta');
+                meta.textContent = `${summary(entry, fields.length > 0)} · ${entry.ms.toFixed(1)} ms`;
+                block.append(meta);
+            }
+            this.output.append(block);
+            this.output.scrollTop = this.output.scrollHeight;
+        }
+    }
+    customElements.define(tag, FirebirdRepl);
+    return FirebirdRepl;
+}
+function el(tag, className) {
+    const node = document.createElement(tag);
+    node.className = className;
+    return node;
+}
+function asError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+function summary(entry, returnsRows) {
+    if (returnsRows) {
+        const n = entry.rows?.length ?? 0;
+        return `${n} ${n === 1 ? 'row' : 'rows'}`;
+    }
+    if (entry.affectedRows !== undefined && entry.affectedRows > 0) {
+        return `${entry.affectedRows} ${entry.affectedRows === 1 ? 'row' : 'rows'} affected`;
+    }
+    return 'done';
+}
+function table(fields, rows) {
+    const wrap = el('div', 'table');
+    const grid = document.createElement('table');
+    const head = document.createElement('tr');
+    for (const field of fields) {
+        const th = document.createElement('th');
+        th.textContent = field.name;
+        if (field.typeName)
+            th.title = field.typeName;
+        head.append(th);
+    }
+    const thead = document.createElement('thead');
+    thead.append(head);
+    const tbody = document.createElement('tbody');
+    for (const row of rows.slice(0, MAX_ROWS)) {
+        const tr = document.createElement('tr');
+        row.forEach((value) => tr.append(cell(value)));
+        tbody.append(tr);
+    }
+    grid.append(thead, tbody);
+    wrap.append(grid);
+    if (rows.length > MAX_ROWS) {
+        const more = el('p', 'meta');
+        more.textContent = `… ${rows.length - MAX_ROWS} more rows not shown`;
+        wrap.append(more);
+    }
+    return wrap;
+}
+/** A value as a table cell, always through textContent. */
+function cell(value) {
+    const td = document.createElement('td');
+    if (value === null || value === undefined) {
+        td.className = 'null';
+        td.textContent = 'NULL';
+    }
+    else if (typeof value === 'number' || typeof value === 'bigint') {
+        td.className = 'num';
+        td.textContent = String(value);
+    }
+    else if (value instanceof Uint8Array) {
+        const hex = Array.from(value.subarray(0, 32), (b) => b.toString(16).padStart(2, '0')).join('');
+        td.textContent = `x'${hex}${value.length > 32 ? '…' : ''}' (${value.length} bytes)`;
+    }
+    else if (value instanceof Date) {
+        td.textContent = value.toISOString();
+    }
+    else if (typeof value === 'object') {
+        td.textContent = JSON.stringify(value);
+    }
+    else {
+        td.textContent = String(value);
+    }
+    return td;
+}
+//# sourceMappingURL=index.js.map

package/dist/repl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repl/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -112,7 +112,8 @@ export interface TransactionOptions {
 /**
  * What each row is.
  *
- * - `'object'` (default) keys every value by its upper-cased column name.
+ * - `'object'` (default) keys every value by its column name as Firebird
+ *   reports it: upper case unless quoted (`AS "title"` stays `title`).
  * - `'array'` gives the values in column order, positionally.
  *
  * Names live in `fields` either way, so `'array'` loses nothing — it trades

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -3,5 +3,5 @@
  * (see {@link cdnArtifacts}).  Kept equal to package.json's by a test, so a
  * release that bumps one and not the other fails before it is published.
  */
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.8.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -6,5 +6,5 @@ exports.VERSION = void 0;
  * (see {@link cdnArtifacts}).  Kept equal to package.json's by a test, so a
  * release that bumps one and not the other fails before it is published.
  */
-exports.VERSION = '0.7.0';
+exports.VERSION = '0.8.0';
 //# sourceMappingURL=version.js.map

package/dist/vue/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * firebird-wasm/vue – composables that keep a component in step with a query.
+ *
+ * ```ts
+ * // main.ts
+ * app.provide(FIREBIRD, db);              // or provideFirebird(db) in a setup()
+ *
+ * // a component's setup()
+ * const { rows, error } = useLiveQuery('SELECT id, title FROM todos ORDER BY id',
+ *   { events: ['todos'] });
+ * ```
+ *
+ * The statement, its parameters and the events may be refs or getters; the
+ * query runs again when what they hold changes.  Vue 3.3 or later
+ * (`toValue`), a peer dependency the package does not install for you.
+ */
+import type { InjectionKey, MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
+import type { QueryableDatabase } from '../frameworks/query-store';
+import type { SqlFragment } from '../sql-tag';
+import type { QueryParams, Row } from '../types';
+export type { QueryableDatabase } from '../frameworks/query-store';
+/** The injection key of the database: `app.provide(FIREBIRD, db)`. */
+export declare const FIREBIRD: InjectionKey<QueryableDatabase>;
+/** Makes `db` the database of this component and those below it. */
+export declare function provideFirebird(db: QueryableDatabase): void;
+/** The database provided above this component. */
+export declare function useFirebird<D extends QueryableDatabase = QueryableDatabase>(): D;
+/** What `useQuery` and `useLiveQuery` return: refs, for a template to read. */
+export interface QueryRefs<T> {
+    /** The latest rows; `undefined` before the first result. */
+    rows: ShallowRef<T[] | undefined>;
+    /** Why the latest run failed; cleared by the next result. */
+    error: ShallowRef<Error | undefined>;
+    /** True until the current statement's first result or error. */
+    loading: Ref<boolean>;
+    /** Run the statement again now. */
+    refresh(): Promise<void>;
+}
+/** Options of {@link useQuery}. */
+export interface UseQueryOptions {
+    /** A database other than the provided one. */
+    db?: QueryableDatabase;
+}
+/** Options of {@link useLiveQuery}. */
+export interface UseLiveQueryOptions extends UseQueryOptions {
+    /** Event names whose firing re-runs the statement (`POST_EVENT`). */
+    events: MaybeRefOrGetter<readonly string[]>;
+    /** Parameters, when the statement is a string with `?` placeholders. */
+    params?: MaybeRefOrGetter<QueryParams | undefined>;
+    /** How often to poll for events, in milliseconds.  @default 250 */
+    pollIntervalMs?: number;
+}
+/**
+ * Run a statement and keep its rows in refs.  It runs again when the SQL or
+ * the parameters change by value.
+ *
+ * ```ts
+ * const done = ref(false);
+ * const { rows } = useQuery('SELECT * FROM todos WHERE done = ?', () => [done.value]);
+ * ```
+ */
+export declare function useQuery<T extends Row = Row>(query: MaybeRefOrGetter<string | SqlFragment>, params?: MaybeRefOrGetter<QueryParams | undefined>, options?: UseQueryOptions): QueryRefs<T>;
+/**
+ * Like {@link useQuery}, and the statement runs again each time one of
+ * `events` fires: `FirebirdBrowser.live()` as a composable.
+ */
+export declare function useLiveQuery<T extends Row = Row>(query: MaybeRefOrGetter<string | SqlFragment>, options: UseLiveQueryOptions): QueryRefs<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAE3E,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,2BAA2B,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,sEAAsE;AACtE,eAAO,MAAM,QAAQ,EAAE,YAAY,CAAC,iBAAiB,CAA2B,CAAC;AAEjF,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAE3D;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,KAAK,CAAC,CAShF;AAED,+EAA+E;AAC/E,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,4DAA4D;IAC5D,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAClC,6DAA6D;IAC7D,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACrC,gEAAgE;IAChE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,mCAAmC;IACnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,EAAE,CAAC,EAAE,iBAAiB,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,qEAAqE;IACrE,MAAM,EAAE,gBAAgB,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC5C,wEAAwE;IACxE,MAAM,CAAC,EAAE,gBAAgB,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACnD,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAC1C,KAAK,EAAE,gBAAgB,CAAC,MAAM,GAAG,WAAW,CAAC,EAC7C,MAAM,CAAC,EAAE,gBAAgB,CAAC,WAAW,GAAG,SAAS,CAAC,EAClD,OAAO,GAAE,eAAoB,GAC5B,SAAS,CAAC,CAAC,CAAC,CAEd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAC9C,KAAK,EAAE,gBAAgB,CAAC,MAAM,GAAG,WAAW,CAAC,EAC7C,OAAO,EAAE,mBAAmB,GAC3B,SAAS,CAAC,CAAC,CAAC,CAQd"}

package/dist/vue/index.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * firebird-wasm/vue – composables that keep a component in step with a query.
+ *
+ * ```ts
+ * // main.ts
+ * app.provide(FIREBIRD, db);              // or provideFirebird(db) in a setup()
+ *
+ * // a component's setup()
+ * const { rows, error } = useLiveQuery('SELECT id, title FROM todos ORDER BY id',
+ *   { events: ['todos'] });
+ * ```
+ *
+ * The statement, its parameters and the events may be refs or getters; the
+ * query runs again when what they hold changes.  Vue 3.3 or later
+ * (`toValue`), a peer dependency the package does not install for you.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIREBIRD = void 0;
+exports.provideFirebird = provideFirebird;
+exports.useFirebird = useFirebird;
+exports.useQuery = useQuery;
+exports.useLiveQuery = useLiveQuery;
+const vue_1 = require("vue");
+const query_store_1 = require("../frameworks/query-store");
+/** The injection key of the database: `app.provide(FIREBIRD, db)`. */
+exports.FIREBIRD = Symbol('firebird-wasm');
+/** Makes `db` the database of this component and those below it. */
+function provideFirebird(db) {
+    (0, vue_1.provide)(exports.FIREBIRD, db);
+}
+/** The database provided above this component. */
+function useFirebird() {
+    const db = (0, vue_1.inject)(exports.FIREBIRD, null);
+    if (db === null) {
+        throw new Error('useFirebird() found no database: app.provide(FIREBIRD, db) or provideFirebird(db) ' +
+            'above this component, or pass { db } to the composable');
+    }
+    return db;
+}
+/**
+ * Run a statement and keep its rows in refs.  It runs again when the SQL or
+ * the parameters change by value.
+ *
+ * ```ts
+ * const done = ref(false);
+ * const { rows } = useQuery('SELECT * FROM todos WHERE done = ?', () => [done.value]);
+ * ```
+ */
+function useQuery(query, params, options = {}) {
+    return useStore(options.db, query, params, () => ({}));
+}
+/**
+ * Like {@link useQuery}, and the statement runs again each time one of
+ * `events` fires: `FirebirdBrowser.live()` as a composable.
+ */
+function useLiveQuery(query, options) {
+    return useStore(options.db, query, options.params, () => {
+        const events = (0, vue_1.toValue)(options.events);
+        if (events.length === 0) {
+            throw new RangeError('useLiveQuery() needs at least one event name; useQuery() runs a statement once');
+        }
+        return { events: [...events], pollIntervalMs: options.pollIntervalMs };
+    });
+}
+function useStore(explicitDb, query, params, storeOptions) {
+    const db = explicitDb ?? useFirebird();
+    const rows = (0, vue_1.shallowRef)(undefined);
+    const error = (0, vue_1.shallowRef)(undefined);
+    const loading = (0, vue_1.ref)(true);
+    let store;
+    let unsubscribe;
+    const target = () => {
+        const statement = (0, query_store_1.resolveStatement)((0, vue_1.toValue)(query), (0, vue_1.toValue)(params));
+        const options = storeOptions();
+        return { statement, options, key: (0, query_store_1.queryKey)(statement.sql, statement.params, options) };
+    };
+    // Watching the key, not the statement: a getter returning a new parameter
+    // array with the same values must not run the query again.
+    (0, vue_1.watch)(() => target().key, () => {
+        const { statement, options } = target();
+        const next = new query_store_1.QueryStore(db, statement.sql, statement.params, options, rows.value);
+        unsubscribe?.();
+        store?.stop();
+        store = next;
+        const sync = () => {
+            const state = next.getSnapshot();
+            rows.value = state.rows;
+            error.value = state.error;
+            loading.value = state.loading;
+        };
+        unsubscribe = next.subscribe(sync);
+        sync();
+        next.start();
+    }, { immediate: true });
+    (0, vue_1.onScopeDispose)(() => {
+        unsubscribe?.();
+        store?.stop();
+    });
+    return {
+        rows,
+        error,
+        loading,
+        refresh: () => store?.refresh() ?? Promise.resolve(),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebird-wasm",
-  "version": "0.7.0",
+  "version": "0.8.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",
@@ -13,7 +13,32 @@
     "./browser": {
       "types": "./dist/browser/index.d.ts",
       "default": "./dist/browser/index.js"
-    }
+    },
+    "./browser/worker-entry": {
+      "types": "./dist/browser/worker-entry.d.ts",
+      "default": "./dist/browser/worker-entry.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "default": "./dist/vue/index.js"
+    },
+    "./repl": {
+      "types": "./dist/repl/index.d.ts",
+      "default": "./dist/repl/index.js"
+    },
+    "./electric": {
+      "types": "./dist/electric/index.d.ts",
+      "default": "./dist/electric/index.js"
+    },
+    "./electric-server": {
+      "types": "./dist/electric-server/index.d.ts",
+      "default": "./dist/electric-server/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -40,15 +65,37 @@
   "dependencies": {
     "node-firebird-driver": "^3.5.0"
   },
+  "peerDependencies": {
+    "react": ">=18",
+    "vue": ">=3.3",
+    "@electric-sql/client": ">=1.5"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "@electric-sql/client": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@electric-sql/client": "^1.5.28",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.14.10",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
     "@typescript-eslint/eslint-plugin": "^7.17.0",
     "@typescript-eslint/parser": "^7.17.0",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "ts-jest": "^29.2.2",
-    "typescript": "^5.5.3"
+    "typescript": "^5.5.3",
+    "vue": "^3.5.22"
   },
   "jest": {
     "preset": "ts-jest",