@symbiote-native/sqlite 0.1.0

package/build-ngc/core/storage.js

@@ -0,0 +1,383 @@
+// Ported from expo-sqlite's Storage.ts (.vendors/expo @ origin/sdk-57,
+// packages/expo-sqlite/src/Storage.ts), renamed with this repo's `I`-prefix convention.
+//
+// Published on its own subpath (`@symbiote-native/sqlite/kv-store`) rather than the package
+// root — see the README for why.
+import AwaitLock from 'await-lock';
+import { openDatabaseAsync, openDatabaseSync } from './sqlite-database';
+import { normalizeStorageIndex } from './param-utils';
+const DATABASE_VERSION = 1;
+const STATEMENT_GET = 'SELECT value FROM storage WHERE key = ?;';
+const STATEMENT_SET = 'INSERT INTO storage (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value;';
+const STATEMENT_REMOVE = 'DELETE FROM storage WHERE key = ?;';
+const STATEMENT_GET_ALL_KEYS = 'SELECT key FROM storage;';
+const STATEMENT_CLEAR = 'DELETE FROM storage;';
+const STATEMENT_LENGTH = 'SELECT COUNT(*) as count FROM storage;';
+const STATEMENT_GET_KEY_BY_INDEX = 'SELECT key FROM storage LIMIT 1 OFFSET ?;';
+const MIGRATION_STATEMENT_0 = 'CREATE TABLE IF NOT EXISTS storage (key TEXT PRIMARY KEY NOT NULL, value TEXT);';
+/**
+ * A key-value store backed by SQLite. The constructor's `databaseName` is the database file
+ * name used for storage.
+ */
+export class SQLiteStorage {
+    databaseName;
+    db = null;
+    awaitLock = new AwaitLock();
+    constructor(databaseName) {
+        this.databaseName = databaseName;
+    }
+    //#region Asynchronous API
+    /** Retrieves the value for the given key. */
+    async getItemAsync(key) {
+        this.checkValidInput(key);
+        const db = await this.getDbAsync();
+        const result = await db.getFirstAsync(STATEMENT_GET, key);
+        return result?.value ?? null;
+    }
+    /**
+     * Sets the value for the given key. A function computes the new value from the previous one.
+     */
+    async setItemAsync(key, value) {
+        this.checkValidInput(key, value);
+        const db = await this.getDbAsync();
+        if (typeof value === 'function') {
+            await db.withExclusiveTransactionAsync(async (tx) => {
+                const prevResult = await tx.getFirstAsync(STATEMENT_GET, key);
+                const prevValue = prevResult?.value ?? null;
+                const nextValue = value(prevValue);
+                this.checkValidInput(key, nextValue);
+                await tx.runAsync(STATEMENT_SET, key, nextValue);
+            });
+            return;
+        }
+        await db.runAsync(STATEMENT_SET, key, value);
+    }
+    /** Removes the value for the given key. Returns whether a row was actually removed. */
+    async removeItemAsync(key) {
+        this.checkValidInput(key);
+        const db = await this.getDbAsync();
+        const result = await db.runAsync(STATEMENT_REMOVE, key);
+        return result.changes > 0;
+    }
+    /** Retrieves every key stored. */
+    async getAllKeysAsync() {
+        const db = await this.getDbAsync();
+        const result = await db.getAllAsync(STATEMENT_GET_ALL_KEYS);
+        return result.map(({ key }) => key);
+    }
+    /** Clears every key-value pair. Returns whether anything was actually cleared. */
+    async clearAsync() {
+        const db = await this.getDbAsync();
+        const result = await db.runAsync(STATEMENT_CLEAR);
+        return result.changes > 0;
+    }
+    /** Closes the database connection. */
+    async closeAsync() {
+        await this.awaitLock.acquireAsync();
+        try {
+            if (this.db) {
+                await this.db.closeAsync();
+                this.db = null;
+            }
+        }
+        finally {
+            this.awaitLock.release();
+        }
+    }
+    /** Retrieves the number of key-value pairs stored. */
+    async getLengthAsync() {
+        const db = await this.getDbAsync();
+        const result = await db.getFirstAsync(STATEMENT_LENGTH);
+        return result?.count ?? 0;
+    }
+    /** Retrieves the key at the given index. */
+    async getKeyByIndexAsync(index) {
+        const db = await this.getDbAsync();
+        const offset = normalizeStorageIndex(index);
+        if (offset == null) {
+            return null;
+        }
+        const result = await db.getFirstAsync(STATEMENT_GET_KEY_BY_INDEX, offset);
+        return result?.key ?? null;
+    }
+    //#endregion
+    //#region Synchronous API
+    /**
+     * Retrieves the value for the given key.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    getItemSync(key) {
+        this.checkValidInput(key);
+        const db = this.getDbSync();
+        const result = db.getFirstSync(STATEMENT_GET, key);
+        return result?.value ?? null;
+    }
+    /**
+     * Sets the value for the given key. A function computes the new value from the previous one.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    setItemSync(key, value) {
+        this.checkValidInput(key, value);
+        const db = this.getDbSync();
+        if (typeof value === 'function') {
+            db.withTransactionSync(() => {
+                const prevResult = db.getFirstSync(STATEMENT_GET, key);
+                const prevValue = prevResult?.value ?? null;
+                const nextValue = value(prevValue);
+                this.checkValidInput(key, nextValue);
+                db.runSync(STATEMENT_SET, key, nextValue);
+            });
+            return;
+        }
+        db.runSync(STATEMENT_SET, key, value);
+    }
+    /**
+     * Removes the value for the given key. Returns whether a row was actually removed.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    removeItemSync(key) {
+        this.checkValidInput(key);
+        const db = this.getDbSync();
+        const result = db.runSync(STATEMENT_REMOVE, key);
+        return result.changes > 0;
+    }
+    /**
+     * Retrieves every key stored.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    getAllKeysSync() {
+        const db = this.getDbSync();
+        const result = db.getAllSync(STATEMENT_GET_ALL_KEYS);
+        return result.map(({ key }) => key);
+    }
+    /**
+     * Clears every key-value pair. Returns whether anything was actually cleared.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    clearSync() {
+        const db = this.getDbSync();
+        const result = db.runSync(STATEMENT_CLEAR);
+        return result.changes > 0;
+    }
+    /**
+     * Closes the database connection.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    closeSync() {
+        if (this.db) {
+            this.db.closeSync();
+            this.db = null;
+        }
+    }
+    /**
+     * Retrieves the number of key-value pairs stored.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    getLengthSync() {
+        const db = this.getDbSync();
+        const result = db.getFirstSync(STATEMENT_LENGTH);
+        return result?.count ?? 0;
+    }
+    /**
+     * Retrieves the key at the given index.
+     * > **Note:** Running heavy tasks with this function can block the JavaScript thread.
+     */
+    getKeyByIndexSync(index) {
+        const db = this.getDbSync();
+        const offset = normalizeStorageIndex(index);
+        if (offset == null) {
+            return null;
+        }
+        const result = db.getFirstSync(STATEMENT_GET_KEY_BY_INDEX, offset);
+        return result?.key ?? null;
+    }
+    //#endregion
+    //#region react-native-async-storage compatible API
+    /** Alias for `getItemAsync()`. */
+    async getItem(key) {
+        return this.getItemAsync(key);
+    }
+    /** Alias for `setItemAsync()`. */
+    async setItem(key, value) {
+        await this.setItemAsync(key, value);
+    }
+    /** Alias for `removeItemAsync()`. */
+    async removeItem(key) {
+        await this.removeItemAsync(key);
+    }
+    /** Alias for `getAllKeysAsync()`. */
+    async getAllKeys() {
+        return this.getAllKeysAsync();
+    }
+    /** Alias for `clearAsync()`. */
+    async clear() {
+        await this.clearAsync();
+    }
+    /** Merges the given value with the existing value for the key — a deep merge for JSON. */
+    async mergeItem(key, value) {
+        this.checkValidInput(key, value);
+        await this.setItemAsync(key, prevValue => {
+            if (prevValue == null) {
+                return value;
+            }
+            const prevJSON = JSON.parse(prevValue);
+            const newJSON = JSON.parse(value);
+            const mergedJSON = mergeDeep(prevJSON, newJSON);
+            return JSON.stringify(mergedJSON);
+        });
+    }
+    /** Retrieves the values for the given keys. */
+    async multiGet(keys) {
+        return Promise.all(keys.map(async (key) => {
+            this.checkValidInput(key);
+            return [key, await this.getItemAsync(key)];
+        }));
+    }
+    /** Sets multiple key-value pairs. */
+    async multiSet(keyValuePairs) {
+        const db = await this.getDbAsync();
+        await db.withExclusiveTransactionAsync(async (tx) => {
+            for (const [key, value] of keyValuePairs) {
+                this.checkValidInput(key, value);
+                await tx.runAsync(STATEMENT_SET, key, value);
+            }
+        });
+    }
+    /** Removes the values for the given keys. */
+    async multiRemove(keys) {
+        const db = await this.getDbAsync();
+        await db.withExclusiveTransactionAsync(async (tx) => {
+            for (const key of keys) {
+                this.checkValidInput(key);
+                await tx.runAsync(STATEMENT_REMOVE, key);
+            }
+        });
+    }
+    /** Merges multiple key-value pairs — a deep merge for JSON existing values. */
+    async multiMerge(keyValuePairs) {
+        const db = await this.getDbAsync();
+        await db.withExclusiveTransactionAsync(async (tx) => {
+            for (const [key, value] of keyValuePairs) {
+                this.checkValidInput(key, value);
+                const prevValue = await tx.getFirstAsync(STATEMENT_GET, key);
+                if (prevValue == null) {
+                    await tx.runAsync(STATEMENT_SET, key, value);
+                    continue;
+                }
+                const prevJSON = JSON.parse(prevValue.value);
+                const newJSON = JSON.parse(value);
+                const mergedJSON = mergeDeep(prevJSON, newJSON);
+                await tx.runAsync(STATEMENT_SET, key, JSON.stringify(mergedJSON));
+            }
+        });
+    }
+    /** Alias for `closeAsync()`. */
+    async close() {
+        await this.closeAsync();
+    }
+    //#endregion
+    //#region Internals
+    async getDbAsync() {
+        await this.awaitLock.acquireAsync();
+        try {
+            if (!this.db) {
+                const db = await openDatabaseAsync(this.databaseName);
+                await this.maybeMigrateDbAsync(db);
+                this.db = db;
+            }
+        }
+        finally {
+            this.awaitLock.release();
+        }
+        return this.db;
+    }
+    getDbSync() {
+        // Unlike getDbAsync(), this cannot take `awaitLock` — it is promise-based and this method is
+        // synchronous. The migration is idempotent instead, so the next open repairs a database a
+        // race left without a `storage` table.
+        if (!this.db) {
+            const db = openDatabaseSync(this.databaseName);
+            this.maybeMigrateDbSync(db);
+            this.db = db;
+        }
+        return this.db;
+    }
+    maybeMigrateDbAsync(db) {
+        return db.withTransactionAsync(async () => {
+            const result = await db.getFirstAsync('PRAGMA user_version');
+            const currentDbVersion = result?.user_version ?? 0;
+            // Baseline schema, deliberately outside the version ladder below — `CREATE TABLE IF NOT
+            // EXISTS` is a no-op on a healthy database and also repairs one a raced first-run
+            // migration left at `user_version >= 1` with no `storage` table. A new column has to be
+            // added here too, so fresh and repaired databases both get it.
+            await db.execAsync(MIGRATION_STATEMENT_0);
+            // Version ladder: add each new migration below, gated on `currentDbVersion`. Since the
+            // baseline above already carries every column, a ladder entry adding one has to tolerate
+            // it already being there — gate it on `PRAGMA table_info(storage)`, or a fresh database
+            // fails the migration with `duplicate column name`.
+            if (currentDbVersion >= DATABASE_VERSION) {
+                return;
+            }
+            await db.execAsync(`PRAGMA user_version = ${DATABASE_VERSION}`);
+        });
+    }
+    maybeMigrateDbSync(db) {
+        db.withTransactionSync(() => {
+            const result = db.getFirstSync('PRAGMA user_version');
+            const currentDbVersion = result?.user_version ?? 0;
+            // Keep in sync with maybeMigrateDbAsync(), which documents the two steps below.
+            db.execSync(MIGRATION_STATEMENT_0);
+            if (currentDbVersion >= DATABASE_VERSION) {
+                return;
+            }
+            db.execSync(`PRAGMA user_version = ${DATABASE_VERSION}`);
+        });
+    }
+    checkValidInput(...input) {
+        const [key, value] = input;
+        if (typeof key !== 'string') {
+            throw new Error(`[SQLiteStorage] Using ${typeof key} type for key is not supported. Use string instead. Key passed: ${String(key)}`);
+        }
+        if (input.length > 1 &&
+            typeof value !== 'string' &&
+            typeof value !== 'function') {
+            throw new Error(`[SQLiteStorage] Using ${typeof value} type for value is not supported. Use string instead. Key passed: ${key}. Value passed : ${String(value)}`);
+        }
+    }
+}
+/** Recursively merges two JSON-decoded values, concatenating arrays and merging objects. */
+function mergeDeep(target, source) {
+    if (typeof target !== 'object' || target === null || Array.isArray(target)) {
+        return source;
+    }
+    if (typeof source !== 'object' || source === null || Array.isArray(source)) {
+        return target;
+    }
+    // I/O edge: both are JSON.parse() output narrowed only to "non-null, non-array object" above —
+    // JSON itself carries no further static shape to check against.
+    const targetRecord = target;
+    const sourceRecord = source;
+    const output = { ...targetRecord };
+    for (const key of Object.keys(sourceRecord)) {
+        const sourceValue = sourceRecord[key];
+        if (Array.isArray(sourceValue)) {
+            const existing = output[key];
+            output[key] = (Array.isArray(existing) ? existing : []).concat(sourceValue);
+        }
+        else if (typeof sourceValue === 'object' && sourceValue !== null) {
+            output[key] = mergeDeep(targetRecord[key], sourceValue);
+        }
+        else {
+            output[key] = sourceValue;
+        }
+    }
+    return output;
+}
+/**
+ * A drop-in replacement for `AsyncStorage` from `@react-native-async-storage/async-storage`.
+ */
+export const AsyncStorage = new SQLiteStorage('ExpoSQLiteStorage');
+export default AsyncStorage;
+/** Alias for `AsyncStorage`, given the storage offers more than asynchronous methods. */
+export const Storage = AsyncStorage;
+//# sourceMappingURL=storage.js.map

package/build-ngc/core/storage.js.map

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

package/build-ngc/core/types.d.ts

@@ -0,0 +1,30 @@
+import type { SQLiteDatabase } from './sqlite-database';
+import type { ISQLiteOpenOptions } from './native-database';
+/** The event payload for `addDatabaseChangeListener`. */
+export type IDatabaseChangeEvent = {
+    /** The database name — `main` by default, or another name set via `ATTACH DATABASE`. */
+    databaseName: string;
+    /** The absolute file path to the database. */
+    databaseFilePath: string;
+    /** The table name. */
+    tableName: string;
+    /** The changed row ID. */
+    rowId: number;
+};
+/**
+ * Called once, right after the native handle opens and before `openDatabaseAsync`/
+ * `openDatabaseSync` returns the database — e.g. to run `execAsync`/`execSync` migrations.
+ *
+ * **Deviation from upstream:** expo-sqlite only exposes this as a `SQLiteProviderProps.onInit`
+ * field, called by its React `<SQLiteProvider>` after opening, before rendering children. This
+ * package has no Provider yet (per-adapter Provider/hook wrappers are a later, separate pass —
+ * see the README), so `onInit` is exposed directly on `openDatabaseAsync`/`openDatabaseSync`
+ * instead, giving any adapter — or plain module-scope code with no view tree at all — the same
+ * "run this once right after open" hook without needing a Provider to exist first. A future
+ * Provider can still accept its own `onInit` prop and either forward it here or call the
+ * callback itself; that choice is left to that later pass.
+ */
+export type IOnInitCallback = (db: SQLiteDatabase) => Promise<void> | void;
+export type IOpenDatabaseOptions = ISQLiteOpenOptions & {
+    onInit?: IOnInitCallback;
+};

package/build-ngc/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-sqlite",
+    "modules": [
+      {
+        "importPath": "expo.modules.sqlite.SQLiteModule",
+        "className": "SQLiteModule",
+        "nativeName": "ExpoSQLite"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,141 @@
+{
+  "name": "@symbiote-native/sqlite",
+  "version": "0.1.0",
+  "description": "expo-sqlite wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Database / Statement / Session (transactions, changesets), a Bun-style SQL tagged-template helper, and a SQLite-backed key-value store.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-sqlite",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "sqlite",
+    "database",
+    "storage"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/sqlite"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/sqlite#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./kv-store": {
+      "types": "./build/core/storage.d.ts",
+      "default": "./build/core/storage.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./vue": {
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./svelte": {
+      "types": "./build/svelte/index.d.ts",
+      "default": "./build/svelte/index.js"
+    },
+    "./solid": {
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "default": "./build-ngc/angular/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*",
+    "!src/core/native-fakes.ts",
+    "!src/core/better-sqlite3-ambient.d.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-sqlite": "57.0.2",
+    "expo-modules-core": "57.0.5",
+    "await-lock": "^2.2.2"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.86",
+    "react": ">=19.0.0",
+    "vue": ">=3.5.0",
+    "@vue/runtime-core": "^3.5.13",
+    "svelte": ">=5.56.0",
+    "solid-js": ">=1.9.0",
+    "@angular/core": ">=20",
+    "@angular/common": ">=20"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@angular/common": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@types/react-reconciler": "^0.32.2",
+    "better-sqlite3": "^13.0.3",
+    "typescript": "~6.0.0",
+    "react": "19.2.3",
+    "react-reconciler": "^0.33.0",
+    "vue": "^3.5.38",
+    "@vue/runtime-core": "^3.5.13",
+    "svelte": "^5.56.0",
+    "solid-js": "^1.9.14",
+    "@angular/core": "~22.0.8",
+    "@angular/common": "~22.0.8",
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@symbiote-native/svelte": "3.0.2",
+    "@symbiote-native/test-utils": "0.4.2",
+    "@symbiote-native/engine": "1.3.0"
+  },
+  "scripts": {
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "typecheck": "tsc --build",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+export * from '../core';
+export * from './sqlite.service';