moloni 0.5.0

data/lib/moloni/configuration.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Moloni
+  class Configuration
+    REQUIRED_ATTRIBUTES = %i[
+      developer_id
+      redirect_uri
+      client_secret
+      refresh_token
+      access_token
+    ].freeze
+
+    attr_accessor :developer_id, :redirect_uri, :client_secret, :refresh_token, :access_token,
+                  :company_id, :access_token_expires_at, :refresh_token_expires_at
+
+    attr_writer :debug
+
+    def initialize
+      @developer_id = ''
+      @redirect_uri = ''
+      @client_secret = ''
+      @refresh_token = ''
+      @access_token = ''
+      @company_id = 0
+      @debug = false
+      @access_token_expires_at = nil
+      @refresh_token_expires_at = nil
+    end
+
+    def debug?
+      @debug
+    end
+
+    def access_token_expired?(margin_seconds: 300)
+      return true if @access_token_expires_at.nil?
+
+      Time.now >= (@access_token_expires_at - margin_seconds)
+    end
+
+    def refresh_token_expired?
+      return true if @refresh_token_expires_at.nil?
+
+      Time.now >= @refresh_token_expires_at
+    end
+  end
+end

data/lib/moloni/errors.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Moloni
+  class APIKeyError < StandardError
+  end
+
+  class GenericError < StandardError
+  end
+
+  class APIError < StandardError
+    attr_reader :errors
+
+    def initialize(message, errors = [])
+      super(message)
+      @errors = errors
+    end
+  end
+
+  class TokenExpiredError < StandardError
+  end
+end

data/lib/moloni/models/company.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Company < BaseModel
+    @intermediate_path = 'companies/'
+
+    # Backward-compatible alias (v0.4 accepted a bare id)
+    def self.find(id)
+      post('getOne/', { company_id: id })
+    end
+
+    def self.check_slug(slug)
+      post('freeSlug/', { slug: })[:valid] == 1
+    end
+  end
+end

data/lib/moloni/models/country.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Country < BaseModel
+    @intermediate_path = 'countries/'
+
+    def self.portugal
+      1
+    end
+  end
+end

data/lib/moloni/models/customer.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Customer < BaseModel
+    @intermediate_path = 'customers/'
+
+    def self.find_by_vat(args)
+      post('getByVat/', args)
+    end
+
+    def self.find_by_email(args)
+      post('getByEmail/', args)
+    end
+
+    def self.find_by_number(args)
+      post('getByNumber/', args)
+    end
+
+    def self.create(args)
+      default_empty_required_params = {
+        salesman_id: '',
+        payment_day: '',
+        discount: '',
+        credit_limit: '',
+        payment_method_id: '',
+        delivery_method_id: ''
+      }
+
+      post('insert/', args.merge(default_empty_required_params))
+    end
+
+    def self.update(args)
+      default_empty_required_params = {
+        salesman_id: '',
+        payment_day: '',
+        discount: '',
+        credit_limit: '',
+        payment_method_id: '',
+        delivery_method_id: ''
+      }
+
+      post('update/', args.merge(default_empty_required_params))
+    end
+  end
+end

data/lib/moloni/models/document.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Document < BaseModel
+    @intermediate_path = 'documents/'
+
+    # Backward-compatible aliases (v0.4 API names)
+    def self.pdf_link(args = {})
+      post('getPDFLink/', args)
+    end
+
+    def self.all_types(args = {})
+      post('getAllDocumentTypes/', args)
+    end
+  end
+end

data/lib/moloni/models/document_set.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class DocumentSet < BaseModel
+    @intermediate_path = 'documentSets/'
+  end
+end

data/lib/moloni/models/invoice.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Invoice < BaseModel
+    @intermediate_path = 'invoices/'
+  end
+end

data/lib/moloni/models/invoice_receipt.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class InvoiceReceipt < BaseModel
+    @intermediate_path = 'invoiceReceipts/'
+  end
+end

data/lib/moloni/models/language.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Language < BaseModel
+    @intermediate_path = 'languages/'
+
+    def self.pt
+      find('pt')
+    end
+
+    def self.en
+      find('en')
+    end
+
+    def self.es
+      find('es')
+    end
+
+    def self.find(code)
+      post('getAll/').select { |el| el[:code].match?(/#{code}/i) }.first
+    end
+  end
+end

data/lib/moloni/models/maturity_date.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class MaturityDate < BaseModel
+    @intermediate_path = 'maturityDates/'
+
+    def self.pronto_pagamento
+      970_080
+    end
+  end
+end

data/lib/moloni/models/payment_method.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class PaymentMethod < BaseModel
+    @intermediate_path = 'paymentMethods/'
+
+    def self.numerario
+      1_068_129
+    end
+  end
+end

data/lib/moloni/models/printer.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Printer < BaseModel
+    @intermediate_path = 'printers/'
+
+    def self.all(args = {})
+      post('getCompanyPrinters/', args)
+    end
+  end
+end

data/lib/moloni/models/product.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Product < BaseModel
+    @intermediate_path = 'products/'
+
+    # Backward-compatible alias (v0.4 API name)
+    # rubocop:disable Naming/MethodName
+    def self.searchByName(args)
+      post('getByName/', args)
+    end
+    # rubocop:enable Naming/MethodName
+
+    def self.search_by_name(args)
+      post('getByName/', args)
+    end
+  end
+end

data/lib/moloni/models/product_category.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class ProductCategory < BaseModel
+    @intermediate_path = 'productCategories/'
+  end
+end

data/lib/moloni/models/product_stock.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class ProductStock < BaseModel
+    @intermediate_path = 'productStocks/'
+  end
+end

data/lib/moloni/models/simplified_invoice.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class SimplifiedInvoice < BaseModel
+    @intermediate_path = 'simplifiedInvoices/'
+  end
+end

data/lib/moloni/models/subscription.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Subscription < BaseModel
+    @intermediate_path = 'subscription/'
+  end
+end

data/lib/moloni/models/supplier.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Supplier < BaseModel
+    @intermediate_path = 'suppliers/'
+
+    def self.find_by_vat(args)
+      post('getByVat/', args)
+    end
+
+    def self.find_by_email(args)
+      post('getByEmail/', args)
+    end
+  end
+end

data/lib/moloni/models/tax.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class Tax < BaseModel
+    @intermediate_path = 'taxes/'
+
+    def self.iva_normal
+      post('getAll/').select { |el| el[:tax_id] == iva_normal_id }.first
+    end
+
+    def self.iva_intermedio
+      post('getAll/').select { |el| el[:tax_id] == iva_intermedio_id }.first
+    end
+
+    def self.iva_reduzido
+      post('getAll/').select { |el| el[:tax_id] == iva_reduzido_id }.first
+    end
+
+    def self.iva_normal_id
+      2_072_734
+    end
+
+    def self.iva_intermedio_id
+      2_072_748
+    end
+
+    def self.iva_reduzido_id
+      2_072_741
+    end
+  end
+end

data/lib/moloni/models/user.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'moloni/base_model'
+
+module Moloni
+  class User < BaseModel
+    @intermediate_path = 'users/'
+
+    def self.me
+      post('getMe/')
+    end
+  end
+end

data/lib/moloni/version.rb

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

data/lib/moloni.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'faraday'
+
+require 'moloni/version'
+require 'moloni/configuration'
+require 'moloni/errors'
+require 'moloni/auth'
+
+module Moloni
+  module_function
+
+  API_PROTOCOL = 'https'
+  API_HOST = 'api.moloni.pt'
+  API_VERSION = 'v1'
+  API_BASE_URL = "#{API_PROTOCOL}://#{API_HOST}/#{API_VERSION}/".freeze
+
+  def config
+    @config ||= Configuration.new
+  end
+
+  def configure
+    yield(config)
+  end
+
+  def connection
+    Faraday.new(url: API_BASE_URL) do |conn|
+      conn.request :json
+      conn.response :logger if config.debug?
+      conn.response :json, parser_options: { symbolize_names: true }
+    end
+  end
+end
+
+# Load models
+require 'moloni/base_model'
+require 'moloni/models/company'
+require 'moloni/models/country'
+require 'moloni/models/customer'
+require 'moloni/models/document'
+require 'moloni/models/document_set'
+require 'moloni/models/invoice'
+require 'moloni/models/invoice_receipt'
+require 'moloni/models/language'
+require 'moloni/models/maturity_date'
+require 'moloni/models/payment_method'
+require 'moloni/models/printer'
+require 'moloni/models/product'
+require 'moloni/models/product_category'
+require 'moloni/models/product_stock'
+require 'moloni/models/simplified_invoice'
+require 'moloni/models/subscription'
+require 'moloni/models/supplier'
+require 'moloni/models/tax'
+require 'moloni/models/user'

data/moloni.gemspec

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative 'lib/moloni/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'moloni'
+  spec.version       = Moloni::VERSION
+  spec.authors       = ['Tiago Pinto']
+  spec.email         = ['tp@tiagopinto.pt']
+
+  spec.summary       = 'A RubyGem to consume the Moloni API.'
+  spec.description   = spec.summary
+  # spec.homepage      = 'TODO: Put your gem's website or public repo URL here.'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.2.0')
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+  # spec.metadata["homepage_uri"] = spec.homepage
+  # spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir = 'bin'
+  spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'addressable', '~> 2.9'
+  spec.add_dependency 'faraday',     '~> 2.14'
+  spec.add_dependency 'launchy',     '~> 3.1'
+  spec.add_dependency 'sinatra',     '~> 4.2'
+
+  spec.add_development_dependency 'bundler', '~> 2.4'
+  spec.add_development_dependency 'dotenv',       '~> 2.8'
+  spec.add_development_dependency 'pry-byebug',   '~> 3.10'
+  spec.add_development_dependency 'rake',         '~> 13.0'
+  spec.add_development_dependency 'rspec',        '~> 3.13'
+  spec.add_development_dependency 'rubocop',      '~> 1.59'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.26'
+  spec.add_development_dependency 'simplecov',    '~> 0.22'
+  spec.add_development_dependency 'webmock',      '~> 3.26'
+end