cc-jandi 1.0.0

package/dist/tools/team-incoming/SendTeamMessageTool.js

@@ -0,0 +1,57 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { TeamIncomingWebhookService } from "../../services/TeamIncomingWebhookService.js";
+import { resolveTeamToken } from "../../utils/resolveTeamToken.js";
+class SendTeamMessageTool extends MCPTool {
+    name = "send_team_message";
+    description = "Send a text message to specific team member(s) via Jandi Team Incoming Webhook. Messages are sent as personal messages to the specified email addresses.";
+    schema = {
+        email: {
+            type: z.string(),
+            description: "Comma-separated email addresses of recipients (max 100). e.g., 'user1@example.com,user2@example.com'",
+        },
+        message: {
+            type: z.string(),
+            description: "The message text to send",
+        },
+        teamId: {
+            type: z.string().optional(),
+            description: "Jandi team ID. Required if not using tokenAlias",
+        },
+        token: {
+            type: z.string().optional(),
+            description: "Jandi team webhook token. Required if not using tokenAlias",
+        },
+        tokenAlias: {
+            type: z.string().optional(),
+            description: "Team token alias from configuration (e.g., 'sales'). Maps to JANDI_TEAM_ID_{alias} and JANDI_TEAM_TOKEN_{alias} env vars",
+        },
+    };
+    async execute(input) {
+        try {
+            const resolved = resolveTeamToken(input);
+            if (!resolved.success) {
+                return { success: false, error: resolved.error };
+            }
+            const message = TeamIncomingWebhookService.createBasicMessage(input.message, input.email);
+            const result = await TeamIncomingWebhookService.sendMessage(resolved.config, message);
+            if (result.success) {
+                return {
+                    success: true,
+                    data: {
+                        message: "Team message sent successfully",
+                        tokenUsed: resolved.config.alias || 'direct',
+                        recipients: input.email
+                    }
+                };
+            }
+            else {
+                return { success: false, error: result.error };
+            }
+        }
+        catch (error) {
+            return { success: false, error: `Unexpected error: ${error}` };
+        }
+    }
+}
+export default SendTeamMessageTool;

package/dist/tools/team-incoming/SendTeamRichMessageTool.js

@@ -0,0 +1,83 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { TeamIncomingWebhookService } from "../../services/TeamIncomingWebhookService.js";
+import { resolveTeamToken } from "../../utils/resolveTeamToken.js";
+import { validateHexColor } from "../../utils/validateColor.js";
+import { JandiColors } from "../../types/common.js";
+class SendTeamRichMessageTool extends MCPTool {
+    name = "send_team_rich_message";
+    description = "Send a rich message with color and attachments to specific team member(s) via Jandi Team Incoming Webhook";
+    schema = {
+        email: {
+            type: z.string(),
+            description: "Comma-separated email addresses of recipients (max 100)",
+        },
+        message: {
+            type: z.string(),
+            description: "The main message text to send",
+        },
+        color: {
+            type: z.string().optional(),
+            description: "Hex color code for the message (e.g., '#FF0000'). Default is Jandi's default color",
+        },
+        connectInfo: {
+            type: z.array(z.object({
+                title: z.string().optional(),
+                description: z.string().optional(),
+                imageUrl: z.string().optional(),
+            })).optional(),
+            description: "Array of additional information sections with optional title, description, and image URL",
+        },
+        teamId: {
+            type: z.string().optional(),
+            description: "Jandi team ID. Required if not using tokenAlias",
+        },
+        token: {
+            type: z.string().optional(),
+            description: "Jandi team webhook token. Required if not using tokenAlias",
+        },
+        tokenAlias: {
+            type: z.string().optional(),
+            description: "Team token alias from configuration (e.g., 'sales')",
+        },
+    };
+    async execute(input) {
+        try {
+            const resolved = resolveTeamToken(input);
+            if (!resolved.success) {
+                return { success: false, error: resolved.error };
+            }
+            let normalizedColor = input.color;
+            if (input.color) {
+                const colorResult = validateHexColor(input.color);
+                if (!colorResult.valid) {
+                    return { success: false, error: colorResult.error };
+                }
+                normalizedColor = colorResult.normalized;
+            }
+            const message = TeamIncomingWebhookService.createRichMessage(input.message, input.email, normalizedColor, input.connectInfo);
+            const result = await TeamIncomingWebhookService.sendMessage(resolved.config, message);
+            if (result.success) {
+                return {
+                    success: true,
+                    data: {
+                        message: "Team rich message sent successfully",
+                        tokenUsed: resolved.config.alias || 'direct',
+                        recipients: input.email,
+                        messageDetails: {
+                            color: input.color || JandiColors.DEFAULT,
+                            attachments: input.connectInfo?.length || 0
+                        }
+                    }
+                };
+            }
+            else {
+                return { success: false, error: result.error };
+            }
+        }
+        catch (error) {
+            return { success: false, error: `Unexpected error: ${error}` };
+        }
+    }
+}
+export default SendTeamRichMessageTool;

package/dist/tools/team-incoming/ValidateTeamTokenTool.js

@@ -0,0 +1,56 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { TeamIncomingWebhookService } from "../../services/TeamIncomingWebhookService.js";
+import { resolveTeamToken } from "../../utils/resolveTeamToken.js";
+class ValidateTeamTokenTool extends MCPTool {
+    name = "validate_team_token";
+    description = "Validate a Jandi Team Incoming Webhook token by testing the endpoint";
+    schema = {
+        teamId: {
+            type: z.string().optional(),
+            description: "Jandi team ID. Required if not using tokenAlias",
+        },
+        token: {
+            type: z.string().optional(),
+            description: "Jandi team webhook token. Required if not using tokenAlias",
+        },
+        tokenAlias: {
+            type: z.string().optional(),
+            description: "Team token alias from configuration (e.g., 'sales'). Maps to JANDI_TEAM_ID_{alias} and JANDI_TEAM_TOKEN_{alias} env vars",
+        },
+    };
+    async execute(input) {
+        try {
+            const resolved = resolveTeamToken(input);
+            if (!resolved.success) {
+                return { success: false, error: resolved.error };
+            }
+            const result = await TeamIncomingWebhookService.validateToken(resolved.config);
+            if (result.success) {
+                return {
+                    success: true,
+                    data: {
+                        message: "Team webhook token is valid",
+                        tokenAlias: resolved.config.alias || 'direct'
+                    }
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    error: result.error,
+                    data: {
+                        tokenAlias: resolved.config.alias || 'direct'
+                    }
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Unexpected error during team token validation: ${error}`
+            };
+        }
+    }
+}
+export default ValidateTeamTokenTool;

package/dist/types/common.js

@@ -0,0 +1,19 @@
+export var JandiColors;
+(function (JandiColors) {
+    JandiColors["RED"] = "#FF0000";
+    JandiColors["GREEN"] = "#00FF00";
+    JandiColors["BLUE"] = "#0000FF";
+    JandiColors["YELLOW"] = "#FFFF00";
+    JandiColors["ORANGE"] = "#FFA500";
+    JandiColors["PURPLE"] = "#800080";
+    JandiColors["PINK"] = "#FFC0CB";
+    JandiColors["GRAY"] = "#808080";
+    JandiColors["DEFAULT"] = "#FAC11B";
+})(JandiColors || (JandiColors = {}));
+export var MessageType;
+(function (MessageType) {
+    MessageType["INFO"] = "info";
+    MessageType["SUCCESS"] = "success";
+    MessageType["WARNING"] = "warning";
+    MessageType["ERROR"] = "error";
+})(MessageType || (MessageType = {}));

package/dist/types/incoming.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.js

@@ -0,0 +1,2 @@
+// Common types
+export { JandiColors, MessageType, } from './common.js';

package/dist/types/jandi.js

@@ -0,0 +1,3 @@
+// Backward compatibility facade
+// New code should import from './index.js' or specific type files
+export { JandiColors, MessageType, } from './common.js';

package/dist/types/outgoing.js

@@ -0,0 +1 @@
+export {};

package/dist/types/team-incoming.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { resolveIncomingToken } from './resolveToken.js';
+export { resolveTeamToken } from './resolveTeamToken.js';
+export { validateHexColor } from './validateColor.js';

package/dist/utils/resolveTeamToken.js

@@ -0,0 +1,23 @@
+import { ConfigService } from '../services/configService.js';
+export function resolveTeamToken(input) {
+    if (input.teamId && input.token) {
+        return {
+            success: true,
+            config: { teamId: input.teamId, token: input.token }
+        };
+    }
+    if (input.tokenAlias) {
+        const config = ConfigService.getTeamToken(input.tokenAlias);
+        if (!config) {
+            return {
+                success: false,
+                error: `Team token alias '${input.tokenAlias}' not found. Available aliases: ${ConfigService.listTeamTokenAliases().join(', ')}`
+            };
+        }
+        return { success: true, config };
+    }
+    return {
+        success: false,
+        error: "Please provide teamId+token or a tokenAlias for team webhook. Set JANDI_TEAM_ID_{alias} and JANDI_TEAM_TOKEN_{alias} environment variables"
+    };
+}

package/dist/utils/resolveToken.js

@@ -0,0 +1,30 @@
+import { ConfigService } from '../services/configService.js';
+export function resolveIncomingToken(input) {
+    if (input.token) {
+        if (!ConfigService.validateTokenFormat(input.token)) {
+            return {
+                success: false,
+                error: "Invalid token format. Token should be a 32-character hexadecimal string"
+            };
+        }
+        return { success: true, config: { token: input.token } };
+    }
+    if (input.tokenAlias) {
+        const config = ConfigService.getToken(input.tokenAlias);
+        if (!config) {
+            return {
+                success: false,
+                error: `Token alias '${input.tokenAlias}' not found. Available aliases: ${ConfigService.listTokenAliases().join(', ')}`
+            };
+        }
+        return { success: true, config };
+    }
+    const config = ConfigService.getToken('default');
+    if (!config) {
+        return {
+            success: false,
+            error: "No default token configured. Please provide a token or tokenAlias, or set JANDI_TOKEN environment variable"
+        };
+    }
+    return { success: true, config };
+}

package/dist/utils/validateColor.js

@@ -0,0 +1,9 @@
+export function validateHexColor(color) {
+    if (!color.match(/^#[0-9A-Fa-f]{6}$/)) {
+        return {
+            valid: false,
+            error: "Invalid color format. Color should be a hex color code (e.g., '#FF0000')"
+        };
+    }
+    return { valid: true, normalized: color.toUpperCase() };
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "cc-jandi",
+  "version": "1.0.0",
+  "description": "잔디(Jandi) 팀 협업 도구용 MCP 서버 & Claude Code 플러그인 - 웹훅 메시지 전송, 알림 자동화, 스크립트 생성",
+  "type": "module",
+  "author": "kwag93",
+  "license": "MIT",
+  "homepage": "https://github.com/kwag93/cc-jandi#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kwag93/cc-jandi.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kwag93/cc-jandi/issues"
+  },
+  "keywords": [
+    "jandi",
+    "mcp",
+    "webhook",
+    "korean",
+    "collaboration",
+    "team",
+    "messaging",
+    "automation",
+    "claude",
+    "plugin",
+    "claude-code"
+  ],
+  "bin": {
+    "cc-jandi": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && mcp-build",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "release:patch": "npm run version:patch && npm publish && git push --follow-tags",
+    "release:minor": "npm run version:minor && npm publish && git push --follow-tags",
+    "release:major": "npm run version:major && npm publish && git push --follow-tags"
+  },
+  "dependencies": {
+    "axios": "^1.10.0",
+    "dotenv": "^17.1.0",
+    "mcp-framework": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  }
+}