@chanaka_nakandala/integration-agent 1.1.0 → 2.0.0

package/templates/update_item_availability/typescript.template

@@ -1,194 +0,0 @@
-/**
- * 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

@@ -1,138 +0,0 @@
-#!/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

package/templates/update_order_status/java.template

@@ -1,202 +0,0 @@
-/**
- * Grubtech Order Status Update - Java (Spring Boot)
- *
- * This example demonstrates how to update order status in Grubtech.
- *
- * Prerequisites:
- * - Java 17+
- * - Spring Boot 3.x
- * - Spring WebFlux (for WebClient)
- *
- * 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
- */
-
-package com.example.grubtech;
-
-import org.springframework.http.HttpHeaders;
-import org.springframework.http.MediaType;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-import reactor.core.publisher.Mono;
-
-import java.time.Instant;
-import java.util.HashMap;
-import java.util.Map;
-
-@Service
-public class GrubtechOrderStatusService {
-
-    private static final String AUTH_TOKEN = "{{AUTH_TOKEN}}";
-    private static final String BASE_URL = "https://api.grubtech.io";
-
-    private final WebClient webClient;
-
-    /**
-     * Valid order status values
-     */
-    public enum OrderStatus {
-        ACCEPTED("accepted"),
-        PREPARING("preparing"),
-        READY("ready"),
-        DELIVERED("delivered"),
-        CANCELLED("cancelled");
-
-        private final String value;
-
-        OrderStatus(String value) {
-            this.value = value;
-        }
-
-        public String getValue() {
-            return value;
-        }
-    }
-
-    public GrubtechOrderStatusService() {
-        this.webClient = WebClient.builder()
-                .baseUrl(BASE_URL)
-                .build();
-    }
-
-    /**
-     * Update order status in Grubtech
-     *
-     * @param orderId   The Grubtech order ID
-     * @param newStatus The new status value
-     * @param notes     Optional notes about the status change
-     * @return Status update response
-     */
-    public StatusUpdateResponse updateOrderStatus(
-            String orderId,
-            OrderStatus newStatus,
-            String notes
-    ) {
-        try {
-            // Construct status update payload
-            Map<String, Object> payload = new HashMap<>();
-            payload.put("orderId", orderId);
-            payload.put("status", newStatus.getValue());
-            payload.put("timestamp", Instant.now().toString());
-
-            if (notes != null && !notes.isEmpty()) {
-                payload.put("notes", notes);
-            }
-
-            System.out.println("Updating order " + orderId + " to status: " + newStatus.getValue());
-
-            // Make status update request
-            StatusUpdateResponse response = webClient.put()
-                    .uri("/v1/orders/" + orderId + "/status")
-                    .header(HttpHeaders.AUTHORIZATION, "Bearer " + AUTH_TOKEN)
-                    .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
-                    .bodyValue(payload)
-                    .retrieve()
-                    .onStatus(
-                            status -> !status.is2xxSuccessful(),
-                            clientResponse -> clientResponse.bodyToMono(String.class)
-                                    .flatMap(errorBody -> Mono.error(
-                                            new RuntimeException(
-                                                    "Status update failed: " +
-                                                    clientResponse.statusCode() +
-                                                    " - " + errorBody
-                                            )
-                                    ))
-                    )
-                    .bodyToMono(StatusUpdateResponse.class)
-                    .block();
-
-            if (response == null) {
-                throw new RuntimeException("No response received from status update");
-            }
-
-            System.out.println("✅ Order status updated successfully!");
-            System.out.println("Order ID: " + response.getOrderId());
-            System.out.println("New Status: " + response.getStatus());
-            System.out.println("Updated At: " + response.getUpdatedAt());
-
-            return response;
-
-        } catch (Exception e) {
-            System.err.println("❌ Status update error: " + e.getMessage());
-            throw e;
-        }
-    }
-
-    /**
-     * Example: Update order through typical workflow
-     *
-     * @param orderId The Grubtech order ID
-     */
-    public void orderWorkflowExample(String orderId) {
-        try {
-            // Step 1: Accept the order
-            updateOrderStatus(orderId, OrderStatus.ACCEPTED, "Order confirmed");
-
-            // Step 2: Start preparing
-            updateOrderStatus(orderId, OrderStatus.PREPARING, "Chef started cooking");
-
-            // Step 3: Mark as ready
-            updateOrderStatus(orderId, OrderStatus.READY, "Order ready for pickup");
-
-            // Step 4: Mark as delivered
-            updateOrderStatus(orderId, OrderStatus.DELIVERED, "Order delivered to customer");
-
-            System.out.println("✅ Order workflow completed!");
-
-        } catch (Exception e) {
-            System.err.println("❌ Workflow error: " + e.getMessage());
-
-            // If something goes wrong, cancel the order
-            updateOrderStatus(orderId, OrderStatus.CANCELLED, "Unable to fulfill order");
-        }
-    }
-
-    /**
-     * Response model for status update
-     */
-    public static class StatusUpdateResponse {
-        private boolean success;
-        private String orderId;
-        private String status;
-        private String updatedAt;
-        private String message;
-
-        // Getters and setters
-        public boolean isSuccess() { return success; }
-        public void setSuccess(boolean success) { this.success = success; }
-
-        public String getOrderId() { return orderId; }
-        public void setOrderId(String orderId) { this.orderId = orderId; }
-
-        public String getStatus() { return status; }
-        public void setStatus(String status) { this.status = status; }
-
-        public String getUpdatedAt() { return updatedAt; }
-        public void setUpdatedAt(String updatedAt) { this.updatedAt = updatedAt; }
-
-        public String getMessage() { return message; }
-        public void setMessage(String message) { this.message = message; }
-    }
-
-    // Main method for testing
-    public static void main(String[] args) {
-        try {
-            GrubtechOrderStatusService service = new GrubtechOrderStatusService();
-
-            String orderId = "{{ORDER_ID}}";
-            OrderStatus newStatus = OrderStatus.PREPARING; // Change to {{NEW_STATUS}}
-
-            // Single status update
-            service.updateOrderStatus(orderId, newStatus, "Status update from POS");
-
-            // Or run through full workflow
-            // service.orderWorkflowExample(orderId);
-
-        } catch (Exception e) {
-            System.exit(1);
-        }
-    }
-}

package/templates/update_order_status/python.template

@@ -1,142 +0,0 @@
-"""
-Grubtech Order Status Update - Python
-
-This example demonstrates how to update order status in Grubtech.
-
-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
-- {{ORDER_ID}}: The Grubtech order ID to update
-- {{NEW_STATUS}}: The new status value
-"""
-
-import requests
-import sys
-from datetime import datetime
-from enum import Enum
-from typing import Dict, Any, Optional
-
-AUTH_TOKEN = '{{AUTH_TOKEN}}'
-BASE_URL = 'https://api.grubtech.io'
-
-
-class OrderStatus(Enum):
-    """Valid order status values"""
-    ACCEPTED = 'accepted'
-    PREPARING = 'preparing'
-    READY = 'ready'
-    DELIVERED = 'delivered'
-    CANCELLED = 'cancelled'
-
-
-def update_order_status(
-    order_id: str,
-    new_status: OrderStatus,
-    notes: Optional[str] = None
-) -> Dict[str, Any]:
-    """
-    Update order status in Grubtech
-
-    Args:
-        order_id: The Grubtech order ID
-        new_status: The new status value
-        notes: Optional notes about the status change
-
-    Returns:
-        Dict: Response from API
-
-    Raises:
-        Exception: If status update fails
-    """
-    try:
-        # Construct status update payload
-        payload = {
-            'orderId': order_id,
-            'status': new_status.value,
-            'timestamp': datetime.utcnow().isoformat() + 'Z',
-        }
-
-        if notes:
-            payload['notes'] = notes
-
-        print(f'Updating order {order_id} to status: {new_status.value}')
-
-        # Make status update request
-        url = f'{BASE_URL}/v1/orders/{order_id}/status'
-        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'Status update failed: {response.status_code} - {response.text}'
-            )
-
-        # Parse response
-        data = response.json()
-
-        print(f'✅ Order status updated successfully!')
-        print(f'Order ID: {data["orderId"]}')
-        print(f'New Status: {data["status"]}')
-        print(f'Updated At: {data["updatedAt"]}')
-
-        return data
-
-    except requests.RequestException as e:
-        print(f'❌ Status update error: {e}', file=sys.stderr)
-        raise
-    except Exception as e:
-        print(f'❌ Unexpected error: {e}', file=sys.stderr)
-        raise
-
-
-def order_workflow_example(order_id: str) -> None:
-    """
-    Example: Update order through typical workflow
-
-    Args:
-        order_id: The Grubtech order ID
-    """
-    try:
-        # Step 1: Accept the order
-        update_order_status(order_id, OrderStatus.ACCEPTED, 'Order confirmed')
-
-        # Step 2: Start preparing
-        update_order_status(order_id, OrderStatus.PREPARING, 'Chef started cooking')
-
-        # Step 3: Mark as ready
-        update_order_status(order_id, OrderStatus.READY, 'Order ready for pickup')
-
-        # Step 4: Mark as delivered
-        update_order_status(order_id, OrderStatus.DELIVERED, 'Order delivered to customer')
-
-        print('✅ Order workflow completed!')
-
-    except Exception as e:
-        print(f'❌ Workflow error: {e}', file=sys.stderr)
-
-        # If something goes wrong, cancel the order
-        update_order_status(order_id, OrderStatus.CANCELLED, 'Unable to fulfill order')
-
-
-if __name__ == '__main__':
-    try:
-        order_id = '{{ORDER_ID}}'
-        new_status = OrderStatus.PREPARING  # Change to {{NEW_STATUS}}
-
-        # Single status update
-        update_order_status(order_id, new_status, 'Status update from POS')
-
-        # Or run through full workflow
-        # order_workflow_example(order_id)
-
-    except Exception as e:
-        sys.exit(1)