mock-mcp 0.3.0 → 0.5.0

package/dist/discovery-Dc2LdF8q.d.cts

@@ -0,0 +1,105 @@
+import fssync from 'node:fs';
+
+/**
+ * Discovery module for mock-mcp Daemon + Adapter architecture.
+ *
+ * Provides:
+ * - Project root resolution (up-search for .git / package.json)
+ * - Project ID computation (sha256 of realpath)
+ * - Registry/lock file path management
+ * - IPC path (Unix Domain Socket / Windows Named Pipe)
+ * - ensureDaemonRunning() - atomic daemon startup with lock
+ */
+
+interface DaemonRegistry {
+    projectId: string;
+    projectRoot: string;
+    ipcPath: string;
+    token: string;
+    pid: number;
+    startedAt: string;
+    version: string;
+}
+interface EnsureDaemonOptions {
+    projectRoot?: string;
+    timeoutMs?: number;
+    /** For testing: override cache directory */
+    cacheDir?: string;
+}
+/**
+ * Resolve the project root by searching upward for .git or package.json.
+ * Falls back to the starting directory if nothing is found.
+ */
+declare function resolveProjectRoot(startDir?: string): string;
+/**
+ * Compute a stable project ID from the project root path.
+ * Uses sha256 of the realpath, truncated to 16 characters.
+ */
+declare function computeProjectId(projectRoot: string): string;
+/**
+ * Get the cache directory for mock-mcp files.
+ * Priority: override > MOCK_MCP_CACHE_DIR env > XDG_CACHE_HOME > LOCALAPPDATA (Windows) > ~/.cache
+ */
+declare function getCacheDir(override?: string): string;
+interface DaemonPaths {
+    base: string;
+    registryPath: string;
+    lockPath: string;
+    ipcPath: string;
+}
+/**
+ * Get all relevant paths for a given project ID.
+ */
+declare function getPaths(projectId: string, cacheDir?: string): DaemonPaths;
+/**
+ * Read the daemon registry file.
+ */
+declare function readRegistry(registryPath: string): Promise<DaemonRegistry | null>;
+/**
+ * Write the daemon registry file with restricted permissions.
+ */
+declare function writeRegistry(registryPath: string, registry: DaemonRegistry): Promise<void>;
+/**
+ * Check if the daemon is healthy by making an HTTP request to /health.
+ */
+declare function healthCheck(ipcPath: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Try to acquire an exclusive lock file.
+ * Returns the file handle if successful, null otherwise.
+ */
+declare function tryAcquireLock(lockPath: string): Promise<fssync.promises.FileHandle | null>;
+/**
+ * Release the lock file.
+ */
+declare function releaseLock(lockPath: string, fh: fssync.promises.FileHandle): Promise<void>;
+/**
+ * Generate a random token for daemon authentication.
+ */
+declare function randomToken(): string;
+/**
+ * Get the path to the daemon entry point.
+ *
+ * This function handles multiple scenarios:
+ * 1. Direct execution from source (development)
+ * 2. Execution from dist (production)
+ * 3. When re-bundled by another tool (Vitest, esbuild, webpack)
+ *
+ * We use require.resolve to reliably find the mock-mcp package location,
+ * which works even when the code is re-bundled by another tool.
+ */
+declare function getDaemonEntryPath(): string;
+/**
+ * Ensure the daemon is running for the given project.
+ *
+ * This function:
+ * 1. Checks if a daemon is already running (via registry + health check)
+ * 2. If not, acquires a lock and spawns a new daemon
+ * 3. Waits for the daemon to become healthy
+ * 4. Returns the registry information
+ *
+ * Thread-safe: multiple processes calling this concurrently will only start one daemon.
+ */
+declare function ensureDaemonRunning(opts?: EnsureDaemonOptions): Promise<DaemonRegistry>;
+declare function sleep(ms: number): Promise<void>;
+
+export { type DaemonRegistry as D, type EnsureDaemonOptions as E, getPaths as a, readRegistry as b, computeProjectId as c, releaseLock as d, randomToken as e, getDaemonEntryPath as f, getCacheDir as g, healthCheck as h, ensureDaemonRunning as i, type DaemonPaths as j, resolveProjectRoot as r, sleep as s, tryAcquireLock as t, writeRegistry as w };

package/dist/discovery-Dc2LdF8q.d.ts

@@ -0,0 +1,105 @@
+import fssync from 'node:fs';
+
+/**
+ * Discovery module for mock-mcp Daemon + Adapter architecture.
+ *
+ * Provides:
+ * - Project root resolution (up-search for .git / package.json)
+ * - Project ID computation (sha256 of realpath)
+ * - Registry/lock file path management
+ * - IPC path (Unix Domain Socket / Windows Named Pipe)
+ * - ensureDaemonRunning() - atomic daemon startup with lock
+ */
+
+interface DaemonRegistry {
+    projectId: string;
+    projectRoot: string;
+    ipcPath: string;
+    token: string;
+    pid: number;
+    startedAt: string;
+    version: string;
+}
+interface EnsureDaemonOptions {
+    projectRoot?: string;
+    timeoutMs?: number;
+    /** For testing: override cache directory */
+    cacheDir?: string;
+}
+/**
+ * Resolve the project root by searching upward for .git or package.json.
+ * Falls back to the starting directory if nothing is found.
+ */
+declare function resolveProjectRoot(startDir?: string): string;
+/**
+ * Compute a stable project ID from the project root path.
+ * Uses sha256 of the realpath, truncated to 16 characters.
+ */
+declare function computeProjectId(projectRoot: string): string;
+/**
+ * Get the cache directory for mock-mcp files.
+ * Priority: override > MOCK_MCP_CACHE_DIR env > XDG_CACHE_HOME > LOCALAPPDATA (Windows) > ~/.cache
+ */
+declare function getCacheDir(override?: string): string;
+interface DaemonPaths {
+    base: string;
+    registryPath: string;
+    lockPath: string;
+    ipcPath: string;
+}
+/**
+ * Get all relevant paths for a given project ID.
+ */
+declare function getPaths(projectId: string, cacheDir?: string): DaemonPaths;
+/**
+ * Read the daemon registry file.
+ */
+declare function readRegistry(registryPath: string): Promise<DaemonRegistry | null>;
+/**
+ * Write the daemon registry file with restricted permissions.
+ */
+declare function writeRegistry(registryPath: string, registry: DaemonRegistry): Promise<void>;
+/**
+ * Check if the daemon is healthy by making an HTTP request to /health.
+ */
+declare function healthCheck(ipcPath: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Try to acquire an exclusive lock file.
+ * Returns the file handle if successful, null otherwise.
+ */
+declare function tryAcquireLock(lockPath: string): Promise<fssync.promises.FileHandle | null>;
+/**
+ * Release the lock file.
+ */
+declare function releaseLock(lockPath: string, fh: fssync.promises.FileHandle): Promise<void>;
+/**
+ * Generate a random token for daemon authentication.
+ */
+declare function randomToken(): string;
+/**
+ * Get the path to the daemon entry point.
+ *
+ * This function handles multiple scenarios:
+ * 1. Direct execution from source (development)
+ * 2. Execution from dist (production)
+ * 3. When re-bundled by another tool (Vitest, esbuild, webpack)
+ *
+ * We use require.resolve to reliably find the mock-mcp package location,
+ * which works even when the code is re-bundled by another tool.
+ */
+declare function getDaemonEntryPath(): string;
+/**
+ * Ensure the daemon is running for the given project.
+ *
+ * This function:
+ * 1. Checks if a daemon is already running (via registry + health check)
+ * 2. If not, acquires a lock and spawns a new daemon
+ * 3. Waits for the daemon to become healthy
+ * 4. Returns the registry information
+ *
+ * Thread-safe: multiple processes calling this concurrently will only start one daemon.
+ */
+declare function ensureDaemonRunning(opts?: EnsureDaemonOptions): Promise<DaemonRegistry>;
+declare function sleep(ms: number): Promise<void>;
+
+export { type DaemonRegistry as D, type EnsureDaemonOptions as E, getPaths as a, readRegistry as b, computeProjectId as c, releaseLock as d, randomToken as e, getDaemonEntryPath as f, getCacheDir as g, healthCheck as h, ensureDaemonRunning as i, type DaemonPaths as j, resolveProjectRoot as r, sleep as s, tryAcquireLock as t, writeRegistry as w };