@cfxdevkit/core 0.1.0

package/dist/types/index.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+__export(types_exports, {
+  NodeError: () => NodeError
+});
+module.exports = __toCommonJS(types_exports);
+
+// src/types/config.ts
+var NodeError = class extends Error {
+  code;
+  chain;
+  context;
+  constructor(message, code, chain, context) {
+    super(message);
+    this.name = "NodeError";
+    this.code = code;
+    this.chain = chain;
+    this.context = context;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NodeError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts","../../src/types/config.ts"],"sourcesContent":["/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Types Index - Export all type definitions\n\n// Re-export chain types from config\nexport type { SupportedChainId } from '../config/chains.js';\nexport * from './clients.js';\nexport * from './config.js';\n\n// Health status enum\nexport type HealthStatus = 'healthy' | 'unhealthy' | 'disconnected' | 'unknown';\n\n// Import client types\nimport type {\n  CoreClient,\n  CoreTestClient,\n  CoreWalletClient,\n} from '../clients/core.js';\nimport type {\n  EspaceClient,\n  EspaceTestClient,\n  EspaceWalletClient,\n} from '../clients/evm.js';\n\n// Combined client instance types\nexport interface CoreClientInstance {\n  publicClient: CoreClient;\n  walletClient?: CoreWalletClient;\n  testClient?: CoreTestClient;\n}\n\nexport interface EspaceClientInstance {\n  publicClient: EspaceClient;\n  walletClient?: EspaceWalletClient;\n  testClient?: EspaceTestClient;\n}\n\n// DevKit API Types\nexport interface StartOptions {\n  mining?: boolean;\n  waitForBlocks?: number;\n  fundingAmount?: string;\n}\n\nexport interface DeployOptions {\n  abi: unknown[];\n  bytecode: string;\n  args?: unknown[];\n  account: number;\n  chain?: 'core' | 'evm';\n  chains?: ('core' | 'evm')[];\n  value?: bigint;\n}\n\nexport interface ReadOptions {\n  address: string;\n  abi: unknown[];\n  functionName: string;\n  args?: unknown[];\n  chain: 'core' | 'evm';\n}\n\nexport interface WriteOptions {\n  address: string;\n  abi: unknown[];\n  functionName: string;\n  args?: unknown[];\n  account: number;\n  chain: 'core' | 'evm';\n  value?: bigint;\n  waitForConfirmation?: boolean;\n}\n\nexport interface ContractResult {\n  core?: string;\n  evm?: string;\n}\n\nexport interface ChainStatus {\n  core: { connected: boolean; status: string };\n  evm: { connected: boolean; status: string };\n}\n\nexport interface FaucetBalances {\n  coreBalance: string;\n  evmBalance: string;\n}\n\nexport interface MiningStatus {\n  isRunning: boolean;\n  interval: number;\n  blocksMined: number;\n  startTime?: Date;\n}\n\nexport interface ChainBalances {\n  core: string;\n  evm: string;\n}\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Core Configuration Types\n// Based on proven patterns from DevKit CLI and @xcfx/node\n\nexport interface NodeConfig {\n  // Chain Configuration\n  readonly chainId?: number; // Core space chain ID (default: 2029)\n  readonly evmChainId?: number; // EVM space chain ID (default: 2030)\n\n  // Network Ports\n  readonly jsonrpcHttpPort?: number; // Core HTTP RPC port (default: 12537)\n  readonly jsonrpcHttpEthPort?: number; // EVM HTTP RPC port (default: 8545)\n  readonly jsonrpcWsPort?: number; // Core WebSocket port (default: 12538)\n  readonly jsonrpcWsEthPort?: number; // EVM WebSocket port (default: 8546)\n\n  // // Development Settings\n  // readonly devBlockIntervalMs?: number; // Block generation interval (default: 1000)\n  // readonly devPackTxImmediately?: boolean; // Pack transactions immediately\n\n  // Data & Logging\n  readonly confluxDataDir?: string; // Data directory path\n  readonly log?: boolean; // Enable console logging\n  readonly logConf?: string; // Custom log configuration file\n\n  // Genesis Configuration\n  readonly genesisSecrets?: readonly string[]; // Core space genesis private keys\n  readonly genesisEvmSecrets?: readonly string[]; // EVM space genesis private keys\n  readonly miningAuthor?: string; // Mining rewards recipient\n\n  // Node Type\n  readonly nodeType?: 'full' | 'archive' | 'light';\n  readonly blockDbType?: 'rocksdb' | 'sqlite';\n}\n\nexport interface ExtendedNodeConfig extends NodeConfig {\n  // DevKit Extensions\n  readonly accountCount?: number; // Number of accounts to generate per chain\n  readonly silent?: boolean; // Suppress all logging\n  readonly fundAccounts?: boolean; // Auto-fund generated accounts\n  readonly enabledChains?: readonly ('core' | 'evm')[]; // Active chains\n\n  // Derivation paths for account generation\n  readonly derivationPaths?: {\n    readonly core: string; // Core derivation path template\n    readonly evm: string; // EVM derivation path template\n  };\n}\n\n// Address and Hash Types\nexport type Address = string;\nexport type CoreAddress = string; // cfx:... format\nexport type EvmAddress = string; // 0x... format\nexport type Hash = string;\nexport type ChainType = 'core' | 'evm';\n\n// Account Types\nexport interface UnifiedAccount {\n  readonly id: string; // Unique identifier\n  readonly name: string; // Human-readable name\n  readonly index: number; // Derivation index\n  readonly privateKey: string; // Private key (hex format)\n  readonly derivationPath: string; // BIP32 derivation path\n\n  // Chain-specific addresses (same private key, different formats)\n  readonly coreAddress: CoreAddress; // cfx:... format\n  readonly evmAddress: EvmAddress; // 0x... format\n\n  // Chain-specific state\n  readonly coreBalance: bigint;\n  readonly evmBalance: bigint;\n  readonly coreNonce: number;\n  readonly evmNonce: number;\n\n  // Metadata\n  readonly isActive: boolean;\n  readonly createdAt: Date;\n  readonly updatedAt: Date;\n}\n\n// Client Status Types\nexport interface ChainStatus {\n  readonly isRunning: boolean;\n  readonly chainId: number;\n  readonly blockNumber: bigint;\n  readonly gasPrice: bigint;\n  readonly peerCount: number;\n  readonly syncStatus: 'syncing' | 'synced';\n  readonly latestBlockHash: string;\n  readonly mining: boolean;\n  readonly pendingTransactions: number;\n  readonly rpcEndpoint: string;\n  readonly wsEndpoint?: string;\n}\n\nexport interface NodeStatus {\n  readonly isRunning: boolean;\n  readonly uptime: number;\n  readonly startTime: Date | null;\n  readonly core: ChainStatus;\n  readonly evm: ChainStatus;\n  readonly dataDir: string;\n  readonly config: NodeConfig;\n  readonly mining: MiningStatus;\n}\n\nexport interface MiningStatus {\n  readonly isRunning: boolean;\n  readonly interval: number;\n  readonly blocksMined: number;\n  readonly startTime: Date | null;\n  readonly lastBlockTime: Date | null;\n}\n\n// Transaction Types\nexport interface BaseTransaction {\n  readonly to?: string;\n  readonly value?: bigint;\n  readonly data?: string;\n  readonly gasLimit?: bigint;\n  readonly gasPrice?: bigint;\n  readonly nonce?: number;\n}\n\nexport interface TransactionReceipt {\n  readonly hash: string;\n  readonly blockNumber: bigint;\n  readonly blockHash: string;\n  readonly transactionIndex: number;\n  readonly status: 'success' | 'reverted';\n  readonly gasUsed: bigint;\n  readonly contractAddress?: string;\n  readonly logs: readonly Log[];\n}\n\nexport interface Log {\n  readonly address: string;\n  readonly topics: readonly string[];\n  readonly data: string;\n  readonly blockNumber: bigint;\n  readonly transactionHash: string;\n  readonly logIndex: number;\n}\n\n// Error Types\nexport interface ConfluxNodeError extends Error {\n  readonly code: string;\n  readonly chain?: ChainType;\n  readonly context?: Record<string, unknown>;\n}\n\nexport class NodeError extends Error implements ConfluxNodeError {\n  public readonly code: string;\n  public readonly chain?: ChainType;\n  public readonly context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    code: string,\n    chain?: ChainType,\n    context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'NodeError';\n    this.code = code;\n    this.chain = chain;\n    this.context = context;\n  }\n}\n\n// Event Types\nexport interface BlockEvent {\n  readonly chainType: ChainType;\n  readonly blockNumber: bigint;\n  readonly blockHash: string;\n  readonly timestamp: number;\n  readonly transactionCount: number;\n}\n\nexport interface TransactionEvent {\n  readonly chainType: ChainType;\n  readonly hash: string;\n  readonly from: string;\n  readonly to?: string;\n  readonly value: bigint;\n  readonly blockNumber: bigint;\n}\n\n// Utility Types\nexport type EventCallback<T> = (event: T) => void;\nexport type UnwatchFunction = () => void;\n\n// Server Management Types\nexport type ServerStatus =\n  | 'stopped'\n  | 'starting'\n  | 'running'\n  | 'stopping'\n  | 'error';\n\nexport interface ServerConfig {\n  readonly coreRpcPort?: number;\n  readonly evmRpcPort?: number;\n  readonly wsPort?: number;\n  readonly chainId?: number;\n  readonly evmChainId?: number;\n  readonly accounts?: number;\n  readonly balance?: string;\n  readonly mnemonic?: string;\n  readonly logging?: boolean;\n  readonly detached?: boolean;\n  readonly mining?: MiningConfig;\n  readonly devBlockIntervalMs?: number; // Auto block generation interval in ms (undefined = disabled)\n  readonly devPackTxImmediately?: boolean; // Pack transactions immediately for responsiveness\n  readonly dataDir?: string; // Data directory for Conflux node (default: /workspace/.conflux-dev)\n}\n\nexport interface MiningConfig {\n  readonly enabled: boolean;\n  readonly interval: number; // milliseconds between blocks\n  readonly autoStart: boolean; // start mining when server starts\n}\n\nexport interface AccountInfo {\n  readonly index: number;\n  readonly privateKey: string;\n  readonly coreAddress: string;\n  readonly evmAddress: string;\n  readonly mnemonic: string;\n  readonly path: string;\n  readonly evmPrivateKey?: string; // Ethereum-derived private key for EVM operations\n  readonly evmPath?: string; // Ethereum derivation path (m/44'/60'/0'/0/i)\n}\n\n// Additional types will be migrated from devkit-node as needed\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACqKO,IAAM,YAAN,cAAwB,MAAkC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YACE,SACA,MACA,OACA,SACA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,UAAU;AAAA,EACjB;AACF;","names":[]}

package/dist/types/index.d.cts

@@ -0,0 +1,5 @@
+export { SupportedChainId } from '../config/index.cjs';
+export { h as ChainBalances, i as ChainClient, j as ChainStatus, e as ClientConfig, k as ClientFactory, l as ClientManager, m as ContractResult, f as CoreClientInstance, D as DeployOptions, g as EspaceClientInstance, F as FaucetBalances, H as HealthStatus, M as MiningStatus, R as ReadOptions, S as StartOptions, T as TestClient, n as TestConfig, W as WalletClient, o as WalletConfig, p as WriteOptions } from '../core-RZA4aKwj.cjs';
+export { c as AccountInfo, A as Address, B as BaseTransaction, a as BlockEvent, C as ChainType, d as ConfluxNodeError, e as CoreAddress, E as EventCallback, f as EvmAddress, g as ExtendedNodeConfig, H as Hash, L as Log, M as MiningConfig, N as NodeConfig, h as NodeError, i as NodeStatus, S as ServerConfig, j as ServerStatus, b as TransactionEvent, T as TransactionReceipt, k as UnifiedAccount, U as UnwatchFunction } from '../config-BMtaWM0X.cjs';
+import 'cive';
+import 'viem';

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export { SupportedChainId } from '../config/index.js';
+export { h as ChainBalances, i as ChainClient, j as ChainStatus, e as ClientConfig, k as ClientFactory, l as ClientManager, m as ContractResult, f as CoreClientInstance, D as DeployOptions, g as EspaceClientInstance, F as FaucetBalances, H as HealthStatus, M as MiningStatus, R as ReadOptions, S as StartOptions, T as TestClient, n as TestConfig, W as WalletClient, o as WalletConfig, p as WriteOptions } from '../core-C5qe16RS.js';
+export { c as AccountInfo, A as Address, B as BaseTransaction, a as BlockEvent, C as ChainType, d as ConfluxNodeError, e as CoreAddress, E as EventCallback, f as EvmAddress, g as ExtendedNodeConfig, H as Hash, L as Log, M as MiningConfig, N as NodeConfig, h as NodeError, i as NodeStatus, S as ServerConfig, j as ServerStatus, b as TransactionEvent, T as TransactionReceipt, k as UnifiedAccount, U as UnwatchFunction } from '../config-BMtaWM0X.js';
+import 'cive';
+import 'viem';

package/dist/types/index.js

@@ -0,0 +1,17 @@
+// src/types/config.ts
+var NodeError = class extends Error {
+  code;
+  chain;
+  context;
+  constructor(message, code, chain, context) {
+    super(message);
+    this.name = "NodeError";
+    this.code = code;
+    this.chain = chain;
+    this.context = context;
+  }
+};
+export {
+  NodeError
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Core Configuration Types\n// Based on proven patterns from DevKit CLI and @xcfx/node\n\nexport interface NodeConfig {\n  // Chain Configuration\n  readonly chainId?: number; // Core space chain ID (default: 2029)\n  readonly evmChainId?: number; // EVM space chain ID (default: 2030)\n\n  // Network Ports\n  readonly jsonrpcHttpPort?: number; // Core HTTP RPC port (default: 12537)\n  readonly jsonrpcHttpEthPort?: number; // EVM HTTP RPC port (default: 8545)\n  readonly jsonrpcWsPort?: number; // Core WebSocket port (default: 12538)\n  readonly jsonrpcWsEthPort?: number; // EVM WebSocket port (default: 8546)\n\n  // // Development Settings\n  // readonly devBlockIntervalMs?: number; // Block generation interval (default: 1000)\n  // readonly devPackTxImmediately?: boolean; // Pack transactions immediately\n\n  // Data & Logging\n  readonly confluxDataDir?: string; // Data directory path\n  readonly log?: boolean; // Enable console logging\n  readonly logConf?: string; // Custom log configuration file\n\n  // Genesis Configuration\n  readonly genesisSecrets?: readonly string[]; // Core space genesis private keys\n  readonly genesisEvmSecrets?: readonly string[]; // EVM space genesis private keys\n  readonly miningAuthor?: string; // Mining rewards recipient\n\n  // Node Type\n  readonly nodeType?: 'full' | 'archive' | 'light';\n  readonly blockDbType?: 'rocksdb' | 'sqlite';\n}\n\nexport interface ExtendedNodeConfig extends NodeConfig {\n  // DevKit Extensions\n  readonly accountCount?: number; // Number of accounts to generate per chain\n  readonly silent?: boolean; // Suppress all logging\n  readonly fundAccounts?: boolean; // Auto-fund generated accounts\n  readonly enabledChains?: readonly ('core' | 'evm')[]; // Active chains\n\n  // Derivation paths for account generation\n  readonly derivationPaths?: {\n    readonly core: string; // Core derivation path template\n    readonly evm: string; // EVM derivation path template\n  };\n}\n\n// Address and Hash Types\nexport type Address = string;\nexport type CoreAddress = string; // cfx:... format\nexport type EvmAddress = string; // 0x... format\nexport type Hash = string;\nexport type ChainType = 'core' | 'evm';\n\n// Account Types\nexport interface UnifiedAccount {\n  readonly id: string; // Unique identifier\n  readonly name: string; // Human-readable name\n  readonly index: number; // Derivation index\n  readonly privateKey: string; // Private key (hex format)\n  readonly derivationPath: string; // BIP32 derivation path\n\n  // Chain-specific addresses (same private key, different formats)\n  readonly coreAddress: CoreAddress; // cfx:... format\n  readonly evmAddress: EvmAddress; // 0x... format\n\n  // Chain-specific state\n  readonly coreBalance: bigint;\n  readonly evmBalance: bigint;\n  readonly coreNonce: number;\n  readonly evmNonce: number;\n\n  // Metadata\n  readonly isActive: boolean;\n  readonly createdAt: Date;\n  readonly updatedAt: Date;\n}\n\n// Client Status Types\nexport interface ChainStatus {\n  readonly isRunning: boolean;\n  readonly chainId: number;\n  readonly blockNumber: bigint;\n  readonly gasPrice: bigint;\n  readonly peerCount: number;\n  readonly syncStatus: 'syncing' | 'synced';\n  readonly latestBlockHash: string;\n  readonly mining: boolean;\n  readonly pendingTransactions: number;\n  readonly rpcEndpoint: string;\n  readonly wsEndpoint?: string;\n}\n\nexport interface NodeStatus {\n  readonly isRunning: boolean;\n  readonly uptime: number;\n  readonly startTime: Date | null;\n  readonly core: ChainStatus;\n  readonly evm: ChainStatus;\n  readonly dataDir: string;\n  readonly config: NodeConfig;\n  readonly mining: MiningStatus;\n}\n\nexport interface MiningStatus {\n  readonly isRunning: boolean;\n  readonly interval: number;\n  readonly blocksMined: number;\n  readonly startTime: Date | null;\n  readonly lastBlockTime: Date | null;\n}\n\n// Transaction Types\nexport interface BaseTransaction {\n  readonly to?: string;\n  readonly value?: bigint;\n  readonly data?: string;\n  readonly gasLimit?: bigint;\n  readonly gasPrice?: bigint;\n  readonly nonce?: number;\n}\n\nexport interface TransactionReceipt {\n  readonly hash: string;\n  readonly blockNumber: bigint;\n  readonly blockHash: string;\n  readonly transactionIndex: number;\n  readonly status: 'success' | 'reverted';\n  readonly gasUsed: bigint;\n  readonly contractAddress?: string;\n  readonly logs: readonly Log[];\n}\n\nexport interface Log {\n  readonly address: string;\n  readonly topics: readonly string[];\n  readonly data: string;\n  readonly blockNumber: bigint;\n  readonly transactionHash: string;\n  readonly logIndex: number;\n}\n\n// Error Types\nexport interface ConfluxNodeError extends Error {\n  readonly code: string;\n  readonly chain?: ChainType;\n  readonly context?: Record<string, unknown>;\n}\n\nexport class NodeError extends Error implements ConfluxNodeError {\n  public readonly code: string;\n  public readonly chain?: ChainType;\n  public readonly context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    code: string,\n    chain?: ChainType,\n    context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'NodeError';\n    this.code = code;\n    this.chain = chain;\n    this.context = context;\n  }\n}\n\n// Event Types\nexport interface BlockEvent {\n  readonly chainType: ChainType;\n  readonly blockNumber: bigint;\n  readonly blockHash: string;\n  readonly timestamp: number;\n  readonly transactionCount: number;\n}\n\nexport interface TransactionEvent {\n  readonly chainType: ChainType;\n  readonly hash: string;\n  readonly from: string;\n  readonly to?: string;\n  readonly value: bigint;\n  readonly blockNumber: bigint;\n}\n\n// Utility Types\nexport type EventCallback<T> = (event: T) => void;\nexport type UnwatchFunction = () => void;\n\n// Server Management Types\nexport type ServerStatus =\n  | 'stopped'\n  | 'starting'\n  | 'running'\n  | 'stopping'\n  | 'error';\n\nexport interface ServerConfig {\n  readonly coreRpcPort?: number;\n  readonly evmRpcPort?: number;\n  readonly wsPort?: number;\n  readonly chainId?: number;\n  readonly evmChainId?: number;\n  readonly accounts?: number;\n  readonly balance?: string;\n  readonly mnemonic?: string;\n  readonly logging?: boolean;\n  readonly detached?: boolean;\n  readonly mining?: MiningConfig;\n  readonly devBlockIntervalMs?: number; // Auto block generation interval in ms (undefined = disabled)\n  readonly devPackTxImmediately?: boolean; // Pack transactions immediately for responsiveness\n  readonly dataDir?: string; // Data directory for Conflux node (default: /workspace/.conflux-dev)\n}\n\nexport interface MiningConfig {\n  readonly enabled: boolean;\n  readonly interval: number; // milliseconds between blocks\n  readonly autoStart: boolean; // start mining when server starts\n}\n\nexport interface AccountInfo {\n  readonly index: number;\n  readonly privateKey: string;\n  readonly coreAddress: string;\n  readonly evmAddress: string;\n  readonly mnemonic: string;\n  readonly path: string;\n  readonly evmPrivateKey?: string; // Ethereum-derived private key for EVM operations\n  readonly evmPath?: string; // Ethereum derivation path (m/44'/60'/0'/0/i)\n}\n\n// Additional types will be migrated from devkit-node as needed\n"],"mappings":";AAqKO,IAAM,YAAN,cAAwB,MAAkC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YACE,SACA,MACA,OACA,SACA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,UAAU;AAAA,EACjB;AACF;","names":[]}

package/dist/utils/index.cjs

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  logger: () => logger
+});
+module.exports = __toCommonJS(utils_exports);
+
+// src/utils/logger.ts
+var colors = {
+  info: "\x1B[36m",
+  // Cyan
+  warn: "\x1B[33m",
+  // Yellow
+  error: "\x1B[31m",
+  // Red
+  success: "\x1B[32m",
+  // Green
+  debug: "\x1B[90m",
+  // Gray
+  reset: "\x1B[0m"
+  // Reset
+};
+function formatMessage(level, message, ...args) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const formattedArgs = args.length > 0 ? ` ${args.map(
+    (arg) => arg !== null && typeof arg === "object" ? JSON.stringify(
+      arg,
+      (_key, value) => typeof value === "bigint" ? value.toString() : value,
+      2
+    ) : String(arg)
+  ).join(" ")}` : "";
+  return `[${timestamp}] ${level.toUpperCase()}: ${message}${formattedArgs}`;
+}
+function handleLog(level, color, fn, messageOrObj, maybeMsg, ...args) {
+  let msg = typeof messageOrObj === "string" ? messageOrObj : String(messageOrObj);
+  let objs = maybeMsg !== void 0 ? [maybeMsg, ...args] : args;
+  if (typeof messageOrObj === "object" && typeof maybeMsg === "string") {
+    msg = maybeMsg;
+    objs = [messageOrObj, ...args];
+  }
+  fn(color + formatMessage(level, msg, ...objs) + colors.reset);
+}
+var logger = {
+  info(m, m2, ...args) {
+    handleLog("info", colors.info, console.log, m, m2, ...args);
+  },
+  warn(m, m2, ...args) {
+    handleLog("warn", colors.warn, console.warn, m, m2, ...args);
+  },
+  error(m, m2, ...args) {
+    handleLog("error", colors.error, console.error, m, m2, ...args);
+  },
+  success(m, m2, ...args) {
+    handleLog("success", colors.success, console.log, m, m2, ...args);
+  },
+  debug(m, m2, ...args) {
+    handleLog("debug", colors.debug, console.log, m, m2, ...args);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  logger
+});
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/logger.ts"],"sourcesContent":["/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// @cfxdevkit/core - Utils module\n// Shared utilities: logger, formatting helpers\n\nexport { logger } from './logger.js';\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Simple logger utility\n */\n\nconst colors = {\n  info: '\\x1b[36m', // Cyan\n  warn: '\\x1b[33m', // Yellow\n  error: '\\x1b[31m', // Red\n  success: '\\x1b[32m', // Green\n  debug: '\\x1b[90m', // Gray\n  reset: '\\x1b[0m', // Reset\n};\n\n/** A structured log object or plain message string — mirrors the pino/winston dual-form API. */\ntype LogMessage = string | Record<string, unknown>;\n\nfunction formatMessage(\n  level: string,\n  message: string,\n  ...args: unknown[]\n): string {\n  const timestamp = new Date().toISOString();\n  const formattedArgs =\n    args.length > 0\n      ? ` ${args\n          .map((arg) =>\n            arg !== null && typeof arg === 'object'\n              ? JSON.stringify(\n                  arg,\n                  (_key, value) =>\n                    typeof value === 'bigint' ? value.toString() : value,\n                  2\n                )\n              : String(arg)\n          )\n          .join(' ')}`\n      : '';\n\n  return `[${timestamp}] ${level.toUpperCase()}: ${message}${formattedArgs}`;\n}\n\nfunction handleLog(\n  level: string,\n  color: string,\n  fn: (message: string) => void,\n  messageOrObj: LogMessage,\n  maybeMsg?: unknown,\n  ...args: unknown[]\n): void {\n  let msg =\n    typeof messageOrObj === 'string' ? messageOrObj : String(messageOrObj);\n  let objs: unknown[] = maybeMsg !== undefined ? [maybeMsg, ...args] : args;\n\n  if (typeof messageOrObj === 'object' && typeof maybeMsg === 'string') {\n    msg = maybeMsg;\n    objs = [messageOrObj, ...args];\n  }\n\n  fn(color + formatMessage(level, msg, ...objs) + colors.reset);\n}\n\nexport const logger = {\n  info(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('info', colors.info, console.log, m, m2, ...args);\n  },\n  warn(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('warn', colors.warn, console.warn, m, m2, ...args);\n  },\n  error(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('error', colors.error, console.error, m, m2, ...args);\n  },\n  success(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('success', colors.success, console.log, m, m2, ...args);\n  },\n  debug(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('debug', colors.debug, console.log, m, m2, ...args);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACoBA,IAAM,SAAS;AAAA,EACb,MAAM;AAAA;AAAA,EACN,MAAM;AAAA;AAAA,EACN,OAAO;AAAA;AAAA,EACP,SAAS;AAAA;AAAA,EACT,OAAO;AAAA;AAAA,EACP,OAAO;AAAA;AACT;AAKA,SAAS,cACP,OACA,YACG,MACK;AACR,QAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,QAAM,gBACJ,KAAK,SAAS,IACV,IAAI,KACD;AAAA,IAAI,CAAC,QACJ,QAAQ,QAAQ,OAAO,QAAQ,WAC3B,KAAK;AAAA,MACH;AAAA,MACA,CAAC,MAAM,UACL,OAAO,UAAU,WAAW,MAAM,SAAS,IAAI;AAAA,MACjD;AAAA,IACF,IACA,OAAO,GAAG;AAAA,EAChB,EACC,KAAK,GAAG,CAAC,KACZ;AAEN,SAAO,IAAI,SAAS,KAAK,MAAM,YAAY,CAAC,KAAK,OAAO,GAAG,aAAa;AAC1E;AAEA,SAAS,UACP,OACA,OACA,IACA,cACA,aACG,MACG;AACN,MAAI,MACF,OAAO,iBAAiB,WAAW,eAAe,OAAO,YAAY;AACvE,MAAI,OAAkB,aAAa,SAAY,CAAC,UAAU,GAAG,IAAI,IAAI;AAErE,MAAI,OAAO,iBAAiB,YAAY,OAAO,aAAa,UAAU;AACpE,UAAM;AACN,WAAO,CAAC,cAAc,GAAG,IAAI;AAAA,EAC/B;AAEA,KAAG,QAAQ,cAAc,OAAO,KAAK,GAAG,IAAI,IAAI,OAAO,KAAK;AAC9D;AAEO,IAAM,SAAS;AAAA,EACpB,KAAK,GAAe,OAAiB,MAAuB;AAC1D,cAAU,QAAQ,OAAO,MAAM,QAAQ,KAAK,GAAG,IAAI,GAAG,IAAI;AAAA,EAC5D;AAAA,EACA,KAAK,GAAe,OAAiB,MAAuB;AAC1D,cAAU,QAAQ,OAAO,MAAM,QAAQ,MAAM,GAAG,IAAI,GAAG,IAAI;AAAA,EAC7D;AAAA,EACA,MAAM,GAAe,OAAiB,MAAuB;AAC3D,cAAU,SAAS,OAAO,OAAO,QAAQ,OAAO,GAAG,IAAI,GAAG,IAAI;AAAA,EAChE;AAAA,EACA,QAAQ,GAAe,OAAiB,MAAuB;AAC7D,cAAU,WAAW,OAAO,SAAS,QAAQ,KAAK,GAAG,IAAI,GAAG,IAAI;AAAA,EAClE;AAAA,EACA,MAAM,GAAe,OAAiB,MAAuB;AAC3D,cAAU,SAAS,OAAO,OAAO,QAAQ,KAAK,GAAG,IAAI,GAAG,IAAI;AAAA,EAC9D;AACF;","names":[]}

package/dist/utils/index.d.cts

@@ -0,0 +1,11 @@
+/** A structured log object or plain message string — mirrors the pino/winston dual-form API. */
+type LogMessage = string | Record<string, unknown>;
+declare const logger: {
+    info(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    warn(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    error(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    success(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    debug(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+};
+
+export { logger };

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+/** A structured log object or plain message string — mirrors the pino/winston dual-form API. */
+type LogMessage = string | Record<string, unknown>;
+declare const logger: {
+    info(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    warn(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    error(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    success(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+    debug(m: LogMessage, m2?: unknown, ...args: unknown[]): void;
+};
+
+export { logger };

package/dist/utils/index.js

@@ -0,0 +1,56 @@
+// src/utils/logger.ts
+var colors = {
+  info: "\x1B[36m",
+  // Cyan
+  warn: "\x1B[33m",
+  // Yellow
+  error: "\x1B[31m",
+  // Red
+  success: "\x1B[32m",
+  // Green
+  debug: "\x1B[90m",
+  // Gray
+  reset: "\x1B[0m"
+  // Reset
+};
+function formatMessage(level, message, ...args) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const formattedArgs = args.length > 0 ? ` ${args.map(
+    (arg) => arg !== null && typeof arg === "object" ? JSON.stringify(
+      arg,
+      (_key, value) => typeof value === "bigint" ? value.toString() : value,
+      2
+    ) : String(arg)
+  ).join(" ")}` : "";
+  return `[${timestamp}] ${level.toUpperCase()}: ${message}${formattedArgs}`;
+}
+function handleLog(level, color, fn, messageOrObj, maybeMsg, ...args) {
+  let msg = typeof messageOrObj === "string" ? messageOrObj : String(messageOrObj);
+  let objs = maybeMsg !== void 0 ? [maybeMsg, ...args] : args;
+  if (typeof messageOrObj === "object" && typeof maybeMsg === "string") {
+    msg = maybeMsg;
+    objs = [messageOrObj, ...args];
+  }
+  fn(color + formatMessage(level, msg, ...objs) + colors.reset);
+}
+var logger = {
+  info(m, m2, ...args) {
+    handleLog("info", colors.info, console.log, m, m2, ...args);
+  },
+  warn(m, m2, ...args) {
+    handleLog("warn", colors.warn, console.warn, m, m2, ...args);
+  },
+  error(m, m2, ...args) {
+    handleLog("error", colors.error, console.error, m, m2, ...args);
+  },
+  success(m, m2, ...args) {
+    handleLog("success", colors.success, console.log, m, m2, ...args);
+  },
+  debug(m, m2, ...args) {
+    handleLog("debug", colors.debug, console.log, m, m2, ...args);
+  }
+};
+export {
+  logger
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logger.ts"],"sourcesContent":["/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Simple logger utility\n */\n\nconst colors = {\n  info: '\\x1b[36m', // Cyan\n  warn: '\\x1b[33m', // Yellow\n  error: '\\x1b[31m', // Red\n  success: '\\x1b[32m', // Green\n  debug: '\\x1b[90m', // Gray\n  reset: '\\x1b[0m', // Reset\n};\n\n/** A structured log object or plain message string — mirrors the pino/winston dual-form API. */\ntype LogMessage = string | Record<string, unknown>;\n\nfunction formatMessage(\n  level: string,\n  message: string,\n  ...args: unknown[]\n): string {\n  const timestamp = new Date().toISOString();\n  const formattedArgs =\n    args.length > 0\n      ? ` ${args\n          .map((arg) =>\n            arg !== null && typeof arg === 'object'\n              ? JSON.stringify(\n                  arg,\n                  (_key, value) =>\n                    typeof value === 'bigint' ? value.toString() : value,\n                  2\n                )\n              : String(arg)\n          )\n          .join(' ')}`\n      : '';\n\n  return `[${timestamp}] ${level.toUpperCase()}: ${message}${formattedArgs}`;\n}\n\nfunction handleLog(\n  level: string,\n  color: string,\n  fn: (message: string) => void,\n  messageOrObj: LogMessage,\n  maybeMsg?: unknown,\n  ...args: unknown[]\n): void {\n  let msg =\n    typeof messageOrObj === 'string' ? messageOrObj : String(messageOrObj);\n  let objs: unknown[] = maybeMsg !== undefined ? [maybeMsg, ...args] : args;\n\n  if (typeof messageOrObj === 'object' && typeof maybeMsg === 'string') {\n    msg = maybeMsg;\n    objs = [messageOrObj, ...args];\n  }\n\n  fn(color + formatMessage(level, msg, ...objs) + colors.reset);\n}\n\nexport const logger = {\n  info(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('info', colors.info, console.log, m, m2, ...args);\n  },\n  warn(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('warn', colors.warn, console.warn, m, m2, ...args);\n  },\n  error(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('error', colors.error, console.error, m, m2, ...args);\n  },\n  success(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('success', colors.success, console.log, m, m2, ...args);\n  },\n  debug(m: LogMessage, m2?: unknown, ...args: unknown[]): void {\n    handleLog('debug', colors.debug, console.log, m, m2, ...args);\n  },\n};\n"],"mappings":";AAoBA,IAAM,SAAS;AAAA,EACb,MAAM;AAAA;AAAA,EACN,MAAM;AAAA;AAAA,EACN,OAAO;AAAA;AAAA,EACP,SAAS;AAAA;AAAA,EACT,OAAO;AAAA;AAAA,EACP,OAAO;AAAA;AACT;AAKA,SAAS,cACP,OACA,YACG,MACK;AACR,QAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,QAAM,gBACJ,KAAK,SAAS,IACV,IAAI,KACD;AAAA,IAAI,CAAC,QACJ,QAAQ,QAAQ,OAAO,QAAQ,WAC3B,KAAK;AAAA,MACH;AAAA,MACA,CAAC,MAAM,UACL,OAAO,UAAU,WAAW,MAAM,SAAS,IAAI;AAAA,MACjD;AAAA,IACF,IACA,OAAO,GAAG;AAAA,EAChB,EACC,KAAK,GAAG,CAAC,KACZ;AAEN,SAAO,IAAI,SAAS,KAAK,MAAM,YAAY,CAAC,KAAK,OAAO,GAAG,aAAa;AAC1E;AAEA,SAAS,UACP,OACA,OACA,IACA,cACA,aACG,MACG;AACN,MAAI,MACF,OAAO,iBAAiB,WAAW,eAAe,OAAO,YAAY;AACvE,MAAI,OAAkB,aAAa,SAAY,CAAC,UAAU,GAAG,IAAI,IAAI;AAErE,MAAI,OAAO,iBAAiB,YAAY,OAAO,aAAa,UAAU;AACpE,UAAM;AACN,WAAO,CAAC,cAAc,GAAG,IAAI;AAAA,EAC/B;AAEA,KAAG,QAAQ,cAAc,OAAO,KAAK,GAAG,IAAI,IAAI,OAAO,KAAK;AAC9D;AAEO,IAAM,SAAS;AAAA,EACpB,KAAK,GAAe,OAAiB,MAAuB;AAC1D,cAAU,QAAQ,OAAO,MAAM,QAAQ,KAAK,GAAG,IAAI,GAAG,IAAI;AAAA,EAC5D;AAAA,EACA,KAAK,GAAe,OAAiB,MAAuB;AAC1D,cAAU,QAAQ,OAAO,MAAM,QAAQ,MAAM,GAAG,IAAI,GAAG,IAAI;AAAA,EAC7D;AAAA,EACA,MAAM,GAAe,OAAiB,MAAuB;AAC3D,cAAU,SAAS,OAAO,OAAO,QAAQ,OAAO,GAAG,IAAI,GAAG,IAAI;AAAA,EAChE;AAAA,EACA,QAAQ,GAAe,OAAiB,MAAuB;AAC7D,cAAU,WAAW,OAAO,SAAS,QAAQ,KAAK,GAAG,IAAI,GAAG,IAAI;AAAA,EAClE;AAAA,EACA,MAAM,GAAe,OAAiB,MAAuB;AAC3D,cAAU,SAAS,OAAO,OAAO,QAAQ,KAAK,GAAG,IAAI,GAAG,IAAI;AAAA,EAC9D;AACF;","names":[]}