epos_now_client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 486c114791db7ffda314246e447b5c03a56879dc08a8551d9e695338ad02bdbe
+  data.tar.gz: 6c43a07100a3f83a2fbce1feea144aaa4eda78b0d11cf1e636a7309d413bf9ea
+SHA512:
+  metadata.gz: a64dbe7f3883d91a09ef3dca33a721571dbe2c574f88462fdfe6ac50207e0a69919b2ac9976207f63521e1f68bda6950b57cf0d976d8decefddb3bac81ec494e
+  data.tar.gz: df5c985d5b28e3728ca1a92792b4e0635f5f7dac069e855c8c272e0a860a3e46a406bfcc0484e4f673a4ac074179206823f3b4006136e871ecc0151b4431d1e9

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-13
+
+### Added
+
+- Initial release
+- Basic Auth configuration with API Key and Secret
+- HTTP connection layer with retry logic and exponential backoff
+- Automatic pagination (200 items/page)
+- 10 resource classes: Products, Categories, Transactions, TenderTypes, TaxGroups, Customers, Staff, Devices, Brands, Locations
+- Search and filtering support via Epos Now query syntax
+- Structured error hierarchy: AuthenticationError, RateLimitError, NotFoundError, ValidationError, ServerError, ConnectionError, TimeoutError
+- Per-client and global configuration
+- Optional logging support
+- 131 specs with 100% line and branch coverage
+- RuboCop with 0 offenses

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TheOwnerStack
+
+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,326 @@
+# EposNowClient
+
+[![Gem Version](https://badge.fury.io/rb/epos_now_client.svg)](https://rubygems.org/gems/epos_now_client)
+[![CI](https://github.com/dan1d/epos_now_client/actions/workflows/ci.yml/badge.svg)](https://github.com/dan1d/epos_now_client/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.txt)
+
+A lightweight, fully-tested Ruby client for the [Epos Now REST API (V4)](https://developer.eposnowhq.com).
+
+**131 specs | 100% line coverage | 100% branch coverage | 0 RuboCop offenses**
+
+## Features
+
+- **Basic Auth** with API Key + Secret (Base64-encoded)
+- **10 resource classes**: Products, Categories, Transactions, TenderTypes, TaxGroups, Customers, Staff, Devices, Brands, Locations
+- **Automatic pagination** (200 items/page, fetches all pages)
+- **Retry with exponential backoff** on transient network errors
+- **Structured error hierarchy** for clean exception handling
+- **Search & filtering** using Epos Now query syntax
+- **Zero runtime dependencies** beyond HTTParty
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'epos_now_client'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+Or install directly:
+
+```bash
+gem install epos_now_client
+```
+
+## Quick Start
+
+```ruby
+require 'epos_now_client'
+
+client = EposNowClient::Client.new(
+  api_key: 'your_api_key',
+  api_secret: 'your_api_secret'
+)
+
+# Fetch all products
+products = client.products.all
+
+# Create a category
+client.categories.create_category({ 'Name' => 'Drinks' })
+
+# Search products
+client.products.search('(Name|contains|Burger)')
+```
+
+## Authentication
+
+Epos Now uses **Basic Auth** with an API Key and Secret. Get your credentials from the Epos Now Backoffice:
+
+1. Navigate to **Web Integrations > REST API**
+2. Click **Add Device**
+3. Copy the **API Key** and **API Secret**
+
+> **Note:** Epos Now uses a single API endpoint (`https://api.eposnowhq.com`) for all environments. There is no separate sandbox URL. Developer accounts use the same API with test credentials.
+
+## Configuration
+
+### Global (recommended for single-account apps)
+
+```ruby
+EposNowClient.configure do |config|
+  config.api_key = ENV['EPOS_NOW_API_KEY']
+  config.api_secret = ENV['EPOS_NOW_API_SECRET']
+  config.base_url = 'https://api.eposnowhq.com'  # default
+  config.timeout = 30                              # default (seconds)
+  config.open_timeout = 10                         # default (seconds)
+  config.max_retries = 3                           # default
+  config.retry_delay = 1.0                         # default (seconds, doubles each retry)
+  config.per_page = 200                            # default
+  config.logger = Logger.new($stdout)              # optional
+end
+
+client = EposNowClient::Client.new
+```
+
+### Per-client (for multi-account apps)
+
+```ruby
+client = EposNowClient::Client.new(
+  api_key: 'merchant_api_key',
+  api_secret: 'merchant_api_secret',
+  timeout: 60
+)
+```
+
+### Rails initializer
+
+```ruby
+# config/initializers/epos_now.rb
+EposNowClient.configure do |config|
+  config.api_key = Rails.application.credentials.dig(:epos_now, :api_key)
+  config.api_secret = Rails.application.credentials.dig(:epos_now, :api_secret)
+  config.logger = Rails.logger
+end
+```
+
+## Usage
+
+### Categories
+
+```ruby
+client.categories.all                                         # List all (paginated)
+client.categories.find(42)                                    # Get by ID
+client.categories.create_category({ 'Name' => 'Drinks' })    # Create
+client.categories.update_category(42, { 'Name' => 'Bev' })   # Update
+client.categories.delete_category(42)                         # Delete
+```
+
+### Products
+
+```ruby
+client.products.all                                           # List all
+client.products.find(10)                                      # Get by ID
+client.products.create_product({                              # Create
+  'Name' => 'Burger',
+  'SalePrice' => 9.99,
+  'CategoryId' => 1
+})
+client.products.update_product(10, { 'SalePrice' => 11.99 }) # Update
+client.products.delete_product(10)                            # Delete
+client.products.search('(Name|contains|Burg)')                # Search
+```
+
+### Transactions
+
+```ruby
+client.transactions.all                                       # List all
+client.transactions.find(100)                                 # Get by ID
+client.transactions.by_date(                                  # By date range
+  start_date: '2026-03-01',
+  end_date: '2026-03-13'
+)
+client.transactions.latest                                    # Latest
+client.transactions.create_transaction({                      # Create
+  'TransactionItems' => [{ 'ProductId' => 1, 'Quantity' => 2 }],
+  'Tenders' => [{ 'TenderTypeId' => 1, 'Amount' => 25.50 }],
+  'ServiceType' => 0  # 0=EatIn, 1=Takeaway, 2=Delivery
+})
+client.transactions.delete_transaction(200)                   # Delete
+client.transactions.validate(payload)                         # Validate
+```
+
+### Tender Types
+
+```ruby
+client.tender_types.all
+client.tender_types.find(1)
+client.tender_types.create_tender_type({ 'Name' => 'Gift Card' })
+```
+
+### Tax Groups
+
+```ruby
+client.tax_groups.all
+client.tax_groups.find(1)
+```
+
+### Customers
+
+```ruby
+client.customers.all
+client.customers.find(1)
+client.customers.create_customer({ 'FirstName' => 'Jane', 'LastName' => 'Doe' })
+client.customers.update_customer(1, { 'FirstName' => 'Janet' })
+client.customers.delete_customer(1)
+client.customers.search('(FirstName|contains|Jane)')
+```
+
+### Staff
+
+```ruby
+client.staff.all
+client.staff.find(1)
+client.staff.create_staff({ 'FirstName' => 'Bob', 'Pin' => '1234' })
+client.staff.update_staff(1, { 'FirstName' => 'Robert' })
+client.staff.delete_staff(1)
+```
+
+### Devices
+
+```ruby
+client.devices.all
+client.devices.find(1)
+```
+
+### Brands
+
+```ruby
+client.brands.all
+client.brands.find(1)
+client.brands.create_brand({ 'Name' => 'Coca-Cola' })
+client.brands.update_brand(1, { 'Name' => 'PepsiCo' })
+client.brands.delete_brand(1)
+```
+
+### Locations
+
+```ruby
+client.locations.all
+client.locations.find(1)
+```
+
+## Pagination
+
+All `.all` methods automatically paginate through every page (200 items per page):
+
+```ruby
+# Fetches ALL products, regardless of how many pages exist
+all_products = client.products.all
+```
+
+## Search & Filtering
+
+Epos Now supports search filters using the syntax `(PropertyName|Operator|Value)`:
+
+```ruby
+# Available operators: contains, StartsWith, EndsWith, >, >=, <, <=, like
+client.products.search('(Name|contains|Burger)')
+client.customers.search('(FirstName|StartsWith|J)')
+client.products.search('(SalePrice|>|10.00)')
+```
+
+## Error Handling
+
+All errors inherit from `EposNowClient::Error` and include `status` and `body` attributes:
+
+```ruby
+begin
+  client.products.find(999)
+rescue EposNowClient::AuthenticationError => e
+  # 401 - Invalid API key or secret
+rescue EposNowClient::NotFoundError => e
+  # 404 - Resource not found
+rescue EposNowClient::ValidationError => e
+  # 422 - Invalid request payload
+rescue EposNowClient::RateLimitError => e
+  # 429 - API rate limit exceeded
+rescue EposNowClient::ServerError => e
+  # 500-599 - Epos Now server error
+rescue EposNowClient::ConnectionError => e
+  # Network errors (after all retries exhausted)
+rescue EposNowClient::Error => e
+  # Catch-all
+  e.status  # HTTP status code (Integer or nil)
+  e.body    # Parsed response body (Hash, String, or nil)
+  e.message # Human-readable error message
+end
+```
+
+## Retry Logic
+
+The client automatically retries on transient network errors with exponential backoff:
+
+- `Errno::ECONNRESET`, `Errno::ECONNREFUSED`, `Errno::ETIMEDOUT`
+- `Net::OpenTimeout`, `Net::ReadTimeout`
+- `SocketError`
+
+```ruby
+EposNowClient.configure do |config|
+  config.max_retries = 3    # Retry up to 3 times (default)
+  config.retry_delay = 1.0  # 1s, 2s, 4s backoff (default)
+end
+```
+
+## API Reference
+
+| Resource | Methods |
+|----------|---------|
+| `client.categories` | `all`, `find`, `create_category`, `update_category`, `delete_category` |
+| `client.products` | `all`, `find`, `create_product`, `update_product`, `delete_product`, `search` |
+| `client.transactions` | `all`, `find`, `create_transaction`, `delete_transaction`, `by_date`, `latest`, `validate` |
+| `client.tender_types` | `all`, `find`, `create_tender_type` |
+| `client.tax_groups` | `all`, `find` |
+| `client.customers` | `all`, `find`, `create_customer`, `update_customer`, `delete_customer`, `search` |
+| `client.staff` | `all`, `find`, `create_staff`, `update_staff`, `delete_staff` |
+| `client.devices` | `all`, `find` |
+| `client.brands` | `all`, `find`, `create_brand`, `update_brand`, `delete_brand` |
+| `client.locations` | `all`, `find` |
+
+## Development
+
+```bash
+git clone https://github.com/dan1d/epos_now_client.git
+cd epos_now_client
+bundle install
+
+# Run the full suite
+bundle exec rake            # RuboCop + RSpec
+
+# Or individually
+bundle exec rspec           # 131 specs, 100% line + branch coverage
+bundle exec rubocop         # 0 offenses
+
+# View coverage report
+open coverage/index.html
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b feature/my-feature`)
+3. Write tests first (TDD)
+4. Ensure 100% coverage (`bundle exec rspec`)
+5. Ensure 0 RuboCop offenses (`bundle exec rubocop`)
+6. Commit your changes (`git commit -m 'Add my feature'`)
+7. Push to the branch (`git push origin feature/my-feature`)
+8. Create a Pull Request
+
+## License
+
+MIT License. See [LICENSE.txt](LICENSE.txt) for details.

data/lib/epos_now_client/client.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  class Client
+    attr_reader :configuration, :connection
+
+    def initialize(api_key: nil, api_secret: nil, base_url: nil, **)
+      @configuration = build_configuration(api_key, api_secret, base_url, **)
+      @connection = Connection.new(@configuration)
+    end
+
+    def categories
+      @categories ||= Resources::Categories.new(connection)
+    end
+
+    def products
+      @products ||= Resources::Products.new(connection)
+    end
+
+    def transactions
+      @transactions ||= Resources::Transactions.new(connection)
+    end
+
+    def tender_types
+      @tender_types ||= Resources::TenderTypes.new(connection)
+    end
+
+    def tax_groups
+      @tax_groups ||= Resources::TaxGroups.new(connection)
+    end
+
+    def customers
+      @customers ||= Resources::Customers.new(connection)
+    end
+
+    def staff
+      @staff ||= Resources::Staff.new(connection)
+    end
+
+    def devices
+      @devices ||= Resources::Devices.new(connection)
+    end
+
+    def brands
+      @brands ||= Resources::Brands.new(connection)
+    end
+
+    def locations
+      @locations ||= Resources::Locations.new(connection)
+    end
+
+    private
+
+    def build_configuration(api_key, api_secret, base_url, **options)
+      config = EposNowClient.configuration.dup
+      config.api_key = api_key if api_key
+      config.api_secret = api_secret if api_secret
+      config.base_url = base_url if base_url
+      options.each { |key, value| config.send(:"#{key}=", value) }
+      config
+    end
+  end
+end

data/lib/epos_now_client/configuration.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'base64'
+
+module EposNowClient
+  class Configuration
+    attr_accessor :api_key, :api_secret, :timeout, :open_timeout,
+                  :max_retries, :retry_delay, :logger, :per_page
+    attr_reader :base_url
+
+    DEFAULT_BASE_URL = 'https://api.eposnowhq.com'
+    DEFAULT_TIMEOUT = 30
+    DEFAULT_OPEN_TIMEOUT = 10
+    DEFAULT_MAX_RETRIES = 3
+    DEFAULT_RETRY_DELAY = 1.0
+    DEFAULT_PER_PAGE = 200
+
+    def initialize
+      @api_key = nil
+      @api_secret = nil
+      @base_url = DEFAULT_BASE_URL
+      @timeout = DEFAULT_TIMEOUT
+      @open_timeout = DEFAULT_OPEN_TIMEOUT
+      @max_retries = DEFAULT_MAX_RETRIES
+      @retry_delay = DEFAULT_RETRY_DELAY
+      @per_page = DEFAULT_PER_PAGE
+      @logger = nil
+    end
+
+    def auth_token
+      validate!
+      Base64.strict_encode64("#{api_key}:#{api_secret}")
+    end
+
+    def validate!
+      raise AuthenticationError, 'API key is required' if api_key.nil? || api_key.empty?
+      raise AuthenticationError, 'API secret is required' if api_secret.nil? || api_secret.empty?
+    end
+
+    def base_url=(url)
+      @base_url = url&.chomp('/')
+    end
+  end
+end

data/lib/epos_now_client/connection.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require 'json'
+
+module EposNowClient
+  class Connection
+    RETRYABLE_ERRORS = [
+      Errno::ECONNRESET,
+      Errno::ECONNREFUSED,
+      Errno::ETIMEDOUT,
+      Net::OpenTimeout,
+      Net::ReadTimeout,
+      SocketError
+    ].freeze
+
+    RETRYABLE_STATUS_CODES = [502, 503, 504].freeze
+
+    def initialize(configuration)
+      @configuration = configuration
+    end
+
+    def get(path, params: {})
+      request(:get, path, query: params)
+    end
+
+    def post(path, body: {})
+      request(:post, path, body: body.to_json)
+    end
+
+    def put(path, body: {})
+      request(:put, path, body: body.to_json)
+    end
+
+    def delete(path, body: nil)
+      options = {}
+      options[:body] = body.to_json if body
+      request(:delete, path, **options)
+    end
+
+    private
+
+    def request(method, path, **)
+      url = build_url(path)
+      attempts = 0
+
+      begin
+        attempts += 1
+        response = execute_request(method, url, **)
+        handle_response(response)
+      rescue *RETRYABLE_ERRORS => e
+        raise ConnectionError, "Connection failed: #{e.message}" unless retryable?(attempts)
+
+        sleep_before_retry(attempts)
+        retry
+      end
+    end
+
+    def execute_request(method, url, **)
+      HTTParty.send(
+        method,
+        url,
+        **default_options, **
+      )
+    end
+
+    def default_options
+      {
+        headers: {
+          'Authorization' => "Basic #{@configuration.auth_token}",
+          'Content-Type' => 'application/json',
+          'Accept' => 'application/json'
+        },
+        timeout: @configuration.timeout,
+        open_timeout: @configuration.open_timeout
+      }
+    end
+
+    def build_url(path)
+      "#{@configuration.base_url}/api/v4/#{path}"
+    end
+
+    def handle_response(response)
+      log_response(response)
+
+      return parse_body(response) if response.code.between?(200, 204)
+
+      raise_error_for(response)
+    end
+
+    def raise_error_for(response)
+      error_class, message = error_mapping(response)
+      raise error_class.new(message, status: response.code, body: parse_body(response))
+    end
+
+    def error_mapping(response)
+      case response.code
+      when 401 then [AuthenticationError, 'Authentication failed (401)']
+      when 404 then [NotFoundError, 'Resource not found (404)']
+      when 422 then [ValidationError, "Validation failed (422): #{response.body}"]
+      when 429 then [RateLimitError, 'Rate limit exceeded (429)']
+      when 500..599 then [ServerError, "Server error (#{response.code})"]
+      else [Error, "Unexpected response (#{response.code}): #{response.body}"]
+      end
+    end
+
+    def parse_body(response)
+      return nil if response.body.nil? || response.body.empty?
+
+      JSON.parse(response.body)
+    rescue JSON::ParserError
+      response.body
+    end
+
+    def retryable?(attempts)
+      attempts < @configuration.max_retries
+    end
+
+    def sleep_before_retry(attempts)
+      delay = @configuration.retry_delay * (2**(attempts - 1))
+      log_retry(attempts, delay)
+      sleep(delay)
+    end
+
+    def log_response(response)
+      return unless @configuration.logger
+
+      @configuration.logger.debug(
+        "EposNowClient [#{response.code}] #{response.request.http_method::METHOD} #{response.request.uri}"
+      )
+    end
+
+    def log_retry(attempts, delay)
+      return unless @configuration.logger
+
+      @configuration.logger.warn(
+        "EposNowClient retry #{attempts}/#{@configuration.max_retries} in #{delay}s"
+      )
+    end
+  end
+end

data/lib/epos_now_client/error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  class Error < StandardError
+    attr_reader :status, :body
+
+    def initialize(message = nil, status: nil, body: nil)
+      @status = status
+      @body = body
+      super(message)
+    end
+  end
+
+  class AuthenticationError < Error; end
+  class RateLimitError < Error; end
+  class NotFoundError < Error; end
+  class ValidationError < Error; end
+  class ServerError < Error; end
+  class ConnectionError < Error; end
+  class TimeoutError < Error; end
+end

data/lib/epos_now_client/resources/base_resource.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class BaseResource
+      attr_reader :connection
+
+      def initialize(connection)
+        @connection = connection
+      end
+
+      private
+
+      def resource_name
+        raise NotImplementedError, "#{self.class} must implement #resource_name"
+      end
+
+      def list(params = {})
+        connection.get(resource_name, params: params)
+      end
+
+      def fetch(id)
+        connection.get("#{resource_name}/#{id}")
+      end
+
+      def create(attributes)
+        connection.post(resource_name, body: attributes)
+      end
+
+      def update(id, attributes)
+        connection.put("#{resource_name}/#{id}", body: attributes)
+      end
+
+      def destroy(id)
+        connection.delete("#{resource_name}/#{id}")
+      end
+
+      def fetch_all_pages(params = {})
+        page = 1
+        all_records = []
+
+        loop do
+          results = list(params.merge(page: page))
+          break if results.nil? || !results.is_a?(Array) || results.empty?
+
+          all_records.concat(results)
+          break if results.length < 200
+
+          page += 1
+        end
+
+        all_records
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/brands.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Brands < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_brand(attributes)
+        create(attributes)
+      end
+
+      def update_brand(id, attributes)
+        update(id, attributes)
+      end
+
+      def delete_brand(id)
+        destroy(id)
+      end
+
+      private
+
+      def resource_name
+        'Brand'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/categories.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Categories < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_category(attributes)
+        create(attributes)
+      end
+
+      def update_category(id, attributes)
+        update(id, attributes)
+      end
+
+      def delete_category(id)
+        destroy(id)
+      end
+
+      private
+
+      def resource_name
+        'Category'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/customers.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Customers < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_customer(attributes)
+        create(attributes)
+      end
+
+      def update_customer(id, attributes)
+        update(id, attributes)
+      end
+
+      def delete_customer(id)
+        destroy(id)
+      end
+
+      def search(query, params = {})
+        list(params.merge(search: query))
+      end
+
+      private
+
+      def resource_name
+        'Customer'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/devices.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Devices < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      private
+
+      def resource_name
+        'Device'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/locations.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Locations < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      private
+
+      def resource_name
+        'Location'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/products.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Products < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_product(attributes)
+        create(attributes)
+      end
+
+      def update_product(id, attributes)
+        update(id, attributes)
+      end
+
+      def delete_product(id)
+        destroy(id)
+      end
+
+      def search(query, params = {})
+        list(params.merge(search: query))
+      end
+
+      private
+
+      def resource_name
+        'Product'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/staff.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Staff < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_staff(attributes)
+        create(attributes)
+      end
+
+      def update_staff(id, attributes)
+        update(id, attributes)
+      end
+
+      def delete_staff(id)
+        destroy(id)
+      end
+
+      private
+
+      def resource_name
+        'Staff'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/tax_groups.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class TaxGroups < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      private
+
+      def resource_name
+        'TaxGroup'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/tender_types.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class TenderTypes < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_tender_type(attributes)
+        create(attributes)
+      end
+
+      private
+
+      def resource_name
+        'TenderType'
+      end
+    end
+  end
+end

data/lib/epos_now_client/resources/transactions.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  module Resources
+    class Transactions < BaseResource
+      def all(params = {})
+        fetch_all_pages(params)
+      end
+
+      def find(id)
+        fetch(id)
+      end
+
+      def create_transaction(attributes)
+        create(attributes)
+      end
+
+      def delete_transaction(id)
+        destroy(id)
+      end
+
+      def by_date(start_date:, end_date:, params: {})
+        connection.get(
+          "#{resource_name}/GetByDate",
+          params: params.merge(startDate: start_date, endDate: end_date)
+        )
+      end
+
+      def latest(params = {})
+        connection.get("#{resource_name}/GetLatest", params: params)
+      end
+
+      def validate(payload)
+        connection.post("#{resource_name}/Validate", body: payload)
+      end
+
+      private
+
+      def resource_name
+        'Transaction'
+      end
+    end
+  end
+end

data/lib/epos_now_client/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EposNowClient
+  VERSION = '0.1.0'
+end

data/lib/epos_now_client.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'epos_now_client/version'
+require_relative 'epos_now_client/error'
+require_relative 'epos_now_client/configuration'
+require_relative 'epos_now_client/connection'
+require_relative 'epos_now_client/resources/base_resource'
+require_relative 'epos_now_client/resources/categories'
+require_relative 'epos_now_client/resources/products'
+require_relative 'epos_now_client/resources/transactions'
+require_relative 'epos_now_client/resources/tender_types'
+require_relative 'epos_now_client/resources/tax_groups'
+require_relative 'epos_now_client/resources/customers'
+require_relative 'epos_now_client/resources/staff'
+require_relative 'epos_now_client/resources/devices'
+require_relative 'epos_now_client/resources/brands'
+require_relative 'epos_now_client/resources/locations'
+require_relative 'epos_now_client/client'
+
+module EposNowClient
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,205 @@
+--- !ruby/object:Gem::Specification
+name: epos_now_client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Daniel Dominguez
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.75'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.75'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.24'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.24'
+description: A lightweight, fully-tested Ruby client for the Epos Now REST API. Supports
+  Basic Auth, pagination, and all V4 resources including products, categories, transactions,
+  customers, staff, and more.
+email:
+- danielfromarg@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/epos_now_client.rb
+- lib/epos_now_client/client.rb
+- lib/epos_now_client/configuration.rb
+- lib/epos_now_client/connection.rb
+- lib/epos_now_client/error.rb
+- lib/epos_now_client/resources/base_resource.rb
+- lib/epos_now_client/resources/brands.rb
+- lib/epos_now_client/resources/categories.rb
+- lib/epos_now_client/resources/customers.rb
+- lib/epos_now_client/resources/devices.rb
+- lib/epos_now_client/resources/locations.rb
+- lib/epos_now_client/resources/products.rb
+- lib/epos_now_client/resources/staff.rb
+- lib/epos_now_client/resources/tax_groups.rb
+- lib/epos_now_client/resources/tender_types.rb
+- lib/epos_now_client/resources/transactions.rb
+- lib/epos_now_client/version.rb
+homepage: https://github.com/dan1d/epos_now_client
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/dan1d/epos_now_client
+  changelog_uri: https://github.com/dan1d/epos_now_client/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby client for the Epos Now POS API (V4)
+test_files: []