@apexmcp/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ApexMCP
+
+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.

package/README.md

@@ -0,0 +1,80 @@
+# @apexmcp/sdk
+
+Developer-first SDK for building **MCP (Model Context Protocol)** servers in the ApexMCP ecosystem.
+
+## Goals
+
+- **Tiny**: a working MCP server in <10 LOC
+- **Elegant**: fluent builder API with good defaults
+- **Extensible**: plugins/hooks, plus escape hatches to the underlying `McpServer`
+- **Compatible**: built on the official `@modelcontextprotocol/sdk`
+
+## Quick start (STDIO)
+
+```ts
+import { apex, t } from '@apexmcp/sdk';
+
+const server = apex
+  .createServer('my-server', '0.1.0')
+  .tool({
+    name: 'hello',
+    description: 'Say hello',
+    input: t.Object({ name: t.String() }),
+    handler: ({ name }) => apex.text(`Hello ${name}`, { name }),
+  });
+
+await server.listenStdio();
+```
+
+## Quick start (HTTP-only, Deno Deploy)
+
+```ts
+import { apex, t } from '@apexmcp/sdk';
+
+const server = apex
+  .createServer('my-server', '0.1.0')
+  .tool({
+    name: 'hello',
+    description: 'Say hello',
+    input: t.Object({ name: t.String() }),
+    handler: ({ name }) => apex.text(`Hello ${name}`, { name }),
+  });
+
+export const fetch = server.fetch; // serves MCP on /mcp (and /health)
+```
+
+## Mount into an existing router (example: Hono)
+
+```ts
+import { Hono } from 'hono';
+import { apex, t } from '@apexmcp/sdk';
+
+const server = apex
+  .createServer('my-server', '0.1.0')
+  .tool({
+    name: 'hello',
+    description: 'Say hello',
+    input: t.Object({ name: t.String() }),
+    handler: ({ name }) => apex.text(`Hello ${name}`, { name }),
+  });
+
+const app = new Hono();
+const { mcp, health } = server.routes();
+
+app.all('/mcp', c => mcp(c.req.raw));
+app.get('/health', c => health(c.req.raw));
+
+export const fetch = app.fetch;
+```
+
+## API highlights
+
+- `apex.createServer(name, version, options?)`
+- `server.tool({ name, description, input, handler, ... })`
+- `server.resource({ name, uri, mimeType?, handler, ... })`
+- `server.use(plugin)`
+- `server.onShutdown(fn)`
+- `server.fetch` / `server.asFetch({ mcpPath, healthPath })`
+- `server.routes()` (router-friendly `{ mcp, health }`)
+- `server.mcp` (escape hatch to the official MCP server)
+

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Variables } from '@modelcontextprotocol/sdk/shared/uriTemplate.js';
+import { ServerCapabilities, ToolAnnotations, CallToolResult, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import { TSchema, Static } from '@sinclair/typebox';
+export { Static, TSchema, Type, Type as t } from '@sinclair/typebox';
+
+type ToolHandlerResult = CallToolResult;
+type ToolHandler<S extends TSchema = TSchema> = (args: Static<S>) => Promise<ToolHandlerResult> | ToolHandlerResult;
+type ToolDefinition<S extends TSchema = TSchema> = {
+    name: string;
+    title?: string;
+    description: string;
+    input: S;
+    output?: TSchema;
+    annotations?: ToolAnnotations;
+    handler: ToolHandler<S>;
+};
+type ResourceHandlerResult = ReadResourceResult;
+type ResourceHandler = (uri: string, variables?: Variables) => Promise<ResourceHandlerResult> | ResourceHandlerResult;
+type ResourceDefinition = {
+    name: string;
+    /**
+     * Use a concrete URI (`"apex://foo"`) or a `ResourceTemplate` from the MCP SDK.
+     * Re-exported as `ResourceTemplate` from `@apexmcp/sdk`.
+     */
+    uri: string | ResourceTemplate;
+    mimeType?: string;
+    description?: string;
+    handler: ResourceHandler;
+};
+type ApexPlugin = (server: ApexServer) => void | Promise<void>;
+type ApexServerOptions = {
+    title?: string;
+    instructions?: string;
+    capabilities?: ServerCapabilities;
+};
+type ApexServer = {
+    readonly mcp: McpServer;
+    tool<S extends TSchema>(def: ToolDefinition<S>): ApexServer;
+    resource(def: ResourceDefinition): ApexServer;
+    /**
+     * Web-standard MCP handler for HTTP-only deployments (Deno Deploy, Bun, Workers, etc).
+     *
+     * Default behavior:
+     * - `/mcp` -> MCP Streamable HTTP transport handler
+     * - `/health` -> 200 JSON health check
+     */
+    readonly fetch: (request: Request) => Promise<Response>;
+    /**
+     * Create a `fetch` handler with custom routing.
+     */
+    asFetch(options?: {
+        mcpPath?: string;
+        healthPath?: string;
+    }): (request: Request) => Promise<Response>;
+    /**
+     * Router-friendly handlers for mounting into existing frameworks (Hono/Oak/etc).
+     *
+     * These handlers assume the router has already matched the path.
+     */
+    routes(): {
+        mcp: (request: Request) => Promise<Response>;
+        health: (request: Request) => Promise<Response>;
+    };
+    /**
+     * Install an extension/plugin that can register tools/resources and hooks.
+     */
+    use(plugin: ApexPlugin): ApexServer;
+    /**
+     * Wire up STDIO transport and start serving MCP requests.
+     * Includes a SIGINT handler by default.
+     */
+    listenStdio(options?: {
+        handleSigint?: boolean;
+    }): Promise<void>;
+    /**
+     * Adds a callback that runs during shutdown.
+     */
+    onShutdown(cb: () => void | Promise<void>): ApexServer;
+    /**
+     * Lightweight dev manifest for introspection/testing.
+     */
+    manifest(): {
+        name: string;
+        version: string;
+        tools: Array<Pick<ToolDefinition, 'name' | 'title' | 'description'>>;
+        resources: Array<Pick<ResourceDefinition, 'name' | 'uri' | 'mimeType'>>;
+    };
+};
+
+declare function text(text: string, structuredContent?: Record<string, unknown>): ToolHandlerResult;
+declare function json(value: unknown): ToolHandlerResult;
+
+declare function createServer(name: string, version: string, options?: ApexServerOptions): ApexServer;
+declare const apex: {
+    createServer: typeof createServer;
+    text: typeof text;
+    json: typeof json;
+};
+
+export { type ApexPlugin, type ApexServer, type ApexServerOptions, type ResourceDefinition, type ResourceHandler, type ToolDefinition, type ToolHandler, apex, createServer };

package/dist/index.js

@@ -0,0 +1,185 @@
+// src/lib/apex.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+
+// src/lib/content.ts
+function text(text2, structuredContent) {
+  return {
+    content: [{ type: "text", text: text2 }],
+    ...structuredContent === void 0 ? {} : { structuredContent }
+  };
+}
+function json(value) {
+  const structured = typeof value === "object" && value !== null ? value : { value };
+  return text(JSON.stringify(value, null, 2), structured);
+}
+
+// src/lib/helpers.ts
+function writeStderr(line) {
+  if (typeof process !== "undefined" && process.stderr?.write) {
+    process.stderr.write(`${line}
+`);
+    return;
+  }
+}
+
+// src/lib/apex.ts
+var ApexServerImpl = class {
+  mcp;
+  info;
+  shutdownHandlers = [];
+  toolIndex = [];
+  resourceIndex = [];
+  closing = false;
+  webTransport;
+  webConnected;
+  cachedRoutes;
+  constructor(info, options = {}, mcp) {
+    this.info = info;
+    this.mcp = mcp ?? new McpServer(
+      { name: info.name, title: options.title ?? info.name, version: info.version },
+      options.instructions || options.capabilities ? { instructions: options.instructions, capabilities: options.capabilities } : void 0
+    );
+  }
+  fetch = async (request) => {
+    return await this.asFetch()(request);
+  };
+  asFetch(options = {}) {
+    const mcpPath = options.mcpPath ?? "/mcp";
+    const healthPath = options.healthPath ?? "/health";
+    return async (request) => {
+      const url = new URL(request.url);
+      if (url.pathname === healthPath) return await this.routes().health(request);
+      if (url.pathname !== mcpPath) {
+        return new Response(JSON.stringify({ error: "Not Found" }), {
+          status: 404,
+          headers: { "Content-Type": "application/json" }
+        });
+      }
+      return await this.routes().mcp(request);
+    };
+  }
+  routes() {
+    if (this.cachedRoutes) return this.cachedRoutes;
+    const health = async (_request) => {
+      return new Response(JSON.stringify({ status: "ok" }), {
+        status: 200,
+        headers: { "Content-Type": "application/json" }
+      });
+    };
+    const mcp = async (request) => {
+      if (!this.webTransport) {
+        this.webTransport = new WebStandardStreamableHTTPServerTransport();
+      }
+      if (!this.webConnected) {
+        this.webConnected = this.mcp.connect(this.webTransport);
+      }
+      await this.webConnected;
+      return await this.webTransport.handleRequest(request);
+    };
+    this.cachedRoutes = { mcp, health };
+    return this.cachedRoutes;
+  }
+  tool(def) {
+    this.toolIndex.push({
+      name: def.name,
+      title: def.title,
+      description: def.description
+    });
+    this.mcp.registerTool(
+      def.name,
+      {
+        title: def.title ?? def.name,
+        description: def.description,
+        // MCP SDK accepts Zod shapes or generic JSON schemas (AnySchema). TypeBox schemas are JSON schemas.
+        inputSchema: def.input,
+        ...def.output ? { outputSchema: def.output } : {},
+        ...def.annotations ? { annotations: def.annotations } : {}
+      },
+      (async (args) => await def.handler(args))
+    );
+    return this;
+  }
+  resource(def) {
+    this.resourceIndex.push({
+      name: def.name,
+      uri: def.uri,
+      mimeType: def.mimeType
+    });
+    const config = {
+      ...def.mimeType ? { mimeType: def.mimeType } : {},
+      ...def.description ? { description: def.description } : {}
+    };
+    if (typeof def.uri === "string") {
+      this.mcp.registerResource(def.name, def.uri, config, async (uri) => {
+        return await def.handler(uri.toString(), void 0);
+      });
+    } else {
+      this.mcp.registerResource(def.name, def.uri, config, async (uri, variables) => {
+        return await def.handler(uri.toString(), variables);
+      });
+    }
+    return this;
+  }
+  use(plugin) {
+    void Promise.resolve(plugin(this));
+    return this;
+  }
+  onShutdown(cb) {
+    this.shutdownHandlers.push(cb);
+    return this;
+  }
+  manifest() {
+    return {
+      name: this.info.name,
+      version: this.info.version,
+      tools: [...this.toolIndex],
+      resources: [...this.resourceIndex]
+    };
+  }
+  async listenStdio(options = {}) {
+    const transport = new StdioServerTransport();
+    await this.mcp.connect(transport);
+    writeStderr(`${this.info.name} MCP server running on stdio`);
+    if (options.handleSigint !== false && typeof process !== "undefined") {
+      process.on("SIGINT", () => {
+        void this.closeAndExit(0);
+      });
+    }
+  }
+  async closeAndExit(exitCode) {
+    if (this.closing) return;
+    this.closing = true;
+    try {
+      await this.mcp.close();
+    } finally {
+      for (const fn of this.shutdownHandlers) {
+        await fn();
+      }
+      if (typeof process !== "undefined" && typeof process.exit === "function") {
+        process.exit(exitCode);
+      }
+    }
+  }
+};
+function createServer(name, version, options) {
+  return new ApexServerImpl({ name, version }, options);
+}
+var apex = {
+  createServer,
+  text,
+  json
+};
+
+// src/index.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Type, Type as Type2 } from "@sinclair/typebox";
+export {
+  ResourceTemplate,
+  Type,
+  apex,
+  createServer,
+  Type2 as t
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/apex.ts","../src/lib/content.ts","../src/lib/helpers.ts","../src/index.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';\nimport type { AnySchema } from '@modelcontextprotocol/sdk/server/zod-compat.js';\nimport type { Variables } from '@modelcontextprotocol/sdk/shared/uriTemplate.js';\nimport type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { TSchema } from '@sinclair/typebox';\n\nimport { json, text } from './content.js';\nimport { writeStderr } from './helpers.js';\nimport type {\n  ApexPlugin,\n  ApexServer,\n  ApexServerOptions,\n  ResourceDefinition,\n  ToolDefinition,\n  ToolHandlerResult,\n} from './types.js';\n\ntype ServerInfo = { name: string; version: string };\n\nclass ApexServerImpl implements ApexServer {\n  public readonly mcp: McpServer;\n\n  private readonly info: ServerInfo;\n  private readonly shutdownHandlers: Array<() => void | Promise<void>> = [];\n  private readonly toolIndex: Array<Pick<ToolDefinition, 'name' | 'title' | 'description'>> = [];\n  private readonly resourceIndex: Array<Pick<ResourceDefinition, 'name' | 'uri' | 'mimeType'>> =\n    [];\n  private closing = false;\n  private webTransport?: WebStandardStreamableHTTPServerTransport;\n  private webConnected?: Promise<void>;\n  private cachedRoutes?: ReturnType<ApexServer['routes']>;\n\n  public constructor(info: ServerInfo, options: ApexServerOptions = {}, mcp?: McpServer) {\n    this.info = info;\n    this.mcp =\n      mcp ??\n      new McpServer(\n        { name: info.name, title: options.title ?? info.name, version: info.version },\n        options.instructions || options.capabilities\n          ? { instructions: options.instructions, capabilities: options.capabilities }\n          : undefined\n      );\n  }\n\n  public readonly fetch = async (request: Request): Promise<Response> => {\n    return await this.asFetch()(request);\n  };\n\n  public asFetch(\n    options: { mcpPath?: string; healthPath?: string } = {}\n  ): (request: Request) => Promise<Response> {\n    const mcpPath = options.mcpPath ?? '/mcp';\n    const healthPath = options.healthPath ?? '/health';\n\n    return async (request: Request): Promise<Response> => {\n      const url = new URL(request.url);\n\n      if (url.pathname === healthPath) return await this.routes().health(request);\n\n      if (url.pathname !== mcpPath) {\n        return new Response(JSON.stringify({ error: 'Not Found' }), {\n          status: 404,\n          headers: { 'Content-Type': 'application/json' },\n        });\n      }\n\n      return await this.routes().mcp(request);\n    };\n  }\n\n  public routes(): ReturnType<ApexServer['routes']> {\n    if (this.cachedRoutes) return this.cachedRoutes;\n\n    const health = async (_request: Request): Promise<Response> => {\n      return new Response(JSON.stringify({ status: 'ok' }), {\n        status: 200,\n        headers: { 'Content-Type': 'application/json' },\n      });\n    };\n\n    const mcp = async (request: Request): Promise<Response> => {\n      if (!this.webTransport) {\n        // Default is stateless (sessionIdGenerator undefined), perfect for HTTP-only serverless deploys.\n        this.webTransport = new WebStandardStreamableHTTPServerTransport();\n      }\n      if (!this.webConnected) {\n        this.webConnected = this.mcp.connect(this.webTransport);\n      }\n      await this.webConnected;\n      return await this.webTransport.handleRequest(request);\n    };\n\n    this.cachedRoutes = { mcp, health };\n    return this.cachedRoutes;\n  }\n\n  public tool<S extends TSchema>(def: ToolDefinition<S>): ApexServer {\n    this.toolIndex.push({\n      name: def.name,\n      title: def.title,\n      description: def.description,\n    });\n\n    this.mcp.registerTool(\n      def.name,\n      {\n        title: def.title ?? def.name,\n        description: def.description,\n        // MCP SDK accepts Zod shapes or generic JSON schemas (AnySchema). TypeBox schemas are JSON schemas.\n        inputSchema: def.input as unknown as AnySchema,\n        ...(def.output ? { outputSchema: def.output as unknown as AnySchema } : {}),\n        ...(def.annotations ? { annotations: def.annotations } : {}),\n      },\n      (async (args: unknown) => await def.handler(args as any)) as unknown as ToolCallback<AnySchema>\n    );\n\n    return this;\n  }\n\n  public resource(def: ResourceDefinition): ApexServer {\n    this.resourceIndex.push({\n      name: def.name,\n      uri: def.uri,\n      mimeType: def.mimeType,\n    });\n\n    const config = {\n      ...(def.mimeType ? { mimeType: def.mimeType } : {}),\n      ...(def.description ? { description: def.description } : {}),\n    };\n\n    if (typeof def.uri === 'string') {\n      this.mcp.registerResource(def.name, def.uri, config, async (uri: URL) => {\n        return await def.handler(uri.toString(), undefined);\n      });\n    } else {\n      this.mcp.registerResource(def.name, def.uri, config, async (uri: URL, variables: Variables) => {\n        return await def.handler(uri.toString(), variables);\n      });\n    }\n\n    return this;\n  }\n\n  public use(plugin: ApexPlugin): ApexServer {\n    // Support async plugins without forcing `.use()` to be async.\n    void Promise.resolve(plugin(this));\n    return this;\n  }\n\n  public onShutdown(cb: () => void | Promise<void>): ApexServer {\n    this.shutdownHandlers.push(cb);\n    return this;\n  }\n\n  public manifest(): ReturnType<ApexServer['manifest']> {\n    return {\n      name: this.info.name,\n      version: this.info.version,\n      tools: [...this.toolIndex],\n      resources: [...this.resourceIndex],\n    };\n  }\n\n  public async listenStdio(options: { handleSigint?: boolean } = {}): Promise<void> {\n    const transport = new StdioServerTransport();\n    await this.mcp.connect(transport);\n\n    writeStderr(`${this.info.name} MCP server running on stdio`);\n\n    if (options.handleSigint !== false && typeof process !== 'undefined') {\n      process.on('SIGINT', () => {\n        void this.closeAndExit(0);\n      });\n    }\n  }\n\n  private async closeAndExit(exitCode: number): Promise<void> {\n    if (this.closing) return;\n    this.closing = true;\n\n    try {\n      await this.mcp.close();\n    } finally {\n      for (const fn of this.shutdownHandlers) {\n        await fn();\n      }\n      if (typeof process !== 'undefined' && typeof process.exit === 'function') {\n        process.exit(exitCode);\n      }\n    }\n  }\n}\n\nexport function createServer(\n  name: string,\n  version: string,\n  options?: ApexServerOptions\n): ApexServer {\n  return new ApexServerImpl({ name, version }, options);\n}\n\nexport const apex = {\n  createServer,\n  text,\n  json,\n};\n\n\n","import type { ToolHandlerResult } from './types.js';\n\nexport function text(\n  text: string,\n  structuredContent?: Record<string, unknown>\n): ToolHandlerResult {\n  return {\n    content: [{ type: 'text', text }],\n    ...(structuredContent === undefined ? {} : { structuredContent }),\n  };\n}\n\nexport function json(value: unknown): ToolHandlerResult {\n  const structured =\n    typeof value === 'object' && value !== null\n      ? (value as Record<string, unknown>)\n      : { value };\n  return text(JSON.stringify(value, null, 2), structured);\n}\n\n\n","export function writeStderr(line: string): void {\n  // Node/Bun\n  if (typeof process !== 'undefined' && process.stderr?.write) {\n    process.stderr.write(`${line}\\n`);\n    return;\n  }\n}\n\n\n","export { apex, createServer } from './lib/apex.js';\nexport type {\n  ApexServer,\n  ApexServerOptions,\n  ApexPlugin,\n  ToolDefinition,\n  ToolHandler,\n  ResourceDefinition,\n  ResourceHandler,\n} from './lib/types.js';\n\nexport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\n\nexport { Type, Type as t } from '@sinclair/typebox';\nexport type { Static, TSchema } from '@sinclair/typebox';\n\n\n"],"mappings":"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","names":["text","Type"]}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@apexmcp/sdk",
+  "version": "1.0.0",
+  "description": "Developer-first SDK for building MCP (Model Context Protocol) servers in the ApexMCP ecosystem.",
+  "author": "@keyrxng",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "test:ci": "jest --coverage --ci --reporters=default --reporters=jest-junit",
+    "format": "run-s format:lint format:prettier format:cspell",
+    "format:lint": "eslint --fix .",
+    "format:prettier": "prettier --write .",
+    "format:cspell": "cspell **/*",
+    "typecheck": "tsc --noEmit",
+    "knip": "knip",
+    "clean": "rm -rf dist coverage .swc",
+    "prepublishOnly": "bun run clean && bun run build && bun run test",
+    "prepare": "husky install || true"
+  },
+  "keywords": [
+    "apexmcp",
+    "mcp",
+    "model-context-protocol",
+    "sdk",
+    "typescript",
+    "server",
+    "tools",
+    "resources"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.0",
+    "@sinclair/typebox": "^0.34.41"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.2.0",
+    "@jest/globals": "^30.2.0",
+    "@mswjs/data": "^0.16.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@swc/core": "^1.15.4",
+    "@swc/jest": "^0.2.39",
+    "@types/bun": "^1.3.4",
+    "@types/deno": "^2.5.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.2",
+    "cspell": "^9.4.0",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-sonarjs": "^3.0.5",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "jest-junit": "^16.0.0",
+    "knip": "^5.73.4",
+    "lint-staged": "^16.2.7",
+    "msw": "^2.12.4",
+    "npm-run-all": "^4.1.5",
+    "prettier": "^3.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "src/**.{ts,json}": [
+      "cspell"
+    ]
+  },
+  "private": false
+}