@basis-theory-labs/cli 4.1.0 → 4.3.0

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

@@ -0,0 +1,56 @@
+"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 Read extends base_1.BaseCommand {
+    async run() {
+        const now = Date.now();
+        const { flags: { 'management-key': apiKey, 'api-base-url': apiBaseUrl, format, since, until, }, args: { id }, } = await this.parse(Read);
+        if (!id.trim()) {
+            this.error('Reactor id must not be blank');
+        }
+        await (0, runtime_1.readEventLogs)({
+            apiKey,
+            apiBaseUrl,
+            resourceType: 'reactor',
+            resourceId: id,
+            format: format,
+            window: (0, time_1.resolveLogWindow)({
+                since,
+                until,
+            }, 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 = Read;
+Read.description = 'Read a fixed window of Reactor runtime logs through Events and exit. Requires `event:read` and runtime logging already enabled.\n\n' +
+    'Defaults to the five minutes preceding --until, or command start when --until is omitted. Explicit relative values use command-start time. Windows include their start and exclude their end, filtering event batch timestamps rather than individual record occurrence times. Each matching batch is expanded in record sequence; flattened output has no global chronological ordering. History is tenant-limited (24 hours by default, at most 30 days); the API clamps unavailable history. Indexing is asynchronous and pagination is not a snapshot, so empty or exhausted results do not prove complete coverage. Large windows may hit bounded work limits and fail with partial output. Application logs come from the injected `logger`, not arbitrary stdout or `console.log`; collection requires resource opt-in and the platform runtime-log gate. Does not enable logging or open a tunnel.';
+Read.examples = [
+    '<%= config.bin %> reactors logs read 03858bf5-32d3-4a2e-b74b-daeea0883bca --since 1h --until 30m',
+    '<%= config.bin %> reactors logs read 03858bf5-32d3-4a2e-b74b-daeea0883bca --since 2026-10-01T10:00:00Z --until 2026-10-01T10:15:00Z --format json',
+];
+Read.args = {
+    id: core_1.Args.string({
+        description: 'Reactor id',
+        required: true,
+    }),
+};
+Read.flags = {
+    since: core_1.Flags.string({
+        description: 'window start: positive duration (30s, 5m, 2h, 1d, 1w) or ISO timestamp with timezone; defaults to five minutes before the end',
+    }),
+    until: core_1.Flags.string({
+        description: 'window end (exclusive): positive duration or ISO timestamp with timezone; defaults to 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/tail.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base';
+export default class Tail extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        since: import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        format: import("@oclif/core/lib/interfaces/parser").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,50 @@
+"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, format, since, }, args: { id }, } = await this.parse(Tail);
+        if (!id.trim()) {
+            this.error('Reactor id must not be blank');
+        }
+        await (0, runtime_1.followEventLogs)({
+            apiKey,
+            apiBaseUrl,
+            resourceType: 'reactor',
+            resourceId: id,
+            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' +
+    'Starts watching from command time. 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 tenant-limited (24 hours by default, at most 30 days); 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, 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 --since 30m --format json',
+];
+Tail.args = {
+    id: core_1.Args.string({
+        description: 'Reactor id',
+        required: true,
+    }),
+};
+Tail.flags = {
+    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,56 @@
+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 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 {
+    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 { EventLogPage, EventLogRecord, ReadEventPageOptions, ResourceType, };
+export { EventsReadError, readEventPage, resolveEventsOrigin };