@onchaindb/sdk 1.0.0 → 2.0.0

package/src/index.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.createHttpClient = exports.NodeHttpClient = exports.FetchHttpClient = exports.AxiosHttpClient = exports.PaymentVerificationError = exports.PaymentRequiredError = exports.ValidationError = exports.TransactionError = exports.OnChainDBError = exports.createDatabaseManager = exports.DatabaseManager = exports.LogicalOperator = exports.FieldConditionBuilder = exports.SelectionBuilder = exports.QueryBuilder = exports.BulkBuilder = exports.BatchOperations = exports.OnChainDBClient = void 0;
+exports.VERSION = exports.createHttpClient = exports.NodeHttpClient = exports.FetchHttpClient = exports.AxiosHttpClient = exports.PaymentVerificationError = exports.PaymentRequiredError = exports.ValidationError = exports.TransactionError = exports.OnDBError = exports.createDatabaseManager = exports.DatabaseManager = exports.LogicalOperator = exports.FieldConditionBuilder = exports.SelectionBuilder = exports.QueryBuilder = exports.BulkBuilder = exports.BatchOperations = exports.OnDBClient = void 0;
 exports.createClient = createClient;
 // Main SDK exports
 var client_1 = require("./client");
-Object.defineProperty(exports, "OnChainDBClient", { enumerable: true, get: function () { return client_1.OnChainDBClient; } });
+Object.defineProperty(exports, "OnDBClient", { enumerable: true, get: function () { return client_1.OnDBClient; } });
 var batch_1 = require("./batch");
 Object.defineProperty(exports, "BatchOperations", { enumerable: true, get: function () { return batch_1.BatchOperations; } });
 Object.defineProperty(exports, "BulkBuilder", { enumerable: true, get: function () { return batch_1.BulkBuilder; } });
@@ -20,7 +20,7 @@ Object.defineProperty(exports, "DatabaseManager", { enumerable: true, get: funct
 Object.defineProperty(exports, "createDatabaseManager", { enumerable: true, get: function () { return database_1.createDatabaseManager; } });
 // Error exports
 var types_1 = require("./types");
-Object.defineProperty(exports, "OnChainDBError", { enumerable: true, get: function () { return types_1.OnChainDBError; } });
+Object.defineProperty(exports, "OnDBError", { enumerable: true, get: function () { return types_1.OnDBError; } });
 Object.defineProperty(exports, "TransactionError", { enumerable: true, get: function () { return types_1.TransactionError; } });
 Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return types_1.ValidationError; } });
 Object.defineProperty(exports, "PaymentRequiredError", { enumerable: true, get: function () { return types_1.PaymentRequiredError; } });
@@ -28,7 +28,7 @@ Object.defineProperty(exports, "PaymentVerificationError", { enumerable: true, g
 const client_2 = require("./client");
 // Convenience factory function
 function createClient(config) {
-    return new client_2.OnChainDBClient(config);
+    return new client_2.OnDBClient(config);
 }
 // Re-export HTTP client utilities from ./query-sdk for advanced usage
 var query_sdk_2 = require("./query-sdk");
@@ -39,9 +39,9 @@ Object.defineProperty(exports, "createHttpClient", { enumerable: true, get: func
 // SDK version
 exports.VERSION = '1.0.0';
 /**
- * OnChainDB TypeScript SDK
+ * OnDB TypeScript SDK
  *
- * A complete TypeScript SDK for OnChainDB - the decentralized database
+ * A complete TypeScript SDK for OnDB - the decentralized database
  * built on Celestia blockchain.
  *
  * Features:
@@ -58,7 +58,7 @@ exports.VERSION = '1.0.0';
  *
  * @example Basic Usage
  * ```typescript
- * import { createClient } from '@onchaindb/sdk';
+ * import { createClient } from '@ondb/sdk';
  *
  * const db = createClient({
  *   endpoint: 'http://localhost:9092',
@@ -67,7 +67,7 @@ exports.VERSION = '1.0.0';
  *
  * // Store data
  * const result = await db.store({
- *   data: { message: 'Hello OnChainDB!', user: 'alice' },
+ *   data: { message: 'Hello OnDB!', user: 'alice' },
  *   collection: 'messages'
  * });
  *
@@ -85,9 +85,9 @@ exports.VERSION = '1.0.0';
  *
  * @example Advanced Usage with Events
  * ```typescript
- * import { OnChainDBClient } from '@onchaindb/sdk';
+ * import { OnDBClient } from '@ondb/sdk';
  *
- * const db = new OnChainDBClient({
+ * const db = new OnDBClient({
  *   endpoint: 'http://localhost:9092'
  * });
  *
@@ -109,9 +109,9 @@ exports.VERSION = '1.0.0';
  *
  * @example Batch Operations
  * ```typescript
- * import { OnChainDBClient, BulkBuilder } from '@onchaindb/sdk';
+ * import { OnDBClient, BulkBuilder } from '@ondb/sdk';
  *
- * const db = new OnChainDBClient({ endpoint: 'http://localhost:9092' });
+ * const db = new OnDBClient({ endpoint: 'http://localhost:9092' });
  * const batch = db.batch();
  *
  * // Build bulk operation
@@ -133,7 +133,7 @@ exports.VERSION = '1.0.0';
  *
  * @example Database Management
  * ```typescript
- * import { createClient } from '@onchaindb/sdk';
+ * import { createClient } from '@ondb/sdk';
  *
  * const client = createClient({
  *   endpoint: 'http://localhost:9092',
@@ -169,7 +169,7 @@ exports.VERSION = '1.0.0';
  *
  * @example Error Handling
  * ```typescript
- * import { OnChainDBError, TransactionError, ValidationError } from '@onchaindb/sdk';
+ * import { OnDBError, TransactionError, ValidationError } from '@ondb/sdk';
  *
  * try {
  *   await db.store({ data: { test: 'data' } });
@@ -178,8 +178,8 @@ exports.VERSION = '1.0.0';
  *     console.log('Validation failed:', error.message);
  *   } else if (error instanceof TransactionError) {
  *     console.log('Transaction failed:', error.transactionId);
- *   } else if (error instanceof OnChainDBError) {
- *     console.log('OnChainDB error:', error.code);
+ *   } else if (error instanceof OnDBError) {
+ *     console.log('OnDB error:', error.code);
  *   }
  * }
  * ```

package/src/index.ts

@@ -1,11 +1,11 @@
 // Main SDK exports
-export { OnChainDBClient } from './client';
+export { OnDBClient } from './client';
 export { QueryBuilder } from './query-sdk';
 export { DatabaseManager, createDatabaseManager } from './database';
 
 // Core type exports
 export type {
-    OnChainDBConfig,
+    OnDBConfig,
     StoreRequest,
     StoreResponse,
     TransactionStatus,
@@ -22,7 +22,6 @@ export type {
     RetrieveBlobRequest,
     BlobMetadata,
     PricingQuoteRequest,
-    PricingQuoteResponse,
     SimpleCollectionSchema,
     SimpleFieldDefinition,
     SimpleCollectionSchemaWithSharding,
@@ -81,7 +80,7 @@ export type {
 
 // Error exports
 export {
-    OnChainDBError,
+    OnDBError,
     TransactionError,
     ValidationError,
     PaymentRequiredError,
@@ -89,11 +88,11 @@ export {
 } from './types';
 
 // Convenience factory function
-import { OnChainDBConfig } from './types';
-import { OnChainDBClient } from './client';
+import { OnDBConfig } from './types';
+import { OnDBClient } from './client';
 
-export function createClient(config: OnChainDBConfig): OnChainDBClient {
-    return new OnChainDBClient(config);
+export function createClient(config: OnDBConfig): OnDBClient {
+    return new OnDBClient(config);
 }
 
 // SDK version

package/src/query-sdk/{OnChainDB.ts → OnDB.ts}

@@ -3,7 +3,7 @@ import {SelectionBuilder} from './SelectionBuilder';
 import {FieldMap, HttpClient, QueryRequest, QueryResponse, QueryValue} from "./index";
 
 // Main SDK class providing static methods for query building
-export class OnChainDB {
+export class OnDB {
     private static httpClient?: HttpClient;
     private static serverUrl?: string;
     private static apiKey?: string;

package/src/query-sdk/README.md

@@ -1,4 +1,4 @@
-# OnChainDB Query SDK
+# OnDB Query SDK
 
 Fluent API for building queries with server-side JOINs, logical operators, field conditions, and aggregations.
 
@@ -92,7 +92,7 @@ All operators available on `whereField()` and `FieldConditionBuilder`:
 ### FieldConditionBuilder directly
 
 ```typescript
-import { FieldConditionBuilder } from '@onchaindb/sdk';
+import { FieldConditionBuilder } from '@ondb/sdk';
 
 const condition = new FieldConditionBuilder('user.profile.bio').contains('Developer');
 condition.toComposable(); // { user: { profile: { bio: { includes: 'Developer' } } } }
@@ -101,7 +101,7 @@ condition.toComposable(); // { user: { profile: { bio: { includes: 'Developer' }
 ## Logical Operators
 
 ```typescript
-import { LogicalOperator } from '@onchaindb/sdk';
+import { LogicalOperator } from '@ondb/sdk';
 
 const result = await db.queryBuilder()
   .collection('posts')
@@ -297,7 +297,7 @@ db.queryBuilder().collection('users').selectAll().execute();
 ### SelectionBuilder
 
 ```typescript
-import { SelectionBuilder } from '@onchaindb/sdk';
+import { SelectionBuilder } from '@ondb/sdk';
 
 // Field-by-field
 const sel = new SelectionBuilder().field('id').field('name').build();
@@ -342,7 +342,7 @@ const result = await db.queryBuilder()
 ### NestedConditionBuilder
 
 ```typescript
-import { NestedConditionBuilder } from '@onchaindb/sdk';
+import { NestedConditionBuilder } from '@ondb/sdk';
 
 const result = await db.queryBuilder()
   .collection('users')
@@ -362,7 +362,7 @@ const result = await db.queryBuilder()
 A lightweight wrapper around query response data for convenient access. Aggregation, sorting, filtering, and joining are handled server-side via `QueryBuilder`.
 
 ```typescript
-import { createQueryResult } from '@onchaindb/sdk';
+import { createQueryResult } from '@ondb/sdk';
 
 const result = createQueryResult(response.records);
 
@@ -385,13 +385,13 @@ import {
   AxiosHttpClient,   // Axios (browser or Node.js)
   NodeHttpClient,    // Node.js native HTTP
   createHttpClient   // Auto-detect best for environment
-} from '@onchaindb/sdk';
+} from '@ondb/sdk';
 ```
 
 ### Custom HTTP Client
 
 ```typescript
-import { HttpClient } from '@onchaindb/sdk';
+import { HttpClient } from '@ondb/sdk';
 
 class MyHttpClient implements HttpClient {
   async post(url: string, data: any, headers?: Record<string, string>): Promise<any> {

package/src/query-sdk/index.ts

@@ -41,7 +41,7 @@ export interface DateRange {
 }
 
 // Main SDK exports
-export {OnChainDB} from './OnChainDB';
+export {OnDB} from './OnDB';
 export {QueryBuilder, JoinBuilder, ServerJoinConfig, GroupByQueryBuilder} from './QueryBuilder';
 export {SelectionBuilder} from './SelectionBuilder';
 export {ConditionBuilder} from './ConditionBuilder';

package/src/tests/client-requests.test.ts

@@ -1,5 +1,5 @@
 import axios from 'axios';
-import { OnChainDBClient } from '../client';
+import { OnDBClient } from '../client';
 import { CreateQueryRequest } from '../types';
 
 // Spy on axios.create so we can capture the instance handed to the client
@@ -11,7 +11,7 @@ let mockHttp: {
     interceptors: { request: { use: jest.Mock }; response: { use: jest.Mock } };
 };
 let createSpy: jest.SpyInstance;
-let client: OnChainDBClient;
+let client: OnDBClient;
 
 beforeEach(() => {
     mockHttp = {
@@ -25,7 +25,7 @@ beforeEach(() => {
         },
     };
     createSpy = jest.spyOn(axios, 'create').mockReturnValue(mockHttp as any);
-    client = new OnChainDBClient({
+    client = new OnDBClient({
         endpoint: 'http://localhost:9092',
         appId: 'test_app',
         appKey: 'key123',

package/src/tests/client-validation.test.ts

@@ -1,19 +1,19 @@
-import { OnChainDBClient } from '../client';
+import { OnDBClient } from '../client';
 import { ValidationError } from '../types';
 
 // These tests cover pure validation logic that throws before any HTTP is made.
 // No axios mock required — the errors fire synchronously before any await.
 
-const clientWithApp = new OnChainDBClient({
+const clientWithApp = new OnDBClient({
     endpoint: 'http://localhost:9092',
     appId: 'test_app',
 });
 
-const clientNoApp = new OnChainDBClient({
+const clientNoApp = new OnDBClient({
     endpoint: 'http://localhost:9092',
 });
 
-describe('OnChainDBClient — store() validation', () => {
+describe('OnDBClient — store() validation', () => {
     test('throws when data is empty array', async () => {
         await expect(
             clientWithApp.store({ collection: 'col', data: [] })
@@ -52,7 +52,7 @@ describe('OnChainDBClient — store() validation', () => {
     });
 });
 
-describe('OnChainDBClient — appId-required methods throw ValidationError when appId is missing', () => {
+describe('OnDBClient — appId-required methods throw ValidationError when appId is missing', () => {
     const cases: Array<[string, () => Promise<any>]> = [
         ['setupSharding()', () => clientNoApp.setupSharding('col', { keys: [], enforce_in_queries: false })],
         ['syncCollection()', () => clientNoApp.syncCollection({ name: 'col', fields: {} })],

package/src/types.d.ts

@@ -1,5 +1,5 @@
 import { QueryValue } from "./query-sdk";
-export interface OnChainDBConfig {
+export interface OnDBConfig {
     endpoint: string;
     apiKey?: string;
     appId?: string;
@@ -68,25 +68,25 @@ export interface TransactionEvents {
     'transaction:failed': (tx: TransactionStatus) => void;
     'error': (error: Error) => void;
 }
-export declare class OnChainDBError extends Error {
+export declare class OnDBError extends Error {
     code: string;
     statusCode?: number | undefined;
     details?: any | undefined;
     constructor(message: string, code: string, statusCode?: number | undefined, details?: any | undefined);
 }
-export declare class TransactionError extends OnChainDBError {
+export declare class TransactionError extends OnDBError {
     transactionId: string;
     constructor(message: string, transactionId: string, details?: any);
 }
-export declare class ValidationError extends OnChainDBError {
+export declare class ValidationError extends OnDBError {
     constructor(message: string, details?: any);
 }
-export declare class PaymentRequiredError extends OnChainDBError {
+export declare class PaymentRequiredError extends OnDBError {
     requiredAmount: number;
     providedAmount?: number | undefined;
     constructor(message: string, requiredAmount: number, providedAmount?: number | undefined, details?: any);
 }
-export declare class PaymentVerificationError extends OnChainDBError {
+export declare class PaymentVerificationError extends OnDBError {
     txHash: string;
     constructor(message: string, txHash: string, details?: any);
 }

package/src/types.js

@@ -1,18 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaymentVerificationError = exports.PaymentRequiredError = exports.ValidationError = exports.TransactionError = exports.OnChainDBError = void 0;
+exports.PaymentVerificationError = exports.PaymentRequiredError = exports.ValidationError = exports.TransactionError = exports.OnDBError = void 0;
 // Error Types
-class OnChainDBError extends Error {
+class OnDBError extends Error {
     constructor(message, code, statusCode, details) {
         super(message);
         this.code = code;
         this.statusCode = statusCode;
         this.details = details;
-        this.name = 'OnChainDBError';
+        this.name = 'OnDBError';
     }
 }
-exports.OnChainDBError = OnChainDBError;
-class TransactionError extends OnChainDBError {
+exports.OnDBError = OnDBError;
+class TransactionError extends OnDBError {
     constructor(message, transactionId, details) {
         super(message, 'TRANSACTION_ERROR', undefined, details);
         this.transactionId = transactionId;
@@ -20,14 +20,14 @@ class TransactionError extends OnChainDBError {
     }
 }
 exports.TransactionError = TransactionError;
-class ValidationError extends OnChainDBError {
+class ValidationError extends OnDBError {
     constructor(message, details) {
         super(message, 'VALIDATION_ERROR', 400, details);
         this.name = 'ValidationError';
     }
 }
 exports.ValidationError = ValidationError;
-class PaymentRequiredError extends OnChainDBError {
+class PaymentRequiredError extends OnDBError {
     constructor(message, requiredAmount, providedAmount, details) {
         super(message, 'PAYMENT_REQUIRED', 402, details);
         this.requiredAmount = requiredAmount;
@@ -36,7 +36,7 @@ class PaymentRequiredError extends OnChainDBError {
     }
 }
 exports.PaymentRequiredError = PaymentRequiredError;
-class PaymentVerificationError extends OnChainDBError {
+class PaymentVerificationError extends OnDBError {
     constructor(message, txHash, details) {
         super(message, 'PAYMENT_VERIFICATION_FAILED', 402, details);
         this.txHash = txHash;

package/src/types.ts

@@ -1,8 +1,8 @@
-// Core OnChainDB Types
+// Core OnDB Types
 import {QueryValue} from "./query-sdk";
 import {X402Quote} from "./x402/types";
 
-export interface OnChainDBConfig {
+export interface OnDBConfig {
     endpoint: string;
     apiKey?: string; // Deprecated: use appKey instead
     appKey?: string; // App API key for write operations (X-App-Key header)
@@ -149,8 +149,8 @@ export interface QueryRequest {
 export interface AdvancedQueryRequest {
     root?: string; // Format: "app::collection" - ONLY NEW THING
     collection?: string; // Collection name (will be combined with appId if provided)
-    find?: any; // Flexible find conditions from onChainDBSDK
-    select?: any; // Selection map from onChainDBSDK
+    find?: any; // Flexible find conditions from onDBSDK
+    select?: any; // Selection map from onDBSDK
 
     // All existing functionality stays the same
     filters?: Record<string, any>;
@@ -200,7 +200,7 @@ export interface TransactionEvents {
 }
 
 // Error Types
-export class OnChainDBError extends Error {
+export class OnDBError extends Error {
     constructor(
         message: string,
         public code: string,
@@ -208,11 +208,11 @@ export class OnChainDBError extends Error {
         public details?: any
     ) {
         super(message);
-        this.name = 'OnChainDBError';
+        this.name = 'OnDBError';
     }
 }
 
-export class TransactionError extends OnChainDBError {
+export class TransactionError extends OnDBError {
     constructor(
         message: string,
         public transactionId: string,
@@ -223,14 +223,14 @@ export class TransactionError extends OnChainDBError {
     }
 }
 
-export class ValidationError extends OnChainDBError {
+export class ValidationError extends OnDBError {
     constructor(message: string, details?: any) {
         super(message, 'VALIDATION_ERROR', 400, details);
         this.name = 'ValidationError';
     }
 }
 
-export class PaymentRequiredError extends OnChainDBError {
+export class PaymentRequiredError extends OnDBError {
     constructor(
         message: string,
         public quote: X402Quote,
@@ -241,7 +241,7 @@ export class PaymentRequiredError extends OnChainDBError {
     }
 }
 
-export class PaymentVerificationError extends OnChainDBError {
+export class PaymentVerificationError extends OnDBError {
     constructor(
         message: string,
         public txHash: string,
@@ -329,42 +329,6 @@ export interface PricingQuoteRequest {
     data?: any; // Sample data for price index calculation
 }
 
-export interface PricingQuoteResponse {
-    type: 'write_quote_with_indexing' | 'read_quote';
-    // Base costs
-    base_celestia_cost: number;
-    base_celestia_cost_utia: number;
-    broker_fee: number;
-    broker_fee_utia: number;
-    // Indexing costs per field
-    indexing_costs: Record<string, number>;
-    indexing_costs_utia: Record<string, number>;
-    // Total before price index fees
-    base_total_cost: number;
-    base_total_cost_utia: number;
-    // Final total (includes price index fees if any)
-    total_cost: number;
-    total_cost_utia: number;
-    // Metadata
-    indexed_fields_count: number;
-    request: PricingQuoteRequest;
-    monthly_volume_kb: number;
-    currency: string;
-    // Optional breakdowns
-    creator_premium?: {
-        premium_total: number;
-        premium_total_utia: number;
-        premium_type: string;
-        premium_amount: number;
-        creator_revenue: number;
-        creator_revenue_utia: number;
-        platform_revenue: number;
-        platform_revenue_utia: number;
-        revenue_split: string;
-    };
-    price?: any; // Price index breakdown (single or multiple fields)
-}
-
 // ============================================================================
 // Collection Schema Types (for createCollection convenience method)
 // ============================================================================

package/src/x402/types.ts

@@ -47,7 +47,7 @@ export interface X402PaymentRequirement {
 }
 
 /**
- * x402 Extra field with OnChainDB extensions
+ * x402 Extra field with OnDB extensions
  */
 export interface X402Extra {
     /** Extension identifier */
@@ -164,8 +164,8 @@ export interface X402PaymentResponse {
 export interface X402Quote {
     /** Quote ID */
     quoteId: string;
-    /** Total cost in TIA */
-    totalCostTia: number;
+    /** Total cost */
+    totalCost: number;
     /** Amount in smallest units */
     amountRaw: string;
     /** Broker/recipient address */

package/src/x402/utils.ts

@@ -79,9 +79,9 @@ export function requirementToQuote(
         chainType = 'solana';
     }
 
-    // Calculate TIA amount (for display purposes)
+    // Calculate total cost (for display purposes)
     const decimals = extra.tokenDecimals || 6;
-    const totalCostTia = parseInt(amountRaw) / Math.pow(10, decimals);
+    const totalCost = parseInt(amountRaw) / Math.pow(10, decimals);
 
     // Calculate expiration
     const expiresAt = extra.pricing?.expiresAt ||
@@ -89,7 +89,7 @@ export function requirementToQuote(
 
     return {
         quoteId: extra.quoteId || '',
-        totalCostTia,
+        totalCost,
         amountRaw,
         brokerAddress: requirement.payTo,
         description: requirement.description,