vilgain-mcp 0.1.0

package/dist/parsers/product.js.map

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

package/dist/parsers/search.d.ts

@@ -0,0 +1,3 @@
+import { SearchProduct } from '../types.js';
+/** Parse product cards from a search results (or category listing) page. */
+export declare function parseSearchResults(html: string, baseUrl: string): SearchProduct[];

package/dist/parsers/search.js

@@ -0,0 +1,66 @@
+import * as cheerio from 'cheerio';
+import { cleanText, findDataLayerObject, parsePriceText, parseRatingText } from './common.js';
+/**
+ * The search page's `view_item_list` analytics event lists the variant ids of
+ * the displayed products in card order (with occasional extra non-product
+ * entries like bundles). Zip it with the cards, matching by product name;
+ * a card that cannot be matched safely just gets no variant id.
+ */
+function buildVariantIdLookup(html) {
+    const list = findDataLayerObject(html, (obj) => obj.event === 'view_item_list' && Array.isArray(obj.item_ids) && Array.isArray(obj.item_names));
+    if (!list)
+        return () => undefined;
+    let pointer = 0;
+    const assigned = new Set();
+    return (name) => {
+        // Skip non-product entries (their names don't match the card).
+        let cursor = pointer;
+        while (cursor < list.item_names.length && cleanText(list.item_names[cursor]) !== name) {
+            cursor++;
+        }
+        if (cursor >= list.item_ids.length)
+            return undefined;
+        const id = list.item_ids[cursor];
+        pointer = cursor + 1;
+        // The analytics list can repeat an entry; never hand out the same id twice.
+        if (typeof id !== 'number' || assigned.has(id))
+            return undefined;
+        assigned.add(id);
+        return id;
+    };
+}
+/** Parse product cards from a search results (or category listing) page. */
+export function parseSearchResults(html, baseUrl) {
+    const $ = cheerio.load(html);
+    const products = [];
+    const seen = new Set();
+    const variantIdFor = buildVariantIdLookup(html);
+    $('.c-product-box').each((_, el) => {
+        const box = $(el);
+        const productId = parseInt(box.attr('data-item-id') ?? '', 10);
+        if (Number.isNaN(productId) || seen.has(productId))
+            return;
+        const href = box.find('a.c-product-box__link').attr('href');
+        if (!href)
+            return;
+        seen.add(productId);
+        const name = cleanText(box.attr('data-item-name') ?? box.find('.c-product-box__title').first().text());
+        const priceText = box.find('.c-product-box__price--main').first().text();
+        const price = parsePriceText(priceText);
+        const rating = parseRatingText(box.find('.c-product-box__rating .sr-only').first().text());
+        products.push({
+            productId,
+            name,
+            subtitle: cleanText(box.find('.c-product-box__subtitle').first().text()).replace(/^[–-]\s*/, '') || undefined,
+            defaultVariant: cleanText(box.find('.c-product-box__param').first().text()) || undefined,
+            variantId: variantIdFor(name),
+            url: new URL(href, baseUrl).href,
+            price: price?.price,
+            currency: price?.currency,
+            rating: rating?.rating,
+            reviewCount: rating?.reviewCount,
+        });
+    });
+    return products;
+}
+//# sourceMappingURL=search.js.map

package/dist/parsers/search.js.map

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

package/dist/tools/cart.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+import { VilgainAPI } from '../vilgain-api.js';
+export declare function createCartTools(api: VilgainAPI): {
+    getCartContent: {
+        name: string;
+        definition: {
+            title: string;
+            description: string;
+            inputSchema: {};
+            annotations: {
+                readOnlyHint: boolean;
+                openWorldHint: boolean;
+            };
+        };
+        handler: () => Promise<{
+            content: Array<{
+                type: "text";
+                text: string;
+            }>;
+            isError?: boolean;
+        }>;
+    };
+    addToCart: {
+        name: string;
+        definition: {
+            title: string;
+            description: string;
+            inputSchema: {
+                variant_id: z.ZodNumber;
+                quantity: z.ZodDefault<z.ZodNumber>;
+            };
+            annotations: {
+                readOnlyHint: boolean;
+                destructiveHint: boolean;
+                openWorldHint: boolean;
+            };
+        };
+        handler: ({ variant_id, quantity }: {
+            variant_id: number;
+            quantity?: number;
+        }) => Promise<{
+            content: Array<{
+                type: "text";
+                text: string;
+            }>;
+            isError?: boolean;
+        }>;
+    };
+    setCartItemQuantity: {
+        name: string;
+        definition: {
+            title: string;
+            description: string;
+            inputSchema: {
+                variant_id: z.ZodNumber;
+                quantity: z.ZodNumber;
+            };
+            annotations: {
+                readOnlyHint: boolean;
+                destructiveHint: boolean;
+                openWorldHint: boolean;
+            };
+        };
+        handler: ({ variant_id, quantity }: {
+            variant_id: number;
+            quantity: number;
+        }) => Promise<{
+            content: Array<{
+                type: "text";
+                text: string;
+            }>;
+            isError?: boolean;
+        }>;
+    };
+    removeFromCart: {
+        name: string;
+        definition: {
+            title: string;
+            description: string;
+            inputSchema: {
+                variant_id: z.ZodNumber;
+            };
+            annotations: {
+                readOnlyHint: boolean;
+                destructiveHint: boolean;
+                openWorldHint: boolean;
+            };
+        };
+        handler: ({ variant_id }: {
+            variant_id: number;
+        }) => Promise<{
+            content: Array<{
+                type: "text";
+                text: string;
+            }>;
+            isError?: boolean;
+        }>;
+    };
+};

package/dist/tools/cart.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { errorResult, formatCart, textResult } from './helpers.js';
+export function createCartTools(api) {
+    const getCartContent = {
+        name: 'get_cart_content',
+        definition: {
+            title: 'Get Cart Content',
+            description: 'Show the current content of the Vilgain shopping cart: items, quantities, prices and the total.',
+            inputSchema: {},
+            annotations: {
+                readOnlyHint: true,
+                openWorldHint: true,
+            },
+        },
+        handler: async () => {
+            try {
+                return textResult(formatCart(await api.getCart()));
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+    const addToCart = {
+        name: 'add_to_cart',
+        definition: {
+            title: 'Add to Cart',
+            description: 'Add a product variant to the Vilgain shopping cart. Requires a variant ID - either the displayed variant ' +
+                'from search_products, or a specific flavor/size from get_product_variants. ' +
+                'Adds the given quantity on top of what is already in the cart. Returns the updated cart.',
+            inputSchema: {
+                variant_id: z.number().int().positive().describe('Variant ID from search_products or get_product_variants'),
+                quantity: z.number().int().min(1).max(100).default(1).describe('How many pieces to add (default 1)'),
+            },
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: false,
+                openWorldHint: true,
+            },
+        },
+        handler: async ({ variant_id, quantity }) => {
+            try {
+                const cart = await api.addToCart(variant_id, quantity ?? 1);
+                return textResult(`Added to cart.\n\n${formatCart(cart)}`);
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+    const setCartItemQuantity = {
+        name: 'set_cart_item_quantity',
+        definition: {
+            title: 'Set Cart Item Quantity',
+            description: 'Set the exact quantity of an item already in the Vilgain cart (use variant IDs from get_cart_content). ' +
+                'Returns the updated cart.',
+            inputSchema: {
+                variant_id: z.number().int().positive().describe('Variant ID of an item in the cart'),
+                quantity: z.number().int().min(1).max(100).describe('New absolute quantity'),
+            },
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: false,
+                openWorldHint: true,
+            },
+        },
+        handler: async ({ variant_id, quantity }) => {
+            try {
+                const cart = await api.setCartItemQuantity(variant_id, quantity);
+                return textResult(`Quantity updated.\n\n${formatCart(cart)}`);
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+    const removeFromCart = {
+        name: 'remove_from_cart',
+        definition: {
+            title: 'Remove from Cart',
+            description: 'Remove an item from the Vilgain shopping cart (use variant IDs from get_cart_content). Returns the updated cart.',
+            inputSchema: {
+                variant_id: z.number().int().positive().describe('Variant ID of the item to remove'),
+            },
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: true,
+                openWorldHint: true,
+            },
+        },
+        handler: async ({ variant_id }) => {
+            try {
+                const cart = await api.removeFromCart(variant_id);
+                return textResult(`Item removed.\n\n${formatCart(cart)}`);
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+    return { getCartContent, addToCart, setCartItemQuantity, removeFromCart };
+}
+//# sourceMappingURL=cart.js.map

package/dist/tools/cart.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,12 @@
+import { CartContent } from '../types.js';
+type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function textResult(text: string): ToolResult;
+export declare function errorResult(error: unknown): ToolResult;
+export declare function formatCart(cart: CartContent): string;
+export {};

package/dist/tools/helpers.js

@@ -0,0 +1,21 @@
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function errorResult(error) {
+    return {
+        content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],
+        isError: true,
+    };
+}
+export function formatCart(cart) {
+    if (cart.items.length === 0) {
+        return 'The cart is empty.';
+    }
+    const lines = cart.items.map((item) => {
+        const variant = item.variant ? ` (${item.variant})` : '';
+        return `• ${item.productName}${variant}\n  Quantity: ${item.quantity} × ${item.price} ${item.currency}\n  Variant ID: ${item.variantId}`;
+    });
+    const total = cart.totalWithVat !== undefined ? `\n\nTotal (with VAT): ${cart.totalWithVat} ${cart.currency ?? ''}`.trimEnd() : '';
+    return `Cart (${cart.items.length} item${cart.items.length === 1 ? '' : 's'}):\n\n${lines.join('\n\n')}${total}`;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,IAAI,CAAC,WAAW,GAAG,OAAO,iBAAiB,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,mBAAmB,IAAI,CAAC,SAAS,EAAE,CAAC;IAC3I,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GACT,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvH,OAAO,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;AACnH,CAAC"}

package/dist/tools/order-history.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { VilgainAPI } from '../vilgain-api.js';
+export declare function createOrderHistoryTools(api: VilgainAPI): {
+    getOrderHistory: {
+        name: string;
+        definition: {
+            title: string;
+            description: string;
+            inputSchema: {};
+            annotations: {
+                readOnlyHint: boolean;
+                openWorldHint: boolean;
+            };
+        };
+        handler: () => Promise<{
+            content: Array<{
+                type: "text";
+                text: string;
+            }>;
+            isError?: boolean;
+        }>;
+    };
+    getOrderDetail: {
+        name: string;
+        definition: {
+            title: string;
+            description: string;
+            inputSchema: {
+                order_id: z.ZodString;
+            };
+            annotations: {
+                readOnlyHint: boolean;
+                openWorldHint: boolean;
+            };
+        };
+        handler: ({ order_id }: {
+            order_id: string;
+        }) => Promise<{
+            content: Array<{
+                type: "text";
+                text: string;
+            }>;
+            isError?: boolean;
+        }>;
+    };
+};

package/dist/tools/order-history.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { errorResult, textResult } from './helpers.js';
+export function createOrderHistoryTools(api) {
+    const getOrderHistory = {
+        name: 'get_order_history',
+        definition: {
+            title: 'Get Order History',
+            description: 'List past orders of the logged-in Vilgain account: order ID, date, state, total and product names. ' +
+                'Use get_order_detail with an order ID for quantities, prices and delivery status.',
+            inputSchema: {},
+            annotations: {
+                readOnlyHint: true,
+                openWorldHint: true,
+            },
+        },
+        handler: async () => {
+            try {
+                const { orders, empty } = await api.getOrderHistory();
+                if (empty || orders.length === 0) {
+                    return textResult('No past orders found on this account.');
+                }
+                const output = orders
+                    .map((order) => {
+                    const header = [
+                        `• Order ${order.id}`,
+                        order.date,
+                        order.state,
+                        order.total !== undefined ? `${order.total} ${order.currency}` : undefined,
+                    ]
+                        .filter(Boolean)
+                        .join(' | ');
+                    const products = order.productNames.length > 0 ? `\n  Products: ${order.productNames.join(', ')}` : '';
+                    return header + products;
+                })
+                    .join('\n\n');
+                return textResult(`Found ${orders.length} orders (most recent first):\n\n${output}`);
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+    const getOrderDetail = {
+        name: 'get_order_detail',
+        definition: {
+            title: 'Get Order Detail',
+            description: 'Get one past order of the logged-in Vilgain account: items with variants, quantities, prices and ' +
+                'variant IDs (usable with add_to_cart to reorder), order total, delivery destination and shipment status timeline.',
+            inputSchema: {
+                order_id: z.string().regex(/^\d+$/).describe('Order ID from get_order_history'),
+            },
+            annotations: {
+                readOnlyHint: true,
+                openWorldHint: true,
+            },
+        },
+        handler: async ({ order_id }) => {
+            try {
+                const detail = await api.getOrderDetail(order_id);
+                const sections = [`# Order ${detail.orderNumber}`];
+                if (detail.items.length > 0) {
+                    const items = detail.items
+                        .map((item) => {
+                        const parts = [
+                            item.variant,
+                            item.quantity !== undefined ? `${item.quantity} pcs` : undefined,
+                            item.price !== undefined ? `${item.price} ${item.currency}` : undefined,
+                        ].filter(Boolean);
+                        const variantId = item.variantId !== undefined ? `\n  Variant ID (for add_to_cart): ${item.variantId}` : '';
+                        return `• ${item.name}${parts.length > 0 ? ` (${parts.join(', ')})` : ''}${variantId}${item.url ? `\n  URL: ${item.url}` : ''}`;
+                    })
+                        .join('\n');
+                    sections.push(`## Items\n${items}`);
+                }
+                if (detail.totalWithVat !== undefined) {
+                    sections.push(`Total (with VAT): ${detail.totalWithVat} ${detail.currency ?? ''}`.trimEnd());
+                }
+                if (detail.deliveryAddress) {
+                    sections.push(`Delivery: ${detail.deliveryAddress}`);
+                }
+                if (detail.timeline.length > 0) {
+                    sections.push(`## Status timeline\n${detail.timeline.map((e) => `• ${e.event}${e.date ? ` – ${e.date}` : ''}`).join('\n')}`);
+                }
+                return textResult(sections.join('\n\n'));
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+    return { getOrderHistory, getOrderDetail };
+}
+//# sourceMappingURL=order-history.js.map

package/dist/tools/order-history.js.map

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

package/dist/tools/product-detail.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { VilgainAPI } from '../vilgain-api.js';
+export declare function createProductDetailTool(api: VilgainAPI): {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            product_url: z.ZodString;
+            variant_id: z.ZodOptional<z.ZodNumber>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            openWorldHint: boolean;
+        };
+    };
+    handler: ({ product_url, variant_id }: {
+        product_url: string;
+        variant_id?: number;
+    }) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+};

package/dist/tools/product-detail.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { errorResult, textResult } from './helpers.js';
+function formatNutritionTable(table) {
+    const header = `  | ${['', ...table.columns].join(' | ')} |`;
+    const rows = table.rows.map((row) => `  | ${[row.label, ...row.values].join(' | ')} |`);
+    return [header, ...rows].join('\n');
+}
+export function createProductDetailTool(api) {
+    return {
+        name: 'get_product_detail',
+        definition: {
+            title: 'Get Product Detail',
+            description: 'Get what is inside a Vilgain product: ingredients (with allergens), nutrition facts, dosage and description. ' +
+                'Without variant_id it describes the product\'s default variant; pass variant_id (from search_products, ' +
+                'get_product_variants or get_order_detail) to inspect a specific flavor/size. ' +
+                'For the list of variants and prices use get_product_variants instead.',
+            inputSchema: {
+                product_url: z
+                    .string()
+                    .min(1)
+                    .describe('Product or variant URL, e.g. "https://vilgain.cz/vilgain-whey-protein-2"'),
+                variant_id: z
+                    .number()
+                    .int()
+                    .positive()
+                    .optional()
+                    .describe('Optional variant ID to get the content of a specific flavor/size of this product'),
+            },
+            annotations: {
+                readOnlyHint: true,
+                openWorldHint: true,
+            },
+        },
+        handler: async ({ product_url, variant_id }) => {
+            try {
+                const detail = await api.getProductDetail(product_url, variant_id);
+                const sections = [];
+                sections.push(`# ${detail.name}`);
+                const selected = detail.variants.find((v) => v.variantId === detail.selectedVariantId);
+                if (selected)
+                    sections.push(`Content below refers to variant: ${selected.name} (Variant ID: ${selected.variantId})`);
+                if (detail.rating)
+                    sections.push(`Rating: ${detail.rating} (${detail.reviewCount} reviews)`);
+                if (detail.shortDescription)
+                    sections.push(detail.shortDescription);
+                if (detail.ingredients)
+                    sections.push(`## Ingredients & allergens\n${detail.ingredients}`);
+                if (detail.nutrition.length > 0) {
+                    sections.push(`## Nutrition facts\n${detail.nutrition.map(formatNutritionTable).join('\n\n')}`);
+                }
+                if (detail.dosage)
+                    sections.push(`## Dosage\n${detail.dosage}`);
+                if (detail.description)
+                    sections.push(`## Description\n${detail.description}`);
+                sections.push(`URL: ${detail.url}`);
+                return textResult(sections.join('\n\n'));
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=product-detail.js.map

package/dist/tools/product-detail.js.map

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

package/dist/tools/product-variants.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { VilgainAPI } from '../vilgain-api.js';
+export declare function createProductVariantsTool(api: VilgainAPI): {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            product_url: z.ZodString;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            openWorldHint: boolean;
+        };
+    };
+    handler: ({ product_url }: {
+        product_url: string;
+    }) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+};