reflection-check 0.0.1

package/dist/core/config.js

@@ -0,0 +1,159 @@
+import { access } from 'node:fs/promises';
+import { extname, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { createJiti } from 'jiti';
+import { z } from 'zod';
+export const runModes = ['smoke', 'design', 'visual', 'full'];
+const BrowserExpectationSchema = z.union([
+    z.object({ urlIncludes: z.string() }),
+    z.object({ urlEquals: z.string() }),
+    z.object({ role: z.string(), name: z.string().optional() }),
+    z.object({ label: z.string() }),
+    z.object({ text: z.string() }),
+    z.object({ noText: z.string() }),
+    z.object({ selector: z.string() }),
+    z.object({ elementVisible: z.string() }),
+    z.object({ elementNotVisible: z.string() }),
+    z.object({ noHorizontalOverflow: z.literal(true) }),
+    z.object({ noConsoleErrors: z.literal(true) }),
+    z.object({ screenshot: z.string() })
+]);
+const VisualThresholdSchema = z.object({
+    maxDiffPixels: z.number().int().nonnegative().optional(),
+    maxDiffPixelRatio: z.number().min(0).max(1).optional()
+});
+const RouteVisualSmokeCaseSchema = z.object({
+    id: z.string().min(1),
+    route: z.string().min(1),
+    viewport: z.string().min(1),
+    baseline: z.string().min(1),
+    baselineRoot: z.string().optional(),
+    threshold: VisualThresholdSchema.optional(),
+    blocking: z.boolean().optional(),
+    strict: z.boolean().optional()
+});
+const BrowserRouteSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().optional(),
+    path: z.string().min(1),
+    viewports: z.array(z.string().min(1)).default(['desktop']),
+    expects: z.array(BrowserExpectationSchema).default([])
+});
+const BrowserContractSchema = z.object({
+    enabled: z.boolean().default(true),
+    blocking: z.boolean().default(true),
+    baseUrl: z.string().url(),
+    server: z
+        .object({
+        command: z.string(),
+        readyUrl: z.string().url(),
+        reuseExisting: z.boolean().default(true),
+        timeoutMs: z.number().int().positive().default(60_000)
+    })
+        .optional(),
+    routes: z.array(BrowserRouteSchema).default([]),
+    maskSelectors: z.array(z.string().min(1)).default([]),
+    visualSmoke: z.array(RouteVisualSmokeCaseSchema).default([])
+});
+const DesignCommandSchema = z.object({
+    id: z.string().min(1),
+    command: z.string().min(1),
+    cwd: z.string().min(1).optional(),
+    blocking: z.boolean().optional()
+});
+const DesignContractSchema = z.object({
+    enabled: z.boolean().default(true),
+    commands: z.array(DesignCommandSchema).default([])
+});
+const ComponentBrowserStateSchema = z
+    .object({
+    kind: z.enum(['hover', 'focus']),
+    selector: z.string().min(1),
+    animationStabilization: z.object({
+        disableAnimations: z.boolean().optional(),
+        waitMs: z.number().int().nonnegative().max(5_000).optional()
+    })
+})
+    .superRefine((value, context) => {
+    if (value.animationStabilization.disableAnimations !== true && (value.animationStabilization.waitMs ?? 0) <= 0) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['animationStabilization'],
+            message: 'browser-forced pseudo states require effective animation stabilization'
+        });
+    }
+});
+const ComponentVisualCaseSchema = z.object({
+    id: z.string().min(1),
+    storyId: z.string().min(1),
+    viewport: z.string().min(1).default('component'),
+    baseline: z.string().min(1),
+    baselineRoot: z.string().optional(),
+    threshold: VisualThresholdSchema.optional(),
+    blocking: z.boolean().optional(),
+    strict: z.boolean().optional(),
+    stateNote: z.string().min(1).optional(),
+    browserState: ComponentBrowserStateSchema.optional()
+});
+const ComponentContractSchema = z.object({
+    enabled: z.boolean().default(true),
+    storybook: z.object({
+        command: z.string(),
+        readyUrl: z.string().url(),
+        reuseExisting: z.boolean().default(true),
+        timeoutMs: z.number().int().positive().default(60_000)
+    }),
+    cases: z.array(ComponentVisualCaseSchema).default([])
+});
+const ReflectionConfigSchema = z.object({
+    project: z.string().min(1),
+    run: z
+        .object({
+        defaultMode: z.enum(runModes).default('smoke'),
+        ciMode: z.enum(runModes).default('smoke')
+    })
+        .default({ defaultMode: 'smoke', ciMode: 'smoke' }),
+    contracts: z.object({
+        browser: BrowserContractSchema.optional(),
+        design: DesignContractSchema.optional(),
+        component: ComponentContractSchema.optional(),
+        visual: z.unknown().optional()
+    })
+});
+export function isRunMode(value) {
+    return runModes.includes(value);
+}
+export function validateReflectionConfig(input) {
+    const parsed = ReflectionConfigSchema.safeParse(input);
+    if (!parsed.success) {
+        const details = parsed.error.issues.map((issue) => `${issue.path.join('.') || 'config'}: ${issue.message}`).join('; ');
+        throw new Error(`Invalid Reflection config: ${details}`);
+    }
+    return parsed.data;
+}
+export async function loadReflectionConfig(configPath) {
+    const resolvedConfigPath = resolve(configPath);
+    try {
+        await access(resolvedConfigPath);
+    }
+    catch {
+        throw new Error(`Reflection config not found: ${configPath}`);
+    }
+    const module = await importConfigModule(resolvedConfigPath);
+    if (!('default' in module)) {
+        throw new Error(`Reflection config must use a default export: ${configPath}`);
+    }
+    return validateReflectionConfig(module.default);
+}
+async function importConfigModule(configPath) {
+    const extension = extname(configPath);
+    if (extension === '.ts' || extension === '.mts' || extension === '.cts') {
+        const jiti = createJiti(import.meta.url, { moduleCache: false });
+        const config = await jiti.import(configPath, { default: true });
+        return { default: config };
+    }
+    const configUrl = pathToFileURL(configPath);
+    configUrl.searchParams.set('reflectionLoad', Date.now().toString());
+    return (await import(configUrl.href));
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/define-reflection.d.ts

@@ -0,0 +1,2 @@
+import type { ReflectionConfigInput } from './config.js';
+export declare function defineReflection(config: ReflectionConfigInput): ReflectionConfigInput;

package/dist/core/define-reflection.js

@@ -0,0 +1,4 @@
+export function defineReflection(config) {
+    return config;
+}
+//# sourceMappingURL=define-reflection.js.map

package/dist/core/define-reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-reflection.js","sourceRoot":"","sources":["../../src/core/define-reflection.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/exit-codes.d.ts

@@ -0,0 +1,7 @@
+export declare enum ExitCode {
+    Success = 0,
+    BlockingFailure = 1,
+    ToolOrConfigError = 2,
+    InvalidUsage = 64,
+    MissingDependency = 69
+}

package/dist/core/exit-codes.js

@@ -0,0 +1,9 @@
+export var ExitCode;
+(function (ExitCode) {
+    ExitCode[ExitCode["Success"] = 0] = "Success";
+    ExitCode[ExitCode["BlockingFailure"] = 1] = "BlockingFailure";
+    ExitCode[ExitCode["ToolOrConfigError"] = 2] = "ToolOrConfigError";
+    ExitCode[ExitCode["InvalidUsage"] = 64] = "InvalidUsage";
+    ExitCode[ExitCode["MissingDependency"] = 69] = "MissingDependency";
+})(ExitCode || (ExitCode = {}));
+//# sourceMappingURL=exit-codes.js.map

package/dist/core/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/core/exit-codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6CAAW,CAAA;IACX,6DAAmB,CAAA;IACnB,iEAAqB,CAAA;IACrB,wDAAiB,CAAA;IACjB,kEAAsB,CAAA;AACxB,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB"}

package/dist/core/failure-classifier.d.ts

@@ -0,0 +1,3 @@
+import type { CheckResult } from './report-schema.js';
+export type FailureClass = 'route-failure' | 'auth-gate-failure' | 'dom-contract-failure' | 'accessibility-contract-failure' | 'layout-overflow' | 'console-error' | 'network-error' | 'visual-diff' | 'component-drift' | 'environment-mismatch' | 'missing-baseline' | 'flaky-unstable-screenshot' | 'artifact-redaction-warning' | 'tool-error';
+export declare function classifyFailure(check: CheckResult): FailureClass | undefined;

package/dist/core/failure-classifier.js

@@ -0,0 +1,19 @@
+export function classifyFailure(check) {
+    if (check.status !== 'fail' && check.status !== 'error') {
+        return undefined;
+    }
+    if (check.metadata.failureClass && typeof check.metadata.failureClass === 'string') {
+        return check.metadata.failureClass;
+    }
+    if (check.status === 'error') {
+        return 'tool-error';
+    }
+    if (check.suite === 'visual') {
+        return 'visual-diff';
+    }
+    if (check.suite === 'environment') {
+        return 'environment-mismatch';
+    }
+    return 'dom-contract-failure';
+}
+//# sourceMappingURL=failure-classifier.js.map

package/dist/core/failure-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-classifier.js","sourceRoot":"","sources":["../../src/core/failure-classifier.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnF,OAAO,KAAK,CAAC,QAAQ,CAAC,YAA4B,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QAClC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC"}

package/dist/core/gc.d.ts

@@ -0,0 +1,19 @@
+export type GcRun = {
+    runId: string;
+    path: string;
+};
+export type GcSkippedRun = GcRun & {
+    reason: string;
+};
+export type GcPlan = {
+    reportDir: string;
+    runsDir: string;
+    dryRun: boolean;
+    eligible: GcRun[];
+    skipped: GcSkippedRun[];
+    deleted: GcRun[];
+};
+export declare function collectGarbage(options?: {
+    reportDir?: string;
+    dryRun?: boolean;
+}): Promise<GcPlan>;

package/dist/core/gc.js

@@ -0,0 +1,161 @@
+import { lstat, readdir, readFile, realpath, rm } from 'node:fs/promises';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { z } from 'zod';
+const RunManifestSchema = z.object({
+    schemaVersion: z.literal(1),
+    runId: z.string().min(1),
+    createdAt: z.string().datetime(),
+    project: z.string().min(1),
+    status: z.enum(['pass', 'fail', 'pass-with-review', 'error']),
+    mode: z.enum(['smoke', 'design', 'visual', 'full']),
+    ci: z.boolean(),
+    retention: z.object({ pinned: z.boolean() }),
+    files: z.array(z.object({
+        path: z.string().min(1),
+        type: z.enum(['report', 'screenshot', 'image', 'visual-diff', 'trace', 'video', 'log', 'metadata']),
+        bytes: z.number().int().nonnegative().optional(),
+        sha256: z.string().regex(/^[a-f0-9]{64}$/).optional()
+    }))
+});
+export async function collectGarbage(options = {}) {
+    const reportDir = resolve(options.reportDir ?? '.reflection');
+    const runsDir = resolve(reportDir, 'runs');
+    ensureInside(reportDir, runsDir);
+    const dryRun = options.dryRun !== false;
+    const plan = { reportDir, runsDir, dryRun, eligible: [], skipped: [], deleted: [] };
+    const realReportDir = await realpath(reportDir);
+    const realRunsDir = await inspectRunsDirectory(runsDir, realReportDir);
+    if (realRunsDir === undefined) {
+        return plan;
+    }
+    let entries;
+    try {
+        entries = await readdir(runsDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isNodeError(error, 'ENOENT')) {
+            return plan;
+        }
+        throw error;
+    }
+    for (const entry of entries) {
+        if (entry.name === 'latest') {
+            continue;
+        }
+        const runDir = resolve(runsDir, entry.name);
+        ensureInside(runsDir, runDir);
+        const entryStats = await lstat(runDir);
+        if (!entryStats.isDirectory() && !entryStats.isSymbolicLink()) {
+            plan.skipped.push({ runId: entry.name, path: runDir, reason: 'not a run directory' });
+            continue;
+        }
+        const safetyIssue = await getRunSafetyIssue({ realRunsDir, runDir });
+        if (safetyIssue) {
+            plan.skipped.push({ runId: entry.name, path: runDir, reason: safetyIssue });
+            continue;
+        }
+        const manifestResult = await readRunManifest(runDir);
+        if (!manifestResult.ok) {
+            plan.skipped.push({ runId: entry.name, path: runDir, reason: manifestResult.reason });
+            continue;
+        }
+        if (manifestResult.manifest.runId !== entry.name) {
+            plan.skipped.push({ runId: entry.name, path: runDir, reason: `manifest runId mismatch: ${manifestResult.manifest.runId}` });
+            continue;
+        }
+        if (manifestResult.manifest.retention.pinned) {
+            plan.skipped.push({ runId: entry.name, path: runDir, reason: 'run is pinned' });
+            continue;
+        }
+        plan.eligible.push({ runId: entry.name, path: runDir });
+    }
+    if (!dryRun) {
+        for (const run of plan.eligible) {
+            const safetyIssue = await getRunSafetyIssue({ realRunsDir, runDir: run.path });
+            if (safetyIssue) {
+                plan.skipped.push({ ...run, reason: `became unsafe before deletion: ${safetyIssue}` });
+                continue;
+            }
+            await rm(run.path, { recursive: true, force: false });
+            plan.deleted.push(run);
+        }
+    }
+    return plan;
+}
+async function inspectRunsDirectory(runsDir, realReportDir) {
+    try {
+        const stats = await lstat(runsDir);
+        if (stats.isSymbolicLink()) {
+            throw new Error(`Refusing to garbage collect through a symlinked runs directory: ${runsDir}`);
+        }
+        if (!stats.isDirectory()) {
+            throw new Error(`Reflection runs path is not a directory: ${runsDir}`);
+        }
+    }
+    catch (error) {
+        if (isNodeError(error, 'ENOENT')) {
+            return undefined;
+        }
+        throw error;
+    }
+    const realRunsDir = await realpath(runsDir);
+    if (!isInside(realReportDir, realRunsDir)) {
+        throw new Error(`Reflection runs directory resolves outside the artifact root: ${realRunsDir}`);
+    }
+    return realRunsDir;
+}
+async function getRunSafetyIssue(input) {
+    try {
+        const stats = await lstat(input.runDir);
+        if (stats.isSymbolicLink()) {
+            const realRunDir = await realpath(input.runDir);
+            if (!isInside(input.realRunsDir, realRunDir)) {
+                return `run directory resolves outside the runs directory: ${realRunDir}`;
+            }
+            return 'run directory is a symlink';
+        }
+        const realRunDir = await realpath(input.runDir);
+        if (!isInside(input.realRunsDir, realRunDir)) {
+            return `run directory resolves outside the runs directory: ${realRunDir}`;
+        }
+    }
+    catch (error) {
+        if (isNodeError(error, 'ENOENT')) {
+            return 'run directory disappeared before GC could inspect it';
+        }
+        throw error;
+    }
+    return undefined;
+}
+async function readRunManifest(runDir) {
+    try {
+        const raw = await readFile(resolve(runDir, 'manifest.json'), 'utf8');
+        const parsed = RunManifestSchema.safeParse(JSON.parse(raw));
+        if (!parsed.success) {
+            return { ok: false, reason: `invalid manifest: ${parsed.error.issues.map((issue) => issue.path.join('.') || 'manifest').join(', ')}` };
+        }
+        return { ok: true, manifest: parsed.data };
+    }
+    catch (error) {
+        if (isNodeError(error, 'ENOENT')) {
+            return { ok: false, reason: 'missing manifest' };
+        }
+        if (error instanceof SyntaxError) {
+            return { ok: false, reason: 'invalid manifest JSON' };
+        }
+        throw error;
+    }
+}
+function ensureInside(parent, child) {
+    if (!isInside(parent, child)) {
+        throw new Error(`Refusing to garbage collect outside the artifact root: ${child}`);
+    }
+}
+function isInside(parent, child) {
+    const relation = relative(parent, child);
+    return relation === '' || (!relation.startsWith('..') && !isAbsolute(relation));
+}
+function isNodeError(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=gc.js.map

package/dist/core/gc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.js","sourceRoot":"","sources":["../../src/core/gc.ts"],"names":[],"mappings":"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"}

package/dist/core/manifest.d.ts

@@ -0,0 +1,23 @@
+import type { ArtifactRef, ReflectionReport } from './report-schema.js';
+export type RunManifest = {
+    schemaVersion: 1;
+    runId: string;
+    createdAt: string;
+    project: string;
+    status: ReflectionReport['status'];
+    mode: ReflectionReport['mode'];
+    ci: boolean;
+    retention: {
+        pinned: boolean;
+    };
+    files: Array<{
+        path: string;
+        type: ArtifactRef['type'];
+        bytes?: number;
+        sha256?: string;
+    }>;
+};
+export declare function createRunManifest(input: {
+    report: ReflectionReport;
+    files: ArtifactRef[];
+}): RunManifest;

package/dist/core/manifest.js

@@ -0,0 +1,21 @@
+export function createRunManifest(input) {
+    return {
+        schemaVersion: 1,
+        runId: input.report.runId,
+        createdAt: input.report.finishedAt,
+        project: input.report.project,
+        status: input.report.status,
+        mode: input.report.mode,
+        ci: input.report.ci,
+        retention: {
+            pinned: false
+        },
+        files: input.files.map((file) => ({
+            path: file.path,
+            type: file.type,
+            ...(file.bytes !== undefined ? { bytes: file.bytes } : {}),
+            ...(file.sha256 !== undefined ? { sha256: file.sha256 } : {})
+        }))
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,iBAAiB,CAAC,KAAyD;IACzF,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK;QACzB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;QAClC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QACvB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QACnB,SAAS,EAAE;YACT,MAAM,EAAE,KAAK;SACd;QACD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/core/redaction.d.ts

@@ -0,0 +1,3 @@
+import { Transform } from 'node:stream';
+export declare function redactSensitiveText(text: string): string;
+export declare function createRedactionTransform(): Transform;

package/dist/core/redaction.js

@@ -0,0 +1,63 @@
+import { Transform } from 'node:stream';
+const REDACTION = '[REDACTED]';
+const streamingTailLength = 4096;
+const sensitiveHeaderNames = ['authorization', 'cookie', 'set-cookie', 'x-api-key', 'api[-_]?key', 'access[-_]?token'];
+const sensitiveFieldStartPattern = new RegExp(`["']?(?:${sensitiveHeaderNames.join('|')})["']?\\s*[:=]`, 'i');
+const incompleteSensitiveFieldPattern = new RegExp(`(["']?(?:${sensitiveHeaderNames.join('|')})["']?\\s*[:=]\\s*["']?)[\\s\\S]*`, 'i');
+const doubleQuotedValuePattern = new RegExp(`("(?:${sensitiveHeaderNames.join('|')})"\\s*:\\s*")(?:\\\\.|[^"\\\\\\r\\n])*(")`, 'gi');
+const singleQuotedValuePattern = new RegExp(`('(?:${sensitiveHeaderNames.join('|')})'\\s*:\\s*')(?:\\\\.|[^'\\\\\\r\\n])*(')`, 'gi');
+const headerLinePatterns = [
+    /\b(authorization\s*[:=]\s*)[^\r\n]+/gi,
+    /\b(cookie\s*[:=]\s*)[^\r\n]+/gi,
+    /\b(set-cookie\s*[:=]\s*)[^\r\n]+/gi,
+    /\b(x-api-key\s*[:=]\s*)[^\r\n]+/gi,
+    /\b(api[-_]?key\s*[:=]\s*)[^\s&\r\n]+/gi,
+    /\b(access[-_]?token\s*[:=]\s*)[^\s&\r\n]+/gi
+];
+export function redactSensitiveText(text) {
+    const redactedDoubleQuotedValues = text.replace(doubleQuotedValuePattern, `$1${REDACTION}$2`);
+    const redactedQuotedValues = redactedDoubleQuotedValues.replace(singleQuotedValuePattern, `$1${REDACTION}$2`);
+    return headerLinePatterns.reduce((value, pattern) => value.replace(pattern, `$1${REDACTION}`), redactedQuotedValues);
+}
+export function createRedactionTransform() {
+    let pending = '';
+    let suppressingSensitiveLine = false;
+    return new Transform({
+        transform(chunk, _encoding, callback) {
+            let text = chunk.toString();
+            if (suppressingSensitiveLine) {
+                const lineBreak = text.indexOf('\n');
+                if (lineBreak === -1) {
+                    callback();
+                    return;
+                }
+                text = text.slice(lineBreak + 1);
+                suppressingSensitiveLine = false;
+            }
+            pending += text;
+            const lastLineBreak = pending.lastIndexOf('\n');
+            if (lastLineBreak === -1 && pending.length <= streamingTailLength) {
+                callback();
+                return;
+            }
+            if (lastLineBreak === -1 && sensitiveFieldStartPattern.test(pending)) {
+                const redacted = redactIncompleteSensitiveLine(pending);
+                pending = '';
+                suppressingSensitiveLine = true;
+                callback(null, redacted);
+                return;
+            }
+            const flushThrough = lastLineBreak === -1 ? Math.max(0, pending.length - streamingTailLength) : lastLineBreak + 1;
+            const ready = pending.slice(0, flushThrough);
+            pending = pending.slice(flushThrough);
+            callback(null, redactSensitiveText(ready));
+        },
+        flush(callback) {
+            callback(null, suppressingSensitiveLine ? '' : redactSensitiveText(pending));
+        }
+    });
+}
+function redactIncompleteSensitiveLine(text) {
+    return text.replace(incompleteSensitiveFieldPattern, `$1${REDACTION}`);
+}
+//# sourceMappingURL=redaction.js.map

package/dist/core/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/core/redaction.ts"],"names":[],"mappings":"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"}