@hasna/events 0.1.3 → 0.1.5

package/dist/cli/index.d.ts

@@ -1,2 +1,6 @@
 #!/usr/bin/env bun
-export {};
+export interface RunEventsCliOptions {
+    programName?: string;
+    source?: string;
+}
+export declare function runEventsCli(argv?: string[], options?: RunEventsCliOptions): Promise<void>;

package/dist/cli/index.js

@@ -631,26 +631,72 @@ function output(parsed, value, human) {
   }
   human();
 }
-function printHelp() {
-  console.log(`events ${version()}
+function commandName(options) {
+  return options.programName ?? "events";
+}
+function printHelp(options = {}) {
+  const name = commandName(options);
+  console.log(`${name} ${version()}
 
 Usage:
-  events [--dir <path>] [--json] webhooks add <url|command> [options]
-  events [--dir <path>] [--json] webhooks list
-  events [--dir <path>] [--json] webhooks remove <id>
-  events [--dir <path>] [--json] webhooks test <id>
-  events [--dir <path>] [--json] events emit <type> --source <source> [options]
-  events [--dir <path>] [--json] events list [--limit <n>]
-  events [--dir <path>] [--json] events replay [--id <event-id>] [--dry-run]
+  ${name} [--dir <path>] [--json] webhooks add <url|command> [options]
+  ${name} [--dir <path>] [--json] webhooks list
+  ${name} [--dir <path>] [--json] webhooks remove <id>
+  ${name} [--dir <path>] [--json] webhooks test <id>
+  ${name} [--dir <path>] [--json] events emit <type>${options.source ? "" : " --source <source>"} [options]
+  ${name} [--dir <path>] [--json] events list [--limit <n>]
+  ${name} [--dir <path>] [--json] events replay [--id <event-id>] [--dry-run]
 
 Environment:
   HASNA_EVENTS_DIR or HASNA_EVENTS_HOME overrides the default ${getEventsDataDir()}`);
 }
-async function main(argv = process.argv.slice(2)) {
+function printWebhooksHelp(options = {}) {
+  const name = commandName(options);
+  console.log(`${name} webhooks
+
+Usage:
+  ${name} [--dir <path>] [--json] webhooks add <url|command> [options]
+  ${name} [--dir <path>] [--json] webhooks list
+  ${name} [--dir <path>] [--json] webhooks remove <id>
+  ${name} [--dir <path>] [--json] webhooks test <id>
+
+Options:
+  --id <id>                 Channel id for add
+  --type <pattern>          Event type filter, supports wildcards
+  --source <source>         Event source filter
+  --subject <subject>       Event subject filter
+  --severity <severity>     Event severity filter
+  --transport <kind>        webhook or command
+  --secret <secret>         Webhook signing secret
+  --header <name=value>     Webhook header, repeatable
+  --redact <path>           Redaction path, repeatable
+  --no-deliver              Available on events emit`);
+}
+function printEventsHelp(options = {}) {
+  const name = commandName(options);
+  console.log(`${name} events
+
+Usage:
+  ${name} [--dir <path>] [--json] events emit <type>${options.source ? "" : " --source <source>"} [options]
+  ${name} [--dir <path>] [--json] events list [--limit <n>]
+  ${name} [--dir <path>] [--json] events replay [--id <event-id>] [--dry-run]
+
+Options:
+  --source <source>         Event source${options.source ? ` (default: ${options.source})` : ""}
+  --subject <subject>       Event subject
+  --severity <severity>     Event severity
+  --message <message>       Human-readable event message
+  --dedupe-key <key>        Deduplicate repeated events
+  --data <json>             JSON object payload
+  --metadata <json>         JSON object metadata
+  --no-deliver              Record without delivering webhooks
+  --dry-run                 Preview replay matches without delivery`);
+}
+async function runEventsCli(argv = process.argv.slice(2), options = {}) {
   const parsed = parseGlobalArgs(argv);
   const [group, command, ...tail] = parsed.rest;
   if (!group || group === "--help" || group === "-h") {
-    printHelp();
+    printHelp(options);
     return;
   }
   if (group === "--version" || group === "-v") {
@@ -660,16 +706,24 @@ async function main(argv = process.argv.slice(2)) {
   const store = new JsonEventsStore(parsed.dir);
   const client = new EventsClient({ store });
   if (group === "webhooks") {
-    await handleWebhooks(client, command, tail, parsed);
+    if (!command || command === "--help" || command === "-h") {
+      printWebhooksHelp(options);
+      return;
+    }
+    await handleWebhooks(client, command, tail, parsed, options);
     return;
   }
   if (group === "events") {
-    await handleEvents(client, command, tail, parsed);
+    if (!command || command === "--help" || command === "-h") {
+      printEventsHelp(options);
+      return;
+    }
+    await handleEvents(client, command, tail, parsed, options);
     return;
   }
   throw new Error(`Unknown command group: ${group}`);
 }
-async function handleWebhooks(client, command, tail, parsed) {
+async function handleWebhooks(client, command, tail, parsed, options) {
   if (command === "add") {
     const args = [...tail];
     const transport = takeOption(args, "--transport") ?? "webhook";
@@ -737,7 +791,7 @@ async function handleWebhooks(client, command, tail, parsed) {
     if (!id)
       throw new Error("webhooks test requires a channel id");
     const result = await client.testChannel(id, {
-      source: takeOption(args, "--source") ?? "hasna.events",
+      source: takeOption(args, "--source") ?? options.source ?? "hasna.events",
       type: takeOption(args, "--type") ?? "events.test",
       subject: takeOption(args, "--subject") ?? id,
       data: parseJsonOption(takeOption(args, "--data"), { test: true })
@@ -747,13 +801,13 @@ async function handleWebhooks(client, command, tail, parsed) {
   }
   throw new Error(`Unknown webhooks command: ${command ?? ""}`);
 }
-async function handleEvents(client, command, tail, parsed) {
+async function handleEvents(client, command, tail, parsed, options) {
   if (command === "emit") {
     const args = [...tail];
     const type = args.shift();
     if (!type)
       throw new Error("events emit requires an event type");
-    const source = takeOption(args, "--source");
+    const source = takeOption(args, "--source") ?? options.source;
     if (!source)
       throw new Error("events emit requires --source");
     const noDeliver = takeFlag(args, "--no-deliver");
@@ -822,13 +876,18 @@ function severityOption(value) {
     throw new Error(`Invalid severity: ${value}`);
   return value;
 }
-main().catch((error) => {
-  const parsed = parseGlobalArgs(process.argv.slice(2));
-  const message = error instanceof Error ? error.message : String(error);
-  if (parsed.json) {
-    console.log(JSON.stringify({ error: message }, null, 2));
-  } else {
-    console.error(message);
-  }
-  process.exit(1);
-});
+if (import.meta.main) {
+  runEventsCli().catch((error) => {
+    const parsed = parseGlobalArgs(process.argv.slice(2));
+    const message = error instanceof Error ? error.message : String(error);
+    if (parsed.json) {
+      console.log(JSON.stringify({ error: message }, null, 2));
+    } else {
+      console.error(message);
+    }
+    process.exit(1);
+  });
+}
+export {
+  runEventsCli
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/events",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Shared event envelopes, local subscriptions, and webhook delivery for Hasna open-source apps",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,6 +33,10 @@
     "./commander": {
       "types": "./dist/commander.d.ts",
       "import": "./dist/commander.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js"
     }
   },
   "files": [