@bgx4k3p/huly-mcp-server 2.2.3 → 2.2.5

package/README.md

@@ -17,8 +17,18 @@ May also work with [Huly Cloud](https://app.huly.io) (not yet tested).
 
 Huly has no public API. The only programmatic access is through their JavaScript SDK,
 which connects via WebSocket. This server wraps that SDK and exposes **MCP tools**
-over both stdio and **Streamable HTTP** transports — compatible with Claude Code,
-VS Code, n8n, and any MCP client.
+over both stdio and **Streamable HTTP** transports — compatible with Codex,
+Claude Code, VS Code, n8n, and any MCP client.
+
+## Documentation Map
+
+- **Install**: add the package to a project or run it with `npx`.
+- **Quick Start**: configure Huly authentication.
+- **Integrations**: connect Codex, Claude Code, HTTP clients, or Docker.
+- **Configuration Reference**: environment variables and workspace behavior.
+- **Network Configurations**: local, remote, and Cloudflare tunnel notes.
+- **Development and Publishing**: tests, linting, and package publishing.
+- **API Reference**: available MCP tools and response conventions.
 
 ## Install
 
@@ -42,23 +52,13 @@ cd huly-mcp-server
 npm install
 ```
 
-### Publishing
-
-The Huly SDK has `workspace:` protocol references in transitive
-dependencies on the npm registry. The custom pack script bundles
-only the needed SDK packages and prunes UI bloat (32MB to 4MB):
-
-```bash
-npm run pack
-npm publish bgx4k3p-huly-mcp-server-<version>.tgz --access public
-```
-
 ---
 
 ## Quick Start
 
 ### Authentication
 
+Configure Huly access first, then choose one integration in the next section.
 You can authenticate with either **email/password** or a **token**.
 
 #### Email and Password
@@ -75,9 +75,15 @@ export HULY_WORKSPACE=your-workspace
 Get a token from your Huly credentials — no env vars needed beforehand:
 
 ```bash
-node src/index.mjs --get-token -e your@email.com -p your-password -u https://your-huly-instance.com
+npx -y @bgx4k3p/huly-mcp-server --get-token \
+  -e your@email.com \
+  -p your-password \
+  -u https://your-huly-instance.com
 ```
 
+From a source checkout, use `node src/index.mjs --get-token` with the same
+flags.
+
 Then use it:
 
 ```bash
@@ -89,19 +95,80 @@ export HULY_WORKSPACE=your-workspace
 The token does not expire. You can store it in a secrets manager
 and stop exposing your password in environment variables.
 
+For local stdio clients, the project config examples below set
+`HULY_WORKSPACE` per repo. Optionally set `HULY_PROJECT` when a repository maps
+cleanly to one Huly project. After connecting a client, call
+`get_huly_context` first to verify that the workspace, project, URL host, and
+auth mode are what you expect.
+
 ---
 
 ## Integrations
 
-### Claude Code (stdio)
+Use stdio for local coding agents and Streamable HTTP for remote clients or
+automation systems.
+
+### Codex (project-scoped stdio)
+
+Codex supports MCP servers from `config.toml`. For project-specific Huly
+workspaces, generate a repo-local Codex config layer:
+
+```bash
+npx -y @bgx4k3p/huly-mcp-server --init-codex --workspace my-workspace
+```
+
+Optionally set a default project identifier for project-scoped tools:
+
+```bash
+npx -y @bgx4k3p/huly-mcp-server --init-codex --workspace my-workspace --project PROJ
+```
+
+This creates `.codex/config.toml`:
+
+```toml
+[mcp_servers.huly]
+command = "npx"
+args = ["-y", "@bgx4k3p/huly-mcp-server"]
+env_vars = ["HULY_URL", "HULY_TOKEN"]
+startup_timeout_sec = 20
+tool_timeout_sec = 120
+
+[mcp_servers.huly.env]
+HULY_WORKSPACE = "my-workspace"
+HULY_PROJECT = "PROJ"
+```
+
+Keep secrets like `HULY_URL` and `HULY_TOKEN` in your user environment.
+Set `HULY_WORKSPACE` literally in each Codex or Claude project config so every
+repo, workspace folder, or editor project points to the intended Huly
+workspace. `HULY_PROJECT` is optional; when present, tools that naturally
+operate inside one project can omit the `project` argument. Explicit tool
+arguments still win.
 
-After cloning and running `npm install`, register the server:
+After starting a fresh Codex session in the project, run `get_huly_context`.
+It returns sanitized runtime context: default workspace, default project,
+Huly URL host, auth mode, and package version.
+
+Codex may show local stdio MCP servers as `unauthenticated` in `/mcp`.
+That label refers to MCP-level authentication, not Huly authentication.
+Use `get_huly_context` to confirm the downstream Huly auth mode is `token`
+or `email_password`.
+
+### Claude Code (project-scoped stdio)
+
+Generate `.mcp.json` for Claude Code:
+
+```bash
+npx -y @bgx4k3p/huly-mcp-server --init-claude --workspace my-workspace
+```
+
+Or add the server manually from a local source checkout:
 
 ```bash
 claude mcp add huly \
   -e HULY_URL=https://your-huly-instance.com \
   -e HULY_TOKEN=your-token \
-  -e HULY_WORKSPACE=your-workspace \
+  -e HULY_WORKSPACE=my-workspace \
   -- node /absolute/path/to/huly-mcp-server/src/index.mjs
 ```
 
@@ -114,15 +181,28 @@ Or add to your `.mcp.json` manually (token auth — recommended):
       "command": "node",
       "args": ["/path/to/huly-mcp-server/src/index.mjs"],
       "env": {
-        "HULY_URL": "https://your-huly-instance.com",
+        "HULY_URL": "${HULY_URL}",
         "HULY_TOKEN": "${HULY_TOKEN}",
-        "HULY_WORKSPACE": "${HULY_WORKSPACE}"
+        "HULY_WORKSPACE": "my-workspace"
       }
     }
   }
 }
 ```
 
+For project-specific workspaces, keep secrets in environment variables and set
+the workspace slug literally in each repo. `HULY_PROJECT` is optional; set it
+only when the repo maps cleanly to one Huly project:
+
+```json
+"env": {
+  "HULY_URL": "${HULY_URL}",
+  "HULY_TOKEN": "${HULY_TOKEN}",
+  "HULY_WORKSPACE": "my-workspace",
+  "HULY_PROJECT": "PROJ"
+}
+```
+
 Or with email/password:
 
 ```json
@@ -132,25 +212,32 @@ Or with email/password:
       "command": "node",
       "args": ["/path/to/huly-mcp-server/src/index.mjs"],
       "env": {
-        "HULY_URL": "https://your-huly-instance.com",
+        "HULY_URL": "${HULY_URL}",
         "HULY_EMAIL": "${HULY_EMAIL}",
         "HULY_PASSWORD": "${HULY_PASSWORD}",
-        "HULY_WORKSPACE": "${HULY_WORKSPACE}"
+        "HULY_WORKSPACE": "my-workspace"
       }
     }
   }
 }
 ```
 
-Then ask Claude things like:
+### Generate Both Project Configs
 
-- "List my issues in the OPS project"
-- "Create a bug report for the login page crash"
-- "Summarize the PROJ project — what's overdue?"
-- "Break down this feature into subtasks using the feature template"
+```bash
+npx -y @bgx4k3p/huly-mcp-server --init-all --workspace my-workspace
+```
 
-All tools have detailed descriptions optimized for AI agents.
-MCP Resources are also available at `huly://projects/{id}` and `huly://issues/{id}`.
+With an optional default project:
+
+```bash
+npx -y @bgx4k3p/huly-mcp-server --init-all --workspace my-workspace --project PROJ
+```
+
+`--init-claude` creates or updates `.mcp.json` while preserving other MCP
+servers. `--init-codex` creates `.codex/config.toml` for trusted Codex
+projects while preserving unrelated Codex settings. Existing Huly entries are
+not replaced unless `--force` is passed.
 
 ### Streamable HTTP (n8n, VS Code, remote clients)
 
@@ -195,9 +282,25 @@ docker run -i \
   huly-mcp-server node src/mcp.mjs
 ```
 
+### Verify the Connection
+
+In any MCP client, call `get_huly_context` first. It confirms the active
+workspace, optional project, Huly URL host, auth mode, and package version
+without exposing secrets.
+
+Then ask your MCP client things like:
+
+- "List my issues in the PROJ project"
+- "Create a bug report for the login page crash"
+- "Summarize the PROJ project — what's overdue?"
+- "Break down this feature into subtasks using the feature template"
+
+All tools have detailed descriptions optimized for AI agents.
+MCP Resources are also available at `huly://projects/{id}` and `huly://issues/{id}`.
+
 ---
 
-## Server Configuration
+## Configuration Reference
 
 ### Environment Variables
 
@@ -209,6 +312,7 @@ docker run -i \
 | `HULY_EMAIL` | No | - | Huly login email (required if no token) |
 | `HULY_PASSWORD` | No | - | Huly login password (required if no token) |
 | `HULY_WORKSPACE` | Yes* | - | Default workspace slug |
+| `HULY_PROJECT` | No | - | Optional default project identifier for project-scoped tools |
 | `HULY_TRANSPORT` | No | `ws` | SDK transport: `ws` (WebSocket) or `rest` (REST API) |
 | `HULY_POOL_TTL_MS` | No | `1800000` | Connection pool TTL in ms (30 min) |
 | **HTTP Server** | | | |
@@ -235,7 +339,7 @@ MCP_AUTH_TOKEN=your-token-here npm run start:server
 
 If `MCP_AUTH_TOKEN` is not set, auth is disabled (fine for local-only usage).
 
-MCP stdio mode (Claude Code) does not use this token — stdio is inherently local.
+MCP stdio mode does not use this token — stdio is inherently local.
 
 ### Multi-Workspace
 
@@ -250,10 +354,31 @@ If omitted, the `HULY_WORKSPACE` env var is used as the default.
 
 ---
 
+## Network Configurations
+
+- **Local:** `HULY_URL=http://localhost:8087`
+- **Remote:** `HULY_URL=https://huly.example.com`
+- **Behind nginx proxy:** Point to the proxy port
+
+### Cloudflare Access / Tunnel
+
+If Huly is behind Cloudflare Access with MFA, create a
+bypass Application for `/_*` or these individual paths:
+
+- `/_accounts`
+- `/_transactor`
+- `/_collaborator`
+- `/_rekoni`
+- `/config.json`
+
+---
+
 ## Testing
 
 Uses Node.js built-in `node:test` and `node:assert` — no test framework dependencies.
-Tests run twice: once with WebSocket transport, once with REST transport.
+The live integration suite runs twice: once with WebSocket transport and once
+with REST transport. Focused unit suites cover dispatch, MCP tool metadata, and
+project config generation.
 
 ```bash
 npm test              # Both transports (ws + rest)
@@ -261,38 +386,41 @@ npm run test:ws       # WebSocket only
 npm run test:rest     # REST only
 ```
 
-194 tests across 101 suites:
+Test coverage:
 
-| Suite | Tests | Description |
-| --- | --- | --- |
-| **Unit** | 28 | Constants, ID parsing, rate limiting, auth logic |
-| **Integration** | 55 | Full CRUD lifecycle against live Huly |
-| **Dispatch** | 45 | Schema to dispatch to client param forwarding for all tools |
-| **Account-level** | 11 | Workspaces, profile, social IDs |
-| **Mock** | 44 | Destructive ops, token auth via mocks |
-| **Streamable HTTP** | 11 | MCP protocol over HTTP: init, tools, resources, auth, rate limiting |
+| Suite | Description |
+| --- | --- |
+| **Unit** | Constants, ID parsing, rate limiting, auth logic |
+| **Integration** | Full CRUD lifecycle against live Huly |
+| **Dispatch** | Schema to dispatch to client param forwarding for all tools |
+| **MCP metadata** | Tool registration, `get_huly_context`, default project schemas |
+| **Project config** | `--init-claude`, `--init-codex`, `--init-all` helpers |
+| **Account-level** | Workspaces, profile, social IDs |
+| **Mock** | Destructive ops, token auth via mocks |
+| **Streamable HTTP** | MCP protocol over HTTP: init, tools, resources, auth, rate limiting |
 
 **100% dispatch coverage** — every tool's params are traced end-to-end
 through the dispatch table to the client method.
 
 ---
 
-## Network Configurations
+## Development and Publishing
 
-- **Local:** `HULY_URL=http://localhost:8087`
-- **Remote:** `HULY_URL=https://huly.example.com`
-- **Behind nginx proxy:** Point to the proxy port
+For local development:
 
-### Cloudflare Access / Tunnel
+```bash
+npm install
+npm run lint
+node --test test/initCodex.test.mjs test/mcpShared.test.mjs
+```
 
-If Huly is behind Cloudflare Access with MFA, create a
-bypass Application for `/_*` or these individual paths:
+The custom pack script bundles only the Huly SDK packages needed at runtime
+and prunes UI/frontend bloat from the published tarball:
 
-- `/_accounts`
-- `/_transactor`
-- `/_collaborator`
-- `/_rekoni`
-- `/config.json`
+```bash
+npm run pack
+npm publish bgx4k3p-huly-mcp-server-<version>.tgz --access public
+```
 
 ---
 
@@ -305,14 +433,15 @@ src/
   dispatch.mjs  # Tool-to-method dispatch table
   pool.mjs      # Connection pool — caches clients by workspace with TTL
   mcpShared.mjs # Shared MCP server factory — tool definitions + resources
-  mcp.mjs       # MCP stdio entry point (Claude Code)
+  mcp.mjs       # MCP stdio entry point (Codex, Claude Code)
   server.mjs    # MCP Streamable HTTP entry point (n8n, VS Code, remote)
-  index.mjs     # CLI entry point — --get-token mode + MCP re-export
+  initCodex.mjs # Project config helpers for Codex and Claude Code
+  index.mjs     # CLI entry point — --get-token, --init-* modes + MCP re-export
 ```
 
 ```text
-Claude Code  -> stdio           -> mcp.mjs    -> mcpShared.mjs -> pool -> client -> Huly SDK
-n8n / remote -> Streamable HTTP -> server.mjs -> mcpShared.mjs -> pool -> client -> Huly SDK
+Claude / Codex -> stdio           -> mcp.mjs    -> mcpShared.mjs -> pool -> client -> Huly SDK
+n8n / remote   -> Streamable HTTP -> server.mjs -> mcpShared.mjs -> pool -> client -> Huly SDK
 ```
 
 ---
@@ -360,6 +489,7 @@ Full list of all MCP tools available through this server.
 
 | Tool | Description |
 | --- | --- |
+| `get_huly_context` | Show sanitized runtime context: default workspace, default project, Huly URL host, auth mode, and package version |
 | `list_workspaces` | List all accessible workspaces |
 | `get_workspace_info` | Get workspace details by slug |
 | `create_workspace` | Create a new workspace |

package/node_modules/@hcengineering/account-client/lib/__tests__/utils.test.js

@@ -0,0 +1,249 @@
+"use strict";
+var import_utils = require("../utils");
+describe("isNetworkError", () => {
+  describe("Node.js-style connection errors", () => {
+    it("should return true for ECONNRESET error", () => {
+      const error = {
+        cause: {
+          code: "ECONNRESET"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return true for ECONNREFUSED error", () => {
+      const error = {
+        cause: {
+          code: "ECONNREFUSED"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return true for ENOTFOUND error", () => {
+      const error = {
+        cause: {
+          code: "ENOTFOUND"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return false for other error codes", () => {
+      const error = {
+        cause: {
+          code: "EACCES"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false when cause.code is not a string", () => {
+      const error = {
+        cause: {
+          code: 123
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false when cause is not an object", () => {
+      const error = {
+        cause: "not an object"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+  });
+  describe('Browser "Failed to fetch" errors', () => {
+    it('should return true for TypeError with "Failed to fetch" message', () => {
+      const error = new TypeError("Failed to fetch");
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it('should return true for TypeError with "failed to fetch" (lowercase) message', () => {
+      const error = new TypeError("failed to fetch");
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it('should return true for TypeError with "NetworkError" message', () => {
+      const error = new TypeError("NetworkError");
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it('should return true for TypeError with "networkerror" (lowercase) message', () => {
+      const error = new TypeError("networkerror");
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it('should return true for TypeError with "Network request failed" message', () => {
+      const error = new TypeError("Network request failed");
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return false for TypeError with non-network message", () => {
+      const error = new TypeError("Something went wrong");
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false for TypeError with empty message", () => {
+      const error = new TypeError("");
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should handle TypeError with undefined message", () => {
+      const error = new TypeError();
+      expect(typeof (0, import_utils.isNetworkError)(error)).toBe("boolean");
+    });
+  });
+  describe("Error name-based detection", () => {
+    it("should return true for NetworkError with network-related message", () => {
+      const error = {
+        name: "NetworkError",
+        message: "Network connection failed"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return true for TypeError (by name) with fetch-related message", () => {
+      const error = {
+        name: "TypeError",
+        message: "fetch error occurred"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return true for FetchError with connection-related message", () => {
+      const error = {
+        name: "FetchError",
+        message: "connection timeout"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return true for NetworkError with connection message", () => {
+      const error = {
+        name: "NetworkError",
+        message: "connection refused"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return false for NetworkError with non-network message", () => {
+      const error = {
+        name: "NetworkError",
+        message: "Invalid argument"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false for TypeError (by name) with non-network message", () => {
+      const error = {
+        name: "TypeError",
+        message: "Cannot read property of undefined"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false for other error names", () => {
+      const error = {
+        name: "ReferenceError",
+        message: "fetch is not defined"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should handle case-insensitive message matching", () => {
+      const error = {
+        name: "NetworkError",
+        message: "FETCH ERROR"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should return false when message is not a string", () => {
+      const error = {
+        name: "NetworkError",
+        message: 123
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false when name is not a string", () => {
+      const error = {
+        name: 123,
+        message: "fetch error"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+  });
+  describe("Edge cases", () => {
+    it("should return false for null", () => {
+      expect((0, import_utils.isNetworkError)(null)).toBe(false);
+    });
+    it("should return false for undefined", () => {
+      expect((0, import_utils.isNetworkError)(void 0)).toBe(false);
+    });
+    it("should return false for primitive values", () => {
+      expect((0, import_utils.isNetworkError)(123)).toBe(false);
+      expect((0, import_utils.isNetworkError)("string")).toBe(false);
+      expect((0, import_utils.isNetworkError)(true)).toBe(false);
+    });
+    it("should return false for empty object", () => {
+      expect((0, import_utils.isNetworkError)({})).toBe(false);
+    });
+    it("should return false for object without name or message", () => {
+      const error = {
+        someProperty: "value"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false for regular Error without network indicators", () => {
+      const error = new Error("Something went wrong");
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false for Error with cause but wrong code", () => {
+      const error = {
+        cause: {
+          code: "SOME_OTHER_CODE"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should return false when cause exists but code is missing", () => {
+      const error = {
+        cause: {}
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+  });
+  describe("Real-world error scenarios", () => {
+    it("should handle fetch API network error", () => {
+      const error = new TypeError("Failed to fetch");
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should handle Node.js connection refused error", () => {
+      const error = {
+        cause: {
+          code: "ECONNREFUSED",
+          errno: -61,
+          syscall: "connect",
+          address: "127.0.0.1",
+          port: 3e3
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should handle DNS resolution failure", () => {
+      const error = {
+        cause: {
+          code: "ENOTFOUND",
+          errno: -3008,
+          syscall: "getaddrinfo",
+          hostname: "nonexistent.example.com"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should handle connection reset error", () => {
+      const error = {
+        cause: {
+          code: "ECONNRESET",
+          errno: -54,
+          syscall: "read"
+        }
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(true);
+    });
+    it("should not treat application errors as network errors", () => {
+      const error = new Error("Invalid email format");
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+    it("should not treat authentication errors as network errors", () => {
+      const error = {
+        name: "AuthenticationError",
+        message: "Invalid credentials"
+      };
+      expect((0, import_utils.isNetworkError)(error)).toBe(false);
+    });
+  });
+});
+//# sourceMappingURL=utils.test.js.map

package/node_modules/@hcengineering/account-client/lib/__tests__/utils.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/__tests__/utils.test.ts"],
+  "sourcesContent": ["//\n// Copyright \u00A9 2026 Hardcore Engineering Inc.\n//\n// Licensed under the Eclipse Public License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License. You may\n// obtain a copy of the License at https://www.eclipse.org/legal/epl-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n//\n// See the License for the specific language governing permissions and\n// limitations under the License.\n//\n\nimport { isNetworkError } from '../utils'\n\ndescribe('isNetworkError', () => {\n  describe('Node.js-style connection errors', () => {\n    it('should return true for ECONNRESET error', () => {\n      const error = {\n        cause: {\n          code: 'ECONNRESET'\n        }\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for ECONNREFUSED error', () => {\n      const error = {\n        cause: {\n          code: 'ECONNREFUSED'\n        }\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for ENOTFOUND error', () => {\n      const error = {\n        cause: {\n          code: 'ENOTFOUND'\n        }\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return false for other error codes', () => {\n      const error = {\n        cause: {\n          code: 'EACCES'\n        }\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false when cause.code is not a string', () => {\n      const error = {\n        cause: {\n          code: 123\n        }\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false when cause is not an object', () => {\n      const error = {\n        cause: 'not an object'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n  })\n\n  describe('Browser \"Failed to fetch\" errors', () => {\n    it('should return true for TypeError with \"Failed to fetch\" message', () => {\n      const error = new TypeError('Failed to fetch')\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for TypeError with \"failed to fetch\" (lowercase) message', () => {\n      const error = new TypeError('failed to fetch')\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for TypeError with \"NetworkError\" message', () => {\n      const error = new TypeError('NetworkError')\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for TypeError with \"networkerror\" (lowercase) message', () => {\n      const error = new TypeError('networkerror')\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for TypeError with \"Network request failed\" message', () => {\n      const error = new TypeError('Network request failed')\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return false for TypeError with non-network message', () => {\n      const error = new TypeError('Something went wrong')\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false for TypeError with empty message', () => {\n      const error = new TypeError('')\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should handle TypeError with undefined message', () => {\n      const error = new TypeError()\n      // TypeError constructor may set message to empty string or undefined\n      // The function should handle this gracefully\n      expect(typeof isNetworkError(error)).toBe('boolean')\n    })\n  })\n\n  describe('Error name-based detection', () => {\n    it('should return true for NetworkError with network-related message', () => {\n      const error = {\n        name: 'NetworkError',\n        message: 'Network connection failed'\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for TypeError (by name) with fetch-related message', () => {\n      const error = {\n        name: 'TypeError',\n        message: 'fetch error occurred'\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for FetchError with connection-related message', () => {\n      const error = {\n        name: 'FetchError',\n        message: 'connection timeout'\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return true for NetworkError with connection message', () => {\n      const error = {\n        name: 'NetworkError',\n        message: 'connection refused'\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return false for NetworkError with non-network message', () => {\n      const error = {\n        name: 'NetworkError',\n        message: 'Invalid argument'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false for TypeError (by name) with non-network message', () => {\n      const error = {\n        name: 'TypeError',\n        message: 'Cannot read property of undefined'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false for other error names', () => {\n      const error = {\n        name: 'ReferenceError',\n        message: 'fetch is not defined'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should handle case-insensitive message matching', () => {\n      const error = {\n        name: 'NetworkError',\n        message: 'FETCH ERROR'\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should return false when message is not a string', () => {\n      const error = {\n        name: 'NetworkError',\n        message: 123\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false when name is not a string', () => {\n      const error = {\n        name: 123,\n        message: 'fetch error'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n  })\n\n  describe('Edge cases', () => {\n    it('should return false for null', () => {\n      expect(isNetworkError(null)).toBe(false)\n    })\n\n    it('should return false for undefined', () => {\n      expect(isNetworkError(undefined)).toBe(false)\n    })\n\n    it('should return false for primitive values', () => {\n      expect(isNetworkError(123)).toBe(false)\n      expect(isNetworkError('string')).toBe(false)\n      expect(isNetworkError(true)).toBe(false)\n    })\n\n    it('should return false for empty object', () => {\n      expect(isNetworkError({})).toBe(false)\n    })\n\n    it('should return false for object without name or message', () => {\n      const error = {\n        someProperty: 'value'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false for regular Error without network indicators', () => {\n      const error = new Error('Something went wrong')\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false for Error with cause but wrong code', () => {\n      const error = {\n        cause: {\n          code: 'SOME_OTHER_CODE'\n        }\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should return false when cause exists but code is missing', () => {\n      const error = {\n        cause: {}\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n  })\n\n  describe('Real-world error scenarios', () => {\n    it('should handle fetch API network error', () => {\n      // Simulating a real browser fetch error\n      const error = new TypeError('Failed to fetch')\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should handle Node.js connection refused error', () => {\n      // Simulating a real Node.js connection error\n      const error = {\n        cause: {\n          code: 'ECONNREFUSED',\n          errno: -61,\n          syscall: 'connect',\n          address: '127.0.0.1',\n          port: 3000\n        }\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should handle DNS resolution failure', () => {\n      const error = {\n        cause: {\n          code: 'ENOTFOUND',\n          errno: -3008,\n          syscall: 'getaddrinfo',\n          hostname: 'nonexistent.example.com'\n        }\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should handle connection reset error', () => {\n      const error = {\n        cause: {\n          code: 'ECONNRESET',\n          errno: -54,\n          syscall: 'read'\n        }\n      }\n      expect(isNetworkError(error)).toBe(true)\n    })\n\n    it('should not treat application errors as network errors', () => {\n      const error = new Error('Invalid email format')\n      expect(isNetworkError(error)).toBe(false)\n    })\n\n    it('should not treat authentication errors as network errors', () => {\n      const error = {\n        name: 'AuthenticationError',\n        message: 'Invalid credentials'\n      }\n      expect(isNetworkError(error)).toBe(false)\n    })\n  })\n})\n"],
+  "mappings": "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",
+  "names": []
+}