@hayodev/crystallize-mcp 0.1.1

package/build/src/tools/catalogue.js

@@ -0,0 +1,329 @@
+/**
+ * Catalogue tools — browse, get items, search, and product variants.
+ */
+import { z } from 'zod';
+export function catalogueTools(client) {
+    return [
+        {
+            name: 'browse_catalogue',
+            description: 'Browse the catalogue tree by path. Returns child items (folders, products, documents) with names, paths, and types. Start with "/" to see the root.',
+            schema: {
+                path: z
+                    .string()
+                    .default('/')
+                    .describe('Catalogue path to browse, e.g. "/" or "/shop/plants"'),
+                language: z.string().default('en').describe('Language code'),
+                depth: z
+                    .number()
+                    .default(1)
+                    .describe('How many levels deep to fetch children (1-3)'),
+            },
+            handler: async (params) => {
+                const { path, language, depth } = params;
+                const clampedDepth = Math.min(Math.max(depth, 1), 3);
+                const childrenFragment = buildChildrenFragment(clampedDepth);
+                const query = `
+          query BrowseCatalogue($path: String!, $language: String!) {
+            catalogue(path: $path, language: $language) {
+              id
+              name
+              type
+              path
+              ${childrenFragment}
+            }
+          }
+        `;
+                const data = await client.api.catalogueApi(query, { path, language });
+                const catalogue = data
+                    .catalogue;
+                if (!catalogue) {
+                    return {
+                        content: [
+                            { type: 'text', text: `No item found at path "${path}"` },
+                        ],
+                        isError: true,
+                    };
+                }
+                const lines = formatCatalogueNode(catalogue, client, 0, language);
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                };
+            },
+        },
+        {
+            name: 'get_item',
+            description: 'Get a catalogue item by path with its full component data. Returns name, type, shape, components, and a deep link to the Crystallize UI.',
+            schema: {
+                path: z.string().describe('Item path, e.g. "/shop/plants/monstera"'),
+                language: z.string().default('en').describe('Language code'),
+            },
+            handler: async (params) => {
+                const { path, language } = params;
+                const query = `
+          query GetItem($path: String!, $language: String!) {
+            catalogue(path: $path, language: $language) {
+              id
+              name
+              type
+              path
+              shape {
+                identifier
+                name
+              }
+              components {
+                id
+                name
+                type
+                content {
+                  ... on SingleLineContent { text }
+                  ... on RichTextContent { plainText }
+                  ... on BooleanContent { value }
+                  ... on NumericContent { number unit }
+                  ... on SelectionContent { options { key value } }
+                  ... on ImageContent {
+                    images { url altText width height }
+                  }
+                  ... on ComponentChoiceContent {
+                    selectedComponent { id name type }
+                  }
+                }
+              }
+            }
+          }
+        `;
+                const data = await client.api.catalogueApi(query, { path, language });
+                const item = data.catalogue;
+                if (!item) {
+                    return {
+                        content: [
+                            { type: 'text', text: `No item found at path "${path}"` },
+                        ],
+                        isError: true,
+                    };
+                }
+                const lines = [
+                    `${item.name}`,
+                    `  Type: ${item.type}`,
+                    `  Path: ${item.path}`,
+                    `  Shape: ${item.shape?.name ?? 'unknown'} (${item.shape?.identifier ?? '?'})`,
+                    `  Link: ${client.itemLink(item.id, item.type, language)}`,
+                    `  Shape link: ${item.shape ? client.shapeLink(item.shape.identifier, language) : 'n/a'}`,
+                ];
+                if (item.components?.length) {
+                    lines.push('', 'Components:');
+                    for (const comp of item.components) {
+                        lines.push(`  ${comp.id} (${comp.type}): ${formatComponentContent(comp.content)}`);
+                    }
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                };
+            },
+        },
+        {
+            name: 'search_catalogue',
+            description: 'Search across the catalogue for products, documents, and folders. Supports filtering by type (PRODUCT, DOCUMENT, FOLDER). Returns names, paths, types, and deep links.',
+            schema: {
+                term: z.string().describe('Search term'),
+                type: z
+                    .enum(['PRODUCT', 'DOCUMENT', 'FOLDER'])
+                    .optional()
+                    .describe('Filter by item type'),
+                language: z.string().default('no').describe('Language code'),
+                limit: z.number().default(20).describe('Max results to return'),
+            },
+            handler: async (params) => {
+                const { term, type, language, limit } = params;
+                const typeFilter = type ? `, type: ${type}` : '';
+                const query = `
+          query Search($term: String!, $language: String!) {
+            search(
+              language: $language
+              filter: { searchTerm: $term${typeFilter} }
+            ) {
+              edges {
+                node {
+                  id
+                  name
+                  path
+                  type
+                }
+              }
+            }
+          }
+        `;
+                const response = await fetch(`https://api.crystallize.com/${client.config.tenantIdentifier}/search`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ query, variables: { term, language } }),
+                });
+                const json = (await response.json());
+                const edges = (json.data?.search?.edges ?? []).slice(0, limit);
+                if (edges.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `No results for "${term}"${type ? ` (type: ${type})` : ''}`,
+                            },
+                        ],
+                    };
+                }
+                const lines = edges.map((edge, i) => {
+                    const node = edge.node;
+                    const parts = [
+                        `${i + 1}. ${node.name} [${node.type}]`,
+                        `   Path: ${node.path}`,
+                        `   Link: ${client.itemLink(node.id, node.type, language)}`,
+                    ];
+                    return parts.join('\n');
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Search results for "${term}" (${edges.length} hits):\n\n${lines.join('\n\n')}`,
+                        },
+                    ],
+                };
+            },
+        },
+        {
+            name: 'get_product_variants',
+            description: 'Get all variants for a product by path. Returns SKUs, names, pricing, stock, and attributes.',
+            schema: {
+                path: z.string().describe('Product path, e.g. "/shop/plants/monstera"'),
+                language: z.string().default('en').describe('Language code'),
+            },
+            handler: async (params) => {
+                const { path, language } = params;
+                const query = `
+          query GetVariants($path: String!, $language: String!) {
+            catalogue(path: $path, language: $language) {
+              id
+              name
+              ... on Product {
+                variants {
+                  sku
+                  name
+                  isDefault
+                  price
+                  stock
+                  attributes {
+                    attribute
+                    value
+                  }
+                  images {
+                    url
+                    altText
+                  }
+                }
+              }
+            }
+          }
+        `;
+                const data = await client.api.catalogueApi(query, { path, language });
+                const product = data.catalogue;
+                if (!product) {
+                    return {
+                        content: [
+                            { type: 'text', text: `No product found at path "${path}"` },
+                        ],
+                        isError: true,
+                    };
+                }
+                const variants = product.variants ?? [];
+                if (variants.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Product "${product.name}" has no variants.`,
+                            },
+                        ],
+                    };
+                }
+                const lines = [
+                    `${product.name} — ${variants.length} variant(s)`,
+                    `Link: ${client.itemLink(product.id, 'product', language)}`,
+                    '',
+                ];
+                for (const v of variants) {
+                    lines.push(`${v.isDefault ? '* ' : '  '}${v.name ?? v.sku}`);
+                    lines.push(`    SKU: ${v.sku}`);
+                    if (v.price != null) {
+                        lines.push(`    Price: ${v.price}`);
+                    }
+                    if (v.stock != null) {
+                        lines.push(`    Stock: ${v.stock}`);
+                    }
+                    if (v.attributes?.length) {
+                        for (const attr of v.attributes) {
+                            lines.push(`    ${attr.attribute}: ${attr.value}`);
+                        }
+                    }
+                    lines.push('');
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                };
+            },
+        },
+    ];
+}
+// --- Helpers ---
+function buildChildrenFragment(depth) {
+    if (depth <= 0) {
+        return '';
+    }
+    const inner = depth > 1 ? buildChildrenFragment(depth - 1) : '';
+    return `children { id name type path ${inner} }`;
+}
+function formatCatalogueNode(node, client, indent, language = 'en') {
+    const prefix = '  '.repeat(indent);
+    const lines = [
+        `${prefix}${node.name} [${node.type}]`,
+        `${prefix}  Path: ${node.path}`,
+        `${prefix}  Link: ${client.itemLink(node.id, node.type, language)}`,
+    ];
+    if (node.children?.length) {
+        for (const child of node.children) {
+            lines.push(...formatCatalogueNode(child, client, indent + 1, language));
+        }
+    }
+    return lines;
+}
+function formatComponentContent(content) {
+    if (!content) {
+        return '(empty)';
+    }
+    if ('text' in content) {
+        return String(content.text);
+    }
+    if ('plainText' in content) {
+        return truncate(String(content.plainText), 200);
+    }
+    if ('value' in content) {
+        return String(content.value);
+    }
+    if ('number' in content) {
+        const unit = content.unit ? ` ${content.unit}` : '';
+        return `${content.number}${unit}`;
+    }
+    if ('images' in content) {
+        const images = content.images;
+        return `${images.length} image(s)`;
+    }
+    if ('options' in content) {
+        const options = content.options;
+        return options.map(o => o.value).join(', ');
+    }
+    return JSON.stringify(content);
+}
+function truncate(text, max) {
+    if (text.length <= max) {
+        return text;
+    }
+    return text.slice(0, max) + '...';
+}
+//# sourceMappingURL=catalogue.js.map

package/build/src/tools/catalogue.js.map

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

package/build/src/tools/customers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Customer tools — search and inspect customers.
+ */
+import type { CrystallizeClient } from '../client.js';
+import type { ToolDefinition } from '../types.js';
+export declare function customerTools(client: CrystallizeClient): ToolDefinition[];
+//# sourceMappingURL=customers.d.ts.map

package/build/src/tools/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../../src/tools/customers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CA+SzE"}

package/build/src/tools/customers.js

@@ -0,0 +1,278 @@
+/**
+ * Customer tools — search and inspect customers.
+ */
+import { z } from 'zod';
+import { maskEmail, maskPhone } from '../pii.js';
+export function customerTools(client) {
+    return [
+        {
+            name: 'list_customers',
+            description: 'Search and list customers in the tenant. Supports filtering by name or email. Returned fields depend on CRYSTALLIZE_PII_MODE: full (default) returns name, identifier, email, company, and phone; masked returns name, identifier, company, and masked email/phone; none returns identifiers only.',
+            schema: {
+                searchTerm: z
+                    .string()
+                    .optional()
+                    .describe('Filter customers by name or email (partial match)'),
+                first: z.number().default(20).describe('Max customers to return'),
+                after: z
+                    .string()
+                    .optional()
+                    .describe('Pagination cursor from a previous response'),
+            },
+            handler: async (params) => {
+                const { searchTerm, first, after } = params;
+                const filterArg = searchTerm
+                    ? `, filter: { searchTerm: "${searchTerm}" }`
+                    : '';
+                const afterArg = after ? `, after: "${after}"` : '';
+                const query = `
+          query ListCustomers($tenantId: ID!, $first: Int) {
+            customer {
+              getMany(
+                tenantId: $tenantId
+                first: $first${afterArg}${filterArg}
+              ) {
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                  totalNodes
+                }
+                edges {
+                  node {
+                    identifier
+                    firstName
+                    lastName
+                    email
+                    companyName
+                    phone
+                  }
+                }
+              }
+            }
+          }
+        `;
+                const data = await client.api.pimApi(query, {
+                    tenantId: client.config.tenantId,
+                    first,
+                });
+                const result = data.customer?.getMany;
+                if (!result) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `No customers found${searchTerm ? ` matching "${searchTerm}"` : ''}.`,
+                            },
+                        ],
+                    };
+                }
+                const customers = result.edges.map(e => e.node);
+                if (customers.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `No customers found${searchTerm ? ` matching "${searchTerm}"` : ''}.`,
+                            },
+                        ],
+                    };
+                }
+                const total = result.pageInfo.totalNodes ?? customers.length;
+                const lines = [
+                    `Customers (${customers.length} of ${total}):`,
+                    '',
+                ];
+                const pii = client.config.piiMode;
+                for (const c of customers) {
+                    const maskedId = pii !== 'full' && c.identifier.includes('@')
+                        ? maskEmail(c.identifier)
+                        : c.identifier;
+                    if (pii === 'none') {
+                        lines.push(`${maskedId}`);
+                    }
+                    else {
+                        const name = [c.firstName, c.lastName].filter(Boolean).join(' ');
+                        lines.push(`${name || maskedId} (${maskedId})`);
+                        if (c.email) {
+                            lines.push(`  Email: ${pii === 'masked' ? maskEmail(c.email) : c.email}`);
+                        }
+                        if (c.companyName) {
+                            lines.push(`  Company: ${c.companyName}`);
+                        }
+                        if (c.phone) {
+                            lines.push(`  Phone: ${pii === 'masked' ? maskPhone(c.phone) : c.phone}`);
+                        }
+                    }
+                    lines.push('');
+                }
+                if (result.pageInfo.hasNextPage && result.pageInfo.endCursor) {
+                    lines.push(`Next page cursor: ${result.pageInfo.endCursor}`);
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                };
+            },
+        },
+        {
+            name: 'get_customer',
+            description: 'Get full profile for a customer by their identifier (UUID from list_customers). Returns name, email, addresses, meta, and external references.',
+            schema: {
+                identifier: z
+                    .string()
+                    .describe('Customer identifier UUID — use list_customers to find it'),
+            },
+            handler: async (params) => {
+                const { identifier } = params;
+                const query = `
+          query GetCustomer($identifier: String!, $tenantId: ID!) {
+            customer {
+              get(identifier: $identifier, tenantId: $tenantId) {
+                identifier
+                firstName
+                lastName
+                email
+                companyName
+                phone
+                taxNumber
+                birthDate
+                meta {
+                  key
+                  value
+                }
+                externalReferences {
+                  key
+                  value
+                }
+                addresses {
+                  type
+                  firstName
+                  lastName
+                  street
+                  street2
+                  streetNumber
+                  city
+                  state
+                  postalCode
+                  country
+                  email
+                  phone
+                }
+              }
+            }
+          }
+        `;
+                const data = await client.api.pimApi(query, {
+                    identifier,
+                    tenantId: client.config.tenantId,
+                });
+                const customer = data.customer?.get;
+                if (!customer) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Customer "${identifier}" not found. Use list_customers to search.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const pii = client.config.piiMode;
+                const maskedId = pii !== 'full' && customer.identifier.includes('@')
+                    ? maskEmail(customer.identifier)
+                    : customer.identifier;
+                const lines = [`  Identifier: ${maskedId}`];
+                if (pii !== 'none') {
+                    const name = [customer.firstName, customer.lastName]
+                        .filter(Boolean)
+                        .join(' ');
+                    if (name) {
+                        lines.unshift(name);
+                    }
+                    else {
+                        lines.unshift(maskedId);
+                    }
+                    if (customer.email) {
+                        lines.push(`  Email: ${pii === 'masked' ? maskEmail(customer.email) : customer.email}`);
+                    }
+                    if (customer.phone) {
+                        lines.push(`  Phone: ${pii === 'masked' ? maskPhone(customer.phone) : customer.phone}`);
+                    }
+                    if (customer.companyName) {
+                        lines.push(`  Company: ${customer.companyName}`);
+                    }
+                    if (customer.taxNumber) {
+                        lines.push(`  Tax number: ${customer.taxNumber}`);
+                    }
+                    if (customer.birthDate) {
+                        lines.push(`  Birth date: ${customer.birthDate}`);
+                    }
+                }
+                else {
+                    lines.unshift(maskedId);
+                }
+                if (pii !== 'none' && customer.addresses?.length) {
+                    lines.push('');
+                    lines.push(`Addresses (${customer.addresses.length}):`);
+                    for (const addr of customer.addresses) {
+                        if (pii === 'masked') {
+                            // City + country only
+                            const addrStr = [addr.city, addr.country]
+                                .filter(Boolean)
+                                .join(', ');
+                            lines.push(`  [${addr.type}] ${addrStr || '(masked)'}`);
+                        }
+                        else {
+                            const addrName = [addr.firstName, addr.lastName]
+                                .filter(Boolean)
+                                .join(' ');
+                            const addrStr = [
+                                addr.streetNumber,
+                                addr.street,
+                                addr.street2,
+                                addr.city,
+                                addr.state,
+                                addr.postalCode,
+                                addr.country,
+                            ]
+                                .filter(Boolean)
+                                .join(', ');
+                            lines.push(`  [${addr.type}] ${addrName}`);
+                            if (addrStr) {
+                                lines.push(`    ${addrStr}`);
+                            }
+                            if (addr.email) {
+                                lines.push(`    Email: ${addr.email}`);
+                            }
+                            if (addr.phone) {
+                                lines.push(`    Phone: ${addr.phone}`);
+                            }
+                        }
+                    }
+                }
+                if (pii !== 'none') {
+                    if (customer.externalReferences?.length) {
+                        lines.push('');
+                        lines.push('External references:');
+                        for (const ref of customer.externalReferences) {
+                            lines.push(`  ${ref.key}: ${ref.value ?? ''}`);
+                        }
+                    }
+                    if (customer.meta?.length) {
+                        lines.push('');
+                        lines.push('Meta:');
+                        for (const m of customer.meta) {
+                            lines.push(`  ${m.key}: ${m.value ?? ''}`);
+                        }
+                    }
+                }
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=customers.js.map

package/build/src/tools/customers.js.map

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

package/build/src/tools/discovery.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Discovery API tools — browse shapes, introspect schema, search via browse.
+ *
+ * Uses the Discovery API's semantic browse queries where each shape
+ * is a top-level field with its own filters, pagination, and fields.
+ */
+import type { CrystallizeClient } from '../client.js';
+import type { ToolDefinition } from '../types.js';
+export declare function discoveryTools(client: CrystallizeClient): ToolDefinition[];
+//# sourceMappingURL=discovery.d.ts.map

package/build/src/tools/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAqHlD,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,EAAE,CA+N1E"}