ccman 0.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Claude Code Manager 类型定义
+ */
+export interface ClaudeEnv {
+    /** 环境名称 */
+    name: string;
+    /** API 基础 URL */
+    baseUrl: string;
+    /** API 密钥 */
+    apiKey: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 最后使用时间 */
+    lastUsed?: string;
+}
+export interface Config {
+    /** 当前使用的环境名称 */
+    current: string | null;
+    /** 环境配置列表 */
+    environments: {
+        [name: string]: ClaudeEnv;
+    };
+    /** 全局设置 */
+    settings: GlobalSettings;
+}
+export interface GlobalSettings {
+    /** 是否自动写入 shell 配置文件 */
+    autoWriteShell: boolean;
+    /** 首选的 shell 类型 */
+    preferredShell: 'bash' | 'zsh' | 'auto';
+    /** shell 配置文件路径（可自定义） */
+    shellConfigPath?: string;
+}
+export interface ShellEnvVars {
+    ANTHROPIC_BASE_URL: string;
+    ANTHROPIC_AUTH_TOKEN: string;
+}
+export interface AddEnvOptions {
+    name: string;
+    baseUrl: string;
+    apiKey: string;
+    autoWriteShell?: boolean;
+}
+export interface ShellWriteResult {
+    success: boolean;
+    filePath: string;
+    message: string;
+    error?: string;
+}
+export interface EnvironmentListItem extends ClaudeEnv {
+    /** 是否为当前使用的环境 */
+    isCurrent: boolean;
+}
+export type ShellType = 'bash' | 'zsh' | 'fish' | 'unknown';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,gBAAgB;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa;IACb,YAAY,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC5C,WAAW;IACX,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB;IACnB,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACxC,yBAAyB;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,iBAAiB;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Claude Code Manager 类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/version.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 版本信息接口
+ */
+export interface VersionInfo {
+    version: string;
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+}
+/**
+ * 版本工具类
+ */
+export declare class VersionManager {
+    private static instance;
+    private cachedVersion?;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): VersionManager;
+    /**
+     * 获取当前版本信息
+     */
+    getCurrentVersion(): VersionInfo;
+    /**
+     * 获取版本字符串
+     */
+    getVersionString(): string;
+    /**
+     * 解析版本字符串
+     */
+    private parseVersion;
+    /**
+     * 获取 package.json 路径
+     */
+    private getPackageJsonPath;
+    /**
+     * 预测下一个版本
+     */
+    getNextVersion(type: 'patch' | 'minor' | 'major'): string;
+    /**
+     * 获取版本变更建议（基于 git 历史分析）
+     */
+    getVersionSuggestion(): Promise<'patch' | 'minor' | 'major'>;
+    /**
+     * 清除缓存（测试用）
+     */
+    clearCache(): void;
+}
+/**
+ * 便捷函数：获取当前版本字符串
+ */
+export declare function getCurrentVersion(): string;
+/**
+ * 便捷函数：获取版本信息
+ */
+export declare function getVersionInfo(): VersionInfo;
+/**
+ * 便捷函数：获取下一个版本
+ */
+export declare function getNextVersion(type: 'patch' | 'minor' | 'major'): string;
+/**
+ * 便捷函数：获取版本建议
+ */
+export declare function getVersionSuggestion(): Promise<'patch' | 'minor' | 'major'>;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,aAAa,CAAC,CAAc;IAEpC,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;OAEG;IACH,iBAAiB,IAAI,WAAW;IAmBhC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM;IAezD;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IA0BlE;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAEjF"}

package/dist/utils/version.js

@@ -0,0 +1,199 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionManager = void 0;
+exports.getCurrentVersion = getCurrentVersion;
+exports.getVersionInfo = getVersionInfo;
+exports.getNextVersion = getNextVersion;
+exports.getVersionSuggestion = getVersionSuggestion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * 版本工具类
+ */
+class VersionManager {
+    constructor() { }
+    /**
+     * 获取单例实例
+     */
+    static getInstance() {
+        if (!VersionManager.instance) {
+            VersionManager.instance = new VersionManager();
+        }
+        return VersionManager.instance;
+    }
+    /**
+     * 获取当前版本信息
+     */
+    getCurrentVersion() {
+        if (this.cachedVersion) {
+            return this.cachedVersion;
+        }
+        try {
+            const packageJsonPath = this.getPackageJsonPath();
+            const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf8'));
+            const version = packageJson.version;
+            this.cachedVersion = this.parseVersion(version);
+            return this.cachedVersion;
+        }
+        catch (error) {
+            console.warn('⚠️  无法读取版本信息，使用默认版本');
+            this.cachedVersion = this.parseVersion('0.0.1');
+            return this.cachedVersion;
+        }
+    }
+    /**
+     * 获取版本字符串
+     */
+    getVersionString() {
+        return this.getCurrentVersion().version;
+    }
+    /**
+     * 解析版本字符串
+     */
+    parseVersion(versionString) {
+        const match = versionString.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
+        if (!match) {
+            throw new Error(`无效的版本格式: ${versionString}`);
+        }
+        const [, major, minor, patch, prerelease] = match;
+        return {
+            version: versionString,
+            major: parseInt(major, 10),
+            minor: parseInt(minor, 10),
+            patch: parseInt(patch, 10),
+            prerelease
+        };
+    }
+    /**
+     * 获取 package.json 路径
+     */
+    getPackageJsonPath() {
+        // 在构建后的环境中，package.json 在 ../package.json
+        // 在开发环境中，可能在不同的位置
+        const paths = [
+            (0, path_1.join)(__dirname, '../package.json'), // 构建后
+            (0, path_1.join)(__dirname, '../../package.json'), // 开发环境
+            (0, path_1.join)(process.cwd(), 'package.json') // 当前工作目录
+        ];
+        for (const path of paths) {
+            try {
+                (0, fs_1.readFileSync)(path, 'utf8');
+                return path;
+            }
+            catch {
+                continue;
+            }
+        }
+        throw new Error('找不到 package.json 文件');
+    }
+    /**
+     * 预测下一个版本
+     */
+    getNextVersion(type) {
+        const current = this.getCurrentVersion();
+        switch (type) {
+            case 'patch':
+                return `${current.major}.${current.minor}.${current.patch + 1}`;
+            case 'minor':
+                return `${current.major}.${current.minor + 1}.0`;
+            case 'major':
+                return `${current.major + 1}.0.0`;
+            default:
+                throw new Error(`不支持的版本类型: ${type}`);
+        }
+    }
+    /**
+     * 获取版本变更建议（基于 git 历史分析）
+     */
+    async getVersionSuggestion() {
+        try {
+            // 这里可以添加 git 历史分析逻辑
+            // 比如分析提交信息中的关键词来推荐版本类型
+            const { exec } = await Promise.resolve().then(() => __importStar(require('child_process')));
+            const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
+            const execAsync = promisify(exec);
+            // 获取最近的提交信息
+            const { stdout } = await execAsync('git log --oneline -10');
+            const commits = stdout.toLowerCase();
+            // 简单的启发式规则
+            if (commits.includes('breaking') || commits.includes('major')) {
+                return 'major';
+            }
+            else if (commits.includes('feat') || commits.includes('feature') || commits.includes('add')) {
+                return 'minor';
+            }
+            else {
+                return 'patch';
+            }
+        }
+        catch {
+            // 默认推荐 patch
+            return 'patch';
+        }
+    }
+    /**
+     * 清除缓存（测试用）
+     */
+    clearCache() {
+        this.cachedVersion = undefined;
+    }
+}
+exports.VersionManager = VersionManager;
+/**
+ * 便捷函数：获取当前版本字符串
+ */
+function getCurrentVersion() {
+    return VersionManager.getInstance().getVersionString();
+}
+/**
+ * 便捷函数：获取版本信息
+ */
+function getVersionInfo() {
+    return VersionManager.getInstance().getCurrentVersion();
+}
+/**
+ * 便捷函数：获取下一个版本
+ */
+function getNextVersion(type) {
+    return VersionManager.getInstance().getNextVersion(type);
+}
+/**
+ * 便捷函数：获取版本建议
+ */
+async function getVersionSuggestion() {
+    return VersionManager.getInstance().getVersionSuggestion();
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"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"}

package/docs/npm-publish-guide.md

@@ -0,0 +1,71 @@
+# NPM 发布配置指南
+
+## 🔐 步骤一：获取 NPM Token
+
+```bash
+# 1. 登录 NPM
+npm login
+
+# 2. 创建发布权限的 token
+npm token create --read-only=false
+```
+
+复制生成的 token（格式：`npm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）
+
+## 🔧 步骤二：设置 GitHub Secrets
+
+1. 访问：`https://github.com/2ue/ccm/settings/secrets/actions`
+2. 点击 **"New repository secret"**
+3. 设置：
+   - **Name**: `NPM_TOKEN`
+   - **Secret**: 粘贴你的 NPM token
+4. 点击 **"Add secret"**
+
+### 验证设置
+设置完成后，应看到：
+```
+Repository secrets:
+• NPM_TOKEN  ••••••••••••••••••••••••••••••••••••••••
+```
+
+### 关于 GITHUB_TOKEN
+**无需手动设置** - GitHub Actions 自动提供此 token
+
+## 🚀 步骤三：发布
+
+### 自动发布（推荐）
+```bash
+# 交互式选择版本
+pnpm run release:interactive
+
+# 或指定版本类型
+pnpm run release:patch
+pnpm run release:minor
+pnpm run release:major
+```
+
+### 本地发布（备用）
+```bash
+pnpm run publish:local
+```
+
+## 🔍 故障排查
+
+### 401 Unauthorized
+- 检查 NPM token 是否正确设置
+- 重新生成 token: `npm token create --read-only=false`
+
+### 403 Forbidden  
+- 包名已存在：修改 package.json 中的 name
+- 检查发布权限：`npm owner ls ccman`
+
+### 测试发布权限
+```bash
+npm publish --dry-run
+```
+
+## 🛡️ 安全提醒
+
+- NPM token 只存储在 GitHub Secrets 中
+- 定期轮换 token（建议 90 天）
+- Token 泄露时立即删除并重新创建

package/docs/release-guide.md

@@ -0,0 +1,86 @@
+# 发布指南
+
+## 📋 发布前准备
+
+1. **设置 NPM Token**：参见 [setup-github-secrets.md](./setup-github-secrets.md)
+2. **确保工作目录干净**：`git status`
+3. **确保在主分支**：`git checkout main`
+
+## 🚀 发布方式
+
+### 方式一：交互式发布（推荐）
+```bash
+# 交互选择版本类型
+pnpm run release:interactive
+```
+
+### 方式二：快速发布
+```bash
+# 指定版本类型
+pnpm run release:patch   # 0.0.1 → 0.0.2
+pnpm run release:minor   # 0.0.1 → 0.1.0  
+pnpm run release:major   # 0.0.1 → 1.0.0
+```
+
+### 方式三：完整发布流程
+```bash
+# 包含分支管理的完整流程
+pnpm run release
+```
+
+### 方式四：本地发布（备用）
+```bash
+# 直接发布到 NPM（跳过 GitHub Actions）
+pnpm run publish:local
+```
+
+## 📊 发布后验证
+
+### 1. 检查 GitHub Actions
+访问：https://github.com/2ue/ccm/actions
+- 等待构建完成（约 2-3 分钟）
+- 确认状态为 ✅ 成功
+
+### 2. 验证结果
+- **NPM 包**：https://www.npmjs.com/package/ccman
+- **GitHub Release**：https://github.com/2ue/ccm/releases
+- **测试安装**：`npm install -g ccman`
+
+## 🔧 故障排查
+
+### GitHub Actions 失败
+1. 检查 `NPM_TOKEN` 设置是否正确
+2. 查看 Actions 日志获取详细错误信息
+3. 确认包名未被占用
+
+### 版本冲突
+```bash
+# 检查已存在的版本
+npm view ccman versions --json
+
+# 使用新版本号重新发布
+pnpm run release:patch
+```
+
+### 手动创建标签（高级）
+```bash
+# 如果脚本失败，可手动操作
+pnpm version patch --no-git-tag-version
+git add . && git commit -m "chore: 发布版本 v0.0.2"
+git tag -a v0.0.2 -m "Release v0.0.2"
+git push origin main && git push origin v0.0.2
+```
+
+## ✅ 发布检查清单
+
+### 发布前
+- [ ] NPM token 已设置
+- [ ] 工作目录干净
+- [ ] 在主分支
+- [ ] 构建和测试通过
+
+### 发布后  
+- [ ] GitHub Actions 成功
+- [ ] NPM 包可安装
+- [ ] GitHub Release 创建
+- [ ] 版本号正确

package/docs/version-management.md

@@ -0,0 +1,64 @@
+# 版本管理
+
+## 🎯 版本工具
+
+项目使用独立的版本工具模块 `src/utils/version.ts`：
+
+```typescript
+import { getCurrentVersion } from './utils/version';
+
+// CLI 自动获取版本
+program.version(getCurrentVersion());
+```
+
+## 📦 发布脚本功能
+
+### 智能版本推荐
+脚本会分析最近的 git 提交，自动推荐合适的版本类型：
+- `feat`, `feature` → minor 版本
+- `breaking`, `major` → major 版本  
+- 其他 → patch 版本
+
+### 交互式界面
+```bash
+📦 版本升级选项:
+
+✨ [推荐] 1) 🔧 patch (修订版本)    0.0.1 → 0.0.2
+          2) ✨ minor (次版本)     0.0.1 → 0.1.0  
+          3) 🚀 major (主版本)     0.0.1 → 1.0.0
+
+请选择版本类型 (1-3, 回车默认选择推荐项):
+```
+
+## 🚀 使用方式
+
+### 快速发布
+```bash
+pnpm run release:patch      # 直接发布 patch 版本
+pnpm run release:minor      # 直接发布 minor 版本
+pnpm run release:major      # 直接发布 major 版本
+```
+
+### 交互式发布
+```bash
+pnpm run release:interactive  # 交互选择版本类型
+pnpm run release             # 完整发布流程
+```
+
+### 本地发布
+```bash
+pnpm run publish:local      # 绕过 GitHub Actions
+```
+
+## 🎯 版本管理最佳实践
+
+### 语义化版本
+- **patch (0.0.x)**: Bug 修复、小改进
+- **minor (0.x.0)**: 新功能、向后兼容
+- **major (x.0.0)**: 破坏性更改、重大重构
+
+### 工具特性
+- ✅ 版本号统一管理（package.json）
+- ✅ 智能推荐基于 git 提交分析
+- ✅ 交互式界面友好
+- ✅ 支持多种发布模式

package/jest.config.js

@@ -0,0 +1,22 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: [
+    '**/__tests__/**/*.ts',
+    '**/?(*.)+(spec|test).ts'
+  ],
+  transform: {
+    '^.+\\.ts$': 'ts-jest'
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts',  // 简单的导出文件
+    '!src/cli.ts'     // CLI入口文件，主要是命令定义
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  testTimeout: 10000
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "ccman",
+  "version": "0.0.1",
+  "description": "Claude Code Manager - A TypeScript tool to manage Claude Code API configurations",
+  "main": "dist/index.js",
+  "packageManager": "pnpm@8.15.1",
+  "bin": {
+    "ccman": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "jest --passWithNoTests",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rm -rf dist",
+    "release": "./scripts/release.sh",
+    "release:patch": "./scripts/quick-release.sh patch",
+    "release:minor": "./scripts/quick-release.sh minor",
+    "release:major": "./scripts/quick-release.sh major",
+    "release:interactive": "./scripts/quick-release.sh",
+    "publish:local": "./scripts/publish-local.sh",
+    "prepublishOnly": "pnpm run clean && pnpm run build && pnpm run lint"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "api",
+    "config",
+    "manager",
+    "cli",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/inquirer": "^9.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "prettier": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}