web3ql-client 1.2.0

package/dist/src/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @web3ql/sdk — Public API  (v1.2)
+ *
+ * ─────────────────────────────────────────────────────────────
+ *  import {
+ *    // Core clients
+ *    Web3QLClient, DatabaseClient, EncryptedTableClient,
+ *    // High-level typed API
+ *    TypedTableClient,
+ *    // Type system (v1.1+)
+ *    validateAndEncode, decodeRow, encodeFieldValue, decodeFieldValue,
+ *    // Query builder (v1.1+)
+ *    query,
+ *    // Migrations (v1.1+)
+ *    MigrationRunner, addColumn, dropColumn, renameColumn, changeType,
+ *    // Constraints (v1.2)
+ *    ConstraintEngine, ConstraintViolation, AutoIncrementCounter,
+ *    // Index cache (v1.2)
+ *    TableIndexCache, QueryRelayClient,
+ *    // Batch writes (v1.2)
+ *    BatchWriter, buildCrossTableBatch,
+ *    // Access control (v1.2)
+ *    AccessManager, PublicTableClient,
+ *    // Schema management (v1.2)
+ *    SchemaManager, decodeSchemaBytes, diffSchema,
+ *    // Crypto
+ *    deriveKeypairFromWallet,
+ *    Role,
+ *  } from '@web3ql/sdk';
+ * ─────────────────────────────────────────────────────────────
+ */
+export { Web3QLClient, DatabaseClient } from './factory-client.js';
+export { EncryptedTableClient, Role } from './table-client.js';
+export type { RawRecord } from './table-client.js';
+export { PublicKeyRegistryClient } from './registry.js';
+export { TypedTableClient } from './typed-table.js';
+export type { FindManyOptions, RecordWithId, WhereTuple, SchemaDefinition, } from './typed-table.js';
+export { NULL_SENTINEL, validateAndEncode, decodeRow, encodeFieldValue, decodeFieldValue, } from './types.js';
+export type { FieldType, FieldDescriptor } from './types.js';
+export { query, QueryBuilder } from './query.js';
+export type { Row, WhereOperator, WhereClause, OrderByClause, SortDirection, AggregateOptions, AggregateResult, JoinType, JoinClause, TimeBucketUnit, HavingClause, } from './query.js';
+export { MigrationRunner, addColumn, addColumnSchema, dropColumn, dropColumnSchema, renameColumn, renameColumnSchema, changeType, computeColumn, } from './migrations.js';
+export type { Migration, RowTransformer, SchemaTransformer } from './migrations.js';
+export { ConstraintEngine, ConstraintViolation, AutoIncrementCounter, } from './constraints.js';
+export type { Constraint, UniqueConstraint, CheckConstraint, ForeignKeyConstraint, NotNullConstraint, } from './constraints.js';
+export { TableIndexCache, QueryRelayClient, } from './index-cache.js';
+export type { IndexEntry, IndexCacheOptions, RelayQueryRequest, RelayQueryResponse, } from './index-cache.js';
+export { BatchWriter, buildCrossTableBatch, MULTICALL3_ADDRESS, } from './batch.js';
+export type { CrossTableOp } from './batch.js';
+export { AccessManager, PublicTableClient, grantMetaKey, generateColumnKeySet, encryptWithColumnKeys, decryptColumnBlobs, } from './access.js';
+export type { TimedGrant, CapabilityToken, ColumnKeySet, } from './access.js';
+export { SchemaManager, decodeSchemaBytes, diffSchema, } from './schema-manager.js';
+export type { SchemaChange, SchemaChangeType, } from './schema-manager.js';
+export { KEY_DERIVATION_MESSAGE, deriveKeypairFromWallet, // ✅ browser-compatible (recommended)
+deriveKeypair, // ⚠️  deprecated: different keypair to browser
+publicKeyFromPrivate, generateSymmetricKey, encryptData, decryptData, encryptKeyForSelf, encryptKeyForRecipient, decryptKeyForSelf, decryptKeyFromSender, publicKeyToHex, hexToPublicKey, } from './crypto.js';
+export type { EncryptionKeypair } from './crypto.js';
+export { Model } from './model.js';
+export type { ModelOptions, RelatedCreateOptions, } from './model.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAoB,qBAAqB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAsB,mBAAmB,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAkC,mBAAmB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAyB,eAAe,CAAC;AAG3E,OAAO,EAAE,gBAAgB,EAAE,MAAgC,kBAAkB,CAAC;AAC9E,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAA0D,kBAAkB,CAAC;AAG9E,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,MAA0D,YAAY,CAAC;AACxE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAiB,YAAY,CAAC;AAGxE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAA6B,YAAY,CAAC;AACxE,YAAY,EACV,GAAG,EACH,aAAa,EACb,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAA0D,YAAY,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,GACd,MAA0D,iBAAiB,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAA0D,kBAAkB,CAAC;AAC9E,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAA0D,kBAAkB,CAAC;AAG9E,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAA0D,kBAAkB,CAAC;AAC9E,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAA0D,kBAAkB,CAAC;AAG9E,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,kBAAkB,GACnB,MAA0D,YAAY,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,MAA+B,YAAY,CAAC;AAGxE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAA0D,aAAa,CAAC;AACzE,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAA0D,aAAa,CAAC;AAGzE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAA0D,qBAAqB,CAAC;AACjF,YAAY,EACV,YAAY,EACZ,gBAAgB,GACjB,MAA0D,qBAAqB,CAAC;AAGjF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EAAG,qCAAqC;AAC/D,aAAa,EAAa,+CAA+C;AACzE,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,cAAc,GACf,MAA0D,aAAa,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAA0B,aAAa,CAAC;AAGzE,OAAO,EAAE,KAAK,EAAE,MAA2C,YAAY,CAAC;AACxE,YAAY,EACV,YAAY,EACZ,oBAAoB,GACrB,MAA0D,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,60 @@
+/**
+ * @web3ql/sdk — Public API  (v1.2)
+ *
+ * ─────────────────────────────────────────────────────────────
+ *  import {
+ *    // Core clients
+ *    Web3QLClient, DatabaseClient, EncryptedTableClient,
+ *    // High-level typed API
+ *    TypedTableClient,
+ *    // Type system (v1.1+)
+ *    validateAndEncode, decodeRow, encodeFieldValue, decodeFieldValue,
+ *    // Query builder (v1.1+)
+ *    query,
+ *    // Migrations (v1.1+)
+ *    MigrationRunner, addColumn, dropColumn, renameColumn, changeType,
+ *    // Constraints (v1.2)
+ *    ConstraintEngine, ConstraintViolation, AutoIncrementCounter,
+ *    // Index cache (v1.2)
+ *    TableIndexCache, QueryRelayClient,
+ *    // Batch writes (v1.2)
+ *    BatchWriter, buildCrossTableBatch,
+ *    // Access control (v1.2)
+ *    AccessManager, PublicTableClient,
+ *    // Schema management (v1.2)
+ *    SchemaManager, decodeSchemaBytes, diffSchema,
+ *    // Crypto
+ *    deriveKeypairFromWallet,
+ *    Role,
+ *  } from '@web3ql/sdk';
+ * ─────────────────────────────────────────────────────────────
+ */
+// ── Core clients ──────────────────────────────────────────────
+export { Web3QLClient, DatabaseClient } from './factory-client.js';
+export { EncryptedTableClient, Role } from './table-client.js';
+export { PublicKeyRegistryClient } from './registry.js';
+// ── High-level typed API (Prisma-style) ───────────────────────
+export { TypedTableClient } from './typed-table.js';
+// ── v1.1 Type system (encode/decode/validate) ─────────────────
+export { NULL_SENTINEL, validateAndEncode, decodeRow, encodeFieldValue, decodeFieldValue, } from './types.js';
+// ── v1.1 Query builder ────────────────────────────────────────
+export { query, QueryBuilder } from './query.js';
+// ── v1.1 Migration framework ──────────────────────────────────
+export { MigrationRunner, addColumn, addColumnSchema, dropColumn, dropColumnSchema, renameColumn, renameColumnSchema, changeType, computeColumn, } from './migrations.js';
+// ── v1.2 Integrity constraints ────────────────────────────────
+export { ConstraintEngine, ConstraintViolation, AutoIncrementCounter, } from './constraints.js';
+// ── v1.2 Index cache + relay query client ─────────────────────
+export { TableIndexCache, QueryRelayClient, } from './index-cache.js';
+// ── v1.2 Batch writes (Multicall3) ────────────────────────────
+export { BatchWriter, buildCrossTableBatch, MULTICALL3_ADDRESS, } from './batch.js';
+// ── v1.2 Advanced access control ─────────────────────────────
+export { AccessManager, PublicTableClient, grantMetaKey, generateColumnKeySet, encryptWithColumnKeys, decryptColumnBlobs, } from './access.js';
+// ── v1.2 Schema management ────────────────────────────────────
+export { SchemaManager, decodeSchemaBytes, diffSchema, } from './schema-manager.js';
+// ── Crypto primitives ─────────────────────────────────────────
+export { KEY_DERIVATION_MESSAGE, deriveKeypairFromWallet, // ✅ browser-compatible (recommended)
+deriveKeypair, // ⚠️  deprecated: different keypair to browser
+publicKeyFromPrivate, generateSymmetricKey, encryptData, decryptData, encryptKeyForSelf, encryptKeyForRecipient, decryptKeyForSelf, decryptKeyFromSender, publicKeyToHex, hexToPublicKey, } from './crypto.js';
+// ── v1.3 ORM — Model + Relation wires ────────────────────────
+export { Model } from './model.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,iEAAiE;AACjE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAoB,qBAAqB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAsB,mBAAmB,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAyB,eAAe,CAAC;AAE3E,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAgC,kBAAkB,CAAC;AAQ9E,iEAAiE;AACjE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,MAA0D,YAAY,CAAC;AAGxE,iEAAiE;AACjE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAA6B,YAAY,CAAC;AAexE,iEAAiE;AACjE,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,GACd,MAA0D,iBAAiB,CAAC;AAG7E,iEAAiE;AACjE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAA0D,kBAAkB,CAAC;AAS9E,iEAAiE;AACjE,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAA0D,kBAAkB,CAAC;AAQ9E,iEAAiE;AACjE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,kBAAkB,GACnB,MAA0D,YAAY,CAAC;AAGxE,gEAAgE;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAA0D,aAAa,CAAC;AAOzE,iEAAiE;AACjE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAA0D,qBAAqB,CAAC;AAMjF,iEAAiE;AACjE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EAAG,qCAAqC;AAC/D,aAAa,EAAa,+CAA+C;AACzE,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,cAAc,GACf,MAA0D,aAAa,CAAC;AAGzE,gEAAgE;AAChE,OAAO,EAAE,KAAK,EAAE,MAA2C,YAAY,CAAC"}

package/dist/src/migrations.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @file   migrations.ts
+ * @notice Web3QL v1.1 — schema migration framework.
+ *
+ * Because schemas are stored as bytes on-chain, adding or removing columns
+ * is an off-chain SDK concern:
+ *
+ *   • ADD COLUMN  → new field appears with its DEFAULT value for old records
+ *   • DROP COLUMN → field is silently ignored on read, omitted on write
+ *   • RENAME      → read uses old name, write uses new name
+ *   • CHANGE TYPE → codec changes; old wire values are transparently converted
+ *
+ * Migrations are run client-side during read/write. They do NOT require any
+ * contract call or gas. The on-chain ciphertext is re-encrypted with the new
+ * schema on the next write (lazy migration).
+ *
+ * Usage:
+ * ─────────────────────────────────────────────────────────────
+ *   const migrations = new MigrationRunner([
+ *     {
+ *       version: 1,
+ *       description: 'Add role field',
+ *       up: addColumn({ name: 'role', type: 'ENUM', enumValues: ['user','admin'], default: 'user' }),
+ *     },
+ *     {
+ *       version: 2,
+ *       description: 'Rename email → emailAddress',
+ *       up: renameColumn('email', 'emailAddress'),
+ *     },
+ *     {
+ *       version: 3,
+ *       description: 'Drop legacy field',
+ *       up: dropColumn('legacyField'),
+ *     },
+ *   ]);
+ *
+ *   // Apply to a record read from chain
+ *   const migratedData = migrations.applyToRecord(rawDecoded, fromVersion = 0);
+ *
+ *   // Apply to a schema definition (for TypedTableClient)
+ *   const latestSchema = migrations.applyToSchema(v0Schema);
+ * ─────────────────────────────────────────────────────────────
+ */
+import type { SchemaDefinition, FieldDescriptor } from './types.js';
+export type RowTransformer = (row: Record<string, unknown>) => Record<string, unknown>;
+export type SchemaTransformer = (schema: SchemaDefinition) => SchemaDefinition;
+export interface Migration {
+    /** Monotonically increasing version number (1, 2, 3…) */
+    version: number;
+    description: string;
+    /** Transform the row data from previous version to this version */
+    up: RowTransformer;
+    /** Transform the schema definition from previous version to this version */
+    schema?: SchemaTransformer;
+}
+/**
+ * ADD COLUMN — inserts the field with its default value into records
+ * that don't have it yet.
+ */
+export declare function addColumn(field: FieldDescriptor): RowTransformer;
+/** Schema variant of addColumn */
+export declare function addColumnSchema(field: FieldDescriptor): SchemaTransformer;
+/**
+ * DROP COLUMN — removes the field from records.
+ * Old ciphertext data is discarded on next write.
+ */
+export declare function dropColumn(fieldName: string): RowTransformer;
+/** Schema variant of dropColumn */
+export declare function dropColumnSchema(fieldName: string): SchemaTransformer;
+/**
+ * RENAME COLUMN — moves value from oldName to newName.
+ */
+export declare function renameColumn(oldName: string, newName: string): RowTransformer;
+/** Schema variant of renameColumn */
+export declare function renameColumnSchema(oldName: string, newName: string): SchemaTransformer;
+/**
+ * CHANGE TYPE — re-encode a field's value through a transform function.
+ * Supply a function that converts the old wire value to the new wire value.
+ *
+ * @example
+ *   // Convert TEXT → TIMESTAMP (ISO string → unix ms)
+ *   changeType('createdAt', (v) => new Date(String(v)).getTime())
+ */
+export declare function changeType(fieldName: string, transform: (oldValue: unknown) => unknown): RowTransformer;
+/**
+ * COMPUTE COLUMN — derive a new field from existing fields.
+ * Called only if the field is absent (so it doesn't overwrite on re-migrations).
+ */
+export declare function computeColumn(fieldName: string, compute: (row: Record<string, unknown>) => unknown): RowTransformer;
+export declare class MigrationRunner {
+    private migrations;
+    constructor(migrations: Migration[]);
+    /**
+     * Apply all migrations with version > `fromVersion` to a single record row.
+     *
+     * @param row          Decoded record from the chain (before migration)
+     * @param fromVersion  The schema version the record was written at. Use the
+     *                     VERSION field stored in the record, or 0 if absent.
+     */
+    applyToRecord(row: Record<string, unknown>, fromVersion?: number): Record<string, unknown>;
+    /**
+     * Apply all schema migrations from `fromVersion` to the latest version,
+     * producing an up-to-date SchemaDefinition for TypedTableClient.
+     */
+    applyToSchema(baseSchema: SchemaDefinition, fromVersion?: number): SchemaDefinition;
+    /** The latest migration version number. */
+    get latestVersion(): number;
+    /** List all registered migrations in version order. */
+    list(): {
+        version: number;
+        description: string;
+    }[];
+}
+//# sourceMappingURL=migrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMpE,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvF,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,OAAO,EAAM,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,EAAE,EAAW,cAAc,CAAC;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAM,iBAAiB,CAAC;CAChC;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAQhE;AAED,kCAAkC;AAClC,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAKzE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAM5D;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAErE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAO7E;AAED,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAGtF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,GACxC,cAAc,CAKhB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GACnD,cAAc,CAKhB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAc;gBAEpB,UAAU,EAAE,SAAS,EAAE;IAKnC;;;;;;OAMG;IACH,aAAa,CACX,GAAG,EAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,WAAW,GAAE,MAAU,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAU1B;;;OAGG;IACH,aAAa,CACX,UAAU,EAAG,gBAAgB,EAC7B,WAAW,GAAE,MAAU,GACtB,gBAAgB;IAUnB,2CAA2C;IAC3C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,uDAAuD;IACvD,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE;CAGnD"}

package/dist/src/migrations.js

@@ -0,0 +1,173 @@
+/**
+ * @file   migrations.ts
+ * @notice Web3QL v1.1 — schema migration framework.
+ *
+ * Because schemas are stored as bytes on-chain, adding or removing columns
+ * is an off-chain SDK concern:
+ *
+ *   • ADD COLUMN  → new field appears with its DEFAULT value for old records
+ *   • DROP COLUMN → field is silently ignored on read, omitted on write
+ *   • RENAME      → read uses old name, write uses new name
+ *   • CHANGE TYPE → codec changes; old wire values are transparently converted
+ *
+ * Migrations are run client-side during read/write. They do NOT require any
+ * contract call or gas. The on-chain ciphertext is re-encrypted with the new
+ * schema on the next write (lazy migration).
+ *
+ * Usage:
+ * ─────────────────────────────────────────────────────────────
+ *   const migrations = new MigrationRunner([
+ *     {
+ *       version: 1,
+ *       description: 'Add role field',
+ *       up: addColumn({ name: 'role', type: 'ENUM', enumValues: ['user','admin'], default: 'user' }),
+ *     },
+ *     {
+ *       version: 2,
+ *       description: 'Rename email → emailAddress',
+ *       up: renameColumn('email', 'emailAddress'),
+ *     },
+ *     {
+ *       version: 3,
+ *       description: 'Drop legacy field',
+ *       up: dropColumn('legacyField'),
+ *     },
+ *   ]);
+ *
+ *   // Apply to a record read from chain
+ *   const migratedData = migrations.applyToRecord(rawDecoded, fromVersion = 0);
+ *
+ *   // Apply to a schema definition (for TypedTableClient)
+ *   const latestSchema = migrations.applyToSchema(v0Schema);
+ * ─────────────────────────────────────────────────────────────
+ */
+// ─────────────────────────────────────────────────────────────
+//  Built-in migration helpers
+// ─────────────────────────────────────────────────────────────
+/**
+ * ADD COLUMN — inserts the field with its default value into records
+ * that don't have it yet.
+ */
+export function addColumn(field) {
+    return (row) => {
+        if (row[field.name] !== undefined && row[field.name] !== null)
+            return row;
+        const defaultVal = field.default != null
+            ? (typeof field.default === 'function' ? field.default() : field.default)
+            : null;
+        return { ...row, [field.name]: defaultVal };
+    };
+}
+/** Schema variant of addColumn */
+export function addColumnSchema(field) {
+    return (schema) => {
+        if (schema.some((f) => f.name === field.name))
+            return schema;
+        return [...schema, field];
+    };
+}
+/**
+ * DROP COLUMN — removes the field from records.
+ * Old ciphertext data is discarded on next write.
+ */
+export function dropColumn(fieldName) {
+    return (row) => {
+        const out = { ...row };
+        delete out[fieldName];
+        return out;
+    };
+}
+/** Schema variant of dropColumn */
+export function dropColumnSchema(fieldName) {
+    return (schema) => schema.filter((f) => f.name !== fieldName);
+}
+/**
+ * RENAME COLUMN — moves value from oldName to newName.
+ */
+export function renameColumn(oldName, newName) {
+    return (row) => {
+        if (!(oldName in row))
+            return row;
+        const out = { ...row, [newName]: row[oldName] };
+        delete out[oldName];
+        return out;
+    };
+}
+/** Schema variant of renameColumn */
+export function renameColumnSchema(oldName, newName) {
+    return (schema) => schema.map((f) => (f.name === oldName ? { ...f, name: newName } : f));
+}
+/**
+ * CHANGE TYPE — re-encode a field's value through a transform function.
+ * Supply a function that converts the old wire value to the new wire value.
+ *
+ * @example
+ *   // Convert TEXT → TIMESTAMP (ISO string → unix ms)
+ *   changeType('createdAt', (v) => new Date(String(v)).getTime())
+ */
+export function changeType(fieldName, transform) {
+    return (row) => {
+        if (!(fieldName in row))
+            return row;
+        return { ...row, [fieldName]: transform(row[fieldName]) };
+    };
+}
+/**
+ * COMPUTE COLUMN — derive a new field from existing fields.
+ * Called only if the field is absent (so it doesn't overwrite on re-migrations).
+ */
+export function computeColumn(fieldName, compute) {
+    return (row) => {
+        if (row[fieldName] !== undefined && row[fieldName] !== null)
+            return row;
+        return { ...row, [fieldName]: compute(row) };
+    };
+}
+// ─────────────────────────────────────────────────────────────
+//  MigrationRunner
+// ─────────────────────────────────────────────────────────────
+export class MigrationRunner {
+    migrations;
+    constructor(migrations) {
+        // Sort ascending by version
+        this.migrations = [...migrations].sort((a, b) => a.version - b.version);
+    }
+    /**
+     * Apply all migrations with version > `fromVersion` to a single record row.
+     *
+     * @param row          Decoded record from the chain (before migration)
+     * @param fromVersion  The schema version the record was written at. Use the
+     *                     VERSION field stored in the record, or 0 if absent.
+     */
+    applyToRecord(row, fromVersion = 0) {
+        let current = { ...row };
+        for (const m of this.migrations) {
+            if (m.version > fromVersion) {
+                current = m.up(current);
+            }
+        }
+        return current;
+    }
+    /**
+     * Apply all schema migrations from `fromVersion` to the latest version,
+     * producing an up-to-date SchemaDefinition for TypedTableClient.
+     */
+    applyToSchema(baseSchema, fromVersion = 0) {
+        let schema = [...baseSchema];
+        for (const m of this.migrations) {
+            if (m.version > fromVersion && m.schema) {
+                schema = m.schema(schema);
+            }
+        }
+        return schema;
+    }
+    /** The latest migration version number. */
+    get latestVersion() {
+        return this.migrations.at(-1)?.version ?? 0;
+    }
+    /** List all registered migrations in version order. */
+    list() {
+        return this.migrations.map(({ version, description }) => ({ version, description }));
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/src/migrations.js.map

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

package/dist/src/model.d.ts

@@ -0,0 +1,198 @@
+/**
+ * @file   model.ts
+ * @notice Web3QL ORM — Prisma-style Model class that unifies:
+ *
+ *   • Encrypted record CRUD (via TypedTableClient under the hood)
+ *   • On-chain COUNTER fields — automatically merged into every find result
+ *   • Relation writes — `relatedCreate()` pays with native CELO or any ERC-20
+ *     and atomically writes the source record + increments target counters
+ *
+ * Usage:
+ * ─────────────────────────────────────────────────────────────
+ *   // 1. Define your models
+ *   const projects = new Model<Project>('projects', projectsTableAddr, signer, keypair, {
+ *     counterFields: ['vote_total', 'vote_count', 'tip_total', 'tip_count'],
+ *     schema: projectSchema,
+ *   });
+ *
+ *   const votes = new Model<Vote>('votes', votesTableAddr, signer, keypair);
+ *
+ *   // 2. Standard CRUD
+ *   await projects.create(1n, { id: 1n, name: 'Web3QL' });
+ *
+ *   // 3. findUnique — counter fields merged in automatically
+ *   const p = await projects.findUnique(1n);
+ *   // p = { id: 1n, name: 'Web3QL', vote_total: 420n, vote_count: 3n, ... }
+ *
+ *   // 4. Relation write — pay 2 CELO, atomically save vote + update project counters
+ *   await votes.relatedCreate({
+ *     wire      : wireAddress,
+ *     id        : 10n,
+ *     data      : { project_id: 1n, voter: myAddr, amount: 2n * 10n**18n },
+ *     targetId  : 1n,
+ *     amount    : 2n * 10n**18n,   // native CELO
+ *   });
+ *
+ *   // 5. ERC-20 vote: approve first, then:
+ *   await votes.relatedCreate({
+ *     wire      : wireAddress,
+ *     id        : 11n,
+ *     data      : { project_id: 1n, voter: myAddr, amount: 5_000000n },
+ *     targetId  : 1n,
+ *     amount    : 5_000000n,       // 5 cUSD (6 decimals)
+ *     token     : CUSD_ADDRESS,    // ERC-20 token — pre-approve wire contract first
+ *   });
+ * ─────────────────────────────────────────────────────────────
+ */
+import { ethers } from 'ethers';
+import { Role } from './table-client.js';
+import type { FindManyOptions, RecordWithId, SchemaDefinition } from './typed-table.js';
+import type { EncryptionKeypair } from './crypto.js';
+import type { PublicKeyRegistryClient } from './registry.js';
+export { Role };
+export interface ModelOptions {
+    /**
+     * Names of COUNTER fields on this table.
+     * Counter values are stored in the on-chain `counters` mapping — NOT
+     * inside the encrypted ciphertext.  They are automatically fetched
+     * and merged into every `findUnique` / `findMany` result.
+     */
+    counterFields?: string[];
+    /** Optional schema for validation, type coercion, NOT NULL, DEFAULT. */
+    schema?: SchemaDefinition;
+}
+/** Options for `relatedCreate()` */
+export interface RelatedCreateOptions<T> {
+    /** Address of the deployed Web3QLRelationWire contract. */
+    wire: string;
+    /** Primary key of the NEW record being written to THIS table. */
+    id: bigint;
+    /** Payload to encrypt and store (COUNTER fields are excluded automatically). */
+    data: T;
+    /** Primary key of the TARGET record to increment counters on. */
+    targetId: bigint;
+    /** Name of the target table (needed for key derivation). */
+    targetTable: string;
+    /**
+     * Payment amount.
+     *  - Native wire  (token undefined / address(0)): amount in wei (msg.value)
+     *  - ERC-20 wire  (token set): amount in token's native units
+     */
+    amount?: bigint;
+    /**
+     * ERC-20 token address.  Omit (or pass `undefined`) for native CELO.
+     * The wire contract must be pre-approved: call `model.approveWire(wire, token, amount)` once.
+     */
+    token?: string;
+}
+/**
+ * `Model<T>` — the Web3QL ORM entry point.
+ *
+ * T is the shape of the ENCRYPTED fields only (not counter fields).
+ * Counter fields are added automatically to every returned object.
+ */
+export declare class Model<T extends Record<string, unknown>> {
+    readonly tableName: string;
+    readonly tableAddress: string;
+    private inner;
+    private rawClient;
+    private counterFields;
+    private counterFieldHashes;
+    private signer;
+    private provider;
+    constructor(tableName: string, tableAddress: string, signer: ethers.Signer, keypair: EncryptionKeypair, options?: ModelOptions);
+    /** Derive the on-chain bytes32 record key for a given primary key. */
+    key(id: bigint): string;
+    /** Read a single named counter for the record at `id`. */
+    counter(id: bigint, field: string): Promise<bigint>;
+    /**
+     * Read ALL registered counter fields for the record at `id`.
+     * Returns a plain object mapping field name → bigint value.
+     */
+    counters(id: bigint): Promise<Record<string, bigint>>;
+    /**
+     * Encrypt and store a new record.
+     * Pass only encrypted fields — counter fields are managed by the chain.
+     */
+    create(id: bigint, data: T): Promise<ethers.TransactionReceipt>;
+    /**
+     * Read and decrypt a record, with all counter values merged in.
+     * Returns `null` if the record does not exist.
+     */
+    findUnique(id: bigint): Promise<(T & Record<string, bigint>) | null>;
+    /**
+     * List and decrypt all records owned by `ownerAddress`.
+     * Counter values are merged into every record.
+     */
+    findMany(ownerAddress: string, options?: FindManyOptions): Promise<RecordWithId<T & Record<string, bigint>>[]>;
+    /** Get all records (no chain limit). Counter values merged. */
+    findAll(ownerAddress: string): Promise<RecordWithId<T & Record<string, bigint>>[]>;
+    /**
+     * Patch an existing record — fetches current, merges patch, re-encrypts.
+     * Counter fields in patch are silently ignored (they live on-chain, not in ciphertext).
+     */
+    update(id: bigint, patch: Partial<T>): Promise<ethers.TransactionReceipt>;
+    /** Delete a record (soft-delete — scrubs all encrypted key copies). */
+    delete(id: bigint): Promise<ethers.TransactionReceipt>;
+    /** True if a live record exists for `id`. */
+    exists(id: bigint): Promise<boolean>;
+    /** Total record count (including deleted) for `ownerAddress`. */
+    count(ownerAddress: string): Promise<bigint>;
+    share(id: bigint, recipient: string, role: Role, registry: PublicKeyRegistryClient): Promise<ethers.TransactionReceipt>;
+    revoke(id: bigint, user: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Write a record to THIS table via a RelationWire, atomically incrementing
+     * counter fields on the TARGET table in the same transaction.
+     *
+     * For native CELO:  pass `amount` in wei, do NOT pass `token`.
+     * For ERC-20:       pass `token` address + `amount` in token units.
+     *                   You must have approved the wire contract beforehand —
+     *                   call `model.approveWire(wire, token, amount)` once.
+     */
+    relatedCreate(opts: RelatedCreateOptions<T>): Promise<ethers.TransactionReceipt>;
+    /**
+     * Approve a RelationWire to spend your ERC-20 tokens.
+     * Call this once before using `relatedCreate` with an ERC-20 wire.
+     * You can approve `MaxUint256` for unlimited allowance.
+     */
+    approveWire(wire: string, token: string, amount?: bigint): Promise<ethers.TransactionReceipt>;
+    /**
+     * Withdraw a single token's accumulated payments for a project record.
+     * Caller must be the record owner of `id` on this table.
+     *
+     * @param wire   Address of the RelationWire contract
+     * @param id     Primary key of THIS table's record (the project)
+     * @param token  Token to withdraw (ethers.ZeroAddress = native CELO)
+     * @param to     Recipient address (defaults to signer)
+     */
+    withdrawFunds(wire: string, id: bigint, token?: string, to?: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Withdraw ALL token balances for a project in one transaction.
+     * Caller must be the record owner of `id` on this table.
+     *
+     * @param wire   Address of the RelationWire contract
+     * @param id     Primary key of the project record
+     * @param to     Recipient address (defaults to signer)
+     */
+    withdrawAllFunds(wire: string, id: bigint, to?: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Check pending balances for a project across all tokens accepted by the wire.
+     * Returns a plain object: { tokenAddress: bigintBalance, ... }
+     *
+     * @param wire  Address of the RelationWire contract
+     * @param id    Primary key of the project record
+     */
+    projectBalances(wire: string, id: bigint): Promise<Record<string, bigint>>;
+    /**
+     * Build and sign an EIP-2612 permit signature.
+     * Works for cUSD, cEUR, cREAL, USDC and any token that implements ERC-2612.
+     * Throws if the token doesn't expose `nonces()` or `DOMAIN_SEPARATOR()`.
+     */
+    private _signPermit;
+    private _countersFromBytes32Key;
+    /**
+     * Encrypt a payload for self, returning raw bytes for the wire contract.
+     */
+    private _encryptPayload;
+}
+//# sourceMappingURL=model.d.ts.map

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

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