rowpipe 1.1.0 → 1.2.0

package/dist/diff/types.d.ts

@@ -0,0 +1,127 @@
+import type { ColumnType, ReaderOptions, Row, TabularReader } from "../core/types.js";
+export type DuplicateKeyPolicy = "error" | "first" | "last";
+export type DiffOutputFormat = "summary" | "rows" | "patch";
+export type DiffOnlyFilter = "added" | "removed" | "changed" | "unchanged";
+export interface ColumnChange {
+    column: string;
+    oldVal: unknown;
+    newVal: unknown;
+}
+export type DiffEvent = {
+    type: "added";
+    key: Record<string, unknown>;
+    encodedKey: string;
+    row: Row;
+    rowNumber: number;
+} | {
+    type: "removed";
+    key: Record<string, unknown>;
+    encodedKey: string;
+    row: Row;
+    rowNumber: number;
+} | {
+    type: "changed";
+    key: Record<string, unknown>;
+    encodedKey: string;
+    changes: ColumnChange[];
+    leftRow: Row;
+    rightRow: Row;
+    leftRowNumber: number;
+    rightRowNumber: number;
+} | {
+    type: "unchanged";
+    key: Record<string, unknown>;
+    encodedKey: string;
+    row: Row;
+    leftRowNumber: number;
+    rightRowNumber: number;
+};
+export interface IndexedRow {
+    rowNumber: number;
+    row: Row;
+    hash: number;
+}
+export interface DiffIndex {
+    set(key: string, row: IndexedRow): Promise<void>;
+    get(key: string): Promise<IndexedRow | undefined>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    entries(): AsyncIterable<[string, IndexedRow]>;
+    count(): number;
+    getSpillStats?(): {
+        isSpilled: boolean;
+        spilledBytes: number;
+        entryCount: number;
+    };
+    close(): Promise<void>;
+}
+export interface SchemaColumnDiff {
+    added: Array<{
+        name: string;
+        type: ColumnType;
+    }>;
+    removed: Array<{
+        name: string;
+        type: ColumnType;
+    }>;
+    changed: Array<{
+        name: string;
+        leftType: ColumnType;
+        rightType: ColumnType;
+    }>;
+}
+export interface DiffSummary {
+    leftSource: string;
+    rightSource: string;
+    keyColumns: string[];
+    rows: {
+        added: number;
+        removed: number;
+        changed: number;
+        unchanged: number;
+        totalLeft: number;
+        totalRight: number;
+    };
+    columns: Record<string, {
+        changed: number;
+    }>;
+    schema?: SchemaColumnDiff;
+    executionTimeMs?: number;
+    spillStats?: {
+        isSpilled: boolean;
+        spilledBytes: number;
+    };
+}
+export interface DiffEngineOptions {
+    left?: TabularReader | string;
+    leftPath?: string;
+    fromLeft?: string;
+    right?: TabularReader | string;
+    rightPath?: string;
+    fromRight?: string;
+    keys: string[];
+    columns?: string[];
+    ignore?: string[];
+    duplicateKey?: DuplicateKeyPolicy;
+    coerce?: boolean;
+    epsilon?: number;
+    ignoreCase?: boolean;
+    trim?: boolean;
+    memoryLimitBytes?: number;
+    includeSchema?: boolean;
+    leftOptions?: ReaderOptions;
+    rightOptions?: ReaderOptions;
+    onProgress?: (info: DiffProgressInfo) => void;
+}
+export interface DiffProgressInfo {
+    phase: "indexing_left" | "comparing_right" | "finishing";
+    leftRowsProcessed: number;
+    rightRowsProcessed: number;
+    addedCount: number;
+    removedCount: number;
+    changedCount: number;
+    unchangedCount: number;
+    elapsedMs: number;
+    isSpilled?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/diff/types.d.ts.map

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

package/dist/diff/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diff/types.ts"],"names":[],"mappings":""}

package/dist/files/glob.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Zero-dependency, high-performance glob compiler and matcher.
+ */
+/**
+ * Expands brace patterns like `*.{jpg,png}` into `["*.jpg", "*.png"]`.
+ */
+export declare function expandBracePatterns(pattern: string): string[];
+/**
+ * Normalizes file path to forward slashes without leading `./`.
+ */
+export declare function normalizeGlobPath(filePath: string): string;
+/**
+ * Converts a single glob pattern into a regular expression.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+export type GlobMatcher = (path: string) => boolean;
+/**
+ * Creates a composite matcher function from an array of glob strings.
+ */
+export declare function createGlobMatcher(patterns?: string[] | string): GlobMatcher;
+//# sourceMappingURL=glob.d.ts.map

package/dist/files/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/files/glob.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAY7D;AAgCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2CnD;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEpD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,WAAW,CAsB3E"}

package/dist/files/glob.js

@@ -0,0 +1,132 @@
+/**
+ * Zero-dependency, high-performance glob compiler and matcher.
+ */
+/**
+ * Expands brace patterns like `*.{jpg,png}` into `["*.jpg", "*.png"]`.
+ */
+export function expandBracePatterns(pattern) {
+    const match = pattern.match(/\{([^}]+)\}/);
+    if (!match)
+        return [pattern];
+    const prefix = pattern.slice(0, match.index);
+    const suffix = pattern.slice(match.index + match[0].length);
+    const options = match[1].split(",").map((s) => s.trim());
+    const results = [];
+    for (const opt of options) {
+        const expanded = `${prefix}${opt}${suffix}`;
+        results.push(...expandBracePatterns(expanded));
+    }
+    return results;
+}
+/**
+ * Splits comma-separated patterns only outside of curly braces {}.
+ */
+function splitTopLevelCommas(input) {
+    const parts = [];
+    let depth = 0;
+    let current = "";
+    for (let i = 0; i < input.length; i++) {
+        const c = input[i];
+        if (c === "{") {
+            depth++;
+            current += c;
+        }
+        else if (c === "}") {
+            depth = Math.max(0, depth - 1);
+            current += c;
+        }
+        else if (c === "," && depth === 0) {
+            if (current.trim().length > 0) {
+                parts.push(current.trim());
+            }
+            current = "";
+        }
+        else {
+            current += c;
+        }
+    }
+    if (current.trim().length > 0) {
+        parts.push(current.trim());
+    }
+    return parts;
+}
+/**
+ * Normalizes file path to forward slashes without leading `./`.
+ */
+export function normalizeGlobPath(filePath) {
+    let normalized = filePath.replace(/\\/g, "/");
+    while (normalized.startsWith("./")) {
+        normalized = normalized.slice(2);
+    }
+    return normalized;
+}
+/**
+ * Converts a single glob pattern into a regular expression.
+ */
+export function globToRegex(pattern) {
+    const cleanPattern = normalizeGlobPath(pattern);
+    // If pattern does not contain a slash, treat it as matching either at root or anywhere in tree
+    const hasSlash = cleanPattern.includes("/");
+    let regexStr = "";
+    let i = 0;
+    const len = cleanPattern.length;
+    while (i < len) {
+        const c = cleanPattern[i];
+        if (c === undefined)
+            break;
+        if (c === "*" && cleanPattern[i + 1] === "*") {
+            // '**'
+            i += 2;
+            if (cleanPattern[i] === "/") {
+                i += 1;
+                regexStr += "(?:.*?/)?";
+            }
+            else {
+                regexStr += ".*";
+            }
+        }
+        else if (c === "*") {
+            regexStr += "[^/]*";
+            i += 1;
+        }
+        else if (c === "?") {
+            regexStr += "[^/]";
+            i += 1;
+        }
+        else if ("()+^${}|[].\\".includes(c)) {
+            regexStr += `\\${c}`;
+            i += 1;
+        }
+        else {
+            regexStr += c;
+            i += 1;
+        }
+    }
+    if (!hasSlash) {
+        return new RegExp(`^(?:.*?/)?${regexStr}$`, "i");
+    }
+    return new RegExp(`^${regexStr}$`, "i");
+}
+/**
+ * Creates a composite matcher function from an array of glob strings.
+ */
+export function createGlobMatcher(patterns) {
+    if (!patterns) {
+        return () => true;
+    }
+    const rawPatterns = Array.isArray(patterns) ? patterns : [patterns];
+    const normalizedPatterns = rawPatterns
+        .flatMap(splitTopLevelCommas)
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0)
+        .flatMap(expandBracePatterns);
+    if (normalizedPatterns.length === 0) {
+        return () => true;
+    }
+    const regexes = normalizedPatterns.map(globToRegex);
+    return (filePath) => {
+        const normalized = normalizeGlobPath(filePath);
+        return regexes.some((re) => re.test(normalized));
+    };
+}
+//# sourceMappingURL=glob.js.map

package/dist/files/glob.js.map

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

package/dist/files/hash.d.ts

@@ -0,0 +1,10 @@
+import type { HashAlgorithm } from "./types.js";
+/**
+ * Computes streaming cryptographic hash of a file.
+ */
+export declare function computeFileHash(filePath: string, algorithm?: HashAlgorithm): Promise<string>;
+/**
+ * Computes a fast non-cryptographic fingerprint using file stat + partial content sampling.
+ */
+export declare function computeFastFileHash(filePath: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/files/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/files/hash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAwB,GAClC,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC3E"}

package/dist/files/hash.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+import { createReadStream, promises as fsPromises } from "node:fs";
+import { pipeline } from "node:stream/promises";
+import { FileSystemError } from "../core/errors.js";
+/**
+ * Computes streaming cryptographic hash of a file.
+ */
+export async function computeFileHash(filePath, algorithm = "sha256") {
+    if (algorithm === "fast") {
+        return computeFastFileHash(filePath);
+    }
+    try {
+        const hashStream = createHash(algorithm);
+        const fileStream = createReadStream(filePath);
+        await pipeline(fileStream, hashStream);
+        return hashStream.digest("hex");
+    }
+    catch (err) {
+        throw new FileSystemError(`Failed to compute ${algorithm} hash for "${filePath}"`, {
+            path: filePath,
+            operation: "hash",
+            cause: err instanceof Error ? err : String(err),
+        });
+    }
+}
+/**
+ * Computes a fast non-cryptographic fingerprint using file stat + partial content sampling.
+ */
+export async function computeFastFileHash(filePath) {
+    try {
+        const stat = await fsPromises.stat(filePath);
+        const size = stat.size;
+        const mtimeMs = stat.mtimeMs;
+        if (size === 0) {
+            return `fast:0:${mtimeMs}:empty`;
+        }
+        const hash = createHash("sha256");
+        hash.update(`size:${size}|mtime:${mtimeMs}|`);
+        // Sample up to 4KB from start and end for fast fingerprinting
+        const sampleSize = Math.min(4096, size);
+        const fd = await fsPromises.open(filePath, "r");
+        try {
+            const buffer = Buffer.alloc(sampleSize);
+            // Read header
+            await fd.read(buffer, 0, sampleSize, 0);
+            hash.update(buffer);
+            if (size > sampleSize * 2) {
+                // Read footer if large enough
+                const footerBuffer = Buffer.alloc(sampleSize);
+                await fd.read(footerBuffer, 0, sampleSize, size - sampleSize);
+                hash.update(footerBuffer);
+            }
+        }
+        finally {
+            await fd.close();
+        }
+        return `fast:${hash.digest("hex").slice(0, 16)}`;
+    }
+    catch (err) {
+        throw new FileSystemError(`Failed to compute fast hash for "${filePath}"`, {
+            path: filePath,
+            operation: "hash",
+            cause: err instanceof Error ? err : String(err),
+        });
+    }
+}
+//# sourceMappingURL=hash.js.map

package/dist/files/hash.js.map

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

package/dist/files/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./glob.js";
+export * from "./mime.js";
+export * from "./hash.js";
+export * from "./reader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/files/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./glob.js";
+export * from "./mime.js";
+export * from "./hash.js";
+export * from "./reader.js";
+//# sourceMappingURL=index.js.map

package/dist/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/files/mime.d.ts

@@ -0,0 +1,9 @@
+import type { FileCategory } from "./types.js";
+/**
+ * Returns MIME type and Category for a given file extension or name.
+ */
+export declare function inferMimeAndCategory(extensionOrName: string): {
+    mime: string;
+    category: FileCategory;
+};
+//# sourceMappingURL=mime.d.ts.map

package/dist/files/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../src/files/mime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA4H/C;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAgBtG"}

package/dist/files/mime.js

@@ -0,0 +1,128 @@
+const MIME_MAP = {
+    // Tabular & Data
+    csv: { mime: "text/csv", category: "data" },
+    tsv: { mime: "text/tab-separated-values", category: "data" },
+    psv: { mime: "text/plain", category: "data" },
+    tab: { mime: "text/tab-separated-values", category: "data" },
+    json: { mime: "application/json", category: "data" },
+    jsonl: { mime: "application/x-ndjson", category: "data" },
+    ndjson: { mime: "application/x-ndjson", category: "data" },
+    ldjson: { mime: "application/x-ndjson", category: "data" },
+    parquet: { mime: "application/vnd.apache.parquet", category: "data" },
+    pq: { mime: "application/vnd.apache.parquet", category: "data" },
+    sql: { mime: "application/sql", category: "data" },
+    sqlite: { mime: "application/vnd.sqlite3", category: "data" },
+    db: { mime: "application/octet-stream", category: "data" },
+    xml: { mime: "application/xml", category: "data" },
+    yaml: { mime: "application/yaml", category: "data" },
+    yml: { mime: "application/yaml", category: "data" },
+    toml: { mime: "application/toml", category: "data" },
+    // Spreadsheets & Office Documents
+    xlsx: { mime: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", category: "document" },
+    xlsm: { mime: "application/vnd.ms-excel.sheet.macroEnabled.12", category: "document" },
+    xls: { mime: "application/vnd.ms-excel", category: "document" },
+    ods: { mime: "application/vnd.oasis.opendocument.spreadsheet", category: "document" },
+    pdf: { mime: "application/pdf", category: "document" },
+    docx: { mime: "application/vnd.openxmlformats-officedocument.wordprocessingml.document", category: "document" },
+    doc: { mime: "application/msword", category: "document" },
+    pptx: { mime: "application/vnd.openxmlformats-officedocument.presentationml.presentation", category: "document" },
+    ppt: { mime: "application/vnd.ms-powerpoint", category: "document" },
+    txt: { mime: "text/plain", category: "document" },
+    md: { mime: "text/markdown", category: "document" },
+    markdown: { mime: "text/markdown", category: "document" },
+    rtf: { mime: "application/rtf", category: "document" },
+    epub: { mime: "application/epub+zip", category: "document" },
+    // Images
+    png: { mime: "image/png", category: "image" },
+    jpg: { mime: "image/jpeg", category: "image" },
+    jpeg: { mime: "image/jpeg", category: "image" },
+    webp: { mime: "image/webp", category: "image" },
+    gif: { mime: "image/gif", category: "image" },
+    svg: { mime: "image/svg+xml", category: "image" },
+    avif: { mime: "image/avif", category: "image" },
+    bmp: { mime: "image/bmp", category: "image" },
+    ico: { mime: "image/x-icon", category: "image" },
+    tiff: { mime: "image/tiff", category: "image" },
+    tif: { mime: "image/tiff", category: "image" },
+    heic: { mime: "image/heic", category: "image" },
+    // Video
+    mp4: { mime: "video/mp4", category: "video" },
+    mkv: { mime: "video/x-matroska", category: "video" },
+    webm: { mime: "video/webm", category: "video" },
+    avi: { mime: "video/x-msvideo", category: "video" },
+    mov: { mime: "video/quicktime", category: "video" },
+    wmv: { mime: "video/x-ms-wmv", category: "video" },
+    flv: { mime: "video/x-flv", category: "video" },
+    // Audio
+    mp3: { mime: "audio/mpeg", category: "audio" },
+    wav: { mime: "audio/wav", category: "audio" },
+    flac: { mime: "audio/flac", category: "audio" },
+    aac: { mime: "audio/aac", category: "audio" },
+    ogg: { mime: "audio/ogg", category: "audio" },
+    m4a: { mime: "audio/mp4", category: "audio" },
+    // Archives & Compression
+    zip: { mime: "application/zip", category: "archive" },
+    tar: { mime: "application/x-tar", category: "archive" },
+    gz: { mime: "application/gzip", category: "archive" },
+    gzip: { mime: "application/gzip", category: "archive" },
+    tgz: { mime: "application/gzip", category: "archive" },
+    bz2: { mime: "application/x-bzip2", category: "archive" },
+    xz: { mime: "application/x-xz", category: "archive" },
+    zst: { mime: "application/zstd", category: "archive" },
+    "7z": { mime: "application/x-7z-compressed", category: "archive" },
+    rar: { mime: "application/vnd.rar", category: "archive" },
+    // Code & Source
+    js: { mime: "text/javascript", category: "code" },
+    mjs: { mime: "text/javascript", category: "code" },
+    cjs: { mime: "text/javascript", category: "code" },
+    ts: { mime: "text/typescript", category: "code" },
+    mts: { mime: "text/typescript", category: "code" },
+    cts: { mime: "text/typescript", category: "code" },
+    jsx: { mime: "text/javascript", category: "code" },
+    tsx: { mime: "text/typescript", category: "code" },
+    html: { mime: "text/html", category: "code" },
+    htm: { mime: "text/html", category: "code" },
+    css: { mime: "text/css", category: "code" },
+    scss: { mime: "text/x-scss", category: "code" },
+    sass: { mime: "text/x-sass", category: "code" },
+    less: { mime: "text/less", category: "code" },
+    py: { mime: "text/x-python", category: "code" },
+    rs: { mime: "text/x-rust", category: "code" },
+    go: { mime: "text/x-go", category: "code" },
+    c: { mime: "text/x-c", category: "code" },
+    cpp: { mime: "text/x-c++", category: "code" },
+    h: { mime: "text/x-c", category: "code" },
+    hpp: { mime: "text/x-c++", category: "code" },
+    java: { mime: "text/x-java-source", category: "code" },
+    kt: { mime: "text/x-kotlin", category: "code" },
+    swift: { mime: "text/x-swift", category: "code" },
+    rb: { mime: "text/x-ruby", category: "code" },
+    php: { mime: "application/x-httpd-php", category: "code" },
+    sh: { mime: "application/x-sh", category: "code" },
+    bash: { mime: "application/x-sh", category: "code" },
+    zsh: { mime: "application/x-sh", category: "code" },
+    // Fonts
+    woff: { mime: "font/woff", category: "font" },
+    woff2: { mime: "font/woff2", category: "font" },
+    ttf: { mime: "font/ttf", category: "font" },
+    otf: { mime: "font/otf", category: "font" },
+};
+/**
+ * Returns MIME type and Category for a given file extension or name.
+ */
+export function inferMimeAndCategory(extensionOrName) {
+    let ext = extensionOrName.toLowerCase();
+    const dotIndex = ext.lastIndexOf(".");
+    if (dotIndex !== -1) {
+        ext = ext.slice(dotIndex + 1);
+    }
+    const entry = MIME_MAP[ext];
+    if (entry) {
+        return entry;
+    }
+    return {
+        mime: "application/octet-stream",
+        category: "other",
+    };
+}
+//# sourceMappingURL=mime.js.map

package/dist/files/mime.js.map

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

package/dist/files/reader.d.ts

@@ -0,0 +1,19 @@
+import type { DataStream, InspectionMetadata, ReaderOptions, TabularReader } from "../core/types.js";
+import type { FileSystemReaderOptions } from "./types.js";
+/**
+ * First-class streaming filesystem reader.
+ * Converts directories and files into streaming tabular DataBatches.
+ */
+export declare class FileSystemReader implements TabularReader {
+    private readonly options;
+    constructor(optionsOrRoot: string | FileSystemReaderOptions);
+    /**
+     * Reads the filesystem stream yielding DataBatches.
+     */
+    read(readOptions?: ReaderOptions): DataStream;
+    /**
+     * Inspects filesystem directory metadata without full memory accumulation.
+     */
+    inspect(_options?: ReaderOptions): Promise<InspectionMetadata>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/files/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/files/reader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIhH,OAAO,KAAK,EAAc,uBAAuB,EAAY,MAAM,YAAY,CAAC;AAahF;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,aAAa,EAAE,MAAM,GAAG,uBAAuB;IAQ3D;;OAEG;IACW,IAAI,CAAC,WAAW,CAAC,EAAE,aAAa,GAAG,UAAU;IAgT3D;;OAEG;IACU,OAAO,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA0C5E"}