@event-driven-io/emmett 0.43.0-beta.14 → 0.43.0-beta.16

package/dist/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.cjs","names":["CliCommand","EmmettError","isPluginConfig","Command"],"sources":["../src/commandLine/config.ts","../src/commandLine/plugins.ts","../src/cli.ts"],"sourcesContent":["import { Command as CliCommand } from 'commander';\n// eslint-disable-next-line no-restricted-imports\nimport { writeFileSync } from 'node:fs';\nimport { exit } from 'process';\n\nexport const sampleConfig = (plugins: string[] = ['emmett-expressjs']) => {\n  const pluginsNames =\n    plugins.length > 0\n      ? `[\\n${plugins.map((p) => `\"${p}\"`).join(',\\n')}  \\n]`\n      : '[]';\n\n  return `\nexport default {\n  plugins: ${pluginsNames},\n};\n`;\n};\n\nexport const generateConfigFile = (\n  configPath: string,\n  collectionNames: string[],\n): void => {\n  try {\n    writeFileSync(configPath, sampleConfig(collectionNames), 'utf8');\n    console.log(`Configuration file stored at: ${configPath}`);\n  } catch (error) {\n    console.error(`Error: Couldn't store config file: ${configPath}!`);\n    console.error(error);\n    process.exit(1);\n  }\n};\n\nexport const configCommand = new CliCommand('config').description(\n  'Manage Pongo configuration',\n);\n\ntype SampleConfigOptions =\n  | {\n      plugin: string[];\n      print?: boolean;\n    }\n  | {\n      plugin: string[];\n      generate?: boolean;\n      file?: string;\n    };\n\nconfigCommand\n  .command('sample')\n  .description('Generate or print sample configuration')\n  .option(\n    '-plg, --plugins <name>',\n    'Specify the plugin name',\n    (value: string, previous: string[]) => {\n      // Accumulate plugins names into an array (explicitly typing `previous` as `string[]`)\n      return previous.concat([value]);\n    },\n    [] as string[],\n  )\n  .option(\n    '-f, --file <path>',\n    'Path to configuration file with collection list',\n  )\n  .option('-g, --generate', 'Generate sample config file')\n  .option('-p, --print', 'Print sample config file')\n  .action((options: SampleConfigOptions) => {\n    const plugins =\n      options.plugin.length > 0\n        ? options.plugin\n        : ['@event-driven-io/emmett-expressjs'];\n\n    if (!('print' in options) && !('generate' in options)) {\n      console.error(\n        'Error: Please provide either:\\n--print param to print sample config or\\n--generate to generate sample config file',\n      );\n      exit(1);\n    }\n\n    if ('print' in options) {\n      console.log(`${sampleConfig(plugins)}`);\n    } else if ('generate' in options) {\n      if (!options.file) {\n        console.error(\n          'Error: You need to provide a config file through a --file',\n        );\n        exit(1);\n      }\n\n      generateConfigFile(options.file, plugins);\n    }\n  });\n","import type { Command as CliCommand } from 'commander';\nimport path from 'path';\nimport {\n  isPluginConfig,\n  type EmmettCliCommand,\n  type EmmettCliPlugin,\n  type EmmettPlugin,\n  type EmmettPluginConfig,\n  type EmmettPluginsConfig,\n  type EmmettPluginType,\n} from '../config';\nimport { EmmettError } from '../errors';\nimport { sampleConfig } from './config';\n\nconst PluginsConfigImportError = {\n  missingDefaultExport: `Error: Config should contain default export, e.g.\\n\\n${sampleConfig()}`,\n  missingPluginsPropertyExport: `Error: Config should contain default export with plugins array, e.g.\\n\\n${sampleConfig()}`,\n  wrongPluginStructure: `Error: Plugin config should be either string with plugin name or object with plugin name, e.g. { name: 'emmett-expressjs' }`,\n};\nexport const importPluginsConfig = async (options?: {\n  configPath?: string | undefined;\n}): Promise<EmmettPluginsConfig | EmmettError> => {\n  const configPath = path.join(\n    process.cwd(),\n    options?.configPath ?? './dist/emmett.config.js',\n  );\n\n  console.log('IMPORTING' + configPath);\n\n  try {\n    const imported = (await import(configPath)) as {\n      default: Partial<EmmettPluginsConfig>;\n    };\n\n    if (!imported.default) {\n      return new EmmettError(PluginsConfigImportError.missingDefaultExport);\n    }\n\n    if (!imported.default.plugins || !Array.isArray(imported.default.plugins)) {\n      return new EmmettError(\n        PluginsConfigImportError.missingPluginsPropertyExport,\n      );\n    }\n\n    if (!imported.default.plugins.every(isPluginConfig)) {\n      return new EmmettError(PluginsConfigImportError.wrongPluginStructure);\n    }\n\n    return { plugins: imported.default.plugins };\n  } catch (error) {\n    if (!options?.configPath) {\n      console.warn('Didn`t find config file: ' + configPath, error);\n      return { plugins: [] };\n    }\n    return new EmmettError(\n      `Error: Couldn't load file:` + (error as Error).toString(),\n    );\n  }\n};\n\nexport const loadPlugins = async (options?: {\n  pluginType?: EmmettPluginType;\n  configPath?: string;\n}): Promise<EmmettPlugin[]> => {\n  try {\n    const pluginsConfig = await importPluginsConfig({\n      configPath: options?.configPath,\n    });\n\n    if (pluginsConfig instanceof EmmettError) throw pluginsConfig;\n\n    if (pluginsConfig.plugins.length === 0) {\n      console.log(`No extensions specified in config ${options?.configPath}.`);\n      return [];\n    }\n\n    const pluginsToLoad = filterPluginsByType(\n      pluginsConfig.plugins,\n      options?.pluginType,\n    );\n\n    const pluginsPromises = pluginsToLoad.map(async (pluginConfig) => {\n      const importPath = getImportPath(pluginConfig, options?.pluginType);\n      try {\n        const plugin = (await import(importPath)) as { default: EmmettPlugin };\n\n        console.info(`Loaded plugin: ${importPath}`);\n\n        if (!plugin.default) {\n          throw new Error(`Plugin: ${importPath} is missing default export`);\n        }\n\n        return plugin.default;\n      } catch (error) {\n        console.error(`Failed to load extension \"${importPath}\":`, error);\n        return undefined;\n      }\n    });\n\n    return (await Promise.all(pluginsPromises)).filter(\n      (plugin) => plugin !== undefined,\n    );\n  } catch (error) {\n    console.error(`Failed to load config ${options?.configPath}:`, error);\n    return [];\n  }\n};\n\nexport const registerCliPlugins = async (\n  program: CliCommand,\n  plugins: EmmettCliPlugin[],\n): Promise<void> => {\n  const result: EmmettCliPlugin[] = [];\n\n  for (const plugin of plugins) {\n    const pluginName = plugin.name;\n\n    if (!('registerCommands' in plugin)) {\n      console.warn(`No registerCommands function found in ${pluginName}`);\n    }\n    await plugin.registerCommands(program as EmmettCliCommand);\n    console.log(`Loaded extension: ${plugin.name}`);\n    result.push(plugin);\n  }\n};\n\nconst filterPluginsByType = (\n  plugins: EmmettPluginConfig[],\n  pluginType?: EmmettPluginType,\n): EmmettPluginConfig[] =>\n  plugins.filter(\n    (p) =>\n      typeof p === 'string' ||\n      (pluginType &&\n        (p.register === undefined ||\n          p.register.some((r) => r.pluginType === pluginType))),\n  );\n\nconst getImportPath = (\n  pluginConfig: EmmettPluginConfig,\n  pluginType: EmmettPluginType | undefined,\n) => {\n  if (typeof pluginConfig === 'string') {\n    return pluginType ? `${pluginConfig}/${pluginType}` : pluginConfig;\n  }\n\n  const pluginSubpath =\n    pluginConfig.register.find((r) => pluginType && r.pluginType === pluginType)\n      ?.path ?? pluginType;\n\n  return pluginSubpath\n    ? `${pluginConfig.name}/${pluginSubpath}`\n    : pluginConfig.name;\n};\n","#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { loadPlugins, registerCliPlugins } from './commandLine';\n\nconst program = new Command();\n\nprogram\n  .name('emmett')\n  .description('CLI tool for Emmett')\n  .option('--config <path>', 'Path to the configuration file');\n\n// Load extensions and parse CLI arguments\nconst initCLI = async () => {\n  const configIndex = process.argv.indexOf('--config');\n\n  const configPath =\n    configIndex !== -1 && process.argv.length > configIndex + 1\n      ? process.argv[configIndex + 1]\n      : undefined;\n\n  try {\n    const plugins = await loadPlugins({\n      pluginType: 'cli',\n      configPath: configPath,\n    });\n    await registerCliPlugins(program, plugins);\n\n    // Parse the CLI arguments\n    program.parse(process.argv);\n  } catch (err) {\n    console.error(`Failed to load config from ${configPath}:`, err);\n  }\n};\n\n//Initialize CLI and handle errors\ninitCLI().catch((err) => {\n  console.error(`CLI initialization failed:`);\n  console.error(err);\n});\n\nexport default program;\nexport * from './commandLine';\n"],"mappings":"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"}
+{"version":3,"file":"cli.cjs","names":["CliCommand","EmmettError","isPluginConfig","Command"],"sources":["../src/commandLine/config.ts","../src/commandLine/plugins.ts","../src/cli.ts"],"sourcesContent":["import { Command as CliCommand } from 'commander';\n// eslint-disable-next-line no-restricted-imports\nimport { writeFileSync } from 'node:fs';\nimport { exit } from 'process';\n\nexport const sampleConfig = (plugins: string[] = ['emmett-expressjs']) => {\n  const pluginsNames =\n    plugins.length > 0\n      ? `[\\n${plugins.map((p) => `\"${p}\"`).join(',\\n')}  \\n]`\n      : '[]';\n\n  return `\nexport default {\n  plugins: ${pluginsNames},\n};\n`;\n};\n\nexport const generateConfigFile = (\n  configPath: string,\n  collectionNames: string[],\n): void => {\n  try {\n    writeFileSync(configPath, sampleConfig(collectionNames), 'utf8');\n    console.log(`Configuration file stored at: ${configPath}`);\n  } catch (error) {\n    console.error(`Error: Couldn't store config file: ${configPath}!`);\n    console.error(error);\n    process.exit(1);\n  }\n};\n\nexport const configCommand = new CliCommand('config').description(\n  'Manage Pongo configuration',\n);\n\ntype SampleConfigOptions =\n  | {\n      plugin: string[];\n      print?: boolean;\n    }\n  | {\n      plugin: string[];\n      generate?: boolean;\n      file?: string;\n    };\n\nconfigCommand\n  .command('sample')\n  .description('Generate or print sample configuration')\n  .option(\n    '-plg, --plugins <name>',\n    'Specify the plugin name',\n    (value: string, previous: string[]) => {\n      // Accumulate plugins names into an array (explicitly typing `previous` as `string[]`)\n      return previous.concat([value]);\n    },\n    [] as string[],\n  )\n  .option(\n    '-f, --file <path>',\n    'Path to configuration file with collection list',\n  )\n  .option('-g, --generate', 'Generate sample config file')\n  .option('-p, --print', 'Print sample config file')\n  .action((options: SampleConfigOptions) => {\n    const plugins =\n      options.plugin.length > 0\n        ? options.plugin\n        : ['@event-driven-io/emmett-expressjs'];\n\n    if (!('print' in options) && !('generate' in options)) {\n      console.error(\n        'Error: Please provide either:\\n--print param to print sample config or\\n--generate to generate sample config file',\n      );\n      exit(1);\n    }\n\n    if ('print' in options) {\n      console.log(`${sampleConfig(plugins)}`);\n    } else if ('generate' in options) {\n      if (!options.file) {\n        console.error(\n          'Error: You need to provide a config file through a --file',\n        );\n        exit(1);\n      }\n\n      generateConfigFile(options.file, plugins);\n    }\n  });\n","import type { Command as CliCommand } from 'commander';\nimport path from 'path';\nimport {\n  isPluginConfig,\n  type EmmettCliCommand,\n  type EmmettCliPlugin,\n  type EmmettPlugin,\n  type EmmettPluginConfig,\n  type EmmettPluginsConfig,\n  type EmmettPluginType,\n} from '../config';\nimport { EmmettError } from '../errors';\nimport { sampleConfig } from './config';\n\nconst PluginsConfigImportError = {\n  missingDefaultExport: `Error: Config should contain default export, e.g.\\n\\n${sampleConfig()}`,\n  missingPluginsPropertyExport: `Error: Config should contain default export with plugins array, e.g.\\n\\n${sampleConfig()}`,\n  wrongPluginStructure: `Error: Plugin config should be either string with plugin name or object with plugin name, e.g. { name: 'emmett-expressjs' }`,\n};\nexport const importPluginsConfig = async (options?: {\n  configPath?: string | undefined;\n}): Promise<EmmettPluginsConfig | EmmettError> => {\n  const configPath = path.join(\n    process.cwd(),\n    options?.configPath ?? './dist/emmett.config.js',\n  );\n\n  console.log('IMPORTING' + configPath);\n\n  try {\n    const imported = (await import(configPath)) as {\n      default: Partial<EmmettPluginsConfig>;\n    };\n\n    if (!imported.default) {\n      return new EmmettError(PluginsConfigImportError.missingDefaultExport);\n    }\n\n    if (!imported.default.plugins || !Array.isArray(imported.default.plugins)) {\n      return new EmmettError(\n        PluginsConfigImportError.missingPluginsPropertyExport,\n      );\n    }\n\n    if (!imported.default.plugins.every(isPluginConfig)) {\n      return new EmmettError(PluginsConfigImportError.wrongPluginStructure);\n    }\n\n    return { plugins: imported.default.plugins };\n  } catch (error) {\n    if (!options?.configPath) {\n      console.warn('Didn`t find config file: ' + configPath, error);\n      return { plugins: [] };\n    }\n    return new EmmettError(\n      `Error: Couldn't load file:` + (error as Error).toString(),\n    );\n  }\n};\n\nexport const loadPlugins = async (options?: {\n  pluginType?: EmmettPluginType;\n  configPath?: string;\n}): Promise<EmmettPlugin[]> => {\n  try {\n    const pluginsConfig = await importPluginsConfig({\n      configPath: options?.configPath,\n    });\n\n    if (pluginsConfig instanceof EmmettError) throw pluginsConfig;\n\n    if (pluginsConfig.plugins.length === 0) {\n      console.log(`No extensions specified in config ${options?.configPath}.`);\n      return [];\n    }\n\n    const pluginsToLoad = filterPluginsByType(\n      pluginsConfig.plugins,\n      options?.pluginType,\n    );\n\n    const pluginsPromises = pluginsToLoad.map(async (pluginConfig) => {\n      const importPath = getImportPath(pluginConfig, options?.pluginType);\n      try {\n        const plugin = (await import(importPath)) as { default: EmmettPlugin };\n\n        console.info(`Loaded plugin: ${importPath}`);\n\n        if (!plugin.default) {\n          throw new Error(`Plugin: ${importPath} is missing default export`);\n        }\n\n        return plugin.default;\n      } catch (error) {\n        console.error(`Failed to load extension \"${importPath}\":`, error);\n        return undefined;\n      }\n    });\n\n    return (await Promise.all(pluginsPromises)).filter(\n      (plugin) => plugin !== undefined,\n    );\n  } catch (error) {\n    console.error(`Failed to load config ${options?.configPath}:`, error);\n    return [];\n  }\n};\n\nexport const registerCliPlugins = async (\n  program: CliCommand,\n  plugins: EmmettCliPlugin[],\n): Promise<void> => {\n  const result: EmmettCliPlugin[] = [];\n\n  for (const plugin of plugins) {\n    const pluginName = plugin.name;\n\n    if (!('registerCommands' in plugin)) {\n      console.warn(`No registerCommands function found in ${pluginName}`);\n    }\n    await plugin.registerCommands(program as EmmettCliCommand);\n    console.log(`Loaded extension: ${plugin.name}`);\n    result.push(plugin);\n  }\n};\n\nconst filterPluginsByType = (\n  plugins: EmmettPluginConfig[],\n  pluginType?: EmmettPluginType,\n): EmmettPluginConfig[] =>\n  plugins.filter(\n    (p) =>\n      typeof p === 'string' ||\n      (pluginType &&\n        (p.register === undefined ||\n          p.register.some((r) => r.pluginType === pluginType))),\n  );\n\nconst getImportPath = (\n  pluginConfig: EmmettPluginConfig,\n  pluginType: EmmettPluginType | undefined,\n) => {\n  if (typeof pluginConfig === 'string') {\n    return pluginType ? `${pluginConfig}/${pluginType}` : pluginConfig;\n  }\n\n  const pluginSubpath =\n    pluginConfig.register.find((r) => pluginType && r.pluginType === pluginType)\n      ?.path ?? pluginType;\n\n  return pluginSubpath\n    ? `${pluginConfig.name}/${pluginSubpath}`\n    : pluginConfig.name;\n};\n","#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { loadPlugins, registerCliPlugins } from './commandLine';\n\nconst program = new Command();\n\nprogram\n  .name('emmett')\n  .description('CLI tool for Emmett')\n  .option('--config <path>', 'Path to the configuration file');\n\n// Load extensions and parse CLI arguments\nconst initCLI = async () => {\n  const configIndex = process.argv.indexOf('--config');\n\n  const configPath =\n    configIndex !== -1 && process.argv.length > configIndex + 1\n      ? process.argv[configIndex + 1]\n      : undefined;\n\n  try {\n    const plugins = await loadPlugins({\n      pluginType: 'cli',\n      configPath: configPath,\n    });\n    await registerCliPlugins(program, plugins);\n\n    // Parse the CLI arguments\n    program.parse(process.argv);\n  } catch (err) {\n    console.error(`Failed to load config from ${configPath}:`, err);\n  }\n};\n\n//Initialize CLI and handle errors\ninitCLI().catch((err) => {\n  console.error(`CLI initialization failed:`);\n  console.error(err);\n});\n\nexport default program;\nexport * from './commandLine';\n"],"mappings":"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"}

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":["CliCommand"],"sources":["../src/commandLine/config.ts","../src/commandLine/plugins.ts","../src/cli.ts"],"sourcesContent":["import { Command as CliCommand } from 'commander';\n// eslint-disable-next-line no-restricted-imports\nimport { writeFileSync } from 'node:fs';\nimport { exit } from 'process';\n\nexport const sampleConfig = (plugins: string[] = ['emmett-expressjs']) => {\n  const pluginsNames =\n    plugins.length > 0\n      ? `[\\n${plugins.map((p) => `\"${p}\"`).join(',\\n')}  \\n]`\n      : '[]';\n\n  return `\nexport default {\n  plugins: ${pluginsNames},\n};\n`;\n};\n\nexport const generateConfigFile = (\n  configPath: string,\n  collectionNames: string[],\n): void => {\n  try {\n    writeFileSync(configPath, sampleConfig(collectionNames), 'utf8');\n    console.log(`Configuration file stored at: ${configPath}`);\n  } catch (error) {\n    console.error(`Error: Couldn't store config file: ${configPath}!`);\n    console.error(error);\n    process.exit(1);\n  }\n};\n\nexport const configCommand = new CliCommand('config').description(\n  'Manage Pongo configuration',\n);\n\ntype SampleConfigOptions =\n  | {\n      plugin: string[];\n      print?: boolean;\n    }\n  | {\n      plugin: string[];\n      generate?: boolean;\n      file?: string;\n    };\n\nconfigCommand\n  .command('sample')\n  .description('Generate or print sample configuration')\n  .option(\n    '-plg, --plugins <name>',\n    'Specify the plugin name',\n    (value: string, previous: string[]) => {\n      // Accumulate plugins names into an array (explicitly typing `previous` as `string[]`)\n      return previous.concat([value]);\n    },\n    [] as string[],\n  )\n  .option(\n    '-f, --file <path>',\n    'Path to configuration file with collection list',\n  )\n  .option('-g, --generate', 'Generate sample config file')\n  .option('-p, --print', 'Print sample config file')\n  .action((options: SampleConfigOptions) => {\n    const plugins =\n      options.plugin.length > 0\n        ? options.plugin\n        : ['@event-driven-io/emmett-expressjs'];\n\n    if (!('print' in options) && !('generate' in options)) {\n      console.error(\n        'Error: Please provide either:\\n--print param to print sample config or\\n--generate to generate sample config file',\n      );\n      exit(1);\n    }\n\n    if ('print' in options) {\n      console.log(`${sampleConfig(plugins)}`);\n    } else if ('generate' in options) {\n      if (!options.file) {\n        console.error(\n          'Error: You need to provide a config file through a --file',\n        );\n        exit(1);\n      }\n\n      generateConfigFile(options.file, plugins);\n    }\n  });\n","import type { Command as CliCommand } from 'commander';\nimport path from 'path';\nimport {\n  isPluginConfig,\n  type EmmettCliCommand,\n  type EmmettCliPlugin,\n  type EmmettPlugin,\n  type EmmettPluginConfig,\n  type EmmettPluginsConfig,\n  type EmmettPluginType,\n} from '../config';\nimport { EmmettError } from '../errors';\nimport { sampleConfig } from './config';\n\nconst PluginsConfigImportError = {\n  missingDefaultExport: `Error: Config should contain default export, e.g.\\n\\n${sampleConfig()}`,\n  missingPluginsPropertyExport: `Error: Config should contain default export with plugins array, e.g.\\n\\n${sampleConfig()}`,\n  wrongPluginStructure: `Error: Plugin config should be either string with plugin name or object with plugin name, e.g. { name: 'emmett-expressjs' }`,\n};\nexport const importPluginsConfig = async (options?: {\n  configPath?: string | undefined;\n}): Promise<EmmettPluginsConfig | EmmettError> => {\n  const configPath = path.join(\n    process.cwd(),\n    options?.configPath ?? './dist/emmett.config.js',\n  );\n\n  console.log('IMPORTING' + configPath);\n\n  try {\n    const imported = (await import(configPath)) as {\n      default: Partial<EmmettPluginsConfig>;\n    };\n\n    if (!imported.default) {\n      return new EmmettError(PluginsConfigImportError.missingDefaultExport);\n    }\n\n    if (!imported.default.plugins || !Array.isArray(imported.default.plugins)) {\n      return new EmmettError(\n        PluginsConfigImportError.missingPluginsPropertyExport,\n      );\n    }\n\n    if (!imported.default.plugins.every(isPluginConfig)) {\n      return new EmmettError(PluginsConfigImportError.wrongPluginStructure);\n    }\n\n    return { plugins: imported.default.plugins };\n  } catch (error) {\n    if (!options?.configPath) {\n      console.warn('Didn`t find config file: ' + configPath, error);\n      return { plugins: [] };\n    }\n    return new EmmettError(\n      `Error: Couldn't load file:` + (error as Error).toString(),\n    );\n  }\n};\n\nexport const loadPlugins = async (options?: {\n  pluginType?: EmmettPluginType;\n  configPath?: string;\n}): Promise<EmmettPlugin[]> => {\n  try {\n    const pluginsConfig = await importPluginsConfig({\n      configPath: options?.configPath,\n    });\n\n    if (pluginsConfig instanceof EmmettError) throw pluginsConfig;\n\n    if (pluginsConfig.plugins.length === 0) {\n      console.log(`No extensions specified in config ${options?.configPath}.`);\n      return [];\n    }\n\n    const pluginsToLoad = filterPluginsByType(\n      pluginsConfig.plugins,\n      options?.pluginType,\n    );\n\n    const pluginsPromises = pluginsToLoad.map(async (pluginConfig) => {\n      const importPath = getImportPath(pluginConfig, options?.pluginType);\n      try {\n        const plugin = (await import(importPath)) as { default: EmmettPlugin };\n\n        console.info(`Loaded plugin: ${importPath}`);\n\n        if (!plugin.default) {\n          throw new Error(`Plugin: ${importPath} is missing default export`);\n        }\n\n        return plugin.default;\n      } catch (error) {\n        console.error(`Failed to load extension \"${importPath}\":`, error);\n        return undefined;\n      }\n    });\n\n    return (await Promise.all(pluginsPromises)).filter(\n      (plugin) => plugin !== undefined,\n    );\n  } catch (error) {\n    console.error(`Failed to load config ${options?.configPath}:`, error);\n    return [];\n  }\n};\n\nexport const registerCliPlugins = async (\n  program: CliCommand,\n  plugins: EmmettCliPlugin[],\n): Promise<void> => {\n  const result: EmmettCliPlugin[] = [];\n\n  for (const plugin of plugins) {\n    const pluginName = plugin.name;\n\n    if (!('registerCommands' in plugin)) {\n      console.warn(`No registerCommands function found in ${pluginName}`);\n    }\n    await plugin.registerCommands(program as EmmettCliCommand);\n    console.log(`Loaded extension: ${plugin.name}`);\n    result.push(plugin);\n  }\n};\n\nconst filterPluginsByType = (\n  plugins: EmmettPluginConfig[],\n  pluginType?: EmmettPluginType,\n): EmmettPluginConfig[] =>\n  plugins.filter(\n    (p) =>\n      typeof p === 'string' ||\n      (pluginType &&\n        (p.register === undefined ||\n          p.register.some((r) => r.pluginType === pluginType))),\n  );\n\nconst getImportPath = (\n  pluginConfig: EmmettPluginConfig,\n  pluginType: EmmettPluginType | undefined,\n) => {\n  if (typeof pluginConfig === 'string') {\n    return pluginType ? `${pluginConfig}/${pluginType}` : pluginConfig;\n  }\n\n  const pluginSubpath =\n    pluginConfig.register.find((r) => pluginType && r.pluginType === pluginType)\n      ?.path ?? pluginType;\n\n  return pluginSubpath\n    ? `${pluginConfig.name}/${pluginSubpath}`\n    : pluginConfig.name;\n};\n","#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { loadPlugins, registerCliPlugins } from './commandLine';\n\nconst program = new Command();\n\nprogram\n  .name('emmett')\n  .description('CLI tool for Emmett')\n  .option('--config <path>', 'Path to the configuration file');\n\n// Load extensions and parse CLI arguments\nconst initCLI = async () => {\n  const configIndex = process.argv.indexOf('--config');\n\n  const configPath =\n    configIndex !== -1 && process.argv.length > configIndex + 1\n      ? process.argv[configIndex + 1]\n      : undefined;\n\n  try {\n    const plugins = await loadPlugins({\n      pluginType: 'cli',\n      configPath: configPath,\n    });\n    await registerCliPlugins(program, plugins);\n\n    // Parse the CLI arguments\n    program.parse(process.argv);\n  } catch (err) {\n    console.error(`Failed to load config from ${configPath}:`, err);\n  }\n};\n\n//Initialize CLI and handle errors\ninitCLI().catch((err) => {\n  console.error(`CLI initialization failed:`);\n  console.error(err);\n});\n\nexport default program;\nexport * from './commandLine';\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":["CliCommand"],"sources":["../src/commandLine/config.ts","../src/commandLine/plugins.ts","../src/cli.ts"],"sourcesContent":["import { Command as CliCommand } from 'commander';\n// eslint-disable-next-line no-restricted-imports\nimport { writeFileSync } from 'node:fs';\nimport { exit } from 'process';\n\nexport const sampleConfig = (plugins: string[] = ['emmett-expressjs']) => {\n  const pluginsNames =\n    plugins.length > 0\n      ? `[\\n${plugins.map((p) => `\"${p}\"`).join(',\\n')}  \\n]`\n      : '[]';\n\n  return `\nexport default {\n  plugins: ${pluginsNames},\n};\n`;\n};\n\nexport const generateConfigFile = (\n  configPath: string,\n  collectionNames: string[],\n): void => {\n  try {\n    writeFileSync(configPath, sampleConfig(collectionNames), 'utf8');\n    console.log(`Configuration file stored at: ${configPath}`);\n  } catch (error) {\n    console.error(`Error: Couldn't store config file: ${configPath}!`);\n    console.error(error);\n    process.exit(1);\n  }\n};\n\nexport const configCommand = new CliCommand('config').description(\n  'Manage Pongo configuration',\n);\n\ntype SampleConfigOptions =\n  | {\n      plugin: string[];\n      print?: boolean;\n    }\n  | {\n      plugin: string[];\n      generate?: boolean;\n      file?: string;\n    };\n\nconfigCommand\n  .command('sample')\n  .description('Generate or print sample configuration')\n  .option(\n    '-plg, --plugins <name>',\n    'Specify the plugin name',\n    (value: string, previous: string[]) => {\n      // Accumulate plugins names into an array (explicitly typing `previous` as `string[]`)\n      return previous.concat([value]);\n    },\n    [] as string[],\n  )\n  .option(\n    '-f, --file <path>',\n    'Path to configuration file with collection list',\n  )\n  .option('-g, --generate', 'Generate sample config file')\n  .option('-p, --print', 'Print sample config file')\n  .action((options: SampleConfigOptions) => {\n    const plugins =\n      options.plugin.length > 0\n        ? options.plugin\n        : ['@event-driven-io/emmett-expressjs'];\n\n    if (!('print' in options) && !('generate' in options)) {\n      console.error(\n        'Error: Please provide either:\\n--print param to print sample config or\\n--generate to generate sample config file',\n      );\n      exit(1);\n    }\n\n    if ('print' in options) {\n      console.log(`${sampleConfig(plugins)}`);\n    } else if ('generate' in options) {\n      if (!options.file) {\n        console.error(\n          'Error: You need to provide a config file through a --file',\n        );\n        exit(1);\n      }\n\n      generateConfigFile(options.file, plugins);\n    }\n  });\n","import type { Command as CliCommand } from 'commander';\nimport path from 'path';\nimport {\n  isPluginConfig,\n  type EmmettCliCommand,\n  type EmmettCliPlugin,\n  type EmmettPlugin,\n  type EmmettPluginConfig,\n  type EmmettPluginsConfig,\n  type EmmettPluginType,\n} from '../config';\nimport { EmmettError } from '../errors';\nimport { sampleConfig } from './config';\n\nconst PluginsConfigImportError = {\n  missingDefaultExport: `Error: Config should contain default export, e.g.\\n\\n${sampleConfig()}`,\n  missingPluginsPropertyExport: `Error: Config should contain default export with plugins array, e.g.\\n\\n${sampleConfig()}`,\n  wrongPluginStructure: `Error: Plugin config should be either string with plugin name or object with plugin name, e.g. { name: 'emmett-expressjs' }`,\n};\nexport const importPluginsConfig = async (options?: {\n  configPath?: string | undefined;\n}): Promise<EmmettPluginsConfig | EmmettError> => {\n  const configPath = path.join(\n    process.cwd(),\n    options?.configPath ?? './dist/emmett.config.js',\n  );\n\n  console.log('IMPORTING' + configPath);\n\n  try {\n    const imported = (await import(configPath)) as {\n      default: Partial<EmmettPluginsConfig>;\n    };\n\n    if (!imported.default) {\n      return new EmmettError(PluginsConfigImportError.missingDefaultExport);\n    }\n\n    if (!imported.default.plugins || !Array.isArray(imported.default.plugins)) {\n      return new EmmettError(\n        PluginsConfigImportError.missingPluginsPropertyExport,\n      );\n    }\n\n    if (!imported.default.plugins.every(isPluginConfig)) {\n      return new EmmettError(PluginsConfigImportError.wrongPluginStructure);\n    }\n\n    return { plugins: imported.default.plugins };\n  } catch (error) {\n    if (!options?.configPath) {\n      console.warn('Didn`t find config file: ' + configPath, error);\n      return { plugins: [] };\n    }\n    return new EmmettError(\n      `Error: Couldn't load file:` + (error as Error).toString(),\n    );\n  }\n};\n\nexport const loadPlugins = async (options?: {\n  pluginType?: EmmettPluginType;\n  configPath?: string;\n}): Promise<EmmettPlugin[]> => {\n  try {\n    const pluginsConfig = await importPluginsConfig({\n      configPath: options?.configPath,\n    });\n\n    if (pluginsConfig instanceof EmmettError) throw pluginsConfig;\n\n    if (pluginsConfig.plugins.length === 0) {\n      console.log(`No extensions specified in config ${options?.configPath}.`);\n      return [];\n    }\n\n    const pluginsToLoad = filterPluginsByType(\n      pluginsConfig.plugins,\n      options?.pluginType,\n    );\n\n    const pluginsPromises = pluginsToLoad.map(async (pluginConfig) => {\n      const importPath = getImportPath(pluginConfig, options?.pluginType);\n      try {\n        const plugin = (await import(importPath)) as { default: EmmettPlugin };\n\n        console.info(`Loaded plugin: ${importPath}`);\n\n        if (!plugin.default) {\n          throw new Error(`Plugin: ${importPath} is missing default export`);\n        }\n\n        return plugin.default;\n      } catch (error) {\n        console.error(`Failed to load extension \"${importPath}\":`, error);\n        return undefined;\n      }\n    });\n\n    return (await Promise.all(pluginsPromises)).filter(\n      (plugin) => plugin !== undefined,\n    );\n  } catch (error) {\n    console.error(`Failed to load config ${options?.configPath}:`, error);\n    return [];\n  }\n};\n\nexport const registerCliPlugins = async (\n  program: CliCommand,\n  plugins: EmmettCliPlugin[],\n): Promise<void> => {\n  const result: EmmettCliPlugin[] = [];\n\n  for (const plugin of plugins) {\n    const pluginName = plugin.name;\n\n    if (!('registerCommands' in plugin)) {\n      console.warn(`No registerCommands function found in ${pluginName}`);\n    }\n    await plugin.registerCommands(program as EmmettCliCommand);\n    console.log(`Loaded extension: ${plugin.name}`);\n    result.push(plugin);\n  }\n};\n\nconst filterPluginsByType = (\n  plugins: EmmettPluginConfig[],\n  pluginType?: EmmettPluginType,\n): EmmettPluginConfig[] =>\n  plugins.filter(\n    (p) =>\n      typeof p === 'string' ||\n      (pluginType &&\n        (p.register === undefined ||\n          p.register.some((r) => r.pluginType === pluginType))),\n  );\n\nconst getImportPath = (\n  pluginConfig: EmmettPluginConfig,\n  pluginType: EmmettPluginType | undefined,\n) => {\n  if (typeof pluginConfig === 'string') {\n    return pluginType ? `${pluginConfig}/${pluginType}` : pluginConfig;\n  }\n\n  const pluginSubpath =\n    pluginConfig.register.find((r) => pluginType && r.pluginType === pluginType)\n      ?.path ?? pluginType;\n\n  return pluginSubpath\n    ? `${pluginConfig.name}/${pluginSubpath}`\n    : pluginConfig.name;\n};\n","#!/usr/bin/env node\nimport { Command } from 'commander';\nimport { loadPlugins, registerCliPlugins } from './commandLine';\n\nconst program = new Command();\n\nprogram\n  .name('emmett')\n  .description('CLI tool for Emmett')\n  .option('--config <path>', 'Path to the configuration file');\n\n// Load extensions and parse CLI arguments\nconst initCLI = async () => {\n  const configIndex = process.argv.indexOf('--config');\n\n  const configPath =\n    configIndex !== -1 && process.argv.length > configIndex + 1\n      ? process.argv[configIndex + 1]\n      : undefined;\n\n  try {\n    const plugins = await loadPlugins({\n      pluginType: 'cli',\n      configPath: configPath,\n    });\n    await registerCliPlugins(program, plugins);\n\n    // Parse the CLI arguments\n    program.parse(process.argv);\n  } catch (err) {\n    console.error(`Failed to load config from ${configPath}:`, err);\n  }\n};\n\n//Initialize CLI and handle errors\ninitCLI().catch((err) => {\n  console.error(`CLI initialization failed:`);\n  console.error(err);\n});\n\nexport default program;\nexport * from './commandLine';\n"],"mappings":"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"}

package/dist/index.cjs

@@ -3,6 +3,7 @@ const require_plugins = require('./plugins-DB9xe8AV.cjs');
 let uuid = require("uuid");
 let async_retry = require("async-retry");
 async_retry = require_plugins.__toESM(async_retry, 1);
+let _event_driven_io_almanac = require("@event-driven-io/almanac");
 
 //#region src/eventStore/afterCommit/afterEventStoreCommitHandler.ts
 async function tryPublishMessagesAfterCommit(messages, options, context) {
@@ -1070,14 +1071,27 @@ const reactor = (options) => {
 		canHandle,
 		init,
 		start: async (startOptions) => {
-			if (isActive) return;
+			if (isActive) {
+				console.log(`Processor ${processorId} with instance id ${instanceId} is already active. Start request ignored.`);
+				return;
+			}
+			console.log(`Starting processor ${processorId} with instance id ${instanceId}`);
 			await init(startOptions);
 			isActive = true;
 			closeSignal = onShutdown(() => close(startOptions));
-			if (lastCheckpoint !== null) return { lastCheckpoint };
+			if (lastCheckpoint !== null) {
+				console.log(`Processor ${processorId} started with instance id ${instanceId}, checkpoint: ${JSONSerializer.serialize(lastCheckpoint)}`);
+				return { lastCheckpoint };
+			}
 			return await processingScope(async (context) => {
-				if (hooks.onStart) await hooks.onStart(context);
-				if (startFrom && startFrom !== "CURRENT") return startFrom;
+				if (hooks.onStart) {
+					console.log(`Executing onStart hook for processor ${processorId} with instance id ${instanceId}`);
+					await hooks.onStart(context);
+				}
+				if (startFrom && startFrom !== "CURRENT") {
+					console.log(`Processor ${processorId} with instance id ${instanceId} starting from: ${JSONSerializer.serialize(startFrom)}`);
+					return startFrom;
+				}
 				if (checkpoints) lastCheckpoint = (await checkpoints?.read({
 					processorId,
 					partition
@@ -1085,7 +1099,11 @@ const reactor = (options) => {
 					...startOptions,
 					...context
 				})).lastCheckpoint;
-				if (lastCheckpoint === null) return "BEGINNING";
+				if (lastCheckpoint === null) {
+					console.log(`Processor ${processorId} with instance id ${instanceId} starting from: BEGINNING`);
+					return "BEGINNING";
+				}
+				console.log(`Checkpoint read for processor ${processorId} with instance id ${instanceId}: ${JSONSerializer.serialize(lastCheckpoint)}`);
 				return { lastCheckpoint };
 			}, startOptions);
 		},
@@ -1095,34 +1113,44 @@ const reactor = (options) => {
 		},
 		handle: async (messages, partialContext) => {
 			if (!isActive) return Promise.resolve();
-			return await processingScope(async (context) => {
-				const messagesAboveCheckpoint = messages.filter((message) => !wasMessageHandled(message, lastCheckpoint));
-				const upcastedMessages = messagesAboveCheckpoint.map((message) => upcastRecordedMessage(message, options.messageOptions?.schema?.versioning)).filter((upcasted) => !canHandle || canHandle.includes(upcasted.type));
-				const stopMessageIndex = isCustomBatch && stopAfter ? upcastedMessages.findIndex(stopAfter) : -1;
-				const unhandledMessages = stopMessageIndex !== -1 ? upcastedMessages.slice(0, stopMessageIndex + 1) : upcastedMessages;
-				const batchResult = await eachBatch(unhandledMessages, context);
-				const messageProcessingResult = batchResult?.type === "STOP" ? batchResult : stopMessageIndex !== -1 ? {
+			try {
+				return await processingScope(async (context) => {
+					const messagesAboveCheckpoint = messages.filter((message) => !wasMessageHandled(message, lastCheckpoint));
+					const upcastedMessages = messagesAboveCheckpoint.map((message) => upcastRecordedMessage(message, options.messageOptions?.schema?.versioning)).filter((upcasted) => !canHandle || canHandle.includes(upcasted.type));
+					const stopMessageIndex = isCustomBatch && stopAfter ? upcastedMessages.findIndex(stopAfter) : -1;
+					const unhandledMessages = stopMessageIndex !== -1 ? upcastedMessages.slice(0, stopMessageIndex + 1) : upcastedMessages;
+					const batchResult = await eachBatch(unhandledMessages, context);
+					const messageProcessingResult = batchResult?.type === "STOP" ? batchResult : stopMessageIndex !== -1 ? {
+						type: "STOP",
+						reason: "Stop condition reached",
+						lastSuccessfulMessage: unhandledMessages[stopMessageIndex]
+					} : batchResult;
+					const isStop = messageProcessingResult && messageProcessingResult.type === "STOP";
+					const checkpointMessage = messageProcessingResult?.type === "STOP" ? messageProcessingResult.lastSuccessfulMessage : messagesAboveCheckpoint[messagesAboveCheckpoint.length - 1];
+					if (checkpointMessage && checkpoints) {
+						const storeCheckpointResult = await checkpoints.store({
+							processorId,
+							version,
+							message: checkpointMessage,
+							lastCheckpoint,
+							partition
+						}, context);
+						if (storeCheckpointResult.success) lastCheckpoint = storeCheckpointResult.newCheckpoint;
+					}
+					if (isStop) {
+						isActive = false;
+						return messageProcessingResult;
+					}
+				}, partialContext);
+			} catch (error) {
+				console.log(`Error during message processing for processor ${processorId} with instance id ${instanceId}. Stopping the processor.`, error);
+				isActive = false;
+				return {
 					type: "STOP",
-					reason: "Stop condition reached",
-					lastSuccessfulMessage: unhandledMessages[stopMessageIndex]
-				} : batchResult;
-				const isStop = messageProcessingResult && messageProcessingResult.type === "STOP";
-				const checkpointMessage = messageProcessingResult?.type === "STOP" ? messageProcessingResult.lastSuccessfulMessage : messagesAboveCheckpoint[messagesAboveCheckpoint.length - 1];
-				if (checkpointMessage && checkpoints) {
-					const storeCheckpointResult = await checkpoints.store({
-						processorId,
-						version,
-						message: checkpointMessage,
-						lastCheckpoint,
-						partition
-					}, context);
-					if (storeCheckpointResult.success) lastCheckpoint = storeCheckpointResult.newCheckpoint;
-				}
-				if (isStop) {
-					isActive = false;
-					return messageProcessingResult;
-				}
-			}, partialContext);
+					error,
+					reason: "Error during message processing"
+				};
+			}
 		}
 	};
 };
@@ -1374,9 +1402,12 @@ const assertNotDeepEqual = (actual, expected, message) => {
 const assertThat = (item) => {
 	return { isEqualTo: (other) => assertTrue(deepEquals(item, other)) };
 };
-const assertDefined = (value, message) => {
-	assertOk(value, message instanceof Error ? message.message : message);
-};
+function assertDefined(value, message) {
+	if (value === void 0 || value === null) throw new AssertionError((message instanceof Error ? message.message : message) ?? "Value is not defined");
+}
+function assertUndefined(value, message) {
+	if (value !== void 0 && value !== null) throw new AssertionError((message instanceof Error ? message.message : message) ?? "Value is defined");
+}
 function assertFalse(condition, message) {
 	if (condition !== false) throw new AssertionError(message ?? `Condition is true`);
 }
@@ -1855,6 +1886,247 @@ const getInMemoryEventStore = (eventStoreOptions) => {
 	return eventStore;
 };
 
+//#endregion
+//#region src/observability/attributes.ts
+const EmmettAttributes = {
+	scope: { type: "emmett.scope.type" },
+	command: {
+		type: "emmett.command.type",
+		status: "emmett.command.status",
+		eventCount: "emmett.command.event_count",
+		eventTypes: "emmett.command.event_types"
+	},
+	stream: {
+		name: "emmett.stream.name",
+		versionBefore: "emmett.stream.version.before",
+		versionAfter: "emmett.stream.version.after"
+	},
+	eventStore: {
+		operation: "emmett.eventstore.operation",
+		read: {
+			eventCount: "emmett.eventstore.read.event_count",
+			eventTypes: "emmett.eventstore.read.event_types",
+			status: "emmett.eventstore.read.status"
+		},
+		append: {
+			batchSize: "emmett.eventstore.append.batch_size",
+			status: "emmett.eventstore.append.status"
+		}
+	},
+	event: { type: "emmett.event.type" },
+	processor: {
+		id: "emmett.processor.id",
+		type: "emmett.processor.type",
+		status: "emmett.processor.status",
+		batchSize: "emmett.processor.batch_size",
+		eventTypes: "emmett.processor.event_types",
+		checkpointBefore: "emmett.processor.checkpoint.before",
+		checkpointAfter: "emmett.processor.checkpoint.after",
+		lagEvents: "emmett.processor.lag_events"
+	},
+	workflow: {
+		id: "emmett.workflow.id",
+		type: "emmett.workflow.type",
+		inputType: "emmett.workflow.input.type",
+		outputs: "emmett.workflow.outputs",
+		outputsCount: "emmett.workflow.outputs.count",
+		streamPosition: "emmett.workflow.stream_position",
+		stateRebuildEventCount: "emmett.workflow.state_rebuild.event_count"
+	},
+	consumer: {
+		batchSize: "emmett.consumer.batch_size",
+		processorCount: "emmett.consumer.processor_count",
+		delivery: { processorId: "emmett.consumer.delivery.processor_id" }
+	}
+};
+const EmmettMetrics = {
+	command: { handlingDuration: "emmett.command.handling.duration" },
+	event: {
+		appendingCount: "emmett.event.appending.count",
+		readingCount: "emmett.event.reading.count"
+	},
+	stream: {
+		readingDuration: "emmett.stream.reading.duration",
+		readingSize: "emmett.stream.reading.size",
+		appendingDuration: "emmett.stream.appending.duration",
+		appendingSize: "emmett.stream.appending.size"
+	},
+	processor: {
+		processingDuration: "emmett.processor.processing.duration",
+		lagEvents: "emmett.processor.lag_events"
+	},
+	workflow: { processingDuration: "emmett.workflow.processing.duration" },
+	consumer: {
+		pollDuration: "emmett.consumer.poll.duration",
+		deliveryDuration: "emmett.consumer.delivery.duration"
+	}
+};
+const ScopeTypes = {
+	command: "command",
+	processor: "processor",
+	reactor: "reactor",
+	projector: "projector",
+	workflow: "workflow",
+	consumer: "consumer"
+};
+const MessagingSystemName = "emmett";
+
+//#endregion
+//#region src/observability/options.ts
+const resolveCommandObservability = (options, parent) => ({
+	tracer: options?.observability?.tracer ?? parent?.observability?.tracer ?? (0, _event_driven_io_almanac.noopTracer)(),
+	meter: options?.observability?.meter ?? parent?.observability?.meter ?? (0, _event_driven_io_almanac.noopMeter)(),
+	attributeTarget: options?.observability?.attributeTarget ?? parent?.observability?.attributeTarget ?? "both",
+	includeMessagePayloads: options?.observability?.includeMessagePayloads ?? parent?.observability?.includeMessagePayloads ?? false
+});
+
+//#endregion
+//#region src/observability/tracer.ts
+const tracer = () => {};
+const LogLevel = {
+	DISABLED: "DISABLED",
+	INFO: "INFO",
+	LOG: "LOG",
+	WARN: "WARN",
+	ERROR: "ERROR"
+};
+const getEnvVariable = (name) => {
+	try {
+		if (typeof process !== "undefined" && process.env) return process.env[name];
+		return;
+	} catch {
+		return;
+	}
+};
+const shouldLog = (logLevel) => {
+	const definedLogLevel = getEnvVariable("DUMBO_LOG_LEVEL") ?? LogLevel.ERROR;
+	if (definedLogLevel === LogLevel.ERROR && logLevel === LogLevel.ERROR) return true;
+	if (definedLogLevel === LogLevel.WARN && [LogLevel.ERROR, LogLevel.WARN].includes(logLevel)) return true;
+	if (definedLogLevel === LogLevel.LOG && [
+		LogLevel.ERROR,
+		LogLevel.WARN,
+		LogLevel.LOG
+	].includes(logLevel)) return true;
+	if (definedLogLevel === LogLevel.INFO && [
+		LogLevel.ERROR,
+		LogLevel.WARN,
+		LogLevel.LOG,
+		LogLevel.INFO
+	].includes(logLevel)) return true;
+	return false;
+};
+const nulloTraceEventRecorder = () => {};
+const getTraceEventFormatter = (logStyle, serializer) => (event) => {
+	serializer = serializer ?? JSONSerializer.from();
+	switch (logStyle) {
+		case "RAW": return serializer.serialize(event);
+		case "PRETTY": return serializer.serialize(event);
+	}
+};
+const getTraceEventRecorder = (logLevel, logStyle) => {
+	const format = getTraceEventFormatter(logStyle);
+	switch (logLevel) {
+		case "DISABLED": return nulloTraceEventRecorder;
+		case "INFO": return (event) => console.info(format(event));
+		case "LOG": return (event) => console.log(format(event));
+		case "WARN": return (event) => console.warn(format(event));
+		case "ERROR": return (event) => console.error(format(event));
+	}
+};
+const recordTraceEvent = (logLevel, eventName, attributes) => {
+	if (!shouldLog(LogLevel.LOG)) return;
+	const event = {
+		name: eventName,
+		timestamp: (/* @__PURE__ */ new Date()).getTime(),
+		...attributes
+	};
+	getTraceEventRecorder(logLevel, getEnvVariable("DUMBO_LOG_STYLE") ?? "RAW")(event);
+};
+tracer.info = (eventName, attributes) => recordTraceEvent(LogLevel.INFO, eventName, attributes);
+tracer.warn = (eventName, attributes) => recordTraceEvent(LogLevel.WARN, eventName, attributes);
+tracer.log = (eventName, attributes) => recordTraceEvent(LogLevel.LOG, eventName, attributes);
+tracer.error = (eventName, attributes) => recordTraceEvent(LogLevel.ERROR, eventName, attributes);
+
+//#endregion
+//#region src/commandHandling/observability/commandHandlerCollector.ts
+const commandHandlerCollector = (observability) => {
+	const { startScope } = (0, _event_driven_io_almanac.ObservabilityScope)({
+		...observability,
+		attributePrefix: "emmett"
+	});
+	const A = EmmettAttributes;
+	const M = _event_driven_io_almanac.MessagingAttributes;
+	const commandHandlingDuration = observability.meter.histogram(EmmettMetrics.command.handlingDuration);
+	const eventAppendingCount = observability.meter.counter(EmmettMetrics.event.appendingCount);
+	return {
+		startScope: (context, fn) => {
+			const start = Date.now();
+			return startScope("command.handle", async (scope) => {
+				scope.setAttributes({
+					[A.scope.type]: ScopeTypes.command,
+					[M.system]: MessagingSystemName,
+					[M.destination.name]: context.streamName,
+					...context.commandType ? { [A.command.type]: context.commandType } : {},
+					...context.correlationId ? { [M.message.correlationId]: context.correlationId } : {},
+					...context.causationId ? { [M.message.causationId]: context.causationId } : {}
+				});
+				let status = "success";
+				try {
+					const result = await fn(scope);
+					status = "success";
+					scope.setAttributes({
+						[A.command.status]: "success",
+						error: false
+					});
+					return result;
+				} catch (err) {
+					status = "failure";
+					scope.setAttributes({
+						[A.command.status]: "failure",
+						error: true,
+						"exception.message": err instanceof Error ? err.message : String(err),
+						"exception.type": err instanceof Error ? err.constructor.name : "unknown"
+					});
+					scope.recordException(err instanceof Error ? err : new Error(String(err)));
+					throw err;
+				} finally {
+					commandHandlingDuration.record(Date.now() - start, {
+						[A.command.status]: status,
+						...typeof context.commandType === "string" ? { [A.command.type]: context.commandType } : {}
+					});
+				}
+			}, {
+				parent: context.traceId && context.spanId ? {
+					traceId: context.traceId,
+					spanId: context.spanId
+				} : void 0,
+				attributes: {
+					[A.scope.type]: ScopeTypes.command,
+					[A.stream.name]: context.streamName,
+					...context.commandType ? { [A.command.type]: context.commandType } : {},
+					...context.correlationId ? { [M.message.correlationId]: context.correlationId } : {},
+					...context.causationId ? { [M.message.causationId]: context.causationId } : {}
+				}
+			});
+		},
+		recordEvents: (scope, events, status) => {
+			scope.setAttributes({
+				[A.command.eventCount]: events.length,
+				[A.command.eventTypes]: events.map((e) => e.type),
+				[M.batch.messageCount]: events.length,
+				[A.command.status]: status
+			});
+			for (const event of events) eventAppendingCount.add(1, { [A.event.type]: event.type });
+		},
+		recordVersions: (scope, before, after) => {
+			scope.setAttributes({
+				[A.stream.versionBefore]: Number(before),
+				[A.stream.versionAfter]: Number(after)
+			});
+		}
+	};
+};
+
 //#endregion
 //#region src/commandHandling/handleCommand.ts
 const CommandHandlerStreamVersionConflictRetryOptions = {
@@ -1863,6 +2135,76 @@ const CommandHandlerStreamVersionConflictRetryOptions = {
 	factor: 1.5,
 	shouldRetryError: isExpectedVersionConflictError
 };
+const CommandHandler = (options) => async (store, id, handle, handleOptions) => {
+	const collector = commandHandlerCollector(resolveCommandObservability(options));
+	const streamName = (options.mapToStreamId ?? ((id) => id))(id);
+	const commandType = handleOptions?.commandType ?? options.commandType ?? options.name ?? handlerNames(handle);
+	const correlationId = handleOptions?.observability?.correlationId ?? (0, uuid.v7)();
+	const causationId = handleOptions?.observability?.causationId;
+	return asyncRetry(() => collector.startScope({
+		streamName,
+		commandType,
+		correlationId,
+		causationId,
+		traceId: handleOptions?.observability?.traceId,
+		spanId: handleOptions?.observability?.spanId
+	}, async (scope) => {
+		return await withSession$1(store, async ({ eventStore }) => {
+			const { evolve, initialState } = options;
+			const aggregationResult = await eventStore.aggregateStream(streamName, {
+				evolve,
+				initialState,
+				read: {
+					schema: options.schema,
+					...handleOptions,
+					serialization: options.serialization,
+					expectedStreamVersion: handleOptions?.expectedStreamVersion ?? "NO_CONCURRENCY_CHECK"
+				}
+			});
+			const { currentStreamVersion, streamExists: _streamExists, ...restOfAggregationResult } = aggregationResult;
+			let state = aggregationResult.state;
+			const handlers = Array.isArray(handle) ? handle : [handle];
+			let eventsToAppend = [];
+			for (const handler of handlers) {
+				const result = await handler(state);
+				const newEvents = Array.isArray(result) ? result : [result];
+				if (newEvents.length > 0) state = newEvents.reduce(evolve, state);
+				eventsToAppend = [...eventsToAppend, ...newEvents];
+			}
+			if (eventsToAppend.length === 0) {
+				collector.recordVersions(scope, currentStreamVersion, currentStreamVersion);
+				return {
+					...restOfAggregationResult,
+					newEvents: [],
+					newState: state,
+					nextExpectedStreamVersion: currentStreamVersion,
+					createdNewStream: false
+				};
+			}
+			const expectedStreamVersion = handleOptions?.expectedStreamVersion ?? (aggregationResult.streamExists ? currentStreamVersion : "STREAM_DOES_NOT_EXIST");
+			const { traceId, spanId } = scope.spanContext();
+			const { observability: _appendObservability, ...handleOptionsForAppend } = handleOptions ?? {};
+			const appendResult = await eventStore.appendToStream(streamName, eventsToAppend, {
+				...handleOptionsForAppend,
+				expectedStreamVersion,
+				correlationId,
+				...causationId ? { causationId } : {},
+				traceId,
+				spanId
+			});
+			collector.recordEvents(scope, eventsToAppend, "success");
+			collector.recordVersions(scope, currentStreamVersion, appendResult.nextExpectedStreamVersion);
+			return {
+				...appendResult,
+				newEvents: eventsToAppend,
+				newState: state
+			};
+		});
+	}), fromCommandHandlerRetryOptions(handleOptions && "retry" in handleOptions ? handleOptions.retry : options.retry));
+};
+const withSession$1 = (eventStore, callback) => {
+	return (canCreateEventStoreSession(eventStore) ? eventStore : nulloSessionFactory(eventStore)).withSession(callback);
+};
 const fromCommandHandlerRetryOptions = (retryOptions) => {
 	if (retryOptions === void 0) return NoRetries;
 	if ("onVersionConflict" in retryOptions) if (typeof retryOptions.onVersionConflict === "boolean") return CommandHandlerStreamVersionConflictRetryOptions;
@@ -1873,58 +2215,24 @@ const fromCommandHandlerRetryOptions = (retryOptions) => {
 	else return retryOptions.onVersionConflict;
 	return retryOptions;
 };
-const CommandHandler = (options) => async (store, id, handle, handleOptions) => asyncRetry(async () => {
-	return await withSession$1(store, async ({ eventStore }) => {
-		const { evolve, initialState } = options;
-		const streamName = (options.mapToStreamId ?? ((id) => id))(id);
-		const aggregationResult = await eventStore.aggregateStream(streamName, {
-			evolve,
-			initialState,
-			read: {
-				schema: options.schema,
-				...handleOptions,
-				serialization: options.serialization,
-				expectedStreamVersion: handleOptions?.expectedStreamVersion ?? "NO_CONCURRENCY_CHECK"
-			}
-		});
-		const { currentStreamVersion, streamExists: _streamExists, ...restOfAggregationResult } = aggregationResult;
-		let state = aggregationResult.state;
-		const handlers = Array.isArray(handle) ? handle : [handle];
-		let eventsToAppend = [];
-		for (const handler of handlers) {
-			const result = await handler(state);
-			const newEvents = Array.isArray(result) ? result : [result];
-			if (newEvents.length > 0) state = newEvents.reduce(evolve, state);
-			eventsToAppend = [...eventsToAppend, ...newEvents];
-		}
-		if (eventsToAppend.length === 0) return {
-			...restOfAggregationResult,
-			newEvents: [],
-			newState: state,
-			nextExpectedStreamVersion: currentStreamVersion,
-			createdNewStream: false
-		};
-		const expectedStreamVersion = handleOptions?.expectedStreamVersion ?? (aggregationResult.streamExists ? currentStreamVersion : "STREAM_DOES_NOT_EXIST");
-		return {
-			...await eventStore.appendToStream(streamName, eventsToAppend, {
-				...handleOptions,
-				expectedStreamVersion
-			}),
-			newEvents: eventsToAppend,
-			newState: state
-		};
-	});
-}, fromCommandHandlerRetryOptions(handleOptions && "retry" in handleOptions ? handleOptions.retry : options.retry));
-const withSession$1 = (eventStore, callback) => {
-	return (canCreateEventStoreSession(eventStore) ? eventStore : nulloSessionFactory(eventStore)).withSession(callback);
+const handlerNames = (handle) => {
+	if (Array.isArray(handle)) {
+		const names = handle.map((h) => h.name).filter((n) => !!n);
+		return names.length > 0 ? names : void 0;
+	}
+	return handle.name || void 0;
 };
 
 //#endregion
 //#region src/commandHandling/handleCommandWithDecider.ts
+const commandTypesOf = (commands) => Array.isArray(commands) ? commands.map((c) => c.type) : commands.type;
 const DeciderCommandHandler = (options) => async (eventStore, id, commands, handleOptions) => {
 	const { decide, ...rest } = options;
 	const deciders = (Array.isArray(commands) ? commands : [commands]).map((command) => (state) => decide(command, state));
-	return CommandHandler(rest)(eventStore, id, deciders, handleOptions);
+	return CommandHandler(rest)(eventStore, id, deciders, {
+		commandType: commandTypesOf(commands),
+		...handleOptions
+	});
 };
 
 //#endregion
@@ -2263,6 +2571,7 @@ exports.assertThatArray = assertThatArray;
 exports.assertThrows = assertThrows;
 exports.assertThrowsAsync = assertThrowsAsync;
 exports.assertTrue = assertTrue;
+exports.assertUndefined = assertUndefined;
 exports.assertUnsignedBigInt = require_plugins.assertUnsignedBigInt;
 exports.asyncAwaiter = asyncAwaiter;
 exports.asyncProjections = asyncProjections;