first commit

Author: omermorad

.eslintignore

@@ -0,0 +1,5 @@
+dist
+node_modules
+coverage
+*.json
+jest.config.js 

.eslintrc.json

@@ -0,0 +1,42 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "prettier"
+  ],
+  "plugins": ["@typescript-eslint", "prettier"],
+  "env": {
+    "node": true,
+    "jest": true,
+    "es6": true
+  },
+  "rules": {
+    "prettier/prettier": "error",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/explicit-module-boundary-types": "off",
+    "no-console": ["warn", { "allow": ["warn", "error", "info"] }]
+  },
+  "overrides": [
+    {
+      "files": ["**/test/**/*.ts", "**/*.test.ts"],
+      "rules": {
+        "@typescript-eslint/no-explicit-any": "off"
+      }
+    },
+    {
+      "files": ["**/openapi/**/*.ts"],
+      "rules": {
+        "@typescript-eslint/no-explicit-any": "off"
+      }
+    },
+    {
+      "files": ["**/core/logger.ts"],
+      "rules": {
+        "no-console": "off"
+      }
+    }
+  ],
+  "ignorePatterns": ["dist/", "node_modules/", "coverage/"]
+} 

.gitignore

@@ -0,0 +1,4 @@
+.idea
+dist
+node_modules
+docs

.prettierignore

@@ -0,0 +1,9 @@
+dist
+node_modules
+coverage
+*.json
+*.yml
+*.yaml
+README.md
+LICENSE
+.gitignore 

.prettierrc

@@ -0,0 +1,10 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "semi": true,
+  "quoteProps": "consistent",
+  "jsxSingleQuote": true,
+  "arrowParens": "avoid"
+} 

README.md

@@ -0,0 +1,130 @@
+# Tadata Node SDK
+
+A Node.js SDK for deploying MCP (Multi-Channel Proxy) servers with your OpenAPI specifications.
+
+## Installation
+
+```bash
+npm install @tadata/node-sdk
+# or
+yarn add @tadata/node-sdk
+# or
+pnpm add @tadata/node-sdk
+```
+
+## Quickstart
+
+Deploy an MCP server with your OpenAPI specification:
+
+```typescript
+import { TadataNodeSDK, OpenApiSource } from '@tadata/node-sdk';
+
+// Initialize the SDK
+const tadata = new TadataNodeSDK({
+  apiKey: process.env.TADATA_KEY!,
+  dev: process.env.NODE_ENV !== 'production',
+  version: '10-10-2024',  // Optional: specify API version
+  logger: pino(),         // Optional: use custom logger
+});
+
+// Create an OpenAPI source from various formats
+const source = await OpenApiSource.fromFile('./acme-openapi.yaml');
+
+// Deploy the MCP server
+const deployment = await tadata.mcp.deploy({
+  spec: source,
+  specBaseUrl: 'https://acme.com/api',
+  name: 'Acme API',  // Optional
+});
+
+console.log(`Deployed MCP server: ${deployment.url}`);
+```
+
+## OpenAPI Source Formats
+
+The SDK supports multiple ways to provide your OpenAPI specification:
+
+```typescript
+// From a file (YAML or JSON)
+const source = await OpenApiSource.fromFile('./openapi.yaml');
+
+// From a JSON string
+const source = OpenApiSource.fromJson(jsonString);
+
+// From a YAML string
+const source = OpenApiSource.fromYaml(yamlString);
+
+// From a JavaScript object
+const source = OpenApiSource.fromObject({
+  openapi: '3.0.0',
+  info: { title: 'Example API', version: '1.0.0' },
+  paths: { /* ... */ }
+});
+
+// From an Express application
+const source = OpenApiSource.fromExpress(app);
+
+// From a Fastify instance
+const source = OpenApiSource.fromFastify(fastifyApp);
+```
+
+## Error Handling
+
+The SDK provides specific error classes for better error handling:
+
+```typescript
+import { SpecInvalidError, AuthError, ApiError, NetworkError } from '@tadata/node-sdk';
+
+try {
+  await tadata.mcp.deploy({ /* ... */ });
+} catch (error) {
+  if (error instanceof SpecInvalidError) {
+    console.error('Invalid OpenAPI spec:', error.message, error.details);
+  } else if (error instanceof AuthError) {
+    console.error('Authentication failed:', error.message);
+  } else if (error instanceof ApiError) {
+    console.error('API error:', error.message, error.statusCode);
+  } else if (error instanceof NetworkError) {
+    console.error('Network error:', error.message);
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+## Custom Logging
+
+You can provide your own logger implementation:
+
+```typescript
+import pino from 'pino';
+import { TadataNodeSDK, Logger } from '@tadata/node-sdk';
+
+// Use pino
+const pinoLogger = pino();
+
+const tadata = new TadataNodeSDK({
+  apiKey: 'your-api-key',
+  logger: pinoLogger,
+});
+
+// Or create a custom logger
+class CustomLogger implements Logger {
+  debug(msg: string, ...meta: unknown[]): void {
+    // Your implementation
+  }
+  info(msg: string, ...meta: unknown[]): void {
+    // Your implementation
+  }
+  warn(msg: string, ...meta: unknown[]): void {
+    // Your implementation
+  }
+  error(msg: string, ...meta: unknown[]): void {
+    // Your implementation
+  }
+}
+```
+
+## License
+
+MIT 

jest.config.js

@@ -0,0 +1,19 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src', '<rootDir>/test'],
+  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts', '!src/dev.ts'],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov'],
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        tsconfig: 'tsconfig.json'
+      }
+    ]
+  },
+  moduleFileExtensions: ['ts', 'js', 'json', 'node']
+}; 

package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@tadata/node-sdk",
+  "version": "0.1.0",
+  "description": "A fluent SDK for working with Tadata's API",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "dev": "ts-node src/dev.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "tadata",
+    "api",
+    "sdk",
+    "openapi",
+    "mcp"
+  ],
+  "author": "Tadata Inc.",
+  "license": "MIT",
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.0",
+    "@ts-rest/core": "^3.30.5",
+    "axios": "^1.6.2",
+    "swagger-jsdoc": "^6.2.8",
+    "yaml": "^2.3.4",
+    "zod": "^3.22.4"
+  },
+  "peerDependencies": {
+    "express": "^4.18.2",
+    "fastify": "^4.24.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/node": "^20.10.0",
+    "@types/swagger-jsdoc": "^6.0.4",
+    "@typescript-eslint/eslint-plugin": "^5.62.0",
+    "@typescript-eslint/parser": "^5.62.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.0.0",
+    "express": "^4.18.2",
+    "fastify": "^4.24.3",
+    "jest": "^29.7.0",
+    "nock": "^13.3.0",
+    "prettier": "^3.1.0",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.2.2"
+  }
+}