Ts migration review (#228)

# TypeScript Migration: 0.19.0 Release

## Overview
This PR introduces the TypeScript migration for KaibanJS, providing
enhanced type safety and developer experience. This is the first alpha
release (v0.19.0-alpha) with TypeScript support while maintaining
backward compatibility.

## Key Changes
- Complete conversion of JavaScript codebase to TypeScript
- Added comprehensive type definitions for core functionality
- **Migrated all tools to TypeScript with proper typing**
- Updated build system to handle TypeScript compilation
- Added TypeScript tests to validate type safety
- Maintained backward compatibility by preserving `.js` files as
`.deprecated.js`
- Enhanced documentation with TypeScript usage examples
- Updated Jest configuration to support TypeScript tests

## Tool Improvements
- All tools now include strong type definitions for inputs and outputs
- Type-safe tool registration and execution flow
- Enhanced error handling with typed error responses
- Better intellisense support when creating custom tools
- Type guards for runtime validation of tool responses

## Benefits for Developers
- Improved autocompletion in modern IDEs
- Better error detection during development
- Self-documenting code with type signatures
- Enhanced refactoring capabilities
- Stronger guarantees around API contracts
- Easier custom tool creation with TypeScript interfaces

## Usage
```bash
npm install kaibanjs
```

TypeScript users can now enjoy native type support without additional
configuration.

## Testing
- All existing tests have been migrated to TypeScript
- New type-specific tests have been added 
- Tool-specific type tests ensure proper input/output handling
- All functionality remains identical to the JavaScript version

## Migration for Existing Users
No breaking changes have been introduced for JavaScript users. The
existing API remains fully compatible, and JavaScript projects using
KaibanJS will continue to work without any changes.

## Next Steps
- Gather feedback from the community on type definitions
- Refine types based on real-world usage
- Prepare for stable release
- Expand TypeScript-specific documentation

## Special Thanks
Thanks to [original PR author] for their initial TypeScript migration
work, which served as the foundation for this improved implementation.
Additional contributions from the community that helped refine the types
and testing approach are greatly appreciated.

---

Please provide feedback on the type definitions and report any issues
you encounter with the alpha release!

Author: anthonydevs17

babel.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  presets: [
+    ['@babel/preset-env', { targets: { node: 'current' } }],
+    '@babel/preset-typescript',
+  ],
+};

jest.config.js

@@ -1,12 +1,19 @@
+/** @type {import('jest').Config} */
 module.exports = {
+  roots: ['<rootDir>/src', '<rootDir>/tests'],
+  testEnvironment: 'node',
   transform: {
-    '^.+\\.[t|j]sx?$': 'babel-jest',
+    '^.+\\.(js|jsx|ts|tsx)$': 'babel-jest',
   },
+  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx', 'json', 'node'],
+  coverageDirectory: './coverage',
+  collectCoverageFrom: ['src/**/*.js', 'src/**/*.ts'],
+  coveragePathIgnorePatterns: ['/node_modules/', '/tests/'],
+  testPathIgnorePatterns: ['/node_modules/'],
   moduleNameMapper: {
     '^kaibanjs$': '<rootDir>/dist/bundle.cjs',
   },
   testTimeout: 300000, // Sets global timeout to 10 seconds for all tests
-  testEnvironment: 'node', // Use Node.js environment for executing tests,
   verbose: true, // Make Jest more verbose
   silent: false, // Ensure Jest is not silent (though this is not directly related to console.log output)
   // testMatch: ['**/tests/e2e/**/eventPlanningTeam.test.js'], // Run tests only in the specific directory

package-lock.json

@@ -29,6 +29,7 @@
     "build": "npx rollup -c",
     "build:test": "NODE_ENV=development TEST_ENV=mocked-llm-apis npx rollup -c",
     "dev": "NODE_ENV=development npx rollup -c -w",
+    "tsc": "NODE_ENV=development npx rollup -c",
     "test": "npm run build:test && npm run test:integration",
     "test:watch": "TEST_ENV=mocked-llm-apis jest --testPathPattern='tests/e2e' --watch",
     "test:debug": "TEST_ENV=mocked-llm-apis node --inspect-brk node_modules/.bin/jest --runInBand --verbose --testPathPattern='tests/e2e'",
@@ -112,14 +113,17 @@
     "@babel/core": "^7.24.9",
     "@babel/plugin-syntax-import-meta": "^7.10.4",
     "@babel/preset-env": "^7.24.8",
+    "@babel/preset-typescript": "^7.27.0",
     "@eslint/js": "^9.11.0",
     "@rollup/plugin-babel": "6.0.4",
     "@rollup/plugin-commonjs": "26.0.1",
-    "@rollup/plugin-node-resolve": "15.2.3",
+    "@rollup/plugin-inject": "^5.0.5",
+    "@rollup/plugin-node-resolve": "^15.3.1",
     "@rollup/plugin-replace": "5.0.7",
     "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^11.1.6",
+    "@rollup/plugin-typescript": "^12.1.2",
     "@types/init-package-json": "^1.10.3",
+    "@types/jest": "^29.5.14",
     "@typescript-eslint/eslint-plugin": "^8.6.0",
     "@typescript-eslint/parser": "^8.6.0",
     "babel-jest": "^29.7.0",
@@ -135,7 +139,11 @@
     "prettier": "2.3.2",
     "rollup": "4.21.1",
     "rollup-plugin-dts": "6.1.1",
+    "rollup-plugin-esbuild": "^6.2.1",
+    "rollup-plugin-node-polyfills": "^0.2.1",
     "rollup-plugin-peer-deps-external": "2.2.4",
+    "terser-webpack-plugin": "^5.3.14",
+    "ts-loader": "^9.5.2",
     "tslib": "^2.7.0",
     "typescript": "^5.5.4",
     "typescript-eslint": "^8.6.0"