mock-mcp 0.3.1 → 0.5.1

package/dist/shared/index.d.cts

@@ -0,0 +1,241 @@
+import { a as MockRequestDescriptor, M as MockResponseDescriptor } from '../types-bEGXLBF0.cjs';
+export { A as ActiveDaemonEntry, v as ActiveDaemonsIndex, q as DaemonPaths, D as DaemonRegistry, E as EnsureDaemonOptions, o as cleanupGlobalIndex, c as computeProjectId, p as discoverAllDaemons, j as ensureDaemonRunning, g as getCacheDir, i as getDaemonEntryPath, k as getGlobalIndexPath, b as getPaths, h as healthCheck, f as randomToken, l as readGlobalIndex, d as readRegistry, n as registerDaemonGlobally, e as releaseLock, r as resolveProjectRoot, s as sleep, t as tryAcquireLock, u as unregisterDaemonGlobally, m as writeGlobalIndex, w as writeRegistry } from '../types-bEGXLBF0.cjs';
+import 'node:fs';
+
+/**
+ * Protocol definitions for mock-mcp Daemon communication.
+ *
+ * Defines message types for:
+ * - Test channel (WebSocket /test): Test process ↔ Daemon
+ * - Control channel (HTTP /control): Adapter ↔ Daemon (JSON-RPC)
+ */
+
+declare const HELLO_TEST: "HELLO_TEST";
+declare const HELLO_ACK: "HELLO_ACK";
+declare const BATCH_MOCK_REQUEST: "BATCH_MOCK_REQUEST";
+declare const BATCH_MOCK_RESULT: "BATCH_MOCK_RESULT";
+declare const HEARTBEAT: "HEARTBEAT";
+declare const HEARTBEAT_ACK: "HEARTBEAT_ACK";
+declare const RPC_GET_STATUS: "getStatus";
+declare const RPC_LIST_RUNS: "listRuns";
+declare const RPC_CLAIM_NEXT_BATCH: "claimNextBatch";
+declare const RPC_PROVIDE_BATCH: "provideBatch";
+declare const RPC_RELEASE_BATCH: "releaseBatch";
+declare const RPC_GET_BATCH: "getBatch";
+/**
+ * HELLO message from test process to daemon.
+ * Must be the first message after WebSocket connection.
+ */
+interface HelloTestMessage {
+    type: typeof HELLO_TEST;
+    token: string;
+    runId: string;
+    pid: number;
+    cwd: string;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Acknowledgment of HELLO from daemon.
+ */
+interface HelloAckMessage {
+    type: typeof HELLO_ACK;
+    runId: string;
+}
+/**
+ * Batch mock request from test process.
+ */
+interface BatchMockRequestMessage {
+    type: typeof BATCH_MOCK_REQUEST;
+    runId: string;
+    requests: MockRequestDescriptor[];
+}
+/**
+ * Batch mock result from daemon to test process.
+ */
+interface BatchMockResultMessage {
+    type: typeof BATCH_MOCK_RESULT;
+    batchId: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Heartbeat from test process.
+ */
+interface HeartbeatMessage {
+    type: typeof HEARTBEAT;
+    runId: string;
+}
+/**
+ * Heartbeat acknowledgment from daemon.
+ */
+interface HeartbeatAckMessage {
+    type: typeof HEARTBEAT_ACK;
+    runId: string;
+}
+/**
+ * Union type for all test channel messages (from test process).
+ */
+type TestChannelIncomingMessage = HelloTestMessage | BatchMockRequestMessage | HeartbeatMessage;
+/**
+ * Union type for all test channel messages (from daemon).
+ */
+type TestChannelOutgoingMessage = HelloAckMessage | BatchMockResultMessage | HeartbeatAckMessage;
+/**
+ * JSON-RPC 2.0 request structure.
+ */
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 response structure.
+ */
+interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare const RPC_ERROR_PARSE = -32700;
+declare const RPC_ERROR_INVALID_REQUEST = -32600;
+declare const RPC_ERROR_METHOD_NOT_FOUND = -32601;
+declare const RPC_ERROR_INVALID_PARAMS = -32602;
+declare const RPC_ERROR_INTERNAL = -32603;
+declare const RPC_ERROR_NOT_FOUND = -32000;
+declare const RPC_ERROR_UNAUTHORIZED = -32001;
+declare const RPC_ERROR_CONFLICT = -32002;
+declare const RPC_ERROR_EXPIRED = -32003;
+/**
+ * Parameters for claimNextBatch RPC.
+ */
+interface ClaimNextBatchParams {
+    adapterId: string;
+    runId?: string;
+    leaseMs?: number;
+}
+/**
+ * Result of claimNextBatch RPC.
+ */
+interface ClaimNextBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    claimToken: string;
+    leaseUntil: number;
+}
+/**
+ * Parameters for provideBatch RPC.
+ */
+interface ProvideBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Result of provideBatch RPC.
+ */
+interface ProvideBatchResult {
+    ok: boolean;
+    message?: string;
+}
+/**
+ * Parameters for releaseBatch RPC.
+ */
+interface ReleaseBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    reason?: string;
+}
+/**
+ * Parameters for getBatch RPC.
+ */
+interface GetBatchParams {
+    batchId: string;
+}
+/**
+ * Result of getStatus RPC.
+ */
+interface GetStatusResult {
+    version: string;
+    projectId: string;
+    projectRoot: string;
+    pid: number;
+    uptime: number;
+    runs: number;
+    pending: number;
+    claimed: number;
+    totalBatches: number;
+}
+/**
+ * Result of listRuns RPC.
+ */
+interface ListRunsResult {
+    runs: RunInfo[];
+}
+interface RunInfo {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    pendingBatches: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Result of getBatch RPC.
+ */
+interface GetBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    status: BatchStatus;
+    createdAt: number;
+    claim?: {
+        adapterId: string;
+        leaseUntil: number;
+    };
+}
+type BatchStatus = "pending" | "claimed" | "fulfilled" | "expired";
+interface RunRecord {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+interface BatchRecord {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    createdAt: number;
+    status: BatchStatus;
+    claim?: {
+        adapterId: string;
+        claimToken: string;
+        leaseUntil: number;
+    };
+}
+declare function isHelloTestMessage(msg: unknown): msg is HelloTestMessage;
+declare function isBatchMockRequestMessage(msg: unknown): msg is BatchMockRequestMessage;
+declare function isHeartbeatMessage(msg: unknown): msg is HeartbeatMessage;
+declare function isJsonRpcRequest(msg: unknown): msg is JsonRpcRequest;
+
+export { BATCH_MOCK_REQUEST, BATCH_MOCK_RESULT, type BatchMockRequestMessage, type BatchMockResultMessage, type BatchRecord, type BatchStatus, type ClaimNextBatchParams, type ClaimNextBatchResult, type GetBatchParams, type GetBatchResult, type GetStatusResult, HEARTBEAT, HEARTBEAT_ACK, HELLO_ACK, HELLO_TEST, type HeartbeatAckMessage, type HeartbeatMessage, type HelloAckMessage, type HelloTestMessage, type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, type ListRunsResult, type ProvideBatchParams, type ProvideBatchResult, RPC_CLAIM_NEXT_BATCH, RPC_ERROR_CONFLICT, RPC_ERROR_EXPIRED, RPC_ERROR_INTERNAL, RPC_ERROR_INVALID_PARAMS, RPC_ERROR_INVALID_REQUEST, RPC_ERROR_METHOD_NOT_FOUND, RPC_ERROR_NOT_FOUND, RPC_ERROR_PARSE, RPC_ERROR_UNAUTHORIZED, RPC_GET_BATCH, RPC_GET_STATUS, RPC_LIST_RUNS, RPC_PROVIDE_BATCH, RPC_RELEASE_BATCH, type ReleaseBatchParams, type RunInfo, type RunRecord, type TestChannelIncomingMessage, type TestChannelOutgoingMessage, isBatchMockRequestMessage, isHeartbeatMessage, isHelloTestMessage, isJsonRpcRequest };

package/dist/shared/index.d.ts

@@ -0,0 +1,241 @@
+import { a as MockRequestDescriptor, M as MockResponseDescriptor } from '../types-bEGXLBF0.js';
+export { A as ActiveDaemonEntry, v as ActiveDaemonsIndex, q as DaemonPaths, D as DaemonRegistry, E as EnsureDaemonOptions, o as cleanupGlobalIndex, c as computeProjectId, p as discoverAllDaemons, j as ensureDaemonRunning, g as getCacheDir, i as getDaemonEntryPath, k as getGlobalIndexPath, b as getPaths, h as healthCheck, f as randomToken, l as readGlobalIndex, d as readRegistry, n as registerDaemonGlobally, e as releaseLock, r as resolveProjectRoot, s as sleep, t as tryAcquireLock, u as unregisterDaemonGlobally, m as writeGlobalIndex, w as writeRegistry } from '../types-bEGXLBF0.js';
+import 'node:fs';
+
+/**
+ * Protocol definitions for mock-mcp Daemon communication.
+ *
+ * Defines message types for:
+ * - Test channel (WebSocket /test): Test process ↔ Daemon
+ * - Control channel (HTTP /control): Adapter ↔ Daemon (JSON-RPC)
+ */
+
+declare const HELLO_TEST: "HELLO_TEST";
+declare const HELLO_ACK: "HELLO_ACK";
+declare const BATCH_MOCK_REQUEST: "BATCH_MOCK_REQUEST";
+declare const BATCH_MOCK_RESULT: "BATCH_MOCK_RESULT";
+declare const HEARTBEAT: "HEARTBEAT";
+declare const HEARTBEAT_ACK: "HEARTBEAT_ACK";
+declare const RPC_GET_STATUS: "getStatus";
+declare const RPC_LIST_RUNS: "listRuns";
+declare const RPC_CLAIM_NEXT_BATCH: "claimNextBatch";
+declare const RPC_PROVIDE_BATCH: "provideBatch";
+declare const RPC_RELEASE_BATCH: "releaseBatch";
+declare const RPC_GET_BATCH: "getBatch";
+/**
+ * HELLO message from test process to daemon.
+ * Must be the first message after WebSocket connection.
+ */
+interface HelloTestMessage {
+    type: typeof HELLO_TEST;
+    token: string;
+    runId: string;
+    pid: number;
+    cwd: string;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Acknowledgment of HELLO from daemon.
+ */
+interface HelloAckMessage {
+    type: typeof HELLO_ACK;
+    runId: string;
+}
+/**
+ * Batch mock request from test process.
+ */
+interface BatchMockRequestMessage {
+    type: typeof BATCH_MOCK_REQUEST;
+    runId: string;
+    requests: MockRequestDescriptor[];
+}
+/**
+ * Batch mock result from daemon to test process.
+ */
+interface BatchMockResultMessage {
+    type: typeof BATCH_MOCK_RESULT;
+    batchId: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Heartbeat from test process.
+ */
+interface HeartbeatMessage {
+    type: typeof HEARTBEAT;
+    runId: string;
+}
+/**
+ * Heartbeat acknowledgment from daemon.
+ */
+interface HeartbeatAckMessage {
+    type: typeof HEARTBEAT_ACK;
+    runId: string;
+}
+/**
+ * Union type for all test channel messages (from test process).
+ */
+type TestChannelIncomingMessage = HelloTestMessage | BatchMockRequestMessage | HeartbeatMessage;
+/**
+ * Union type for all test channel messages (from daemon).
+ */
+type TestChannelOutgoingMessage = HelloAckMessage | BatchMockResultMessage | HeartbeatAckMessage;
+/**
+ * JSON-RPC 2.0 request structure.
+ */
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 response structure.
+ */
+interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare const RPC_ERROR_PARSE = -32700;
+declare const RPC_ERROR_INVALID_REQUEST = -32600;
+declare const RPC_ERROR_METHOD_NOT_FOUND = -32601;
+declare const RPC_ERROR_INVALID_PARAMS = -32602;
+declare const RPC_ERROR_INTERNAL = -32603;
+declare const RPC_ERROR_NOT_FOUND = -32000;
+declare const RPC_ERROR_UNAUTHORIZED = -32001;
+declare const RPC_ERROR_CONFLICT = -32002;
+declare const RPC_ERROR_EXPIRED = -32003;
+/**
+ * Parameters for claimNextBatch RPC.
+ */
+interface ClaimNextBatchParams {
+    adapterId: string;
+    runId?: string;
+    leaseMs?: number;
+}
+/**
+ * Result of claimNextBatch RPC.
+ */
+interface ClaimNextBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    claimToken: string;
+    leaseUntil: number;
+}
+/**
+ * Parameters for provideBatch RPC.
+ */
+interface ProvideBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    mocks: MockResponseDescriptor[];
+}
+/**
+ * Result of provideBatch RPC.
+ */
+interface ProvideBatchResult {
+    ok: boolean;
+    message?: string;
+}
+/**
+ * Parameters for releaseBatch RPC.
+ */
+interface ReleaseBatchParams {
+    adapterId: string;
+    batchId: string;
+    claimToken: string;
+    reason?: string;
+}
+/**
+ * Parameters for getBatch RPC.
+ */
+interface GetBatchParams {
+    batchId: string;
+}
+/**
+ * Result of getStatus RPC.
+ */
+interface GetStatusResult {
+    version: string;
+    projectId: string;
+    projectRoot: string;
+    pid: number;
+    uptime: number;
+    runs: number;
+    pending: number;
+    claimed: number;
+    totalBatches: number;
+}
+/**
+ * Result of listRuns RPC.
+ */
+interface ListRunsResult {
+    runs: RunInfo[];
+}
+interface RunInfo {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    pendingBatches: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+/**
+ * Result of getBatch RPC.
+ */
+interface GetBatchResult {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    status: BatchStatus;
+    createdAt: number;
+    claim?: {
+        adapterId: string;
+        leaseUntil: number;
+    };
+}
+type BatchStatus = "pending" | "claimed" | "fulfilled" | "expired";
+interface RunRecord {
+    runId: string;
+    pid: number;
+    cwd: string;
+    startedAt: string;
+    lastSeen: number;
+    testMeta?: {
+        testFile?: string;
+        testName?: string;
+    };
+}
+interface BatchRecord {
+    batchId: string;
+    runId: string;
+    requests: MockRequestDescriptor[];
+    createdAt: number;
+    status: BatchStatus;
+    claim?: {
+        adapterId: string;
+        claimToken: string;
+        leaseUntil: number;
+    };
+}
+declare function isHelloTestMessage(msg: unknown): msg is HelloTestMessage;
+declare function isBatchMockRequestMessage(msg: unknown): msg is BatchMockRequestMessage;
+declare function isHeartbeatMessage(msg: unknown): msg is HeartbeatMessage;
+declare function isJsonRpcRequest(msg: unknown): msg is JsonRpcRequest;
+
+export { BATCH_MOCK_REQUEST, BATCH_MOCK_RESULT, type BatchMockRequestMessage, type BatchMockResultMessage, type BatchRecord, type BatchStatus, type ClaimNextBatchParams, type ClaimNextBatchResult, type GetBatchParams, type GetBatchResult, type GetStatusResult, HEARTBEAT, HEARTBEAT_ACK, HELLO_ACK, HELLO_TEST, type HeartbeatAckMessage, type HeartbeatMessage, type HelloAckMessage, type HelloTestMessage, type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, type ListRunsResult, type ProvideBatchParams, type ProvideBatchResult, RPC_CLAIM_NEXT_BATCH, RPC_ERROR_CONFLICT, RPC_ERROR_EXPIRED, RPC_ERROR_INTERNAL, RPC_ERROR_INVALID_PARAMS, RPC_ERROR_INVALID_REQUEST, RPC_ERROR_METHOD_NOT_FOUND, RPC_ERROR_NOT_FOUND, RPC_ERROR_PARSE, RPC_ERROR_UNAUTHORIZED, RPC_GET_BATCH, RPC_GET_STATUS, RPC_LIST_RUNS, RPC_PROVIDE_BATCH, RPC_RELEASE_BATCH, type ReleaseBatchParams, type RunInfo, type RunRecord, type TestChannelIncomingMessage, type TestChannelOutgoingMessage, isBatchMockRequestMessage, isHeartbeatMessage, isHelloTestMessage, isJsonRpcRequest };