@basis-theory-labs/cli 4.2.0 → 4.4.0

package/dist/commands/reactors/logs/tail.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+const runtime_1 = require("../../../logs/runtime");
+const time_1 = require("../../../logs/time");
+class Tail extends base_1.BaseCommand {
+    async run() {
+        const now = Date.now();
+        const { flags: { 'management-key': apiKey, 'api-base-url': apiBaseUrl, 'trace-id': traceId, format, since, }, args: { id }, } = await this.parse(Tail);
+        if (!id.trim()) {
+            this.error('Reactor id must not be blank');
+        }
+        if (traceId !== undefined && !traceId.trim()) {
+            this.error('--trace-id must not be blank');
+        }
+        await (0, runtime_1.followEventLogs)({
+            apiKey,
+            apiBaseUrl,
+            resourceType: 'reactor',
+            resourceId: id,
+            traceId,
+            format: format,
+            window: (0, time_1.resolveTailWindow)({ since }, now),
+        });
+        // Cleanup has completed. Oclif's final flush would stall on a pending write.
+        if (process.stdout.writableLength > 0 && process.exitCode !== undefined) {
+            this.exit(process.exitCode);
+        }
+    }
+}
+exports.default = Tail;
+Tail.description = 'Tail Reactor runtime logs through Events. Requires `event:read` and runtime logging already enabled.\n\n' +
+    'Optional --trace-id matches the effective stored BT trace ID exactly and case-sensitively. A submitted header may be sanitized by Vault; the CLI does not normalize or trim it. A reused trace ID can match multiple invocations.\n\n' +
+    'Starts watching from command time, regardless of filters. Supply --since to retrieve initial history before following new logs. Polls every five seconds with a rolling five-minute overlap that never reaches before the requested start. Time windows filter event batches, not individual record occurrence times; a newly arriving batch can contain records that occurred before command start. History is limited by server retention and tenant entitlements; the API clamps unavailable history. Large initial windows may hit bounded work limits and fail with partial output. Visibility is delayed and best-effort; output has no durable resume or global chronological ordering. Application logs come from the injected `logger`, not arbitrary stdout or `console.log`; collection requires resource opt-in and the platform runtime-log gate. Silence does not distinguish an idle resource, a wrong ID or filter, disabled collection, or delayed indexing. Runs until interrupted, output closes, or an error occurs.';
+Tail.examples = [
+    '<%= config.bin %> reactors logs tail 03858bf5-32d3-4a2e-b74b-daeea0883bca',
+    '<%= config.bin %> reactors logs tail 03858bf5-32d3-4a2e-b74b-daeea0883bca --trace-id customer_Order-42',
+    '<%= config.bin %> reactors logs tail 03858bf5-32d3-4a2e-b74b-daeea0883bca --trace-id customer_Order-42 --since 30m --format json',
+    '<%= config.bin %> reactors logs tail 03858bf5-32d3-4a2e-b74b-daeea0883bca --since 30m --format json',
+];
+Tail.args = {
+    id: core_1.Args.string({
+        description: 'Reactor id',
+        required: true,
+    }),
+};
+Tail.flags = {
+    'trace-id': core_1.Flags.string({
+        description: 'exact, case-sensitive stored BT trace ID',
+    }),
+    since: core_1.Flags.string({
+        description: 'include initial history from a positive duration (30s, 5m, 2h, 1d, 1w) or ISO timestamp with timezone; omitted means watch from command start',
+    }),
+    format: core_1.Flags.string({
+        description: 'pretty: readable logs; json: compact objects; json-pretty: indented objects. Entries are separated by blank lines; colors are enabled in terminals',
+        options: ['pretty', 'json', 'json-pretty'],
+        default: 'pretty',
+    }),
+};

package/dist/commands/reactors/logs.js

@@ -19,7 +19,7 @@ class Logs extends base_1.BaseCommand {
     }
 }
 exports.default = Logs;
-Logs.description = 'Display live Reactor logs output. Requires `reactor:update` Management Application permissions';
+Logs.description = 'Legacy tunnel-based Reactor logs. Opens a local tunnel and updates logging configuration. For v2/runtime debugging, use `bt reactors logs tail <id>` or `bt reactors logs read <id>`. Requires `reactor:update` Management Application permissions';
 Logs.examples = [
     '<%= config.bin %> <%= command.id %>',
     '<%= config.bin %> <%= command.id %> 03858bf5-32d3-4a2e-b74b-daeea0883bca',

package/dist/logs/events.d.ts

@@ -0,0 +1,60 @@
+type ResourceType = 'reactor' | 'proxy';
+interface EventLogRecord {
+    event_id: string;
+    event_type: string;
+    event_timestamp: string;
+    tenant_id: string;
+    trace_id?: string;
+    resource_type: ResourceType;
+    resource_id: string;
+    invocation_id: string;
+    transform_type?: 'request_transform' | 'response_transform';
+    occurred_at: string;
+    sequence: number;
+    source: 'application' | 'platform';
+    record_type: 'log' | 'lifecycle';
+    level?: string;
+    message?: string | null;
+    attributes?: Record<string, unknown>;
+    error?: {
+        type: string;
+        message: string;
+        stack_trace?: string;
+    };
+    event?: string;
+    outcome?: string;
+    duration_ms?: number;
+}
+interface EventLogFilters {
+    traceId?: string;
+    transformType?: EventLogRecord['transform_type'];
+}
+interface EventLogPage {
+    batches: EventLogRecord[][];
+    next: string | null;
+}
+declare class EventsReadError extends Error {
+    readonly retryable: boolean;
+    readonly retryAfterMs?: number;
+    constructor(message: string, options?: {
+        retryable?: boolean;
+        retryAfterMs?: number;
+    });
+}
+/** Resolve and validate the API origin before any credential is sent. */
+declare const resolveEventsOrigin: (apiBaseUrl?: string) => string;
+interface ReadEventPageOptions extends EventLogFilters {
+    origin: string;
+    apiKey: string;
+    resourceType: ResourceType;
+    resourceId: string;
+    start: number;
+    end: number;
+    cursor?: string;
+    signal: AbortSignal;
+    onBytes: (bytes: number) => void;
+}
+/** Read and validate one Events page. Continuations contain only the opaque cursor. */
+declare const readEventPage: (options: ReadEventPageOptions) => Promise<EventLogPage>;
+export type { EventLogFilters, EventLogPage, EventLogRecord, ReadEventPageOptions, ResourceType, };
+export { EventsReadError, readEventPage, resolveEventsOrigin };