@xyo-network/xl1-cli-lib 1.20.14 → 1.20.16

package/src/configMiddleware.ts

@@ -1,55 +0,0 @@
-import { createDeepMerge } from '@xylabs/sdk-js'
-import { tryParseConfig } from '@xyo-network/chain-orchestration'
-import type { Config } from '@xyo-network/xl1-sdk'
-import {
-  ConfigZod, isZodError, resolveConfig,
-} from '@xyo-network/xl1-sdk'
-
-const deepMerge = createDeepMerge({ arrayStrategy: 'concat' })
-
-export async function configMiddleware(argv: Record<string, unknown>, setConfiguration: (config: Config) => void): Promise<void> {
-  try {
-    // Parse the various config sources
-    const configPath = argv.config as string | undefined
-    const parsedConfigFile = await tryParseConfig({ configPath }) // Config file
-    const parsedConfigArgs = ConfigZod.safeParse(argv).data ?? {} // Command-line arguments & ENV VARs
-    const parseResult = ConfigZod.safeParse(deepMerge(parsedConfigFile, parsedConfigArgs))
-    if (!parseResult.success) {
-      throw parseResult.error
-    }
-    // Deep merge with precedence
-    // TODO: Would like precedence to be defaults < file < ENV < CLI Args
-    // but there is currently no way to determine which are defaults vs
-    // user-supplied CLI Args since we set the CLI args to the defaults
-    // and receive a flattened object. We might need to manually invoke
-    // the parser without the defaults to achieve this.
-    // const mergedConfig = deepMerge(parsedConfigArgs, parsedConfigFile)
-    const mergedConfig = parseResult.data
-    const validatedMergedConfigResult = ConfigZod.safeParse(mergedConfig)
-    if (!validatedMergedConfigResult.success) {
-      throw validatedMergedConfigResult.error
-    }
-    const resolvedConfig = resolveConfig(validatedMergedConfigResult.data)
-    // Validate the merged configuration
-    const validatedConfigResult = ConfigZod.safeParse(resolvedConfig)
-    if (!validatedConfigResult.success) {
-      throw validatedConfigResult.error
-    }
-    setConfiguration(validatedConfigResult.data)
-
-    // Check if user wants to dump config and exit
-    if (argv['dump-config']) {
-      console.log(JSON.stringify(validatedConfigResult.data, null, 2))
-      // eslint-disable-next-line unicorn/no-process-exit
-      process.exit(0)
-    }
-  } catch (err) {
-    if (isZodError(err)) {
-      console.error(`Zod error: ${err.message}`)
-    } else {
-      console.error(`Error parsing configuration: ${err}`)
-    }
-    console.error(`Stack: ${err instanceof Error ? err.stack : 'N/A'}`)
-    throw new Error('Invalid configuration')
-  }
-}

package/src/images.ts

@@ -1,19 +0,0 @@
-/* eslint-disable @stylistic/max-len */
-export const XL1LogoColorizedAscii = `                    _
-                   ╠╠
-                   ╠╠_
-        ╦╦_       [╠╠▒       _╔╦
-        ²╠▒D╦_    ╠╠╠╠    _╔R▒▒╙
-          ╚▒▒▒D╦ j╠╠╠╠H ╔D▒▒▒╠
-           ²▒▒▒▒ ╠╠╠╠╠╠ ╠▒▒▒╙
-             \`_,╓╠╠╠╠╠╠╓_\`\`
- _,╓╓╔╗φ@D▒╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠▒▒Kφ╗╦╖²__
- \`^╙╙╚╝╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╠╝╩╜╙^\`
-             \`'"╙╠╠╠╠╠╠╜^^\`\`
-           ,╠▒▒╠ ╠╠╠╠╠╠ å╠╠╠,
-          ╔▒▒▒▒╩ [╠╠╠╠H ╚╠╠╠╠H
-        ,╠▒▒╩^    ╠╠╠╠    '╚╠╠╠,
-        ╩╩^       ╚╠╠╠       '╚╩
-                  '╠╠H
-                   ╠╠
-                   ²^`

package/src/index.ts

@@ -1,4 +0,0 @@
-export * from './configMiddleware.ts'
-export * from './initLogger.ts'
-export * from './runCLI.ts'
-export * from './start.ts'

package/src/initLogger.ts

@@ -1,23 +0,0 @@
-import type { Logger, LogLevelValue } from '@xylabs/sdk-js'
-import {
-  Base,
-  ConsoleLogger, isDefined,
-  LogLevel, SilentLogger,
-} from '@xylabs/sdk-js'
-import type { BaseConfig } from '@xyo-network/xl1-sdk'
-
-export const initLogger = (config: BaseConfig): Logger => {
-  let logger: Logger
-  if (config.log.silent) {
-    logger = new SilentLogger()
-  } else {
-    let level: LogLevelValue | undefined
-    if (isDefined(config.log.logLevel)) {
-      const parsed = LogLevel[config.log.logLevel.toLowerCase() as keyof typeof LogLevel]
-      if (isDefined(parsed)) level = parsed
-    }
-    logger = new ConsoleLogger(level)
-  }
-  Base.defaultLogger = logger
-  return logger
-}

package/src/optionsFromGlobalZodRegistry.ts

@@ -1,19 +0,0 @@
-import type { UsageMeta } from '@xyo-network/xl1-sdk'
-import { isUsageMeta } from '@xyo-network/xl1-sdk'
-import type { Options } from 'yargs'
-import { globalRegistry } from 'zod'
-
-const usageMetaToOptions = (meta: UsageMeta): Options => {
-  return meta
-}
-
-export const optionsFromGlobalZodRegistry = (): Record<string, Options> => {
-  const opts: Record<string, Options> = {}
-  for (const schema of Object.values(globalRegistry._map)) {
-    if (isUsageMeta(schema)) {
-      if (schema.hidden) continue // skip hidden options
-      opts[schema.title] = usageMetaToOptions(schema)
-    }
-  }
-  return opts
-}

package/src/runCLI.ts

@@ -1,126 +0,0 @@
-import { isDefined } from '@xylabs/sdk-js'
-import {
-  contextFromConfigWithoutLocator, locatorsFromConfig, Orchestrator,
-} from '@xyo-network/chain-orchestration'
-import type { ActorConfig, Config } from '@xyo-network/xl1-sdk'
-import { ActorConfigZod, ConfigZod } from '@xyo-network/xl1-sdk'
-import type { Argv } from 'yargs'
-import yargs from 'yargs'
-import { hideBin } from 'yargs/helpers'
-
-import {
-  apiCommand,
-  bridgeCommand,
-  mempoolCommand,
-  producerCommand,
-  rewardRedemptionCommand,
-  startCommand,
-  withDeprecationWarning,
-} from './commands/index.ts'
-import { configMiddleware } from './configMiddleware.ts'
-import { XL1LogoColorizedAscii } from './images.ts'
-import { initLogger } from './initLogger.ts'
-import { optionsFromGlobalZodRegistry } from './optionsFromGlobalZodRegistry.ts'
-
-/** Version string injected by Rollup at build time. */
-declare const __VERSION__: string
-
-/**
- * The configuration that will be used throughout the CLI.
- * This is materialized after parsing the command-line arguments,
- * environment variables, and defaults.
- */
-let configuration: Config
-
-const version = isDefined(__VERSION__) ? __VERSION__ : 'unknown'
-
-function getConfiguration(): Config {
-  return configuration
-}
-
-async function getLocatorsFromConfig(actors: string[], configuration: Config) {
-  const actorConfigs: ActorConfig[] = []
-  for (const actorName of actors) {
-    const existingConfig = configuration.actors.find(actor => actor.name === actorName)
-    if (existingConfig) {
-      actorConfigs.push(existingConfig)
-    } else {
-      const actorConfig = ActorConfigZod.loose().parse({ name: actorName })
-      actorConfigs.push(actorConfig)
-    }
-  }
-
-  const config = ConfigZod.parse({ ...configuration, actors: actorConfigs })
-
-  const logger = initLogger(configuration)
-  const orchestrator = await Orchestrator.create({ logger })
-  const context = await contextFromConfigWithoutLocator(config, logger, 'xl1-cli', version)
-  const locators = await locatorsFromConfig(context, config)
-  // Handle cancellation (Ctrl+C)
-  process.on('SIGINT', () => {
-    void (async () => {
-      try {
-        logger.log('\nSIGINT received. Attempting graceful shutdown...')
-        await orchestrator?.stop()
-        logger.log('Orchestrator stopped, exiting now.')
-        process.exit(0)
-      } catch (err) {
-        logger.error('Error stopping orchestrator:', err)
-        process.exit(1)
-      }
-    })()
-  })
-  return { locators, orchestrator }
-}
-
-// Main entry point
-export async function runCLI() {
-  // Parse command-line arguments using Yargs
-  const y = yargs(hideBin(process.argv)) as Argv<Config>
-  const argv = y
-    .usage(`
-🚀 XL1 Node CLI (${version})
-${XL1LogoColorizedAscii}
-Run various components of the XL1 ecosystem.
-
-Usage:
-$0 <command> [options]`)
-    .parserConfiguration({
-      'dot-notation': true, // foo.bar → { foo: { bar } }
-      'parse-numbers': false, // Don't auto-parse numbers to allow strings like "0x1"
-      'populate--': true, // Populate -- with all options so we can detected user-supplied vs defaults
-    })
-    .env('XL1')
-    .scriptName('xl1')
-    .middleware(async (argv) => {
-      await configMiddleware(argv, (config) => {
-        configuration = config
-      })
-    })
-    .options(optionsFromGlobalZodRegistry())
-    .wrap(y.terminalWidth())
-    .command(withDeprecationWarning(apiCommand(getConfiguration, getLocatorsFromConfig)))
-    .command(withDeprecationWarning(bridgeCommand(getConfiguration, getLocatorsFromConfig)))
-    .command(withDeprecationWarning(mempoolCommand(getConfiguration, getLocatorsFromConfig)))
-    .command(withDeprecationWarning(producerCommand(getConfiguration, getLocatorsFromConfig)))
-    .command(withDeprecationWarning(rewardRedemptionCommand(getConfiguration, getLocatorsFromConfig)))
-    .command(startCommand(getConfiguration, getLocatorsFromConfig))
-    .options({
-      'config': {
-        type: 'string',
-        description: 'Path to a config file to use instead of the default search.',
-        alias: 'c',
-      },
-      'dump-config': {
-        type: 'boolean',
-        description: 'Just process the configuration and print the resolved config to stdout, then exit.',
-        default: false,
-      },
-    })
-    .help()
-    .alias('help', 'h')
-    .version(version)
-    .argv
-
-  await argv
-}

package/src/start.ts

@@ -1,8 +0,0 @@
-import { config } from 'dotenv'
-
-import { runCLI } from './runCLI.ts'
-
-export const start = async () => {
-  config({ quiet: true })
-  await runCLI()
-}

package/src/waitForHostPort.ts

@@ -1,26 +0,0 @@
-import net from 'node:net'
-
-export const waitForHostPort = (host: string, port: number): Promise<void> => {
-  return new Promise((resolve) => {
-    const tryConnect = () => {
-      const socket = new net.Socket()
-
-      socket
-        .setTimeout(1000)
-        .once('error', () => {
-          socket.destroy()
-          setTimeout(tryConnect, 500) // retry after 500ms
-        })
-        .once('timeout', () => {
-          socket.destroy()
-          setTimeout(tryConnect, 500)
-        })
-        .connect(port, host, () => {
-          socket.end()
-          resolve()
-        })
-    }
-
-    tryConnect()
-  })
-}

package/src/xl1.ts

@@ -1,8 +0,0 @@
-import { start } from './start.ts'
-
-start().catch((err) => {
-  // If we're in development mode, log the stack trace to the console
-  if (process.env.NODE_ENV === 'development') console.error('An error occurred during startup:', err)
-  // eslint-disable-next-line unicorn/no-process-exit
-  process.exit(1)
-})