lightspeed_sandbox_simulator 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 91921b4c2a3b26ae9a5444309b1b9ea33816c83c281ff8bdd2bd0961fa2e55de
+  data.tar.gz: 7aa36df7a8e33b200db8106c5821a4983ba6d0cf190580ef478be969dc64abd1
+SHA512:
+  metadata.gz: 4bd2dae32589ca317c60335aead9fb0b906adbe4947e8600a8b6a5ea711d7e0bc2a9dc94065b4c0288374c16a769850c0b41f4df4b2405108ceb71fc566037d0
+  data.tar.gz: c8a316d2e875b428477b49e54f7d6259fc77504049de10e900f20403009ca472316d115edf731688278cac0216ed288388d2f58c138fff340e4a50788508627b

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dan1d
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,215 @@
+# Lightspeed Sandbox Simulator
+
+A Ruby gem for simulating POS operations against the **Lightspeed K-Series API**. Generates realistic orders, payments, and transaction data for development and testing.
+
+## Features
+
+- **Entity Setup** — Seed categories, menu items, and payment methods via the Lightspeed K-Series API
+- **Order Generation** — Create realistic daily order patterns with meal periods, dining options, tips, and discounts
+- **Payment Simulation** — Process payments with weighted tender selection (Cash, Credit Card, etc.)
+- **Refund Processing** — Simulate refund flows at configurable percentages
+- **Multi-Business-Type Support** — Restaurant, Cafe & Bakery, Bar & Nightclub, Retail General
+- **Database Tracking** — Optional PostgreSQL persistence for orders, payments, API requests, and daily summaries
+- **Thor CLI** — Command-line interface for all operations
+
+## Installation
+
+```ruby
+gem 'lightspeed_sandbox_simulator'
+```
+
+Or install directly:
+
+```bash
+gem install lightspeed_sandbox_simulator
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file:
+
+```bash
+LIGHTSPEED_ACCESS_TOKEN=your_access_token
+LIGHTSPEED_BUSINESS_ID=your_business_id
+LIGHTSPEED_CLIENT_ID=your_client_id        # optional
+LIGHTSPEED_CLIENT_SECRET=your_client_secret # optional
+LIGHTSPEED_REFRESH_TOKEN=your_refresh_token # optional
+LOG_LEVEL=INFO
+TAX_RATE=20.0
+LIGHTSPEED_TIMEZONE=America/New_York
+```
+
+### Multi-Merchant Support
+
+Create a `.env.json` file for multiple merchants:
+
+```json
+[
+  {
+    "LIGHTSPEED_ACCESS_TOKEN": "token_1",
+    "LIGHTSPEED_BUSINESS_ID": "business_1",
+    "LIGHTSPEED_DEVICE_NAME": "Store A"
+  },
+  {
+    "LIGHTSPEED_ACCESS_TOKEN": "token_2",
+    "LIGHTSPEED_BUSINESS_ID": "business_2",
+    "LIGHTSPEED_DEVICE_NAME": "Store B"
+  }
+]
+```
+
+### Ruby Configuration
+
+```ruby
+LightspeedSandboxSimulator.configure do |config|
+  config.access_token = "your_access_token"
+  config.business_id = "your_business_id"
+end
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Set up menu entities (categories, items, payment methods)
+bin/simulate setup --business-type restaurant
+
+# Generate a day's worth of orders
+bin/simulate generate --count 50 --business-type restaurant
+
+# Generate a realistic day (volume based on day-of-week)
+bin/simulate generate --realistic --business-type cafe_bakery
+
+# Generate a rush period
+bin/simulate rush --period dinner --count 20
+
+# List available merchants
+bin/simulate merchants
+
+# Database operations (optional)
+bin/simulate db:create
+bin/simulate db:migrate
+bin/simulate db:seed --business-type all
+```
+
+### Ruby API
+
+```ruby
+require "lightspeed_sandbox_simulator"
+
+config = LightspeedSandboxSimulator::Configuration.new
+config.access_token = "your_token"
+config.business_id = "your_business_id"
+
+# Set up entities
+generator = LightspeedSandboxSimulator::Generators::EntityGenerator.new(
+  config: config,
+  business_type: :restaurant
+)
+result = generator.setup_all
+# => { categories: [...], items: [...], payment_methods: [...] }
+
+# Generate orders
+order_gen = LightspeedSandboxSimulator::Generators::OrderGenerator.new(
+  config: config,
+  business_type: :restaurant,
+  refund_percentage: 5
+)
+orders = order_gen.generate_today(count: 50)
+
+# Use services directly
+manager = LightspeedSandboxSimulator::Services::Lightspeed::ServicesManager.new(
+  config: config
+)
+manager.menu.list_categories
+manager.menu.create_item(name: "Espresso", price: 3.50, category_id: 1)
+manager.orders.create_local_order(items: [{ item_id: 1, quantity: 2 }], table_number: 5)
+manager.payments.create_payment(order_id: 100, amount: 25.50, payment_method_id: 1)
+manager.business.fetch_business
+```
+
+## Business Types
+
+| Type | Key | Categories |
+|------|-----|------------|
+| Restaurant | `:restaurant` | Appetizers, Entrees, Sides, Desserts, Beverages |
+| Cafe & Bakery | `:cafe_bakery` | Hot Drinks, Cold Drinks, Pastries, Sandwiches, Snacks |
+| Bar & Nightclub | `:bar_nightclub` | Beer, Wine, Cocktails, Spirits, Bar Food |
+| Retail General | `:retail_general` | Electronics, Clothing, Home, Sports, Accessories |
+
+## Order Generation Details
+
+Orders are distributed across five meal periods with realistic weights:
+
+| Period | Weight | Items per Order |
+|--------|--------|-----------------|
+| Breakfast | 15% | 1–3 |
+| Lunch | 30% | 2–4 |
+| Happy Hour | 10% | 2–4 |
+| Dinner | 35% | 3–6 |
+| Late Night | 10% | 1–3 |
+
+Dining options (eat-in, takeaway, delivery) vary by period. Tips and discounts are calculated with configurable probability distributions.
+
+## Database (Optional)
+
+PostgreSQL tracking is optional. When configured, the gem persists:
+
+- **API Requests** — Full audit log of all Lightspeed API calls
+- **Simulated Orders** — Order details with meal period, dining option, amounts
+- **Simulated Payments** — Payment records with tender type and amounts
+- **Daily Summaries** — Aggregated daily stats with breakdowns
+- **Business Types, Categories, Items** — Seeded reference data
+
+```bash
+# Set DATABASE_URL in .env or .env.json
+DATABASE_URL=postgres://localhost:5432/lightspeed_sandbox
+
+bin/simulate db:create
+bin/simulate db:migrate
+bin/simulate db:seed --business-type all
+```
+
+## Lightspeed K-Series API
+
+This gem targets the [Lightspeed K-Series (L-Series) API](https://developers.lightspeedhq.com/):
+
+- **Base URL**: `https://api.lsk.lightspeed.app`
+- **Auth**: OAuth2 Bearer token
+- **Pagination**: Cursor-based
+- **API Version**: V2
+
+### Endpoints Used
+
+| Method | Endpoint | Purpose |
+|--------|----------|---------|
+| GET | `/api/v2/businesses/{id}` | Business info |
+| GET | `/api/v2/businesses/{id}/menu/categories` | List categories |
+| POST | `/api/v2/businesses/{id}/menu/categories` | Create category |
+| GET | `/api/v2/businesses/{id}/menu/items` | List items |
+| POST | `/api/v2/businesses/{id}/menu/items` | Create item |
+| GET | `/api/v2/businesses/{id}/payment-methods` | List payment methods |
+| POST | `/api/v2/businesses/{id}/payment-methods` | Create payment method |
+| POST | `/api/v2/businesses/{id}/orders/local` | Create dine-in order |
+| POST | `/api/v2/businesses/{id}/orders/toGo` | Create takeout order |
+| GET | `/api/v2/businesses/{id}/orders` | Fetch orders |
+| POST | `/api/v2/businesses/{id}/payments` | Create payment |
+| GET | `/api/v2/businesses/{id}/payments` | Fetch payments |
+| GET | `/api/v2/businesses/{id}/tax-rates` | List tax rates |
+| GET | `/api/v2/businesses/{id}/floorplans` | List floor plans |
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec                  # Run tests (275 examples)
+COVERAGE=true bundle exec rspec    # With coverage report (100% line + branch)
+bundle exec rubocop                # Lint (0 offenses)
+```
+
+## License
+
+[MIT](LICENSE)

data/bin/simulate

@@ -0,0 +1,162 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'thor'
+require_relative '../lib/lightspeed_sandbox_simulator'
+
+module LightspeedSandboxSimulator
+  class CLI < Thor
+    desc 'version', 'Show version'
+    def version
+      puts 'lightspeed_sandbox_simulator v0.1.0'
+    end
+
+    desc 'merchants', 'List configured API devices'
+    def merchants
+      devices = Configuration.available_merchants
+      if devices.empty?
+        puts 'No devices found in .env.json'
+        return
+      end
+
+      devices.each do |d|
+        puts "##{d[:index]}: #{d[:name] || 'unnamed'} (business_id: #{d[:business_id]})"
+      end
+    end
+
+    desc 'setup', 'Set up POS entities (categories, items, payment methods)'
+    method_option :index, aliases: '-i', type: :numeric, desc: 'Device index'
+    method_option :business_type, aliases: '-b', type: :string, default: 'restaurant'
+    def setup
+      config = load_config(options[:index])
+      bt = options[:business_type].to_sym
+      gen = Generators::EntityGenerator.new(config: config, business_type: bt)
+      result = gen.setup_all
+      puts "Setup complete: #{result[:categories].size} categories, " \
+           "#{result[:items].size} items, #{result[:payment_methods].size} payment methods"
+    end
+
+    desc 'generate', 'Generate orders for today'
+    method_option :count, aliases: '-n', type: :numeric, desc: 'Number of orders'
+    method_option :refund, aliases: '-r', type: :numeric, default: 5, desc: 'Refund percentage'
+    method_option :index, aliases: '-i', type: :numeric, desc: 'Device index'
+    method_option :business_type, aliases: '-b', type: :string, default: 'restaurant'
+    def generate
+      config = load_config(options[:index])
+      gen = Generators::OrderGenerator.new(
+        config: config,
+        business_type: options[:business_type].to_sym,
+        refund_percentage: options[:refund]
+      )
+      orders = gen.generate_today(count: options[:count])
+      puts "Generated #{orders.size} orders"
+    end
+
+    desc 'day', 'Generate a realistic full day'
+    method_option :multiplier, aliases: '-x', type: :numeric, default: 1.0
+    method_option :index, aliases: '-i', type: :numeric, desc: 'Device index'
+    method_option :business_type, aliases: '-b', type: :string, default: 'restaurant'
+    def day
+      config = load_config(options[:index])
+      gen = Generators::OrderGenerator.new(
+        config: config,
+        business_type: options[:business_type].to_sym
+      )
+      orders = gen.generate_realistic_day(multiplier: options[:multiplier])
+      puts "Generated #{orders.size} orders (#{options[:multiplier]}x)"
+    end
+
+    desc 'rush', 'Generate a meal period rush'
+    method_option :period, aliases: '-p', type: :string, default: 'dinner'
+    method_option :count, aliases: '-n', type: :numeric, default: 20
+    method_option :index, aliases: '-i', type: :numeric, desc: 'Device index'
+    def rush
+      config = load_config(options[:index])
+      gen = Generators::OrderGenerator.new(config: config)
+      orders = gen.generate_rush(
+        period: options[:period].to_sym,
+        count: options[:count]
+      )
+      puts "Generated #{orders.size} #{options[:period]} orders"
+    end
+
+    desc 'full', 'Full setup + order generation'
+    method_option :index, aliases: '-i', type: :numeric, desc: 'Device index'
+    method_option :business_type, aliases: '-b', type: :string, default: 'restaurant'
+    def full
+      invoke :setup
+      invoke :generate
+    end
+
+    desc 'status', 'Show entity counts'
+    method_option :index, aliases: '-i', type: :numeric, desc: 'Device index'
+    def status
+      config = load_config(options[:index])
+      manager = Services::Lightspeed::ServicesManager.new(config: config)
+
+      categories = manager.menu.list_categories
+      cat_count = extract_count(categories, 'categories')
+      items = manager.menu.list_items
+      item_count = extract_count(items, 'items')
+      methods = manager.payment_methods.list_payment_methods
+      method_count = extract_count(methods, 'paymentMethods')
+
+      puts "Categories: #{cat_count}"
+      puts "Items: #{item_count}"
+      puts "Payment Methods: #{method_count}"
+    end
+
+    desc 'business_types', 'List available business types'
+    def business_types
+      Generators::DataLoader::BUSINESS_TYPES.each do |bt|
+        loader = Generators::DataLoader.new(business_type: bt)
+        cats = loader.load_categories.size
+        items = loader.load_items.size
+        puts "#{bt}: #{cats} categories, #{items} items"
+      end
+    end
+
+    desc 'db SUBCOMMAND', 'Database management'
+    method_option :business_type, aliases: '-b', type: :string, default: 'restaurant'
+    def db(subcommand)
+      url = Database.database_url
+      case subcommand
+      when 'create'  then Database.create!(url)
+      when 'migrate' then Database.connect!(url) && Database.migrate!
+      when 'seed'    then Database.connect!(url) && Database.seed!(business_type: options[:business_type].to_sym)
+      when 'reset'
+        Database.drop!(url)
+        Database.create!(url)
+        Database.connect!(url)
+        Database.migrate!
+        Database.seed!(business_type: options[:business_type].to_sym)
+      else puts "Unknown subcommand: #{subcommand}. Use: create, migrate, seed, reset"
+      end
+    end
+
+    private
+
+    def load_config(index = nil)
+      if index
+        config = Configuration.load_merchant(index: index)
+        raise Error, "Device ##{index} not found" unless config
+
+        config
+      else
+        LightspeedSandboxSimulator.configuration
+      end
+    end
+
+    def extract_count(data, key)
+      if data.is_a?(Hash) && data.key?(key)
+        Array(data[key]).size
+      elsif data.is_a?(Array)
+        data.size
+      else
+        0
+      end
+    end
+  end
+end
+
+LightspeedSandboxSimulator::CLI.start(ARGV)

data/lib/lightspeed_sandbox_simulator/configuration.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require 'dotenv'
+require 'json'
+require 'logger'
+require 'tzinfo'
+
+module LightspeedSandboxSimulator
+  class Configuration
+    MERCHANT_KEYS = {
+      'LIGHTSPEED_CLIENT_ID' => :client_id,
+      'LIGHTSPEED_CLIENT_SECRET' => :client_secret,
+      'LIGHTSPEED_ACCESS_TOKEN' => :access_token,
+      'LIGHTSPEED_REFRESH_TOKEN' => :refresh_token,
+      'LIGHTSPEED_BUSINESS_ID' => :business_id,
+      'LIGHTSPEED_DEVICE_NAME' => :device_name
+    }.freeze
+
+    DEFAULTS = {
+      base_url: 'https://api.lsk.lightspeed.app',
+      auth_url: 'https://cloud.lsk.lightspeed.app',
+      tax_rate: 20.0,
+      merchant_timezone: 'America/New_York'
+    }.freeze
+
+    attr_accessor :client_id, :client_secret, :access_token, :refresh_token,
+                  :business_id, :base_url, :auth_url, :tax_rate, :log_level,
+                  :device_name, :merchant_timezone
+
+    attr_writer :logger
+
+    def initialize
+      Dotenv.load if File.exist?('.env')
+      @client_id = ENV.fetch('LIGHTSPEED_CLIENT_ID', nil)
+      @client_secret = ENV.fetch('LIGHTSPEED_CLIENT_SECRET', nil)
+      @access_token = ENV.fetch('LIGHTSPEED_ACCESS_TOKEN', nil)
+      @refresh_token = ENV.fetch('LIGHTSPEED_REFRESH_TOKEN', nil)
+      @business_id = ENV.fetch('LIGHTSPEED_BUSINESS_ID', nil)
+      @base_url = normalize_url(ENV.fetch('LIGHTSPEED_BASE_URL', DEFAULTS[:base_url]))
+      @auth_url = normalize_url(ENV.fetch('LIGHTSPEED_AUTH_URL', DEFAULTS[:auth_url]))
+      @tax_rate = ENV.fetch('TAX_RATE', DEFAULTS[:tax_rate]).to_f
+      @log_level = ENV.fetch('LOG_LEVEL', 'INFO')
+      @device_name = ENV.fetch('LIGHTSPEED_DEVICE_NAME', nil)
+      @merchant_timezone = ENV.fetch('LIGHTSPEED_TIMEZONE', DEFAULTS[:merchant_timezone])
+    end
+
+    def validate!
+      raise ConfigurationError, 'LIGHTSPEED_ACCESS_TOKEN is required' if access_token.nil? || access_token.empty?
+      raise ConfigurationError, 'LIGHTSPEED_BUSINESS_ID is required' if business_id.nil? || business_id.empty?
+    end
+
+    def logger
+      @logger ||= build_logger
+    end
+
+    def auth_token
+      access_token
+    end
+
+    def merchant_time_now
+      tz = TZInfo::Timezone.get(merchant_timezone)
+      tz.now
+    rescue TZInfo::InvalidTimezoneIdentifier
+      Time.now
+    end
+
+    def self.load_from_merchants_file(path = '.env.json')
+      return nil unless File.exist?(path)
+
+      data = JSON.parse(File.read(path))
+      case data
+      when Array
+        data
+      when Hash
+        data['merchants'] || []
+      end
+    rescue JSON::ParserError
+      nil
+    end
+
+    def self.load_merchant(index: nil, name: nil, path: '.env.json')
+      merchants = load_from_merchants_file(path)
+      return nil if merchants.nil? || merchants.empty?
+
+      merchant = find_merchant(merchants, index: index, name: name)
+      return nil unless merchant
+
+      build_config_from_merchant(merchant)
+    end
+
+    def self.find_merchant(merchants, index: nil, name: nil)
+      if name
+        merchants.find { |m| m['LIGHTSPEED_DEVICE_NAME']&.downcase == name.downcase }
+      elsif index
+        merchants[index]
+      else
+        merchants.first
+      end
+    end
+    private_class_method :find_merchant
+
+    def self.build_config_from_merchant(merchant)
+      config = new
+      MERCHANT_KEYS.each do |env_key, attr|
+        value = merchant[env_key]
+        config.public_send(:"#{attr}=", value) unless value.to_s.empty?
+      end
+      config
+    end
+    private_class_method :build_config_from_merchant
+
+    def self.available_merchants(path = '.env.json')
+      merchants = load_from_merchants_file(path)
+      return [] if merchants.nil?
+
+      merchants.map.with_index do |m, i|
+        { index: i, name: m['LIGHTSPEED_DEVICE_NAME'], business_id: m['LIGHTSPEED_BUSINESS_ID'] }
+      end
+    end
+
+    def self.database_url_from_file(path = '.env.json')
+      return nil unless File.exist?(path)
+
+      data = JSON.parse(File.read(path))
+      data.is_a?(Hash) ? data['DATABASE_URL'] : nil
+    rescue JSON::ParserError
+      nil
+    end
+
+    private
+
+    def normalize_url(url)
+      url&.chomp('/')
+    end
+
+    def build_logger
+      log = Logger.new($stdout)
+      log.level = parse_log_level(log_level)
+      log.formatter = proc { |severity, _datetime, _progname, msg| "[#{severity}] #{msg}\n" }
+      log
+    end
+
+    def parse_log_level(level)
+      {
+        'DEBUG' => Logger::DEBUG, 'INFO' => Logger::INFO,
+        'WARN' => Logger::WARN, 'ERROR' => Logger::ERROR,
+        'FATAL' => Logger::FATAL
+      }.fetch(level.to_s.upcase, Logger::INFO)
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/data/bar_nightclub/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "Draft Beer", "sort_order": 1, "description": "Beers on tap" },
+    { "name": "Bottled Beer", "sort_order": 2, "description": "Bottled and canned beers" },
+    { "name": "Cocktails", "sort_order": 3, "description": "Mixed drinks" },
+    { "name": "Wine", "sort_order": 4, "description": "Wine by the glass" },
+    { "name": "Bar Snacks", "sort_order": 5, "description": "Bar food and snacks" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/bar_nightclub/items.json

@@ -0,0 +1,26 @@
+{
+  "items": [
+    { "name": "IPA Pint", "price": 7.50, "category": "Draft Beer", "sku": "BAR-DRF-001" },
+    { "name": "Lager Pint", "price": 6.50, "category": "Draft Beer", "sku": "BAR-DRF-002" },
+    { "name": "Stout Pint", "price": 7.00, "category": "Draft Beer", "sku": "BAR-DRF-003" },
+    { "name": "Wheat Beer", "price": 7.50, "category": "Draft Beer", "sku": "BAR-DRF-004" },
+    { "name": "Pale Ale", "price": 7.00, "category": "Draft Beer", "sku": "BAR-DRF-005" },
+    { "name": "Corona", "price": 6.00, "category": "Bottled Beer", "sku": "BAR-BTL-001" },
+    { "name": "Heineken", "price": 5.50, "category": "Bottled Beer", "sku": "BAR-BTL-002" },
+    { "name": "Budweiser", "price": 5.00, "category": "Bottled Beer", "sku": "BAR-BTL-003" },
+    { "name": "Seltzer", "price": 5.50, "category": "Bottled Beer", "sku": "BAR-BTL-004" },
+    { "name": "Margarita", "price": 12.00, "category": "Cocktails", "sku": "BAR-COK-001" },
+    { "name": "Old Fashioned", "price": 14.00, "category": "Cocktails", "sku": "BAR-COK-002" },
+    { "name": "Mojito", "price": 12.00, "category": "Cocktails", "sku": "BAR-COK-003" },
+    { "name": "Espresso Martini", "price": 13.00, "category": "Cocktails", "sku": "BAR-COK-004" },
+    { "name": "Long Island", "price": 14.00, "category": "Cocktails", "sku": "BAR-COK-005" },
+    { "name": "House Red Wine", "price": 9.00, "category": "Wine", "sku": "BAR-WIN-001" },
+    { "name": "House White Wine", "price": 9.00, "category": "Wine", "sku": "BAR-WIN-002" },
+    { "name": "Prosecco", "price": 10.00, "category": "Wine", "sku": "BAR-WIN-003" },
+    { "name": "Chicken Wings", "price": 10.99, "category": "Bar Snacks", "sku": "BAR-SNK-001" },
+    { "name": "Loaded Fries", "price": 8.99, "category": "Bar Snacks", "sku": "BAR-SNK-002" },
+    { "name": "Nachos", "price": 11.99, "category": "Bar Snacks", "sku": "BAR-SNK-003" },
+    { "name": "Slider Trio", "price": 12.99, "category": "Bar Snacks", "sku": "BAR-SNK-004" },
+    { "name": "Mixed Nuts", "price": 5.99, "category": "Bar Snacks", "sku": "BAR-SNK-005" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/bar_nightclub/tenders.json

@@ -0,0 +1,8 @@
+{
+  "tenders": [
+    { "name": "Cash", "description": "Cash payment", "weight": 20 },
+    { "name": "Credit Card", "description": "Credit card payment", "weight": 55 },
+    { "name": "Debit Card", "description": "Debit card payment", "weight": 20 },
+    { "name": "Gift Card", "description": "Gift card payment", "weight": 5 }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/cafe_bakery/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "Hot Drinks", "sort_order": 1, "description": "Coffee, tea, and hot beverages" },
+    { "name": "Cold Drinks", "sort_order": 2, "description": "Iced and cold beverages" },
+    { "name": "Pastries", "sort_order": 3, "description": "Fresh baked pastries" },
+    { "name": "Sandwiches", "sort_order": 4, "description": "Fresh sandwiches and wraps" },
+    { "name": "Cakes", "sort_order": 5, "description": "Cakes and slices" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/cafe_bakery/items.json

@@ -0,0 +1,28 @@
+{
+  "items": [
+    { "name": "Espresso", "price": 3.50, "category": "Hot Drinks", "sku": "CAFE-HOT-001" },
+    { "name": "Cappuccino", "price": 4.50, "category": "Hot Drinks", "sku": "CAFE-HOT-002" },
+    { "name": "Latte", "price": 4.75, "category": "Hot Drinks", "sku": "CAFE-HOT-003" },
+    { "name": "Hot Chocolate", "price": 4.25, "category": "Hot Drinks", "sku": "CAFE-HOT-004" },
+    { "name": "English Breakfast Tea", "price": 3.25, "category": "Hot Drinks", "sku": "CAFE-HOT-005" },
+    { "name": "Iced Latte", "price": 5.25, "category": "Cold Drinks", "sku": "CAFE-CLD-001" },
+    { "name": "Iced Americano", "price": 4.75, "category": "Cold Drinks", "sku": "CAFE-CLD-002" },
+    { "name": "Smoothie", "price": 5.99, "category": "Cold Drinks", "sku": "CAFE-CLD-003" },
+    { "name": "Fresh Orange Juice", "price": 4.50, "category": "Cold Drinks", "sku": "CAFE-CLD-004" },
+    { "name": "Croissant", "price": 3.50, "category": "Pastries", "sku": "CAFE-PAS-001" },
+    { "name": "Pain au Chocolat", "price": 3.75, "category": "Pastries", "sku": "CAFE-PAS-002" },
+    { "name": "Blueberry Muffin", "price": 3.99, "category": "Pastries", "sku": "CAFE-PAS-003" },
+    { "name": "Cinnamon Roll", "price": 4.25, "category": "Pastries", "sku": "CAFE-PAS-004" },
+    { "name": "Scone", "price": 3.25, "category": "Pastries", "sku": "CAFE-PAS-005" },
+    { "name": "Club Sandwich", "price": 8.99, "category": "Sandwiches", "sku": "CAFE-SAN-001" },
+    { "name": "BLT", "price": 7.99, "category": "Sandwiches", "sku": "CAFE-SAN-002" },
+    { "name": "Avocado Toast", "price": 9.50, "category": "Sandwiches", "sku": "CAFE-SAN-003" },
+    { "name": "Panini", "price": 8.50, "category": "Sandwiches", "sku": "CAFE-SAN-004" },
+    { "name": "Chicken Wrap", "price": 8.99, "category": "Sandwiches", "sku": "CAFE-SAN-005" },
+    { "name": "Carrot Cake", "price": 5.50, "category": "Cakes", "sku": "CAFE-CAK-001" },
+    { "name": "Victoria Sponge", "price": 5.25, "category": "Cakes", "sku": "CAFE-CAK-002" },
+    { "name": "Brownie", "price": 4.50, "category": "Cakes", "sku": "CAFE-CAK-003" },
+    { "name": "Lemon Drizzle", "price": 4.99, "category": "Cakes", "sku": "CAFE-CAK-004" },
+    { "name": "Red Velvet Slice", "price": 5.75, "category": "Cakes", "sku": "CAFE-CAK-005" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/cafe_bakery/tenders.json

@@ -0,0 +1,8 @@
+{
+  "tenders": [
+    { "name": "Cash", "description": "Cash payment", "weight": 30 },
+    { "name": "Credit Card", "description": "Credit card payment", "weight": 50 },
+    { "name": "Debit Card", "description": "Debit card payment", "weight": 15 },
+    { "name": "Gift Card", "description": "Gift card payment", "weight": 5 }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/restaurant/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "Appetizers", "sort_order": 1, "description": "Starters and small plates" },
+    { "name": "Entrees", "sort_order": 2, "description": "Main course dishes" },
+    { "name": "Sides", "sort_order": 3, "description": "Side dishes" },
+    { "name": "Drinks", "sort_order": 4, "description": "Beverages" },
+    { "name": "Desserts", "sort_order": 5, "description": "Sweets and treats" }
+  ]
+}