@tomaspavlin/rohlik-mcp 2.0.0 → 3.0.0

package/dist/tools/shopping-scenarios.js

@@ -0,0 +1,143 @@
+export function createShoppingScenariosTool() {
+    return {
+        name: "get_shopping_scenarios",
+        definition: {
+            title: "Get Shopping Scenarios",
+            description: "Shows example scenarios and use cases for the Rohlik MCP - helps users understand what's possible",
+            inputSchema: {}
+        },
+        handler: async () => {
+            const output = `🛒 ROHLIK MCP - WHAT YOU CAN DO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 SMART SHOPPING SCENARIOS:
+
+1️⃣  MEAL-BASED SHOPPING
+   💬 "Add breakfast items I typically order"
+   💬 "Show me lunch suggestions for this week"
+   💬 "I need dinner ingredients - suggest what I usually buy"
+   💬 "Add my usual snacks to the cart"
+   🔧 Tool: get_meal_suggestions
+
+2️⃣  QUICK REORDERING
+   💬 "Show my 20 most frequently purchased items"
+   💬 "What do I buy most often?"
+   💬 "Add my top 10 frequent items to cart"
+   🔧 Tool: get_frequent_items
+
+3️⃣  CATEGORY-BASED SHOPPING
+   💬 "What dairy products do I usually buy?"
+   💬 "Show my top bakery purchases"
+   💬 "Add my usual fruits and vegetables"
+   🔧 Tool: get_frequent_items (with categories)
+
+4️⃣  SPECIFIC PRODUCT SEARCH
+   💬 "Find organic milk and add to cart"
+   💬 "Search for gluten-free bread"
+   💬 "Show me all chocolates on sale"
+   🔧 Tool: search_products + add_to_cart
+
+5️⃣  WEEKLY PLANNING
+   💬 "I need groceries for the whole week - suggest based on my history"
+   💬 "Show what I typically buy for breakfast, lunch, and dinner"
+   💬 "Help me plan my weekly shopping"
+   🔧 Combination of meal suggestions
+
+6️⃣  ORDER MANAGEMENT
+   💬 "What's in my cart?"
+   💬 "Show my last 5 orders"
+   💬 "What did I order last week?"
+   💬 "Show details of order #1234567"
+   🔧 Tools: get_cart_content, get_order_history, get_order_detail
+
+7️⃣  DELIVERY PLANNING
+   💬 "When is my next delivery?"
+   💬 "What delivery slots are available tomorrow?"
+   💬 "Show the cheapest delivery slots this week"
+   🔧 Tools: get_upcoming_orders, get_delivery_slots
+
+8️⃣  ACCOUNT & SAVINGS
+   💬 "How much have I saved with Premium?"
+   💬 "What are my Premium benefits?"
+   💬 "Check my reusable bags count"
+   🔧 Tools: get_premium_info, get_reusable_bags_info
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎯 MEAL TYPES AVAILABLE:
+   • breakfast 🍳 - Morning essentials (bread, milk, cereals, fruits)
+   • lunch 🍽️ - Midday meal ingredients (meat, vegetables, pasta, rice)
+   • dinner 🍴 - Evening meal items (meat, fish, vegetables, sides)
+   • snack 🍿 - Quick bites (sweets, fruits, nuts, yogurt)
+   • baking 🧁 - Baking supplies (flour, sugar, chocolate, butter)
+   • drinks 🥤 - Beverages (coffee, tea, juices, water, alcohol)
+   • healthy 🥗 - Health-focused (bio, vegan, gluten-free, vegetables)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 POWER TIPS:
+
+   ✨ Combine suggestions with actions:
+      "Show breakfast suggestions and add top 5 to cart"
+
+   ✨ Use natural language:
+      "I forgot to buy milk last time, add it to my cart"
+
+   ✨ Ask for alternatives:
+      "Find cheaper alternative to product #123456"
+
+   ✨ Plan ahead:
+      "What should I order for weekend breakfast?"
+
+   ✨ Be specific:
+      "Add ingredients for apple pie - only gluten-free"
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔧 AVAILABLE TOOLS (${16}):
+
+📦 Shopping:
+   • search_products - Find products by name
+   • add_to_cart - Add products to cart
+   • get_cart_content - View current cart
+   • remove_from_cart - Remove items
+   • get_shopping_list - View shopping lists
+
+🤖 Smart Features:
+   • get_meal_suggestions - Meal-based suggestions (NEW!)
+   • get_frequent_items - Most purchased items
+   • get_shopping_scenarios - This help (NEW!)
+
+📊 Orders:
+   • get_order_history - Past orders
+   • get_order_detail - Order details
+   • get_upcoming_orders - Scheduled orders
+
+🚚 Delivery:
+   • get_delivery_info - Current delivery info
+   • get_delivery_slots - Available time slots
+
+👤 Account:
+   • get_account_data - Full account info
+   • get_premium_info - Premium subscription
+   • get_announcements - Current announcements
+   • get_reusable_bags_info - Bag tracking
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🚀 TRY IT NOW:
+   Start with: "Show me breakfast suggestions based on what I usually order"
+
+💬 Need help? Just ask: "What can I do with Rohlik MCP?"`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: output
+                    }
+                ]
+            };
+        }
+    };
+}
+//# sourceMappingURL=shopping-scenarios.js.map

package/dist/tools/shopping-scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopping-scenarios.js","sourceRoot":"","sources":["../../src/tools/shopping-scenarios.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE;YACV,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,mGAAmG;YAChH,WAAW,EAAE,EAAE;SAChB;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAuFC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAkCiC,CAAC;YAEpD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -124,6 +124,28 @@ export interface RohlikAPIResponse<T = any> {
         content: string;
     }>;
 }
+export interface OrderProduct {
+    id?: string;
+    productId?: string;
+    productName?: string;
+    name?: string;
+    quantity?: number;
+    price?: number;
+    totalPrice?: number;
+    brand?: string;
+}
+export interface OrderDetail {
+    id?: string;
+    orderNumber?: string;
+    status?: string;
+    createdAt?: string;
+    deliveredAt?: string;
+    deliveryDate?: string;
+    totalPrice?: number;
+    price?: number;
+    products?: OrderProduct[];
+    items?: OrderProduct[];
+}
 export interface AccountData {
     login?: any;
     delivery?: any;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,kBAAkB,CAAC,EAAE,GAAG,CAAC;IACzB,sBAAsB,CAAC,EAAE,GAAG,CAAC;IAC7B,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,kBAAkB,CAAC,EAAE,GAAG,CAAC;IACzB,sBAAsB,CAAC,EAAE,GAAG,CAAC;IAC7B,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomaspavlin/rohlik-mcp",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "type": "module",
   "description": "MCP server for controlling Rohlik.cz grocery shopping website",
   "keywords": [
@@ -35,7 +35,11 @@
     "start": "node dist/index.js",
     "inspect": "npm run build && npx @modelcontextprotocol/inspector -e ROHLIK_USERNAME=your-email@example.com -e ROHLIK_PASSWORD=your-password node dist/index.js",
     "watch": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "validate-api": "tsc && node dist/tests/validate-api.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -44,6 +48,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
   }
 }