codepage-bridge-mcp 0.1.0

package/dist/src/core.d.ts

@@ -0,0 +1,56 @@
+import { type DecodedText, type EncodingRules } from './encoding/index.js';
+export interface ProjectFileContext {
+    absolutePath: string;
+    root: string;
+    rules: EncodingRules;
+    encoding: string;
+}
+export interface ReadSnapshot {
+    absolutePath: string;
+    root: string;
+    encoding: string;
+    text: string;
+    bom: DecodedText['bom'];
+    newline: DecodedText['newline'];
+    mtimeMs: number;
+    size: number;
+    hash: string;
+    complete: boolean;
+    offset?: number;
+    limit?: number;
+}
+export declare function getProjectFileContext(filePath: string): Promise<ProjectFileContext>;
+export declare function readDecodedFile(context: ProjectFileContext): Promise<ReadSnapshot>;
+export declare function encodeSnapshotText(snapshot: ReadSnapshot, text: string, preserveNewline?: boolean): Buffer;
+export declare class ReadRegistry {
+    private readonly snapshots;
+    private readonly coverage;
+    private readonly ranges;
+    get(filePath: string): ReadSnapshot | undefined;
+    clear(filePath?: string): void;
+    remember(snapshot: ReadSnapshot, range: {
+        startLine: number;
+        endLine: number;
+        totalLines: number;
+    }): void;
+    authorizeEdit(filePath: string, currentHash: string, requiredRanges: Array<{
+        startLine: number;
+        endLine: number;
+    }>): {
+        status: 'authorized';
+        snapshot: ReadSnapshot;
+    } | {
+        status: 'unread';
+    } | {
+        status: 'changed';
+    } | {
+        status: 'uncovered';
+        missing: Array<{
+            startLine: number;
+            endLine: number;
+        }>;
+    };
+    isUnchanged(filePath: string, offset?: number, limit?: number): Promise<boolean>;
+    updateAfterWrite(snapshot: ReadSnapshot, text: string, buffer: Buffer, mtimeMs: number): void;
+}
+export declare const readRegistry: ReadRegistry;

package/dist/src/core.js

@@ -0,0 +1,166 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { decodeText, encodeText, findEncodingRules, resolveEncoding, } from './encoding/index.js';
+import { fileStateCache, resolveProjectPath } from './filesystem/index.js';
+function digest(buffer) {
+    return createHash('sha256').update(buffer).digest('hex');
+}
+export async function getProjectFileContext(filePath) {
+    if (filePath.includes('\0'))
+        throw new Error('file_path must not contain NUL bytes');
+    if (/^[/\\]{2}/.test(filePath) || /^\\\\[?.]\\/.test(filePath)) {
+        throw new Error('UNC and device paths are not allowed');
+    }
+    if (!path.isAbsolute(filePath))
+        throw new Error('file_path must be an absolute path');
+    const absolutePath = path.resolve(filePath);
+    const rules = await findEncodingRules(path.dirname(absolutePath));
+    if (rules.file === null) {
+        throw new Error(`No .encoding-rules found for ${filePath}`);
+    }
+    resolveProjectPath(rules.root, absolutePath);
+    return {
+        absolutePath,
+        root: rules.root,
+        rules,
+        encoding: resolveEncoding(absolutePath, rules),
+    };
+}
+export async function readDecodedFile(context) {
+    const state = await fileStateCache.read(context.root, context.absolutePath);
+    const decoded = decodeText(state.buffer, context.encoding);
+    return {
+        absolutePath: context.absolutePath,
+        root: context.root,
+        encoding: decoded.encoding,
+        text: decoded.text.replaceAll('\r\n', '\n').replaceAll('\r', '\n'),
+        bom: decoded.bom,
+        newline: decoded.newline,
+        mtimeMs: state.mtimeMs,
+        size: state.size,
+        hash: state.hash,
+        complete: true,
+    };
+}
+export function encodeSnapshotText(snapshot, text, preserveNewline = true) {
+    return encodeText(text, snapshot.encoding, {
+        bom: snapshot.bom,
+        newline: preserveNewline ? snapshot.newline : null,
+    });
+}
+function mergeIntervals(intervals, next) {
+    if (next.end < next.start)
+        return intervals;
+    const merged = [];
+    let current = next;
+    for (const interval of [...intervals, next].sort((left, right) => left.start - right.start)) {
+        if (interval === next)
+            continue;
+        if (interval.end + 1 < current.start)
+            merged.push(interval);
+        else if (current.end + 1 < interval.start) {
+            merged.push(current);
+            current = interval;
+        }
+        else {
+            current = {
+                start: Math.min(current.start, interval.start),
+                end: Math.max(current.end, interval.end),
+            };
+        }
+    }
+    merged.push(current);
+    return merged.sort((left, right) => left.start - right.start);
+}
+export class ReadRegistry {
+    snapshots = new Map();
+    coverage = new Map();
+    ranges = new Map();
+    get(filePath) {
+        return this.snapshots.get(path.resolve(filePath));
+    }
+    clear(filePath) {
+        if (filePath === undefined) {
+            this.snapshots.clear();
+            this.coverage.clear();
+            this.ranges.clear();
+            return;
+        }
+        const absolutePath = path.resolve(filePath);
+        this.snapshots.delete(absolutePath);
+        this.coverage.delete(absolutePath);
+        this.ranges.delete(absolutePath);
+    }
+    remember(snapshot, range) {
+        const key = snapshot.absolutePath;
+        const existing = this.coverage.get(key);
+        const sameVersion = existing?.snapshot.hash === snapshot.hash
+            && existing.snapshot.mtimeMs === snapshot.mtimeMs;
+        const intervals = sameVersion ? existing.intervals : [];
+        const merged = mergeIntervals(intervals, {
+            start: Math.max(1, range.startLine),
+            end: Math.min(range.totalLines, range.endLine),
+        });
+        const complete = merged.length === 1
+            && merged[0]?.start === 1
+            && merged[0].end >= range.totalLines;
+        const remembered = { ...snapshot, complete };
+        this.coverage.set(key, {
+            snapshot: remembered,
+            totalLines: range.totalLines,
+            intervals: merged,
+        });
+        if (complete)
+            this.snapshots.set(key, remembered);
+        else
+            this.snapshots.delete(key);
+        this.ranges.set(key, {
+            mtimeMs: snapshot.mtimeMs,
+            hash: snapshot.hash,
+            ...(snapshot.offset === undefined ? {} : { offset: snapshot.offset }),
+            ...(snapshot.limit === undefined ? {} : { limit: snapshot.limit }),
+        });
+    }
+    authorizeEdit(filePath, currentHash, requiredRanges) {
+        const entry = this.coverage.get(path.resolve(filePath));
+        if (!entry)
+            return { status: 'unread' };
+        if (entry.snapshot.hash !== currentHash)
+            return { status: 'changed' };
+        const missing = requiredRanges.filter(required => !entry.intervals.some(interval => interval.start <= required.startLine && interval.end >= required.endLine));
+        if (missing.length > 0)
+            return { status: 'uncovered', missing };
+        return { status: 'authorized', snapshot: entry.snapshot };
+    }
+    async isUnchanged(filePath, offset, limit) {
+        const absolutePath = path.resolve(filePath);
+        const previous = this.ranges.get(absolutePath);
+        if (!previous || previous.offset !== offset || previous.limit !== limit)
+            return false;
+        const context = await getProjectFileContext(absolutePath);
+        const current = await fileStateCache.read(context.root, absolutePath);
+        return current.mtimeMs === previous.mtimeMs && current.hash === previous.hash;
+    }
+    updateAfterWrite(snapshot, text, buffer, mtimeMs) {
+        const { offset: _offset, limit: _limit, ...base } = snapshot;
+        const hash = digest(buffer);
+        const next = {
+            ...base,
+            text,
+            size: buffer.length,
+            hash,
+            mtimeMs,
+            complete: true,
+        };
+        const totalLines = text.split('\n').length;
+        this.snapshots.set(snapshot.absolutePath, next);
+        this.coverage.set(snapshot.absolutePath, {
+            snapshot: next,
+            totalLines,
+            intervals: [{ start: 1, end: totalLines }],
+        });
+        this.ranges.set(snapshot.absolutePath, { mtimeMs, hash });
+    }
+}
+export const readRegistry = new ReadRegistry();
+//# sourceMappingURL=core.js.map

package/dist/src/core.js.map

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

package/dist/src/diff.d.ts

@@ -0,0 +1,8 @@
+export interface PatchHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+}
+export declare function createStructuredPatch(filePath: string, before: string, after: string): PatchHunk[];

package/dist/src/diff.js

@@ -0,0 +1,11 @@
+import { structuredPatch } from 'diff';
+export function createStructuredPatch(filePath, before, after) {
+    return structuredPatch(filePath, filePath, before, after, '', '').hunks.map(hunk => ({
+        oldStart: hunk.oldStart,
+        oldLines: hunk.oldLines,
+        newStart: hunk.newStart,
+        newLines: hunk.newLines,
+        lines: hunk.lines,
+    }));
+}
+//# sourceMappingURL=diff.js.map

package/dist/src/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAA;AAUtC,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,MAAc,EAAE,KAAa;IACnF,OAAO,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/src/encoding/codec.d.ts

@@ -0,0 +1,5 @@
+import type { DecodedText, EncodeTextOptions, NewlineKind } from "./types.js";
+export declare function normalizeEncoding(label: string): string;
+export declare function detectDominantNewline(text: string): NewlineKind;
+export declare function decodeText(buffer: Buffer, requestedEncoding?: string): DecodedText;
+export declare function encodeText(text: string, requestedEncoding?: string, options?: EncodeTextOptions): Buffer;

package/dist/src/encoding/codec.js

@@ -0,0 +1,75 @@
+import { TextDecoder } from "node:util";
+import iconv from "iconv-lite";
+const BOMS = [
+    ["utf-8", Buffer.from([0xef, 0xbb, 0xbf])],
+    ["utf-16le", Buffer.from([0xff, 0xfe])],
+    ["utf-16be", Buffer.from([0xfe, 0xff])],
+];
+export function normalizeEncoding(label) {
+    try {
+        return new TextDecoder(label).encoding;
+    }
+    catch {
+        throw new Error(`Unsupported encoding: ${label}`);
+    }
+}
+function detectBom(buffer) {
+    for (const [kind, bytes] of BOMS) {
+        if (buffer.subarray(0, bytes.length).equals(bytes))
+            return [kind, bytes.length];
+    }
+    return [null, 0];
+}
+export function detectDominantNewline(text) {
+    let crlf = 0;
+    let lf = 0;
+    let cr = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        if (text[index] === "\r" && text[index + 1] === "\n") {
+            crlf += 1;
+            index += 1;
+        }
+        else if (text[index] === "\n")
+            lf += 1;
+        else if (text[index] === "\r")
+            cr += 1;
+    }
+    const maximum = Math.max(crlf, lf, cr);
+    if (maximum === 0)
+        return null;
+    if (crlf === maximum)
+        return "\r\n";
+    if (lf === maximum)
+        return "\n";
+    return "\r";
+}
+export function decodeText(buffer, requestedEncoding = "utf-8") {
+    const encoding = normalizeEncoding(requestedEncoding);
+    const [bom, bomLength] = detectBom(buffer);
+    const bytes = buffer.subarray(bomLength);
+    let text;
+    try {
+        text = new TextDecoder(encoding, { fatal: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new Error(`Invalid byte sequence for ${encoding}`, { cause: error });
+    }
+    return { text, encoding, bom, newline: detectDominantNewline(text) };
+}
+function applyNewline(text, newline) {
+    return newline === null ? text : text.replace(/\r\n|\r|\n/g, newline);
+}
+export function encodeText(text, requestedEncoding = "utf-8", options = {}) {
+    const encoding = normalizeEncoding(requestedEncoding);
+    const normalizedText = applyNewline(text, options.newline ?? null);
+    if (!iconv.encodingExists(encoding))
+        throw new Error(`Encoding cannot be written: ${encoding}`);
+    const encoded = iconv.encode(normalizedText, encoding);
+    const roundTrip = new TextDecoder(encoding, { fatal: true }).decode(encoded);
+    if (roundTrip !== normalizedText) {
+        throw new Error(`Text contains characters not representable in ${encoding}`);
+    }
+    const prefix = BOMS.find(([kind]) => kind === (options.bom ?? null))?.[1];
+    return prefix ? Buffer.concat([prefix, encoded]) : encoded;
+}
+//# sourceMappingURL=codec.js.map

package/dist/src/encoding/codec.js.map

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

package/dist/src/encoding/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./codec.js";
+export * from "./rules.js";
+export * from "./types.js";

package/dist/src/encoding/index.js

@@ -0,0 +1,4 @@
+export * from "./codec.js";
+export * from "./rules.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/encoding/index.js.map

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

package/dist/src/encoding/rules.d.ts

@@ -0,0 +1,4 @@
+import type { EncodingRules } from "./types.js";
+export declare function findEncodingRules(startPath: string, boundary?: string): Promise<EncodingRules>;
+export declare function parseEncodingRules(source: string, root: string, file?: string | null): EncodingRules;
+export declare function resolveEncoding(filePath: string, rules: EncodingRules): string;

package/dist/src/encoding/rules.js

@@ -0,0 +1,70 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import picomatch from "picomatch";
+const RULES_FILE = ".encoding-rules";
+function isWithin(candidate, boundary) {
+    const relative = path.relative(boundary, candidate);
+    return relative === "" || (!relative.startsWith(`..${path.sep}`) && relative !== "..");
+}
+export async function findEncodingRules(startPath, boundary) {
+    const resolvedBoundary = path.resolve(boundary ?? path.parse(path.resolve(startPath)).root);
+    let directory = path.resolve(startPath);
+    if (!isWithin(directory, resolvedBoundary)) {
+        throw new Error(`Path is outside the rules boundary: ${startPath}`);
+    }
+    while (isWithin(directory, resolvedBoundary)) {
+        const rulesFile = path.join(directory, RULES_FILE);
+        try {
+            await access(rulesFile);
+            return parseEncodingRules(await readFile(rulesFile, "utf8"), directory, rulesFile);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "ENOENT" && code !== "ENOTDIR")
+                throw error;
+        }
+        if (directory === resolvedBoundary)
+            break;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            break;
+        directory = parent;
+    }
+    return { root: resolvedBoundary, file: null, rules: [] };
+}
+export function parseEncodingRules(source, root, file = null) {
+    const rules = [];
+    for (const [index, rawLine] of source.split(/\r\n|\n|\r/).entries()) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const separator = line.search(/\s/);
+        const rawPattern = separator < 0 ? line : line.slice(0, separator);
+        const rawEncoding = separator < 0 ? "" : line.slice(separator).trim().split(/\s+/)[0] ?? "";
+        const cancelled = rawPattern.startsWith("!");
+        const pattern = cancelled ? rawPattern.slice(1) : rawPattern;
+        if (!pattern)
+            throw new Error(`Invalid empty pattern at ${file ?? RULES_FILE}:${index + 1}`);
+        if (!cancelled && !rawEncoding) {
+            throw new Error(`Missing encoding at ${file ?? RULES_FILE}:${index + 1}`);
+        }
+        rules.push({ pattern, encoding: cancelled ? null : rawEncoding, line: index + 1 });
+    }
+    return { root: path.resolve(root), file, rules };
+}
+export function resolveEncoding(filePath, rules) {
+    const absolute = path.resolve(filePath);
+    if (!isWithin(absolute, rules.root))
+        throw new Error(`Path is outside project root: ${filePath}`);
+    const relative = path.relative(rules.root, absolute).split(path.sep).join("/");
+    let encoding = "utf-8";
+    for (const rule of rules.rules) {
+        const pattern = rule.pattern.split("\\").join("/");
+        const basename = !pattern.includes("/");
+        if (picomatch.isMatch(relative, pattern, { dot: true, basename })) {
+            encoding = rule.encoding ?? "utf-8";
+        }
+    }
+    return encoding;
+}
+//# sourceMappingURL=rules.js.map

package/dist/src/encoding/rules.js.map

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

package/dist/src/encoding/types.d.ts

@@ -0,0 +1,22 @@
+export interface EncodingRule {
+    pattern: string;
+    encoding: string | null;
+    line: number;
+}
+export interface EncodingRules {
+    root: string;
+    file: string | null;
+    rules: readonly EncodingRule[];
+}
+export type BomKind = "utf-8" | "utf-16le" | "utf-16be" | null;
+export type NewlineKind = "\r\n" | "\n" | "\r" | null;
+export interface DecodedText {
+    text: string;
+    encoding: string;
+    bom: BomKind;
+    newline: NewlineKind;
+}
+export interface EncodeTextOptions {
+    bom?: BomKind;
+    newline?: NewlineKind;
+}

package/dist/src/encoding/types.js

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

package/dist/src/encoding/types.js.map

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

package/dist/src/filesystem/atomic.d.ts

@@ -0,0 +1,6 @@
+import { type FileVersion } from "./cache.js";
+export interface AtomicWriteOptions {
+    mode?: number;
+    expected?: Pick<FileVersion, "mtimeMs" | "hash">;
+}
+export declare function atomicWriteBuffer(root: string, input: string, buffer: Buffer, options?: AtomicWriteOptions): Promise<void>;

package/dist/src/filesystem/atomic.js

@@ -0,0 +1,91 @@
+import { randomBytes } from "node:crypto";
+import { chmod, open, rename, rm, stat } from "node:fs/promises";
+import path from "node:path";
+import { fileStateCache } from "./cache.js";
+import { pathMutex } from "./mutex.js";
+import { inspectProjectPath } from "./path.js";
+function temporaryName(target, suffix) {
+    return path.join(path.dirname(target), `.${path.basename(target)}.${process.pid}.${randomBytes(6).toString("hex")}.${suffix}`);
+}
+async function flushDirectory(directory) {
+    try {
+        const handle = await open(directory, "r");
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch (error) {
+        if (process.platform !== "win32")
+            throw error;
+    }
+}
+async function replaceFile(temp, target) {
+    const attempts = process.platform === "win32" ? 4 : 1;
+    let lastError;
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        try {
+            await rename(temp, target);
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            const code = error.code;
+            if (process.platform !== "win32" || (code !== "EPERM" && code !== "EACCES" && code !== "EEXIST")) {
+                throw error;
+            }
+            if (attempt + 1 < attempts) {
+                await new Promise(resolve => setTimeout(resolve, 25 * (attempt + 1)));
+            }
+        }
+    }
+    throw lastError;
+}
+async function assertExpected(root, input, expected) {
+    const current = await fileStateCache.read(root, input);
+    if (current.mtimeMs !== expected.mtimeMs || current.hash !== expected.hash) {
+        throw new Error(`File changed since it was read: ${input}`);
+    }
+}
+export async function atomicWriteBuffer(root, input, buffer, options = {}) {
+    const initial = await inspectProjectPath(root, input, true);
+    const key = process.platform === "win32" ? initial.target.toLowerCase() : initial.target;
+    await pathMutex.runExclusive(key, async () => {
+        const safe = await inspectProjectPath(root, input, true);
+        if (options.expected)
+            await assertExpected(root, input, options.expected);
+        let mode = options.mode;
+        if (mode === undefined) {
+            try {
+                mode = (await stat(safe.target)).mode;
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+                mode = 0o666;
+            }
+        }
+        const temp = temporaryName(safe.target, "tmp");
+        let handle;
+        try {
+            handle = await open(temp, "wx", mode);
+            await handle.writeFile(buffer);
+            await handle.sync();
+            await handle.close();
+            handle = undefined;
+            await chmod(temp, mode);
+            await replaceFile(temp, safe.target);
+            await flushDirectory(path.dirname(safe.target));
+            fileStateCache.clear(safe.target);
+        }
+        catch (error) {
+            if (handle)
+                await handle.close().catch(() => undefined);
+            await rm(temp, { force: true }).catch(() => undefined);
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=atomic.js.map

package/dist/src/filesystem/atomic.js.map

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

package/dist/src/filesystem/cache.d.ts

@@ -0,0 +1,21 @@
+export interface FileVersion {
+    mtimeMs: number;
+    size: number;
+    hash: string;
+}
+export interface BufferReadState extends FileVersion {
+    buffer: Buffer;
+    partial: boolean;
+    offset: number;
+    totalSize: number;
+}
+export interface ReadBufferOptions {
+    offset?: number;
+    length?: number;
+}
+export declare class FileStateCache {
+    private readonly entries;
+    clear(filePath?: string): void;
+    read(root: string, input: string, options?: ReadBufferOptions): Promise<BufferReadState>;
+}
+export declare const fileStateCache: FileStateCache;

package/dist/src/filesystem/cache.js

@@ -0,0 +1,40 @@
+import { createHash } from "node:crypto";
+import { readFile, stat } from "node:fs/promises";
+import { inspectProjectPath } from "./path.js";
+function digest(buffer) {
+    return createHash("sha256").update(buffer).digest("hex");
+}
+export class FileStateCache {
+    entries = new Map();
+    clear(filePath) {
+        if (filePath === undefined)
+            this.entries.clear();
+        else
+            this.entries.delete(filePath);
+    }
+    async read(root, input, options = {}) {
+        const safe = await inspectProjectPath(root, input);
+        const info = await stat(safe.target);
+        const buffer = await readFile(safe.target);
+        const entry = { buffer, mtimeMs: info.mtimeMs, size: buffer.length, hash: digest(buffer) };
+        this.entries.set(safe.target, entry);
+        const offset = options.offset ?? 0;
+        const length = options.length ?? entry.buffer.length - offset;
+        if (!Number.isSafeInteger(offset) || offset < 0 || !Number.isSafeInteger(length) || length < 0) {
+            throw new Error("offset and length must be non-negative safe integers");
+        }
+        const end = Math.min(entry.buffer.length, offset + length);
+        const selectedBuffer = Buffer.from(entry.buffer.subarray(Math.min(offset, entry.buffer.length), end));
+        return {
+            buffer: selectedBuffer,
+            partial: offset !== 0 || end !== entry.buffer.length,
+            offset,
+            totalSize: entry.buffer.length,
+            mtimeMs: entry.mtimeMs,
+            size: entry.size,
+            hash: entry.hash,
+        };
+    }
+}
+export const fileStateCache = new FileStateCache();
+//# sourceMappingURL=cache.js.map