@ratio-app/cli 0.1.1

package/dist/commands/dev/listen.d.ts

@@ -0,0 +1,84 @@
+import * as _oclif_core_interfaces from '@oclif/core/interfaces';
+import { RatioCommand } from '../../lib/ratio-command.js';
+import { RelayClient } from '../../lib/relay/relay-client.js';
+import { RelayClientOptions } from '../../lib/relay/types.js';
+import '@oclif/core';
+import '../../lib/credentials/store.js';
+import '../../lib/credentials/clock.js';
+import '../../lib/credentials/refresher.js';
+import '../../lib/credentials/types.js';
+import '../../lib/auth/verbose-trace.js';
+
+/** Best-effort pre-connect reachability probe budget for the local target. */
+declare const TARGET_PROBE_TIMEOUT_MS = 2000;
+/** Per-event forward POST budget; slower targets get a timeout failure line. */
+declare const FORWARD_TIMEOUT_MS = 10000;
+/** Upper bound on concurrently in-flight forward POSTs. */
+declare const FORWARD_MAX_INFLIGHT = 32;
+/** Hard cap on waiting for in-flight forwards once the stream has ended. */
+declare const SHUTDOWN_DRAIN_MS = 5000;
+/** A second interrupt inside this window forces an immediate exit (130). */
+declare const SIGNAL_FORCE_EXIT_WINDOW_MS = 2000;
+/** Minimal process-signal surface, injectable so tests never send real signals. */
+interface SignalSource {
+    on(event: 'SIGINT' | 'SIGTERM', listener: () => void): unknown;
+    removeListener(event: 'SIGINT' | 'SIGTERM', listener: () => void): unknown;
+}
+/**
+ * Parse and validate a `--forward-to` value into a URL.
+ *
+ * Accepted: `localhost:3000`, `localhost:3000/webhooks`,
+ * `http://localhost:3000/webhooks`, `127.0.0.1:3000`, `[::1]:3000`,
+ * `::1:3000`. The host must be local (see LOOPBACK_HOSTS), the port must
+ * be explicit, and only plain `http://` is supported. A missing scheme
+ * defaults to `http://`.
+ */
+declare function parseForwardTarget(raw: string): URL;
+/**
+ * Parse a `--events` value into a set of topics. Returns undefined when the
+ * flag was not provided (forward everything). A provided-but-empty value is
+ * an error — it would silently forward nothing.
+ */
+declare function parseEventsFilter(raw: string | undefined): ReadonlySet<string> | undefined;
+/**
+ * Extract the topic string from a webhook event body. The `--events` filter
+ * matches exactly on payload.topic; anything without a string topic is
+ * treated as non-matching when a filter is active.
+ */
+declare function extractTopic(payload: unknown): string | undefined;
+/**
+ * Render one event log line. JSON mode produces a single NDJSON object per
+ * event on its own line; KV mode produces a single `key=value` line.
+ */
+declare function formatEventLine(mode: 'json' | 'kv', seq: number, timestamp: string, topic: string | undefined, status: string): string;
+declare class DevListen extends RatioCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'forward-to': _oclif_core_interfaces.OptionFlag<string, _oclif_core_interfaces.CustomOptions>;
+        events: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
+        'app-id': _oclif_core_interfaces.OptionFlag<string, _oclif_core_interfaces.CustomOptions>;
+        json: _oclif_core_interfaces.BooleanFlag<boolean>;
+        verbose: _oclif_core_interfaces.BooleanFlag<boolean>;
+    };
+    writeOut: (chunk: string) => void;
+    writeErr: (chunk: string) => void;
+    signalSource: SignalSource;
+    hardExit: (code: number) => void;
+    makeRelayClient: (options: RelayClientOptions) => RelayClient;
+    run(): Promise<void>;
+    /**
+     * Best-effort reachability probe of the forward target. Never throws and
+     * never blocks the session: a dead target only produces a warning, because
+     * the user may start their local server after this command boots.
+     */
+    private probeTarget;
+    /**
+     * POST one event body to the local target. Resolves to a status token —
+     * `ok:<status>` or `err:<reason>` — and NEVER rejects: a failed forward
+     * is logged and dropped so the stream keeps flowing.
+     */
+    private forwardOnce;
+}
+
+export { FORWARD_MAX_INFLIGHT, FORWARD_TIMEOUT_MS, SHUTDOWN_DRAIN_MS, SIGNAL_FORCE_EXIT_WINDOW_MS, TARGET_PROBE_TIMEOUT_MS, DevListen as default, extractTopic, formatEventLine, parseEventsFilter, parseForwardTarget };