@eventcatalog/cli 0.2.0 → 0.2.1

package/dist/cli/index.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/index.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli/index.ts
+var import_commander = require("commander");
+var import_node_fs2 = require("fs");
+var import_node_path = require("path");
+
+// src/cli/executor.ts
+var import_node_fs = require("fs");
+
+// src/cli/parser.ts
+function parseArguments(rawArgs) {
+  return rawArgs.map((arg, index) => {
+    if (arg.startsWith("{") && arg.endsWith("}") || arg.startsWith("[") && arg.endsWith("]")) {
+      try {
+        return JSON.parse(arg);
+      } catch (error) {
+        if (arg.includes(":") || arg.includes(",")) {
+          throw new Error(`Invalid JSON in argument ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return arg;
+      }
+    }
+    if (arg === "true") return true;
+    if (arg === "false") return false;
+    if (/^-?\d+(\.\d+)?$/.test(arg)) {
+      return Number(arg);
+    }
+    return arg;
+  });
+}
+
+// src/cli/executor.ts
+var import_sdk = __toESM(require("@eventcatalog/sdk"));
+async function executeFunction(catalogDir, functionName, rawArgs) {
+  if (!(0, import_node_fs.existsSync)(catalogDir)) {
+    throw new Error(`Catalog directory not found: ${catalogDir}`);
+  }
+  const sdk = (0, import_sdk.default)(catalogDir);
+  if (!(functionName in sdk)) {
+    throw new Error(`Function '${functionName}' not found. Use 'eventcatalog list' to see available functions.`);
+  }
+  const fn = sdk[functionName];
+  if (typeof fn !== "function") {
+    throw new Error(`'${functionName}' is not a callable function.`);
+  }
+  const parsedArgs = parseArguments(rawArgs);
+  try {
+    return await fn(...parsedArgs);
+  } catch (error) {
+    throw new Error(`Error executing '${functionName}': ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+// src/cli/list.ts
+var import_sdk2 = __toESM(require("@eventcatalog/sdk"));
+function listFunctions(catalogDir = ".") {
+  const sdk = (0, import_sdk2.default)(catalogDir);
+  const functionNames = Object.keys(sdk).filter((key) => typeof sdk[key] === "function");
+  const categories = {
+    Events: [],
+    Commands: [],
+    Queries: [],
+    Channels: [],
+    Services: [],
+    Domains: [],
+    Entities: [],
+    DataStores: [],
+    DataProducts: [],
+    Teams: [],
+    Users: [],
+    "Custom Docs": [],
+    Messages: [],
+    Utilities: []
+  };
+  functionNames.forEach((name) => {
+    if (name.includes("Event")) categories["Events"].push(name);
+    else if (name.includes("Command")) categories["Commands"].push(name);
+    else if (name.includes("Query")) categories["Queries"].push(name);
+    else if (name.includes("Channel")) categories["Channels"].push(name);
+    else if (name.includes("Service")) categories["Services"].push(name);
+    else if (name.includes("Domain")) categories["Domains"].push(name);
+    else if (name.includes("Entity")) categories["Entities"].push(name);
+    else if (name.includes("DataStore")) categories["DataStores"].push(name);
+    else if (name.includes("DataProduct")) categories["DataProducts"].push(name);
+    else if (name.includes("Team")) categories["Teams"].push(name);
+    else if (name.includes("User")) categories["Users"].push(name);
+    else if (name.includes("CustomDoc")) categories["Custom Docs"].push(name);
+    else if (name.includes("Message") || name.includes("Producers") || name.includes("Consumers"))
+      categories["Messages"].push(name);
+    else categories["Utilities"].push(name);
+  });
+  Object.keys(categories).forEach((key) => {
+    if (categories[key].length === 0) {
+      delete categories[key];
+    }
+  });
+  return categories;
+}
+function formatListOutput(functions) {
+  let output = "Available EventCatalog SDK Functions:\n\n";
+  Object.entries(functions).forEach(([category, names]) => {
+    output += `${category}:
+`;
+    names.sort().forEach((name) => {
+      output += `  - ${name}
+`;
+    });
+    output += "\n";
+  });
+  return output;
+}
+
+// src/cli/index.ts
+var version = "1.0.0";
+try {
+  const packageJsonPath = (0, import_node_path.resolve)(__dirname, "../../package.json");
+  const packageJson = JSON.parse((0, import_node_fs2.readFileSync)(packageJsonPath, "utf-8"));
+  version = packageJson.version;
+} catch {
+}
+import_commander.program.name("eventcatalog").description("EventCatalog Command-Line Interface").version(version).option("-d, --dir <path>", "Path to the EventCatalog directory (default: current directory)", ".");
+import_commander.program.command("list").description("List all available SDK functions").action(() => {
+  try {
+    const functions = listFunctions(".");
+    const output = formatListOutput(functions);
+    console.log(output);
+  } catch (error) {
+    console.error("Error listing functions:", error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+});
+import_commander.program.arguments("<function> [args...]").action(async (functionName, args) => {
+  try {
+    const options = import_commander.program.opts();
+    const dir = options.dir || ".";
+    const result = await executeFunction(dir, functionName, args);
+    console.log(JSON.stringify(result, null, 0));
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+});
+import_commander.program.parse(process.argv);
+if (process.argv.length < 3) {
+  import_commander.program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/executor.ts","../../src/cli/parser.ts","../../src/cli/list.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { program } from 'commander';\nimport { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { executeFunction } from './executor';\nimport { listFunctions, formatListOutput } from './list';\n\n// Read package.json to get version\nlet version = '1.0.0';\ntry {\n  const packageJsonPath = resolve(__dirname, '../../package.json');\n  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));\n  version = packageJson.version;\n} catch {\n  // Fall back to default version if package.json not found\n}\n\nprogram\n  .name('eventcatalog')\n  .description('EventCatalog Command-Line Interface')\n  .version(version)\n  .option('-d, --dir <path>', 'Path to the EventCatalog directory (default: current directory)', '.');\n\n// List command - show all available functions\nprogram\n  .command('list')\n  .description('List all available SDK functions')\n  .action(() => {\n    try {\n      const functions = listFunctions('.');\n      const output = formatListOutput(functions);\n      console.log(output);\n    } catch (error) {\n      console.error('Error listing functions:', error instanceof Error ? error.message : String(error));\n      process.exit(1);\n    }\n  });\n\n// Catch-all for any other command - execute as SDK function\nprogram.arguments('<function> [args...]').action(async (functionName: string, args: string[]) => {\n  try {\n    const options = program.opts() as any;\n    const dir = options.dir || '.';\n    const result = await executeFunction(dir, functionName, args);\n    console.log(JSON.stringify(result, null, 0));\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exit(1);\n  }\n});\n\nprogram.parse(process.argv);\n\n// Show help if no command provided\nif (process.argv.length < 3) {\n  program.outputHelp();\n}\n","import { existsSync } from 'node:fs';\nimport { parseArguments } from './parser';\nimport createSDK from '@eventcatalog/sdk';\n\n/**\n * Execute a SDK function with the given arguments\n */\nexport async function executeFunction(catalogDir: string, functionName: string, rawArgs: string[]): Promise<any> {\n  // Validate catalog directory exists\n  if (!existsSync(catalogDir)) {\n    throw new Error(`Catalog directory not found: ${catalogDir}`);\n  }\n\n  // Initialize the SDK\n  const sdk = createSDK(catalogDir);\n\n  // Validate function exists\n  if (!(functionName in sdk)) {\n    throw new Error(`Function '${functionName}' not found. Use 'eventcatalog list' to see available functions.`);\n  }\n\n  const fn = (sdk as any)[functionName];\n\n  // Validate it's callable\n  if (typeof fn !== 'function') {\n    throw new Error(`'${functionName}' is not a callable function.`);\n  }\n\n  // Parse arguments\n  const parsedArgs = parseArguments(rawArgs);\n\n  // Execute function\n  try {\n    return await fn(...parsedArgs);\n  } catch (error) {\n    throw new Error(`Error executing '${functionName}': ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n","/**\n * Parse command-line arguments into typed values\n * Supports JSON objects/arrays, booleans, numbers, and strings\n */\nexport function parseArguments(rawArgs: string[]): any[] {\n  return rawArgs.map((arg, index) => {\n    // Try to parse as JSON object or array if it looks like JSON\n    if ((arg.startsWith('{') && arg.endsWith('}')) || (arg.startsWith('[') && arg.endsWith(']'))) {\n      try {\n        return JSON.parse(arg);\n      } catch (error) {\n        // If it fails to parse as JSON, treat it as a string\n        // Only throw error if it looks like valid JSON syntax was intended\n        if (arg.includes(':') || arg.includes(',')) {\n          throw new Error(`Invalid JSON in argument ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n        // Otherwise, return as string\n        return arg;\n      }\n    }\n\n    // Parse booleans\n    if (arg === 'true') return true;\n    if (arg === 'false') return false;\n\n    // Parse numbers\n    if (/^-?\\d+(\\.\\d+)?$/.test(arg)) {\n      return Number(arg);\n    }\n\n    // Return as string\n    return arg;\n  });\n}\n","import createSDK from '@eventcatalog/sdk';\n\ninterface CategorizedFunctions {\n  [category: string]: string[];\n}\n\n/**\n * Get all available SDK functions organized by category\n */\nexport function listFunctions(catalogDir: string = '.'): CategorizedFunctions {\n  // Initialize SDK to get all functions\n  const sdk = createSDK(catalogDir);\n\n  // Get all function names from SDK\n  const functionNames = Object.keys(sdk).filter((key) => typeof (sdk as any)[key] === 'function');\n\n  // Categorize functions based on naming patterns\n  const categories: CategorizedFunctions = {\n    Events: [],\n    Commands: [],\n    Queries: [],\n    Channels: [],\n    Services: [],\n    Domains: [],\n    Entities: [],\n    DataStores: [],\n    DataProducts: [],\n    Teams: [],\n    Users: [],\n    'Custom Docs': [],\n    Messages: [],\n    Utilities: [],\n  };\n\n  functionNames.forEach((name) => {\n    if (name.includes('Event')) categories['Events'].push(name);\n    else if (name.includes('Command')) categories['Commands'].push(name);\n    else if (name.includes('Query')) categories['Queries'].push(name);\n    else if (name.includes('Channel')) categories['Channels'].push(name);\n    else if (name.includes('Service')) categories['Services'].push(name);\n    else if (name.includes('Domain')) categories['Domains'].push(name);\n    else if (name.includes('Entity')) categories['Entities'].push(name);\n    else if (name.includes('DataStore')) categories['DataStores'].push(name);\n    else if (name.includes('DataProduct')) categories['DataProducts'].push(name);\n    else if (name.includes('Team')) categories['Teams'].push(name);\n    else if (name.includes('User')) categories['Users'].push(name);\n    else if (name.includes('CustomDoc')) categories['Custom Docs'].push(name);\n    else if (name.includes('Message') || name.includes('Producers') || name.includes('Consumers'))\n      categories['Messages'].push(name);\n    else categories['Utilities'].push(name);\n  });\n\n  // Remove empty categories\n  Object.keys(categories).forEach((key) => {\n    if (categories[key].length === 0) {\n      delete categories[key];\n    }\n  });\n\n  return categories;\n}\n\n/**\n * Format and print categorized functions\n */\nexport function formatListOutput(functions: CategorizedFunctions): string {\n  let output = 'Available EventCatalog SDK Functions:\\n\\n';\n\n  Object.entries(functions).forEach(([category, names]) => {\n    output += `${category}:\\n`;\n    names.sort().forEach((name) => {\n      output += `  - ${name}\\n`;\n    });\n    output += '\\n';\n  });\n\n  return output;\n}\n"],"mappings":"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","names":["import_node_fs","createSDK","import_sdk","createSDK"]}

package/dist/cli/index.mjs

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+// ../../node_modules/.pnpm/tsup@8.5.0_jiti@1.21.7_postcss@8.5.6_typescript@5.9.3_yaml@2.8.1/node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path.dirname(getFilename());
+var __dirname = /* @__PURE__ */ getDirname();
+
+// src/cli/index.ts
+import { program } from "commander";
+import { readFileSync } from "fs";
+import { resolve } from "path";
+
+// src/cli/executor.ts
+import { existsSync } from "fs";
+
+// src/cli/parser.ts
+function parseArguments(rawArgs) {
+  return rawArgs.map((arg, index) => {
+    if (arg.startsWith("{") && arg.endsWith("}") || arg.startsWith("[") && arg.endsWith("]")) {
+      try {
+        return JSON.parse(arg);
+      } catch (error) {
+        if (arg.includes(":") || arg.includes(",")) {
+          throw new Error(`Invalid JSON in argument ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return arg;
+      }
+    }
+    if (arg === "true") return true;
+    if (arg === "false") return false;
+    if (/^-?\d+(\.\d+)?$/.test(arg)) {
+      return Number(arg);
+    }
+    return arg;
+  });
+}
+
+// src/cli/executor.ts
+import createSDK from "@eventcatalog/sdk";
+async function executeFunction(catalogDir, functionName, rawArgs) {
+  if (!existsSync(catalogDir)) {
+    throw new Error(`Catalog directory not found: ${catalogDir}`);
+  }
+  const sdk = createSDK(catalogDir);
+  if (!(functionName in sdk)) {
+    throw new Error(`Function '${functionName}' not found. Use 'eventcatalog list' to see available functions.`);
+  }
+  const fn = sdk[functionName];
+  if (typeof fn !== "function") {
+    throw new Error(`'${functionName}' is not a callable function.`);
+  }
+  const parsedArgs = parseArguments(rawArgs);
+  try {
+    return await fn(...parsedArgs);
+  } catch (error) {
+    throw new Error(`Error executing '${functionName}': ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+// src/cli/list.ts
+import createSDK2 from "@eventcatalog/sdk";
+function listFunctions(catalogDir = ".") {
+  const sdk = createSDK2(catalogDir);
+  const functionNames = Object.keys(sdk).filter((key) => typeof sdk[key] === "function");
+  const categories = {
+    Events: [],
+    Commands: [],
+    Queries: [],
+    Channels: [],
+    Services: [],
+    Domains: [],
+    Entities: [],
+    DataStores: [],
+    DataProducts: [],
+    Teams: [],
+    Users: [],
+    "Custom Docs": [],
+    Messages: [],
+    Utilities: []
+  };
+  functionNames.forEach((name) => {
+    if (name.includes("Event")) categories["Events"].push(name);
+    else if (name.includes("Command")) categories["Commands"].push(name);
+    else if (name.includes("Query")) categories["Queries"].push(name);
+    else if (name.includes("Channel")) categories["Channels"].push(name);
+    else if (name.includes("Service")) categories["Services"].push(name);
+    else if (name.includes("Domain")) categories["Domains"].push(name);
+    else if (name.includes("Entity")) categories["Entities"].push(name);
+    else if (name.includes("DataStore")) categories["DataStores"].push(name);
+    else if (name.includes("DataProduct")) categories["DataProducts"].push(name);
+    else if (name.includes("Team")) categories["Teams"].push(name);
+    else if (name.includes("User")) categories["Users"].push(name);
+    else if (name.includes("CustomDoc")) categories["Custom Docs"].push(name);
+    else if (name.includes("Message") || name.includes("Producers") || name.includes("Consumers"))
+      categories["Messages"].push(name);
+    else categories["Utilities"].push(name);
+  });
+  Object.keys(categories).forEach((key) => {
+    if (categories[key].length === 0) {
+      delete categories[key];
+    }
+  });
+  return categories;
+}
+function formatListOutput(functions) {
+  let output = "Available EventCatalog SDK Functions:\n\n";
+  Object.entries(functions).forEach(([category, names]) => {
+    output += `${category}:
+`;
+    names.sort().forEach((name) => {
+      output += `  - ${name}
+`;
+    });
+    output += "\n";
+  });
+  return output;
+}
+
+// src/cli/index.ts
+var version = "1.0.0";
+try {
+  const packageJsonPath = resolve(__dirname, "../../package.json");
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+  version = packageJson.version;
+} catch {
+}
+program.name("eventcatalog").description("EventCatalog Command-Line Interface").version(version).option("-d, --dir <path>", "Path to the EventCatalog directory (default: current directory)", ".");
+program.command("list").description("List all available SDK functions").action(() => {
+  try {
+    const functions = listFunctions(".");
+    const output = formatListOutput(functions);
+    console.log(output);
+  } catch (error) {
+    console.error("Error listing functions:", error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+});
+program.arguments("<function> [args...]").action(async (functionName, args) => {
+  try {
+    const options = program.opts();
+    const dir = options.dir || ".";
+    const result = await executeFunction(dir, functionName, args);
+    console.log(JSON.stringify(result, null, 0));
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+});
+program.parse(process.argv);
+if (process.argv.length < 3) {
+  program.outputHelp();
+}
+//# sourceMappingURL=index.mjs.map

package/dist/cli/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../node_modules/.pnpm/tsup@8.5.0_jiti@1.21.7_postcss@8.5.6_typescript@5.9.3_yaml@2.8.1/node_modules/tsup/assets/esm_shims.js","../../src/cli/index.ts","../../src/cli/executor.ts","../../src/cli/parser.ts","../../src/cli/list.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","#!/usr/bin/env node\n\nimport { program } from 'commander';\nimport { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { executeFunction } from './executor';\nimport { listFunctions, formatListOutput } from './list';\n\n// Read package.json to get version\nlet version = '1.0.0';\ntry {\n  const packageJsonPath = resolve(__dirname, '../../package.json');\n  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));\n  version = packageJson.version;\n} catch {\n  // Fall back to default version if package.json not found\n}\n\nprogram\n  .name('eventcatalog')\n  .description('EventCatalog Command-Line Interface')\n  .version(version)\n  .option('-d, --dir <path>', 'Path to the EventCatalog directory (default: current directory)', '.');\n\n// List command - show all available functions\nprogram\n  .command('list')\n  .description('List all available SDK functions')\n  .action(() => {\n    try {\n      const functions = listFunctions('.');\n      const output = formatListOutput(functions);\n      console.log(output);\n    } catch (error) {\n      console.error('Error listing functions:', error instanceof Error ? error.message : String(error));\n      process.exit(1);\n    }\n  });\n\n// Catch-all for any other command - execute as SDK function\nprogram.arguments('<function> [args...]').action(async (functionName: string, args: string[]) => {\n  try {\n    const options = program.opts() as any;\n    const dir = options.dir || '.';\n    const result = await executeFunction(dir, functionName, args);\n    console.log(JSON.stringify(result, null, 0));\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exit(1);\n  }\n});\n\nprogram.parse(process.argv);\n\n// Show help if no command provided\nif (process.argv.length < 3) {\n  program.outputHelp();\n}\n","import { existsSync } from 'node:fs';\nimport { parseArguments } from './parser';\nimport createSDK from '@eventcatalog/sdk';\n\n/**\n * Execute a SDK function with the given arguments\n */\nexport async function executeFunction(catalogDir: string, functionName: string, rawArgs: string[]): Promise<any> {\n  // Validate catalog directory exists\n  if (!existsSync(catalogDir)) {\n    throw new Error(`Catalog directory not found: ${catalogDir}`);\n  }\n\n  // Initialize the SDK\n  const sdk = createSDK(catalogDir);\n\n  // Validate function exists\n  if (!(functionName in sdk)) {\n    throw new Error(`Function '${functionName}' not found. Use 'eventcatalog list' to see available functions.`);\n  }\n\n  const fn = (sdk as any)[functionName];\n\n  // Validate it's callable\n  if (typeof fn !== 'function') {\n    throw new Error(`'${functionName}' is not a callable function.`);\n  }\n\n  // Parse arguments\n  const parsedArgs = parseArguments(rawArgs);\n\n  // Execute function\n  try {\n    return await fn(...parsedArgs);\n  } catch (error) {\n    throw new Error(`Error executing '${functionName}': ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n","/**\n * Parse command-line arguments into typed values\n * Supports JSON objects/arrays, booleans, numbers, and strings\n */\nexport function parseArguments(rawArgs: string[]): any[] {\n  return rawArgs.map((arg, index) => {\n    // Try to parse as JSON object or array if it looks like JSON\n    if ((arg.startsWith('{') && arg.endsWith('}')) || (arg.startsWith('[') && arg.endsWith(']'))) {\n      try {\n        return JSON.parse(arg);\n      } catch (error) {\n        // If it fails to parse as JSON, treat it as a string\n        // Only throw error if it looks like valid JSON syntax was intended\n        if (arg.includes(':') || arg.includes(',')) {\n          throw new Error(`Invalid JSON in argument ${index + 1}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n        // Otherwise, return as string\n        return arg;\n      }\n    }\n\n    // Parse booleans\n    if (arg === 'true') return true;\n    if (arg === 'false') return false;\n\n    // Parse numbers\n    if (/^-?\\d+(\\.\\d+)?$/.test(arg)) {\n      return Number(arg);\n    }\n\n    // Return as string\n    return arg;\n  });\n}\n","import createSDK from '@eventcatalog/sdk';\n\ninterface CategorizedFunctions {\n  [category: string]: string[];\n}\n\n/**\n * Get all available SDK functions organized by category\n */\nexport function listFunctions(catalogDir: string = '.'): CategorizedFunctions {\n  // Initialize SDK to get all functions\n  const sdk = createSDK(catalogDir);\n\n  // Get all function names from SDK\n  const functionNames = Object.keys(sdk).filter((key) => typeof (sdk as any)[key] === 'function');\n\n  // Categorize functions based on naming patterns\n  const categories: CategorizedFunctions = {\n    Events: [],\n    Commands: [],\n    Queries: [],\n    Channels: [],\n    Services: [],\n    Domains: [],\n    Entities: [],\n    DataStores: [],\n    DataProducts: [],\n    Teams: [],\n    Users: [],\n    'Custom Docs': [],\n    Messages: [],\n    Utilities: [],\n  };\n\n  functionNames.forEach((name) => {\n    if (name.includes('Event')) categories['Events'].push(name);\n    else if (name.includes('Command')) categories['Commands'].push(name);\n    else if (name.includes('Query')) categories['Queries'].push(name);\n    else if (name.includes('Channel')) categories['Channels'].push(name);\n    else if (name.includes('Service')) categories['Services'].push(name);\n    else if (name.includes('Domain')) categories['Domains'].push(name);\n    else if (name.includes('Entity')) categories['Entities'].push(name);\n    else if (name.includes('DataStore')) categories['DataStores'].push(name);\n    else if (name.includes('DataProduct')) categories['DataProducts'].push(name);\n    else if (name.includes('Team')) categories['Teams'].push(name);\n    else if (name.includes('User')) categories['Users'].push(name);\n    else if (name.includes('CustomDoc')) categories['Custom Docs'].push(name);\n    else if (name.includes('Message') || name.includes('Producers') || name.includes('Consumers'))\n      categories['Messages'].push(name);\n    else categories['Utilities'].push(name);\n  });\n\n  // Remove empty categories\n  Object.keys(categories).forEach((key) => {\n    if (categories[key].length === 0) {\n      delete categories[key];\n    }\n  });\n\n  return categories;\n}\n\n/**\n * Format and print categorized functions\n */\nexport function formatListOutput(functions: CategorizedFunctions): string {\n  let output = 'Available EventCatalog SDK Functions:\\n\\n';\n\n  Object.entries(functions).forEach(([category, names]) => {\n    output += `${category}:\\n`;\n    names.sort().forEach((name) => {\n      output += `  - ${name}\\n`;\n    });\n    output += '\\n';\n  });\n\n  return output;\n}\n"],"mappings":";;;AACA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAE9B,IAAM,cAAc,MAAM,cAAc,YAAY,GAAG;AACvD,IAAM,aAAa,MAAM,KAAK,QAAQ,YAAY,CAAC;AAE5C,IAAM,YAA4B,2BAAW;;;ACLpD,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAC7B,SAAS,eAAe;;;ACJxB,SAAS,kBAAkB;;;ACIpB,SAAS,eAAe,SAA0B;AACvD,SAAO,QAAQ,IAAI,CAAC,KAAK,UAAU;AAEjC,QAAK,IAAI,WAAW,GAAG,KAAK,IAAI,SAAS,GAAG,KAAO,IAAI,WAAW,GAAG,KAAK,IAAI,SAAS,GAAG,GAAI;AAC5F,UAAI;AACF,eAAO,KAAK,MAAM,GAAG;AAAA,MACvB,SAAS,OAAO;AAGd,YAAI,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS,GAAG,GAAG;AAC1C,gBAAM,IAAI,MAAM,4BAA4B,QAAQ,CAAC,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,QACpH;AAEA,eAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,QAAQ,OAAQ,QAAO;AAC3B,QAAI,QAAQ,QAAS,QAAO;AAG5B,QAAI,kBAAkB,KAAK,GAAG,GAAG;AAC/B,aAAO,OAAO,GAAG;AAAA,IACnB;AAGA,WAAO;AAAA,EACT,CAAC;AACH;;;AD/BA,OAAO,eAAe;AAKtB,eAAsB,gBAAgB,YAAoB,cAAsB,SAAiC;AAE/G,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,UAAM,IAAI,MAAM,gCAAgC,UAAU,EAAE;AAAA,EAC9D;AAGA,QAAM,MAAM,UAAU,UAAU;AAGhC,MAAI,EAAE,gBAAgB,MAAM;AAC1B,UAAM,IAAI,MAAM,aAAa,YAAY,kEAAkE;AAAA,EAC7G;AAEA,QAAM,KAAM,IAAY,YAAY;AAGpC,MAAI,OAAO,OAAO,YAAY;AAC5B,UAAM,IAAI,MAAM,IAAI,YAAY,+BAA+B;AAAA,EACjE;AAGA,QAAM,aAAa,eAAe,OAAO;AAGzC,MAAI;AACF,WAAO,MAAM,GAAG,GAAG,UAAU;AAAA,EAC/B,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,oBAAoB,YAAY,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,EAChH;AACF;;;AErCA,OAAOA,gBAAe;AASf,SAAS,cAAc,aAAqB,KAA2B;AAE5E,QAAM,MAAMA,WAAU,UAAU;AAGhC,QAAM,gBAAgB,OAAO,KAAK,GAAG,EAAE,OAAO,CAAC,QAAQ,OAAQ,IAAY,GAAG,MAAM,UAAU;AAG9F,QAAM,aAAmC;AAAA,IACvC,QAAQ,CAAC;AAAA,IACT,UAAU,CAAC;AAAA,IACX,SAAS,CAAC;AAAA,IACV,UAAU,CAAC;AAAA,IACX,UAAU,CAAC;AAAA,IACX,SAAS,CAAC;AAAA,IACV,UAAU,CAAC;AAAA,IACX,YAAY,CAAC;AAAA,IACb,cAAc,CAAC;AAAA,IACf,OAAO,CAAC;AAAA,IACR,OAAO,CAAC;AAAA,IACR,eAAe,CAAC;AAAA,IAChB,UAAU,CAAC;AAAA,IACX,WAAW,CAAC;AAAA,EACd;AAEA,gBAAc,QAAQ,CAAC,SAAS;AAC9B,QAAI,KAAK,SAAS,OAAO,EAAG,YAAW,QAAQ,EAAE,KAAK,IAAI;AAAA,aACjD,KAAK,SAAS,SAAS,EAAG,YAAW,UAAU,EAAE,KAAK,IAAI;AAAA,aAC1D,KAAK,SAAS,OAAO,EAAG,YAAW,SAAS,EAAE,KAAK,IAAI;AAAA,aACvD,KAAK,SAAS,SAAS,EAAG,YAAW,UAAU,EAAE,KAAK,IAAI;AAAA,aAC1D,KAAK,SAAS,SAAS,EAAG,YAAW,UAAU,EAAE,KAAK,IAAI;AAAA,aAC1D,KAAK,SAAS,QAAQ,EAAG,YAAW,SAAS,EAAE,KAAK,IAAI;AAAA,aACxD,KAAK,SAAS,QAAQ,EAAG,YAAW,UAAU,EAAE,KAAK,IAAI;AAAA,aACzD,KAAK,SAAS,WAAW,EAAG,YAAW,YAAY,EAAE,KAAK,IAAI;AAAA,aAC9D,KAAK,SAAS,aAAa,EAAG,YAAW,cAAc,EAAE,KAAK,IAAI;AAAA,aAClE,KAAK,SAAS,MAAM,EAAG,YAAW,OAAO,EAAE,KAAK,IAAI;AAAA,aACpD,KAAK,SAAS,MAAM,EAAG,YAAW,OAAO,EAAE,KAAK,IAAI;AAAA,aACpD,KAAK,SAAS,WAAW,EAAG,YAAW,aAAa,EAAE,KAAK,IAAI;AAAA,aAC/D,KAAK,SAAS,SAAS,KAAK,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,WAAW;AAC1F,iBAAW,UAAU,EAAE,KAAK,IAAI;AAAA,QAC7B,YAAW,WAAW,EAAE,KAAK,IAAI;AAAA,EACxC,CAAC;AAGD,SAAO,KAAK,UAAU,EAAE,QAAQ,CAAC,QAAQ;AACvC,QAAI,WAAW,GAAG,EAAE,WAAW,GAAG;AAChC,aAAO,WAAW,GAAG;AAAA,IACvB;AAAA,EACF,CAAC;AAED,SAAO;AACT;AAKO,SAAS,iBAAiB,WAAyC;AACxE,MAAI,SAAS;AAEb,SAAO,QAAQ,SAAS,EAAE,QAAQ,CAAC,CAAC,UAAU,KAAK,MAAM;AACvD,cAAU,GAAG,QAAQ;AAAA;AACrB,UAAM,KAAK,EAAE,QAAQ,CAAC,SAAS;AAC7B,gBAAU,OAAO,IAAI;AAAA;AAAA,IACvB,CAAC;AACD,cAAU;AAAA,EACZ,CAAC;AAED,SAAO;AACT;;;AHpEA,IAAI,UAAU;AACd,IAAI;AACF,QAAM,kBAAkB,QAAQ,WAAW,oBAAoB;AAC/D,QAAM,cAAc,KAAK,MAAM,aAAa,iBAAiB,OAAO,CAAC;AACrE,YAAU,YAAY;AACxB,QAAQ;AAER;AAEA,QACG,KAAK,cAAc,EACnB,YAAY,qCAAqC,EACjD,QAAQ,OAAO,EACf,OAAO,oBAAoB,mEAAmE,GAAG;AAGpG,QACG,QAAQ,MAAM,EACd,YAAY,kCAAkC,EAC9C,OAAO,MAAM;AACZ,MAAI;AACF,UAAM,YAAY,cAAc,GAAG;AACnC,UAAM,SAAS,iBAAiB,SAAS;AACzC,YAAQ,IAAI,MAAM;AAAA,EACpB,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAChG,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF,CAAC;AAGH,QAAQ,UAAU,sBAAsB,EAAE,OAAO,OAAO,cAAsB,SAAmB;AAC/F,MAAI;AACF,UAAM,UAAU,QAAQ,KAAK;AAC7B,UAAM,MAAM,QAAQ,OAAO;AAC3B,UAAM,SAAS,MAAM,gBAAgB,KAAK,cAAc,IAAI;AAC5D,YAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,EAC7C,SAAS,OAAO;AACd,YAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AACpE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF,CAAC;AAED,QAAQ,MAAM,QAAQ,IAAI;AAG1B,IAAI,QAAQ,KAAK,SAAS,GAAG;AAC3B,UAAQ,WAAW;AACrB;","names":["createSDK"]}

package/dist/cli-docs.d.mts

@@ -0,0 +1,43 @@
+/**
+ * CLI Documentation Registry
+ *
+ * This file contains metadata for all SDK functions that can be called via the CLI.
+ * It is used to generate documentation for the EventCatalog website.
+ *
+ * @module cli-docs
+ */
+interface CLIFunctionArg {
+    name: string;
+    type: 'string' | 'json' | 'boolean' | 'number';
+    required: boolean;
+    description: string;
+}
+interface CLIFunctionExample {
+    description: string;
+    command: string;
+}
+interface CLIFunctionDoc {
+    name: string;
+    description: string;
+    category: string;
+    args: CLIFunctionArg[];
+    examples: CLIFunctionExample[];
+}
+/**
+ * All CLI-callable functions with their documentation
+ */
+declare const cliFunctions: CLIFunctionDoc[];
+/**
+ * Get all unique categories
+ */
+declare function getCategories(): string[];
+/**
+ * Get functions by category
+ */
+declare function getFunctionsByCategory(category: string): CLIFunctionDoc[];
+/**
+ * Get a function by name
+ */
+declare function getFunction(name: string): CLIFunctionDoc | undefined;
+
+export { type CLIFunctionArg, type CLIFunctionDoc, type CLIFunctionExample, cliFunctions, getCategories, getFunction, getFunctionsByCategory };

package/dist/cli-docs.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CLI Documentation Registry
+ *
+ * This file contains metadata for all SDK functions that can be called via the CLI.
+ * It is used to generate documentation for the EventCatalog website.
+ *
+ * @module cli-docs
+ */
+interface CLIFunctionArg {
+    name: string;
+    type: 'string' | 'json' | 'boolean' | 'number';
+    required: boolean;
+    description: string;
+}
+interface CLIFunctionExample {
+    description: string;
+    command: string;
+}
+interface CLIFunctionDoc {
+    name: string;
+    description: string;
+    category: string;
+    args: CLIFunctionArg[];
+    examples: CLIFunctionExample[];
+}
+/**
+ * All CLI-callable functions with their documentation
+ */
+declare const cliFunctions: CLIFunctionDoc[];
+/**
+ * Get all unique categories
+ */
+declare function getCategories(): string[];
+/**
+ * Get functions by category
+ */
+declare function getFunctionsByCategory(category: string): CLIFunctionDoc[];
+/**
+ * Get a function by name
+ */
+declare function getFunction(name: string): CLIFunctionDoc | undefined;
+
+export { type CLIFunctionArg, type CLIFunctionDoc, type CLIFunctionExample, cliFunctions, getCategories, getFunction, getFunctionsByCategory };