@telora/mcp-products 0.21.1

package/dist/shared.js

@@ -0,0 +1,147 @@
+// ---------------------------------------------------------------------------
+// Shared types, credential loading, and API client used by all handler modules
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Credential loading -- env vars only
+// ---------------------------------------------------------------------------
+export function loadCredentials() {
+    // Support both new TELORA_TRACKER_ID (profile-based UUID) and legacy TELORA_ACCESS_TOKEN
+    const accessToken = process.env.TELORA_TRACKER_ID || process.env.TELORA_ACCESS_TOKEN;
+    if (!process.env.TELORA_TRACKER_ID && process.env.TELORA_ACCESS_TOKEN) {
+        console.error("[telora-products] Warning: TELORA_ACCESS_TOKEN is deprecated. Use TELORA_TRACKER_ID instead.");
+    }
+    const teloraUrl = process.env.TELORA_URL;
+    if (accessToken && teloraUrl) {
+        return { accessToken, teloraUrl };
+    }
+    throw new Error("MCP server not configured. Run: npx @telora/mcp-products init");
+}
+// ---------------------------------------------------------------------------
+// API client
+// ---------------------------------------------------------------------------
+export async function callProductApi(creds, body) {
+    const url = `${creds.teloraUrl}/functions/v1/product-api`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${creds.accessToken}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await response.json();
+    if (!response.ok || !data.success) {
+        throw new Error(data.error || `API error (${response.status})`);
+    }
+    return data;
+}
+// ---------------------------------------------------------------------------
+// Helper to build MCP tool responses
+// ---------------------------------------------------------------------------
+export function successResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof data === "string" ? data : JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+export function errorResult(err) {
+    return {
+        content: [{ type: "text", text: err.message }],
+        isError: true,
+    };
+}
+export function validationError(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+// ---------------------------------------------------------------------------
+// Compact entity helper -- minimize token usage in mutation responses
+// ---------------------------------------------------------------------------
+/**
+ * Strip an entity response to only the ID + fields the caller requested.
+ * Used by create/update handlers to minimize token usage in agent responses.
+ */
+export function compactEntity(entity, requestedFields, returnFull) {
+    if (returnFull)
+        return entity;
+    const compact = { id: entity.id };
+    for (const key of requestedFields) {
+        if (key in entity)
+            compact[key] = entity[key];
+    }
+    return compact;
+}
+/**
+ * Build a fields object from params, only including defined values.
+ * Replaces the repetitive `if (x !== undefined) fields.x = x` pattern.
+ *
+ * @param params - Object with all tool parameters
+ * @param fieldNames - Names of fields to include (defaults to all params)
+ * @param required - Names of required fields to always include
+ *
+ * @example
+ * // Before:
+ * const fields: Record<string, unknown> = {};
+ * if (name !== undefined) fields.name = name;
+ * if (description !== undefined) fields.description = description;
+ * if (status !== undefined) fields.status = status;
+ *
+ * // After:
+ * const fields = buildFields(params, ['name', 'description', 'status']);
+ */
+export function buildFields(params, fieldNames, required) {
+    const fields = {};
+    const keys = fieldNames ?? Object.keys(params);
+    for (const key of keys) {
+        if (params[key] !== undefined) {
+            fields[key] = params[key];
+        }
+    }
+    // Always include required fields even if undefined
+    if (required) {
+        for (const key of required) {
+            if (!(key in fields) && key in params) {
+                fields[key] = params[key];
+            }
+        }
+    }
+    return fields;
+}
+/**
+ * Wrap an async handler with standard try/catch error handling.
+ * Replaces the repetitive try { ... } catch (err) { return errorResult(err); } pattern.
+ *
+ * @example
+ * // Before:
+ * async (params) => {
+ *   try {
+ *     const result = await callProductApi(getCreds(), { action: "create", ... });
+ *     return successResult(result.product);
+ *   } catch (err) {
+ *     return errorResult(err);
+ *   }
+ * }
+ *
+ * // After:
+ * wrapHandler(async (params) => {
+ *   const result = await callProductApi(getCreds(), { action: "create", ... });
+ *   return successResult(result.product);
+ * })
+ */
+export function wrapHandler(handler) {
+    return async (params) => {
+        try {
+            return await handler(params);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@telora/mcp-products",
+  "version": "0.21.1",
+  "description": "MCP server exposing Telora product operations to Claude Code",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "telora-mcp-products": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js || true",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "npx tsx src/index.ts",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "echo 'No tests implemented - MCP server is manually tested via Claude Code integration'",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@10.1.1.250:3122/syntelyos/telora.git",
+    "directory": "mcp/telora-products"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.1",
+    "typescript": "^5.7.3"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// ---------------------------------------------------------------------------
+// postinstall: wire up Claude Code hooks if telora-ai binaries are on PATH
+// ---------------------------------------------------------------------------
+// Runs after `npm install -g @telora/mcp-products`. If telora-ai-hook and
+// telora-ai-human-hook are available, configures them in ~/.claude/settings.json.
+// Never fails the install -- all errors are swallowed silently.
+// ---------------------------------------------------------------------------
+
+"use strict";
+
+const { execSync } = require("child_process");
+const { readFileSync, writeFileSync, mkdirSync, existsSync } = require("fs");
+const { join } = require("path");
+const { homedir } = require("os");
+
+try {
+  // Resolve full paths to hook binaries (bare names may not work in Claude Code subprocesses)
+  const resolveHook = (name) => {
+    try {
+      return execSync(`which ${name}`, { stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+    } catch {
+      return null;
+    }
+  };
+
+  const hookPath = resolveHook("telora-ai-hook");
+  const humanHookPath = resolveHook("telora-ai-human-hook");
+
+  if (!hookPath || !humanHookPath) {
+    // telora-ai not installed -- skip silently
+    process.exit(0);
+  }
+
+  // Read or create ~/.claude/settings.json
+  const claudeDir = join(homedir(), ".claude");
+  const settingsPath = join(claudeDir, "settings.json");
+
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    } catch {
+      // Malformed JSON -- start fresh but preserve file
+      settings = {};
+    }
+  }
+
+  if (!settings.hooks || typeof settings.hooks !== "object") {
+    settings.hooks = {};
+  }
+
+  // Ensure hook arrays exist
+  if (!Array.isArray(settings.hooks.PostToolUse)) {
+    settings.hooks.PostToolUse = [];
+  }
+  if (!Array.isArray(settings.hooks.UserPromptSubmit)) {
+    settings.hooks.UserPromptSubmit = [];
+  }
+
+  // Check if a telora hook is already configured in a rules array.
+  // Each entry has { matcher, hooks: [{ type, command }] } structure.
+  // Also updates the path if the binary moved.
+  const ensureHook = (rulesArr, binaryName, fullPath) => {
+    let found = false;
+    for (const rule of rulesArr) {
+      for (const h of (rule && rule.hooks) || []) {
+        const cmd = h.command || "";
+        if (cmd.includes(binaryName)) {
+          if (cmd !== fullPath) {
+            h.command = fullPath;
+          }
+          found = true;
+        }
+      }
+    }
+    if (!found) {
+      rulesArr.push({
+        matcher: "",
+        hooks: [{ type: "command", command: fullPath }],
+      });
+    }
+  };
+
+  ensureHook(settings.hooks.PostToolUse, "telora-ai-hook", hookPath);
+  ensureHook(settings.hooks.UserPromptSubmit, "telora-ai-human-hook", humanHookPath);
+
+  // Write back
+  if (!existsSync(claudeDir)) {
+    mkdirSync(claudeDir, { recursive: true });
+  }
+  writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+} catch {
+  // Never fail the install
+  process.exit(0);
+}