@chanaka_nakandala/integration-agent 1.0.0

package/templates/update_item_availability/python.template

@@ -0,0 +1,203 @@
+"""
+Grubtech Item Availability Update - Python
+
+This example demonstrates how to update menu item availability in Grubtech
+to keep items in sync with your inventory status.
+
+Prerequisites:
+- Python 3.8+
+- requests library (pip install requests)
+- Valid access token from authentication
+
+Replace the following placeholders:
+- {{AUTH_TOKEN}}: Access token from authentication step
+- {{ITEM_ID}}: The menu item ID to update
+- {{AVAILABLE_STATUS}}: Boolean availability status (True/False)
+"""
+
+import requests
+import sys
+from datetime import datetime
+from typing import Dict, Any, List, Optional
+
+AUTH_TOKEN = '{{AUTH_TOKEN}}'
+BASE_URL = 'https://api.grubtech.io'
+
+
+def update_item_availability(
+    item_id: str,
+    available: bool,
+    reason: Optional[str] = None
+) -> Dict[str, Any]:
+    """
+    Update single item availability
+
+    Args:
+        item_id: The menu item ID
+        available: True if in stock, False if out of stock
+        reason: Optional reason for status change
+
+    Returns:
+        Dict: Response from API
+
+    Raises:
+        Exception: If update fails
+    """
+    try:
+        # Construct payload
+        payload = {
+            'itemId': item_id,
+            'available': available,
+            'timestamp': datetime.utcnow().isoformat() + 'Z',
+        }
+
+        if reason:
+            payload['reason'] = reason
+
+        print(f'Updating item {item_id}: available={available}')
+
+        # Make availability update request
+        url = f'{BASE_URL}/v1/items/{item_id}/availability'
+        headers = {
+            'Authorization': f'Bearer {AUTH_TOKEN}',
+            'Content-Type': 'application/json',
+        }
+
+        response = requests.put(url, json=payload, headers=headers, timeout=10)
+
+        # Check for errors
+        if not response.ok:
+            raise Exception(
+                f'Availability update failed: {response.status_code} - {response.text}'
+            )
+
+        # Parse response
+        data = response.json()
+
+        print(f'✅ Item availability updated successfully!')
+        print(f'Item ID: {data["itemId"]}')
+        print(f'Available: {available}')
+
+        return data
+
+    except requests.RequestException as e:
+        print(f'❌ Availability update error: {e}', file=sys.stderr)
+        raise
+    except Exception as e:
+        print(f'❌ Unexpected error: {e}', file=sys.stderr)
+        raise
+
+
+def update_bulk_availability(
+    updates: List[Dict[str, Any]]
+) -> Dict[str, Any]:
+    """
+    Update multiple items availability in bulk
+
+    Args:
+        updates: List of item availability updates
+                 [{'itemId': 'item-1', 'available': False, 'reason': '...'}]
+
+    Returns:
+        Dict: Response from API
+
+    Raises:
+        Exception: If update fails
+    """
+    try:
+        # Construct bulk payload
+        payload = {
+            'updates': updates,
+            'timestamp': datetime.utcnow().isoformat() + 'Z',
+        }
+
+        print(f'Updating {len(updates)} items availability')
+
+        # Make bulk availability update request
+        url = f'{BASE_URL}/v1/items/availability/bulk'
+        headers = {
+            'Authorization': f'Bearer {AUTH_TOKEN}',
+            'Content-Type': 'application/json',
+        }
+
+        response = requests.put(url, json=payload, headers=headers, timeout=30)
+
+        # Check for errors
+        if not response.ok:
+            raise Exception(
+                f'Bulk availability update failed: {response.status_code} - {response.text}'
+            )
+
+        # Parse response
+        data = response.json()
+
+        print(f'✅ Bulk availability updated successfully!')
+        print(f'Updated: {data.get("updatedCount", 0)} items')
+
+        # Report any errors
+        errors = data.get('errors', [])
+        if errors:
+            print(f'⚠️  {len(errors)} items had errors:')
+            for err in errors:
+                print(f'  - {err["itemId"]}: {err["error"]}')
+
+        return data
+
+    except requests.RequestException as e:
+        print(f'❌ Bulk availability update error: {e}', file=sys.stderr)
+        raise
+    except Exception as e:
+        print(f'❌ Unexpected error: {e}', file=sys.stderr)
+        raise
+
+
+def mark_out_of_stock(item_id: str) -> Dict[str, Any]:
+    """Mark item as out of stock"""
+    return update_item_availability(item_id, False, 'Out of stock')
+
+
+def mark_in_stock(item_id: str) -> Dict[str, Any]:
+    """Mark item as back in stock"""
+    return update_item_availability(item_id, True, 'Back in stock')
+
+
+def sync_inventory(inventory: Dict[str, bool]) -> Dict[str, Any]:
+    """
+    Sync inventory with Grubtech
+
+    Args:
+        inventory: Dict mapping item IDs to availability status
+                   {'item-123': False, 'item-456': True}
+    """
+    updates = [
+        {
+            'itemId': item_id,
+            'available': available,
+            'reason': 'In stock' if available else 'Out of stock',
+        }
+        for item_id, available in inventory.items()
+    ]
+
+    return update_bulk_availability(updates)
+
+
+if __name__ == '__main__':
+    try:
+        item_id = '{{ITEM_ID}}'
+        available = {{AVAILABLE_STATUS}}  # True or False
+
+        # Example 1: Single item update
+        update_item_availability(item_id, available, 'Inventory sync')
+
+        # Example 2: Mark item out of stock
+        # mark_out_of_stock('item-123')
+
+        # Example 3: Bulk update from inventory
+        # sync_inventory({
+        #     'item-123': False,  # Out of stock
+        #     'item-456': True,   # In stock
+        #     'item-789': True,   # In stock
+        # })
+
+    except Exception as e:
+        sys.exit(1)

package/templates/update_item_availability/typescript.template

@@ -0,0 +1,194 @@
+/**
+ * Grubtech Item Availability Update - TypeScript
+ *
+ * This example demonstrates how to update menu item availability in Grubtech
+ * to keep items in sync with your inventory status.
+ *
+ * Prerequisites:
+ * - Node.js 18+ with fetch API
+ * - Valid access token from authentication
+ *
+ * Replace the following placeholders:
+ * - {{AUTH_TOKEN}}: Access token from authentication step
+ * - {{ITEM_ID}}: The menu item ID to update
+ * - {{AVAILABLE_STATUS}}: Boolean availability status (true/false)
+ */
+
+const AUTH_TOKEN = '{{AUTH_TOKEN}}';
+const BASE_URL = 'https://api.grubtech.io';
+
+interface ItemAvailabilityUpdate {
+  itemId: string;
+  available: boolean;
+  reason?: string;
+}
+
+interface BulkAvailabilityUpdate {
+  updates: ItemAvailabilityUpdate[];
+  timestamp: string;
+}
+
+interface AvailabilityResponse {
+  success: boolean;
+  itemId?: string;
+  updatedCount?: number;
+  message?: string;
+  errors?: Array<{ itemId: string; error: string }>;
+}
+
+/**
+ * Update single item availability
+ */
+async function updateItemAvailability(
+  itemId: string,
+  available: boolean,
+  reason?: string
+): Promise<AvailabilityResponse> {
+  try {
+    // Construct payload
+    const payload = {
+      itemId,
+      available,
+      timestamp: new Date().toISOString(),
+      reason,
+    };
+
+    console.log(`Updating item ${itemId}: available=${available}`);
+
+    // Make availability update request
+    const response = await fetch(`${BASE_URL}/v1/items/${itemId}/availability`, {
+      method: 'PUT',
+      headers: {
+        'Authorization': `Bearer ${AUTH_TOKEN}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(payload),
+    });
+
+    // Check for errors
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(
+        `Availability update failed: ${response.status} - ${errorBody}`
+      );
+    }
+
+    // Parse response
+    const data: AvailabilityResponse = await response.json();
+
+    console.log('✅ Item availability updated successfully!');
+    console.log(`Item ID: ${data.itemId}`);
+    console.log(`Available: ${available}`);
+
+    return data;
+  } catch (error) {
+    console.error('❌ Availability update error:', error);
+    throw error;
+  }
+}
+
+/**
+ * Update multiple items availability in bulk
+ */
+async function updateBulkAvailability(
+  updates: ItemAvailabilityUpdate[]
+): Promise<AvailabilityResponse> {
+  try {
+    // Construct bulk payload
+    const payload: BulkAvailabilityUpdate = {
+      updates,
+      timestamp: new Date().toISOString(),
+    };
+
+    console.log(`Updating ${updates.length} items availability`);
+
+    // Make bulk availability update request
+    const response = await fetch(`${BASE_URL}/v1/items/availability/bulk`, {
+      method: 'PUT',
+      headers: {
+        'Authorization': `Bearer ${AUTH_TOKEN}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(payload),
+    });
+
+    // Check for errors
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(
+        `Bulk availability update failed: ${response.status} - ${errorBody}`
+      );
+    }
+
+    // Parse response
+    const data: AvailabilityResponse = await response.json();
+
+    console.log('✅ Bulk availability updated successfully!');
+    console.log(`Updated: ${data.updatedCount} items`);
+
+    // Report any errors
+    if (data.errors && data.errors.length > 0) {
+      console.warn(`⚠️  ${data.errors.length} items had errors:`);
+      data.errors.forEach(err => {
+        console.warn(`  - ${err.itemId}: ${err.error}`);
+      });
+    }
+
+    return data;
+  } catch (error) {
+    console.error('❌ Bulk availability update error:', error);
+    throw error;
+  }
+}
+
+/**
+ * Example: Mark item as out of stock
+ */
+async function markOutOfStock(itemId: string) {
+  return await updateItemAvailability(itemId, false, 'Out of stock');
+}
+
+/**
+ * Example: Mark item as back in stock
+ */
+async function markInStock(itemId: string) {
+  return await updateItemAvailability(itemId, true, 'Back in stock');
+}
+
+/**
+ * Example: Sync inventory with Grubtech
+ */
+async function syncInventory(inventory: Record<string, boolean>) {
+  const updates: ItemAvailabilityUpdate[] = Object.entries(inventory).map(
+    ([itemId, available]) => ({
+      itemId,
+      available,
+      reason: available ? 'In stock' : 'Out of stock',
+    })
+  );
+
+  return await updateBulkAvailability(updates);
+}
+
+// Main execution
+(async () => {
+  try {
+    const itemId = '{{ITEM_ID}}';
+    const available = {{AVAILABLE_STATUS}}; // true or false
+
+    // Example 1: Single item update
+    await updateItemAvailability(itemId, available, 'Inventory sync');
+
+    // Example 2: Mark item out of stock
+    // await markOutOfStock('item-123');
+
+    // Example 3: Bulk update from inventory
+    // await syncInventory({
+    //   'item-123': false,  // Out of stock
+    //   'item-456': true,   // In stock
+    //   'item-789': true,   // In stock
+    // });
+  } catch (error) {
+    process.exit(1);
+  }
+})();

package/templates/update_order_status/curl.template

@@ -0,0 +1,138 @@
+#!/bin/bash
+
+# Grubtech Order Status Update - cURL
+#
+# This example demonstrates how to update order status in Grubtech.
+#
+# Prerequisites:
+# - curl command-line tool
+# - jq (for JSON parsing, optional)
+# - Valid access token from authentication
+#
+# Replace the following placeholders:
+# - {{AUTH_TOKEN}}: Access token from authentication step
+# - {{ORDER_ID}}: The Grubtech order ID to update
+# - {{NEW_STATUS}}: The new status value (accepted, preparing, ready, delivered, cancelled)
+
+AUTH_TOKEN="{{AUTH_TOKEN}}"
+ORDER_ID="{{ORDER_ID}}"
+NEW_STATUS="{{NEW_STATUS}}"  # One of: accepted, preparing, ready, delivered, cancelled
+BASE_URL="https://api.grubtech.io"
+
+# Valid status values
+VALID_STATUSES=("accepted" "preparing" "ready" "delivered" "cancelled")
+
+# Validate status
+validate_status() {
+    local status=$1
+    for valid in "${VALID_STATUSES[@]}"; do
+        if [ "$status" == "$valid" ]; then
+            return 0
+        fi
+    done
+    echo "❌ Invalid status: $status"
+    echo "Valid statuses: ${VALID_STATUSES[*]}"
+    return 1
+}
+
+# Update order status
+update_order_status() {
+    local order_id=$1
+    local new_status=$2
+    local notes=$3
+
+    # Validate status
+    if ! validate_status "$new_status"; then
+        return 1
+    fi
+
+    echo "Updating order ${order_id} to status: ${new_status}"
+
+    # Construct payload
+    TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    PAYLOAD=$(cat <<EOF
+{
+  "orderId": "${order_id}",
+  "status": "${new_status}",
+  "timestamp": "${TIMESTAMP}",
+  "notes": "${notes}"
+}
+EOF
+)
+
+    # Make status update request
+    RESPONSE=$(curl -s -w "\n%{http_code}" -X PUT \
+        "${BASE_URL}/v1/orders/${order_id}/status" \
+        -H "Authorization: Bearer ${AUTH_TOKEN}" \
+        -H "Content-Type: application/json" \
+        -d "$PAYLOAD")
+
+    # Extract HTTP status code and body
+    HTTP_CODE=$(echo "$RESPONSE" | tail -n 1)
+    BODY=$(echo "$RESPONSE" | sed '$d')
+
+    # Check for errors
+    if [ "$HTTP_CODE" -ne 200 ]; then
+        echo "❌ Status update failed: HTTP $HTTP_CODE"
+        echo "Response: $BODY"
+        return 1
+    fi
+
+    # Parse response
+    if command -v jq &> /dev/null; then
+        ORDER_ID=$(echo "$BODY" | jq -r '.orderId')
+        STATUS=$(echo "$BODY" | jq -r '.status')
+        UPDATED_AT=$(echo "$BODY" | jq -r '.updatedAt')
+
+        echo "✅ Order status updated successfully!"
+        echo "Order ID: ${ORDER_ID}"
+        echo "New Status: ${STATUS}"
+        echo "Updated At: ${UPDATED_AT}"
+    else
+        echo "✅ Order status updated successfully!"
+        echo "Response: $BODY"
+        echo "Note: Install jq for better JSON parsing"
+    fi
+}
+
+# Example: Full order workflow
+order_workflow_example() {
+    local order_id=$1
+
+    echo "Running full order workflow for: ${order_id}"
+    echo ""
+
+    # Step 1: Accept
+    echo "Step 1: Accepting order..."
+    update_order_status "$order_id" "accepted" "Order confirmed"
+    echo ""
+
+    # Step 2: Preparing
+    echo "Step 2: Preparing order..."
+    update_order_status "$order_id" "preparing" "Chef started cooking"
+    echo ""
+
+    # Step 3: Ready
+    echo "Step 3: Order ready..."
+    update_order_status "$order_id" "ready" "Order ready for pickup"
+    echo ""
+
+    # Step 4: Delivered
+    echo "Step 4: Order delivered..."
+    update_order_status "$order_id" "delivered" "Order delivered to customer"
+    echo ""
+
+    echo "✅ Order workflow completed!"
+}
+
+# Main execution
+main() {
+    # Single status update
+    update_order_status "$ORDER_ID" "$NEW_STATUS" "Status update from POS"
+
+    # Or run through full workflow
+    # order_workflow_example "$ORDER_ID"
+}
+
+# Run main function
+main