{"_id":"@chykalophia/clickup-mcp-shared","_rev":"2-c8fd5e38493d9e798b123e695406ff4d","name":"@chykalophia/clickup-mcp-shared","dist-tags":{"latest":"1.1.6"},"versions":{"1.1.5":{"name":"@chykalophia/clickup-mcp-shared","version":"1.1.5","keywords":["clickup","mcp","shared","utilities","types","schemas"],"author":{"url":"https://davidwhatley.com","name":"David Whatley"},"license":"MIT","_id":"@chykalophia/clickup-mcp-shared@1.1.5","maintainers":[{"name":"chykalophia","email":"peter@chykalophia.com"}],"contributors":[{"name":"ClickUp MCP Server - Enhanced Contributors"}],"homepage":"https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced#readme","bugs":{"url":"https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/issues"},"dist":{"shasum":"70aece7c3e43e6ba48baf431f027c98d63688d6e","tarball":"https://registry.npmjs.org/@chykalophia/clickup-mcp-shared/-/clickup-mcp-shared-1.1.5.tgz","fileCount":9,"integrity":"sha512-nfuCROMLoG5OQGs/9VVT1iE8gan0E8f3rAN2bJZ8l5Gm1lfnvGJApJE/aNxQUcbxwgqZLPUDM3qbCeJz1rYvFg==","signatures":[{"sig":"MEUCIBvD8FmTlHgcgLS56HFWv4gnBO9OH6t8ev964/ZAeJAbAiEAxwGioZfPgIANS65jbGjhJEa8iG32h9oXoB8xtsL6kEQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13504},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"546e641d61a08e6339e15ca91ac598c3edc28d0d","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","clean":"rm -rf build coverage test-results .jest-cache","format":"prettier --write \"src/**/*.ts\"","prepare":"npm run build","lint:fix":"eslint src/**/*.ts --fix","test:coverage":"jest --coverage"},"_npmUser":{"name":"chykalophia","email":"peter@chykalophia.com"},"repository":{"url":"git+https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git","type":"git","directory":"packages/shared"},"_npmVersion":"10.9.0","description":"Shared utilities, types, and schemas for ClickUp MCP Server packages","directories":{},"_nodeVersion":"22.0.0","dependencies":{"zod":"^3.22.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","ts-jest":"^29.4.1","ts-node":"^10.9.2","prettier":"^3.1.1","typescript":"^5.3.3","@types/jest":"^29.5.14","@types/node":"^18.19.26","@typescript-eslint/parser":"^6.21.0","@typescript-eslint/eslint-plugin":"^6.21.0"},"_npmOperationalInternal":{"tmp":"tmp/clickup-mcp-shared_1.1.5_1756832694558_0.8064410282243908","host":"s3://npm-registry-packages-npm-production"}},"1.1.6":{"name":"@chykalophia/clickup-mcp-shared","version":"1.1.6","description":"Shared utilities, types, and schemas for ClickUp MCP Server packages","main":"build/index.js","types":"build/index.d.ts","scripts":{"build":"tsc","dev":"ts-node --esm src/index.ts","test":"jest","test:coverage":"jest --coverage","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","format":"prettier --write \"src/**/*.ts\"","clean":"rm -rf build coverage test-results .jest-cache","prepare":"npm run build"},"repository":{"type":"git","url":"git+https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git","directory":"packages/shared"},"keywords":["clickup","mcp","shared","utilities","types","schemas"],"author":{"name":"David Whatley","url":"https://davidwhatley.com"},"contributors":[{"name":"ClickUp MCP Server - Enhanced Contributors"}],"license":"MIT","bugs":{"url":"https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/issues"},"homepage":"https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced#readme","engines":{"node":">=18.0.0"},"type":"module","dependencies":{"zod":"^3.22.4"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^18.19.26","@typescript-eslint/eslint-plugin":"^6.21.0","@typescript-eslint/parser":"^6.21.0","eslint":"^8.56.0","jest":"^29.7.0","prettier":"^3.1.1","ts-jest":"^29.4.1","ts-node":"^10.9.2","typescript":"^5.3.3"},"publishConfig":{"access":"public"},"_id":"@chykalophia/clickup-mcp-shared@1.1.6","gitHead":"bdc61264930543fa2dfaa7a9187bd2c4c2d82a4a","_nodeVersion":"22.0.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-rLKKDoVaOH3haITgzUFUvn4M3BQXeyc3cKwVVOcei63J13iHMkUwWApvtW2n3ue2Jro2/ctcx1a3rClE434Y3g==","shasum":"bd06f3fbaea99251df7121afcb2025c59acf8026","tarball":"https://registry.npmjs.org/@chykalophia/clickup-mcp-shared/-/clickup-mcp-shared-1.1.6.tgz","fileCount":10,"unpackedSize":18134,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCGHLzUmSr4IYTLE3guFr0ifal68PtWtMYfBT1MitWUVgIhAPq2qfkK3t1CNUyWsI6dirlKShRyty2XAEVsCb1IyeIv"}]},"_npmUser":{"name":"chykalophia","email":"peter@chykalophia.com"},"directories":{},"maintainers":[{"name":"chykalophia","email":"peter@chykalophia.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clickup-mcp-shared_1.1.6_1756833104272_0.48097454024999564"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-02T17:04:54.446Z","modified":"2025-09-02T17:11:44.644Z","1.1.5":"2025-09-02T17:04:54.757Z","1.1.6":"2025-09-02T17:11:44.460Z"},"bugs":{"url":"https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/issues"},"author":{"name":"David Whatley","url":"https://davidwhatley.com"},"license":"MIT","homepage":"https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced#readme","keywords":["clickup","mcp","shared","utilities","types","schemas"],"repository":{"type":"git","url":"git+https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git","directory":"packages/shared"},"description":"Shared utilities, types, and schemas for ClickUp MCP Server packages","contributors":[{"name":"ClickUp MCP Server - Enhanced Contributors"}],"maintainers":[{"name":"chykalophia","email":"peter@chykalophia.com"}],"readme":"# ClickUp MCP Shared Utilities\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/Chykalophia/ClickUp-MCP-Server---Enhanced/main/assets/images/clickupserverlogo.png\" width=\"256\" alt=\"ClickUp Shared Utilities Logo\" />\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@chykalophia/clickup-mcp-shared\"><img src=\"https://img.shields.io/npm/v/@chykalophia/clickup-mcp-shared.svg\" alt=\"Version\"></a>\n  <a href=\"https://opensource.org/licenses/MIT\"><img src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\"></a>\n  <a href=\"https://nodejs.org/\"><img src=\"https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen\" alt=\"Node.js Version\"></a>\n</p>\n\nShared utilities, types, and schemas for ClickUp MCP Server packages. This package provides common functionality used across the ClickUp MCP ecosystem.\n\n## 📦 What's Included\n\n### TypeScript Types\n- **ClickUp API Types**: Complete type definitions for ClickUp API responses\n- **MCP Protocol Types**: Model Context Protocol interface definitions\n- **Shared Interfaces**: Common interfaces used across packages\n\n### Validation Schemas\n- **Zod Schemas**: Runtime validation for API requests and responses\n- **Input Validation**: Sanitization and security validation helpers\n- **Type Guards**: Runtime type checking utilities\n\n### Utility Functions\n- **API Helpers**: Common ClickUp API interaction utilities\n- **Error Handling**: Standardized error processing and formatting\n- **Security Utils**: Input sanitization and validation functions\n\n## 🚀 Installation\n\n```bash\nnpm install @chykalophia/clickup-mcp-shared\n```\n\n## 🛠️ Usage\n\n### Import Types\n```typescript\nimport { \n  ClickUpTask, \n  ClickUpList, \n  ClickUpSpace,\n  MCPToolResponse \n} from '@chykalophia/clickup-mcp-shared';\n```\n\n### Use Validation Schemas\n```typescript\nimport { TaskSchema, ListSchema } from '@chykalophia/clickup-mcp-shared';\n\n// Validate task data\nconst validatedTask = TaskSchema.parse(taskData);\n```\n\n### Utility Functions\n```typescript\nimport { \n  sanitizeInput, \n  validateApiToken,\n  formatClickUpError \n} from '@chykalophia/clickup-mcp-shared';\n\n// Sanitize user input\nconst cleanInput = sanitizeInput(userInput);\n\n// Validate API token\nconst isValid = validateApiToken(token);\n```\n\n## 📋 Key Features\n\n### Type Safety\n- **Complete ClickUp API coverage** with TypeScript types\n- **Runtime validation** with Zod schemas\n- **Type guards** for safe type checking\n\n### Security\n- **Input sanitization** to prevent XSS and injection attacks\n- **API token validation** with format checking\n- **URL validation** with protocol and domain restrictions\n\n### Consistency\n- **Standardized error handling** across all packages\n- **Common interfaces** for consistent API design\n- **Shared validation logic** to prevent duplication\n\n## 🔧 Development\n\nThis package is primarily intended for use by other ClickUp MCP packages, but can be used independently for ClickUp API integration projects.\n\n### Building\n```bash\nnpm run build\n```\n\n### Testing\n```bash\nnpm test\n```\n\n### Linting\n```bash\nnpm run lint\n```\n\n## 🤝 Related Packages\n\n- **[@chykalophia/clickup-mcp-server](https://www.npmjs.com/package/@chykalophia/clickup-mcp-server)** - Core ClickUp integration (177+ tools)\n- **[@chykalophia/clickup-intelligence-mcp-server](https://www.npmjs.com/package/@chykalophia/clickup-intelligence-mcp-server)** - AI-powered project intelligence\n\n## 📚 API Reference\n\n### Types\n- `ClickUpTask` - Complete task object with all properties\n- `ClickUpList` - List object with metadata and settings\n- `ClickUpSpace` - Space object with features and permissions\n- `ClickUpUser` - User object with profile information\n- `MCPToolResponse` - Standard MCP tool response format\n\n### Schemas\n- `TaskSchema` - Zod schema for task validation\n- `ListSchema` - Zod schema for list validation\n- `CommentSchema` - Zod schema for comment validation\n- `AttachmentSchema` - Zod schema for attachment validation\n\n### Utilities\n- `sanitizeInput(input: any): any` - Sanitize user input\n- `validateApiToken(token: string): boolean` - Validate ClickUp API token\n- `formatClickUpError(error: any): string` - Format ClickUp API errors\n- `generateRequestId(): string` - Generate unique request identifiers\n\n## 📄 License\n\nMIT - see [LICENSE](https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/blob/main/LICENSE) file for details.\n\n## 🔗 Links\n\n- [GitHub Repository](https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced)\n- [Issues & Support](https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/issues)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n","readmeFilename":"README.md"}