web3ql-client 1.2.0

package/dist/src/factory-client.js

@@ -0,0 +1,202 @@
+/**
+ * @file   factory-client.ts
+ * @notice High-level client for the Web3QL Factory + Database contracts.
+ *
+ * Entry point for every Web3QL app:
+ * ─────────────────────────────────────────────────────────────
+ *   const web3ql = new Web3QLClient(factoryAddress, signer, keypair, registryAddress);
+ *
+ *   // Register your public key once (one-time, ~40k gas)
+ *   await web3ql.register();
+ *
+ *   // Create a personal database (or get existing)
+ *   const db = await web3ql.getOrCreateDatabase();
+ *
+ *   // Create a table
+ *   const tableAddr = await db.createTable('users', schemaBytes);
+ *
+ *   // Get an encrypted client for that table
+ *   const users = db.table(tableAddr);
+ *
+ *   // Write (auto-encrypts)
+ *   await users.writeRaw(users.deriveKey('users', 1n), '{"name":"Alice"}');
+ */
+import { ethers } from 'ethers';
+import { EncryptedTableClient } from './table-client.js';
+import { PublicKeyRegistryClient } from './registry.js';
+// ─────────────────────────────────────────────────────────────
+//  ABIs
+// ─────────────────────────────────────────────────────────────
+const FACTORY_ABI = [
+    'function createDatabase(string calldata name) external returns (address)',
+    'function getUserDatabases(address user) external view returns (address[] memory)',
+    'function databaseImplementation() external view returns (address)',
+    'function tableImplementation() external view returns (address)',
+    'function databaseCount() external view returns (uint256)',
+    'function removeDatabase(address db) external',
+    'event DatabaseCreated(address indexed owner, address indexed db, uint256 indexed index)',
+    'event DatabaseRemoved(address indexed owner, address indexed db)',
+];
+const DATABASE_ABI = [
+    'function createTable(string calldata name, bytes calldata schemaBytes) external returns (address)',
+    'function getTable(string calldata name) external view returns (address)',
+    'function listTables() external view returns (string[] memory)',
+    'event TableCreated(string name, address indexed tableContract, address indexed owner)',
+];
+// ─────────────────────────────────────────────────────────────
+//  DatabaseClient
+// ─────────────────────────────────────────────────────────────
+export class DatabaseClient {
+    address;
+    contract;
+    signer;
+    keypair;
+    constructor(address, signer, keypair) {
+        this.address = address;
+        this.signer = signer;
+        this.keypair = keypair;
+        this.contract = new ethers.Contract(address, DATABASE_ABI, signer);
+    }
+    /**
+     * Create a new encrypted table inside this database.
+     * @param name        Human-readable table name (matches your schema).
+     * @param schemaBytes ABI-encoded schema from @web3ql/compiler's compileSchema().
+     * @returns           Address of the deployed table proxy.
+     */
+    async createTable(name, schemaBytes) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tx = await this.contract.createTable(name, schemaBytes);
+        const receipt = await tx.wait();
+        const iface = new ethers.Interface(DATABASE_ABI);
+        for (const log of receipt.logs) {
+            try {
+                const parsed = iface.parseLog(log);
+                if (parsed?.name === 'TableCreated') {
+                    return parsed.args['tableContract'];
+                }
+            }
+            catch { /* skip non-matching logs */ }
+        }
+        throw new Error('DatabaseClient.createTable: TableCreated event not found in logs');
+    }
+    /**
+     * Get the address of an existing table by name.
+     * Returns ethers.ZeroAddress if not found.
+     */
+    async getTable(name) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.contract.getTable(name);
+    }
+    /**
+     * List all table names in this database.
+     */
+    async listTables() {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.contract.listTables();
+    }
+    /**
+     * Drop (remove from registry) a table by name.
+     * Records inside the table are NOT purged by this call — they remain
+     * as unreachable ciphertext. Use SchemaManager.dropTable() first to
+     * bulk-delete records if you want storage refunds.
+     */
+    async dropTable(name) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tx = await this.contract.dropTable(name);
+        return tx.wait();
+    }
+    /**
+     * Get an EncryptedTableClient for a specific table address.
+     * Use this after createTable() or getTable() to read/write records.
+     */
+    table(tableAddress) {
+        return new EncryptedTableClient(tableAddress, this.signer, this.keypair);
+    }
+}
+// ─────────────────────────────────────────────────────────────
+//  Web3QLClient  (top-level entry point)
+// ─────────────────────────────────────────────────────────────
+export class Web3QLClient {
+    factory;
+    signer;
+    keypair;
+    registry;
+    constructor(factoryAddress, signer, keypair, registryAddress) {
+        this.signer = signer;
+        this.keypair = keypair;
+        this.factory = new ethers.Contract(factoryAddress, FACTORY_ABI, signer);
+        this.registry = new PublicKeyRegistryClient(registryAddress, signer);
+    }
+    /**
+     * Register the caller's encryption public key on-chain.
+     * Must be called once per address before anyone can share records
+     * with that address.  Safe to call again — will overwrite.
+     */
+    async register() {
+        return this.registry.register(this.keypair);
+    }
+    /**
+     * Check if an address has registered its public key.
+     */
+    async isRegistered(address) {
+        return this.registry.hasKey(address);
+    }
+    /**
+     * Create a new personal database for the calling wallet.
+     * Most users only ever need one database — use getOrCreateDatabase().
+     * @param name  Human-readable label stored immutably on-chain.
+     */
+    async createDatabase(name = '') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tx = await this.factory.createDatabase(name);
+        const receipt = await tx.wait();
+        const iface = new ethers.Interface(FACTORY_ABI);
+        for (const log of receipt.logs) {
+            try {
+                const parsed = iface.parseLog(log);
+                if (parsed?.name === 'DatabaseCreated') {
+                    return new DatabaseClient(parsed.args['db'], this.signer, this.keypair);
+                }
+            }
+            catch { /* skip */ }
+        }
+        throw new Error('Web3QLClient.createDatabase: DatabaseCreated event not found');
+    }
+    /**
+     * Get all database proxies owned by a user.
+     */
+    async getDatabases(owner) {
+        const addr = owner ?? await this.signer.getAddress();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.factory.getUserDatabases(addr);
+    }
+    /**
+     * Return the first existing database for the caller, or create one
+     * if none exists.  Idempotent — safe to call on every app startup.
+     * @param name  Passed to createDatabase() only when a new one is created.
+     */
+    async getOrCreateDatabase(name = '') {
+        const dbs = await this.getDatabases();
+        if (dbs.length > 0) {
+            return new DatabaseClient(dbs[0], this.signer, this.keypair);
+        }
+        return this.createDatabase(name);
+    }
+    /**
+     * Wrap an already-known database address (e.g. loaded from config).
+     */
+    database(address) {
+        return new DatabaseClient(address, this.signer, this.keypair);
+    }
+    /**
+     * Remove a database from the factory’s registry.
+     * The proxy contract is NOT destroyed — it remains on-chain.
+     * After calling this it will no longer appear in getDatabases().
+     */
+    async removeDatabase(dbAddress) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tx = await this.factory.removeDatabase(dbAddress);
+        return tx.wait();
+    }
+}
+//# sourceMappingURL=factory-client.js.map

package/dist/src/factory-client.js.map

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

package/dist/src/index-cache.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @file   index-cache.ts
+ * @notice Web3QL v1.2 — client-side event-sourced index for fast queries.
+ *
+ * Problem:
+ *   The chain stores opaque ciphertext. Without decrypting every record,
+ *   you cannot answer WHERE queries. For small tables this is fine (the
+ *   query engine decrypts in batches). For large tables you need an index.
+ *
+ * Solution — two tiers:
+ *
+ *   Tier 1: Client-side in-memory index (this file)
+ *     • On first load, decrypt all records and build an in-memory lookup map
+ *     • Subscribe to chain events to update the cache incrementally
+ *     • Fast point-lookups and range scans via the query engine
+ *     • Index survives page refreshes when serialised to localStorage/IndexedDB
+ *
+ *   Tier 2: Relay-maintained SQLite index (v1.2 API)
+ *     • The relay sees all writes and maintains a server-side SQLite DB
+ *     • Exposes `/api/connector/query` endpoint for WHERE-based key lookup
+ *     • SDK calls relay to get matching record keys, then reads+decrypts from chain
+ *
+ * Usage (client-side index):
+ * ─────────────────────────────────────────────────────────────
+ *   const cache = new TableIndexCache(tableClient, ownerAddress, schema);
+ *
+ *   // Build index from chain (decrypt all records)
+ *   await cache.build();
+ *
+ *   // Fast in-memory query (no chain reads)
+ *   const results = cache.query()
+ *     .where('email', 'eq', 'alice@example.com')
+ *     .execute();
+ *
+ *   // Subscribe to updates (incrementally maintains index)
+ *   cache.subscribe(provider);
+ *
+ *   // Persist to localStorage
+ *   cache.save('users-index');
+ *   cache.load('users-index');
+ * ─────────────────────────────────────────────────────────────
+ */
+import { ethers } from 'ethers';
+import type { EncryptedTableClient } from './table-client.js';
+import type { SchemaDefinition } from './types.js';
+import { QueryBuilder } from './query.js';
+import type { Row } from './query.js';
+export interface IndexEntry {
+    key: string;
+    data: Row;
+    version: bigint;
+    updatedAt: bigint;
+}
+export interface IndexCacheOptions {
+    /** Batch size for initial build (parallel decrypt). Default: 20. */
+    buildBatchSize?: number;
+    /** Auto-subscribe to write events to keep index fresh. Default: true. */
+    autoSubscribe?: boolean;
+    /** Max records to index. Default: unlimited. */
+    maxRecords?: number;
+}
+export declare class TableIndexCache {
+    private tableClient;
+    private ownerAddress;
+    private schema?;
+    private opts;
+    /** In-memory index: bytes32 key → IndexEntry */
+    private _index;
+    private _built;
+    private _listener?;
+    constructor(tableClient: EncryptedTableClient, ownerAddress: string, schema?: SchemaDefinition, opts?: IndexCacheOptions);
+    /**
+     * Decrypt all owner records from chain and populate the in-memory index.
+     * Returns the number of records indexed.
+     */
+    build(): Promise<number>;
+    /**
+     * Subscribe to on-chain write events. Automatically decrypts and updates
+     * the index when new records are written by the owner.
+     *
+     * @param provider  An ethers Provider with WebSocket or polling support.
+     */
+    subscribe(provider: ethers.Provider): void;
+    /** Stop listening to chain events. */
+    unsubscribe(): void;
+    /** Return a QueryBuilder over all indexed records. No chain reads. */
+    query(): QueryBuilder<Row>;
+    /** Look up a specific record by its bytes32 on-chain key. */
+    get(key: string): IndexEntry | undefined;
+    /** All indexed entries as an array. */
+    all(): IndexEntry[];
+    /** Number of records in the index. */
+    get size(): number;
+    /** True after build() has completed at least once. */
+    get built(): boolean;
+    /** Manually add or update an entry (e.g. after a local write). */
+    upsert(entry: IndexEntry): void;
+    /** Remove an entry from the cache (e.g. after a local delete). */
+    evict(key: string): void;
+    /** Clear the entire index. */
+    clear(): void;
+    /**
+     * Serialise the index to a JSON string.
+     * Store in localStorage or IndexedDB to survive page refreshes.
+     */
+    serialise(): string;
+    /** Restore an index from a previously serialised string. */
+    deserialise(json: string): void;
+    /** Save to localStorage (browser only). */
+    save(storageKey: string): void;
+    /** Load from localStorage (browser only). */
+    load(storageKey: string): boolean;
+}
+export interface RelayQueryRequest {
+    tableAddress: string;
+    where?: {
+        col: string;
+        op: string;
+        val: unknown;
+    }[];
+    orderBy?: {
+        col: string;
+        dir: 'asc' | 'desc';
+    }[];
+    limit?: number;
+    offset?: number;
+}
+export interface RelayQueryResponse {
+    /** bytes32 record keys matching the query */
+    keys: string[];
+    total: number;
+}
+/**
+ * QueryRelayClient — sends WHERE queries to the relay's SQLite index endpoint
+ * and returns matching bytes32 record keys.  The caller then reads+decrypts
+ * from chain using the returned keys.
+ *
+ * This is the v1.2 "fast query" path that avoids decrypting every record.
+ */
+export declare class QueryRelayClient {
+    private baseUrl;
+    constructor(relayBaseUrl: string);
+    /**
+     * Query the relay's index and return matching bytes32 record keys.
+     *
+     * @example
+     *   const { keys } = await relay.query({
+     *     tableAddress: '0x...',
+     *     where: [{ col: 'age', op: 'gt', val: 18 }],
+     *     limit: 50,
+     *   });
+     *   const records = await Promise.all(keys.map(k => tableClient.readPlaintext(k)));
+     */
+    query(req: RelayQueryRequest): Promise<RelayQueryResponse>;
+}
+//# sourceMappingURL=index-cache.d.ts.map

package/dist/src/index-cache.d.ts.map

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

package/dist/src/index-cache.js

@@ -0,0 +1,265 @@
+/**
+ * @file   index-cache.ts
+ * @notice Web3QL v1.2 — client-side event-sourced index for fast queries.
+ *
+ * Problem:
+ *   The chain stores opaque ciphertext. Without decrypting every record,
+ *   you cannot answer WHERE queries. For small tables this is fine (the
+ *   query engine decrypts in batches). For large tables you need an index.
+ *
+ * Solution — two tiers:
+ *
+ *   Tier 1: Client-side in-memory index (this file)
+ *     • On first load, decrypt all records and build an in-memory lookup map
+ *     • Subscribe to chain events to update the cache incrementally
+ *     • Fast point-lookups and range scans via the query engine
+ *     • Index survives page refreshes when serialised to localStorage/IndexedDB
+ *
+ *   Tier 2: Relay-maintained SQLite index (v1.2 API)
+ *     • The relay sees all writes and maintains a server-side SQLite DB
+ *     • Exposes `/api/connector/query` endpoint for WHERE-based key lookup
+ *     • SDK calls relay to get matching record keys, then reads+decrypts from chain
+ *
+ * Usage (client-side index):
+ * ─────────────────────────────────────────────────────────────
+ *   const cache = new TableIndexCache(tableClient, ownerAddress, schema);
+ *
+ *   // Build index from chain (decrypt all records)
+ *   await cache.build();
+ *
+ *   // Fast in-memory query (no chain reads)
+ *   const results = cache.query()
+ *     .where('email', 'eq', 'alice@example.com')
+ *     .execute();
+ *
+ *   // Subscribe to updates (incrementally maintains index)
+ *   cache.subscribe(provider);
+ *
+ *   // Persist to localStorage
+ *   cache.save('users-index');
+ *   cache.load('users-index');
+ * ─────────────────────────────────────────────────────────────
+ */
+import { ethers } from 'ethers';
+import { decodeRow } from './types.js';
+import { query } from './query.js';
+// ─────────────────────────────────────────────────────────────
+//  TableIndexCache
+// ─────────────────────────────────────────────────────────────
+export class TableIndexCache {
+    tableClient;
+    ownerAddress;
+    schema;
+    opts;
+    /** In-memory index: bytes32 key → IndexEntry */
+    _index = new Map();
+    _built = false;
+    _listener;
+    constructor(tableClient, ownerAddress, schema, opts = {}) {
+        this.tableClient = tableClient;
+        this.ownerAddress = ownerAddress;
+        this.schema = schema;
+        this.opts = {
+            buildBatchSize: opts.buildBatchSize ?? 20,
+            autoSubscribe: opts.autoSubscribe ?? true,
+            maxRecords: opts.maxRecords ?? Infinity,
+        };
+    }
+    // ── Build ───────────────────────────────────────────────────
+    /**
+     * Decrypt all owner records from chain and populate the in-memory index.
+     * Returns the number of records indexed.
+     */
+    async build() {
+        const total = Number(await this.tableClient.ownerRecordCount(this.ownerAddress));
+        const clampedTotal = Math.min(total, this.opts.maxRecords);
+        const BATCH = this.opts.buildBatchSize;
+        for (let i = 0; i < clampedTotal; i += BATCH) {
+            const keys = await this.tableClient.listOwnerRecords(this.ownerAddress, BigInt(i), BigInt(Math.min(BATCH, clampedTotal - i)));
+            const settled = await Promise.allSettled(keys.map(async (k) => {
+                const raw = await this.tableClient.readRaw(k);
+                const plain = await this.tableClient.readPlaintext(k);
+                const parsed = JSON.parse(plain);
+                const data = this.schema ? decodeRow(this.schema, parsed) : parsed;
+                return {
+                    key: k,
+                    data,
+                    version: raw.version,
+                    updatedAt: raw.updatedAt,
+                };
+            }));
+            for (const r of settled) {
+                if (r.status === 'fulfilled') {
+                    this._index.set(r.value.key, r.value);
+                }
+            }
+        }
+        this._built = true;
+        return this._index.size;
+    }
+    // ── Live subscription ───────────────────────────────────────
+    /**
+     * Subscribe to on-chain write events. Automatically decrypts and updates
+     * the index when new records are written by the owner.
+     *
+     * @param provider  An ethers Provider with WebSocket or polling support.
+     */
+    subscribe(provider) {
+        // Listen to the raw Transfer-like events on the table contract.
+        // Web3QL contracts emit a Write(bytes32 key, address owner) event.
+        const iface = new ethers.Interface([
+            'event RecordWritten(bytes32 indexed key, address indexed owner)',
+            'event RecordUpdated(bytes32 indexed key, address indexed owner)',
+            'event RecordDeleted(bytes32 indexed key, address indexed owner)',
+        ]);
+        const contract = new ethers.Contract(this.tableClient.tableAddress, iface, provider);
+        const onWrite = async (key, owner) => {
+            if (owner.toLowerCase() !== this.ownerAddress.toLowerCase())
+                return;
+            try {
+                const raw = await this.tableClient.readRaw(key);
+                const plain = await this.tableClient.readPlaintext(key);
+                const parsed = JSON.parse(plain);
+                const data = this.schema ? decodeRow(this.schema, parsed) : parsed;
+                this._index.set(key, { key, data, version: raw.version, updatedAt: raw.updatedAt });
+            }
+            catch { /* record inaccessible — skip */ }
+        };
+        const onDelete = (key) => {
+            this._index.delete(key);
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        contract.on('RecordWritten', onWrite);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        contract.on('RecordUpdated', onWrite);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        contract.on('RecordDeleted', onDelete);
+        this._listener = () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            contract.off('RecordWritten', onWrite);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            contract.off('RecordUpdated', onWrite);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            contract.off('RecordDeleted', onDelete);
+        };
+    }
+    /** Stop listening to chain events. */
+    unsubscribe() {
+        this._listener?.();
+        this._listener = undefined;
+    }
+    // ── Query ───────────────────────────────────────────────────
+    /** Return a QueryBuilder over all indexed records. No chain reads. */
+    query() {
+        return query(Array.from(this._index.values()).map((e) => e.data));
+    }
+    /** Look up a specific record by its bytes32 on-chain key. */
+    get(key) {
+        return this._index.get(key);
+    }
+    /** All indexed entries as an array. */
+    all() {
+        return Array.from(this._index.values());
+    }
+    /** Number of records in the index. */
+    get size() { return this._index.size; }
+    /** True after build() has completed at least once. */
+    get built() { return this._built; }
+    // ── Invalidation ────────────────────────────────────────────
+    /** Manually add or update an entry (e.g. after a local write). */
+    upsert(entry) {
+        this._index.set(entry.key, entry);
+    }
+    /** Remove an entry from the cache (e.g. after a local delete). */
+    evict(key) {
+        this._index.delete(key);
+    }
+    /** Clear the entire index. */
+    clear() {
+        this._index.clear();
+        this._built = false;
+    }
+    // ── Persistence ─────────────────────────────────────────────
+    /**
+     * Serialise the index to a JSON string.
+     * Store in localStorage or IndexedDB to survive page refreshes.
+     */
+    serialise() {
+        const entries = Array.from(this._index.values()).map((e) => ({
+            key: e.key,
+            data: e.data,
+            version: e.version.toString(),
+            updatedAt: e.updatedAt.toString(),
+        }));
+        return JSON.stringify({ version: 1, entries });
+    }
+    /** Restore an index from a previously serialised string. */
+    deserialise(json) {
+        const { entries } = JSON.parse(json);
+        for (const e of entries) {
+            this._index.set(e.key, {
+                key: e.key,
+                data: e.data,
+                version: BigInt(e.version),
+                updatedAt: BigInt(e.updatedAt),
+            });
+        }
+        this._built = true;
+    }
+    /** Save to localStorage (browser only). */
+    save(storageKey) {
+        const ls = globalThis['localStorage'];
+        if (!ls)
+            return;
+        ls.setItem(storageKey, this.serialise());
+    }
+    /** Load from localStorage (browser only). */
+    load(storageKey) {
+        const ls = globalThis['localStorage'];
+        if (!ls)
+            return false;
+        const raw = ls.getItem(storageKey);
+        if (!raw)
+            return false;
+        this.deserialise(raw);
+        return true;
+    }
+}
+/**
+ * QueryRelayClient — sends WHERE queries to the relay's SQLite index endpoint
+ * and returns matching bytes32 record keys.  The caller then reads+decrypts
+ * from chain using the returned keys.
+ *
+ * This is the v1.2 "fast query" path that avoids decrypting every record.
+ */
+export class QueryRelayClient {
+    baseUrl;
+    constructor(relayBaseUrl) {
+        this.baseUrl = relayBaseUrl.replace(/\/$/, '');
+    }
+    /**
+     * Query the relay's index and return matching bytes32 record keys.
+     *
+     * @example
+     *   const { keys } = await relay.query({
+     *     tableAddress: '0x...',
+     *     where: [{ col: 'age', op: 'gt', val: 18 }],
+     *     limit: 50,
+     *   });
+     *   const records = await Promise.all(keys.map(k => tableClient.readPlaintext(k)));
+     */
+    async query(req) {
+        const url = `${this.baseUrl}/api/connector/query`;
+        const resp = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(req),
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`QueryRelayClient: relay returned ${resp.status}: ${text}`);
+        }
+        return resp.json();
+    }
+}
+//# sourceMappingURL=index-cache.js.map

package/dist/src/index-cache.js.map

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