@adofai-ipc/client 0.1.0 → 0.3.0

package/README.md

@@ -40,12 +40,43 @@ await tufhelper.call("level.open-from-id", {
 
 Finds a running AdofaiIpc server by probing `/ipc/health`.
 
+The client and server product versions must match exactly. A mismatch throws
+`IpcVersionMismatchError` and stops port probing. Use `onVersionMismatch` to display application UI;
+the callback runs at most once per `tryConnect` call and does not suppress the typed error.
+
+```ts
+await tryConnect({
+  onVersionMismatch(error) {
+    if (error.direction === "client_outdated") location.reload();
+    else openAdofaiIpcDownloadNotice(error);
+  }
+});
+```
+
+`server_outdated` means the mod must be updated, `client_outdated` means the web bundle must be
+updated, and `legacy_server` means the server did not provide a valid product version. React
+StrictMode and consumer retry loops can call `tryConnect` more than once, so applications should
+store mismatch as a terminal connection state and deduplicate their own modal or banner.
+
 Defaults:
 
 - host: `127.0.0.1`
 - startPort: `32145`
 - endPort: `32155`
-- timeoutMs: `500`
+- probeTimeoutMs: `500`
+- requestTimeoutMs: `10000`
+
+`tryConnect` only confirms that the AdofaiIpc listener is running. It does not mean that a target
+namespace is registered or that the owning mod has finished initializing.
+
+```ts
+const client = await tryConnect({
+  probeTimeoutMs: 500,
+  requestTimeoutMs: 10_000
+});
+```
+
+The legacy `timeoutMs` option remains as a deprecated alias for both values.
 
 ### `new AdofaiIpcClient(options?)`
 
@@ -61,6 +92,14 @@ const client = new AdofaiIpcClient({
 
 Calls a namespace method through `POST /ipc`.
 
+```ts
+await client.call({
+  namespace: "tufhelper2",
+  method: "activity.get",
+  timeoutMs: 30_000
+});
+```
+
 ### `client.namespace(name)`
 
 Creates a namespace-bound helper.
@@ -77,6 +116,52 @@ Calls `GET /ipc/namespaces`.
 
 Calls `GET /ipc/namespaces/{name}`.
 
+### `client.waitForNamespace(name, options?)`
+
+Polls namespace discovery until the target namespace is registered. Set `status: "ready"` to also
+wait until the namespace owner explicitly marks initialization complete.
+
+```ts
+await client.waitForNamespace("tufhelper2", {
+  status: "ready",
+  timeoutMs: 15_000,
+  pollIntervalMs: 100
+});
+```
+
+AdofaiIpc namespaces have the strict states `initializing`, `ready`, and `error`. A ready wait that
+expires reports `namespace_initializing`; an initialization failure reports `namespace_error`.
+
+## Error handling
+
+Connection failures are reported as `IpcConnectionError` with code `UNAVAILABLE`. Request
+timeouts use the more specific `IpcTimeoutError`, which extends `IpcConnectionError` and has code
+`TIMEOUT`. Protocol failures, including `namespace_not_found`, are reported as
+`IpcResponseError`. `isIpcUnavailable` only matches the `UNAVAILABLE` state, not timeouts.
+
+```ts
+import {
+  IpcTimeoutError,
+  isIpcUnavailable,
+  tryConnect
+} from "@adofai-ipc/client";
+
+try {
+  const client = await tryConnect();
+  await client.health();
+} catch (error) {
+  if (error instanceof IpcTimeoutError) {
+    console.warn(`AdofaiIpc timed out after ${error.timeoutMs} ms.`);
+  } else if (isIpcUnavailable(error)) {
+    console.warn("AdofaiIpc is unavailable.");
+  }
+}
+```
+
+`tryConnect` treats individual probe failures as expected and only throws an `UNAVAILABLE`
+`IpcConnectionError` after every candidate port has failed. A successful probe does not guarantee
+that any specific namespace or mode feature is ready.
+
 ## Notes
 
 This package uses the global `fetch` API. Node.js 18 or newer is recommended.

package/dist/index.cjs

@@ -23,9 +23,13 @@ __export(index_exports, {
   AdofaiIpcClient: () => AdofaiIpcClient,
   AdofaiIpcError: () => AdofaiIpcError,
   AdofaiIpcNamespaceClient: () => AdofaiIpcNamespaceClient,
+  CLIENT_VERSION: () => CLIENT_VERSION,
   IpcConnectionError: () => IpcConnectionError,
   IpcHttpError: () => IpcHttpError,
   IpcResponseError: () => IpcResponseError,
+  IpcTimeoutError: () => IpcTimeoutError,
+  IpcVersionMismatchError: () => IpcVersionMismatchError,
+  isIpcUnavailable: () => isIpcUnavailable,
   tryConnect: () => tryConnect
 });
 module.exports = __toCommonJS(index_exports);
@@ -38,11 +42,38 @@ var AdofaiIpcError = class extends Error {
   }
 };
 var IpcConnectionError = class extends AdofaiIpcError {
-  constructor(message = "Could not connect to AdofaiIpc.") {
+  constructor(message = "Could not connect to AdofaiIpc.", options = {}) {
     super(message);
     this.name = "IpcConnectionError";
+    this.code = options.code ?? "UNAVAILABLE";
+    this.cause = options.cause;
   }
 };
+var IpcTimeoutError = class extends IpcConnectionError {
+  constructor(timeoutMs, options = {}) {
+    super(`AdofaiIpc request timed out after ${timeoutMs} ms.`, {
+      code: "TIMEOUT",
+      cause: options.cause
+    });
+    this.name = "IpcTimeoutError";
+    this.timeoutMs = timeoutMs;
+  }
+};
+var IpcVersionMismatchError = class extends AdofaiIpcError {
+  constructor(options) {
+    const server = options.serverVersion ?? "legacy/unknown";
+    super(`AdofaiIpc version mismatch: client ${options.clientVersion}, server ${server}.`);
+    this.code = "VERSION_MISMATCH";
+    this.name = "IpcVersionMismatchError";
+    this.clientVersion = options.clientVersion;
+    this.serverVersion = options.serverVersion;
+    this.direction = options.direction;
+    this.protocolVersion = options.protocolVersion;
+  }
+};
+function isIpcUnavailable(error) {
+  return error instanceof IpcConnectionError && error.code === "UNAVAILABLE";
+}
 var IpcHttpError = class extends AdofaiIpcError {
   constructor(status, message) {
     super(message);
@@ -59,16 +90,56 @@ var IpcResponseError = class extends AdofaiIpcError {
   }
 };
 
+// src/version.ts
+var CLIENT_VERSION = "0.3.0";
+var CANONICAL_SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?$/;
+function compareProductVersions(left, right) {
+  const leftVersion = parseProductVersion(left);
+  const rightVersion = parseProductVersion(right);
+  if (!leftVersion || !rightVersion) return null;
+  for (let index = 0; index < leftVersion.core.length; index++) {
+    const difference = leftVersion.core[index] - rightVersion.core[index];
+    if (difference !== 0) return difference < 0 ? -1 : 1;
+  }
+  if (leftVersion.prerelease === null) return rightVersion.prerelease === null ? 0 : 1;
+  if (rightVersion.prerelease === null) return -1;
+  const length = Math.max(leftVersion.prerelease.length, rightVersion.prerelease.length);
+  for (let index = 0; index < length; index++) {
+    const leftPart = leftVersion.prerelease[index];
+    const rightPart = rightVersion.prerelease[index];
+    if (leftPart === void 0) return -1;
+    if (rightPart === void 0) return 1;
+    if (leftPart === rightPart) continue;
+    const leftNumeric = /^\d+$/.test(leftPart);
+    const rightNumeric = /^\d+$/.test(rightPart);
+    if (leftNumeric && rightNumeric) return Number(leftPart) < Number(rightPart) ? -1 : 1;
+    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;
+    return leftPart < rightPart ? -1 : 1;
+  }
+  return 0;
+}
+function parseProductVersion(value) {
+  const match = CANONICAL_SEMVER.exec(value);
+  if (!match) return null;
+  return {
+    core: [Number(match[1]), Number(match[2]), Number(match[3])],
+    prerelease: match[4] ? match[4].split(".") : null
+  };
+}
+
 // src/client.ts
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_START_PORT = 32145;
 var DEFAULT_END_PORT = 32155;
-var DEFAULT_TIMEOUT_MS = 500;
+var DEFAULT_PROBE_TIMEOUT_MS = 500;
+var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
+var DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS = 1e4;
+var DEFAULT_NAMESPACE_POLL_INTERVAL_MS = 100;
 var AdofaiIpcClient = class {
   constructor(options = {}) {
     this.baseUrl = normalizeBaseUrl(options.baseUrl ?? `http://${DEFAULT_HOST}:${DEFAULT_START_PORT}`);
     this.fetchImpl = options.fetch ?? globalThis.fetch;
-    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.requestTimeoutMs = options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     if (!this.fetchImpl) {
       throw new IpcConnectionError("A fetch implementation is required.");
     }
@@ -76,47 +147,102 @@ var AdofaiIpcClient = class {
   static async connect(options = {}) {
     return tryConnect(options);
   }
-  async health() {
-    return this.get("/ipc/health");
+  async health(options = {}) {
+    return this.get("/ipc/health", options);
+  }
+  async listNamespaces(options = {}) {
+    return this.get("/ipc/namespaces", options);
   }
-  async listNamespaces() {
-    return this.get("/ipc/namespaces");
+  async getNamespace(namespace, options = {}) {
+    return this.get(
+      `/ipc/namespaces/${encodeURIComponent(namespace)}`,
+      options
+    );
   }
-  async getNamespace(namespace) {
-    return this.get(`/ipc/namespaces/${encodeURIComponent(namespace)}`);
+  async waitForNamespace(namespace, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS;
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_NAMESPACE_POLL_INTERVAL_MS;
+    const requiredStatus = options.status ?? "registered";
+    const deadline = Date.now() + timeoutMs;
+    let stateError;
+    while (true) {
+      try {
+        const detail = await this.getNamespace(namespace, {
+          timeoutMs: options.requestTimeoutMs
+        });
+        if (requiredStatus === "registered" || detail.status === "ready") {
+          return detail;
+        }
+        if (detail.status === "error") {
+          throw new IpcResponseError({
+            code: "namespace_error",
+            message: detail.error?.message ?? `Namespace initialization failed: ${namespace}`
+          });
+        }
+        if (detail.status !== "initializing") {
+          throw new IpcResponseError({
+            code: "namespace_status_unavailable",
+            message: `Namespace status is unavailable: ${namespace}`
+          });
+        }
+        stateError = new IpcResponseError({
+          code: "namespace_initializing",
+          message: `Namespace is initializing: ${namespace}`
+        });
+      } catch (error) {
+        if (!(error instanceof IpcResponseError) || error.code !== "namespace_not_found" && error.code !== "namespace_initializing") {
+          throw error;
+        }
+        stateError = error;
+      }
+      const remainingMs = deadline - Date.now();
+      if (remainingMs <= 0) {
+        throw stateError ?? new IpcResponseError({
+          code: "namespace_initializing",
+          message: `Namespace is initializing: ${namespace}`
+        });
+      }
+      await delay(Math.min(pollIntervalMs, remainingMs));
+    }
   }
   namespace(namespace) {
     return new AdofaiIpcNamespaceClient(this, namespace);
   }
   async call(options) {
-    const response = await this.post("/ipc", {
-      namespace: options.namespace,
-      method: options.method,
-      params: options.params ?? {},
-      id: options.id ?? createRequestId()
-    });
+    const response = await this.post(
+      "/ipc",
+      {
+        namespace: options.namespace,
+        method: options.method,
+        params: options.params ?? {},
+        id: options.id ?? createRequestId()
+      },
+      { timeoutMs: options.timeoutMs }
+    );
     if (!response.ok) {
       throw new IpcResponseError(response.error);
     }
     return response.result;
   }
-  async get(path) {
+  async get(path, options = {}) {
     return this.request(path, {
       method: "GET"
-    });
+    }, options);
   }
-  async post(path, body) {
+  async post(path, body, options = {}) {
     return this.request(path, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
       body: JSON.stringify(body)
-    });
+    }, options);
   }
-  async request(path, init) {
+  async request(path, init, options) {
+    const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    const timeoutError = new IpcTimeoutError(timeoutMs);
+    const timeout = setTimeout(() => controller.abort(timeoutError), timeoutMs);
     try {
       const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
         ...init,
@@ -124,13 +250,18 @@ var AdofaiIpcClient = class {
       });
       if (!response.ok) {
         const text = await response.text();
+        const responseError = parseIpcResponseError(text);
+        if (responseError) throw new IpcResponseError(responseError);
         throw new IpcHttpError(response.status, text || response.statusText);
       }
       return await response.json();
     } catch (error) {
-      if (error instanceof IpcHttpError) throw error;
-      if (error instanceof Error) throw new IpcConnectionError(error.message);
-      throw new IpcConnectionError();
+      if (error instanceof IpcHttpError || error instanceof IpcResponseError) throw error;
+      if (controller.signal.aborted) {
+        if (error === timeoutError) throw timeoutError;
+        throw new IpcTimeoutError(timeoutMs, { cause: error });
+      }
+      throw new IpcConnectionError(getErrorMessage(error), { cause: error });
     } finally {
       clearTimeout(timeout);
     }
@@ -141,12 +272,15 @@ var AdofaiIpcNamespaceClient = class {
     this.client = client;
     this.namespace = namespace;
   }
-  async call(method, params, id) {
+  async call(method, params, idOrOptions, options = {}) {
+    const requestOptions = isIpcRequestOptions(idOrOptions) ? idOrOptions : options;
+    const id = isIpcRequestOptions(idOrOptions) ? void 0 : idOrOptions;
     return this.client.call({
       namespace: this.namespace,
       method,
       params,
-      id
+      id,
+      timeoutMs: requestOptions.timeoutMs
     });
   }
 };
@@ -154,27 +288,80 @@ async function tryConnect(options = {}) {
   const host = options.host ?? DEFAULT_HOST;
   const startPort = options.startPort ?? DEFAULT_START_PORT;
   const endPort = options.endPort ?? DEFAULT_END_PORT;
+  const probeTimeoutMs = options.probeTimeoutMs ?? options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+  const requestTimeoutMs = options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+  let lastProbeError;
   for (let port = startPort; port <= endPort; port++) {
     const client = new AdofaiIpcClient({
       baseUrl: `http://${host}:${port}`,
       fetch: options.fetch,
-      timeoutMs: options.timeoutMs
+      requestTimeoutMs: probeTimeoutMs
     });
     try {
       const health = await client.health();
       if (health.ok && health.server === "AdofaiIpc") {
-        return client;
+        const mismatch = getVersionMismatch(health);
+        if (mismatch) {
+          try {
+            options.onVersionMismatch?.(mismatch);
+          } catch {
+          }
+          throw mismatch;
+        }
+        return new AdofaiIpcClient({
+          baseUrl: client.baseUrl,
+          fetch: options.fetch,
+          requestTimeoutMs
+        });
       }
-    } catch {
+    } catch (error) {
+      if (error instanceof IpcVersionMismatchError) throw error;
+      lastProbeError = error;
     }
   }
+  if (lastProbeError instanceof IpcTimeoutError) throw lastProbeError;
   throw new IpcConnectionError(
     `Could not connect to AdofaiIpc on ${host}:${startPort}-${endPort}.`
   );
 }
+function getVersionMismatch(health) {
+  const protocolVersion = Number.isInteger(health.protocolVersion) ? health.protocolVersion : null;
+  const serverVersion = typeof health.serverVersion === "string" ? health.serverVersion : null;
+  const comparison = serverVersion === null ? null : compareProductVersions(serverVersion, CLIENT_VERSION);
+  if (comparison === 0 && serverVersion === CLIENT_VERSION) return null;
+  return new IpcVersionMismatchError({
+    clientVersion: CLIENT_VERSION,
+    serverVersion,
+    direction: comparison === null ? "legacy_server" : comparison < 0 ? "server_outdated" : "client_outdated",
+    protocolVersion
+  });
+}
 function normalizeBaseUrl(value) {
   return value.replace(/\/+$/, "");
 }
+function getErrorMessage(error) {
+  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
+    return error.message;
+  }
+  return void 0;
+}
+function parseIpcResponseError(text) {
+  try {
+    const value = JSON.parse(text);
+    const error = value?.error;
+    if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" && "message" in error && typeof error.message === "string") {
+      return { code: error.code, message: error.message };
+    }
+  } catch {
+  }
+  return void 0;
+}
+function isIpcRequestOptions(value) {
+  return typeof value === "object" && value !== null;
+}
+function delay(timeoutMs) {
+  return new Promise((resolve) => setTimeout(resolve, timeoutMs));
+}
 function createRequestId() {
   return `adofai-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
@@ -183,9 +370,13 @@ function createRequestId() {
   AdofaiIpcClient,
   AdofaiIpcError,
   AdofaiIpcNamespaceClient,
+  CLIENT_VERSION,
   IpcConnectionError,
   IpcHttpError,
   IpcResponseError,
+  IpcTimeoutError,
+  IpcVersionMismatchError,
+  isIpcUnavailable,
   tryConnect
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export {\n  AdofaiIpcClient,\n  AdofaiIpcNamespaceClient,\n  tryConnect\n} from \"./client\";\n\nexport {\n  AdofaiIpcError,\n  IpcConnectionError,\n  IpcHttpError,\n  IpcResponseError\n} from \"./errors\";\n\nexport type {\n  AdofaiIpcClientOptions,\n  IpcCallOptions,\n  IpcErrorInfo,\n  IpcErrorResponse,\n  IpcHealthResponse,\n  IpcNamespaceDetail,\n  IpcNamespacesResponse,\n  IpcNamespaceSummary,\n  IpcRequestId,\n  IpcResponse,\n  IpcSuccessResponse,\n  TryConnectOptions\n} from \"./types\";\n","import type { IpcErrorInfo } from \"./types\";\n\nexport class AdofaiIpcError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AdofaiIpcError\";\n  }\n}\n\nexport class IpcConnectionError extends AdofaiIpcError {\n  constructor(message = \"Could not connect to AdofaiIpc.\") {\n    super(message);\n    this.name = \"IpcConnectionError\";\n  }\n}\n\nexport class IpcHttpError extends AdofaiIpcError {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"IpcHttpError\";\n    this.status = status;\n  }\n}\n\nexport class IpcResponseError extends AdofaiIpcError {\n  readonly code: string;\n  readonly error: IpcErrorInfo;\n\n  constructor(error: IpcErrorInfo) {\n    super(error.message);\n    this.name = \"IpcResponseError\";\n    this.code = error.code;\n    this.error = error;\n  }\n}\n","import { IpcConnectionError, IpcHttpError, IpcResponseError } from \"./errors\";\nimport type {\n  AdofaiIpcClientOptions,\n  IpcCallOptions,\n  IpcHealthResponse,\n  IpcNamespaceDetail,\n  IpcNamespacesResponse,\n  IpcResponse,\n  TryConnectOptions\n} from \"./types\";\n\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_START_PORT = 32145;\nconst DEFAULT_END_PORT = 32155;\nconst DEFAULT_TIMEOUT_MS = 500;\n\nexport class AdofaiIpcClient {\n  readonly baseUrl: string;\n\n  private readonly fetchImpl: typeof fetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: AdofaiIpcClientOptions = {}) {\n    this.baseUrl = normalizeBaseUrl(options.baseUrl ?? `http://${DEFAULT_HOST}:${DEFAULT_START_PORT}`);\n    this.fetchImpl = options.fetch ?? globalThis.fetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n    if (!this.fetchImpl) {\n      throw new IpcConnectionError(\"A fetch implementation is required.\");\n    }\n  }\n\n  static async connect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n    return tryConnect(options);\n  }\n\n  async health(): Promise<IpcHealthResponse> {\n    return this.get<IpcHealthResponse>(\"/ipc/health\");\n  }\n\n  async listNamespaces(): Promise<IpcNamespacesResponse> {\n    return this.get<IpcNamespacesResponse>(\"/ipc/namespaces\");\n  }\n\n  async getNamespace(namespace: string): Promise<IpcNamespaceDetail> {\n    return this.get<IpcNamespaceDetail>(`/ipc/namespaces/${encodeURIComponent(namespace)}`);\n  }\n\n  namespace(namespace: string): AdofaiIpcNamespaceClient {\n    return new AdofaiIpcNamespaceClient(this, namespace);\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    options: IpcCallOptions<TParams>\n  ): Promise<TResult> {\n    const response = await this.post<IpcResponse<TResult>>(\"/ipc\", {\n      namespace: options.namespace,\n      method: options.method,\n      params: options.params ?? {},\n      id: options.id ?? createRequestId()\n    });\n\n    if (!response.ok) {\n      throw new IpcResponseError(response.error);\n    }\n\n    return response.result;\n  }\n\n  private async get<TResult>(path: string): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"GET\"\n    });\n  }\n\n  private async post<TResult>(path: string, body: unknown): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify(body)\n    });\n  }\n\n  private async request<TResult>(path: string, init: RequestInit): Promise<TResult> {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n        ...init,\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        throw new IpcHttpError(response.status, text || response.statusText);\n      }\n\n      return (await response.json()) as TResult;\n    } catch (error) {\n      if (error instanceof IpcHttpError) throw error;\n      if (error instanceof Error) throw new IpcConnectionError(error.message);\n      throw new IpcConnectionError();\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\nexport class AdofaiIpcNamespaceClient {\n  constructor(\n    private readonly client: AdofaiIpcClient,\n    readonly namespace: string\n  ) {\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    method: string,\n    params?: TParams,\n    id?: string\n  ): Promise<TResult> {\n    return this.client.call<TResult, TParams>({\n      namespace: this.namespace,\n      method,\n      params,\n      id\n    });\n  }\n}\n\nexport async function tryConnect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n  const host = options.host ?? DEFAULT_HOST;\n  const startPort = options.startPort ?? DEFAULT_START_PORT;\n  const endPort = options.endPort ?? DEFAULT_END_PORT;\n\n  for (let port = startPort; port <= endPort; port++) {\n    const client = new AdofaiIpcClient({\n      baseUrl: `http://${host}:${port}`,\n      fetch: options.fetch,\n      timeoutMs: options.timeoutMs\n    });\n\n    try {\n      const health = await client.health();\n\n      if (health.ok && health.server === \"AdofaiIpc\") {\n        return client;\n      }\n    } catch {\n    }\n  }\n\n  throw new IpcConnectionError(\n    `Could not connect to AdofaiIpc on ${host}:${startPort}-${endPort}.`\n  );\n}\n\nfunction normalizeBaseUrl(value: string): string {\n  return value.replace(/\\/+$/, \"\");\n}\n\nfunction createRequestId(): string {\n  return `adofai-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export {\n  AdofaiIpcClient,\n  AdofaiIpcNamespaceClient,\n  tryConnect\n} from \"./client\";\n\nexport {\n  AdofaiIpcError,\n  IpcConnectionError,\n  IpcHttpError,\n  IpcResponseError,\n  IpcTimeoutError,\n  IpcVersionMismatchError,\n  isIpcUnavailable\n} from \"./errors\";\n\nexport type {\n  IpcConnectionErrorCode,\n  IpcConnectionErrorOptions,\n  IpcVersionMismatchDirection\n} from \"./errors\";\n\nexport { CLIENT_VERSION } from \"./version\";\n\nexport type {\n  AdofaiIpcClientOptions,\n  IpcCallOptions,\n  IpcErrorInfo,\n  IpcErrorResponse,\n  IpcHealthResponse,\n  IpcNamespaceDetail,\n  IpcNamespaceErrorInfo,\n  IpcNamespaceStatus,\n  IpcNamespacesResponse,\n  IpcNamespaceSummary,\n  IpcRequestId,\n  IpcRequestOptions,\n  IpcResponse,\n  IpcSuccessResponse,\n  TryConnectOptions,\n  WaitForNamespaceOptions\n} from \"./types\";\n","import type { IpcErrorInfo } from \"./types\";\n\nexport type IpcConnectionErrorCode = \"UNAVAILABLE\" | \"TIMEOUT\";\nexport type IpcVersionMismatchDirection =\n  | \"server_outdated\"\n  | \"client_outdated\"\n  | \"legacy_server\";\n\nexport interface IpcConnectionErrorOptions {\n  code?: IpcConnectionErrorCode;\n  cause?: unknown;\n}\n\nexport class AdofaiIpcError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AdofaiIpcError\";\n  }\n}\n\nexport class IpcConnectionError extends AdofaiIpcError {\n  readonly code: IpcConnectionErrorCode;\n  readonly cause?: unknown;\n\n  constructor(\n    message = \"Could not connect to AdofaiIpc.\",\n    options: IpcConnectionErrorOptions = {}\n  ) {\n    super(message);\n    this.name = \"IpcConnectionError\";\n    this.code = options.code ?? \"UNAVAILABLE\";\n    this.cause = options.cause;\n  }\n}\n\nexport class IpcTimeoutError extends IpcConnectionError {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number, options: Pick<IpcConnectionErrorOptions, \"cause\"> = {}) {\n    super(`AdofaiIpc request timed out after ${timeoutMs} ms.`, {\n      code: \"TIMEOUT\",\n      cause: options.cause\n    });\n    this.name = \"IpcTimeoutError\";\n    this.timeoutMs = timeoutMs;\n  }\n}\n\nexport class IpcVersionMismatchError extends AdofaiIpcError {\n  readonly code = \"VERSION_MISMATCH\" as const;\n  readonly clientVersion: string;\n  readonly serverVersion: string | null;\n  readonly direction: IpcVersionMismatchDirection;\n  readonly protocolVersion: number | null;\n\n  constructor(options: {\n    clientVersion: string;\n    serverVersion: string | null;\n    direction: IpcVersionMismatchDirection;\n    protocolVersion: number | null;\n  }) {\n    const server = options.serverVersion ?? \"legacy/unknown\";\n    super(`AdofaiIpc version mismatch: client ${options.clientVersion}, server ${server}.`);\n    this.name = \"IpcVersionMismatchError\";\n    this.clientVersion = options.clientVersion;\n    this.serverVersion = options.serverVersion;\n    this.direction = options.direction;\n    this.protocolVersion = options.protocolVersion;\n  }\n}\n\nexport function isIpcUnavailable(error: unknown): error is IpcConnectionError {\n  return error instanceof IpcConnectionError && error.code === \"UNAVAILABLE\";\n}\n\nexport class IpcHttpError extends AdofaiIpcError {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"IpcHttpError\";\n    this.status = status;\n  }\n}\n\nexport class IpcResponseError extends AdofaiIpcError {\n  readonly code: string;\n  readonly error: IpcErrorInfo;\n\n  constructor(error: IpcErrorInfo) {\n    super(error.message);\n    this.name = \"IpcResponseError\";\n    this.code = error.code;\n    this.error = error;\n  }\n}\n","declare const __CLIENT_VERSION__: string;\n\nexport const CLIENT_VERSION = __CLIENT_VERSION__;\n\nconst CANONICAL_SEMVER = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?$/;\n\ninterface ParsedVersion {\n  core: [number, number, number];\n  prerelease: string[] | null;\n}\n\nexport function compareProductVersions(left: string, right: string): number | null {\n  const leftVersion = parseProductVersion(left);\n  const rightVersion = parseProductVersion(right);\n  if (!leftVersion || !rightVersion) return null;\n\n  for (let index = 0; index < leftVersion.core.length; index++) {\n    const difference = leftVersion.core[index]! - rightVersion.core[index]!;\n    if (difference !== 0) return difference < 0 ? -1 : 1;\n  }\n\n  if (leftVersion.prerelease === null) return rightVersion.prerelease === null ? 0 : 1;\n  if (rightVersion.prerelease === null) return -1;\n\n  const length = Math.max(leftVersion.prerelease.length, rightVersion.prerelease.length);\n  for (let index = 0; index < length; index++) {\n    const leftPart = leftVersion.prerelease[index];\n    const rightPart = rightVersion.prerelease[index];\n    if (leftPart === undefined) return -1;\n    if (rightPart === undefined) return 1;\n    if (leftPart === rightPart) continue;\n\n    const leftNumeric = /^\\d+$/.test(leftPart);\n    const rightNumeric = /^\\d+$/.test(rightPart);\n    if (leftNumeric && rightNumeric) return Number(leftPart) < Number(rightPart) ? -1 : 1;\n    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;\n    return leftPart < rightPart ? -1 : 1;\n  }\n\n  return 0;\n}\n\nfunction parseProductVersion(value: string): ParsedVersion | null {\n  const match = CANONICAL_SEMVER.exec(value);\n  if (!match) return null;\n  return {\n    core: [Number(match[1]), Number(match[2]), Number(match[3])],\n    prerelease: match[4] ? match[4].split(\".\") : null\n  };\n}\n","import {\n  IpcConnectionError,\n  IpcHttpError,\n  IpcResponseError,\n  IpcTimeoutError,\n  IpcVersionMismatchError\n} from \"./errors\";\nimport { CLIENT_VERSION, compareProductVersions } from \"./version\";\nimport type {\n  AdofaiIpcClientOptions,\n  IpcCallOptions,\n  IpcErrorInfo,\n  IpcHealthResponse,\n  IpcNamespaceDetail,\n  IpcNamespacesResponse,\n  IpcRequestId,\n  IpcRequestOptions,\n  IpcResponse,\n  TryConnectOptions,\n  WaitForNamespaceOptions\n} from \"./types\";\n\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_START_PORT = 32145;\nconst DEFAULT_END_PORT = 32155;\nconst DEFAULT_PROBE_TIMEOUT_MS = 500;\nconst DEFAULT_REQUEST_TIMEOUT_MS = 10_000;\nconst DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS = 10_000;\nconst DEFAULT_NAMESPACE_POLL_INTERVAL_MS = 100;\n\nexport class AdofaiIpcClient {\n  readonly baseUrl: string;\n\n  private readonly fetchImpl: typeof fetch;\n  private readonly requestTimeoutMs: number;\n\n  constructor(options: AdofaiIpcClientOptions = {}) {\n    this.baseUrl = normalizeBaseUrl(options.baseUrl ?? `http://${DEFAULT_HOST}:${DEFAULT_START_PORT}`);\n    this.fetchImpl = options.fetch ?? globalThis.fetch;\n    this.requestTimeoutMs =\n      options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n\n    if (!this.fetchImpl) {\n      throw new IpcConnectionError(\"A fetch implementation is required.\");\n    }\n  }\n\n  static async connect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n    return tryConnect(options);\n  }\n\n  async health(options: IpcRequestOptions = {}): Promise<IpcHealthResponse> {\n    return this.get<IpcHealthResponse>(\"/ipc/health\", options);\n  }\n\n  async listNamespaces(options: IpcRequestOptions = {}): Promise<IpcNamespacesResponse> {\n    return this.get<IpcNamespacesResponse>(\"/ipc/namespaces\", options);\n  }\n\n  async getNamespace(\n    namespace: string,\n    options: IpcRequestOptions = {}\n  ): Promise<IpcNamespaceDetail> {\n    return this.get<IpcNamespaceDetail>(\n      `/ipc/namespaces/${encodeURIComponent(namespace)}`,\n      options\n    );\n  }\n\n  async waitForNamespace(\n    namespace: string,\n    options: WaitForNamespaceOptions = {}\n  ): Promise<IpcNamespaceDetail> {\n    const timeoutMs = options.timeoutMs ?? DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS;\n    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_NAMESPACE_POLL_INTERVAL_MS;\n    const requiredStatus = options.status ?? \"registered\";\n    const deadline = Date.now() + timeoutMs;\n    let stateError: IpcResponseError | undefined;\n\n    while (true) {\n      try {\n        const detail = await this.getNamespace(namespace, {\n          timeoutMs: options.requestTimeoutMs\n        });\n\n        if (requiredStatus === \"registered\" || detail.status === \"ready\") {\n          return detail;\n        }\n\n        if (detail.status === \"error\") {\n          throw new IpcResponseError({\n            code: \"namespace_error\",\n            message: detail.error?.message ?? `Namespace initialization failed: ${namespace}`\n          });\n        }\n\n        if (detail.status !== \"initializing\") {\n          throw new IpcResponseError({\n            code: \"namespace_status_unavailable\",\n            message: `Namespace status is unavailable: ${namespace}`\n          });\n        }\n\n        stateError = new IpcResponseError({\n          code: \"namespace_initializing\",\n          message: `Namespace is initializing: ${namespace}`\n        });\n      } catch (error) {\n        if (\n          !(error instanceof IpcResponseError) ||\n          (error.code !== \"namespace_not_found\" && error.code !== \"namespace_initializing\")\n        ) {\n          throw error;\n        }\n\n        stateError = error;\n      }\n\n      const remainingMs = deadline - Date.now();\n      if (remainingMs <= 0) {\n        throw stateError ?? new IpcResponseError({\n          code: \"namespace_initializing\",\n          message: `Namespace is initializing: ${namespace}`\n        });\n      }\n\n      await delay(Math.min(pollIntervalMs, remainingMs));\n    }\n  }\n\n  namespace(namespace: string): AdofaiIpcNamespaceClient {\n    return new AdofaiIpcNamespaceClient(this, namespace);\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    options: IpcCallOptions<TParams>\n  ): Promise<TResult> {\n    const response = await this.post<IpcResponse<TResult>>(\n      \"/ipc\",\n      {\n        namespace: options.namespace,\n        method: options.method,\n        params: options.params ?? {},\n        id: options.id ?? createRequestId()\n      },\n      { timeoutMs: options.timeoutMs }\n    );\n\n    if (!response.ok) {\n      throw new IpcResponseError(response.error);\n    }\n\n    return response.result;\n  }\n\n  private async get<TResult>(\n    path: string,\n    options: IpcRequestOptions = {}\n  ): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"GET\"\n    }, options);\n  }\n\n  private async post<TResult>(\n    path: string,\n    body: unknown,\n    options: IpcRequestOptions = {}\n  ): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify(body)\n    }, options);\n  }\n\n  private async request<TResult>(\n    path: string,\n    init: RequestInit,\n    options: IpcRequestOptions\n  ): Promise<TResult> {\n    const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;\n    const controller = new AbortController();\n    const timeoutError = new IpcTimeoutError(timeoutMs);\n    const timeout = setTimeout(() => controller.abort(timeoutError), timeoutMs);\n\n    try {\n      const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n        ...init,\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        const responseError = parseIpcResponseError(text);\n        if (responseError) throw new IpcResponseError(responseError);\n        throw new IpcHttpError(response.status, text || response.statusText);\n      }\n\n      return (await response.json()) as TResult;\n    } catch (error) {\n      if (error instanceof IpcHttpError || error instanceof IpcResponseError) throw error;\n      if (controller.signal.aborted) {\n        if (error === timeoutError) throw timeoutError;\n        throw new IpcTimeoutError(timeoutMs, { cause: error });\n      }\n      throw new IpcConnectionError(getErrorMessage(error), { cause: error });\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\nexport class AdofaiIpcNamespaceClient {\n  constructor(\n    private readonly client: AdofaiIpcClient,\n    readonly namespace: string\n  ) {\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    method: string,\n    params?: TParams,\n    idOrOptions?: IpcRequestId | IpcRequestOptions,\n    options: IpcRequestOptions = {}\n  ): Promise<TResult> {\n    const requestOptions = isIpcRequestOptions(idOrOptions) ? idOrOptions : options;\n    const id = isIpcRequestOptions(idOrOptions) ? undefined : idOrOptions;\n\n    return this.client.call<TResult, TParams>({\n      namespace: this.namespace,\n      method,\n      params,\n      id,\n      timeoutMs: requestOptions.timeoutMs\n    });\n  }\n}\n\nexport async function tryConnect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n  const host = options.host ?? DEFAULT_HOST;\n  const startPort = options.startPort ?? DEFAULT_START_PORT;\n  const endPort = options.endPort ?? DEFAULT_END_PORT;\n  const probeTimeoutMs =\n    options.probeTimeoutMs ?? options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;\n  const requestTimeoutMs =\n    options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n  let lastProbeError: unknown;\n\n  for (let port = startPort; port <= endPort; port++) {\n    const client = new AdofaiIpcClient({\n      baseUrl: `http://${host}:${port}`,\n      fetch: options.fetch,\n      requestTimeoutMs: probeTimeoutMs\n    });\n\n    try {\n      const health = await client.health();\n\n      if (health.ok && health.server === \"AdofaiIpc\") {\n        const mismatch = getVersionMismatch(health);\n        if (mismatch) {\n          try {\n            options.onVersionMismatch?.(mismatch);\n          } catch {\n          }\n          throw mismatch;\n        }\n        return new AdofaiIpcClient({\n          baseUrl: client.baseUrl,\n          fetch: options.fetch,\n          requestTimeoutMs\n        });\n      }\n    } catch (error) {\n      if (error instanceof IpcVersionMismatchError) throw error;\n      lastProbeError = error;\n    }\n  }\n\n  if (lastProbeError instanceof IpcTimeoutError) throw lastProbeError;\n\n  throw new IpcConnectionError(\n    `Could not connect to AdofaiIpc on ${host}:${startPort}-${endPort}.`\n  );\n}\n\nfunction getVersionMismatch(health: IpcHealthResponse): IpcVersionMismatchError | null {\n  const protocolVersion = Number.isInteger(health.protocolVersion) ? health.protocolVersion : null;\n  const serverVersion = typeof health.serverVersion === \"string\" ? health.serverVersion : null;\n  const comparison = serverVersion === null\n    ? null\n    : compareProductVersions(serverVersion, CLIENT_VERSION);\n\n  if (comparison === 0 && serverVersion === CLIENT_VERSION) return null;\n\n  return new IpcVersionMismatchError({\n    clientVersion: CLIENT_VERSION,\n    serverVersion,\n    direction: comparison === null\n      ? \"legacy_server\"\n      : comparison < 0\n        ? \"server_outdated\"\n        : \"client_outdated\",\n    protocolVersion\n  });\n}\n\nfunction normalizeBaseUrl(value: string): string {\n  return value.replace(/\\/+$/, \"\");\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n  if (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n  ) {\n    return error.message;\n  }\n\n  return undefined;\n}\n\nfunction parseIpcResponseError(text: string): IpcErrorInfo | undefined {\n  try {\n    const value = JSON.parse(text) as { error?: unknown };\n    const error = value?.error;\n\n    if (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      typeof error.code === \"string\" &&\n      \"message\" in error &&\n      typeof error.message === \"string\"\n    ) {\n      return { code: error.code, message: error.message };\n    }\n  } catch {\n  }\n\n  return undefined;\n}\n\nfunction isIpcRequestOptions(value: unknown): value is IpcRequestOptions {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction delay(timeoutMs: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, timeoutMs));\n}\n\nfunction createRequestId(): string {\n  return `adofai-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,9 +1,61 @@
+type IpcConnectionErrorCode = "UNAVAILABLE" | "TIMEOUT";
+type IpcVersionMismatchDirection = "server_outdated" | "client_outdated" | "legacy_server";
+interface IpcConnectionErrorOptions {
+    code?: IpcConnectionErrorCode;
+    cause?: unknown;
+}
+declare class AdofaiIpcError extends Error {
+    constructor(message: string);
+}
+declare class IpcConnectionError extends AdofaiIpcError {
+    readonly code: IpcConnectionErrorCode;
+    readonly cause?: unknown;
+    constructor(message?: string, options?: IpcConnectionErrorOptions);
+}
+declare class IpcTimeoutError extends IpcConnectionError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, options?: Pick<IpcConnectionErrorOptions, "cause">);
+}
+declare class IpcVersionMismatchError extends AdofaiIpcError {
+    readonly code: "VERSION_MISMATCH";
+    readonly clientVersion: string;
+    readonly serverVersion: string | null;
+    readonly direction: IpcVersionMismatchDirection;
+    readonly protocolVersion: number | null;
+    constructor(options: {
+        clientVersion: string;
+        serverVersion: string | null;
+        direction: IpcVersionMismatchDirection;
+        protocolVersion: number | null;
+    });
+}
+declare function isIpcUnavailable(error: unknown): error is IpcConnectionError;
+declare class IpcHttpError extends AdofaiIpcError {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+declare class IpcResponseError extends AdofaiIpcError {
+    readonly code: string;
+    readonly error: IpcErrorInfo;
+    constructor(error: IpcErrorInfo);
+}
+
 type IpcRequestId = string | number | null;
 interface IpcCallOptions<TParams = unknown> {
     namespace: string;
     method: string;
     params?: TParams;
     id?: IpcRequestId;
+    timeoutMs?: number;
+}
+interface IpcRequestOptions {
+    timeoutMs?: number;
+}
+interface WaitForNamespaceOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    requestTimeoutMs?: number;
+    status?: "registered" | "ready";
 }
 interface IpcSuccessResponse<TResult = unknown> {
     ok: true;
@@ -24,13 +76,20 @@ type IpcResponse<TResult = unknown> = IpcSuccessResponse<TResult> | IpcErrorResp
 interface IpcHealthResponse {
     ok: true;
     server: "AdofaiIpc";
+    serverVersion?: string;
     protocolVersion: number;
     port: number;
 }
+type IpcNamespaceStatus = "initializing" | "ready" | "error";
+interface IpcNamespaceErrorInfo {
+    code: string;
+    message: string;
+}
 interface IpcNamespaceSummary {
     name: string;
     displayName: string;
     version: string;
+    status: IpcNamespaceStatus;
 }
 interface IpcNamespacesResponse {
     namespaces: IpcNamespaceSummary[];
@@ -39,11 +98,15 @@ interface IpcNamespaceDetail {
     namespace: string;
     displayName: string;
     version: string;
+    status: IpcNamespaceStatus;
+    error?: IpcNamespaceErrorInfo | null;
     methods: string[];
 }
 interface AdofaiIpcClientOptions {
     baseUrl?: string;
     fetch?: typeof fetch;
+    requestTimeoutMs?: number;
+    /** @deprecated Use requestTimeoutMs instead. */
     timeoutMs?: number;
 }
 interface TryConnectOptions {
@@ -51,18 +114,23 @@ interface TryConnectOptions {
     startPort?: number;
     endPort?: number;
     fetch?: typeof fetch;
+    probeTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    onVersionMismatch?: (error: IpcVersionMismatchError) => void;
+    /** @deprecated Use probeTimeoutMs and requestTimeoutMs instead. */
     timeoutMs?: number;
 }
 
 declare class AdofaiIpcClient {
     readonly baseUrl: string;
     private readonly fetchImpl;
-    private readonly timeoutMs;
+    private readonly requestTimeoutMs;
     constructor(options?: AdofaiIpcClientOptions);
     static connect(options?: TryConnectOptions): Promise<AdofaiIpcClient>;
-    health(): Promise<IpcHealthResponse>;
-    listNamespaces(): Promise<IpcNamespacesResponse>;
-    getNamespace(namespace: string): Promise<IpcNamespaceDetail>;
+    health(options?: IpcRequestOptions): Promise<IpcHealthResponse>;
+    listNamespaces(options?: IpcRequestOptions): Promise<IpcNamespacesResponse>;
+    getNamespace(namespace: string, options?: IpcRequestOptions): Promise<IpcNamespaceDetail>;
+    waitForNamespace(namespace: string, options?: WaitForNamespaceOptions): Promise<IpcNamespaceDetail>;
     namespace(namespace: string): AdofaiIpcNamespaceClient;
     call<TResult = unknown, TParams = unknown>(options: IpcCallOptions<TParams>): Promise<TResult>;
     private get;
@@ -73,24 +141,10 @@ declare class AdofaiIpcNamespaceClient {
     private readonly client;
     readonly namespace: string;
     constructor(client: AdofaiIpcClient, namespace: string);
-    call<TResult = unknown, TParams = unknown>(method: string, params?: TParams, id?: string): Promise<TResult>;
+    call<TResult = unknown, TParams = unknown>(method: string, params?: TParams, idOrOptions?: IpcRequestId | IpcRequestOptions, options?: IpcRequestOptions): Promise<TResult>;
 }
 declare function tryConnect(options?: TryConnectOptions): Promise<AdofaiIpcClient>;
 
-declare class AdofaiIpcError extends Error {
-    constructor(message: string);
-}
-declare class IpcConnectionError extends AdofaiIpcError {
-    constructor(message?: string);
-}
-declare class IpcHttpError extends AdofaiIpcError {
-    readonly status: number;
-    constructor(status: number, message: string);
-}
-declare class IpcResponseError extends AdofaiIpcError {
-    readonly code: string;
-    readonly error: IpcErrorInfo;
-    constructor(error: IpcErrorInfo);
-}
+declare const CLIENT_VERSION: string;
 
-export { AdofaiIpcClient, type AdofaiIpcClientOptions, AdofaiIpcError, AdofaiIpcNamespaceClient, type IpcCallOptions, IpcConnectionError, type IpcErrorInfo, type IpcErrorResponse, type IpcHealthResponse, IpcHttpError, type IpcNamespaceDetail, type IpcNamespaceSummary, type IpcNamespacesResponse, type IpcRequestId, type IpcResponse, IpcResponseError, type IpcSuccessResponse, type TryConnectOptions, tryConnect };
+export { AdofaiIpcClient, type AdofaiIpcClientOptions, AdofaiIpcError, AdofaiIpcNamespaceClient, CLIENT_VERSION, type IpcCallOptions, IpcConnectionError, type IpcConnectionErrorCode, type IpcConnectionErrorOptions, type IpcErrorInfo, type IpcErrorResponse, type IpcHealthResponse, IpcHttpError, type IpcNamespaceDetail, type IpcNamespaceErrorInfo, type IpcNamespaceStatus, type IpcNamespaceSummary, type IpcNamespacesResponse, type IpcRequestId, type IpcRequestOptions, type IpcResponse, IpcResponseError, type IpcSuccessResponse, IpcTimeoutError, type IpcVersionMismatchDirection, IpcVersionMismatchError, type TryConnectOptions, type WaitForNamespaceOptions, isIpcUnavailable, tryConnect };

package/dist/index.d.ts

@@ -1,9 +1,61 @@
+type IpcConnectionErrorCode = "UNAVAILABLE" | "TIMEOUT";
+type IpcVersionMismatchDirection = "server_outdated" | "client_outdated" | "legacy_server";
+interface IpcConnectionErrorOptions {
+    code?: IpcConnectionErrorCode;
+    cause?: unknown;
+}
+declare class AdofaiIpcError extends Error {
+    constructor(message: string);
+}
+declare class IpcConnectionError extends AdofaiIpcError {
+    readonly code: IpcConnectionErrorCode;
+    readonly cause?: unknown;
+    constructor(message?: string, options?: IpcConnectionErrorOptions);
+}
+declare class IpcTimeoutError extends IpcConnectionError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, options?: Pick<IpcConnectionErrorOptions, "cause">);
+}
+declare class IpcVersionMismatchError extends AdofaiIpcError {
+    readonly code: "VERSION_MISMATCH";
+    readonly clientVersion: string;
+    readonly serverVersion: string | null;
+    readonly direction: IpcVersionMismatchDirection;
+    readonly protocolVersion: number | null;
+    constructor(options: {
+        clientVersion: string;
+        serverVersion: string | null;
+        direction: IpcVersionMismatchDirection;
+        protocolVersion: number | null;
+    });
+}
+declare function isIpcUnavailable(error: unknown): error is IpcConnectionError;
+declare class IpcHttpError extends AdofaiIpcError {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+declare class IpcResponseError extends AdofaiIpcError {
+    readonly code: string;
+    readonly error: IpcErrorInfo;
+    constructor(error: IpcErrorInfo);
+}
+
 type IpcRequestId = string | number | null;
 interface IpcCallOptions<TParams = unknown> {
     namespace: string;
     method: string;
     params?: TParams;
     id?: IpcRequestId;
+    timeoutMs?: number;
+}
+interface IpcRequestOptions {
+    timeoutMs?: number;
+}
+interface WaitForNamespaceOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    requestTimeoutMs?: number;
+    status?: "registered" | "ready";
 }
 interface IpcSuccessResponse<TResult = unknown> {
     ok: true;
@@ -24,13 +76,20 @@ type IpcResponse<TResult = unknown> = IpcSuccessResponse<TResult> | IpcErrorResp
 interface IpcHealthResponse {
     ok: true;
     server: "AdofaiIpc";
+    serverVersion?: string;
     protocolVersion: number;
     port: number;
 }
+type IpcNamespaceStatus = "initializing" | "ready" | "error";
+interface IpcNamespaceErrorInfo {
+    code: string;
+    message: string;
+}
 interface IpcNamespaceSummary {
     name: string;
     displayName: string;
     version: string;
+    status: IpcNamespaceStatus;
 }
 interface IpcNamespacesResponse {
     namespaces: IpcNamespaceSummary[];
@@ -39,11 +98,15 @@ interface IpcNamespaceDetail {
     namespace: string;
     displayName: string;
     version: string;
+    status: IpcNamespaceStatus;
+    error?: IpcNamespaceErrorInfo | null;
     methods: string[];
 }
 interface AdofaiIpcClientOptions {
     baseUrl?: string;
     fetch?: typeof fetch;
+    requestTimeoutMs?: number;
+    /** @deprecated Use requestTimeoutMs instead. */
     timeoutMs?: number;
 }
 interface TryConnectOptions {
@@ -51,18 +114,23 @@ interface TryConnectOptions {
     startPort?: number;
     endPort?: number;
     fetch?: typeof fetch;
+    probeTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    onVersionMismatch?: (error: IpcVersionMismatchError) => void;
+    /** @deprecated Use probeTimeoutMs and requestTimeoutMs instead. */
     timeoutMs?: number;
 }
 
 declare class AdofaiIpcClient {
     readonly baseUrl: string;
     private readonly fetchImpl;
-    private readonly timeoutMs;
+    private readonly requestTimeoutMs;
     constructor(options?: AdofaiIpcClientOptions);
     static connect(options?: TryConnectOptions): Promise<AdofaiIpcClient>;
-    health(): Promise<IpcHealthResponse>;
-    listNamespaces(): Promise<IpcNamespacesResponse>;
-    getNamespace(namespace: string): Promise<IpcNamespaceDetail>;
+    health(options?: IpcRequestOptions): Promise<IpcHealthResponse>;
+    listNamespaces(options?: IpcRequestOptions): Promise<IpcNamespacesResponse>;
+    getNamespace(namespace: string, options?: IpcRequestOptions): Promise<IpcNamespaceDetail>;
+    waitForNamespace(namespace: string, options?: WaitForNamespaceOptions): Promise<IpcNamespaceDetail>;
     namespace(namespace: string): AdofaiIpcNamespaceClient;
     call<TResult = unknown, TParams = unknown>(options: IpcCallOptions<TParams>): Promise<TResult>;
     private get;
@@ -73,24 +141,10 @@ declare class AdofaiIpcNamespaceClient {
     private readonly client;
     readonly namespace: string;
     constructor(client: AdofaiIpcClient, namespace: string);
-    call<TResult = unknown, TParams = unknown>(method: string, params?: TParams, id?: string): Promise<TResult>;
+    call<TResult = unknown, TParams = unknown>(method: string, params?: TParams, idOrOptions?: IpcRequestId | IpcRequestOptions, options?: IpcRequestOptions): Promise<TResult>;
 }
 declare function tryConnect(options?: TryConnectOptions): Promise<AdofaiIpcClient>;
 
-declare class AdofaiIpcError extends Error {
-    constructor(message: string);
-}
-declare class IpcConnectionError extends AdofaiIpcError {
-    constructor(message?: string);
-}
-declare class IpcHttpError extends AdofaiIpcError {
-    readonly status: number;
-    constructor(status: number, message: string);
-}
-declare class IpcResponseError extends AdofaiIpcError {
-    readonly code: string;
-    readonly error: IpcErrorInfo;
-    constructor(error: IpcErrorInfo);
-}
+declare const CLIENT_VERSION: string;
 
-export { AdofaiIpcClient, type AdofaiIpcClientOptions, AdofaiIpcError, AdofaiIpcNamespaceClient, type IpcCallOptions, IpcConnectionError, type IpcErrorInfo, type IpcErrorResponse, type IpcHealthResponse, IpcHttpError, type IpcNamespaceDetail, type IpcNamespaceSummary, type IpcNamespacesResponse, type IpcRequestId, type IpcResponse, IpcResponseError, type IpcSuccessResponse, type TryConnectOptions, tryConnect };
+export { AdofaiIpcClient, type AdofaiIpcClientOptions, AdofaiIpcError, AdofaiIpcNamespaceClient, CLIENT_VERSION, type IpcCallOptions, IpcConnectionError, type IpcConnectionErrorCode, type IpcConnectionErrorOptions, type IpcErrorInfo, type IpcErrorResponse, type IpcHealthResponse, IpcHttpError, type IpcNamespaceDetail, type IpcNamespaceErrorInfo, type IpcNamespaceStatus, type IpcNamespaceSummary, type IpcNamespacesResponse, type IpcRequestId, type IpcRequestOptions, type IpcResponse, IpcResponseError, type IpcSuccessResponse, IpcTimeoutError, type IpcVersionMismatchDirection, IpcVersionMismatchError, type TryConnectOptions, type WaitForNamespaceOptions, isIpcUnavailable, tryConnect };

package/dist/index.js

@@ -6,11 +6,38 @@ var AdofaiIpcError = class extends Error {
   }
 };
 var IpcConnectionError = class extends AdofaiIpcError {
-  constructor(message = "Could not connect to AdofaiIpc.") {
+  constructor(message = "Could not connect to AdofaiIpc.", options = {}) {
     super(message);
     this.name = "IpcConnectionError";
+    this.code = options.code ?? "UNAVAILABLE";
+    this.cause = options.cause;
   }
 };
+var IpcTimeoutError = class extends IpcConnectionError {
+  constructor(timeoutMs, options = {}) {
+    super(`AdofaiIpc request timed out after ${timeoutMs} ms.`, {
+      code: "TIMEOUT",
+      cause: options.cause
+    });
+    this.name = "IpcTimeoutError";
+    this.timeoutMs = timeoutMs;
+  }
+};
+var IpcVersionMismatchError = class extends AdofaiIpcError {
+  constructor(options) {
+    const server = options.serverVersion ?? "legacy/unknown";
+    super(`AdofaiIpc version mismatch: client ${options.clientVersion}, server ${server}.`);
+    this.code = "VERSION_MISMATCH";
+    this.name = "IpcVersionMismatchError";
+    this.clientVersion = options.clientVersion;
+    this.serverVersion = options.serverVersion;
+    this.direction = options.direction;
+    this.protocolVersion = options.protocolVersion;
+  }
+};
+function isIpcUnavailable(error) {
+  return error instanceof IpcConnectionError && error.code === "UNAVAILABLE";
+}
 var IpcHttpError = class extends AdofaiIpcError {
   constructor(status, message) {
     super(message);
@@ -27,16 +54,56 @@ var IpcResponseError = class extends AdofaiIpcError {
   }
 };
 
+// src/version.ts
+var CLIENT_VERSION = "0.3.0";
+var CANONICAL_SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?$/;
+function compareProductVersions(left, right) {
+  const leftVersion = parseProductVersion(left);
+  const rightVersion = parseProductVersion(right);
+  if (!leftVersion || !rightVersion) return null;
+  for (let index = 0; index < leftVersion.core.length; index++) {
+    const difference = leftVersion.core[index] - rightVersion.core[index];
+    if (difference !== 0) return difference < 0 ? -1 : 1;
+  }
+  if (leftVersion.prerelease === null) return rightVersion.prerelease === null ? 0 : 1;
+  if (rightVersion.prerelease === null) return -1;
+  const length = Math.max(leftVersion.prerelease.length, rightVersion.prerelease.length);
+  for (let index = 0; index < length; index++) {
+    const leftPart = leftVersion.prerelease[index];
+    const rightPart = rightVersion.prerelease[index];
+    if (leftPart === void 0) return -1;
+    if (rightPart === void 0) return 1;
+    if (leftPart === rightPart) continue;
+    const leftNumeric = /^\d+$/.test(leftPart);
+    const rightNumeric = /^\d+$/.test(rightPart);
+    if (leftNumeric && rightNumeric) return Number(leftPart) < Number(rightPart) ? -1 : 1;
+    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;
+    return leftPart < rightPart ? -1 : 1;
+  }
+  return 0;
+}
+function parseProductVersion(value) {
+  const match = CANONICAL_SEMVER.exec(value);
+  if (!match) return null;
+  return {
+    core: [Number(match[1]), Number(match[2]), Number(match[3])],
+    prerelease: match[4] ? match[4].split(".") : null
+  };
+}
+
 // src/client.ts
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_START_PORT = 32145;
 var DEFAULT_END_PORT = 32155;
-var DEFAULT_TIMEOUT_MS = 500;
+var DEFAULT_PROBE_TIMEOUT_MS = 500;
+var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
+var DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS = 1e4;
+var DEFAULT_NAMESPACE_POLL_INTERVAL_MS = 100;
 var AdofaiIpcClient = class {
   constructor(options = {}) {
     this.baseUrl = normalizeBaseUrl(options.baseUrl ?? `http://${DEFAULT_HOST}:${DEFAULT_START_PORT}`);
     this.fetchImpl = options.fetch ?? globalThis.fetch;
-    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.requestTimeoutMs = options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     if (!this.fetchImpl) {
       throw new IpcConnectionError("A fetch implementation is required.");
     }
@@ -44,47 +111,102 @@ var AdofaiIpcClient = class {
   static async connect(options = {}) {
     return tryConnect(options);
   }
-  async health() {
-    return this.get("/ipc/health");
+  async health(options = {}) {
+    return this.get("/ipc/health", options);
+  }
+  async listNamespaces(options = {}) {
+    return this.get("/ipc/namespaces", options);
   }
-  async listNamespaces() {
-    return this.get("/ipc/namespaces");
+  async getNamespace(namespace, options = {}) {
+    return this.get(
+      `/ipc/namespaces/${encodeURIComponent(namespace)}`,
+      options
+    );
   }
-  async getNamespace(namespace) {
-    return this.get(`/ipc/namespaces/${encodeURIComponent(namespace)}`);
+  async waitForNamespace(namespace, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS;
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_NAMESPACE_POLL_INTERVAL_MS;
+    const requiredStatus = options.status ?? "registered";
+    const deadline = Date.now() + timeoutMs;
+    let stateError;
+    while (true) {
+      try {
+        const detail = await this.getNamespace(namespace, {
+          timeoutMs: options.requestTimeoutMs
+        });
+        if (requiredStatus === "registered" || detail.status === "ready") {
+          return detail;
+        }
+        if (detail.status === "error") {
+          throw new IpcResponseError({
+            code: "namespace_error",
+            message: detail.error?.message ?? `Namespace initialization failed: ${namespace}`
+          });
+        }
+        if (detail.status !== "initializing") {
+          throw new IpcResponseError({
+            code: "namespace_status_unavailable",
+            message: `Namespace status is unavailable: ${namespace}`
+          });
+        }
+        stateError = new IpcResponseError({
+          code: "namespace_initializing",
+          message: `Namespace is initializing: ${namespace}`
+        });
+      } catch (error) {
+        if (!(error instanceof IpcResponseError) || error.code !== "namespace_not_found" && error.code !== "namespace_initializing") {
+          throw error;
+        }
+        stateError = error;
+      }
+      const remainingMs = deadline - Date.now();
+      if (remainingMs <= 0) {
+        throw stateError ?? new IpcResponseError({
+          code: "namespace_initializing",
+          message: `Namespace is initializing: ${namespace}`
+        });
+      }
+      await delay(Math.min(pollIntervalMs, remainingMs));
+    }
   }
   namespace(namespace) {
     return new AdofaiIpcNamespaceClient(this, namespace);
   }
   async call(options) {
-    const response = await this.post("/ipc", {
-      namespace: options.namespace,
-      method: options.method,
-      params: options.params ?? {},
-      id: options.id ?? createRequestId()
-    });
+    const response = await this.post(
+      "/ipc",
+      {
+        namespace: options.namespace,
+        method: options.method,
+        params: options.params ?? {},
+        id: options.id ?? createRequestId()
+      },
+      { timeoutMs: options.timeoutMs }
+    );
     if (!response.ok) {
       throw new IpcResponseError(response.error);
     }
     return response.result;
   }
-  async get(path) {
+  async get(path, options = {}) {
     return this.request(path, {
       method: "GET"
-    });
+    }, options);
   }
-  async post(path, body) {
+  async post(path, body, options = {}) {
     return this.request(path, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
       body: JSON.stringify(body)
-    });
+    }, options);
   }
-  async request(path, init) {
+  async request(path, init, options) {
+    const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    const timeoutError = new IpcTimeoutError(timeoutMs);
+    const timeout = setTimeout(() => controller.abort(timeoutError), timeoutMs);
     try {
       const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
         ...init,
@@ -92,13 +214,18 @@ var AdofaiIpcClient = class {
       });
       if (!response.ok) {
         const text = await response.text();
+        const responseError = parseIpcResponseError(text);
+        if (responseError) throw new IpcResponseError(responseError);
         throw new IpcHttpError(response.status, text || response.statusText);
       }
       return await response.json();
     } catch (error) {
-      if (error instanceof IpcHttpError) throw error;
-      if (error instanceof Error) throw new IpcConnectionError(error.message);
-      throw new IpcConnectionError();
+      if (error instanceof IpcHttpError || error instanceof IpcResponseError) throw error;
+      if (controller.signal.aborted) {
+        if (error === timeoutError) throw timeoutError;
+        throw new IpcTimeoutError(timeoutMs, { cause: error });
+      }
+      throw new IpcConnectionError(getErrorMessage(error), { cause: error });
     } finally {
       clearTimeout(timeout);
     }
@@ -109,12 +236,15 @@ var AdofaiIpcNamespaceClient = class {
     this.client = client;
     this.namespace = namespace;
   }
-  async call(method, params, id) {
+  async call(method, params, idOrOptions, options = {}) {
+    const requestOptions = isIpcRequestOptions(idOrOptions) ? idOrOptions : options;
+    const id = isIpcRequestOptions(idOrOptions) ? void 0 : idOrOptions;
     return this.client.call({
       namespace: this.namespace,
       method,
       params,
-      id
+      id,
+      timeoutMs: requestOptions.timeoutMs
     });
   }
 };
@@ -122,27 +252,80 @@ async function tryConnect(options = {}) {
   const host = options.host ?? DEFAULT_HOST;
   const startPort = options.startPort ?? DEFAULT_START_PORT;
   const endPort = options.endPort ?? DEFAULT_END_PORT;
+  const probeTimeoutMs = options.probeTimeoutMs ?? options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+  const requestTimeoutMs = options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+  let lastProbeError;
   for (let port = startPort; port <= endPort; port++) {
     const client = new AdofaiIpcClient({
       baseUrl: `http://${host}:${port}`,
       fetch: options.fetch,
-      timeoutMs: options.timeoutMs
+      requestTimeoutMs: probeTimeoutMs
     });
     try {
       const health = await client.health();
       if (health.ok && health.server === "AdofaiIpc") {
-        return client;
+        const mismatch = getVersionMismatch(health);
+        if (mismatch) {
+          try {
+            options.onVersionMismatch?.(mismatch);
+          } catch {
+          }
+          throw mismatch;
+        }
+        return new AdofaiIpcClient({
+          baseUrl: client.baseUrl,
+          fetch: options.fetch,
+          requestTimeoutMs
+        });
       }
-    } catch {
+    } catch (error) {
+      if (error instanceof IpcVersionMismatchError) throw error;
+      lastProbeError = error;
     }
   }
+  if (lastProbeError instanceof IpcTimeoutError) throw lastProbeError;
   throw new IpcConnectionError(
     `Could not connect to AdofaiIpc on ${host}:${startPort}-${endPort}.`
   );
 }
+function getVersionMismatch(health) {
+  const protocolVersion = Number.isInteger(health.protocolVersion) ? health.protocolVersion : null;
+  const serverVersion = typeof health.serverVersion === "string" ? health.serverVersion : null;
+  const comparison = serverVersion === null ? null : compareProductVersions(serverVersion, CLIENT_VERSION);
+  if (comparison === 0 && serverVersion === CLIENT_VERSION) return null;
+  return new IpcVersionMismatchError({
+    clientVersion: CLIENT_VERSION,
+    serverVersion,
+    direction: comparison === null ? "legacy_server" : comparison < 0 ? "server_outdated" : "client_outdated",
+    protocolVersion
+  });
+}
 function normalizeBaseUrl(value) {
   return value.replace(/\/+$/, "");
 }
+function getErrorMessage(error) {
+  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
+    return error.message;
+  }
+  return void 0;
+}
+function parseIpcResponseError(text) {
+  try {
+    const value = JSON.parse(text);
+    const error = value?.error;
+    if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" && "message" in error && typeof error.message === "string") {
+      return { code: error.code, message: error.message };
+    }
+  } catch {
+  }
+  return void 0;
+}
+function isIpcRequestOptions(value) {
+  return typeof value === "object" && value !== null;
+}
+function delay(timeoutMs) {
+  return new Promise((resolve) => setTimeout(resolve, timeoutMs));
+}
 function createRequestId() {
   return `adofai-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
@@ -150,9 +333,13 @@ export {
   AdofaiIpcClient,
   AdofaiIpcError,
   AdofaiIpcNamespaceClient,
+  CLIENT_VERSION,
   IpcConnectionError,
   IpcHttpError,
   IpcResponseError,
+  IpcTimeoutError,
+  IpcVersionMismatchError,
+  isIpcUnavailable,
   tryConnect
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { IpcErrorInfo } from \"./types\";\n\nexport class AdofaiIpcError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AdofaiIpcError\";\n  }\n}\n\nexport class IpcConnectionError extends AdofaiIpcError {\n  constructor(message = \"Could not connect to AdofaiIpc.\") {\n    super(message);\n    this.name = \"IpcConnectionError\";\n  }\n}\n\nexport class IpcHttpError extends AdofaiIpcError {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"IpcHttpError\";\n    this.status = status;\n  }\n}\n\nexport class IpcResponseError extends AdofaiIpcError {\n  readonly code: string;\n  readonly error: IpcErrorInfo;\n\n  constructor(error: IpcErrorInfo) {\n    super(error.message);\n    this.name = \"IpcResponseError\";\n    this.code = error.code;\n    this.error = error;\n  }\n}\n","import { IpcConnectionError, IpcHttpError, IpcResponseError } from \"./errors\";\nimport type {\n  AdofaiIpcClientOptions,\n  IpcCallOptions,\n  IpcHealthResponse,\n  IpcNamespaceDetail,\n  IpcNamespacesResponse,\n  IpcResponse,\n  TryConnectOptions\n} from \"./types\";\n\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_START_PORT = 32145;\nconst DEFAULT_END_PORT = 32155;\nconst DEFAULT_TIMEOUT_MS = 500;\n\nexport class AdofaiIpcClient {\n  readonly baseUrl: string;\n\n  private readonly fetchImpl: typeof fetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: AdofaiIpcClientOptions = {}) {\n    this.baseUrl = normalizeBaseUrl(options.baseUrl ?? `http://${DEFAULT_HOST}:${DEFAULT_START_PORT}`);\n    this.fetchImpl = options.fetch ?? globalThis.fetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n    if (!this.fetchImpl) {\n      throw new IpcConnectionError(\"A fetch implementation is required.\");\n    }\n  }\n\n  static async connect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n    return tryConnect(options);\n  }\n\n  async health(): Promise<IpcHealthResponse> {\n    return this.get<IpcHealthResponse>(\"/ipc/health\");\n  }\n\n  async listNamespaces(): Promise<IpcNamespacesResponse> {\n    return this.get<IpcNamespacesResponse>(\"/ipc/namespaces\");\n  }\n\n  async getNamespace(namespace: string): Promise<IpcNamespaceDetail> {\n    return this.get<IpcNamespaceDetail>(`/ipc/namespaces/${encodeURIComponent(namespace)}`);\n  }\n\n  namespace(namespace: string): AdofaiIpcNamespaceClient {\n    return new AdofaiIpcNamespaceClient(this, namespace);\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    options: IpcCallOptions<TParams>\n  ): Promise<TResult> {\n    const response = await this.post<IpcResponse<TResult>>(\"/ipc\", {\n      namespace: options.namespace,\n      method: options.method,\n      params: options.params ?? {},\n      id: options.id ?? createRequestId()\n    });\n\n    if (!response.ok) {\n      throw new IpcResponseError(response.error);\n    }\n\n    return response.result;\n  }\n\n  private async get<TResult>(path: string): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"GET\"\n    });\n  }\n\n  private async post<TResult>(path: string, body: unknown): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify(body)\n    });\n  }\n\n  private async request<TResult>(path: string, init: RequestInit): Promise<TResult> {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n        ...init,\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        throw new IpcHttpError(response.status, text || response.statusText);\n      }\n\n      return (await response.json()) as TResult;\n    } catch (error) {\n      if (error instanceof IpcHttpError) throw error;\n      if (error instanceof Error) throw new IpcConnectionError(error.message);\n      throw new IpcConnectionError();\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\nexport class AdofaiIpcNamespaceClient {\n  constructor(\n    private readonly client: AdofaiIpcClient,\n    readonly namespace: string\n  ) {\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    method: string,\n    params?: TParams,\n    id?: string\n  ): Promise<TResult> {\n    return this.client.call<TResult, TParams>({\n      namespace: this.namespace,\n      method,\n      params,\n      id\n    });\n  }\n}\n\nexport async function tryConnect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n  const host = options.host ?? DEFAULT_HOST;\n  const startPort = options.startPort ?? DEFAULT_START_PORT;\n  const endPort = options.endPort ?? DEFAULT_END_PORT;\n\n  for (let port = startPort; port <= endPort; port++) {\n    const client = new AdofaiIpcClient({\n      baseUrl: `http://${host}:${port}`,\n      fetch: options.fetch,\n      timeoutMs: options.timeoutMs\n    });\n\n    try {\n      const health = await client.health();\n\n      if (health.ok && health.server === \"AdofaiIpc\") {\n        return client;\n      }\n    } catch {\n    }\n  }\n\n  throw new IpcConnectionError(\n    `Could not connect to AdofaiIpc on ${host}:${startPort}-${endPort}.`\n  );\n}\n\nfunction normalizeBaseUrl(value: string): string {\n  return value.replace(/\\/+$/, \"\");\n}\n\nfunction createRequestId(): string {\n  return `adofai-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n"],"mappings":";AAEO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,qBAAN,cAAiC,eAAe;AAAA,EACrD,YAAY,UAAU,mCAAmC;AACvD,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,eAAN,cAA2B,eAAe;AAAA,EAG/C,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;AAEO,IAAM,mBAAN,cAA+B,eAAe;AAAA,EAInD,YAAY,OAAqB;AAC/B,UAAM,MAAM,OAAO;AACnB,SAAK,OAAO;AACZ,SAAK,OAAO,MAAM;AAClB,SAAK,QAAQ;AAAA,EACf;AACF;;;ACzBA,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAC3B,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAEpB,IAAM,kBAAN,MAAsB;AAAA,EAM3B,YAAY,UAAkC,CAAC,GAAG;AAChD,SAAK,UAAU,iBAAiB,QAAQ,WAAW,UAAU,YAAY,IAAI,kBAAkB,EAAE;AACjG,SAAK,YAAY,QAAQ,SAAS,WAAW;AAC7C,SAAK,YAAY,QAAQ,aAAa;AAEtC,QAAI,CAAC,KAAK,WAAW;AACnB,YAAM,IAAI,mBAAmB,qCAAqC;AAAA,IACpE;AAAA,EACF;AAAA,EAEA,aAAa,QAAQ,UAA6B,CAAC,GAA6B;AAC9E,WAAO,WAAW,OAAO;AAAA,EAC3B;AAAA,EAEA,MAAM,SAAqC;AACzC,WAAO,KAAK,IAAuB,aAAa;AAAA,EAClD;AAAA,EAEA,MAAM,iBAAiD;AACrD,WAAO,KAAK,IAA2B,iBAAiB;AAAA,EAC1D;AAAA,EAEA,MAAM,aAAa,WAAgD;AACjE,WAAO,KAAK,IAAwB,mBAAmB,mBAAmB,SAAS,CAAC,EAAE;AAAA,EACxF;AAAA,EAEA,UAAU,WAA6C;AACrD,WAAO,IAAI,yBAAyB,MAAM,SAAS;AAAA,EACrD;AAAA,EAEA,MAAM,KACJ,SACkB;AAClB,UAAM,WAAW,MAAM,KAAK,KAA2B,QAAQ;AAAA,MAC7D,WAAW,QAAQ;AAAA,MACnB,QAAQ,QAAQ;AAAA,MAChB,QAAQ,QAAQ,UAAU,CAAC;AAAA,MAC3B,IAAI,QAAQ,MAAM,gBAAgB;AAAA,IACpC,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,iBAAiB,SAAS,KAAK;AAAA,IAC3C;AAEA,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAc,IAAa,MAAgC;AACzD,WAAO,KAAK,QAAiB,MAAM;AAAA,MACjC,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,KAAc,MAAc,MAAiC;AACzE,WAAO,KAAK,QAAiB,MAAM;AAAA,MACjC,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,QAAiB,MAAc,MAAqC;AAChF,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,UAAU,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,SAAS;AAEnE,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,UAAU,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,QAC9D,GAAG;AAAA,QACH,QAAQ,WAAW;AAAA,MACrB,CAAC;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,OAAO,MAAM,SAAS,KAAK;AACjC,cAAM,IAAI,aAAa,SAAS,QAAQ,QAAQ,SAAS,UAAU;AAAA,MACrE;AAEA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,SAAS,OAAO;AACd,UAAI,iBAAiB,aAAc,OAAM;AACzC,UAAI,iBAAiB,MAAO,OAAM,IAAI,mBAAmB,MAAM,OAAO;AACtE,YAAM,IAAI,mBAAmB;AAAA,IAC/B,UAAE;AACA,mBAAa,OAAO;AAAA,IACtB;AAAA,EACF;AACF;AAEO,IAAM,2BAAN,MAA+B;AAAA,EACpC,YACmB,QACR,WACT;AAFiB;AACR;AAAA,EAEX;AAAA,EAEA,MAAM,KACJ,QACA,QACA,IACkB;AAClB,WAAO,KAAK,OAAO,KAAuB;AAAA,MACxC,WAAW,KAAK;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,eAAsB,WAAW,UAA6B,CAAC,GAA6B;AAC1F,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,UAAU,QAAQ,WAAW;AAEnC,WAAS,OAAO,WAAW,QAAQ,SAAS,QAAQ;AAClD,UAAM,SAAS,IAAI,gBAAgB;AAAA,MACjC,SAAS,UAAU,IAAI,IAAI,IAAI;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,WAAW,QAAQ;AAAA,IACrB,CAAC;AAED,QAAI;AACF,YAAM,SAAS,MAAM,OAAO,OAAO;AAEnC,UAAI,OAAO,MAAM,OAAO,WAAW,aAAa;AAC9C,eAAO;AAAA,MACT;AAAA,IACF,QAAQ;AAAA,IACR;AAAA,EACF;AAEA,QAAM,IAAI;AAAA,IACR,qCAAqC,IAAI,IAAI,SAAS,IAAI,OAAO;AAAA,EACnE;AACF;AAEA,SAAS,iBAAiB,OAAuB;AAC/C,SAAO,MAAM,QAAQ,QAAQ,EAAE;AACjC;AAEA,SAAS,kBAA0B;AACjC,SAAO,cAAc,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AACxE;","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["import type { IpcErrorInfo } from \"./types\";\n\nexport type IpcConnectionErrorCode = \"UNAVAILABLE\" | \"TIMEOUT\";\nexport type IpcVersionMismatchDirection =\n  | \"server_outdated\"\n  | \"client_outdated\"\n  | \"legacy_server\";\n\nexport interface IpcConnectionErrorOptions {\n  code?: IpcConnectionErrorCode;\n  cause?: unknown;\n}\n\nexport class AdofaiIpcError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AdofaiIpcError\";\n  }\n}\n\nexport class IpcConnectionError extends AdofaiIpcError {\n  readonly code: IpcConnectionErrorCode;\n  readonly cause?: unknown;\n\n  constructor(\n    message = \"Could not connect to AdofaiIpc.\",\n    options: IpcConnectionErrorOptions = {}\n  ) {\n    super(message);\n    this.name = \"IpcConnectionError\";\n    this.code = options.code ?? \"UNAVAILABLE\";\n    this.cause = options.cause;\n  }\n}\n\nexport class IpcTimeoutError extends IpcConnectionError {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number, options: Pick<IpcConnectionErrorOptions, \"cause\"> = {}) {\n    super(`AdofaiIpc request timed out after ${timeoutMs} ms.`, {\n      code: \"TIMEOUT\",\n      cause: options.cause\n    });\n    this.name = \"IpcTimeoutError\";\n    this.timeoutMs = timeoutMs;\n  }\n}\n\nexport class IpcVersionMismatchError extends AdofaiIpcError {\n  readonly code = \"VERSION_MISMATCH\" as const;\n  readonly clientVersion: string;\n  readonly serverVersion: string | null;\n  readonly direction: IpcVersionMismatchDirection;\n  readonly protocolVersion: number | null;\n\n  constructor(options: {\n    clientVersion: string;\n    serverVersion: string | null;\n    direction: IpcVersionMismatchDirection;\n    protocolVersion: number | null;\n  }) {\n    const server = options.serverVersion ?? \"legacy/unknown\";\n    super(`AdofaiIpc version mismatch: client ${options.clientVersion}, server ${server}.`);\n    this.name = \"IpcVersionMismatchError\";\n    this.clientVersion = options.clientVersion;\n    this.serverVersion = options.serverVersion;\n    this.direction = options.direction;\n    this.protocolVersion = options.protocolVersion;\n  }\n}\n\nexport function isIpcUnavailable(error: unknown): error is IpcConnectionError {\n  return error instanceof IpcConnectionError && error.code === \"UNAVAILABLE\";\n}\n\nexport class IpcHttpError extends AdofaiIpcError {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"IpcHttpError\";\n    this.status = status;\n  }\n}\n\nexport class IpcResponseError extends AdofaiIpcError {\n  readonly code: string;\n  readonly error: IpcErrorInfo;\n\n  constructor(error: IpcErrorInfo) {\n    super(error.message);\n    this.name = \"IpcResponseError\";\n    this.code = error.code;\n    this.error = error;\n  }\n}\n","declare const __CLIENT_VERSION__: string;\n\nexport const CLIENT_VERSION = __CLIENT_VERSION__;\n\nconst CANONICAL_SEMVER = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?$/;\n\ninterface ParsedVersion {\n  core: [number, number, number];\n  prerelease: string[] | null;\n}\n\nexport function compareProductVersions(left: string, right: string): number | null {\n  const leftVersion = parseProductVersion(left);\n  const rightVersion = parseProductVersion(right);\n  if (!leftVersion || !rightVersion) return null;\n\n  for (let index = 0; index < leftVersion.core.length; index++) {\n    const difference = leftVersion.core[index]! - rightVersion.core[index]!;\n    if (difference !== 0) return difference < 0 ? -1 : 1;\n  }\n\n  if (leftVersion.prerelease === null) return rightVersion.prerelease === null ? 0 : 1;\n  if (rightVersion.prerelease === null) return -1;\n\n  const length = Math.max(leftVersion.prerelease.length, rightVersion.prerelease.length);\n  for (let index = 0; index < length; index++) {\n    const leftPart = leftVersion.prerelease[index];\n    const rightPart = rightVersion.prerelease[index];\n    if (leftPart === undefined) return -1;\n    if (rightPart === undefined) return 1;\n    if (leftPart === rightPart) continue;\n\n    const leftNumeric = /^\\d+$/.test(leftPart);\n    const rightNumeric = /^\\d+$/.test(rightPart);\n    if (leftNumeric && rightNumeric) return Number(leftPart) < Number(rightPart) ? -1 : 1;\n    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;\n    return leftPart < rightPart ? -1 : 1;\n  }\n\n  return 0;\n}\n\nfunction parseProductVersion(value: string): ParsedVersion | null {\n  const match = CANONICAL_SEMVER.exec(value);\n  if (!match) return null;\n  return {\n    core: [Number(match[1]), Number(match[2]), Number(match[3])],\n    prerelease: match[4] ? match[4].split(\".\") : null\n  };\n}\n","import {\n  IpcConnectionError,\n  IpcHttpError,\n  IpcResponseError,\n  IpcTimeoutError,\n  IpcVersionMismatchError\n} from \"./errors\";\nimport { CLIENT_VERSION, compareProductVersions } from \"./version\";\nimport type {\n  AdofaiIpcClientOptions,\n  IpcCallOptions,\n  IpcErrorInfo,\n  IpcHealthResponse,\n  IpcNamespaceDetail,\n  IpcNamespacesResponse,\n  IpcRequestId,\n  IpcRequestOptions,\n  IpcResponse,\n  TryConnectOptions,\n  WaitForNamespaceOptions\n} from \"./types\";\n\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_START_PORT = 32145;\nconst DEFAULT_END_PORT = 32155;\nconst DEFAULT_PROBE_TIMEOUT_MS = 500;\nconst DEFAULT_REQUEST_TIMEOUT_MS = 10_000;\nconst DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS = 10_000;\nconst DEFAULT_NAMESPACE_POLL_INTERVAL_MS = 100;\n\nexport class AdofaiIpcClient {\n  readonly baseUrl: string;\n\n  private readonly fetchImpl: typeof fetch;\n  private readonly requestTimeoutMs: number;\n\n  constructor(options: AdofaiIpcClientOptions = {}) {\n    this.baseUrl = normalizeBaseUrl(options.baseUrl ?? `http://${DEFAULT_HOST}:${DEFAULT_START_PORT}`);\n    this.fetchImpl = options.fetch ?? globalThis.fetch;\n    this.requestTimeoutMs =\n      options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n\n    if (!this.fetchImpl) {\n      throw new IpcConnectionError(\"A fetch implementation is required.\");\n    }\n  }\n\n  static async connect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n    return tryConnect(options);\n  }\n\n  async health(options: IpcRequestOptions = {}): Promise<IpcHealthResponse> {\n    return this.get<IpcHealthResponse>(\"/ipc/health\", options);\n  }\n\n  async listNamespaces(options: IpcRequestOptions = {}): Promise<IpcNamespacesResponse> {\n    return this.get<IpcNamespacesResponse>(\"/ipc/namespaces\", options);\n  }\n\n  async getNamespace(\n    namespace: string,\n    options: IpcRequestOptions = {}\n  ): Promise<IpcNamespaceDetail> {\n    return this.get<IpcNamespaceDetail>(\n      `/ipc/namespaces/${encodeURIComponent(namespace)}`,\n      options\n    );\n  }\n\n  async waitForNamespace(\n    namespace: string,\n    options: WaitForNamespaceOptions = {}\n  ): Promise<IpcNamespaceDetail> {\n    const timeoutMs = options.timeoutMs ?? DEFAULT_NAMESPACE_WAIT_TIMEOUT_MS;\n    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_NAMESPACE_POLL_INTERVAL_MS;\n    const requiredStatus = options.status ?? \"registered\";\n    const deadline = Date.now() + timeoutMs;\n    let stateError: IpcResponseError | undefined;\n\n    while (true) {\n      try {\n        const detail = await this.getNamespace(namespace, {\n          timeoutMs: options.requestTimeoutMs\n        });\n\n        if (requiredStatus === \"registered\" || detail.status === \"ready\") {\n          return detail;\n        }\n\n        if (detail.status === \"error\") {\n          throw new IpcResponseError({\n            code: \"namespace_error\",\n            message: detail.error?.message ?? `Namespace initialization failed: ${namespace}`\n          });\n        }\n\n        if (detail.status !== \"initializing\") {\n          throw new IpcResponseError({\n            code: \"namespace_status_unavailable\",\n            message: `Namespace status is unavailable: ${namespace}`\n          });\n        }\n\n        stateError = new IpcResponseError({\n          code: \"namespace_initializing\",\n          message: `Namespace is initializing: ${namespace}`\n        });\n      } catch (error) {\n        if (\n          !(error instanceof IpcResponseError) ||\n          (error.code !== \"namespace_not_found\" && error.code !== \"namespace_initializing\")\n        ) {\n          throw error;\n        }\n\n        stateError = error;\n      }\n\n      const remainingMs = deadline - Date.now();\n      if (remainingMs <= 0) {\n        throw stateError ?? new IpcResponseError({\n          code: \"namespace_initializing\",\n          message: `Namespace is initializing: ${namespace}`\n        });\n      }\n\n      await delay(Math.min(pollIntervalMs, remainingMs));\n    }\n  }\n\n  namespace(namespace: string): AdofaiIpcNamespaceClient {\n    return new AdofaiIpcNamespaceClient(this, namespace);\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    options: IpcCallOptions<TParams>\n  ): Promise<TResult> {\n    const response = await this.post<IpcResponse<TResult>>(\n      \"/ipc\",\n      {\n        namespace: options.namespace,\n        method: options.method,\n        params: options.params ?? {},\n        id: options.id ?? createRequestId()\n      },\n      { timeoutMs: options.timeoutMs }\n    );\n\n    if (!response.ok) {\n      throw new IpcResponseError(response.error);\n    }\n\n    return response.result;\n  }\n\n  private async get<TResult>(\n    path: string,\n    options: IpcRequestOptions = {}\n  ): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"GET\"\n    }, options);\n  }\n\n  private async post<TResult>(\n    path: string,\n    body: unknown,\n    options: IpcRequestOptions = {}\n  ): Promise<TResult> {\n    return this.request<TResult>(path, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify(body)\n    }, options);\n  }\n\n  private async request<TResult>(\n    path: string,\n    init: RequestInit,\n    options: IpcRequestOptions\n  ): Promise<TResult> {\n    const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;\n    const controller = new AbortController();\n    const timeoutError = new IpcTimeoutError(timeoutMs);\n    const timeout = setTimeout(() => controller.abort(timeoutError), timeoutMs);\n\n    try {\n      const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n        ...init,\n        signal: controller.signal\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        const responseError = parseIpcResponseError(text);\n        if (responseError) throw new IpcResponseError(responseError);\n        throw new IpcHttpError(response.status, text || response.statusText);\n      }\n\n      return (await response.json()) as TResult;\n    } catch (error) {\n      if (error instanceof IpcHttpError || error instanceof IpcResponseError) throw error;\n      if (controller.signal.aborted) {\n        if (error === timeoutError) throw timeoutError;\n        throw new IpcTimeoutError(timeoutMs, { cause: error });\n      }\n      throw new IpcConnectionError(getErrorMessage(error), { cause: error });\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\nexport class AdofaiIpcNamespaceClient {\n  constructor(\n    private readonly client: AdofaiIpcClient,\n    readonly namespace: string\n  ) {\n  }\n\n  async call<TResult = unknown, TParams = unknown>(\n    method: string,\n    params?: TParams,\n    idOrOptions?: IpcRequestId | IpcRequestOptions,\n    options: IpcRequestOptions = {}\n  ): Promise<TResult> {\n    const requestOptions = isIpcRequestOptions(idOrOptions) ? idOrOptions : options;\n    const id = isIpcRequestOptions(idOrOptions) ? undefined : idOrOptions;\n\n    return this.client.call<TResult, TParams>({\n      namespace: this.namespace,\n      method,\n      params,\n      id,\n      timeoutMs: requestOptions.timeoutMs\n    });\n  }\n}\n\nexport async function tryConnect(options: TryConnectOptions = {}): Promise<AdofaiIpcClient> {\n  const host = options.host ?? DEFAULT_HOST;\n  const startPort = options.startPort ?? DEFAULT_START_PORT;\n  const endPort = options.endPort ?? DEFAULT_END_PORT;\n  const probeTimeoutMs =\n    options.probeTimeoutMs ?? options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;\n  const requestTimeoutMs =\n    options.requestTimeoutMs ?? options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n  let lastProbeError: unknown;\n\n  for (let port = startPort; port <= endPort; port++) {\n    const client = new AdofaiIpcClient({\n      baseUrl: `http://${host}:${port}`,\n      fetch: options.fetch,\n      requestTimeoutMs: probeTimeoutMs\n    });\n\n    try {\n      const health = await client.health();\n\n      if (health.ok && health.server === \"AdofaiIpc\") {\n        const mismatch = getVersionMismatch(health);\n        if (mismatch) {\n          try {\n            options.onVersionMismatch?.(mismatch);\n          } catch {\n          }\n          throw mismatch;\n        }\n        return new AdofaiIpcClient({\n          baseUrl: client.baseUrl,\n          fetch: options.fetch,\n          requestTimeoutMs\n        });\n      }\n    } catch (error) {\n      if (error instanceof IpcVersionMismatchError) throw error;\n      lastProbeError = error;\n    }\n  }\n\n  if (lastProbeError instanceof IpcTimeoutError) throw lastProbeError;\n\n  throw new IpcConnectionError(\n    `Could not connect to AdofaiIpc on ${host}:${startPort}-${endPort}.`\n  );\n}\n\nfunction getVersionMismatch(health: IpcHealthResponse): IpcVersionMismatchError | null {\n  const protocolVersion = Number.isInteger(health.protocolVersion) ? health.protocolVersion : null;\n  const serverVersion = typeof health.serverVersion === \"string\" ? health.serverVersion : null;\n  const comparison = serverVersion === null\n    ? null\n    : compareProductVersions(serverVersion, CLIENT_VERSION);\n\n  if (comparison === 0 && serverVersion === CLIENT_VERSION) return null;\n\n  return new IpcVersionMismatchError({\n    clientVersion: CLIENT_VERSION,\n    serverVersion,\n    direction: comparison === null\n      ? \"legacy_server\"\n      : comparison < 0\n        ? \"server_outdated\"\n        : \"client_outdated\",\n    protocolVersion\n  });\n}\n\nfunction normalizeBaseUrl(value: string): string {\n  return value.replace(/\\/+$/, \"\");\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n  if (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n  ) {\n    return error.message;\n  }\n\n  return undefined;\n}\n\nfunction parseIpcResponseError(text: string): IpcErrorInfo | undefined {\n  try {\n    const value = JSON.parse(text) as { error?: unknown };\n    const error = value?.error;\n\n    if (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      typeof error.code === \"string\" &&\n      \"message\" in error &&\n      typeof error.message === \"string\"\n    ) {\n      return { code: error.code, message: error.message };\n    }\n  } catch {\n  }\n\n  return undefined;\n}\n\nfunction isIpcRequestOptions(value: unknown): value is IpcRequestOptions {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction delay(timeoutMs: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, timeoutMs));\n}\n\nfunction createRequestId(): string {\n  return `adofai-ipc-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adofai-ipc/client",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "TypeScript client for the AdofaiIpc local HTTP IPC gateway.",
   "type": "module",
   "license": "MIT",
@@ -42,12 +42,14 @@
     "access": "public"
   },
   "devDependencies": {
+    "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3"
   },
   "scripts": {
     "build": "tsup",
     "check": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "pnpm run build && node --test test/*.test.mjs"
   }
 }