@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/pactile/capabilities/node.js.map

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

package/dist/pactile/capabilities/read.d.ts

@@ -0,0 +1,6 @@
+import type { BoundedCapabilityRequestV1 } from "../../core/index.js";
+import { type OperationResult } from "./shared.js";
+export declare function readFileCapability(root: string, request: Extract<BoundedCapabilityRequestV1, {
+    operation: "read";
+}>, signal: AbortSignal): Promise<OperationResult>;
+//# sourceMappingURL=read.d.ts.map

package/dist/pactile/capabilities/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/pactile/capabilities/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAGrB,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,0BAA0B,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EACnE,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CAoG1B"}

package/dist/pactile/capabilities/read.js

@@ -0,0 +1,100 @@
+import { StringDecoder } from "node:string_decoder";
+import { jsonBytes, operationDataBudget, stopReason, stopResult, truncateUtf8, } from "./shared.js";
+import { openVerifiedFile, realFile } from "./workspace.js";
+export async function readFileCapability(root, request, signal) {
+    const stopped = stopReason(signal);
+    if (stopped)
+        return stopResult(stopped, null);
+    const { full, stat } = await realFile(root, request.path);
+    const beforeOpenStop = stopReason(signal);
+    if (beforeOpenStop)
+        return stopResult(beforeOpenStop, null);
+    const reserve = jsonBytes({
+        path: request.path,
+        content: "",
+        bytesRead: 0,
+        totalBytes: stat.size,
+        truncated: false,
+    });
+    const contentBudget = Math.max(0, operationDataBudget(request) - reserve);
+    const byteBudget = Math.min(request.limits.maxFileBytes, request.limits.maxBytesRead, contentBudget, stat.size);
+    const handle = await openVerifiedFile(root, full, stat);
+    let buffer;
+    try {
+        const beforeReadStop = stopReason(signal);
+        if (beforeReadStop)
+            return stopResult(beforeReadStop, null);
+        buffer = Buffer.alloc(byteBudget);
+        if (byteBudget > 0) {
+            const read = await handle.read(buffer, 0, byteBudget, 0);
+            buffer = buffer.subarray(0, read.bytesRead);
+        }
+    }
+    finally {
+        await handle.close();
+    }
+    const afterReadStop = stopReason(signal);
+    if (afterReadStop)
+        return stopResult(afterReadStop, null);
+    const content = new StringDecoder("utf8").end(buffer);
+    const truncated = stat.size > byteBudget;
+    const data = {
+        path: request.path,
+        content,
+        bytesRead: buffer.length,
+        totalBytes: stat.size,
+        truncated,
+    };
+    const dataBudget = operationDataBudget(request);
+    if (jsonBytes(data) > dataBudget) {
+        let fit = content;
+        for (let attempt = 0; attempt < 64; attempt += 1) {
+            const fitted = { ...data, content: fit, truncated: true };
+            if (jsonBytes(fitted) <= dataBudget) {
+                return {
+                    data: fitted,
+                    outcome: "partial",
+                    partial: true,
+                    error: {
+                        code: "OUTPUT_LIMIT",
+                        message: "The response reached its output-byte limit.",
+                    },
+                };
+            }
+            fit = truncateUtf8(fit, Math.floor(Buffer.byteLength(fit, "utf8") * 0.75));
+        }
+        return {
+            data: null,
+            outcome: "partial",
+            partial: true,
+            error: {
+                code: "OUTPUT_LIMIT",
+                message: "The response reached its output-byte limit.",
+            },
+        };
+    }
+    if (truncated) {
+        const code = stat.size > request.limits.maxFileBytes ||
+            stat.size > request.limits.maxBytesRead
+            ? "FILE_TOO_LARGE"
+            : "OUTPUT_LIMIT";
+        return {
+            data,
+            outcome: "partial",
+            partial: true,
+            error: {
+                code,
+                message: code === "FILE_TOO_LARGE"
+                    ? "The file exceeded the request read limit."
+                    : "The response reached its output-byte limit.",
+            },
+        };
+    }
+    return {
+        data,
+        outcome: content.length === 0 ? "empty" : "complete",
+        partial: false,
+        error: null,
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/pactile/capabilities/read.js.map

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

package/dist/pactile/capabilities/receipts.d.ts

@@ -0,0 +1,17 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import type { BoundedCapabilityReceiptV1 } from "../../core/index.js";
+export interface ReceiptDirectory {
+    readonly path: string;
+    readonly device: number;
+    readonly inode: number;
+}
+export interface ReceiptClaim {
+    readonly path: string;
+    readonly handle: Awaited<ReturnType<typeof fsp.open>>;
+    readonly stat: fs.Stats;
+}
+export declare function inspectReceiptDirectory(root: string, expected?: ReceiptDirectory): Promise<ReceiptDirectory>;
+export declare function ensureReceiptDirectory(root: string): Promise<ReceiptDirectory>;
+export declare function writeReceipt(root: string, directory: ReceiptDirectory, claim: ReceiptClaim, receipt: BoundedCapabilityReceiptV1): Promise<void>;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/pactile/capabilities/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../../src/pactile/capabilities/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AAEnC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAStE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC;CACzB;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAwC3B;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAmB3B;AAgCD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/pactile/capabilities/receipts.js

@@ -0,0 +1,90 @@
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { CapabilityNodeError, RECEIPT_ROOT, isInside, mapFilesystemError, sameFileIdentity, } from "./shared.js";
+export async function inspectReceiptDirectory(root, expected) {
+    const segments = RECEIPT_ROOT.split("/");
+    let resolved = root;
+    let stat = null;
+    for (let index = 0; index < segments.length; index += 1) {
+        const lexical = path.join(root, ...segments.slice(0, index + 1));
+        try {
+            stat = await fsp.lstat(lexical);
+            resolved = await fsp.realpath(lexical);
+        }
+        catch (error) {
+            throw mapFilesystemError(error);
+        }
+        if (!stat.isDirectory() ||
+            stat.isSymbolicLink() ||
+            !isInside(root, resolved)) {
+            throw new CapabilityNodeError("OUT_OF_SCOPE", "Receipt directory must remain a real directory inside the workspace.");
+        }
+    }
+    if (!stat)
+        throw new CapabilityNodeError("NOT_FOUND", "Receipt directory is unavailable.");
+    if (expected &&
+        (expected.path !== resolved ||
+            expected.device !== stat.dev ||
+            expected.inode !== stat.ino)) {
+        throw new CapabilityNodeError("OUT_OF_SCOPE", "Receipt directory changed while the request was running.");
+    }
+    return { path: resolved, device: stat.dev, inode: stat.ino };
+}
+export async function ensureReceiptDirectory(root) {
+    for (let index = 0; index < RECEIPT_ROOT.split("/").length; index += 1) {
+        const lexical = path.join(root, ...RECEIPT_ROOT.split("/").slice(0, index + 1));
+        try {
+            await fsp.mkdir(lexical, { mode: 0o700 });
+        }
+        catch (error) {
+            const code = error && typeof error === "object" && "code" in error
+                ? String(error.code)
+                : "";
+            if (code !== "EEXIST")
+                throw mapFilesystemError(error);
+        }
+        // Check each newly observed parent before creating the next child.
+        await inspectPartialReceiptDirectory(root, index + 1);
+    }
+    return inspectReceiptDirectory(root);
+}
+async function inspectPartialReceiptDirectory(root, segmentCount) {
+    for (let index = 0; index < segmentCount; index += 1) {
+        const lexical = path.join(root, ...RECEIPT_ROOT.split("/").slice(0, index + 1));
+        let stat;
+        let resolved;
+        try {
+            stat = await fsp.lstat(lexical);
+            resolved = await fsp.realpath(lexical);
+        }
+        catch (error) {
+            throw mapFilesystemError(error);
+        }
+        if (!stat.isDirectory() ||
+            stat.isSymbolicLink() ||
+            !isInside(root, resolved)) {
+            throw new CapabilityNodeError("OUT_OF_SCOPE", "Receipt directory must remain a real directory inside the workspace.");
+        }
+    }
+}
+export async function writeReceipt(root, directory, claim, receipt) {
+    try {
+        await inspectReceiptDirectory(root, directory);
+        const [handleStat, fileStat, resolvedFile] = await Promise.all([
+            claim.handle.stat(),
+            fsp.lstat(claim.path),
+            fsp.realpath(claim.path),
+        ]);
+        if (!sameFileIdentity(claim.stat, handleStat) ||
+            !sameFileIdentity(handleStat, fileStat) ||
+            fileStat.isSymbolicLink() ||
+            !isInside(root, resolvedFile)) {
+            throw new CapabilityNodeError("OUT_OF_SCOPE", "The receipt path changed before its result could be recorded.");
+        }
+        await claim.handle.writeFile(JSON.stringify(receipt), "utf8");
+    }
+    finally {
+        await claim.handle.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=receipts.js.map

package/dist/pactile/capabilities/receipts.js.map

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

package/dist/pactile/capabilities/search.d.ts

@@ -0,0 +1,6 @@
+import type { BoundedCapabilityRequestV1 } from "../../core/index.js";
+import { type OperationResult } from "./shared.js";
+export declare function search(root: string, request: Extract<BoundedCapabilityRequestV1, {
+    operation: "search";
+}>, signal: AbortSignal, excludedPaths: readonly string[]): Promise<OperationResult>;
+//# sourceMappingURL=search.d.ts.map

package/dist/pactile/capabilities/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/pactile/capabilities/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAG3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAQrB,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,0BAA0B,EAAE;IAAE,SAAS,EAAE,QAAQ,CAAA;CAAE,CAAC,EACrE,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,eAAe,CAAC,CAqL1B"}

package/dist/pactile/capabilities/search.js

@@ -0,0 +1,181 @@
+import { CapabilityNodeError, jsonBytes, mapFilesystemError, operationDataBudget, stopReason, stopResult, truncateUtf8, } from "./shared.js";
+import { collectFiles, containsBinaryBytes, openVerifiedFile, realFile, } from "./workspace.js";
+export async function search(root, request, signal, excludedPaths) {
+    const scan = await collectFiles(root, request.directory, request.limits, signal, request.limits.maxFilesScanned + 1, excludedPaths);
+    const files = [...scan.files]
+        .sort((left, right) => (left < right ? -1 : left > right ? 1 : 0))
+        .slice(0, request.limits.maxFilesScanned);
+    const matches = [];
+    const needle = request.caseSensitive
+        ? request.query
+        : request.query.toLocaleLowerCase();
+    let filesScanned = 0;
+    let bytesRead = 0;
+    let outputLimited = false;
+    let readLimited = false;
+    let fileTooLarge = false;
+    let matchingCount = 0;
+    let hasMore = false;
+    const dataBudget = operationDataBudget(request);
+    const maxPreviewBytes = Math.min(512, Math.floor(dataBudget / 4));
+    const data = () => ({
+        matches: [...matches],
+        filesScanned,
+        bytesRead,
+    });
+    if (scan.stopped)
+        return stopResult(scan.stopped, null);
+    for (const relative of files) {
+        const stopped = stopReason(signal);
+        if (stopped)
+            return stopResult(stopped, filesScanned || matches.length ? data() : null);
+        let file;
+        try {
+            file = await realFile(root, relative);
+        }
+        catch (cause) {
+            const mapped = cause instanceof CapabilityNodeError
+                ? cause
+                : mapFilesystemError(cause);
+            if (["PERMISSION_DENIED", "NOT_FOUND"].includes(mapped.code)) {
+                scan.error ??= { code: mapped.code, message: mapped.message };
+                continue;
+            }
+            throw mapped;
+        }
+        const { full, stat } = file;
+        if (stat.size > request.limits.maxFileBytes) {
+            fileTooLarge = true;
+            continue;
+        }
+        if (bytesRead + stat.size > request.limits.maxBytesRead) {
+            readLimited = true;
+            break;
+        }
+        let contents;
+        let fileChangedWhileReading = false;
+        try {
+            const handle = await openVerifiedFile(root, full, stat);
+            try {
+                const currentStat = await handle.stat();
+                if (currentStat.size > request.limits.maxFileBytes) {
+                    fileTooLarge = true;
+                    continue;
+                }
+                if (currentStat.size > request.limits.maxBytesRead - bytesRead) {
+                    readLimited = true;
+                    break;
+                }
+                const buffer = Buffer.alloc(currentStat.size);
+                const read = await handle.read(buffer, 0, buffer.length, 0);
+                contents = buffer.subarray(0, read.bytesRead);
+                const afterReadStat = await handle.stat();
+                fileChangedWhileReading =
+                    read.bytesRead !== currentStat.size ||
+                        afterReadStat.size !== currentStat.size;
+            }
+            finally {
+                await handle.close();
+            }
+        }
+        catch (error) {
+            const mapped = error instanceof CapabilityNodeError
+                ? error
+                : mapFilesystemError(error);
+            if (mapped.code === "PERMISSION_DENIED" || mapped.code === "NOT_FOUND") {
+                scan.error ??= { code: mapped.code, message: mapped.message };
+                continue;
+            }
+            throw mapped;
+        }
+        if (fileChangedWhileReading)
+            readLimited = true;
+        bytesRead += contents.length;
+        filesScanned += 1;
+        if (containsBinaryBytes(contents))
+            continue;
+        const text = contents.toString("utf8");
+        let lineStart = 0;
+        let lineNumber = 1;
+        while (lineStart <= text.length) {
+            const nextBreak = text.indexOf("\n", lineStart);
+            const lineEnd = nextBreak === -1 ? text.length : nextBreak;
+            let line = text.slice(lineStart, lineEnd);
+            if (line.endsWith("\r"))
+                line = line.slice(0, -1);
+            const haystack = request.caseSensitive ? line : line.toLocaleLowerCase();
+            if (haystack.includes(needle)) {
+                if (matchingCount < request.offset) {
+                    matchingCount += 1;
+                    if (nextBreak === -1)
+                        break;
+                    lineStart = nextBreak + 1;
+                    lineNumber += 1;
+                    continue;
+                }
+                if (matches.length >= request.limits.maxResults) {
+                    hasMore = true;
+                    break;
+                }
+                const match = {
+                    path: relative,
+                    line: lineNumber,
+                    preview: truncateUtf8(line, maxPreviewBytes),
+                };
+                const candidate = {
+                    matches: [...matches, match],
+                    filesScanned,
+                    bytesRead,
+                };
+                if (jsonBytes(candidate) > dataBudget) {
+                    outputLimited = true;
+                    break;
+                }
+                matches.push(match);
+                matchingCount += 1;
+            }
+            if (nextBreak === -1)
+                break;
+            lineStart = nextBreak + 1;
+            lineNumber += 1;
+        }
+        if (outputLimited || hasMore)
+            break;
+    }
+    const partial = scan.partial ||
+        Boolean(scan.error) ||
+        outputLimited ||
+        hasMore ||
+        readLimited ||
+        fileTooLarge;
+    const error = outputLimited
+        ? {
+            code: "OUTPUT_LIMIT",
+            message: "The response reached its output or result-count limit.",
+        }
+        : readLimited
+            ? {
+                code: "SCAN_LIMIT",
+                message: "The request reached its total file-read limit.",
+            }
+            : fileTooLarge
+                ? {
+                    code: "FILE_TOO_LARGE",
+                    message: "One or more files exceeded the per-file scan limit.",
+                }
+                : scan.error;
+    return {
+        data: data(),
+        outcome: partial ? "partial" : matches.length === 0 ? "empty" : "complete",
+        partial,
+        error,
+        nextPage: hasMore &&
+            !scan.partial &&
+            !readLimited &&
+            !fileTooLarge &&
+            !outputLimited
+            ? request.offset + matches.length
+            : null,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/pactile/capabilities/search.js.map

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

package/dist/pactile/capabilities/shared.d.ts

@@ -0,0 +1,29 @@
+import fs from "node:fs";
+import type { BoundedCapabilityDataV1, BoundedCapabilityErrorCodeV1, BoundedCapabilityFailureV1, BoundedCapabilityOutcomeV1, BoundedCapabilityRequestV1 } from "../../core/index.js";
+export declare const RECEIPT_ROOT = ".pactile/runtime/receipts/capabilities";
+export declare const RESPONSE_ENVELOPE_RESERVE_BYTES = 1024;
+export type StopReason = "TIMEOUT" | "CANCELLED";
+export interface OperationResult {
+    readonly data: BoundedCapabilityDataV1 | null;
+    readonly outcome?: BoundedCapabilityOutcomeV1;
+    readonly partial?: boolean;
+    readonly error?: BoundedCapabilityFailureV1 | null;
+    readonly nextPage?: number | null;
+}
+export declare class CapabilityNodeError extends Error {
+    readonly code: BoundedCapabilityErrorCodeV1;
+    constructor(code: BoundedCapabilityErrorCodeV1, message: string);
+}
+export declare function safeChild(root: string, relative: string | null): string;
+export declare function isInside(root: string, candidate: string): boolean;
+export declare function relativeInside(root: string, candidate: string): string | null;
+export declare function sameFileIdentity(left: fs.Stats, right: fs.Stats): boolean;
+export declare function operationDataBudget(request: BoundedCapabilityRequestV1): number;
+export declare function isReceiptControlPath(relative: string): boolean;
+export declare function isExcludedPath(relative: string, excludedPaths: readonly string[]): boolean;
+export declare function mapFilesystemError(error: unknown): CapabilityNodeError;
+export declare function stopReason(signal: AbortSignal): StopReason | null;
+export declare function stopResult(reason: StopReason, data: BoundedCapabilityDataV1 | null): OperationResult;
+export declare function jsonBytes(value: unknown): number;
+export declare function truncateUtf8(value: string, maxBytes: number): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/pactile/capabilities/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/pactile/capabilities/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,YAAY,2CAA2C,CAAC;AAErE,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,IAAI,EAAE,4BAA4B;gBAAlC,IAAI,EAAE,4BAA4B,EAC3C,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAUvE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4B7E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,OAAO,CAEzE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAKR;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc9D;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAQT;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA2BtE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAGjE;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,uBAAuB,GAAG,IAAI,GACnC,eAAe,CAcjB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpE"}

package/dist/pactile/capabilities/shared.js

@@ -0,0 +1,134 @@
+import fs from "node:fs";
+import path from "node:path";
+export const RECEIPT_ROOT = ".pactile/runtime/receipts/capabilities";
+export const RESPONSE_ENVELOPE_RESERVE_BYTES = 1_024;
+export class CapabilityNodeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "CapabilityNodeError";
+    }
+}
+export function safeChild(root, relative) {
+    const target = relative === null ? root : path.resolve(root, ...relative.split("/"));
+    if (target !== root && !target.startsWith(`${root}${path.sep}`)) {
+        throw new CapabilityNodeError("OUT_OF_SCOPE", "Path is outside the workspace.");
+    }
+    return target;
+}
+export function isInside(root, candidate) {
+    return relativeInside(root, candidate) !== null;
+}
+export function relativeInside(root, candidate) {
+    const relative = path.relative(root, candidate);
+    if (relative === "" || (!path.isAbsolute(relative) && relative !== ".." && !relative.startsWith(`..${path.sep}`))) {
+        return relative;
+    }
+    if (process.platform !== "win32")
+        return null;
+    try {
+        const rootStat = fs.statSync(root, { bigint: true });
+        if (!rootStat.isDirectory() || rootStat.ino === 0n)
+            return null;
+        let current = path.resolve(candidate);
+        const segments = [];
+        while (true) {
+            try {
+                const stat = fs.statSync(current, { bigint: true });
+                if (stat.isDirectory() && stat.dev === rootStat.dev && stat.ino === rootStat.ino) {
+                    return segments.reverse().join(path.sep);
+                }
+            }
+            catch {
+                // An absent leaf can still have a physically verified parent.
+            }
+            const parent = path.dirname(current);
+            if (parent === current)
+                return null;
+            segments.push(path.basename(current));
+            current = parent;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+export function sameFileIdentity(left, right) {
+    return left.dev === right.dev && left.ino === right.ino;
+}
+export function operationDataBudget(request) {
+    return Math.max(0, request.limits.maxOutputBytes - RESPONSE_ENVELOPE_RESERVE_BYTES);
+}
+export function isReceiptControlPath(relative) {
+    const relativePath = relative.replaceAll("\\", "/");
+    const normalized = process.platform === "win32"
+        ? relativePath.toLocaleLowerCase()
+        : relativePath;
+    const receiptRoot = process.platform === "win32"
+        ? RECEIPT_ROOT.toLocaleLowerCase()
+        : RECEIPT_ROOT;
+    return (normalized === ".pactile/runtime/receipts" ||
+        normalized.startsWith(`${receiptRoot}/`));
+}
+export function isExcludedPath(relative, excludedPaths) {
+    const normalized = relative.replaceAll("\\", "/");
+    return excludedPaths.some((candidate) => process.platform === "win32"
+        ? candidate.replaceAll("\\", "/").toLocaleLowerCase() ===
+            normalized.toLocaleLowerCase()
+        : candidate.replaceAll("\\", "/") === normalized);
+}
+export function mapFilesystemError(error) {
+    const code = error && typeof error === "object" && "code" in error
+        ? String(error.code)
+        : "";
+    if (code === "ENOENT" || code === "ENOTDIR") {
+        return new CapabilityNodeError("NOT_FOUND", "Requested path was not found.");
+    }
+    if (code === "ELOOP" || code === "EMLINK") {
+        return new CapabilityNodeError("OUT_OF_SCOPE", "The requested path changed into a symbolic link.");
+    }
+    if (code === "EACCES" || code === "EPERM") {
+        return new CapabilityNodeError("PERMISSION_DENIED", "Access to the requested path was denied.");
+    }
+    return new CapabilityNodeError("EXECUTION_FAILED", "The filesystem operation failed.");
+}
+export function stopReason(signal) {
+    if (!signal.aborted)
+        return null;
+    return signal.reason === "TIMEOUT" ? "TIMEOUT" : "CANCELLED";
+}
+export function stopResult(reason, data) {
+    const code = reason;
+    return {
+        data,
+        outcome: reason === "TIMEOUT" ? "timed_out" : "cancelled",
+        partial: data !== null,
+        error: {
+            code,
+            message: reason === "TIMEOUT"
+                ? "The request exceeded its time limit."
+                : "The request was cancelled.",
+        },
+    };
+}
+export function jsonBytes(value) {
+    return Buffer.byteLength(JSON.stringify(value), "utf8");
+}
+export function truncateUtf8(value, maxBytes) {
+    if (maxBytes <= 0)
+        return "";
+    if (Buffer.byteLength(value, "utf8") <= maxBytes)
+        return value;
+    let output = "";
+    let used = 0;
+    for (const character of value) {
+        const bytes = Buffer.byteLength(character, "utf8");
+        if (used + bytes > maxBytes)
+            break;
+        output += character;
+        used += bytes;
+    }
+    return output;
+}
+//# sourceMappingURL=shared.js.map