clover_sandbox_simulator 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7cbba3e7549afdbb163ab890407d2627bc9fda35641bf4b56395d11ff36a89c6
-  data.tar.gz: a97d72dc86001e853542ca055142f788b00c79f15c60f5bb13cd662b56c5a4e1
+  metadata.gz: 74de5928a11de82d6c3b389aec6fd92a4c63844eb55ad22bbfafecb805e4aca8
+  data.tar.gz: 2f11d97b104c0a58a37266b9792157d497ed30ff10fd39bb7bca964239893dc9
 SHA512:
-  metadata.gz: f2c979158af6fea16d2d603583a2079ab63eaf6506922baa5c4885d2467c7d828edf140ddd9297657f9735d8ac46bb1ca15ebb1087c4d45d77d4572ef0ebc354
-  data.tar.gz: c3247b3bbd45f6b2cff03453c7a63b7594a80450f36e4d94d2e832579812231a0c3a61db89fc7841312fbbae258e488cc0fa4a54be4e96a4f1cdab28ecbdc59e
+  metadata.gz: 5ff02a1e8a9e90d8230c6af743887851e65c0eb266f9574571cdbcc3e973f06c719abb5fa64b164cdc14b473ee48355f0f822149ba89a0c543c36afa5b97eb68
+  data.tar.gz: 2ae75ceca9d7d77e762fa5fbb94361cd85bea8bdd3e4b8a8c15bc9461aa228f941096e7c079d681bbce4722068b068ecae27496562875fc9019e715dfe8e1167

data/README.md

@@ -160,6 +160,14 @@ Run a full simulation (setup + generate orders):
 ./bin/simulate cash_open_drawer -a 10000     # Open drawer with $100 starting cash
 ./bin/simulate cash_close_drawer -e EMP_ID   # Close drawer for employee
 
+# List recent orders
+./bin/simulate orders
+./bin/simulate orders -l 50              # Show 50 orders
+
+# Reset orders (delete all orders, keep menu/employees)
+./bin/simulate reset_orders --confirm    # Delete today's orders
+./bin/simulate reset_orders --confirm --no-today-only  # Delete ALL orders
+
 # Delete all entities (requires confirmation)
 ./bin/simulate delete --confirm
 

data/bin/simulate

@@ -167,6 +167,79 @@ module CloverSandboxSimulator
       puts "\n✅ All entities deleted!"
     end
 
+    desc "reset_orders", "Delete all orders (keeps menu items, employees, etc.)"
+    option :confirm, type: :boolean, desc: "Confirm deletion"
+    option :today_only, type: :boolean, default: true, desc: "Only delete today's orders (default: true)"
+    def reset_orders
+      unless options[:confirm]
+        puts "⚠️  This will delete all orders from Clover!"
+        puts "   Your menu items, employees, customers, and other entities will be kept."
+        puts "   Run with --confirm to proceed."
+        return
+      end
+
+      configure_logging
+
+      puts "🗑️  Clover Sandbox Simulator - Reset Orders"
+      puts "=" * 50
+
+      services = Services::Clover::ServicesManager.new
+
+      # First, show what will be deleted
+      if options[:today_only]
+        puts "Deleting today's orders..."
+        count = services.order.delete_orders_since
+      else
+        puts "Deleting ALL orders..."
+        count = services.order.delete_all_orders
+      end
+
+      puts "\n✅ Deleted #{count} orders!"
+      puts "   Your menu, employees, and customers are still intact."
+      puts "   Run 'simulate generate' to create new orders."
+    end
+
+    desc "orders", "List recent orders"
+    option :limit, type: :numeric, aliases: "-l", default: 20, desc: "Number of orders to show"
+    def orders
+      configure_logging
+
+      puts "📋 Clover Sandbox Simulator - Recent Orders"
+      puts "=" * 50
+
+      services = Services::Clover::ServicesManager.new
+      orders = services.order.get_orders(limit: options[:limit])
+
+      if orders.empty?
+        puts "No orders found."
+        puts "\nRun 'simulate generate' to create orders."
+        return
+      end
+
+      puts "\nFound #{orders.size} orders:\n\n"
+
+      total_revenue = 0
+      orders.each do |order|
+        created = order["createdTime"] ? Time.at(order["createdTime"] / 1000).strftime("%H:%M:%S") : "N/A"
+        total = order["total"] || 0
+        total_revenue += total
+        state = order["state"] || "unknown"
+        title = order["title"] || "Order"
+
+        state_emoji = case state
+                      when "open" then "🟡"
+                      when "locked" then "🔒"
+                      when "paid" then "✅"
+                      else "⚪"
+                      end
+
+        puts "#{state_emoji} #{title} | $#{'%.2f' % (total / 100.0)} | #{created} | #{order['id']}"
+      end
+
+      puts "\n" + "-" * 50
+      puts "Total: $#{'%.2f' % (total_revenue / 100.0)} across #{orders.size} orders"
+    end
+
     desc "status", "Show current Clover merchant status"
     def status
       configure_logging

data/lib/clover_sandbox_simulator/configuration.rb

@@ -4,7 +4,10 @@ module CloverSandboxSimulator
   class Configuration
     attr_accessor :merchant_id, :merchant_name, :api_token, :environment, :log_level, :tax_rate, :business_type,
                   :public_token, :private_token, :ecommerce_environment, :tokenizer_environment,
-                  :app_id, :app_secret, :refresh_token
+                  :app_id, :app_secret, :refresh_token, :merchant_timezone
+
+    # Default timezone if not fetched from Clover
+    DEFAULT_TIMEZONE = "America/Los_Angeles"
 
     # Path to merchants JSON file
     MERCHANTS_FILE = File.join(File.dirname(__FILE__), "..", "..", ".env.json")
@@ -124,6 +127,51 @@ module CloverSandboxSimulator
       end
     end
 
+    # Fetch merchant timezone from Clover API
+    # @return [String] IANA timezone identifier (e.g., "America/Los_Angeles")
+    def fetch_merchant_timezone
+      return @merchant_timezone if @merchant_timezone
+
+      require "rest-client"
+      require "json"
+
+      url = "#{environment}v3/merchants/#{merchant_id}?expand=properties"
+      response = RestClient.get(url, { Authorization: "Bearer #{api_token}" })
+      data = JSON.parse(response.body)
+
+      @merchant_timezone = data.dig("properties", "timezone") || DEFAULT_TIMEZONE
+      logger.info "Merchant timezone: #{@merchant_timezone}"
+      @merchant_timezone
+    rescue StandardError => e
+      logger.warn "Failed to fetch merchant timezone: #{e.message}. Using default: #{DEFAULT_TIMEZONE}"
+      @merchant_timezone = DEFAULT_TIMEZONE
+    end
+
+    # Get current time in merchant's timezone
+    # @return [Time] Current time in merchant timezone
+    def merchant_time_now
+      require "time"
+      tz = fetch_merchant_timezone
+      # Use TZInfo if available, otherwise use ENV['TZ'] trick
+      begin
+        require "tzinfo"
+        TZInfo::Timezone.get(tz).now
+      rescue LoadError
+        # Fallback: temporarily set TZ environment variable
+        old_tz = ENV["TZ"]
+        ENV["TZ"] = tz
+        time = Time.now
+        ENV["TZ"] = old_tz
+        time
+      end
+    end
+
+    # Get today's date in merchant's timezone
+    # @return [Date] Today's date in merchant timezone
+    def merchant_date_today
+      merchant_time_now.to_date
+    end
+
     private
 
     def load_from_merchants_file

data/lib/clover_sandbox_simulator/generators/order_generator.rb

@@ -89,7 +89,12 @@ module CloverSandboxSimulator
       end
 
       # Generate a realistic day of restaurant operations
-      def generate_realistic_day(date: Date.today, multiplier: 1.0, simulated_time: nil)
+      # @param date [Date] Date to generate orders for (defaults to today in merchant timezone)
+      # @param multiplier [Float] Multiplier for order count (0.5 = slow day, 2.0 = busy day)
+      # @param simulated_time [Time] Override time for all orders (for testing)
+      def generate_realistic_day(date: nil, multiplier: 1.0, simulated_time: nil)
+        # Use merchant timezone for "today"
+        date ||= config.merchant_date_today
         count = (order_count_for_date(date) * multiplier).to_i
 
         logger.info "=" * 60
@@ -208,11 +213,13 @@ module CloverSandboxSimulator
       end
 
       # Generate orders for today (simple mode)
+      # Uses merchant timezone for "today"
       def generate_today(count: nil)
+        today = config.merchant_date_today
         if count
-          generate_for_date(Date.today, count: count)
+          generate_for_date(today, count: count)
         else
-          generate_realistic_day
+          generate_realistic_day(date: today)
         end
       end
 
@@ -357,7 +364,17 @@ module CloverSandboxSimulator
         hours = MEAL_PERIODS[period][:hours]
         hour = rand(hours)
         minute = rand(60)
-        Time.new(date.year, date.month, date.day, hour, minute, 0)
+
+        # Use merchant timezone for generating order times
+        tz_identifier = config.fetch_merchant_timezone
+        begin
+          require "tzinfo"
+          tz = TZInfo::Timezone.get(tz_identifier)
+          tz.local_time(date.year, date.month, date.day, hour, minute, 0)
+        rescue LoadError
+          # Fallback if TZInfo not available
+          Time.new(date.year, date.month, date.day, hour, minute, 0)
+        end
       end
 
       def create_realistic_order(period:, data:, order_num:, total_in_period:, order_time: nil)

data/lib/clover_sandbox_simulator/services/clover/order_service.rb

@@ -250,6 +250,73 @@ module CloverSandboxSimulator
           logger.info "Deleting order: #{order_id}"
           request(:delete, endpoint("orders/#{order_id}"))
         end
+
+        # Delete all orders for today
+        # @param batch_size [Integer] Number of orders to fetch per batch
+        # @return [Integer] Total number of orders deleted
+        def delete_all_orders(batch_size: 100)
+          logger.warn "Deleting all orders..."
+          total_deleted = 0
+          offset = 0
+
+          loop do
+            orders = get_orders(limit: batch_size, offset: 0)
+            break if orders.empty?
+
+            orders.each do |order|
+              begin
+                delete_order(order["id"])
+                total_deleted += 1
+                logger.debug "Deleted order #{order['id']}"
+              rescue StandardError => e
+                logger.warn "Failed to delete order #{order['id']}: #{e.message}"
+              end
+            end
+
+            # Safety: if we got fewer than batch_size, we're done
+            break if orders.size < batch_size
+          end
+
+          logger.info "Deleted #{total_deleted} orders"
+          total_deleted
+        end
+
+        # Delete orders created within a time range
+        # @param since [Time] Start time (default: beginning of today)
+        # @param until_time [Time] End time (default: now)
+        # @return [Integer] Total number of orders deleted
+        def delete_orders_since(since: nil, until_time: nil)
+          since ||= Time.now.to_date.to_time
+          until_time ||= Time.now
+
+          logger.warn "Deleting orders from #{since} to #{until_time}..."
+
+          # Clover uses millisecond timestamps
+          since_ms = (since.to_f * 1000).to_i
+
+          total_deleted = 0
+
+          loop do
+            # Filter by createdTime - only use >= filter (simpler and works)
+            filter = "createdTime>=#{since_ms}"
+            orders = get_orders(limit: 100, filter: filter)
+            break if orders.empty?
+
+            orders.each do |order|
+              begin
+                delete_order(order["id"])
+                total_deleted += 1
+              rescue StandardError => e
+                logger.warn "Failed to delete order #{order['id']}: #{e.message}"
+              end
+            end
+
+            break if orders.size < 100
+          end
+
+          logger.info "Deleted #{total_deleted} orders"
+          total_deleted
+        end
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clover_sandbox_simulator
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - dan1d
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-04 00:00:00.000000000 Z
+date: 2026-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement