multify-mcp 0.1.2

package/dist/index.js

@@ -0,0 +1,238 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+export const DEFAULT_MULTIFY_MCP_URL = "https://api.multifyco.com/mcp";
+export const mcpScopeValues = [
+    "contacts.read",
+    "contacts.create",
+    "contacts.update",
+    "contacts.bulk_create",
+    "contacts.bulk_update",
+    "lists.read",
+    "lists.create",
+    "lists.update",
+    "lists.bulk_create",
+    "lists.bulk_update",
+    "lists.membership.write",
+];
+export const mcpScopeSchema = z.enum(mcpScopeValues);
+export const claudeCodeScopeValues = ["local", "user", "project"];
+export const claudeCodeScopeSchema = z.enum(claudeCodeScopeValues);
+export const remoteMcpConnectionSchema = z.object({
+    name: z.string().min(1),
+    transport: z.literal("http"),
+    url: z.string().url(),
+    headers: z.record(z.string(), z.string()),
+});
+export const apiKeyIntrospectionSchema = z.object({
+    key_id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    actor_user_id: z.string().min(1),
+    scopes: z.array(mcpScopeSchema).default([]),
+    rate_limit_per_minute: z.number().int().min(1).max(10_000).default(120),
+    active: z.boolean().default(true),
+});
+export const contactCreateInputSchema = z.object({
+    list_id: z.string().min(1),
+    full_name: z.string().min(1).max(255),
+    email: z.string().min(1).max(320),
+    phone: z.string().optional().nullable(),
+    whatsapp_number: z.string().optional().nullable(),
+    job_title: z.string().optional().nullable(),
+    company_name: z.string().optional().nullable(),
+    company_domain: z.string().optional().nullable(),
+    linkedin_url: z.string().optional().nullable(),
+    country: z.string().optional().nullable(),
+    source: z.string().optional().nullable(),
+    tags: z.array(z.string()).default([]),
+});
+export const contactUpdateInputSchema = z.object({
+    list_id: z.string().min(1).optional().nullable(),
+    full_name: z.string().min(1).max(255).optional().nullable(),
+    email: z.string().min(1).max(320).optional().nullable(),
+    phone: z.string().optional().nullable(),
+    whatsapp_number: z.string().optional().nullable(),
+    job_title: z.string().optional().nullable(),
+    company_name: z.string().optional().nullable(),
+    company_domain: z.string().optional().nullable(),
+    linkedin_url: z.string().optional().nullable(),
+    country: z.string().optional().nullable(),
+    source: z.string().optional().nullable(),
+    tags: z.array(z.string()).optional().nullable(),
+});
+export const contactSchema = z.object({
+    id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    list_id: z.string().min(1),
+    full_name: z.string().optional().nullable(),
+    email: z.string().optional().nullable(),
+    phone: z.string().optional().nullable(),
+    whatsapp_number: z.string().optional().nullable(),
+    job_title: z.string().optional().nullable(),
+    company_name: z.string().optional().nullable(),
+    company_domain: z.string().optional().nullable(),
+    linkedin_url: z.string().optional().nullable(),
+    country: z.string().optional().nullable(),
+    source: z.string().optional().nullable(),
+    tags: z.array(z.string()).default([]),
+});
+export const contactBulkCreateInputSchema = z.object({
+    idempotency_key: z.string().min(1).max(255),
+    items: z.array(contactCreateInputSchema).min(1).max(500),
+});
+export const contactBulkUpdateItemSchema = z.object({
+    contact_id: z.string().min(1),
+    patch: contactUpdateInputSchema,
+});
+export const contactBulkUpdateInputSchema = z.object({
+    idempotency_key: z.string().min(1).max(255),
+    items: z.array(contactBulkUpdateItemSchema).min(1).max(500),
+});
+export const listCreateInputSchema = z.object({
+    name: z.string().min(1).max(255),
+    description: z.string().optional().nullable(),
+});
+export const listUpdateInputSchema = z.object({
+    name: z.string().min(1).max(255).optional().nullable(),
+    description: z.string().optional().nullable(),
+});
+export const workspaceListSchema = z.object({
+    id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    name: z.string().min(1),
+    description: z.string().optional().nullable(),
+});
+export const listBulkCreateInputSchema = z.object({
+    idempotency_key: z.string().min(1).max(255),
+    items: z.array(listCreateInputSchema).min(1).max(500),
+});
+export const listBulkUpdateItemSchema = z.object({
+    list_id: z.string().min(1),
+    patch: listUpdateInputSchema,
+});
+export const listBulkUpdateInputSchema = z.object({
+    idempotency_key: z.string().min(1).max(255),
+    items: z.array(listBulkUpdateItemSchema).min(1).max(500),
+});
+export const listAddContactsInputSchema = z.object({
+    list_id: z.string().min(1),
+    contact_ids: z.array(z.string().min(1)).min(1).max(500),
+    idempotency_key: z.string().min(1).max(255).optional().nullable(),
+});
+export const listRemoveContactsInputSchema = z.object({
+    list_id: z.string().min(1),
+    contact_ids: z.array(z.string().min(1)).min(1).max(500),
+    idempotency_key: z.string().min(1).max(255).optional().nullable(),
+});
+export const listReplaceContactsInputSchema = z.object({
+    list_id: z.string().min(1),
+    contact_ids: z.array(z.string().min(1)).max(500).default([]),
+    idempotency_key: z.string().min(1).max(255).optional().nullable(),
+});
+export const listBulkMembershipItemSchema = z.object({
+    list_id: z.string().min(1),
+    contact_ids: z.array(z.string().min(1)).min(1).max(500),
+});
+export const listBulkAddContactsInputSchema = z.object({
+    idempotency_key: z.string().min(1).max(255),
+    items: z.array(listBulkMembershipItemSchema).min(1).max(500),
+});
+export const resourcePayloadSchema = z.union([contactSchema, workspaceListSchema]);
+export const resourceOperationResultSchema = z.object({
+    operation_id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    resource: resourcePayloadSchema,
+});
+export const collectionOperationResultSchema = z.object({
+    operation_id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    items: z.array(resourcePayloadSchema).default([]),
+    total: z.number().int().min(0),
+});
+export const bulkItemErrorSchema = z.object({
+    code: z.string().min(1),
+    message: z.string().min(1),
+});
+export const bulkItemResultSchema = z.object({
+    index: z.number().int().min(0),
+    status: z.enum(["success", "error"]),
+    item_id: z.string().optional().nullable(),
+    resource: resourcePayloadSchema.optional().nullable(),
+    error: bulkItemErrorSchema.optional().nullable(),
+});
+export const bulkOperationResultSchema = z.object({
+    operation_id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    total_count: z.number().int().min(0),
+    succeeded_count: z.number().int().min(0),
+    failed_count: z.number().int().min(0),
+    results: z.array(bulkItemResultSchema).default([]),
+});
+export const membershipOperationResultSchema = z.object({
+    operation_id: z.string().min(1),
+    workspace_id: z.string().min(1),
+    affected_count: z.number().int().min(0),
+    list_ids: z.array(z.string().min(1)).default([]),
+});
+export function getMultifyMcpUrl(override) {
+    const normalized = override?.trim();
+    return normalized && normalized.length > 0 ? normalized : DEFAULT_MULTIFY_MCP_URL;
+}
+export function buildAuthorizationHeaders(apiKey) {
+    const normalized = apiKey.trim();
+    if (!normalized) {
+        throw new Error("apiKey must be a non-empty string");
+    }
+    return {
+        Authorization: `Bearer ${normalized}`,
+    };
+}
+export function ensureIdempotencyKey(value) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : randomUUID();
+}
+export function buildRemoteMcpConnection(apiKey, options) {
+    const name = options?.serverName?.trim() || "multify-mcp";
+    const url = getMultifyMcpUrl(options?.url);
+    const headers = buildAuthorizationHeaders(apiKey);
+    return remoteMcpConnectionSchema.parse({
+        name,
+        transport: "http",
+        url,
+        headers,
+    });
+}
+export function buildClaudeCodeAddArgs(apiKey, options) {
+    const scope = options?.scope ? claudeCodeScopeSchema.parse(options.scope) : null;
+    const connection = buildRemoteMcpConnection(apiKey, options);
+    const args = ["mcp", "add", "--transport", "http"];
+    if (scope) {
+        args.push("--scope", scope);
+    }
+    args.push(connection.name, connection.url, "--header", `Authorization: ${connection.headers.Authorization}`);
+    return args;
+}
+function quoteShellArg(value) {
+    if (/^[A-Za-z0-9_./:@=-]+$/.test(value)) {
+        return value;
+    }
+    return `'${value.replace(/'/g, `'\"'\"'`)}'`;
+}
+export function buildClaudeCodeAddCommand(apiKey, options) {
+    return ["claude", ...buildClaudeCodeAddArgs(apiKey, options)].map(quoteShellArg).join(" ");
+}
+export function normalizeScopes(scopes) {
+    const unique = [...new Set(Array.from(scopes, (scope) => scope.trim()).filter(Boolean))];
+    return unique.map((scope) => mcpScopeSchema.parse(scope));
+}
+export function normalizeContactBulkCreateInput(input) {
+    return contactBulkCreateInputSchema.parse({
+        ...input,
+        idempotency_key: ensureIdempotencyKey(input.idempotency_key),
+    });
+}
+export function normalizeListBulkAddContactsInput(input) {
+    return listBulkAddContactsInputSchema.parse({
+        ...input,
+        idempotency_key: ensureIdempotencyKey(input.idempotency_key),
+    });
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "multify-mcp",
+  "version": "0.1.2",
+  "description": "JavaScript helpers and schemas for the hosted Multify MCP.",
+  "packageManager": "pnpm@11.0.8",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "multify-mcp": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "test": "pnpm run check",
+    "release:verify": "npm run build && npm run check && UV_CACHE_DIR=/tmp/uv-cache uv run --group dev ruff check . && UV_CACHE_DIR=/tmp/uv-cache uv run --group dev pytest tests/py -q && node ./scripts/release/verify-npm-packages.mjs && bash ./scripts/release/verify-python-packages.sh",
+    "release:pack:npm": "node ./scripts/release/verify-npm-packages.mjs",
+    "release:pack:py": "bash ./scripts/release/verify-python-packages.sh",
+    "release:publish:npm": "bash ./scripts/release/publish-npm.sh",
+    "release:publish:py": "bash ./scripts/release/publish-pypi.sh"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  }
+}