web3ql-client 1.2.0

package/dist/src/typed-table.js

@@ -0,0 +1,246 @@
+/**
+ * @file   typed-table.ts
+ * @notice High-level Prisma-style API for Web3QL encrypted tables.
+ *
+ * v1.1 upgrades:
+ *   • Optional SchemaDefinition support — auto validates, encodes, and decodes
+ *     fields using the extended type system (TIMESTAMP, UUID, ENUM, DECIMAL, etc.)
+ *   • NOT NULL + DEFAULT enforcement on write
+ *   • findMany with full query builder support: where/orderBy/limit/select/distinct
+ *   • findAll — convenience method (fetches + decrypts all records in batches)
+ *   • aggregate — COUNT/SUM/AVG/MIN/MAX over filtered decrypted records
+ *   • seed — bulk insert an array of records
+ *
+ * Usage (basic, schema-less — identical to v1.0):
+ * ─────────────────────────────────────────────────────────────
+ *   const users = new TypedTableClient<User>('users', db.table('0xTABLE'))
+ *   await users.create(1n, { id: 1n, name: 'Alice' })
+ *   const alice = await users.findUnique(1n)
+ *
+ * Usage (with schema for validation + type coercion):
+ * ─────────────────────────────────────────────────────────────
+ *   const schema: SchemaDefinition = [
+ *     { name: 'id',        type: 'INT',       primaryKey: true },
+ *     { name: 'name',      type: 'TEXT',       notNull: true },
+ *     { name: 'email',     type: 'TEXT',       notNull: true },
+ *     { name: 'createdAt', type: 'TIMESTAMP',  default: () => new Date() },
+ *     { name: 'role',      type: 'ENUM',       enumValues: ['user','admin'], default: 'user' },
+ *   ]
+ *   const users = new TypedTableClient<User>('users', db.table('0xADDR'), schema)
+ *
+ *   // findMany with query builder
+ *   const admins = await users.findMany(ownerAddr, {
+ *     where:   [['role', 'eq', 'admin']],
+ *     orderBy: [['createdAt', 'desc']],
+ *     limit:   20,
+ *     select:  ['id', 'name', 'email'],
+ *   })
+ * ─────────────────────────────────────────────────────────────
+ */
+import { validateAndEncode, decodeRow, } from './types.js';
+import { query as buildQuery, } from './query.js';
+// ─────────────────────────────────────────────────────────────
+//  TypedTableClient
+// ─────────────────────────────────────────────────────────────
+export class TypedTableClient {
+    tableName;
+    inner;
+    schema;
+    /**
+     * @param tableName  Must match the name used in the SQL schema and createTable().
+     * @param inner      An EncryptedTableClient from DatabaseClient.table(address).
+     * @param schema     Optional field descriptors — enables validation, type coercion,
+     *                   NOT NULL enforcement, and DEFAULT values.
+     */
+    constructor(tableName, inner, schema) {
+        this.tableName = tableName;
+        this.inner = inner;
+        this.schema = schema;
+    }
+    // ── Key helper ─────────────────────────────────────────────
+    /** Derive the canonical bytes32 on-chain key for a given primary key id. */
+    key(id) {
+        return this.inner.deriveKey(this.tableName, id);
+    }
+    // ── Internal encode/decode ──────────────────────────────────
+    encode(data) {
+        if (this.schema) {
+            const wire = validateAndEncode(this.schema, data);
+            return JSON.stringify(wire);
+        }
+        return JSON.stringify(data);
+    }
+    decode(plaintext) {
+        const parsed = JSON.parse(plaintext);
+        if (this.schema)
+            return decodeRow(this.schema, parsed);
+        return parsed;
+    }
+    // ── Write ───────────────────────────────────────────────────
+    /**
+     * Validate, encode, encrypt, and store a new record.
+     * Throws if a non-deleted record with the same id already exists.
+     */
+    async create(id, data) {
+        return this.inner.writeRaw(this.key(id), this.encode(data));
+    }
+    /**
+     * Bulk-insert an array of records. Each record must include the primary key field.
+     * Records are written sequentially — fails on first error.
+     */
+    async seed(rows) {
+        const receipts = [];
+        for (const row of rows) {
+            receipts.push(await this.create(row.id, row.data));
+        }
+        return receipts;
+    }
+    // ── Read ────────────────────────────────────────────────────
+    /**
+     * Read and decrypt a single record by primary key.
+     * Returns `null` if the record does not exist or has been deleted.
+     */
+    async findUnique(id) {
+        try {
+            const exists = await this.inner.exists(this.key(id));
+            if (!exists)
+                return null;
+            const plaintext = await this.inner.readPlaintext(this.key(id));
+            return this.decode(plaintext);
+        }
+        catch (err) {
+            const msg = err.message ?? '';
+            if (msg.includes('deleted') || msg.includes('not found') || msg.includes('RecordMeta')) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * List and decrypt all records owned by `ownerAddress`, with optional
+     * client-side filtering, sorting, pagination, and projection.
+     *
+     * ⚠  Records are decrypted client-side. Use `chainLimit` to constrain
+     *    chain reads on large tables. For production scale, use the relay-
+     *    maintained index endpoint (v1.2) instead.
+     */
+    async findMany(ownerAddress, options = {}) {
+        const chainOffset = options.chainOffset ?? 0n;
+        const chainLimit = options.chainLimit ?? 200n;
+        const keys = await this.inner.listOwnerRecords(ownerAddress, chainOffset, chainLimit);
+        const raw = [];
+        // Decrypt in parallel (capped at 20 concurrent RPCs)
+        const BATCH = 20;
+        for (let i = 0; i < keys.length; i += BATCH) {
+            const batch = keys.slice(i, i + BATCH);
+            const settled = await Promise.allSettled(batch.map(async (recordKey) => {
+                const plaintext = await this.inner.readPlaintext(recordKey);
+                return { id: 0n, data: this.decode(plaintext), recordKey };
+            }));
+            for (const r of settled) {
+                if (r.status === 'fulfilled')
+                    raw.push(r.value);
+                // silently skip inaccessible / deleted records
+            }
+        }
+        // Build query
+        let q = buildQuery(raw.map((r) => r.data));
+        if (options.where) {
+            for (const clause of options.where) {
+                if (clause[1] === 'isNull' || clause[1] === 'isNotNull') {
+                    q = q.where(clause[0], clause[1]);
+                }
+                else if (clause[1] === 'in' || clause[1] === 'notIn') {
+                    q = q.where(clause[0], clause[1], clause[2]);
+                }
+                else if (clause[1] === 'between') {
+                    q = q.where(clause[0], clause[1], clause[2]);
+                }
+                else {
+                    q = q.where(clause[0], clause[1], clause[2]);
+                }
+            }
+        }
+        if (options.orderBy) {
+            for (const [field, dir] of options.orderBy)
+                q = q.orderBy(field, dir ?? 'asc');
+        }
+        if (options.limit != null)
+            q = q.limit(options.limit);
+        if (options.offset != null)
+            q = q.offset(options.offset);
+        if (options.select)
+            q = q.select(options.select);
+        if (options.distinct)
+            q = q.distinct(options.distinct);
+        const filteredData = q.execute();
+        // Remap back to RecordWithId — match by index since we decrypted in order
+        return filteredData.map((data, idx) => ({
+            id: 0n,
+            data,
+            recordKey: raw[idx]?.recordKey ?? '',
+        }));
+    }
+    /**
+     * Convenience: fetch and decrypt ALL records the wallet owns (no chain limit).
+     * Useful for small tables or full exports. Decrypts in parallel batches of 20.
+     */
+    async findAll(ownerAddress) {
+        const total = Number(await this.inner.ownerRecordCount(ownerAddress));
+        return this.findMany(ownerAddress, {
+            chainOffset: 0n,
+            chainLimit: BigInt(total),
+        });
+    }
+    /**
+     * Aggregate over owner's records: COUNT, SUM, AVG, MIN, MAX, GROUP BY.
+     *
+     * @example
+     *   await users.aggregate(ownerAddress, { count: '*', groupBy: 'role' })
+     *   // => [{ group: 'admin', count: 3 }, { group: 'user', count: 47 }]
+     */
+    async aggregate(ownerAddress, opts, where, chainLimit) {
+        const records = await this.findMany(ownerAddress, {
+            chainLimit,
+            where,
+        });
+        const rows = records.map((r) => r.data);
+        return buildQuery(rows).aggregate(opts);
+    }
+    // ── Update ──────────────────────────────────────────────────
+    /**
+     * Fetch existing data, merge with `patch`, re-encrypt, and update on-chain.
+     */
+    async update(id, patch) {
+        const current = await this.findUnique(id);
+        if (current === null)
+            throw new Error(`TypedTableClient.update: record ${id} not found`);
+        const merged = { ...current, ...patch };
+        return this.inner.updateRaw(this.key(id), this.encode(merged));
+    }
+    /**
+     * Replace a record's data entirely (no merge).
+     * More gas-efficient when you have the full new payload ready.
+     */
+    async replace(id, data) {
+        return this.inner.updateRaw(this.key(id), this.encode(data));
+    }
+    // ── Delete ──────────────────────────────────────────────────
+    /**
+     * Soft-delete a record. The symmetric key is scrubbed for all collaborators.
+     * Only the record owner can call this.
+     */
+    async remove(id) {
+        return this.inner.deleteRecord(this.key(id));
+    }
+    // ── Helpers ─────────────────────────────────────────────────
+    /** Total number of records ever written by `ownerAddress` (including deleted). */
+    async count(ownerAddress) {
+        return this.inner.ownerRecordCount(ownerAddress);
+    }
+    /** True if a live (non-deleted) record exists for the given id. */
+    async exists(id) {
+        return this.inner.exists(this.key(id));
+    }
+}
+//# sourceMappingURL=typed-table.js.map

package/dist/src/typed-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-table.js","sourceRoot":"","sources":["../../src/typed-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,EAEL,iBAAiB,EACjB,SAAS,GACV,MAAyC,YAAY,CAAC;AACvD,OAAO,EACL,KAAK,IAAI,UAAU,GAKpB,MAAyC,YAAY,CAAC;AAuDvD,gEAAgE;AAChE,oBAAoB;AACpB,gEAAgE;AAEhE,MAAM,OAAO,gBAAgB;IACnB,SAAS,CAAU;IACnB,KAAK,CAA4B;IACjC,MAAM,CAAuB;IAErC;;;;;OAKG;IACH,YAAY,SAAiB,EAAE,KAA2B,EAAE,MAAyB;QACnF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAO,KAAK,CAAC;QACvB,IAAI,CAAC,MAAM,GAAM,MAAM,CAAC;IAC1B,CAAC;IAED,8DAA8D;IAE9D,4EAA4E;IAC5E,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,+DAA+D;IAEvD,MAAM,CAAC,IAAO;QACpB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAA+B,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAEO,MAAM,CAAC,SAAiB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;QAChE,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAM,CAAC;QAC5D,OAAO,MAAW,CAAC;IACrB,CAAC;IAED,+DAA+D;IAE/D;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAO;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CACR,IAA+B;QAE/B,MAAM,QAAQ,GAAgC,EAAE,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+DAA+D;IAE/D;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,IAAI,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACvF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,YAAqB,EACrB,UAAiC,EAAE;QAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAI,OAAO,CAAC,UAAU,IAAK,IAAI,CAAC;QAEhD,MAAM,IAAI,GAAa,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAChG,MAAM,GAAG,GAAsB,EAAE,CAAC;QAElC,qDAAqD;QACrD,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;gBAC5B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;gBAC5D,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;YAC7D,CAAC,CAAC,CACH,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAChD,+CAA+C;YACjD,CAAC;QACH,CAAC;QAED,cAAc;QACd,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAA+B,CAAC,CAAC,CAAC;QAEtE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;oBACxD,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpC,CAAC;qBAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;oBACvD,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAc,CAAC,CAAC;gBAC5D,CAAC;qBAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;oBACnC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAuB,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,IAAK,IAAI;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI;YAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM;YAAU,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,QAAQ;YAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE7D,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,EAAkB,CAAC;QAEjD,0EAA0E;QAC1E,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACtC,EAAE,EAAS,EAAE;YACb,IAAI;YACJ,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,SAAS,IAAI,EAAE;SACrC,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,YAAoB;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE;YACjC,WAAW,EAAE,EAAE;YACf,UAAU,EAAG,MAAM,CAAC,KAAK,CAAC;SAC3B,CAA+B,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,YAAsB,EACtB,IAAgC,EAChC,KAA4B,EAC5B,UAAsB;QAEtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE;YAChD,UAAU;YACV,KAAK;SACN,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAA+B,CAAC,CAAC;QACnE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,+DAA+D;IAE/D;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAiB;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,EAAE,YAAY,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAO,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,IAAO;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,+DAA+D;IAE/D;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,+DAA+D;IAE/D,kFAAkF;IAClF,KAAK,CAAC,KAAK,CAAC,YAAoB;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/src/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file   types.ts
+ * @notice Web3QL v1.1 — extended type system with serialization, validation,
+ *         DEFAULT/NOT NULL enforcement, and codec helpers.
+ *
+ * Every type maps: JS value ↔ JSON-storable "wire" representation.
+ * The chain stores the JSON string; this module handles encode/decode.
+ */
+export type FieldType = 'INT' | 'BIGINT' | 'UINT8' | 'UINT16' | 'UINT32' | 'UINT64' | 'TEXT' | 'BOOL' | 'FLOAT' | 'ADDRESS' | 'TIMESTAMP' | 'DATE' | 'UUID' | 'BYTES32' | 'JSON' | 'JSONB' | 'ENUM' | 'DECIMAL';
+/** Sentinel value stored on-chain when a nullable field has no value. */
+export declare const NULL_SENTINEL = "__NULL__";
+export interface FieldDescriptor {
+    name: string;
+    type: FieldType;
+    primaryKey?: boolean;
+    notNull?: boolean;
+    /** Static default value OR factory function called on each write */
+    default?: unknown | (() => unknown);
+    /** ENUM: ordered list of string labels */
+    enumValues?: string[];
+    /** DECIMAL: [totalDigits, decimalPlaces] */
+    precision?: [number, number];
+}
+export type SchemaDefinition = FieldDescriptor[];
+/** Encode a JS value → wire format (to be JSON-stringified and stored). */
+export declare function encodeFieldValue(field: FieldDescriptor, value: unknown): unknown;
+/** Decode a wire-format value → typed JS value. */
+export declare function decodeFieldValue(field: FieldDescriptor, value: unknown): unknown;
+/**
+ * Validate and normalise a plain JS object before writing to the chain.
+ *
+ * • Applies DEFAULT values for missing fields
+ * • Enforces NOT NULL for fields without a default
+ * • Encodes each field to its wire representation
+ *
+ * @param schema  SchemaDefinition for this table
+ * @param row     Raw user input object
+ * @returns       Wire-ready object (to be JSON.stringify'd and encrypted)
+ */
+export declare function validateAndEncode(schema: SchemaDefinition, row: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Decode a wire-format JSON object back to typed JS values.
+ *
+ * @param schema  SchemaDefinition for this table
+ * @param wire    Object from JSON.parse(plaintext)
+ */
+export declare function decodeRow(schema: SchemaDefinition, wire: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,SAAS,GACjB,KAAK,GACL,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,WAAW,GACX,MAAM,GACN,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,CAAC;AAEd,yEAAyE;AACzE,eAAO,MAAM,aAAa,aAAa,CAAC;AAMxC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAS,MAAM,CAAC;IACpB,IAAI,EAAS,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAK,OAAO,CAAC;IACrB,oEAAoE;IACpE,OAAO,CAAC,EAAK,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACvC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4CAA4C;IAC5C,SAAS,CAAC,EAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GAAG,eAAe,EAAE,CAAC;AA8GjD,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAqBhF;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAuBhF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCzB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/src/types.js

@@ -0,0 +1,222 @@
+/**
+ * @file   types.ts
+ * @notice Web3QL v1.1 — extended type system with serialization, validation,
+ *         DEFAULT/NOT NULL enforcement, and codec helpers.
+ *
+ * Every type maps: JS value ↔ JSON-storable "wire" representation.
+ * The chain stores the JSON string; this module handles encode/decode.
+ */
+/** Sentinel value stored on-chain when a nullable field has no value. */
+export const NULL_SENTINEL = '__NULL__';
+// ─────────────────────────────────────────────────────────────
+//  Type codecs  (encode: JS → wire,  decode: wire → JS)
+// ─────────────────────────────────────────────────────────────
+function encodeInt(v) {
+    if (typeof v === 'bigint')
+        return v.toString();
+    if (typeof v === 'number')
+        return Math.trunc(v).toString();
+    return String(v);
+}
+function decodeInt(v) { return BigInt(String(v)); }
+function encodeFloat(v) {
+    const n = Number(v);
+    if (!isFinite(n))
+        throw new TypeError(`FLOAT: expected finite number, got ${v}`);
+    // Store as scaled integer to avoid float drift
+    return Math.round(n * 1_000_000);
+}
+function decodeFloat(v) { return Number(v) / 1_000_000; }
+function encodeTimestamp(v) {
+    if (v instanceof Date)
+        return v.getTime();
+    if (typeof v === 'number')
+        return v;
+    if (typeof v === 'string')
+        return new Date(v).getTime();
+    throw new TypeError(`TIMESTAMP: expected Date or number, got ${typeof v}`);
+}
+function decodeTimestamp(v) { return new Date(Number(v)); }
+function encodeDate(v) {
+    const ms = encodeTimestamp(v);
+    // Truncate to midnight UTC
+    return ms - (ms % 86_400_000);
+}
+function decodeDate(v) {
+    const d = new Date(Number(v));
+    d.setUTCHours(0, 0, 0, 0);
+    return d;
+}
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function encodeUUID(v) {
+    const s = String(v).toLowerCase();
+    if (!UUID_RE.test(s))
+        throw new TypeError(`UUID: invalid format "${s}"`);
+    return s;
+}
+const BYTES32_RE = /^0x[0-9a-f]{64}$/i;
+function encodeBytes32(v) {
+    const s = String(v).toLowerCase();
+    if (!BYTES32_RE.test(s))
+        throw new TypeError(`BYTES32: expected 0x-prefixed 64-hex-char string, got "${s}"`);
+    return s;
+}
+const ADDRESS_RE = /^0x[0-9a-f]{40}$/i;
+function encodeAddress(v) {
+    const s = String(v).toLowerCase();
+    if (!ADDRESS_RE.test(s))
+        throw new TypeError(`ADDRESS: invalid EVM address "${s}"`);
+    return s;
+}
+function encodeUint(bits, v) {
+    const n = Number(v);
+    const max = bits === 8 ? 255 : bits === 16 ? 65535 : 4294967295;
+    if (!Number.isInteger(n) || n < 0 || n > max) {
+        throw new RangeError(`UINT${bits}: value ${n} out of range [0, ${max}]`);
+    }
+    return n;
+}
+function encodeUint64(v) {
+    const n = BigInt(String(v));
+    if (n < 0n)
+        throw new RangeError(`UINT64: value must be non-negative`);
+    return n.toString();
+}
+function encodeJSON(v) {
+    // Validate it round-trips cleanly
+    JSON.parse(JSON.stringify(v));
+    return v;
+}
+function encodeEnum(field, v) {
+    const labels = field.enumValues ?? [];
+    if (typeof v === 'number') {
+        if (v < 0 || v >= labels.length)
+            throw new RangeError(`ENUM: index ${v} out of range [0,${labels.length})`);
+        return v;
+    }
+    const idx = labels.indexOf(String(v));
+    if (idx === -1)
+        throw new TypeError(`ENUM: "${v}" not in [${labels.join(', ')}]`);
+    return idx;
+}
+function decodeEnum(field, v) {
+    const labels = field.enumValues ?? [];
+    const idx = Number(v);
+    return labels[idx] ?? String(v);
+}
+function encodeDecimal(field, v) {
+    const n = Number(v);
+    if (!isFinite(n))
+        throw new TypeError(`DECIMAL: expected finite number, got ${v}`);
+    const scale = field.precision?.[1] ?? 2;
+    return n.toFixed(scale);
+}
+function decodeDecimal(v) { return parseFloat(String(v)); }
+// ─────────────────────────────────────────────────────────────
+//  Public encode / decode helpers
+// ─────────────────────────────────────────────────────────────
+/** Encode a JS value → wire format (to be JSON-stringified and stored). */
+export function encodeFieldValue(field, value) {
+    switch (field.type) {
+        case 'INT':
+        case 'BIGINT': return encodeInt(value);
+        case 'UINT8': return encodeUint(8, value);
+        case 'UINT16': return encodeUint(16, value);
+        case 'UINT32': return encodeUint(32, value);
+        case 'UINT64': return encodeUint64(value);
+        case 'TEXT': return String(value);
+        case 'BOOL': return Boolean(value);
+        case 'FLOAT': return encodeFloat(value);
+        case 'ADDRESS': return encodeAddress(value);
+        case 'TIMESTAMP': return encodeTimestamp(value);
+        case 'DATE': return encodeDate(value);
+        case 'UUID': return encodeUUID(value);
+        case 'BYTES32': return encodeBytes32(value);
+        case 'JSON':
+        case 'JSONB': return encodeJSON(value);
+        case 'ENUM': return encodeEnum(field, value);
+        case 'DECIMAL': return encodeDecimal(field, value);
+    }
+}
+/** Decode a wire-format value → typed JS value. */
+export function decodeFieldValue(field, value) {
+    if (value === NULL_SENTINEL)
+        return null;
+    if (value === null || value === undefined)
+        return value;
+    switch (field.type) {
+        case 'INT':
+        case 'BIGINT': return decodeInt(value);
+        case 'UINT64': return BigInt(String(value));
+        case 'UINT8':
+        case 'UINT16':
+        case 'UINT32': return Number(value);
+        case 'TEXT':
+        case 'UUID':
+        case 'BYTES32':
+        case 'ADDRESS': return String(value);
+        case 'BOOL': return Boolean(value);
+        case 'FLOAT': return decodeFloat(value);
+        case 'TIMESTAMP': return decodeTimestamp(value);
+        case 'DATE': return decodeDate(value);
+        case 'JSON':
+        case 'JSONB': return value;
+        case 'ENUM': return decodeEnum(field, value);
+        case 'DECIMAL': return decodeDecimal(value);
+    }
+}
+// ─────────────────────────────────────────────────────────────
+//  Row-level validation — NOT NULL + DEFAULT + type coerce
+// ─────────────────────────────────────────────────────────────
+/**
+ * Validate and normalise a plain JS object before writing to the chain.
+ *
+ * • Applies DEFAULT values for missing fields
+ * • Enforces NOT NULL for fields without a default
+ * • Encodes each field to its wire representation
+ *
+ * @param schema  SchemaDefinition for this table
+ * @param row     Raw user input object
+ * @returns       Wire-ready object (to be JSON.stringify'd and encrypted)
+ */
+export function validateAndEncode(schema, row) {
+    const out = {};
+    for (const field of schema) {
+        let value = row[field.name];
+        // Apply default if value is absent
+        if (value === undefined || value === null) {
+            if (field.default !== undefined) {
+                value = typeof field.default === 'function'
+                    ? field.default()
+                    : field.default;
+            }
+        }
+        // NOT NULL enforcement
+        if ((value === undefined || value === null) && field.notNull) {
+            throw new TypeError(`Field "${field.name}" is NOT NULL but no value or default was provided.`);
+        }
+        // Skip truly absent optional fields (store as NULL_SENTINEL for type safety)
+        if (value === undefined || value === null) {
+            out[field.name] = NULL_SENTINEL;
+            continue;
+        }
+        out[field.name] = encodeFieldValue(field, value);
+    }
+    return out;
+}
+/**
+ * Decode a wire-format JSON object back to typed JS values.
+ *
+ * @param schema  SchemaDefinition for this table
+ * @param wire    Object from JSON.parse(plaintext)
+ */
+export function decodeRow(schema, wire) {
+    const out = {};
+    const byName = new Map(schema.map((f) => [f.name, f]));
+    for (const [key, value] of Object.entries(wire)) {
+        const field = byName.get(key);
+        out[key] = field ? decodeFieldValue(field, value) : value;
+    }
+    return out;
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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