square_sandbox_simulator 0.1.0

data/lib/square_sandbox_simulator/configuration.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+module SquareSandboxSimulator
+  class Configuration
+    attr_accessor :location_id, :location_name, :access_token, :environment, :square_version,
+                  :log_level, :tax_rate, :business_type, :database_url, :location_timezone
+
+    # Default timezone if not fetched from Square
+    DEFAULT_TIMEZONE = "America/Los_Angeles"
+
+    # Path to locations JSON file
+    LOCATIONS_FILE = File.join(File.dirname(__FILE__), "..", "..", ".env.json")
+
+    def initialize
+      @location_id      = ENV.fetch("SQUARE_LOCATION_ID", nil)
+      @location_name    = ENV.fetch("SQUARE_LOCATION_NAME", nil)
+      @access_token     = ENV.fetch("SQUARE_ACCESS_TOKEN", nil)
+      @environment      = normalize_url(ENV.fetch("SQUARE_ENVIRONMENT", "https://connect.squareupsandbox.com/"))
+      @square_version   = ENV.fetch("SQUARE_VERSION", "2024-01-18")
+      @log_level        = parse_log_level(ENV.fetch("LOG_LEVEL", "INFO"))
+      @tax_rate         = ENV.fetch("TAX_RATE", "8.25").to_f
+      @business_type    = ENV.fetch("BUSINESS_TYPE", "restaurant").to_sym
+      @database_url     = ENV.fetch("DATABASE_URL", nil)
+
+      # Load from .env.json if location_id not set in ENV
+      load_from_locations_file if @location_id.nil? || @location_id.empty?
+    end
+
+    # Load configuration for a specific location from .env.json
+    #
+    # @param location_id [String, nil] Location ID to load (nil for first location)
+    # @param index [Integer, nil] Index of location in the list (0-based)
+    # @return [self]
+    def load_location(location_id: nil, index: nil)
+      locations = load_locations_file
+      return self if locations.empty?
+
+      location = if location_id
+                   locations.find { |l| l["SQUARE_LOCATION_ID"] == location_id }
+                 elsif index
+                   locations[index]
+                 else
+                   locations.first
+                 end
+
+      if location
+        apply_location_config(location)
+        logger.info "Loaded location: #{@location_name} (#{@location_id})"
+      else
+        logger.warn "Location not found: #{location_id || "index #{index}"}"
+      end
+
+      self
+    end
+
+    # List all available locations from .env.json
+    #
+    # @return [Array<Hash>] Array of location configs
+    def available_locations
+      load_locations_file.map do |l|
+        {
+          id: l["SQUARE_LOCATION_ID"],
+          name: l["SQUARE_LOCATION_NAME"],
+        }
+      end
+    end
+
+    def validate!
+      raise ConfigurationError, "SQUARE_LOCATION_ID is required" if location_id.nil? || location_id.empty?
+      raise ConfigurationError, "SQUARE_ACCESS_TOKEN is required" if access_token.nil? || access_token.empty?
+
+      true
+    end
+
+    def logger
+      @logger ||= Logger.new($stdout).tap do |log|
+        log.level = @log_level
+        log.formatter = proc do |severity, datetime, _progname, msg|
+          timestamp = datetime.strftime("%Y-%m-%d %H:%M:%S")
+          "[#{timestamp}] #{severity.ljust(5)} | #{msg}\n"
+        end
+      end
+    end
+
+    # Fetch location timezone from Square API
+    # @return [String] IANA timezone identifier (e.g., "America/Los_Angeles")
+    def fetch_location_timezone
+      return @location_timezone if @location_timezone
+
+      require "rest-client"
+      require "json"
+
+      url = "#{environment}v2/locations/#{location_id}"
+      response = RestClient.get(url, {
+                                  Authorization: "Bearer #{access_token}",
+                                  "Square-Version": square_version,
+                                  "Content-Type": "application/json",
+                                })
+      data = JSON.parse(response.body)
+
+      @location_timezone = data.dig("location", "timezone") || DEFAULT_TIMEZONE
+      logger.info "Location timezone: #{@location_timezone}"
+      @location_timezone
+    rescue StandardError => e
+      logger.warn "Failed to fetch location timezone: #{e.message}. Using default: #{DEFAULT_TIMEZONE}"
+      @location_timezone = DEFAULT_TIMEZONE
+    end
+
+    # Get current time in location's timezone
+    # @return [Time] Current time in location timezone
+    def merchant_time_now
+      require "time"
+      tz = fetch_location_timezone
+      begin
+        require "tzinfo"
+        TZInfo::Timezone.get(tz).now
+      rescue LoadError
+        old_tz = ENV.fetch("TZ", nil)
+        ENV["TZ"] = tz
+        time = Time.now
+        ENV["TZ"] = old_tz
+        time
+      end
+    end
+
+    # Get today's date in location's timezone
+    # @return [Date] Today's date in location timezone
+    def merchant_date_today
+      merchant_time_now.to_date
+    end
+
+    private
+
+    def load_from_locations_file
+      locations = load_locations_file
+      return if locations.empty?
+
+      # Use first location by default
+      apply_location_config(locations.first)
+    end
+
+    # Parse .env.json, supporting both the legacy array format and the
+    # new object format: { "DATABASE_URL": "...", "locations": [...] }
+    def load_locations_file
+      return [] unless File.exist?(LOCATIONS_FILE)
+
+      data = JSON.parse(File.read(LOCATIONS_FILE))
+      return data if data.is_a?(Array) # legacy format
+
+      # New object format -- extract locations list
+      data.fetch("locations", [])
+    rescue JSON::ParserError => e
+      warn "Failed to parse #{LOCATIONS_FILE}: #{e.message}"
+      []
+    end
+
+    # Read the top-level DATABASE_URL from .env.json (new object format only).
+    # Returns nil when the file uses the legacy array format or has no key.
+    #
+    # @return [String, nil] The DATABASE_URL or nil
+    def self.database_url_from_file
+      return nil unless File.exist?(LOCATIONS_FILE)
+
+      data = JSON.parse(File.read(LOCATIONS_FILE))
+      return nil if data.is_a?(Array)
+
+      data["DATABASE_URL"]
+    rescue JSON::ParserError
+      nil
+    end
+
+    def apply_location_config(location)
+      @location_id   = location["SQUARE_LOCATION_ID"]
+      @location_name = location["SQUARE_LOCATION_NAME"]
+      @access_token  = location["SQUARE_ACCESS_TOKEN"] unless location["SQUARE_ACCESS_TOKEN"].to_s.empty?
+    end
+
+    def normalize_url(url)
+      url = url.strip
+      url.end_with?("/") ? url : "#{url}/"
+    end
+
+    def parse_log_level(level)
+      case level.to_s.upcase
+      when "DEBUG" then Logger::DEBUG
+      when "WARN"  then Logger::WARN
+      when "ERROR" then Logger::ERROR
+      when "FATAL" then Logger::FATAL
+      else Logger::INFO # default for "INFO" and unrecognized levels
+      end
+    end
+  end
+end

data/lib/square_sandbox_simulator/data/cafe_bakery/categories.json

@@ -0,0 +1,54 @@
+{
+  "categories": [
+    {
+      "name": "Coffee & Espresso",
+      "sort_order": 1,
+      "description": "Hot and cold coffee drinks"
+    },
+    {
+      "name": "Pastries & Baked Goods",
+      "sort_order": 2,
+      "description": "Freshly baked daily"
+    },
+    {
+      "name": "Breakfast",
+      "sort_order": 3,
+      "description": "Morning plates and bowls"
+    },
+    {
+      "name": "Sandwiches & Wraps",
+      "sort_order": 4,
+      "description": "Lunch staples"
+    },
+    {
+      "name": "Smoothies & Juices",
+      "sort_order": 5,
+      "description": "Blended drinks and fresh-pressed juices"
+    },
+    {
+      "name": "Coffee & Espresso",
+      "sort_order": 6,
+      "description": "More coffee drinks (duplicate category)"
+    },
+    {
+      "name": "Pastries & Baked Goods",
+      "sort_order": 7,
+      "description": "Pastries imported from integration"
+    },
+    {
+      "name": "Breakfast",
+      "sort_order": 8,
+      "description": "Weekend brunch specials (stale copy)"
+    },
+    {
+      "name": "Drinks",
+      "sort_order": 9,
+      "description": "All drinks catch-all"
+    },
+    {
+      "name": "Grab & Go",
+      "sort_order": 10,
+      "description": "Pre-packaged items for takeout"
+    }
+  ]
+}

data/lib/square_sandbox_simulator/data/cafe_bakery/combos.json

@@ -0,0 +1,33 @@
+{
+  "combos": [
+    {
+      "id": "coffee_pastry_combo",
+      "name": "Coffee & Pastry Combo",
+      "description": "Any coffee + any pastry for $5.99",
+      "combo_price": 599,
+      "required_categories": ["Coffee & Espresso", "Pastries & Baked Goods"],
+      "max_items_per_category": 1,
+      "active": true
+    },
+    {
+      "id": "breakfast_combo",
+      "name": "Breakfast Combo",
+      "description": "Any breakfast plate + any coffee or juice for $12.99",
+      "combo_price": 1299,
+      "required_categories": ["Breakfast", "Coffee & Espresso"],
+      "alternative_categories": { "Coffee & Espresso": ["Smoothies & Juices"] },
+      "max_items_per_category": 1,
+      "active": true
+    },
+    {
+      "id": "lunch_combo",
+      "name": "Lunch Deal",
+      "description": "Any sandwich + any drink for $13.99",
+      "combo_price": 1399,
+      "required_categories": ["Sandwiches & Wraps", "Drinks"],
+      "alternative_categories": { "Drinks": ["Smoothies & Juices", "Coffee & Espresso"] },
+      "max_items_per_category": 1,
+      "active": true
+    }
+  ]
+}

data/lib/square_sandbox_simulator/data/cafe_bakery/coupon_codes.json

@@ -0,0 +1,133 @@
+{
+  "coupon_codes": [
+    {
+      "code": "COFFEE10",
+      "name": "Coffee Lover",
+      "description": "10% off any coffee drink",
+      "discount_type": "percentage",
+      "discount_value": 10,
+      "min_order_amount": 0,
+      "max_discount_amount": null,
+      "valid_from": "2024-01-01T00:00:00Z",
+      "valid_until": "2027-12-31T23:59:59Z",
+      "usage_limit": null,
+      "usage_count": 0,
+      "single_use_per_customer": false,
+      "stackable": false,
+      "applicable_categories": ["Coffee & Espresso"],
+      "excluded_categories": null,
+      "active": true
+    },
+    {
+      "code": "WELCOME20",
+      "name": "New Customer Welcome",
+      "description": "20% off for new customers",
+      "discount_type": "percentage",
+      "discount_value": 20,
+      "min_order_amount": 0,
+      "max_discount_amount": 1000,
+      "valid_from": "2024-01-01T00:00:00Z",
+      "valid_until": "2027-12-31T23:59:59Z",
+      "usage_limit": null,
+      "usage_count": 0,
+      "single_use_per_customer": true,
+      "new_customers_only": true,
+      "stackable": false,
+      "applicable_categories": null,
+      "excluded_categories": null,
+      "active": true
+    },
+    {
+      "code": "FIVER",
+      "name": "$5 Off",
+      "description": "$5 off orders $20 or more",
+      "discount_type": "fixed",
+      "discount_value": 500,
+      "min_order_amount": 2000,
+      "max_discount_amount": null,
+      "valid_from": "2024-01-01T00:00:00Z",
+      "valid_until": "2027-12-31T23:59:59Z",
+      "usage_limit": null,
+      "usage_count": 0,
+      "single_use_per_customer": false,
+      "stackable": false,
+      "applicable_categories": null,
+      "excluded_categories": null,
+      "active": true
+    },
+    {
+      "code": "BRUNCH15",
+      "name": "Brunch Special",
+      "description": "15% off breakfast items on weekends",
+      "discount_type": "percentage",
+      "discount_value": 15,
+      "min_order_amount": 0,
+      "max_discount_amount": null,
+      "valid_from": "2024-01-01T00:00:00Z",
+      "valid_until": "2027-12-31T23:59:59Z",
+      "usage_limit": null,
+      "usage_count": 0,
+      "single_use_per_customer": false,
+      "day_restricted": true,
+      "valid_days": [0, 6],
+      "stackable": false,
+      "applicable_categories": ["Breakfast"],
+      "excluded_categories": null,
+      "active": true
+    },
+    {
+      "code": "FREEPASTRY",
+      "name": "Free Pastry",
+      "description": "Free pastry with any coffee order over $5",
+      "discount_type": "percentage",
+      "discount_value": 100,
+      "min_order_amount": 500,
+      "max_discount_amount": 499,
+      "valid_from": "2024-01-01T00:00:00Z",
+      "valid_until": "2027-12-31T23:59:59Z",
+      "usage_limit": 200,
+      "usage_count": 34,
+      "single_use_per_customer": true,
+      "stackable": false,
+      "applicable_categories": ["Pastries & Baked Goods"],
+      "excluded_categories": null,
+      "active": true
+    },
+    {
+      "code": "EXPIRED10",
+      "name": "Expired Code",
+      "description": "This code has expired (for testing)",
+      "discount_type": "percentage",
+      "discount_value": 10,
+      "min_order_amount": 0,
+      "max_discount_amount": null,
+      "valid_from": "2023-01-01T00:00:00Z",
+      "valid_until": "2023-12-31T23:59:59Z",
+      "usage_limit": null,
+      "usage_count": 0,
+      "single_use_per_customer": false,
+      "stackable": false,
+      "applicable_categories": null,
+      "excluded_categories": null,
+      "active": true
+    },
+    {
+      "code": "INACTIVE",
+      "name": "Inactive Code",
+      "description": "This code is inactive (for testing)",
+      "discount_type": "percentage",
+      "discount_value": 10,
+      "min_order_amount": 0,
+      "max_discount_amount": null,
+      "valid_from": "2024-01-01T00:00:00Z",
+      "valid_until": "2027-12-31T23:59:59Z",
+      "usage_limit": null,
+      "usage_count": 0,
+      "single_use_per_customer": false,
+      "stackable": false,
+      "applicable_categories": null,
+      "excluded_categories": null,
+      "active": false
+    }
+  ]
+}

data/lib/square_sandbox_simulator/data/cafe_bakery/discounts.json

@@ -0,0 +1,113 @@
+{
+  "discounts": [
+    {
+      "id": "morning_rush",
+      "name": "Morning Rush",
+      "percentage": 10,
+      "description": "10% off before 8 AM",
+      "type": "time_based",
+      "time_rules": { "start_hour": 6, "end_hour": 8 },
+      "auto_apply": true
+    },
+    {
+      "id": "happy_hour_cafe",
+      "name": "Afternoon Happy Hour",
+      "percentage": 15,
+      "description": "15% off drinks from 2-4 PM",
+      "type": "time_based",
+      "time_rules": { "start_hour": 14, "end_hour": 16 },
+      "auto_apply": true
+    },
+    {
+      "id": "student_discount",
+      "name": "Student Discount",
+      "percentage": 10,
+      "description": "10% off with student ID",
+      "type": "customer",
+      "auto_apply": false
+    },
+    {
+      "id": "employee_discount",
+      "name": "Employee Discount",
+      "percentage": 30,
+      "description": "30% off for employees",
+      "type": "customer",
+      "auto_apply": false
+    },
+    {
+      "id": "two_off_pastry",
+      "name": "$2 Off Pastry",
+      "amount": 200,
+      "description": "$2 off any pastry with coffee purchase",
+      "type": "line_item",
+      "applicable_categories": ["Pastries & Baked Goods"],
+      "requires_category": ["Coffee & Espresso"],
+      "auto_apply": false
+    },
+    {
+      "id": "five_off",
+      "name": "$5 Off",
+      "amount": 500,
+      "description": "$5 off orders over $25",
+      "type": "threshold",
+      "min_order_amount": 2500,
+      "auto_apply": false
+    },
+    {
+      "id": "ten_off",
+      "name": "$10 Off",
+      "amount": 1000,
+      "description": "$10 off orders over $50",
+      "type": "threshold",
+      "min_order_amount": 5000,
+      "auto_apply": false
+    },
+    {
+      "id": "loyalty_bronze",
+      "name": "Loyalty - Bronze",
+      "percentage": 5,
+      "description": "5% off for 10+ visits",
+      "type": "loyalty",
+      "min_visits": 10,
+      "auto_apply": true
+    },
+    {
+      "id": "loyalty_silver",
+      "name": "Loyalty - Silver",
+      "percentage": 10,
+      "description": "10% off for 25+ visits",
+      "type": "loyalty",
+      "min_visits": 25,
+      "auto_apply": true
+    },
+    {
+      "id": "loyalty_gold",
+      "name": "Loyalty - Gold",
+      "percentage": 15,
+      "description": "15% off for 50+ visits",
+      "type": "loyalty",
+      "min_visits": 50,
+      "auto_apply": true
+    },
+    {
+      "id": "first_order",
+      "name": "First Order Discount",
+      "percentage": 15,
+      "description": "15% off your first order",
+      "type": "loyalty",
+      "min_visits": 0,
+      "max_visits": 1,
+      "auto_apply": true
+    },
+    {
+      "id": "smoothie_half_off",
+      "name": "Smoothie 50% Off",
+      "percentage": 50,
+      "description": "50% off any smoothie with breakfast purchase",
+      "type": "line_item",
+      "applicable_categories": ["Smoothies & Juices"],
+      "requires_category": ["Breakfast"],
+      "auto_apply": false
+    }
+  ]
+}

data/lib/square_sandbox_simulator/data/cafe_bakery/items.json

@@ -0,0 +1,55 @@
+{
+  "items": [
+    { "name": "House Drip Coffee", "price": 299, "category": "Coffee & Espresso", "category_sort_order": 1, "sku": "CAFE-COF-001" },
+    { "name": "Espresso", "price": 349, "category": "Coffee & Espresso", "category_sort_order": 1, "sku": "CAFE-COF-002" },
+    { "name": "Cappuccino", "price": 499, "category": "Coffee & Espresso", "category_sort_order": 1, "sku": "CAFE-COF-003" },
+    { "name": "Latte", "price": 549, "category": "Coffee & Espresso", "category_sort_order": 1, "sku": "CAFE-COF-004" },
+    { "name": "Cold Brew", "price": 499, "category": "Coffee & Espresso", "category_sort_order": 1, "sku": "CAFE-COF-005" },
+
+    { "name": "Butter Croissant", "price": 399, "category": "Pastries & Baked Goods", "category_sort_order": 2, "sku": "CAFE-PAS-001" },
+    { "name": "Blueberry Muffin", "price": 349, "category": "Pastries & Baked Goods", "category_sort_order": 2, "sku": "CAFE-PAS-002" },
+    { "name": "Cinnamon Roll", "price": 449, "category": "Pastries & Baked Goods", "category_sort_order": 2, "sku": "CAFE-PAS-003" },
+    { "name": "Chocolate Chip Cookie", "price": 299, "category": "Pastries & Baked Goods", "category_sort_order": 2, "sku": "CAFE-PAS-004" },
+
+    { "name": "Avocado Toast", "price": 999, "category": "Breakfast", "category_sort_order": 3, "sku": "CAFE-BRK-001" },
+    { "name": "Breakfast Burrito", "price": 899, "category": "Breakfast", "category_sort_order": 3, "sku": "CAFE-BRK-002" },
+    { "name": "Açaí Bowl", "price": 1199, "category": "Breakfast", "category_sort_order": 3, "sku": "CAFE-BRK-003" },
+    { "name": "Yogurt Parfait", "price": 699, "category": "Breakfast", "category_sort_order": 3, "sku": "CAFE-BRK-004" },
+
+    { "name": "Turkey Club", "price": 1099, "category": "Sandwiches & Wraps", "category_sort_order": 4, "sku": "CAFE-SAN-001" },
+    { "name": "Caprese Panini", "price": 999, "category": "Sandwiches & Wraps", "category_sort_order": 4, "sku": "CAFE-SAN-002" },
+    { "name": "Chicken Caesar Wrap", "price": 1049, "category": "Sandwiches & Wraps", "category_sort_order": 4, "sku": "CAFE-SAN-003" },
+    { "name": "BLT", "price": 899, "category": "Sandwiches & Wraps", "category_sort_order": 4, "sku": "CAFE-SAN-004" },
+
+    { "name": "Berry Blast Smoothie", "price": 699, "category": "Smoothies & Juices", "category_sort_order": 5, "sku": "CAFE-SMO-001" },
+    { "name": "Green Detox Juice", "price": 749, "category": "Smoothies & Juices", "category_sort_order": 5, "sku": "CAFE-SMO-002" },
+    { "name": "Mango Tango Smoothie", "price": 699, "category": "Smoothies & Juices", "category_sort_order": 5, "sku": "CAFE-SMO-003" },
+    { "name": "Fresh-Squeezed OJ", "price": 499, "category": "Smoothies & Juices", "category_sort_order": 5, "sku": "CAFE-SMO-004" },
+
+    { "name": "House Drip Coffee", "price": 350, "category": "Coffee & Espresso", "category_sort_order": 6, "sku": "CAFE-COF2-001" },
+    { "name": "Latte", "price": 599, "category": "Coffee & Espresso", "category_sort_order": 6, "sku": "CAFE-COF2-002" },
+    { "name": "Iced Latte", "price": 599, "category": "Coffee & Espresso", "category_sort_order": 6, "sku": "CAFE-COF2-003" },
+    { "name": "Matcha Latte", "price": 649, "category": "Coffee & Espresso", "category_sort_order": 6, "sku": "CAFE-COF2-004" },
+
+    { "name": "Butter Croissant", "price": 450, "category": "Pastries & Baked Goods", "category_sort_order": 7, "sku": "CAFE-PAS2-001" },
+    { "name": "Blueberry Muffin", "price": 349, "category": "Pastries & Baked Goods", "category_sort_order": 7, "sku": "CAFE-PAS2-002" },
+    { "name": "Almond Croissant", "price": 499, "category": "Pastries & Baked Goods", "category_sort_order": 7, "sku": "CAFE-PAS2-003" },
+    { "name": "Banana Bread", "price": 399, "category": "Pastries & Baked Goods", "category_sort_order": 7, "sku": "CAFE-PAS2-004" },
+
+    { "name": "Avocado Toast", "price": 1099, "category": "Breakfast", "category_sort_order": 8, "sku": "CAFE-BRK2-001" },
+    { "name": "Eggs Benedict", "price": 1399, "category": "Breakfast", "category_sort_order": 8, "sku": "CAFE-BRK2-002" },
+    { "name": "French Toast", "price": 1199, "category": "Breakfast", "category_sort_order": 8, "sku": "CAFE-BRK2-003" },
+
+    { "name": "House Drip Coffee", "price": 275, "category": "Drinks", "category_sort_order": 9, "sku": "CAFE-DRK-001" },
+    { "name": "Iced Tea", "price": 349, "category": "Drinks", "category_sort_order": 9, "sku": "CAFE-DRK-002" },
+    { "name": "Lemonade", "price": 399, "category": "Drinks", "category_sort_order": 9, "sku": "CAFE-DRK-003" },
+    { "name": "Hot Chocolate", "price": 449, "category": "Drinks", "category_sort_order": 9, "sku": "CAFE-DRK-004" },
+    { "name": "Berry Blast Smoothie", "price": 749, "category": "Drinks", "category_sort_order": 9, "sku": "CAFE-DRK-005" },
+
+    { "name": "Butter Croissant", "price": 399, "category": "Grab & Go", "category_sort_order": 10, "sku": "CAFE-GNG-001" },
+    { "name": "Blueberry Muffin", "price": 399, "category": "Grab & Go", "category_sort_order": 10, "sku": "CAFE-GNG-002" },
+    { "name": "BLT", "price": 899, "category": "Grab & Go", "category_sort_order": 10, "sku": "CAFE-GNG-003" },
+    { "name": "Yogurt Parfait", "price": 599, "category": "Grab & Go", "category_sort_order": 10, "sku": "CAFE-GNG-004" },
+    { "name": "Cold Brew", "price": 499, "category": "Grab & Go", "category_sort_order": 10, "sku": "CAFE-GNG-005" }
+  ]
+}

data/lib/square_sandbox_simulator/data/cafe_bakery/modifiers.json

@@ -0,0 +1,73 @@
+{
+  "modifier_groups": [
+    {
+      "name": "Milk Choice",
+      "min_required": 0,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "Whole Milk", "price": 0 },
+        { "name": "Oat Milk", "price": 75 },
+        { "name": "Almond Milk", "price": 75 },
+        { "name": "Soy Milk", "price": 50 },
+        { "name": "Coconut Milk", "price": 75 }
+      ]
+    },
+    {
+      "name": "Espresso Shots",
+      "min_required": 0,
+      "max_allowed": 3,
+      "modifiers": [
+        { "name": "Extra Shot", "price": 100 },
+        { "name": "Double Shot", "price": 200 },
+        { "name": "Decaf Shot", "price": 0 }
+      ]
+    },
+    {
+      "name": "Flavor Add-Ins",
+      "min_required": 0,
+      "max_allowed": 3,
+      "modifiers": [
+        { "name": "Vanilla Syrup", "price": 75 },
+        { "name": "Caramel Syrup", "price": 75 },
+        { "name": "Hazelnut Syrup", "price": 75 },
+        { "name": "Mocha Syrup", "price": 75 },
+        { "name": "Lavender Syrup", "price": 100 },
+        { "name": "Sugar-Free Vanilla", "price": 75 }
+      ]
+    },
+    {
+      "name": "Size",
+      "min_required": 1,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "Small (8oz)", "price": 0 },
+        { "name": "Medium (12oz)", "price": 50 },
+        { "name": "Large (16oz)", "price": 100 }
+      ]
+    },
+    {
+      "name": "Bread Choice",
+      "min_required": 1,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "Sourdough", "price": 0 },
+        { "name": "Multigrain", "price": 0 },
+        { "name": "Ciabatta", "price": 0 },
+        { "name": "Gluten-Free Bread", "price": 150 },
+        { "name": "Croissant", "price": 100 }
+      ]
+    },
+    {
+      "name": "Smoothie Boosts",
+      "min_required": 0,
+      "max_allowed": 3,
+      "modifiers": [
+        { "name": "Protein Powder", "price": 150 },
+        { "name": "Chia Seeds", "price": 75 },
+        { "name": "Flax Seeds", "price": 75 },
+        { "name": "Spirulina", "price": 100 },
+        { "name": "Collagen Peptides", "price": 150 }
+      ]
+    }
+  ]
+}