@onchaindb/sdk 0.4.5 → 2.0.0

package/dist/client.js

@@ -3,23 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OnChainDBClient = void 0;
+exports.OnDBClient = void 0;
 const axios_1 = __importDefault(require("axios"));
 const eventemitter3_1 = require("eventemitter3");
 const types_1 = require("./types");
 const database_1 = require("./database");
 const query_sdk_1 = require("./query-sdk");
 const x402_1 = require("./x402");
-class OnChainDBClient extends eventemitter3_1.EventEmitter {
+class OnDBClient extends eventemitter3_1.EventEmitter {
     constructor(config) {
         super();
         const appKey = config.appKey || '';
         const userKey = config.userKey || '';
+        const agentKey = config.agentKey || '';
         this.config = {
             endpoint: config.endpoint,
             apiKey: config.apiKey || "",
             appKey: appKey,
             userKey: userKey,
+            agentKey: agentKey,
             appId: config.appId || undefined,
             timeout: config.timeout || 30000,
             retryCount: config.retryCount || 3,
@@ -37,6 +39,9 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
         if (userKey) {
             headers['X-User-Key'] = userKey;
         }
+        if (agentKey) {
+            headers['X-Agent-Key'] = agentKey;
+        }
         this.http = axios_1.default.create({
             baseURL: this.config.endpoint,
             timeout: this.config.timeout,
@@ -44,8 +49,12 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
         });
     }
     database(appId) {
-        if (!this._database || this._database['appId'] !== appId) {
-            this._database = (0, database_1.createDatabaseManager)(this.http, this.config.endpoint, appId, this.config.apiKey);
+        const resolvedAppId = appId || this.config.appId;
+        if (!resolvedAppId) {
+            throw new types_1.ValidationError('appId must be provided either in config or as an argument to database()');
+        }
+        if (!this._database || this._database['appId'] !== resolvedAppId) {
+            this._database = (0, database_1.createDatabaseManager)(this.http, resolvedAppId, this.config.apiKey);
         }
         return this._database;
     }
@@ -56,7 +65,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             x402Response = (0, x402_1.parseX402Response)(response.data);
         }
         catch (e) {
-            throw new types_1.OnChainDBError(`Invalid x402 response: ${e instanceof Error ? e.message : String(e)}`, 'PAYMENT_ERROR', 402);
+            throw new types_1.OnDBError(`Invalid x402 response: ${e instanceof Error ? e.message : String(e)}`, 'PAYMENT_ERROR', 402);
         }
         const requirement = (0, x402_1.selectPaymentOption)(x402Response.accepts);
         const quote = (0, x402_1.requirementToQuote)(requirement, x402Response.accepts);
@@ -69,7 +78,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             paymentMethod: quote.paymentMethod,
         });
         if (!paymentCallback) {
-            throw new types_1.OnChainDBError('Payment required but no payment callback provided. Please provide a payment callback to handle x402.', 'PAYMENT_REQUIRED', 402, quote);
+            throw new types_1.OnDBError('Payment required but no payment callback provided. Please provide a payment callback to handle x402.', 'PAYMENT_REQUIRED', 402, quote);
         }
         console.log('[x402] Calling payment callback...');
         const payment = await paymentCallback(quote);
@@ -79,7 +88,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             const facilitatorPayment = payment;
             const selectedRequirement = x402Response.accepts.find((req) => req.network === facilitatorPayment.network);
             if (!selectedRequirement) {
-                throw new types_1.OnChainDBError(`Payment callback returned network '${facilitatorPayment.network}' but no matching payment option found`, 'PAYMENT_ERROR');
+                throw new types_1.OnDBError(`Payment callback returned network '${facilitatorPayment.network}' but no matching payment option found`, 'PAYMENT_ERROR');
             }
             console.log('[x402] Using payment option for network:', selectedRequirement.network);
             if (facilitatorPayment.evmAuthorization) {
@@ -96,7 +105,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                 });
             }
             else {
-                throw new types_1.OnChainDBError('Facilitator payment missing authorization data', 'PAYMENT_ERROR');
+                throw new types_1.OnDBError('Facilitator payment missing authorization data', 'PAYMENT_ERROR');
             }
         }
         else {
@@ -115,31 +124,15 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
         if (serverResult.ticket_id) {
             if (waitForConfirmation) {
                 const taskInfo = await this.waitForTaskCompletion(serverResult.ticket_id);
-                if (taskInfo.result && taskInfo.result.results && taskInfo.result.results.length > 0) {
-                    const firstResult = taskInfo.result.results[0];
-                    return {
-                        id: firstResult.id,
-                        block_height: firstResult.celestia_height || 0,
-                        transaction_hash: firstResult.blob_id || '',
-                        celestia_height: firstResult.celestia_height || 0,
-                        namespace: firstResult.namespace || '',
-                        confirmed: firstResult.celestia_height > 0
-                    };
+                if (taskInfo.result?.results?.length > 0) {
+                    return this.buildStoreResult(taskInfo.result.results[0]);
                 }
             }
             else {
-                return {
-                    id: serverResult.ticket_id,
-                    block_height: 0,
-                    transaction_hash: '',
-                    celestia_height: 0,
-                    namespace: '',
-                    confirmed: false,
-                    ticket_id: serverResult.ticket_id
-                };
+                return { id: serverResult.ticket_id, block_height: 0, transaction_hash: '', celestia_height: 0, namespace: '', confirmed: false, ticket_id: serverResult.ticket_id };
             }
         }
-        throw new types_1.OnChainDBError('No ticket_id in response after payment', 'STORE_ERROR');
+        throw new types_1.OnDBError('No ticket_id in response after payment', 'STORE_ERROR');
     }
     async store(request, paymentCallback, waitForConfirmation = true) {
         this.validateStoreRequest(request);
@@ -150,12 +143,6 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
         try {
             delete resolvedRequest.collection;
             const response = await this.http.post('/store', resolvedRequest);
-            if (response.status === 402 && response.data) {
-                const v = await this.handleX402(response, paymentCallback, resolvedRequest, waitForConfirmation);
-                if (v) {
-                    return v;
-                }
-            }
             const serverResult = response.data;
             if (serverResult.ticket_id) {
                 this.emit('transaction:queued', {
@@ -165,16 +152,8 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                 });
                 if (waitForConfirmation) {
                     const taskInfo = await this.waitForTaskCompletion(serverResult.ticket_id);
-                    if (taskInfo.result && taskInfo.result.results && taskInfo.result.results.length > 0) {
-                        const firstResult = taskInfo.result.results[0];
-                        const result = {
-                            id: firstResult.id,
-                            block_height: firstResult.celestia_height || 0,
-                            transaction_hash: firstResult.blob_id || '',
-                            celestia_height: firstResult.celestia_height || 0,
-                            namespace: firstResult.namespace || '',
-                            confirmed: firstResult.celestia_height > 0
-                        };
+                    if (taskInfo.result?.results?.length > 0) {
+                        const result = this.buildStoreResult(taskInfo.result.results[0]);
                         this.emit('transaction:confirmed', {
                             id: result.id,
                             status: 'confirmed',
@@ -185,33 +164,18 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                         return result;
                     }
                     else {
-                        throw new types_1.OnChainDBError('Task completed but no storage results found', 'STORE_ERROR');
+                        throw new types_1.OnDBError('Task completed but no storage results found', 'STORE_ERROR');
                     }
                 }
                 else {
-                    return {
-                        id: serverResult.ticket_id,
-                        block_height: 0,
-                        transaction_hash: '',
-                        celestia_height: 0,
-                        namespace: '',
-                        confirmed: false,
-                        ticket_id: serverResult.ticket_id
-                    };
+                    return { id: serverResult.ticket_id, block_height: 0, transaction_hash: '', celestia_height: 0, namespace: '', confirmed: false, ticket_id: serverResult.ticket_id };
                 }
             }
-            const firstResult = serverResult.results && serverResult.results[0];
+            const firstResult = serverResult.results?.[0];
             if (!firstResult) {
-                throw new types_1.OnChainDBError('No results returned from server', 'STORE_ERROR');
+                throw new types_1.OnDBError('No results returned from server', 'STORE_ERROR');
             }
-            const result = {
-                id: firstResult.id,
-                block_height: firstResult.celestia_height || 0,
-                transaction_hash: firstResult.blob_id || '',
-                celestia_height: firstResult.celestia_height || 0,
-                namespace: firstResult.namespace || '',
-                confirmed: firstResult.celestia_height > 0
-            };
+            const result = this.buildStoreResult(firstResult);
             if (result.block_height === 0) {
                 this.emit('transaction:pending', {
                     id: result.id,
@@ -229,9 +193,6 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                     celestia_height: result.celestia_height
                 });
             }
-            if (waitForConfirmation && result.block_height === 0) {
-                return await this.waitForConfirmation(result.transaction_hash);
-            }
             return result;
         }
         catch (error) {
@@ -243,69 +204,15 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                         return v;
                     }
                 }
-                throw new types_1.OnChainDBError(JSON.stringify(err.response?.data), 'STORE_ERROR');
+                throw new types_1.OnDBError(JSON.stringify(err.response?.data), 'STORE_ERROR');
             }
             console.error(error);
-            const dbError = error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError(error.message, 'STORE_ERROR');
+            const dbError = error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError(error.message, 'STORE_ERROR');
             this.emit('error', dbError);
             throw dbError;
         }
     }
-    async storeAndConfirm(request) {
-        return this.store(request, undefined, true);
-    }
-    async waitForConfirmation(transactionHash, maxWaitTime = 300000) {
-        const startTime = Date.now();
-        const pollInterval = 3000;
-        console.log(`🔄 Waiting for transaction ${transactionHash} confirmation...`);
-        while (Date.now() - startTime < maxWaitTime) {
-            try {
-                const rpcUrl = 'https://celestia-mocha-rpc.publicnode.com:443';
-                const txUrl = `${rpcUrl}/tx?hash=0x${transactionHash}`;
-                console.log(`🔍 Checking transaction status: attempt ${Math.floor((Date.now() - startTime) / pollInterval) + 1}`);
-                const response = await axios_1.default.get(txUrl);
-                if (response.data?.result && response.data.result !== null) {
-                    const txResult = response.data.result;
-                    const height = parseInt(txResult.height);
-                    if (height > 0) {
-                        console.log(`✅ Transaction ${transactionHash} confirmed at height ${height}`);
-                        const confirmedTx = {
-                            id: transactionHash,
-                            namespace: '',
-                            block_height: height,
-                            transaction_hash: transactionHash,
-                            celestia_height: height,
-                            confirmed: true
-                        };
-                        this.emit('transaction:confirmed', {
-                            id: transactionHash,
-                            status: 'confirmed',
-                            block_height: height,
-                            transaction_hash: transactionHash
-                        });
-                        return confirmedTx;
-                    }
-                }
-                console.log(`⏳ Transaction still pending, waiting ${pollInterval}ms...`);
-                this.emit('transaction:pending', {
-                    id: transactionHash,
-                    status: 'pending',
-                    block_height: 0,
-                    transaction_hash: transactionHash
-                });
-                await this.sleep(pollInterval);
-            }
-            catch (error) {
-                if (Date.now() - startTime >= maxWaitTime) {
-                    throw new types_1.TransactionError(`Transaction confirmation timeout after ${maxWaitTime}ms`, transactionHash);
-                }
-                console.log(`⚠️ Error checking transaction (will retry): ${error}`);
-                await this.sleep(pollInterval);
-            }
-        }
-        throw new types_1.TransactionError(`Transaction confirmation timeout after ${maxWaitTime}ms`, transactionHash);
-    }
     async createIndex(request) {
         try {
             const appId = this.config.appId || 'default';
@@ -313,8 +220,8 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             return response.data;
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to create index', 'INDEX_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to create index', 'INDEX_ERROR');
         }
     }
     async createCollection(schema) {
@@ -330,7 +237,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
         };
         const allFields = {};
         if (schema.useBaseFields !== false) {
-            Object.assign(allFields, OnChainDBClient.BASE_FIELDS);
+            Object.assign(allFields, OnDBClient.BASE_FIELDS);
         }
         Object.assign(allFields, schema.fields);
         for (const [fieldName, fieldDef] of Object.entries(allFields)) {
@@ -391,21 +298,9 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             success: true,
             errors: []
         };
-        let existingIndexes = [];
-        try {
-            const response = await this.http.get(`/api/apps/${appId}/collections/${schema.name}/indexes`);
-            existingIndexes = response.data?.indexes || response.data || [];
-        }
-        catch (error) {
-            existingIndexes = [];
-        }
-        const existingByField = new Map();
-        for (const idx of existingIndexes) {
-            existingByField.set(idx.field_name, { type: idx.index_type, name: idx.name });
-        }
         const allFields = {};
         if (schema.useBaseFields !== false) {
-            Object.assign(allFields, OnChainDBClient.BASE_FIELDS);
+            Object.assign(allFields, OnDBClient.BASE_FIELDS);
         }
         Object.assign(allFields, schema.fields);
         const desiredIndexedFields = new Set();
@@ -415,7 +310,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             }
         }
         for (const fieldName of desiredIndexedFields) {
-            if (!existingByField.has(fieldName)) {
+            {
                 const fieldDef = allFields[fieldName];
                 const indexType = fieldDef.indexType || this.getDefaultIndexType(fieldDef.type);
                 try {
@@ -449,232 +344,227 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                 }
             }
         }
-        for (const [fieldName, existing] of existingByField) {
-            if (!desiredIndexedFields.has(fieldName)) {
-                try {
-                    const indexId = `${schema.name}_${fieldName}_index`;
-                    await this.http.delete(`/api/apps/${appId}/indexes/${indexId}`);
-                    result.removed.push({
-                        field: fieldName,
-                        type: existing.type
-                    });
-                }
-                catch (error) {
-                    const errorMsg = error instanceof Error ? error.message : String(error);
-                    result.errors.push(`Failed to remove index on ${fieldName}: ${errorMsg}`);
-                    result.success = false;
-                }
+        if (schema.sharding) {
+            try {
+                await this.setupSharding(schema.name, schema.sharding);
+                result.sharding_configured = true;
             }
-        }
-        for (const [fieldName, existing] of existingByField) {
-            if (desiredIndexedFields.has(fieldName)) {
-                result.unchanged.push({
-                    field: fieldName,
-                    type: existing.type
-                });
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                result.errors.push(`Failed to configure sharding: ${errorMsg}`);
+                result.success = false;
             }
         }
         return result;
     }
-    async getCollectionInfo(collection) {
+    async setupSharding(collection, sharding) {
         const appId = this.config.appId;
         if (!appId) {
+            throw new types_1.ValidationError('appId must be configured to setup sharding');
+        }
+        try {
+            await this.http.patch(`/api/apps/${appId}/collections/${collection}/sharding`, sharding);
+        }
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to setup sharding', 'SHARDING_ERROR');
+        }
+    }
+    async deleteCollection(collection) {
+        const appId = this.config.appId;
+        if (!appId)
             throw new types_1.ValidationError('appId must be configured');
+        try {
+            const response = await this.http.delete(`/api/apps/${appId}/collections/${collection}`);
+            return response.data;
+        }
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to delete collection', 'COLLECTION_ERROR');
         }
+    }
+    async updateCollection(collection, updates) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
         try {
-            const response = await this.http.get(`/api/apps/${appId}/collections/${collection}`);
+            const response = await this.http.patch(`/api/apps/${appId}/collections/${collection}`, updates);
             return response.data;
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to get collection info', 'COLLECTION_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to update collection', 'COLLECTION_ERROR');
         }
     }
-    async createRelation(request) {
+    async getRetention(collection) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
         try {
-            const appId = this.config.appId || 'default';
-            const response = await this.http.post(`/api/apps/${appId}/relations`, request);
+            const response = await this.http.get(`/api/apps/${appId}/collections/${collection}/retention`);
             return response.data;
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to create relation', 'RELATION_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to get retention config', 'RETENTION_ERROR');
         }
     }
-    async health() {
+    async setRetention(collection, request) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
         try {
-            const response = await this.http.get('/');
+            const response = await this.http.post(`/api/apps/${appId}/collections/${collection}/retention`, request);
             return response.data;
         }
         catch (error) {
-            throw new types_1.OnChainDBError('Health check failed', 'HEALTH_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to set retention config', 'RETENTION_ERROR');
         }
     }
-    async getPricingQuote(request) {
+    async getRetentionCost() {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
         try {
-            const response = await this.http.post('/api/pricing/quote', request);
+            const response = await this.http.get(`/api/apps/${appId}/retention/cost`);
             return response.data;
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to get pricing quote', 'PRICING_QUOTE_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to get retention cost', 'RETENTION_ERROR');
         }
     }
-    async query(request) {
+    async sql(query, options) {
         try {
-            const queryBuilder = this.queryBuilder();
-            const root = this.resolveRoot(request);
-            if (request.filters) {
-                queryBuilder.find(builder => {
-                    const conditions = Object.entries(request.filters).map(([field, value]) => query_sdk_1.LogicalOperator.Condition(builder.field(field).equals(value)));
-                    return conditions.length === 1 ? conditions[0] : query_sdk_1.LogicalOperator.And(conditions);
-                });
-            }
-            if (request.limit) {
-                queryBuilder.limit(request.limit);
-            }
-            if (request.offset) {
-                queryBuilder.offset(request.offset);
-            }
-            return await queryBuilder.execute();
+            const body = { sql: query };
+            if (options?.includeHistory !== undefined)
+                body.include_history = options.includeHistory;
+            const response = await this.http.post('/query/sql', body);
+            return response.data;
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to execute query', 'QUERY_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('SQL query failed', 'SQL_ERROR');
         }
     }
-    queryBuilder() {
-        const { AxiosHttpClient } = require('./query-sdk/adapters/HttpClientAdapter');
-        const httpClient = new AxiosHttpClient(this.http);
-        return new query_sdk_1.QueryBuilder(httpClient, this.config.endpoint, this.config.appId);
+    async sqlInsert(sql) {
+        try {
+            const body = { sql };
+            const response = await this.http.post('/insert/sql', body);
+            return response.data;
+        }
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('SQL insert failed', 'SQL_ERROR');
+        }
     }
-    batch() {
-        const { BatchOperations } = require('./batch');
-        return new BatchOperations(this);
+    async listQueries() {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
+        try {
+            const response = await this.http.get(`/apps/${appId}/queries`);
+            return response.data.queries ?? response.data;
+        }
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to list predefined queries', 'QUERY_ERROR');
+        }
     }
-    async findUnique(collection, where) {
+    async createQuery(request) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
         try {
-            let queryBuilder = this.queryBuilder().collection(collection);
-            for (const [field, value] of Object.entries(where)) {
-                queryBuilder = queryBuilder.whereField(field).equals(value);
-            }
-            return await queryBuilder.selectAll().executeUnique();
+            const response = await this.http.post(`/apps/${appId}/queries`, request);
+            return response.data;
         }
         catch (error) {
-            console.error(`findUnique error for ${collection}:`, error);
-            return null;
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to create predefined query', 'QUERY_ERROR');
         }
     }
-    async findMany(collection, where = {}, options = {}) {
+    async getQuery(name) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
         try {
-            let queryBuilder = this.queryBuilder().collection(collection);
-            for (const [field, value] of Object.entries(where)) {
-                queryBuilder = queryBuilder.whereField(field).equals(value);
-            }
-            if (options.limit) {
-                queryBuilder = queryBuilder.limit(options.limit);
-            }
-            if (options.offset) {
-                queryBuilder = queryBuilder.offset(options.offset);
-            }
-            const result = await queryBuilder.selectAll().execute();
-            if (!result.records) {
-                return [];
-            }
-            let records = result.records;
-            if (options.sort) {
-                records = records.sort((a, b) => {
-                    const aVal = a[options.sort.field];
-                    const bVal = b[options.sort.field];
-                    if (options.sort.order === 'asc') {
-                        return aVal > bVal ? 1 : -1;
-                    }
-                    else {
-                        return aVal < bVal ? 1 : -1;
-                    }
-                });
-            }
-            return records;
+            const response = await this.http.get(`/apps/${appId}/queries/${name}`);
+            return response.data;
         }
         catch (error) {
-            console.error(`findMany error for ${collection}:`, error);
-            return [];
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to get predefined query', 'QUERY_ERROR');
         }
     }
-    async createDocument(collection, data, paymentCallback, options) {
-        const document = {
-            id: options?.idGenerator ? options.idGenerator() : this.generateId(),
-            ...data,
-            createdAt: new Date().toISOString(),
-            updatedAt: new Date().toISOString(),
-        };
-        await this.store({
-            collection,
-            data: [document],
-        }, paymentCallback);
-        return document;
-    }
-    async updateDocument(collection, where, data, paymentCallback) {
-        const current = await this.findUnique(collection, where);
-        if (!current) {
-            return null;
-        }
-        const updated = {
-            ...current,
-            ...data,
-            updatedAt: new Date().toISOString(),
-        };
-        await this.store({
-            collection,
-            data: [updated],
-        }, paymentCallback);
-        return updated;
+    async deleteQuery(name) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
+        try {
+            const response = await this.http.delete(`/apps/${appId}/queries/${name}`);
+            return response.data;
+        }
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to delete predefined query', 'QUERY_ERROR');
+        }
     }
-    async upsertDocument(collection, where, create, update, paymentCallback, options) {
-        const existing = await this.findUnique(collection, where);
-        if (existing) {
-            return (await this.updateDocument(collection, where, update, paymentCallback));
+    async executeQuery(name, params, version) {
+        const appId = this.config.appId;
+        if (!appId)
+            throw new types_1.ValidationError('appId must be configured');
+        try {
+            const queryParams = { ...params };
+            if (version !== undefined)
+                queryParams['v'] = version;
+            const response = await this.http.get(`/api/queries/${appId}/${name}/data`, { params: queryParams });
+            return response.data;
         }
-        else {
-            return await this.createDocument(collection, create, paymentCallback, options);
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to execute predefined query', 'QUERY_ERROR');
         }
     }
-    async deleteDocument(collection, where, paymentCallback) {
-        const existing = await this.findUnique(collection, where);
-        if (!existing) {
-            return false;
+    async getCollectionInfo(collectionId) {
+        const appId = this.config.appId;
+        if (!appId) {
+            throw new types_1.ValidationError('appId must be configured');
+        }
+        try {
+            const response = await this.http.get(`/api/apps/${appId}/collections/${collectionId}`);
+            return response.data;
+        }
+        catch (error) {
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to get collection info', 'COLLECTION_ERROR');
         }
-        const deleted = {
-            ...existing,
-            deleted: true,
-            updatedAt: new Date().toISOString(),
-        };
-        await this.store({
-            collection,
-            data: [deleted],
-        }, paymentCallback);
-        return true;
     }
-    async countDocuments(collection, where = {}) {
+    async createRelation(request) {
         try {
-            let queryBuilder = this.queryBuilder().collection(collection);
-            for (const [field, value] of Object.entries(where)) {
-                queryBuilder = queryBuilder.whereField(field).equals(value);
-            }
-            return await queryBuilder.count();
+            const appId = this.config.appId || 'default';
+            const response = await this.http.post(`/api/apps/${appId}/relations`, request);
+            return response.data;
         }
         catch (error) {
-            console.error(`countDocuments error for ${collection}:`, error);
-            return 0;
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to create relation', 'RELATION_ERROR');
         }
     }
-    generateId() {
-        const chars = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
-        let id = '';
-        for (let i = 0; i < 24; i++) {
-            id += chars[Math.floor(Math.random() * chars.length)];
+    async health() {
+        try {
+            const response = await this.http.get('/');
+            return response.data;
+        }
+        catch (error) {
+            throw new types_1.OnDBError('Health check failed', 'HEALTH_ERROR');
         }
-        return id;
+    }
+    queryBuilder() {
+        const { AxiosHttpClient } = require('./query-sdk/adapters/HttpClientAdapter');
+        const httpClient = new AxiosHttpClient(this.http);
+        return new query_sdk_1.QueryBuilder(httpClient, this.config.endpoint, this.config.appId);
     }
     async getTaskStatus(ticketId) {
         try {
@@ -682,8 +572,8 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             return response.data;
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to get task status', 'TASK_STATUS_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to get task status', 'TASK_STATUS_ERROR');
         }
     }
     async waitForTaskCompletion(ticketId, pollInterval = 2000, maxWaitTime = 600000) {
@@ -705,30 +595,30 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                 if (typeof taskInfo.status === 'object' && 'Failed' in taskInfo.status) {
                     const error = taskInfo.status.Failed.error;
                     console.error(`🚫 Task ${ticketId} failed: ${error}`);
-                    throw new types_1.OnChainDBError(`Task failed: ${error}`, 'TASK_FAILED');
+                    throw new types_1.OnDBError(`Task failed: ${error}`, 'TASK_FAILED');
                 }
                 if (typeof taskInfo.status === 'string' && taskInfo.status.toLowerCase().includes('error')) {
                     console.error(`🚫 Task ${ticketId} has error status: ${taskInfo.status}`);
-                    throw new types_1.OnChainDBError(`Task error: ${taskInfo.status}`, 'TASK_FAILED');
+                    throw new types_1.OnDBError(`Task error: ${taskInfo.status}`, 'TASK_FAILED');
                 }
                 await this.sleep(pollInterval);
             }
             catch (error) {
                 console.error(`❌ Error polling task ${ticketId}:`, error);
-                if (error instanceof types_1.OnChainDBError) {
+                if (error instanceof types_1.OnDBError) {
                     if (error.code === 'TASK_FAILED' || error.statusCode === 404 || error.statusCode === 400) {
                         console.error(`🚫 Stopping polling due to permanent error: ${error.message}`);
                         throw error;
                     }
                 }
                 if (Date.now() - startTime >= maxWaitTime) {
-                    throw new types_1.OnChainDBError(`Task completion timeout after ${maxWaitTime}ms. Last error: ${error instanceof Error ? error.message : String(error)}`, 'TASK_TIMEOUT');
+                    throw new types_1.OnDBError(`Task completion timeout after ${maxWaitTime}ms. Last error: ${error instanceof Error ? error.message : String(error)}`, 'TASK_TIMEOUT');
                 }
                 console.warn(`⚠️  Temporary error polling task ${ticketId}, retrying in ${pollInterval}ms...`);
                 await this.sleep(pollInterval);
             }
         }
-        throw new types_1.OnChainDBError(`Task completion timeout after ${maxWaitTime}ms`, 'TASK_TIMEOUT');
+        throw new types_1.OnDBError(`Task completion timeout after ${maxWaitTime}ms`, 'TASK_TIMEOUT');
     }
     async uploadBlob(request, paymentCallback) {
         try {
@@ -742,13 +632,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                 formData.append('metadata', JSON.stringify(request.metadata));
             }
             const uploadWithHeaders = async (headers = {}) => {
-                return await this.http.post(`/api/apps/${appId}/blobs/${request.collection}`, formData, {
-                    headers: {
-                        'Content-Type': 'multipart/form-data',
-                        'X-App-Key': this.config.appKey,
-                        ...headers
-                    }
-                });
+                return await this.http.post(`/api/apps/${appId}/blobs/${request.collection}`, formData, { headers: { 'Content-Type': 'multipart/form-data', ...headers } });
             };
             try {
                 const response = await uploadWithHeaders();
@@ -762,7 +646,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                     const requirement = (0, x402_1.selectPaymentOption)(x402Response.accepts);
                     const quote = (0, x402_1.requirementToQuote)(requirement, x402Response.accepts);
                     if (!paymentCallback) {
-                        throw new types_1.OnChainDBError('Payment required but no payment callback provided', 'PAYMENT_REQUIRED', 402, quote);
+                        throw new types_1.OnDBError('Payment required but no payment callback provided', 'PAYMENT_REQUIRED', 402, quote);
                     }
                     const payment = await paymentCallback(quote);
                     const x402Payload = (0, x402_1.buildPaymentPayload)(requirement, payment);
@@ -776,8 +660,8 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             }
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to upload blob', 'BLOB_UPLOAD_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to upload blob', 'BLOB_UPLOAD_ERROR');
         }
     }
     async retrieveBlob(request) {
@@ -786,12 +670,7 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             if (!appId) {
                 throw new types_1.ValidationError('appId must be configured to retrieve blobs');
             }
-            const response = await this.http.get(`/api/apps/${appId}/blobs/${request.collection}/${request.blob_id}`, {
-                responseType: 'arraybuffer',
-                headers: {
-                    'X-App-Key': this.config.appKey
-                }
-            });
+            const response = await this.http.get(`/api/apps/${appId}/blobs/${request.collection}/${request.blob_id}`, { responseType: 'arraybuffer' });
             if (typeof global.window !== 'undefined' && typeof Blob !== 'undefined') {
                 const contentType = response.headers['content-type'] || 'application/octet-stream';
                 return new Blob([response.data], { type: contentType });
@@ -801,13 +680,10 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             }
         }
         catch (error) {
-            throw error instanceof types_1.OnChainDBError ? error :
-                new types_1.OnChainDBError('Failed to retrieve blob', 'BLOB_RETRIEVAL_ERROR');
+            throw error instanceof types_1.OnDBError ? error :
+                new types_1.OnDBError('Failed to retrieve blob', 'BLOB_RETRIEVAL_ERROR');
         }
     }
-    async queryBlobMetadata(collection, where = {}) {
-        return await this.findMany(collection, where);
-    }
     getDefaultIndexType(fieldType) {
         switch (fieldType) {
             case 'string':
@@ -822,6 +698,16 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
                 return 'string';
         }
     }
+    buildStoreResult(raw) {
+        return {
+            id: raw.id,
+            block_height: raw.celestia_height || 0,
+            transaction_hash: raw.blob_id || '',
+            celestia_height: raw.celestia_height || 0,
+            namespace: raw.namespace || '',
+            confirmed: raw.celestia_height > 0
+        };
+    }
     validateStoreRequest(request) {
         if (!request.root && !request.collection) {
             throw new types_1.ValidationError('Either root or collection must be provided');
@@ -848,42 +734,21 @@ class OnChainDBClient extends eventemitter3_1.EventEmitter {
             throw new types_1.ValidationError('Total data size exceeds 5MB limit');
         }
     }
-    handleHttpError(error) {
-        console.error(error);
-        if (error.response) {
-            const statusCode = error.response.status;
-            const message = error.response.data?.error || error.message;
-            if (statusCode >= 400 && statusCode < 500) {
-                return new types_1.ValidationError(message, error.response.data);
-            }
-            return new types_1.OnChainDBError(message, 'HTTP_ERROR', statusCode, error.response.data);
-        }
-        if (error.request) {
-            return new types_1.OnChainDBError('Network error - could not reach OnChainDB service', 'NETWORK_ERROR');
-        }
-        return new types_1.OnChainDBError(error.message, 'UNKNOWN_ERROR');
-    }
     sleep(ms) {
         return new Promise(resolve => setTimeout(resolve, ms));
     }
-    buildRoot(collection) {
-        if (!this.config.appId) {
-            return collection;
-        }
-        return `${this.config.appId}::${collection}`;
-    }
     resolveRoot(request) {
         if (request.root) {
             return request.root;
         }
         if (request.collection) {
-            return this.buildRoot(request.collection);
+            return this.config.appId ? `${this.config.appId}::${request.collection}` : request.collection;
         }
         throw new types_1.ValidationError('Either root or collection must be provided');
     }
 }
-exports.OnChainDBClient = OnChainDBClient;
-OnChainDBClient.BASE_FIELDS = {
+exports.OnDBClient = OnDBClient;
+OnDBClient.BASE_FIELDS = {
     id: { type: 'string', index: true, unique: true },
     createdAt: { type: 'date', index: true },
     updatedAt: { type: 'date', index: true },