sfscanner 0.0.0-stage → 0.2.0

package/dist/v2/batch-runner.d.ts

@@ -0,0 +1,50 @@
+import { type ScannerLimitsV2 } from '@hub/contracts';
+import type { ScanWorkflowV2FailureCode, ScanWorkflowV2Result } from '@hub/scanner-core/v2';
+import { type ScanConfigV2 } from './config';
+import { type CliStdin, type InputReadHost, type ReadInputResult } from './input-read';
+import type { SelectedInputV2 } from './input-selection';
+import { type ScanWorkerFactory } from './scan-worker-host';
+import { type SigintSource } from './worker-host';
+export type BatchErrorCodeV2 = ScanWorkflowV2FailureCode | 'INPUT_READ_FAILED';
+export type BatchItemStatusV2 = 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMEOUT';
+export type BatchItemV2 = Readonly<{
+    label: string;
+    status: BatchItemStatusV2;
+    result?: ScanWorkflowV2Result;
+    error?: Readonly<{
+        code: BatchErrorCodeV2;
+    }>;
+}>;
+export type BatchResultV2 = Readonly<{
+    ok: true;
+    items: readonly BatchItemV2[];
+    cancelled: boolean;
+    completed: number;
+    failed: number;
+    concurrency: number;
+}> | Readonly<{
+    ok: false;
+    code: 'INVALID_CONFIG' | 'CANCELLED';
+    message: string;
+}>;
+export type BatchScanV2 = (bytes: Uint8Array, item: SelectedInputV2) => ScanWorkflowV2Result | PromiseLike<ScanWorkflowV2Result>;
+export type BatchReadV2 = (item: SelectedInputV2) => Uint8Array | ReadInputResult | PromiseLike<Uint8Array | ReadInputResult>;
+export type BatchRunnerInput = Readonly<{
+    items: readonly SelectedInputV2[];
+    config: ScanConfigV2;
+    scan?: BatchScanV2;
+    read?: BatchReadV2;
+    stdin?: CliStdin;
+    readHost?: InputReadHost;
+    baseDirectory?: string;
+    maxInputBytes?: number;
+    limitsDocument?: ScannerLimitsV2;
+    targetDocument?: unknown;
+    approvedDomains?: readonly string[];
+    scanWorker?: ScanWorkerFactory;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    sigint?: SigintSource;
+    now?: () => number;
+}>;
+export declare function runBatchV2(input: BatchRunnerInput): Promise<BatchResultV2>;

package/dist/v2/cli-runner-internal.d.ts

@@ -0,0 +1,28 @@
+import type { CliStdin, InputReadHost } from './input-read';
+import { type InputSelectionHost } from './input-selection';
+import type { CliCommandV2 } from './arguments';
+import { type BatchReadV2, type BatchScanV2 } from './batch-runner';
+import { type CliEnvelopeV2 } from './json-output';
+import { type ExitCodeV2 } from './exit-reducer';
+import type { SigintSource } from './worker-host';
+export type V2CliRunOptions = Readonly<{
+    cwd?: string;
+    stdin?: CliStdin;
+    signal?: AbortSignal;
+    read?: BatchReadV2;
+    scan?: BatchScanV2;
+    readHost?: InputReadHost;
+    selectionHost?: InputSelectionHost;
+    sigint?: SigintSource;
+}>;
+export type V2CliRunResult = Readonly<{
+    exitCode: ExitCodeV2;
+    stdout: string;
+    stderr: string;
+    document?: CliEnvelopeV2 | string;
+}>;
+type ScanCommand = Extract<CliCommandV2, {
+    kind: 'scan';
+}>;
+export declare function runCliV2Internal(command: ScanCommand, options?: V2CliRunOptions): Promise<V2CliRunResult>;
+export {};

package/dist/v2/cli-runner.d.ts

@@ -0,0 +1,22 @@
+import type { CliCommandV2 } from './arguments.js';
+/** The scan member only: the internal runner does not dispatch metadata commands. */
+export type PublicScanCommandV2 = Extract<CliCommandV2, {
+    kind: 'scan';
+}>;
+export type PublicRunOptionsV2 = Readonly<{
+    cwd?: string;
+    stdin?: string | Uint8Array | AsyncIterable<Uint8Array | string>;
+    signal?: AbortSignal;
+}>;
+export type PublicRunResultV2 = Readonly<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    document?: unknown;
+}>;
+/**
+ * Library entry. The `sfscanner` bin remains the side-effecting CLI; this wrapper forwards only
+ * the three consumer options, so an internal read/scan/selection hook is never part of the
+ * published surface.
+ */
+export declare function runCliV2(command: PublicScanCommandV2, options?: PublicRunOptionsV2): Promise<PublicRunResultV2>;