@j0hanz/fs-context-mcp 2.0.0 → 2.0.2

package/dist/lib/observability/diagnostics-helpers.js

@@ -0,0 +1,50 @@
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasBooleanOk(value) {
+    return isObject(value) && typeof value.ok === 'boolean';
+}
+export function resolveDiagnosticsOk(result) {
+    if (!isObject(result))
+        return undefined;
+    if (result.isError === true)
+        return false;
+    if (hasBooleanOk(result))
+        return result.ok;
+    const structured = result.structuredContent;
+    if (hasBooleanOk(structured))
+        return structured.ok;
+    return undefined;
+}
+function resolvePrimitiveDiagnosticsMessage(error) {
+    if (typeof error === 'string')
+        return error;
+    if (typeof error === 'number' || typeof error === 'boolean') {
+        return String(error);
+    }
+    if (typeof error === 'bigint')
+        return error.toString();
+    if (typeof error === 'symbol')
+        return error.description ?? 'symbol';
+    return undefined;
+}
+function resolveObjectDiagnosticsMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (isObject(error) && typeof error.message === 'string') {
+        return error.message;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolveDiagnosticsErrorMessage(error) {
+    if (error === undefined || error === null)
+        return undefined;
+    return (resolvePrimitiveDiagnosticsMessage(error) ??
+        resolveObjectDiagnosticsMessage(error));
+}
+//# sourceMappingURL=diagnostics-helpers.js.map

package/dist/lib/observability/diagnostics-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-helpers.js","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics-helpers.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC5C,IAAI,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC,EAAE,CAAC;IAEnD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,kCAAkC,CACzC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAc;IACrD,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAe;IAEf,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,CACL,kCAAkC,CAAC,KAAK,CAAC;QACzC,+BAA+B,CAAC,KAAK,CAAC,CACvC,CAAC;AACJ,CAAC"}

package/dist/lib/observability/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,OAAO,GACb,IAAI,CAKN;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,CAAC,CAAC,CAkBZ"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/diagnostics.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgKD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,OAAO,GACb,IAAI,CAKN;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/dist/lib/observability/diagnostics.js

@@ -1,27 +1,10 @@
 import { createHash } from 'node:crypto';
 import { channel, tracingChannel } from 'node:diagnostics_channel';
+import { resolveDiagnosticsErrorMessage, resolveDiagnosticsOk, } from './diagnostics-helpers.js';
 import { captureEventLoopUtilization, diffEventLoopUtilization, } from './perf.js';
 const TOOL_CHANNEL = channel('fs-context:tool');
 const PERF_CHANNEL = channel('fs-context:perf');
 const OPS_TRACE = tracingChannel('fs-context:ops');
-function isObject(value) {
-    return typeof value === 'object' && value !== null;
-}
-function hasBooleanOk(value) {
-    return isObject(value) && typeof value.ok === 'boolean';
-}
-function resolveDiagnosticsOk(result) {
-    if (!isObject(result))
-        return undefined;
-    if (result.isError === true)
-        return false;
-    if (hasBooleanOk(result))
-        return result.ok;
-    const structured = result.structuredContent;
-    if (hasBooleanOk(structured))
-        return structured.ok;
-    return undefined;
-}
 function parseDiagnosticsEnabled() {
     const normalized = process.env.FS_CONTEXT_DIAGNOSTICS?.trim().toLowerCase();
     return normalized === '1' || normalized === 'true' || normalized === 'yes';
@@ -46,56 +29,38 @@ function normalizePathForDiagnostics(path) {
     return hashPath(path);
 }
 function normalizeOpsTraceContext(context) {
-    return context.path
-        ? { ...context, path: normalizePathForDiagnostics(context.path) }
-        : context;
-}
-function resolvePrimitiveDiagnosticsMessage(error) {
-    if (typeof error === 'string')
-        return error;
-    if (typeof error === 'number' || typeof error === 'boolean') {
-        return String(error);
-    }
-    if (typeof error === 'bigint')
-        return error.toString();
-    if (typeof error === 'symbol')
-        return error.description ?? 'symbol';
-    return undefined;
-}
-function resolveObjectDiagnosticsMessage(error) {
-    if (error instanceof Error)
-        return error.message;
-    if (isObject(error) && typeof error.message === 'string') {
-        return error.message;
-    }
-    try {
-        return JSON.stringify(error);
-    }
-    catch {
-        return undefined;
+    if (!context.path)
+        return context;
+    const normalizedPath = normalizePathForDiagnostics(context.path);
+    if (!normalizedPath) {
+        const sanitized = { ...context };
+        delete sanitized.path;
+        return sanitized;
     }
-}
-function resolveDiagnosticsErrorMessage(error) {
-    if (error === undefined || error === null)
-        return undefined;
-    return (resolvePrimitiveDiagnosticsMessage(error) ??
-        resolveObjectDiagnosticsMessage(error));
+    return { ...context, path: normalizedPath };
 }
 function publishStartEvent(tool, options) {
-    TOOL_CHANNEL.publish({
-        phase: 'start',
-        tool,
-        path: options?.path ? normalizePathForDiagnostics(options.path) : undefined,
-    });
+    const event = { phase: 'start', tool };
+    const normalizedPath = options?.path
+        ? normalizePathForDiagnostics(options.path)
+        : undefined;
+    if (normalizedPath !== undefined) {
+        event.path = normalizedPath;
+    }
+    TOOL_CHANNEL.publish(event);
 }
 function publishEndEvent(tool, ok, durationMs, error) {
-    TOOL_CHANNEL.publish({
+    const event = {
         phase: 'end',
         tool,
         ok,
-        error: resolveDiagnosticsErrorMessage(error),
         durationMs,
-    });
+    };
+    const message = resolveDiagnosticsErrorMessage(error);
+    if (message !== undefined) {
+        event.error = message;
+    }
+    TOOL_CHANNEL.publish(event);
 }
 function publishPerfEndEvent(tool, durationMs, elu) {
     PERF_CHANNEL.publish({

package/dist/lib/observability/diagnostics.js.map

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

package/dist/lib/observability.d.ts

@@ -0,0 +1,15 @@
+export interface OpsTraceContext {
+    op: string;
+    engine?: string;
+    tool?: string;
+    path?: string;
+    [key: string]: unknown;
+}
+export declare function shouldPublishOpsTrace(): boolean;
+export declare function publishOpsTraceStart(context: OpsTraceContext): void;
+export declare function publishOpsTraceEnd(context: OpsTraceContext): void;
+export declare function publishOpsTraceError(context: OpsTraceContext, error: unknown): void;
+export declare function withToolDiagnostics<T>(tool: string, run: () => Promise<T>, options?: {
+    path?: string;
+}): Promise<T>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/lib/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/lib/observability.ts"],"names":[],"mappings":"AAuFA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgKD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,OAAO,GACb,IAAI,CAKN;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/dist/lib/observability.js

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import { channel, tracingChannel } from 'node:diagnostics_channel';
+import { performance } from 'node:perf_hooks';
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasBooleanOk(value) {
+    return isObject(value) && typeof value.ok === 'boolean';
+}
+function resolveDiagnosticsOk(result) {
+    if (!isObject(result))
+        return undefined;
+    if (result.isError === true)
+        return false;
+    if (hasBooleanOk(result))
+        return result.ok;
+    const structured = result.structuredContent;
+    if (hasBooleanOk(structured))
+        return structured.ok;
+    return undefined;
+}
+function resolvePrimitiveDiagnosticsMessage(error) {
+    if (typeof error === 'string')
+        return error;
+    if (typeof error === 'number' || typeof error === 'boolean') {
+        return String(error);
+    }
+    if (typeof error === 'bigint')
+        return error.toString();
+    if (typeof error === 'symbol')
+        return error.description ?? 'symbol';
+    return undefined;
+}
+function resolveObjectDiagnosticsMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (isObject(error) && typeof error.message === 'string') {
+        return error.message;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveDiagnosticsErrorMessage(error) {
+    if (error === undefined || error === null)
+        return undefined;
+    return (resolvePrimitiveDiagnosticsMessage(error) ??
+        resolveObjectDiagnosticsMessage(error));
+}
+function captureEventLoopUtilization() {
+    return performance.eventLoopUtilization();
+}
+function diffEventLoopUtilization(start) {
+    return performance.eventLoopUtilization(start);
+}
+const TOOL_CHANNEL = channel('fs-context:tool');
+const PERF_CHANNEL = channel('fs-context:perf');
+const OPS_TRACE = tracingChannel('fs-context:ops');
+function parseDiagnosticsEnabled() {
+    const normalized = process.env.FS_CONTEXT_DIAGNOSTICS?.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes';
+}
+function parseDiagnosticsDetail() {
+    const normalized = process.env.FS_CONTEXT_DIAGNOSTICS_DETAIL?.trim();
+    if (normalized === '2')
+        return 2;
+    if (normalized === '1')
+        return 1;
+    return 0;
+}
+function hashPath(value) {
+    return createHash('sha256').update(value).digest('hex').slice(0, 16);
+}
+function normalizePathForDiagnostics(pathValue) {
+    const detail = parseDiagnosticsDetail();
+    if (detail === 0)
+        return undefined;
+    if (detail === 2)
+        return pathValue;
+    return hashPath(pathValue);
+}
+function normalizeOpsTraceContext(context) {
+    if (!context.path)
+        return context;
+    const normalizedPath = normalizePathForDiagnostics(context.path);
+    if (!normalizedPath) {
+        const sanitized = { ...context };
+        delete sanitized.path;
+        return sanitized;
+    }
+    return { ...context, path: normalizedPath };
+}
+function publishStartEvent(tool, options) {
+    const event = { phase: 'start', tool };
+    const normalizedPath = options?.path
+        ? normalizePathForDiagnostics(options.path)
+        : undefined;
+    if (normalizedPath !== undefined) {
+        event.path = normalizedPath;
+    }
+    TOOL_CHANNEL.publish(event);
+}
+function publishEndEvent(tool, ok, durationMs, error) {
+    const event = {
+        phase: 'end',
+        tool,
+        ok,
+        durationMs,
+    };
+    const message = resolveDiagnosticsErrorMessage(error);
+    if (message !== undefined) {
+        event.error = message;
+    }
+    TOOL_CHANNEL.publish(event);
+}
+function publishPerfEndEvent(tool, durationMs, elu) {
+    PERF_CHANNEL.publish({
+        phase: 'end',
+        tool,
+        durationMs,
+        elu: {
+            idle: elu.idle,
+            active: elu.active,
+            utilization: elu.utilization,
+        },
+    });
+}
+function startToolDiagnostics(tool, options, shouldPublishTool, shouldPublishPerf) {
+    const startNs = process.hrtime.bigint();
+    const eluStart = shouldPublishPerf
+        ? captureEventLoopUtilization()
+        : undefined;
+    if (shouldPublishTool)
+        publishStartEvent(tool, options);
+    return { startNs, eluStart };
+}
+function finalizeToolDiagnostics(tool, startNs, options) {
+    const endNs = process.hrtime.bigint();
+    const durationMs = Number(endNs - startNs) / 1_000_000;
+    if (options.shouldPublishPerf && options.eluStart) {
+        publishPerfEndEvent(tool, durationMs, diffEventLoopUtilization(options.eluStart));
+    }
+    if (options.shouldPublishTool) {
+        publishEndEvent(tool, options.ok, durationMs, options.error);
+    }
+}
+async function runWithDiagnostics(tool, run, options, shouldPublishTool, shouldPublishPerf) {
+    const { startNs, eluStart } = startToolDiagnostics(tool, options, shouldPublishTool, shouldPublishPerf);
+    const finalizeOptions = { shouldPublishTool, shouldPublishPerf, eluStart };
+    try {
+        const result = await run();
+        finalizeToolDiagnostics(tool, startNs, {
+            ok: resolveDiagnosticsOk(result) ?? true,
+            ...finalizeOptions,
+        });
+        return result;
+    }
+    catch (error) {
+        finalizeToolDiagnostics(tool, startNs, {
+            ok: false,
+            error,
+            ...finalizeOptions,
+        });
+        throw error;
+    }
+}
+export function shouldPublishOpsTrace() {
+    return parseDiagnosticsEnabled() && OPS_TRACE.hasSubscribers;
+}
+export function publishOpsTraceStart(context) {
+    OPS_TRACE.start.publish(normalizeOpsTraceContext(context));
+}
+export function publishOpsTraceEnd(context) {
+    OPS_TRACE.end.publish(normalizeOpsTraceContext(context));
+}
+export function publishOpsTraceError(context, error) {
+    OPS_TRACE.error.publish({
+        ...normalizeOpsTraceContext(context),
+        error,
+    });
+}
+export async function withToolDiagnostics(tool, run, options) {
+    if (!parseDiagnosticsEnabled()) {
+        return await run();
+    }
+    const shouldPublishTool = TOOL_CHANNEL.hasSubscribers;
+    const shouldPublishPerf = PERF_CHANNEL.hasSubscribers;
+    if (!shouldPublishTool && !shouldPublishPerf) {
+        return await run();
+    }
+    return await runWithDiagnostics(tool, run, options, shouldPublishTool, shouldPublishPerf);
+}
+//# sourceMappingURL=observability.js.map

package/dist/lib/observability.js.map

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

package/dist/lib/path-validation/validate-existing.js

@@ -39,7 +39,7 @@ async function validateExistingPathDetailsInternal(requestedPath, signal) {
     const realPath = await resolveRealPathOrThrow({
         requestedPath,
         normalizedRequested,
-        signal,
+        ...(signal ? { signal } : {}),
     });
     const normalizedReal = normalizePath(realPath);
     if (!isPathWithinDirectories(normalizedReal, allowedDirs)) {

package/dist/lib/path-validation/validate-existing.js.map

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

package/dist/lib/path-validation.d.ts

@@ -1,6 +1,19 @@
-export { getAllowedDirectories, isPathWithinDirectories, setAllowedDirectoriesResolved, } from './path-validation/allowed-directories.js';
-export { toAccessDeniedWithHint } from './path-validation/path-errors.js';
-export { RESERVED_DEVICE_NAMES } from './path-validation/path-rules.js';
-export { validateExistingDirectory, validateExistingPath, validateExistingPathDetailed, } from './path-validation/validate-existing.js';
-export { getValidRootDirectories } from './path-validation/roots.js';
+import type { Root } from '@modelcontextprotocol/sdk/types.js';
+import { McpError } from './errors.js';
+export declare function normalizePath(p: string): string;
+export declare function getAllowedDirectories(): string[];
+export declare function isPathWithinDirectories(normalizedPath: string, allowedDirs: readonly string[]): boolean;
+export declare function setAllowedDirectoriesResolved(dirs: readonly string[], signal?: AbortSignal): Promise<void>;
+export declare const RESERVED_DEVICE_NAMES: Set<string>;
+export declare function toAccessDeniedWithHint(requestedPath: string, resolvedPath: string, normalizedResolved: string): McpError;
+interface ValidatedPathDetails {
+    requestedPath: string;
+    resolvedPath: string;
+    isSymlink: boolean;
+}
+export declare function validateExistingPathDetailed(requestedPath: string, signal?: AbortSignal): Promise<ValidatedPathDetails>;
+export declare function validateExistingPath(requestedPath: string, signal?: AbortSignal): Promise<string>;
+export declare function validateExistingDirectory(requestedPath: string, signal?: AbortSignal): Promise<string>;
+export declare function getValidRootDirectories(roots: Root[], signal?: AbortSignal): Promise<string[]>;
+export {};
 //# sourceMappingURL=path-validation.d.ts.map

package/dist/lib/path-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-validation.d.ts","sourceRoot":"","sources":["../../src/lib/path-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"path-validation.d.ts","sourceRoot":"","sources":["../../src/lib/path-validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,EAA0B,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU/D,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAS/C;AAmDD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAKT;AAuCD,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,eAAO,MAAM,qBAAqB,aAuBhC,CAAC;AAqJH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,GACzB,QAAQ,CAQV;AAED,UAAU,oBAAoB;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AA6ED,wBAAsB,4BAA4B,CAChD,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAejB;AA+CD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB"}