@0xobelisk/client 0.4.8 → 1.2.0-pre.93

package/dist/index.d.ts

@@ -1,9 +1,27 @@
-export * from '@mysten/sui.js';
-export { Ed25519Keypair } from '@mysten/sui.js/keypairs/ed25519';
-export { BCS, getSuiMoveConfig } from '@mysten/bcs';
-export { Obelisk } from './obelisk';
-export { SuiAccountManager } from './libs/suiAccountManager';
-export { SuiTxBlock } from './libs/suiTxBuilder';
-export { SuiContractFactory } from './libs/suiContractFactory';
-export { loadMetadata } from './metadata';
-export type * from './types';
+/**
+ * @0xobelisk/client - Unified Client Creation Layer for Dubhe Framework
+ *
+ * This package provides a unified interface for creating blockchain clients
+ * across different chains. Currently supports Sui, with more chains coming soon.
+ *
+ * Usage:
+ * - For Sui: import from '@0xobelisk/client/sui'
+ * - For Aptos: import from '@0xobelisk/client/aptos' (coming soon)
+ * - For Initia: import from '@0xobelisk/client/initia' (coming soon)
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@0xobelisk/client/sui';
+ *
+ * const client = createClient({
+ *   network: 'devnet',
+ *   packageId: '0x123...',
+ *   metadata: contractMetadata,
+ *   credentials: { secretKey: '...' }
+ * });
+ * ```
+ */
+/**
+ * Note: Import chain-specific clients from their subpaths:
+ * - '@0xobelisk/client/sui'
+ */

package/dist/sui/client.d.ts

@@ -0,0 +1,59 @@
+import type { ClientConfig, DubheClientBundle } from './types';
+/**
+ * Create a Dubhe client bundle with all necessary instances
+ *
+ * This factory function creates and initializes:
+ * - Dubhe contract client for on-chain interactions
+ * - GraphQL client for querying indexed data
+ * - gRPC client for high-performance queries
+ * - ECS World for entity-component-system queries
+ *
+ * @param config - Client configuration matching @0xobelisk/react interface
+ * @returns DubheClientBundle with all initialized client instances
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@0xobelisk/client/sui';
+ * import metadata from './metadata.json';
+ *
+ * const client = createClient({
+ *   network: 'devnet',
+ *   packageId: '0x123...',
+ *   metadata,
+ *   credentials: {
+ *     secretKey: process.env.PRIVATE_KEY
+ *   }
+ * });
+ *
+ * // Use the contract client
+ * const tx = new Transaction();
+ * await client.contract.tx.counter_system.inc({ tx });
+ *
+ * // Use GraphQL client
+ * const data = await client.graphqlClient.query(...);
+ *
+ * // Use ECS World
+ * const entities = client.ecsWorld.getEntities();
+ * ```
+ */
+export declare function createClient(config: ClientConfig): DubheClientBundle;
+/**
+ * Type guard to check if a value is a valid NetworkType
+ */
+export declare function isNetworkType(value: string): value is ClientConfig['network'];
+/**
+ * Helper function to validate client configuration
+ * Throws descriptive errors for invalid configurations
+ */
+export declare function validateClientConfig(config: Partial<ClientConfig>): asserts config is ClientConfig;
+/**
+ * Create client with configuration validation
+ * Useful when working with external configuration sources
+ *
+ * @example
+ * ```typescript
+ * const config = loadConfigFromFile(); // May be incomplete
+ * const client = createClientWithValidation(config); // Throws if invalid
+ * ```
+ */
+export declare function createClientWithValidation(config: Partial<ClientConfig>): DubheClientBundle;

package/dist/sui/index.d.mts

@@ -0,0 +1,154 @@
+import { Dubhe, SuiMoveNormalizedModules } from '@0xobelisk/sui-client';
+export { Dubhe } from '@0xobelisk/sui-client';
+import { DubheGraphqlClient } from '@0xobelisk/graphql-client';
+export { DubheGraphqlClient } from '@0xobelisk/graphql-client';
+import { DubheECSWorld } from '@0xobelisk/ecs';
+export { DubheECSWorld } from '@0xobelisk/ecs';
+import { DubheGrpcClient } from '@0xobelisk/grpc-client';
+export { DubheGrpcClient } from '@0xobelisk/grpc-client';
+
+/**
+ * Network type for Sui blockchain
+ */
+type NetworkType = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
+/**
+ * Client configuration interface
+ * Aligned with @0xobelisk/react configuration for consistency
+ */
+interface ClientConfig {
+    /** Network type */
+    network: NetworkType;
+    /** Contract package ID */
+    packageId: string;
+    /** Contract metadata (required for contract instantiation) */
+    metadata: any;
+    /** Dubhe Schema ID (optional, for enhanced features) */
+    dubheSchemaId?: string;
+    /** Dubhe metadata (enables GraphQL/ECS features) */
+    dubheMetadata?: any;
+    /** Authentication credentials */
+    credentials?: {
+        /** Private key (base64 or hex string) */
+        secretKey?: string;
+        /** Mnemonic phrase (12 or 24 words) */
+        mnemonics?: string;
+    };
+    /** Service endpoints configuration */
+    endpoints?: {
+        /** Full node RPC URLs (can provide multiple for redundancy) */
+        fullnodeUrls?: string[];
+        /** GraphQL endpoint URL */
+        graphql?: string;
+        /** WebSocket endpoint URL for subscriptions */
+        websocket?: string;
+        /** gRPC endpoint URL */
+        grpc?: string;
+    };
+    /** Performance and behavior options */
+    options?: {
+        /** Enable batch query optimization */
+        enableBatchOptimization?: boolean;
+        /** Default cache timeout (milliseconds) */
+        cacheTimeout?: number;
+        /** Request debounce delay (milliseconds) */
+        debounceMs?: number;
+        /** Auto-reconnect on WebSocket errors */
+        reconnectOnError?: boolean;
+    };
+}
+/**
+ * Type alias for consistency with @0xobelisk/react package
+ */
+type DubheConfig = ClientConfig;
+/**
+ * Client bundle returned by createClient
+ * Contains all initialized client instances
+ */
+interface DubheClientBundle {
+    /** Dubhe contract instance - core client for contract interactions */
+    contract: Dubhe;
+    /** GraphQL client for querying indexed data */
+    graphqlClient: DubheGraphqlClient;
+    /** gRPC client for high-performance queries */
+    grpcClient: DubheGrpcClient;
+    /** ECS World instance for entity-component-system queries */
+    ecsWorld: DubheECSWorld;
+    /** Contract metadata */
+    metadata: SuiMoveNormalizedModules;
+    /** Network type */
+    network: NetworkType;
+    /** Package ID */
+    packageId: string;
+    /** Dubhe Schema ID (if provided) */
+    dubheSchemaId?: string;
+    /** User address */
+    address: string;
+    /** Configuration options used */
+    options?: {
+        enableBatchOptimization?: boolean;
+        cacheTimeout?: number;
+        debounceMs?: number;
+        reconnectOnError?: boolean;
+    };
+}
+
+/**
+ * Create a Dubhe client bundle with all necessary instances
+ *
+ * This factory function creates and initializes:
+ * - Dubhe contract client for on-chain interactions
+ * - GraphQL client for querying indexed data
+ * - gRPC client for high-performance queries
+ * - ECS World for entity-component-system queries
+ *
+ * @param config - Client configuration matching @0xobelisk/react interface
+ * @returns DubheClientBundle with all initialized client instances
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@0xobelisk/client/sui';
+ * import metadata from './metadata.json';
+ *
+ * const client = createClient({
+ *   network: 'devnet',
+ *   packageId: '0x123...',
+ *   metadata,
+ *   credentials: {
+ *     secretKey: process.env.PRIVATE_KEY
+ *   }
+ * });
+ *
+ * // Use the contract client
+ * const tx = new Transaction();
+ * await client.contract.tx.counter_system.inc({ tx });
+ *
+ * // Use GraphQL client
+ * const data = await client.graphqlClient.query(...);
+ *
+ * // Use ECS World
+ * const entities = client.ecsWorld.getEntities();
+ * ```
+ */
+declare function createClient(config: ClientConfig): DubheClientBundle;
+/**
+ * Type guard to check if a value is a valid NetworkType
+ */
+declare function isNetworkType(value: string): value is ClientConfig['network'];
+/**
+ * Helper function to validate client configuration
+ * Throws descriptive errors for invalid configurations
+ */
+declare function validateClientConfig(config: Partial<ClientConfig>): asserts config is ClientConfig;
+/**
+ * Create client with configuration validation
+ * Useful when working with external configuration sources
+ *
+ * @example
+ * ```typescript
+ * const config = loadConfigFromFile(); // May be incomplete
+ * const client = createClientWithValidation(config); // Throws if invalid
+ * ```
+ */
+declare function createClientWithValidation(config: Partial<ClientConfig>): DubheClientBundle;
+
+export { type ClientConfig, type DubheClientBundle, type DubheConfig, type NetworkType, createClient, createClientWithValidation, isNetworkType, validateClientConfig };

package/dist/sui/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @0xobelisk/client/sui - Unified Dubhe Client for Sui Blockchain
+ *
+ * 🚀 Simple, powerful client creation aligned with @0xobelisk/react
+ *
+ * Features:
+ * - ⚡ Unified configuration interface
+ * - 🔧 Factory pattern for easy instantiation
+ * - 🛡️ Complete type safety with strict TypeScript
+ * - 📦 All-in-one bundle with contract, GraphQL, gRPC, and ECS clients
+ * - 🎯 Intuitive API design
+ * - 🌐 Platform-agnostic (Browser, Node.js, COCOS)
+ */
+export type { NetworkType, ClientConfig, DubheConfig, DubheClientBundle } from './types';
+export { createClient, createClientWithValidation, validateClientConfig, isNetworkType } from './client';
+export type { Dubhe } from '@0xobelisk/sui-client';
+export type { DubheGraphqlClient } from '@0xobelisk/graphql-client';
+export type { DubheECSWorld } from '@0xobelisk/ecs';
+export type { DubheGrpcClient } from '@0xobelisk/grpc-client';

package/dist/sui/index.js

@@ -0,0 +1,92 @@
+'use strict';
+
+var suiClient = require('@0xobelisk/sui-client');
+var graphqlClient = require('@0xobelisk/graphql-client');
+var ecs = require('@0xobelisk/ecs');
+var grpcClient = require('@0xobelisk/grpc-client');
+
+// src/sui/client.ts
+function createClient(config) {
+  if (!config.network) {
+    throw new Error("ClientConfig: network is required");
+  }
+  if (!config.packageId) {
+    throw new Error("ClientConfig: packageId is required");
+  }
+  if (!config.metadata) {
+    throw new Error("ClientConfig: metadata is required");
+  }
+  const contract = new suiClient.Dubhe({
+    networkType: config.network,
+    packageId: config.packageId,
+    metadata: config.metadata,
+    secretKey: config.credentials?.secretKey,
+    mnemonics: config.credentials?.mnemonics,
+    fullnodeUrls: config.endpoints?.fullnodeUrls
+  });
+  const graphqlClient$1 = graphqlClient.createDubheGraphqlClient({
+    endpoint: config.endpoints?.graphql || "http://localhost:4000/graphql",
+    subscriptionEndpoint: config.endpoints?.websocket || "ws://localhost:4000/graphql",
+    dubheMetadata: config.dubheMetadata
+  });
+  const grpcClient$1 = new grpcClient.DubheGrpcClient({
+    baseUrl: config.endpoints?.grpc || "http://localhost:8080"
+  });
+  const ecsWorld = ecs.createECSWorld(graphqlClient$1, {
+    dubheMetadata: config.dubheMetadata,
+    queryConfig: {
+      enableBatchOptimization: config.options?.enableBatchOptimization ?? true,
+      defaultCacheTimeout: config.options?.cacheTimeout ?? 5e3
+    },
+    subscriptionConfig: {
+      defaultDebounceMs: config.options?.debounceMs ?? 100,
+      reconnectOnError: config.options?.reconnectOnError ?? true
+    }
+  });
+  const address = contract.getAddress();
+  return {
+    contract,
+    graphqlClient: graphqlClient$1,
+    grpcClient: grpcClient$1,
+    ecsWorld,
+    metadata: config.metadata,
+    network: config.network,
+    packageId: config.packageId,
+    dubheSchemaId: config.dubheSchemaId,
+    address,
+    options: config.options
+  };
+}
+function isNetworkType(value) {
+  return ["mainnet", "testnet", "devnet", "localnet"].includes(value);
+}
+function validateClientConfig(config) {
+  if (!config.network) {
+    throw new Error("ClientConfig validation failed: network is required");
+  }
+  if (!isNetworkType(config.network)) {
+    throw new Error(
+      `ClientConfig validation failed: invalid network type "${config.network}". Must be one of: mainnet, testnet, devnet, localnet`
+    );
+  }
+  if (!config.packageId) {
+    throw new Error("ClientConfig validation failed: packageId is required");
+  }
+  if (typeof config.packageId !== "string" || config.packageId.trim() === "") {
+    throw new Error("ClientConfig validation failed: packageId must be a non-empty string");
+  }
+  if (!config.metadata) {
+    throw new Error("ClientConfig validation failed: metadata is required");
+  }
+}
+function createClientWithValidation(config) {
+  validateClientConfig(config);
+  return createClient(config);
+}
+
+exports.createClient = createClient;
+exports.createClientWithValidation = createClientWithValidation;
+exports.isNetworkType = isNetworkType;
+exports.validateClientConfig = validateClientConfig;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.js.map

package/dist/sui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sui/client.ts"],"names":[],"mappings":";AAAA,SAAS,aAAa;AACtB,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB;AAwCzB,SAAS,aAAa,QAAyC;AAEpE,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AACA,MAAI,CAAC,OAAO,WAAW;AACrB,UAAM,IAAI,MAAM,qCAAqC;AAAA,EACvD;AACA,MAAI,CAAC,OAAO,UAAU;AACpB,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AAGA,QAAM,WAAW,IAAI,MAAM;AAAA,IACzB,aAAa,OAAO;AAAA,IACpB,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO,aAAa;AAAA,IAC/B,WAAW,OAAO,aAAa;AAAA,IAC/B,cAAc,OAAO,WAAW;AAAA,EAClC,CAAC;AAGD,QAAM,gBAAgB,yBAAyB;AAAA,IAC7C,UAAU,OAAO,WAAW,WAAW;AAAA,IACvC,sBAAsB,OAAO,WAAW,aAAa;AAAA,IACrD,eAAe,OAAO;AAAA,EACxB,CAAC;AAGD,QAAM,aAAa,IAAI,gBAAgB;AAAA,IACrC,SAAS,OAAO,WAAW,QAAQ;AAAA,EACrC,CAAC;AAGD,QAAM,WAAW,eAAe,eAAe;AAAA,IAC7C,eAAe,OAAO;AAAA,IACtB,aAAa;AAAA,MACX,yBAAyB,OAAO,SAAS,2BAA2B;AAAA,MACpE,qBAAqB,OAAO,SAAS,gBAAgB;AAAA,IACvD;AAAA,IACA,oBAAoB;AAAA,MAClB,mBAAmB,OAAO,SAAS,cAAc;AAAA,MACjD,kBAAkB,OAAO,SAAS,oBAAoB;AAAA,IACxD;AAAA,EACF,CAAC;AAGD,QAAM,UAAU,SAAS,WAAW;AAGpC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,SAAS,OAAO;AAAA,IAChB,WAAW,OAAO;AAAA,IAClB,eAAe,OAAO;AAAA,IACtB;AAAA,IACA,SAAS,OAAO;AAAA,EAClB;AACF;AAKO,SAAS,cAAc,OAAiD;AAC7E,SAAO,CAAC,WAAW,WAAW,UAAU,UAAU,EAAE,SAAS,KAAK;AACpE;AAMO,SAAS,qBACd,QACgC;AAChC,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,MAAI,CAAC,cAAc,OAAO,OAAO,GAAG;AAClC,UAAM,IAAI;AAAA,MACR,yDAAyD,OAAO,OAAO;AAAA,IAEzE;AAAA,EACF;AACA,MAAI,CAAC,OAAO,WAAW;AACrB,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,MAAI,OAAO,OAAO,cAAc,YAAY,OAAO,UAAU,KAAK,MAAM,IAAI;AAC1E,UAAM,IAAI,MAAM,sEAAsE;AAAA,EACxF;AACA,MAAI,CAAC,OAAO,UAAU;AACpB,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AACF;AAYO,SAAS,2BAA2B,QAAkD;AAC3F,uBAAqB,MAAM;AAC3B,SAAO,aAAa,MAAM;AAC5B","sourcesContent":["import { Dubhe } from '@0xobelisk/sui-client';\nimport { createDubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport { createECSWorld } from '@0xobelisk/ecs';\nimport { DubheGrpcClient } from '@0xobelisk/grpc-client';\nimport type { ClientConfig, DubheClientBundle } from './types';\n\n/**\n * Create a Dubhe client bundle with all necessary instances\n *\n * This factory function creates and initializes:\n * - Dubhe contract client for on-chain interactions\n * - GraphQL client for querying indexed data\n * - gRPC client for high-performance queries\n * - ECS World for entity-component-system queries\n *\n * @param config - Client configuration matching @0xobelisk/react interface\n * @returns DubheClientBundle with all initialized client instances\n *\n * @example\n * ```typescript\n * import { createClient } from '@0xobelisk/client/sui';\n * import metadata from './metadata.json';\n *\n * const client = createClient({\n *   network: 'devnet',\n *   packageId: '0x123...',\n *   metadata,\n *   credentials: {\n *     secretKey: process.env.PRIVATE_KEY\n *   }\n * });\n *\n * // Use the contract client\n * const tx = new Transaction();\n * await client.contract.tx.counter_system.inc({ tx });\n *\n * // Use GraphQL client\n * const data = await client.graphqlClient.query(...);\n *\n * // Use ECS World\n * const entities = client.ecsWorld.getEntities();\n * ```\n */\nexport function createClient(config: ClientConfig): DubheClientBundle {\n  // Validate required fields\n  if (!config.network) {\n    throw new Error('ClientConfig: network is required');\n  }\n  if (!config.packageId) {\n    throw new Error('ClientConfig: packageId is required');\n  }\n  if (!config.metadata) {\n    throw new Error('ClientConfig: metadata is required');\n  }\n\n  // Initialize Dubhe contract client\n  const contract = new Dubhe({\n    networkType: config.network,\n    packageId: config.packageId,\n    metadata: config.metadata,\n    secretKey: config.credentials?.secretKey,\n    mnemonics: config.credentials?.mnemonics,\n    fullnodeUrls: config.endpoints?.fullnodeUrls\n  });\n\n  // Initialize GraphQL client with default localhost endpoint if not provided\n  const graphqlClient = createDubheGraphqlClient({\n    endpoint: config.endpoints?.graphql || 'http://localhost:4000/graphql',\n    subscriptionEndpoint: config.endpoints?.websocket || 'ws://localhost:4000/graphql',\n    dubheMetadata: config.dubheMetadata\n  });\n\n  // Initialize gRPC client with default localhost endpoint if not provided\n  const grpcClient = new DubheGrpcClient({\n    baseUrl: config.endpoints?.grpc || 'http://localhost:8080'\n  });\n\n  // Initialize ECS World (depends on GraphQL client)\n  const ecsWorld = createECSWorld(graphqlClient, {\n    dubheMetadata: config.dubheMetadata,\n    queryConfig: {\n      enableBatchOptimization: config.options?.enableBatchOptimization ?? true,\n      defaultCacheTimeout: config.options?.cacheTimeout ?? 5000\n    },\n    subscriptionConfig: {\n      defaultDebounceMs: config.options?.debounceMs ?? 100,\n      reconnectOnError: config.options?.reconnectOnError ?? true\n    }\n  });\n\n  // Get user address from contract\n  const address = contract.getAddress();\n\n  // Return complete client bundle\n  return {\n    contract,\n    graphqlClient,\n    grpcClient,\n    ecsWorld,\n    metadata: config.metadata,\n    network: config.network,\n    packageId: config.packageId,\n    dubheSchemaId: config.dubheSchemaId,\n    address,\n    options: config.options\n  };\n}\n\n/**\n * Type guard to check if a value is a valid NetworkType\n */\nexport function isNetworkType(value: string): value is ClientConfig['network'] {\n  return ['mainnet', 'testnet', 'devnet', 'localnet'].includes(value);\n}\n\n/**\n * Helper function to validate client configuration\n * Throws descriptive errors for invalid configurations\n */\nexport function validateClientConfig(\n  config: Partial<ClientConfig>\n): asserts config is ClientConfig {\n  if (!config.network) {\n    throw new Error('ClientConfig validation failed: network is required');\n  }\n  if (!isNetworkType(config.network)) {\n    throw new Error(\n      `ClientConfig validation failed: invalid network type \"${config.network}\". ` +\n        'Must be one of: mainnet, testnet, devnet, localnet'\n    );\n  }\n  if (!config.packageId) {\n    throw new Error('ClientConfig validation failed: packageId is required');\n  }\n  if (typeof config.packageId !== 'string' || config.packageId.trim() === '') {\n    throw new Error('ClientConfig validation failed: packageId must be a non-empty string');\n  }\n  if (!config.metadata) {\n    throw new Error('ClientConfig validation failed: metadata is required');\n  }\n}\n\n/**\n * Create client with configuration validation\n * Useful when working with external configuration sources\n *\n * @example\n * ```typescript\n * const config = loadConfigFromFile(); // May be incomplete\n * const client = createClientWithValidation(config); // Throws if invalid\n * ```\n */\nexport function createClientWithValidation(config: Partial<ClientConfig>): DubheClientBundle {\n  validateClientConfig(config);\n  return createClient(config);\n}\n"]}

package/dist/sui/index.mjs

@@ -0,0 +1,87 @@
+import { Dubhe } from '@0xobelisk/sui-client';
+import { createDubheGraphqlClient } from '@0xobelisk/graphql-client';
+import { createECSWorld } from '@0xobelisk/ecs';
+import { DubheGrpcClient } from '@0xobelisk/grpc-client';
+
+// src/sui/client.ts
+function createClient(config) {
+  if (!config.network) {
+    throw new Error("ClientConfig: network is required");
+  }
+  if (!config.packageId) {
+    throw new Error("ClientConfig: packageId is required");
+  }
+  if (!config.metadata) {
+    throw new Error("ClientConfig: metadata is required");
+  }
+  const contract = new Dubhe({
+    networkType: config.network,
+    packageId: config.packageId,
+    metadata: config.metadata,
+    secretKey: config.credentials?.secretKey,
+    mnemonics: config.credentials?.mnemonics,
+    fullnodeUrls: config.endpoints?.fullnodeUrls
+  });
+  const graphqlClient = createDubheGraphqlClient({
+    endpoint: config.endpoints?.graphql || "http://localhost:4000/graphql",
+    subscriptionEndpoint: config.endpoints?.websocket || "ws://localhost:4000/graphql",
+    dubheMetadata: config.dubheMetadata
+  });
+  const grpcClient = new DubheGrpcClient({
+    baseUrl: config.endpoints?.grpc || "http://localhost:8080"
+  });
+  const ecsWorld = createECSWorld(graphqlClient, {
+    dubheMetadata: config.dubheMetadata,
+    queryConfig: {
+      enableBatchOptimization: config.options?.enableBatchOptimization ?? true,
+      defaultCacheTimeout: config.options?.cacheTimeout ?? 5e3
+    },
+    subscriptionConfig: {
+      defaultDebounceMs: config.options?.debounceMs ?? 100,
+      reconnectOnError: config.options?.reconnectOnError ?? true
+    }
+  });
+  const address = contract.getAddress();
+  return {
+    contract,
+    graphqlClient,
+    grpcClient,
+    ecsWorld,
+    metadata: config.metadata,
+    network: config.network,
+    packageId: config.packageId,
+    dubheSchemaId: config.dubheSchemaId,
+    address,
+    options: config.options
+  };
+}
+function isNetworkType(value) {
+  return ["mainnet", "testnet", "devnet", "localnet"].includes(value);
+}
+function validateClientConfig(config) {
+  if (!config.network) {
+    throw new Error("ClientConfig validation failed: network is required");
+  }
+  if (!isNetworkType(config.network)) {
+    throw new Error(
+      `ClientConfig validation failed: invalid network type "${config.network}". Must be one of: mainnet, testnet, devnet, localnet`
+    );
+  }
+  if (!config.packageId) {
+    throw new Error("ClientConfig validation failed: packageId is required");
+  }
+  if (typeof config.packageId !== "string" || config.packageId.trim() === "") {
+    throw new Error("ClientConfig validation failed: packageId must be a non-empty string");
+  }
+  if (!config.metadata) {
+    throw new Error("ClientConfig validation failed: metadata is required");
+  }
+}
+function createClientWithValidation(config) {
+  validateClientConfig(config);
+  return createClient(config);
+}
+
+export { createClient, createClientWithValidation, isNetworkType, validateClientConfig };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/sui/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sui/client.ts"],"names":[],"mappings":";AAAA,SAAS,aAAa;AACtB,SAAS,gCAAgC;AACzC,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB;AAwCzB,SAAS,aAAa,QAAyC;AAEpE,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AACA,MAAI,CAAC,OAAO,WAAW;AACrB,UAAM,IAAI,MAAM,qCAAqC;AAAA,EACvD;AACA,MAAI,CAAC,OAAO,UAAU;AACpB,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AAGA,QAAM,WAAW,IAAI,MAAM;AAAA,IACzB,aAAa,OAAO;AAAA,IACpB,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO;AAAA,IACjB,WAAW,OAAO,aAAa;AAAA,IAC/B,WAAW,OAAO,aAAa;AAAA,IAC/B,cAAc,OAAO,WAAW;AAAA,EAClC,CAAC;AAGD,QAAM,gBAAgB,yBAAyB;AAAA,IAC7C,UAAU,OAAO,WAAW,WAAW;AAAA,IACvC,sBAAsB,OAAO,WAAW,aAAa;AAAA,IACrD,eAAe,OAAO;AAAA,EACxB,CAAC;AAGD,QAAM,aAAa,IAAI,gBAAgB;AAAA,IACrC,SAAS,OAAO,WAAW,QAAQ;AAAA,EACrC,CAAC;AAGD,QAAM,WAAW,eAAe,eAAe;AAAA,IAC7C,eAAe,OAAO;AAAA,IACtB,aAAa;AAAA,MACX,yBAAyB,OAAO,SAAS,2BAA2B;AAAA,MACpE,qBAAqB,OAAO,SAAS,gBAAgB;AAAA,IACvD;AAAA,IACA,oBAAoB;AAAA,MAClB,mBAAmB,OAAO,SAAS,cAAc;AAAA,MACjD,kBAAkB,OAAO,SAAS,oBAAoB;AAAA,IACxD;AAAA,EACF,CAAC;AAGD,QAAM,UAAU,SAAS,WAAW;AAGpC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,SAAS,OAAO;AAAA,IAChB,WAAW,OAAO;AAAA,IAClB,eAAe,OAAO;AAAA,IACtB;AAAA,IACA,SAAS,OAAO;AAAA,EAClB;AACF;AAKO,SAAS,cAAc,OAAiD;AAC7E,SAAO,CAAC,WAAW,WAAW,UAAU,UAAU,EAAE,SAAS,KAAK;AACpE;AAMO,SAAS,qBACd,QACgC;AAChC,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,MAAI,CAAC,cAAc,OAAO,OAAO,GAAG;AAClC,UAAM,IAAI;AAAA,MACR,yDAAyD,OAAO,OAAO;AAAA,IAEzE;AAAA,EACF;AACA,MAAI,CAAC,OAAO,WAAW;AACrB,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,MAAI,OAAO,OAAO,cAAc,YAAY,OAAO,UAAU,KAAK,MAAM,IAAI;AAC1E,UAAM,IAAI,MAAM,sEAAsE;AAAA,EACxF;AACA,MAAI,CAAC,OAAO,UAAU;AACpB,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AACF;AAYO,SAAS,2BAA2B,QAAkD;AAC3F,uBAAqB,MAAM;AAC3B,SAAO,aAAa,MAAM;AAC5B","sourcesContent":["import { Dubhe } from '@0xobelisk/sui-client';\nimport { createDubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport { createECSWorld } from '@0xobelisk/ecs';\nimport { DubheGrpcClient } from '@0xobelisk/grpc-client';\nimport type { ClientConfig, DubheClientBundle } from './types';\n\n/**\n * Create a Dubhe client bundle with all necessary instances\n *\n * This factory function creates and initializes:\n * - Dubhe contract client for on-chain interactions\n * - GraphQL client for querying indexed data\n * - gRPC client for high-performance queries\n * - ECS World for entity-component-system queries\n *\n * @param config - Client configuration matching @0xobelisk/react interface\n * @returns DubheClientBundle with all initialized client instances\n *\n * @example\n * ```typescript\n * import { createClient } from '@0xobelisk/client/sui';\n * import metadata from './metadata.json';\n *\n * const client = createClient({\n *   network: 'devnet',\n *   packageId: '0x123...',\n *   metadata,\n *   credentials: {\n *     secretKey: process.env.PRIVATE_KEY\n *   }\n * });\n *\n * // Use the contract client\n * const tx = new Transaction();\n * await client.contract.tx.counter_system.inc({ tx });\n *\n * // Use GraphQL client\n * const data = await client.graphqlClient.query(...);\n *\n * // Use ECS World\n * const entities = client.ecsWorld.getEntities();\n * ```\n */\nexport function createClient(config: ClientConfig): DubheClientBundle {\n  // Validate required fields\n  if (!config.network) {\n    throw new Error('ClientConfig: network is required');\n  }\n  if (!config.packageId) {\n    throw new Error('ClientConfig: packageId is required');\n  }\n  if (!config.metadata) {\n    throw new Error('ClientConfig: metadata is required');\n  }\n\n  // Initialize Dubhe contract client\n  const contract = new Dubhe({\n    networkType: config.network,\n    packageId: config.packageId,\n    metadata: config.metadata,\n    secretKey: config.credentials?.secretKey,\n    mnemonics: config.credentials?.mnemonics,\n    fullnodeUrls: config.endpoints?.fullnodeUrls\n  });\n\n  // Initialize GraphQL client with default localhost endpoint if not provided\n  const graphqlClient = createDubheGraphqlClient({\n    endpoint: config.endpoints?.graphql || 'http://localhost:4000/graphql',\n    subscriptionEndpoint: config.endpoints?.websocket || 'ws://localhost:4000/graphql',\n    dubheMetadata: config.dubheMetadata\n  });\n\n  // Initialize gRPC client with default localhost endpoint if not provided\n  const grpcClient = new DubheGrpcClient({\n    baseUrl: config.endpoints?.grpc || 'http://localhost:8080'\n  });\n\n  // Initialize ECS World (depends on GraphQL client)\n  const ecsWorld = createECSWorld(graphqlClient, {\n    dubheMetadata: config.dubheMetadata,\n    queryConfig: {\n      enableBatchOptimization: config.options?.enableBatchOptimization ?? true,\n      defaultCacheTimeout: config.options?.cacheTimeout ?? 5000\n    },\n    subscriptionConfig: {\n      defaultDebounceMs: config.options?.debounceMs ?? 100,\n      reconnectOnError: config.options?.reconnectOnError ?? true\n    }\n  });\n\n  // Get user address from contract\n  const address = contract.getAddress();\n\n  // Return complete client bundle\n  return {\n    contract,\n    graphqlClient,\n    grpcClient,\n    ecsWorld,\n    metadata: config.metadata,\n    network: config.network,\n    packageId: config.packageId,\n    dubheSchemaId: config.dubheSchemaId,\n    address,\n    options: config.options\n  };\n}\n\n/**\n * Type guard to check if a value is a valid NetworkType\n */\nexport function isNetworkType(value: string): value is ClientConfig['network'] {\n  return ['mainnet', 'testnet', 'devnet', 'localnet'].includes(value);\n}\n\n/**\n * Helper function to validate client configuration\n * Throws descriptive errors for invalid configurations\n */\nexport function validateClientConfig(\n  config: Partial<ClientConfig>\n): asserts config is ClientConfig {\n  if (!config.network) {\n    throw new Error('ClientConfig validation failed: network is required');\n  }\n  if (!isNetworkType(config.network)) {\n    throw new Error(\n      `ClientConfig validation failed: invalid network type \"${config.network}\". ` +\n        'Must be one of: mainnet, testnet, devnet, localnet'\n    );\n  }\n  if (!config.packageId) {\n    throw new Error('ClientConfig validation failed: packageId is required');\n  }\n  if (typeof config.packageId !== 'string' || config.packageId.trim() === '') {\n    throw new Error('ClientConfig validation failed: packageId must be a non-empty string');\n  }\n  if (!config.metadata) {\n    throw new Error('ClientConfig validation failed: metadata is required');\n  }\n}\n\n/**\n * Create client with configuration validation\n * Useful when working with external configuration sources\n *\n * @example\n * ```typescript\n * const config = loadConfigFromFile(); // May be incomplete\n * const client = createClientWithValidation(config); // Throws if invalid\n * ```\n */\nexport function createClientWithValidation(config: Partial<ClientConfig>): DubheClientBundle {\n  validateClientConfig(config);\n  return createClient(config);\n}\n"]}

package/dist/sui/types.d.ts

@@ -0,0 +1,88 @@
+import type { SuiMoveNormalizedModules, Dubhe } from '@0xobelisk/sui-client';
+import type { DubheGraphqlClient } from '@0xobelisk/graphql-client';
+import type { DubheECSWorld } from '@0xobelisk/ecs';
+import type { DubheGrpcClient } from '@0xobelisk/grpc-client';
+/**
+ * Network type for Sui blockchain
+ */
+export type NetworkType = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
+/**
+ * Client configuration interface
+ * Aligned with @0xobelisk/react configuration for consistency
+ */
+export interface ClientConfig {
+    /** Network type */
+    network: NetworkType;
+    /** Contract package ID */
+    packageId: string;
+    /** Contract metadata (required for contract instantiation) */
+    metadata: any;
+    /** Dubhe Schema ID (optional, for enhanced features) */
+    dubheSchemaId?: string;
+    /** Dubhe metadata (enables GraphQL/ECS features) */
+    dubheMetadata?: any;
+    /** Authentication credentials */
+    credentials?: {
+        /** Private key (base64 or hex string) */
+        secretKey?: string;
+        /** Mnemonic phrase (12 or 24 words) */
+        mnemonics?: string;
+    };
+    /** Service endpoints configuration */
+    endpoints?: {
+        /** Full node RPC URLs (can provide multiple for redundancy) */
+        fullnodeUrls?: string[];
+        /** GraphQL endpoint URL */
+        graphql?: string;
+        /** WebSocket endpoint URL for subscriptions */
+        websocket?: string;
+        /** gRPC endpoint URL */
+        grpc?: string;
+    };
+    /** Performance and behavior options */
+    options?: {
+        /** Enable batch query optimization */
+        enableBatchOptimization?: boolean;
+        /** Default cache timeout (milliseconds) */
+        cacheTimeout?: number;
+        /** Request debounce delay (milliseconds) */
+        debounceMs?: number;
+        /** Auto-reconnect on WebSocket errors */
+        reconnectOnError?: boolean;
+    };
+}
+/**
+ * Type alias for consistency with @0xobelisk/react package
+ */
+export type DubheConfig = ClientConfig;
+/**
+ * Client bundle returned by createClient
+ * Contains all initialized client instances
+ */
+export interface DubheClientBundle {
+    /** Dubhe contract instance - core client for contract interactions */
+    contract: Dubhe;
+    /** GraphQL client for querying indexed data */
+    graphqlClient: DubheGraphqlClient;
+    /** gRPC client for high-performance queries */
+    grpcClient: DubheGrpcClient;
+    /** ECS World instance for entity-component-system queries */
+    ecsWorld: DubheECSWorld;
+    /** Contract metadata */
+    metadata: SuiMoveNormalizedModules;
+    /** Network type */
+    network: NetworkType;
+    /** Package ID */
+    packageId: string;
+    /** Dubhe Schema ID (if provided) */
+    dubheSchemaId?: string;
+    /** User address */
+    address: string;
+    /** Configuration options used */
+    options?: {
+        enableBatchOptimization?: boolean;
+        cacheTimeout?: number;
+        debounceMs?: number;
+        reconnectOnError?: boolean;
+    };
+}