@veryfront/ext-content-mdx 0.1.1119 → 0.1.1122

package/esm/src/observability/tracing/otlp-setup.js

@@ -0,0 +1,219 @@
+/**************************
+ * OpenTelemetry OTLP Setup
+ *
+ * Thin wrapper that delegates to the `ext-observability-opentelemetry` extension via the
+ * `TracingExporter` contract.  When the extension is not installed, all span
+ * operations silently no-op.
+ *
+ * Reads configuration from environment variables:
+ * - OTEL_TRACES_ENABLED: "true" to enable tracing
+ * - OTEL_SERVICE_NAME: Service name for traces
+ * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint
+ * - OTEL_EXPORTER_OTLP_HEADERS: Auth headers
+ **************************/
+import { isTruthyEnvValue } from "../../utils/constants/env.js";
+import { serverLogger } from "../../utils/logger/logger.js";
+import { context as shimContext, defaultTextMapGetter, defaultTextMapSetter, getTracer, getTracerProviderRevision, propagation as shimPropagation, SpanKind, SpanStatusCode, trace as shimTrace, } from "./api-shim.js";
+import { getHostTelemetryEnv } from "./telemetry-env.js";
+const logger = serverLogger.component("otel");
+function parseHeaders(headerString) {
+    if (!headerString)
+        return {};
+    if (headerString.startsWith("Basic "))
+        return { Authorization: headerString };
+    if (headerString.startsWith("Authorization=")) {
+        return { Authorization: headerString.substring("Authorization=".length) };
+    }
+    const headers = {};
+    for (const part of headerString.split(",")) {
+        const [key, ...valueParts] = part.split("=");
+        if (!key || valueParts.length === 0)
+            continue;
+        headers[key.trim()] = valueParts.join("=").trim();
+    }
+    return headers;
+}
+function getConfig() {
+    // Span helpers can run during module initialization and test setup, before
+    // bootstrap has loaded .env files. Read tracing env directly here so no-op
+    // spans do not force early EnvironmentConfig initialization.
+    return {
+        enabled: isTruthyEnvValue(getHostTelemetryEnv("VERYFRONT_OTEL")) ||
+            isTruthyEnvValue(getHostTelemetryEnv("OTEL_TRACES_ENABLED")),
+        serviceName: getHostTelemetryEnv("OTEL_SERVICE_NAME") || "veryfront",
+        endpoint: getHostTelemetryEnv("OTEL_EXPORTER_OTLP_ENDPOINT") || "",
+        headers: parseHeaders(getHostTelemetryEnv("OTEL_EXPORTER_OTLP_HEADERS")),
+    };
+}
+let cachedTracingRuntime;
+function getTracingRuntime() {
+    const providerRevision = getTracerProviderRevision();
+    if (!cachedTracingRuntime || cachedTracingRuntime.providerRevision !== providerRevision) {
+        const config = getConfig();
+        cachedTracingRuntime = {
+            providerRevision,
+            config,
+            tracer: getTracer(config.serviceName),
+        };
+    }
+    return cachedTracingRuntime;
+}
+// ---------------------------------------------------------------------------
+// Legacy initialise / shutdown (now delegated to bootstrap.ts + ext)
+// ---------------------------------------------------------------------------
+let initialized = false;
+/** Initialize OTLP tracing export. */
+export async function initializeOTLP() {
+    if (initialized) {
+        logger.debug("Already initialized");
+        return;
+    }
+    // Actual provider setup is handled by ext-observability-opentelemetry via bootstrap.
+    // This is kept for backward compatibility.
+    initialized = true;
+    logger.debug("OTLP setup delegated to ext-observability-opentelemetry extension");
+}
+/** Shut down OTLP tracing export. */
+export async function shutdownOTLP() {
+    // Actual shutdown is handled by the extension loader teardown.
+    logger.debug("OTLP shutdown delegated to ext-observability-opentelemetry extension");
+}
+/** Check whether OTLP export is enabled. */
+export function isOTLPEnabled() {
+    return initialized;
+}
+/** Initialize OTLP tracing with explicit API adapters. */
+export async function initializeOTLPWithApis() {
+    await initializeOTLP();
+}
+// ---------------------------------------------------------------------------
+// Span helpers — delegate to shim (which delegates to SDK if wired)
+// ---------------------------------------------------------------------------
+function setSpanErrorStatus(span, error) {
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error),
+    });
+    if (error instanceof Error)
+        span.recordException(error);
+}
+/** Applies span. */
+export async function withSpan(name, fn, attributes, options) {
+    const { tracer } = getTracingRuntime();
+    const parentContext = shimContext.active();
+    const span = tracer.startSpan(name, { kind: options?.kind ?? SpanKind.INTERNAL, attributes }, parentContext);
+    const spanContext = shimTrace.setSpan(parentContext, span);
+    try {
+        const result = await shimContext.with(spanContext, () => fn(span));
+        return result;
+    }
+    catch (error) {
+        setSpanErrorStatus(span, error);
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+/** Applies span sync. */
+export function withSpanSync(name, fn, attributes, options) {
+    const { tracer } = getTracingRuntime();
+    const parentContext = shimContext.active();
+    const span = tracer.startSpan(name, { kind: options?.kind ?? SpanKind.INTERNAL, attributes }, parentContext);
+    try {
+        const result = fn();
+        span.setStatus({ code: SpanStatusCode.OK });
+        return result;
+    }
+    catch (error) {
+        setSpanErrorStatus(span, error);
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+/** Context for extract. */
+export function extractContext(headers) {
+    const carrier = {};
+    for (const [k, v] of headers)
+        carrier[k.toLowerCase()] = v;
+    return shimPropagation.extract(shimContext.active(), carrier, defaultTextMapGetter);
+}
+/** Context for inject. */
+export function injectContext(headers) {
+    const carrier = {};
+    shimPropagation.inject(shimContext.active(), carrier, defaultTextMapSetter);
+    for (const [k, v] of Object.entries(carrier))
+        headers.set(k, v);
+}
+/** Starts server span. */
+export function startServerSpan(method, path, parentContext) {
+    const { tracer } = getTracingRuntime();
+    const ctx = (parentContext || shimContext.active());
+    const span = tracer.startSpan(`${method} ${path}`, { kind: SpanKind.SERVER }, ctx);
+    span.setAttribute("http.method", method);
+    span.setAttribute("http.target", path);
+    return { span, context: shimTrace.setSpan(ctx, span) };
+}
+/** End an active server tracing span. */
+export function endServerSpan(span, statusCode, error) {
+    if (!span)
+        return;
+    const otelSpan = span;
+    otelSpan.setAttribute("http.status_code", statusCode);
+    if (error) {
+        setSpanErrorStatus(otelSpan, error);
+        otelSpan.end();
+        return;
+    }
+    if (statusCode >= 400) {
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR });
+        otelSpan.end();
+        return;
+    }
+    otelSpan.setStatus({ code: SpanStatusCode.OK });
+    otelSpan.end();
+}
+/** Sets span attributes. */
+export function setSpanAttributes(span, attributes) {
+    if (!span)
+        return;
+    const otelSpan = span;
+    for (const [key, value] of Object.entries(attributes))
+        otelSpan.setAttribute(key, value);
+}
+/** Adds an event to a span. */
+export function addSpanEvent(span, name, attributes) {
+    if (!span)
+        return;
+    const otelSpan = span;
+    otelSpan.addEvent(name, attributes);
+}
+/** Sets active span attributes. */
+export function setActiveSpanAttributes(attributes) {
+    const span = shimTrace.getActiveSpan?.();
+    if (!span)
+        return;
+    for (const [key, value] of Object.entries(attributes))
+        span.setAttribute(key, value);
+}
+/** Marks the active span as failed. */
+export function setActiveSpanErrorStatus(error) {
+    const span = shimTrace.getActiveSpan?.();
+    if (!span)
+        return;
+    setSpanErrorStatus(span, error);
+}
+/** Context for with. */
+export async function withContext(spanContext, fn) {
+    return shimContext.with(spanContext, fn);
+}
+/** Context for get trace. */
+export function getTraceContext() {
+    const span = shimTrace.getActiveSpan?.();
+    if (!span)
+        return {};
+    const ctx = span.spanContext();
+    return { traceId: ctx.traceId, spanId: ctx.spanId };
+}

package/esm/src/observability/tracing/telemetry-env.d.ts

@@ -0,0 +1,3 @@
+export declare function getHostTelemetryEnv(key: string): string | undefined;
+export declare function isReservedSharedRuntimeTelemetryEnvKey(key: string): boolean;
+//# sourceMappingURL=telemetry-env.d.ts.map

package/esm/src/observability/tracing/telemetry-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-env.d.ts","sourceRoot":"","sources":["../../../../src/src/observability/tracing/telemetry-env.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,wBAAgB,sCAAsC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/esm/src/observability/tracing/telemetry-env.js

@@ -0,0 +1,10 @@
+import { getHostEnv } from "../../platform/compat/process.js";
+const RESERVED_SHARED_RUNTIME_TELEMETRY_ENV_KEYS = new Set([
+    "VERYFRONT_OTEL",
+]);
+export function getHostTelemetryEnv(key) {
+    return getHostEnv(key);
+}
+export function isReservedSharedRuntimeTelemetryEnvKey(key) {
+    return key.startsWith("OTEL_") || RESERVED_SHARED_RUNTIME_TELEMETRY_ENV_KEYS.has(key);
+}

package/esm/src/platform/adapters/base.d.ts

@@ -0,0 +1,209 @@
+/***********************
+ * Runtime identifier for platform-specific code paths
+ ***********************/
+export type RuntimeId = "deno" | "node" | "bun" | "cloudflare" | "memory";
+/**
+ * Core runtime adapter interface
+ *
+ * Provides a unified abstraction over runtime-specific APIs (Deno, Node.js, Bun, Cloudflare Workers).
+ * All platform-specific code should go through this adapter to ensure cross-platform compatibility.
+ */
+export interface RuntimeAdapter {
+    /** Unique identifier for this runtime */
+    readonly id: RuntimeId;
+    /** Human-readable name for logging */
+    readonly name: string;
+    /** Runtime capabilities for feature detection */
+    readonly capabilities: RuntimeCapabilities;
+    /** Filesystem operations */
+    fs: FileSystemAdapter;
+    /** Environment variable access */
+    env: EnvironmentAdapter;
+    /** HTTP server operations */
+    server: ServerAdapter;
+    serve(handler: (request: Request) => Promise<Response> | Response, options: ServeOptions): Promise<Server>;
+    /** Shell operations (sync fs for CLI) */
+    shell?: ShellAdapter;
+    /** Key-value store (Cloudflare KV, Deno KV) */
+    kv?: KVStoreAdapter;
+    /** File watcher (not available on Workers) */
+    watcher?: FileWatcherAdapter;
+    /** Initialize the adapter (called once before first use) */
+    initialize?(): Promise<void>;
+    /** Clean shutdown (close connections, etc.) */
+    shutdown?(): Promise<void>;
+}
+/**
+ * Runtime capabilities for feature detection
+ */
+export interface RuntimeCapabilities {
+    /** Native TypeScript support without compilation */
+    typescript: boolean;
+    /** Native JSX/TSX support */
+    jsx: boolean;
+    /** HTTP/2 server support */
+    http2: boolean;
+    /** WebSocket support */
+    websocket: boolean;
+    /** Web Workers / Worker threads support */
+    workers: boolean;
+    /** File system watching */
+    fileWatching: boolean;
+    /** Shell command execution */
+    shell: boolean;
+    /** Key-value store available */
+    kvStore: boolean;
+    /** Writable filesystem (false for Workers without KV) */
+    writableFs: boolean;
+}
+export interface WebSocketUpgradeOptions {
+    protocol?: string;
+    headers?: Headers | Record<string, string>;
+    idleTimeout?: number;
+}
+export interface ServerAdapter {
+    upgradeWebSocket(request: Request, options?: WebSocketUpgradeOptions): WebSocketUpgrade;
+}
+export interface WebSocketConnection {
+    readonly readyState: number;
+    send(data: string | ArrayBuffer): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, listener: EventListener, options?: AddEventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListener): void;
+}
+declare const WEBSOCKET_UPGRADE_RESPONSE_KIND = "websocket-upgrade";
+export interface WebSocketUpgradeResponse {
+    readonly kind: typeof WEBSOCKET_UPGRADE_RESPONSE_KIND;
+    readonly status: 101;
+    readonly statusText: string;
+    readonly headers: Headers;
+    readonly body: null;
+}
+export interface WebSocketUpgrade {
+    socket: WebSocketConnection;
+    response: Response | WebSocketUpgradeResponse;
+}
+export declare function createWebSocketUpgradeResponse(input?: {
+    headers?: HeadersInit;
+    statusText?: string;
+}): WebSocketUpgradeResponse;
+export declare function isWebSocketUpgradeResponse(value: unknown): value is WebSocketUpgradeResponse;
+export interface ServeOptions {
+    port?: number;
+    hostname?: string;
+    signal?: AbortSignal;
+    onListen?: (params: {
+        hostname: string;
+        port: number;
+    }) => void;
+}
+export interface Server {
+    stop(): Promise<void>;
+    addr: {
+        hostname: string;
+        port: number;
+    };
+}
+export interface FileSystemAdapter {
+    readFile(path: string): Promise<string>;
+    /** Read raw bytes when binary-safe access is required */
+    readFileBytes?(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    readDir(path: string): AsyncIterable<DirEntry>;
+    stat(path: string): Promise<FileInfo>;
+    /**
+     * Stat a path WITHOUT following a terminal symlink (lstat semantics).
+     * Unlike stat(), which follows symlinks and therefore always reports
+     * isSymlink:false for a link, this reports isSymlink:true for the link
+     * itself. Used by path validation to detect symlink escapes. Optional:
+     * virtual/remote filesystems that have no OS-level symlinks may omit it.
+     */
+    lstat?(path: string): Promise<FileInfo>;
+    /**
+     * Resolve a path to its canonical physical form, following all symlinks.
+     * Used by path validation to check containment against the real target so a
+     * symlink whose target escapes the base directory can be rejected. Throws if
+     * the path does not exist. Optional: virtual/remote filesystems that have no
+     * OS-level symlinks may omit it.
+     */
+    realPath?(path: string): Promise<string>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    remove(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    makeTempDir(prefix: string): Promise<string>;
+    watch(paths: string | string[], options?: WatchOptions): FileWatcher;
+    /** Resolve a file path with extension fallback (e.g., pages/test → pages/test.mdx) */
+    resolveFile?(basePath: string, options?: ResolveFileOptions): Promise<string | null>;
+    /** Refresh remote source snapshots when a preview render detects stale cached content. */
+    refreshSourceSnapshot?(reason?: string): Promise<void>;
+}
+export interface ResolveFileOptions {
+    allowPagesPrefix?: boolean;
+}
+export interface DirEntry {
+    name: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymlink: boolean;
+}
+export interface FileInfo {
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymlink: boolean;
+    mtime: Date | null;
+}
+export interface EnvironmentAdapter {
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    toObject(): Record<string, string>;
+}
+export interface WatchOptions {
+    recursive?: boolean;
+    signal?: AbortSignal;
+}
+export type FileChangeKind = "create" | "modify" | "delete" | "any";
+export interface FileChangeEvent {
+    kind: FileChangeKind;
+    paths: string[];
+}
+export interface FileWatcher extends AsyncIterable<FileChangeEvent> {
+    close(): void;
+    /**
+     * Resolves once the watcher's internal loop has fully stopped, including
+     * any in-flight filesystem operations. close() only signals shutdown;
+     * await this to guarantee no pending async ops remain (e.g. before test
+     * sanitizer checks or process exit).
+     */
+    done?: Promise<void>;
+}
+export interface ShellAdapter {
+    statSync(path: string): {
+        isFile: boolean;
+        isDirectory: boolean;
+    };
+    readFileSync(path: string): string;
+}
+/**
+ * Key-value store adapter for Cloudflare KV, Deno KV, etc.
+ */
+export interface KVStoreAdapter {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): AsyncIterable<string>;
+}
+/**
+ * File watcher adapter for development mode
+ */
+export interface FileWatcherAdapter {
+    watch(paths: string | string[], options?: WatchOptions): FileWatcher;
+}
+export {};
+//# sourceMappingURL=base.d.ts.map

package/esm/src/platform/adapters/base.d.ts.map

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

package/esm/src/platform/adapters/base.js

@@ -0,0 +1,15 @@
+const WEBSOCKET_UPGRADE_RESPONSE_KIND = "websocket-upgrade";
+export function createWebSocketUpgradeResponse(input = {}) {
+    return {
+        kind: WEBSOCKET_UPGRADE_RESPONSE_KIND,
+        status: 101,
+        statusText: input.statusText ?? "Switching Protocols",
+        headers: new Headers(input.headers),
+        body: null,
+    };
+}
+export function isWebSocketUpgradeResponse(value) {
+    return typeof value === "object" && value !== null &&
+        value.kind === WEBSOCKET_UPGRADE_RESPONSE_KIND &&
+        value.status === 101;
+}

package/esm/src/platform/compat/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Platform-level constants that don't depend on configuration.
+ * These are simple values used by HTTP servers and adapters.
+ *
+ * Note: config/defaults.ts re-exports DEFAULT_PORT for higher layers.
+ */
+export declare const DEFAULT_PORT = 3000;
+export declare const LOCALHOST: {
+    readonly IPV4: "127.0.0.1";
+    readonly IPV6: "::1";
+    readonly HOSTNAME: "localhost";
+};
+//# sourceMappingURL=constants.d.ts.map

package/esm/src/platform/compat/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,SAAS;;;;CAIZ,CAAC"}

package/esm/src/platform/compat/constants.js

@@ -0,0 +1,12 @@
+/**
+ * Platform-level constants that don't depend on configuration.
+ * These are simple values used by HTTP servers and adapters.
+ *
+ * Note: config/defaults.ts re-exports DEFAULT_PORT for higher layers.
+ */
+export const DEFAULT_PORT = 3000;
+export const LOCALHOST = {
+    IPV4: "127.0.0.1",
+    IPV6: "::1",
+    HOSTNAME: "localhost",
+};

package/esm/src/platform/compat/dynamic-import.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Opaque dynamic import helper.
+ *
+ * Uses `new Function` to hide the `import()` call from static analysis
+ * by bundlers and `deno compile`, preventing them from tracing into
+ * the imported specifier.
+ *
+ * @module platform/compat
+ */
+export declare const dynamicImport: <T = unknown>(specifier: string) => Promise<T>;
+//# sourceMappingURL=dynamic-import.d.ts.map

package/esm/src/platform/compat/dynamic-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-import.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/dynamic-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,aAAa,EAA4D,CACpF,CAAC,GAAG,OAAO,EAEX,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/esm/src/platform/compat/dynamic-import.js

@@ -0,0 +1,10 @@
+/**
+ * Opaque dynamic import helper.
+ *
+ * Uses `new Function` to hide the `import()` call from static analysis
+ * by bundlers and `deno compile`, preventing them from tracing into
+ * the imported specifier.
+ *
+ * @module platform/compat
+ */
+export const dynamicImport = new Function("specifier", "return import(specifier)");

package/esm/src/platform/compat/fs.d.ts

@@ -0,0 +1,76 @@
+import type { FileInfo } from "../adapters/base.js";
+/** Public API contract for file system. */
+export interface FileSystem {
+    readTextFile(path: string): Promise<string>;
+    readFile(path: string): Promise<Uint8Array>;
+    writeTextFile(path: string, data: string): Promise<void>;
+    writeFile(path: string, data: Uint8Array): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileInfo>;
+    lstat?(path: string): Promise<FileInfo>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readDir(path: string): AsyncIterable<{
+        name: string;
+        isFile: boolean;
+        isDirectory: boolean;
+        isSymlink?: boolean;
+    }>;
+    remove(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    makeTempDir(options?: {
+        prefix?: string;
+    }): Promise<string>;
+    chmod(path: string, mode: number): Promise<void>;
+}
+/** Create file system. */
+export declare function createFileSystem(): FileSystem;
+/** Read a file as text. */
+export declare function readTextFile(path: string): Promise<string>;
+/** Read a file as bytes. */
+export declare function readFile(path: string): Promise<Uint8Array>;
+/** Write text to a file. */
+export declare function writeTextFile(path: string, data: string): Promise<void>;
+/** Write bytes to a file. */
+export declare function writeFile(path: string, data: Uint8Array): Promise<void>;
+/** Check whether a path exists. */
+export declare function exists(path: string): Promise<boolean>;
+/** Read file metadata. */
+export declare function stat(path: string): Promise<FileInfo>;
+/** Read file metadata without following a terminal symbolic link. */
+export declare function lstat(path: string): Promise<FileInfo>;
+/** Create a directory. */
+export declare function mkdir(path: string, options?: {
+    recursive?: boolean;
+}): Promise<void>;
+/** Remove a file or directory. */
+export declare function remove(path: string, options?: {
+    recursive?: boolean;
+}): Promise<void>;
+/** Read directory entries. */
+export declare function readDir(path: string): AsyncIterable<{
+    name: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymlink?: boolean;
+}>;
+/** Create temp dir. */
+export declare function makeTempDir(options?: {
+    prefix?: string;
+}): Promise<string>;
+/** Change file permissions. */
+export declare function chmod(path: string, mode: number): Promise<void>;
+export declare function symlink(target: string, path: string): Promise<void>;
+/**
+ * Resolve a path to its canonical absolute form, following symlinks.
+ * Throws if the path does not exist. Useful for containment checks where a
+ * symlink could otherwise escape an intended directory.
+ */
+export declare function realPath(path: string): Promise<string>;
+/** Error shape for is not found. */
+export declare function isNotFoundError(error: unknown, seen?: Set<unknown>): boolean;
+/** Error shape for is already exists. */
+export declare function isAlreadyExistsError(error: unknown): boolean;
+//# sourceMappingURL=fs.d.ts.map

package/esm/src/platform/compat/fs.d.ts.map

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