@adofai-ipc/client 0.1.0 → 0.2.0

package/README.md

@@ -45,7 +45,20 @@ 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 +74,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 +98,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

@@ -26,6 +26,8 @@ __export(index_exports, {
   IpcConnectionError: () => IpcConnectionError,
   IpcHttpError: () => IpcHttpError,
   IpcResponseError: () => IpcResponseError,
+  IpcTimeoutError: () => IpcTimeoutError,
+  isIpcUnavailable: () => isIpcUnavailable,
   tryConnect: () => tryConnect
 });
 module.exports = __toCommonJS(index_exports);
@@ -38,11 +40,26 @@ 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;
+  }
+};
+function isIpcUnavailable(error) {
+  return error instanceof IpcConnectionError && error.code === "UNAVAILABLE";
+}
 var IpcHttpError = class extends AdofaiIpcError {
   constructor(status, message) {
     super(message);
@@ -63,12 +80,15 @@ var IpcResponseError = class extends AdofaiIpcError {
 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 +96,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 +199,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 +221,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,16 +237,22 @@ 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;
   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;
+        return new AdofaiIpcClient({
+          baseUrl: client.baseUrl,
+          fetch: options.fetch,
+          requestTimeoutMs
+        });
       }
     } catch {
     }
@@ -175,6 +264,29 @@ async function tryConnect(options = {}) {
 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)}`;
 }
@@ -186,6 +298,8 @@ function createRequestId() {
   IpcConnectionError,
   IpcHttpError,
   IpcResponseError,
+  IpcTimeoutError,
+  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/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  isIpcUnavailable\n} from \"./errors\";\n\nexport type {\n  IpcConnectionErrorCode,\n  IpcConnectionErrorOptions\n} from \"./errors\";\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\";\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 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","import {\n  IpcConnectionError,\n  IpcHttpError,\n  IpcResponseError,\n  IpcTimeoutError\n} from \"./errors\";\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\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        return new AdofaiIpcClient({\n          baseUrl: client.baseUrl,\n          fetch: options.fetch,\n          requestTimeoutMs\n        });\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 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

@@ -4,6 +4,16 @@ interface IpcCallOptions<TParams = unknown> {
     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;
@@ -27,10 +37,16 @@ interface IpcHealthResponse {
     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 +55,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 +71,22 @@ interface TryConnectOptions {
     startPort?: number;
     endPort?: number;
     fetch?: typeof fetch;
+    probeTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    /** @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,16 +97,28 @@ 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>;
 
+type IpcConnectionErrorCode = "UNAVAILABLE" | "TIMEOUT";
+interface IpcConnectionErrorOptions {
+    code?: IpcConnectionErrorCode;
+    cause?: unknown;
+}
 declare class AdofaiIpcError extends Error {
     constructor(message: string);
 }
 declare class IpcConnectionError extends AdofaiIpcError {
-    constructor(message?: string);
+    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 function isIpcUnavailable(error: unknown): error is IpcConnectionError;
 declare class IpcHttpError extends AdofaiIpcError {
     readonly status: number;
     constructor(status: number, message: string);
@@ -93,4 +129,4 @@ declare class IpcResponseError extends AdofaiIpcError {
     constructor(error: IpcErrorInfo);
 }
 
-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, 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 TryConnectOptions, type WaitForNamespaceOptions, isIpcUnavailable, tryConnect };

package/dist/index.d.ts

@@ -4,6 +4,16 @@ interface IpcCallOptions<TParams = unknown> {
     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;
@@ -27,10 +37,16 @@ interface IpcHealthResponse {
     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 +55,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 +71,22 @@ interface TryConnectOptions {
     startPort?: number;
     endPort?: number;
     fetch?: typeof fetch;
+    probeTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    /** @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,16 +97,28 @@ 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>;
 
+type IpcConnectionErrorCode = "UNAVAILABLE" | "TIMEOUT";
+interface IpcConnectionErrorOptions {
+    code?: IpcConnectionErrorCode;
+    cause?: unknown;
+}
 declare class AdofaiIpcError extends Error {
     constructor(message: string);
 }
 declare class IpcConnectionError extends AdofaiIpcError {
-    constructor(message?: string);
+    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 function isIpcUnavailable(error: unknown): error is IpcConnectionError;
 declare class IpcHttpError extends AdofaiIpcError {
     readonly status: number;
     constructor(status: number, message: string);
@@ -93,4 +129,4 @@ declare class IpcResponseError extends AdofaiIpcError {
     constructor(error: IpcErrorInfo);
 }
 
-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, 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 TryConnectOptions, type WaitForNamespaceOptions, isIpcUnavailable, tryConnect };

package/dist/index.js

@@ -6,11 +6,26 @@ 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;
+  }
+};
+function isIpcUnavailable(error) {
+  return error instanceof IpcConnectionError && error.code === "UNAVAILABLE";
+}
 var IpcHttpError = class extends AdofaiIpcError {
   constructor(status, message) {
     super(message);
@@ -31,12 +46,15 @@ var IpcResponseError = class extends AdofaiIpcError {
 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 +62,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 +165,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 +187,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,16 +203,22 @@ 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;
   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;
+        return new AdofaiIpcClient({
+          baseUrl: client.baseUrl,
+          fetch: options.fetch,
+          requestTimeoutMs
+        });
       }
     } catch {
     }
@@ -143,6 +230,29 @@ async function tryConnect(options = {}) {
 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)}`;
 }
@@ -153,6 +263,8 @@ export {
   IpcConnectionError,
   IpcHttpError,
   IpcResponseError,
+  IpcTimeoutError,
+  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":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { IpcErrorInfo } from \"./types\";\n\nexport type IpcConnectionErrorCode = \"UNAVAILABLE\" | \"TIMEOUT\";\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 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","import {\n  IpcConnectionError,\n  IpcHttpError,\n  IpcResponseError,\n  IpcTimeoutError\n} from \"./errors\";\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\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        return new AdofaiIpcClient({\n          baseUrl: client.baseUrl,\n          fetch: options.fetch,\n          requestTimeoutMs\n        });\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 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":";AASO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,qBAAN,cAAiC,eAAe;AAAA,EAIrD,YACE,UAAU,mCACV,UAAqC,CAAC,GACtC;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ,QAAQ;AAC5B,SAAK,QAAQ,QAAQ;AAAA,EACvB;AACF;AAEO,IAAM,kBAAN,cAA8B,mBAAmB;AAAA,EAGtD,YAAY,WAAmB,UAAoD,CAAC,GAAG;AACrF,UAAM,qCAAqC,SAAS,QAAQ;AAAA,MAC1D,MAAM;AAAA,MACN,OAAO,QAAQ;AAAA,IACjB,CAAC;AACD,SAAK,OAAO;AACZ,SAAK,YAAY;AAAA,EACnB;AACF;AAEO,SAAS,iBAAiB,OAA6C;AAC5E,SAAO,iBAAiB,sBAAsB,MAAM,SAAS;AAC/D;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;;;AChDA,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAC3B,IAAM,mBAAmB;AACzB,IAAM,2BAA2B;AACjC,IAAM,6BAA6B;AACnC,IAAM,oCAAoC;AAC1C,IAAM,qCAAqC;AAEpC,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,mBACH,QAAQ,oBAAoB,QAAQ,aAAa;AAEnD,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,OAAO,UAA6B,CAAC,GAA+B;AACxE,WAAO,KAAK,IAAuB,eAAe,OAAO;AAAA,EAC3D;AAAA,EAEA,MAAM,eAAe,UAA6B,CAAC,GAAmC;AACpF,WAAO,KAAK,IAA2B,mBAAmB,OAAO;AAAA,EACnE;AAAA,EAEA,MAAM,aACJ,WACA,UAA6B,CAAC,GACD;AAC7B,WAAO,KAAK;AAAA,MACV,mBAAmB,mBAAmB,SAAS,CAAC;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,iBACJ,WACA,UAAmC,CAAC,GACP;AAC7B,UAAM,YAAY,QAAQ,aAAa;AACvC,UAAM,iBAAiB,QAAQ,kBAAkB;AACjD,UAAM,iBAAiB,QAAQ,UAAU;AACzC,UAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,QAAI;AAEJ,WAAO,MAAM;AACX,UAAI;AACF,cAAM,SAAS,MAAM,KAAK,aAAa,WAAW;AAAA,UAChD,WAAW,QAAQ;AAAA,QACrB,CAAC;AAED,YAAI,mBAAmB,gBAAgB,OAAO,WAAW,SAAS;AAChE,iBAAO;AAAA,QACT;AAEA,YAAI,OAAO,WAAW,SAAS;AAC7B,gBAAM,IAAI,iBAAiB;AAAA,YACzB,MAAM;AAAA,YACN,SAAS,OAAO,OAAO,WAAW,oCAAoC,SAAS;AAAA,UACjF,CAAC;AAAA,QACH;AAEA,YAAI,OAAO,WAAW,gBAAgB;AACpC,gBAAM,IAAI,iBAAiB;AAAA,YACzB,MAAM;AAAA,YACN,SAAS,oCAAoC,SAAS;AAAA,UACxD,CAAC;AAAA,QACH;AAEA,qBAAa,IAAI,iBAAiB;AAAA,UAChC,MAAM;AAAA,UACN,SAAS,8BAA8B,SAAS;AAAA,QAClD,CAAC;AAAA,MACH,SAAS,OAAO;AACd,YACE,EAAE,iBAAiB,qBAClB,MAAM,SAAS,yBAAyB,MAAM,SAAS,0BACxD;AACA,gBAAM;AAAA,QACR;AAEA,qBAAa;AAAA,MACf;AAEA,YAAM,cAAc,WAAW,KAAK,IAAI;AACxC,UAAI,eAAe,GAAG;AACpB,cAAM,cAAc,IAAI,iBAAiB;AAAA,UACvC,MAAM;AAAA,UACN,SAAS,8BAA8B,SAAS;AAAA,QAClD,CAAC;AAAA,MACH;AAEA,YAAM,MAAM,KAAK,IAAI,gBAAgB,WAAW,CAAC;AAAA,IACnD;AAAA,EACF;AAAA,EAEA,UAAU,WAA6C;AACrD,WAAO,IAAI,yBAAyB,MAAM,SAAS;AAAA,EACrD;AAAA,EAEA,MAAM,KACJ,SACkB;AAClB,UAAM,WAAW,MAAM,KAAK;AAAA,MAC1B;AAAA,MACA;AAAA,QACE,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,QAAQ,QAAQ,UAAU,CAAC;AAAA,QAC3B,IAAI,QAAQ,MAAM,gBAAgB;AAAA,MACpC;AAAA,MACA,EAAE,WAAW,QAAQ,UAAU;AAAA,IACjC;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,iBAAiB,SAAS,KAAK;AAAA,IAC3C;AAEA,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAc,IACZ,MACA,UAA6B,CAAC,GACZ;AAClB,WAAO,KAAK,QAAiB,MAAM;AAAA,MACjC,QAAQ;AAAA,IACV,GAAG,OAAO;AAAA,EACZ;AAAA,EAEA,MAAc,KACZ,MACA,MACA,UAA6B,CAAC,GACZ;AAClB,WAAO,KAAK,QAAiB,MAAM;AAAA,MACjC,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,IAC3B,GAAG,OAAO;AAAA,EACZ;AAAA,EAEA,MAAc,QACZ,MACA,MACA,SACkB;AAClB,UAAM,YAAY,QAAQ,aAAa,KAAK;AAC5C,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,eAAe,IAAI,gBAAgB,SAAS;AAClD,UAAM,UAAU,WAAW,MAAM,WAAW,MAAM,YAAY,GAAG,SAAS;AAE1E,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,gBAAgB,sBAAsB,IAAI;AAChD,YAAI,cAAe,OAAM,IAAI,iBAAiB,aAAa;AAC3D,cAAM,IAAI,aAAa,SAAS,QAAQ,QAAQ,SAAS,UAAU;AAAA,MACrE;AAEA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,SAAS,OAAO;AACd,UAAI,iBAAiB,gBAAgB,iBAAiB,iBAAkB,OAAM;AAC9E,UAAI,WAAW,OAAO,SAAS;AAC7B,YAAI,UAAU,aAAc,OAAM;AAClC,cAAM,IAAI,gBAAgB,WAAW,EAAE,OAAO,MAAM,CAAC;AAAA,MACvD;AACA,YAAM,IAAI,mBAAmB,gBAAgB,KAAK,GAAG,EAAE,OAAO,MAAM,CAAC;AAAA,IACvE,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,aACA,UAA6B,CAAC,GACZ;AAClB,UAAM,iBAAiB,oBAAoB,WAAW,IAAI,cAAc;AACxE,UAAM,KAAK,oBAAoB,WAAW,IAAI,SAAY;AAE1D,WAAO,KAAK,OAAO,KAAuB;AAAA,MACxC,WAAW,KAAK;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,eAAe;AAAA,IAC5B,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;AACnC,QAAM,iBACJ,QAAQ,kBAAkB,QAAQ,aAAa;AACjD,QAAM,mBACJ,QAAQ,oBAAoB,QAAQ,aAAa;AAEnD,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,kBAAkB;AAAA,IACpB,CAAC;AAED,QAAI;AACF,YAAM,SAAS,MAAM,OAAO,OAAO;AAEnC,UAAI,OAAO,MAAM,OAAO,WAAW,aAAa;AAC9C,eAAO,IAAI,gBAAgB;AAAA,UACzB,SAAS,OAAO;AAAA,UAChB,OAAO,QAAQ;AAAA,UACf;AAAA,QACF,CAAC;AAAA,MACH;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,gBAAgB,OAAoC;AAC3D,MACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAO,MAAM,YAAY,UACzB;AACA,WAAO,MAAM;AAAA,EACf;AAEA,SAAO;AACT;AAEA,SAAS,sBAAsB,MAAwC;AACrE,MAAI;AACF,UAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,UAAM,QAAQ,OAAO;AAErB,QACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,OAAO,MAAM,SAAS,YACtB,aAAa,SACb,OAAO,MAAM,YAAY,UACzB;AACA,aAAO,EAAE,MAAM,MAAM,MAAM,SAAS,MAAM,QAAQ;AAAA,IACpD;AAAA,EACF,QAAQ;AAAA,EACR;AAEA,SAAO;AACT;AAEA,SAAS,oBAAoB,OAA4C;AACvE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,MAAM,WAAkC;AAC/C,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,SAAS,CAAC;AAChE;AAEA,SAAS,kBAA0B;AACjC,SAAO,cAAc,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AACxE;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adofai-ipc/client",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript client for the AdofaiIpc local HTTP IPC gateway.",
   "type": "module",
   "license": "MIT",
@@ -35,6 +35,13 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "pnpm run build && node --test test/*.test.mjs",
+    "prepack": "pnpm run build"
+  },
   "engines": {
     "node": ">=18"
   },
@@ -44,10 +51,5 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.6.3"
-  },
-  "scripts": {
-    "build": "tsup",
-    "check": "tsc --noEmit",
-    "clean": "rm -rf dist"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 KGH1113
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.