spree_oxygen_pelatologio 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 37d183e7f183b66f6d87126d0b0cf34a358a25b2b56b0cadbb708a18e5e11cc2
+  data.tar.gz: a75437d806c795623c1c645652d0ec592dd0ea3a03dd362fc95f68d9e8a27ee9
+SHA512:
+  metadata.gz: 07b968463473dfb11b907291eab80ce997a4f06ed3b5dfb0b57ee0538d8eda2f16b4b972b31b49c72ec8e5b98b2d56a54328cc30e3bf0b37c72036d8c468600e
+  data.tar.gz: faa0841cd04899c3f851c7d5cf92c3ad3c9ece75fe1f1162589813ac4ebb06648a1af71db3135e587d0b9ba1d8d25d12ae67e61af825df09505c64e912fa0533

data/LICENSE.md

@@ -0,0 +1,15 @@
+# LICENSE
+
+Copyright (c) 2026 OlympusOne. All rights reserved.
+
+This program is free software: you can redistribute it and/or modify it under the terms of the
+GNU Affero General Public License as published by the Free Software Foundation, either
+version 3 of the License, or any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/).

data/README.md

@@ -0,0 +1,54 @@
+# Spree Oxygen Pelatologio
+
+This is an Oxygen Pelatologio extension for [Spree Commerce](https://spreecommerce.org), an open‑source e-commerce platform built with Ruby on Rails. It adds the ability to sync Oxygen Pelatologio data.
+
+[![Gem Version](https://badge.fury.io/rb/spree_oxygen_pelatologio.svg)](https://badge.fury.io/rb/spree_oxygen_pelatologio)
+
+## Installation
+
+1. Add this extension to your Gemfile with this line:
+
+    ```bash
+    bundle add spree_oxygen_pelatologio
+    ```
+
+## Developing
+
+1. Create a dummy app
+
+    ```bash
+    bundle update
+    bundle exec rake test_app
+    ```
+
+2. Add your new code
+
+3. Run tests
+
+    ```bash
+    bundle exec rspec
+    ```
+
+When testing your applications integration with this extension you may use it's factories.
+Simply add this require statement to your spec_helper:
+
+```ruby
+require 'spree_oxygen_pelatologio/factories'
+```
+
+## Releasing a new version
+
+```bash
+bundle exec gem bump -p -t
+bundle exec gem release
+```
+
+For more options please see [gem-release README](https://github.com/svenfuchs/gem-release)
+
+## Contributing
+
+If you'd like to contribute, please take a look at the
+[instructions](CONTRIBUTING.md) for installing dependencies and crafting a good
+pull request.
+
+Copyright (c) 2026 OlympusOne, released under the AGPL-3.0 or later.

data/Rakefile

@@ -0,0 +1,21 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+require 'spree/testing_support/extension_rake'
+
+RSpec::Core::RakeTask.new
+
+task :default do
+  if Dir['spec/dummy'].empty?
+    Rake::Task[:test_app].invoke
+    Dir.chdir('../../')
+  end
+  Rake::Task[:spec].invoke
+end
+
+desc 'Generates a dummy app for testing'
+task :test_app do
+  ENV['LIB_NAME'] = 'spree_oxygen_pelatologio'
+  Rake::Task['extension:test_app'].invoke
+end

data/app/assets/config/spree_oxygen_pelatologio_manifest.js

@@ -0,0 +1,4 @@
+//= link_tree ../images
+//= link spree_oxygen_pelatologio/application.js
+//= link_tree ../../javascript/spree_oxygen_pelatologio/controllers .js
+

data/app/javascript/spree_oxygen_pelatologio/application.js

@@ -0,0 +1,16 @@
+import '@hotwired/turbo-rails'
+import { Application } from '@hotwired/stimulus'
+
+let application
+
+if (typeof window.Stimulus === "undefined") {
+  application = Application.start()
+  application.debug = false
+  window.Stimulus = application
+} else {
+  application = window.Stimulus
+}
+
+import SpreeOxygenPelatologioController from 'spree_oxygen_pelatologio/controllers/spree_oxygen_pelatologio_controller' 
+
+application.register('spree_oxygen_pelatologio', SpreeOxygenPelatologioController)

data/app/javascript/spree_oxygen_pelatologio/controllers/spree_oxygen_pelatologio_controller.js

@@ -0,0 +1,7 @@
+import { Controller } from '@hotwired/stimulus'
+
+export default class extends Controller {
+  connect() {
+    console.log('Hello, SpreeOxygenPelatologio!')
+  }
+}

data/app/jobs/spree_oxygen_pelatologio/base_job.rb

@@ -0,0 +1,5 @@
+module SpreeOxygenPelatologio
+  class BaseJob < Spree::BaseJob
+    queue_as SpreeOxygenPelatologio.queue
+  end
+end

data/app/lib/spree_oxygen_pelatologio/client.rb

@@ -0,0 +1,108 @@
+module SpreeOxygenPelatologio
+  class Client
+    include Spree::IntegrationsConcern
+
+    SERVICE_ENDPOINTS = {
+      sandbox: 'https://sandbox.api.oxygen.gr/v1/',
+      production: 'https://api.oxygen.gr/v1/'
+    }.freeze
+
+    attr_reader :client
+
+    def initialize
+      @integration = store_integration('oxygen_pelatologio')
+      raise 'Integration not found' unless @integration
+
+      validate!
+    end
+
+    def call(action, **kwargs, &block)
+      case action
+      when :pull_products
+        pull_products(**kwargs, &block)
+      else
+        raise ArgumentError, "Unknown action: #{action}"
+      end
+    end
+
+    private
+
+    def validate!
+      if @integration.preferred_api_key.to_s.strip.empty?
+        raise ConfigurationError, "Oxygen api_key is not configured"
+      end
+    end
+
+    def pull_products(per_page: 100, &block)
+      return enum_for(:pull_products, per_page: per_page) unless block_given?
+
+      params = {
+        per_page: per_page,
+        page: 1
+      }
+
+      loop do
+        result = get('products', params: params)
+
+        yield(result['data'])
+
+        next_link = result.dig('links', 'next')
+        break if next_link.nil?
+
+        params[:page] += 1
+      end
+    end
+
+    def get(path, params: {})
+      uri = build_uri(path, params)
+
+      request = Net::HTTP::Get.new(uri)
+      apply_headers(request)
+
+      perform_request(uri, request)
+    end
+
+    def build_uri(path, params)
+      base_url = SERVICE_ENDPOINTS[@integration.preferred_environment.to_sym]
+      uri = URI.join(base_url, path)
+
+      if params.any?
+        uri.query = URI.encode_www_form(params.compact)
+      end
+
+      uri
+    end
+
+    def apply_headers(request)
+      request["Accept"] = "application/json"
+      request["User-Agent"] = "SpreeOxygenPelatologio/#{SpreeOxygenPelatologio::VERSION}"
+
+      api_key = @integration.preferred_api_key.to_s.strip
+      request["Authorization"] = "Bearer #{api_key}"
+    end
+
+    def perform_request(uri, request)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+
+      response = http.request(request)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        raise ApiError, "Oxygen API error: #{response.code} #{response.message}"
+      end
+
+      parse_json(response.body)
+    rescue Timeout::Error, Errno::ECONNREFUSED, SocketError => e
+      raise ApiError, "Oxygen API connection error: #{e.message}"
+    end
+
+    def parse_json(body)
+      JSON.parse(body)
+    rescue JSON::ParserError => e
+      raise ApiError ,"Invalid JSON from Oxygen: #{e.message}"
+    end
+
+    class ConfigurationError < StandardError; end
+    class ApiError < StandardError; end
+  end
+end

data/app/lib/spree_oxygen_pelatologio/pull_products_worker.rb

@@ -0,0 +1,11 @@
+module SpreeOxygenPelatologio
+  class PullProductsWorker
+    include Sidekiq::Worker
+
+    def perform
+      Rails.logger.info "[SpreeOxygenPelatologio] Starting PullProductsWorker..."
+      SpreeOxygenPelatologio::PullProducts.new.call
+      Rails.logger.info "[SpreeOxygenPelatologio] Finished PullProductsWorker."
+    end
+  end
+end

data/app/models/spree/integrations/oxygen_pelatologio.rb

@@ -0,0 +1,19 @@
+module Spree
+  module Integrations
+    class OxygenPelatologio < Spree::Integration
+      preference :api_key, :string
+      preference :environment, :string, default: 'production'
+
+      validates :preferred_api_key, presence: true
+      validates :preferred_environment, inclusion: { in: %w[production sandbox] }
+
+      def self.integration_group
+        'other'
+      end
+
+      def self.icon_path
+        'integration_icons/oxygen-pelatologio-logo.png'
+      end
+    end
+  end
+end

data/app/services/spree_oxygen_pelatologio/pull_products.rb

@@ -0,0 +1,57 @@
+module SpreeOxygenPelatologio
+  class PullProducts
+    attr_reader :client
+
+    def initialize
+      @client = SpreeOxygenPelatologio::Client.new
+    end
+
+    def call
+      client.call(:pull_products) do |products|
+        products.each { |product| update_product(product) }
+      end
+    end
+
+    private
+
+    def update_product(data)
+      sku = data['code']
+      return if sku.blank?
+
+      variant = Spree::Variant.find_by(sku: sku)
+      return unless variant
+
+      # Update price
+      update_price(variant, data['sale_total_amount'].to_f)
+
+      # Preload once and build a fast lookup by location name
+      stock_items_by_location_name =
+        variant.stock_items.includes(:stock_location).index_by { |si| si.stock_location&.name }
+
+      # Update stock
+      data['warehouses'].each do |wh|
+        location_name = wh['name']
+        qty = wh['quantity'].to_i
+
+        stock_item = stock_items_by_location_name[location_name]
+        next unless stock_item && stock_item.count_on_hand != qty
+
+        variant.set_stock(qty, nil, stock_item.stock_location)
+      end
+    end
+
+    # Update variant price based on new price
+    #
+    # If new price is lower, set it as the current price and keep compare_at_price
+    # If new price is higher, set it as the current price and clear compare_at_price
+    def update_price(variant, new_price)
+      return if variant.price == new_price
+
+      if new_price < variant.price
+        variant.set_price(variant.currency, new_price, variant.compare_at_price)
+      elsif new_price > variant.price
+        variant.set_price(variant.currency, new_price)
+      end
+    end
+  end
+end

data/app/views/spree/admin/integrations/forms/_oxygen_pelatologio.html.erb

@@ -0,0 +1,11 @@
+<div class="col-12 col-md-6 p-0">
+  <div class="card mb-4">
+    <div class="card-body">
+      <%= preference_field(@integration, form, 'api_key', i18n_scope: 'admin.integrations.oxygen_pelatologio') %>
+
+      <div class="form-group">
+        <%= form.spree_select :preferred_environment, options_for_select([['Production', 'production'], ['Sandbox', 'sandbox']], @integration.preferred_environment), label: Spree.t('admin.integrations.oxygen_pelatologio.environment') %>
+      </div>
+    </div>
+  </div>
+</div>

data/app/views/spree_oxygen_pelatologio/_head.html.erb

@@ -0,0 +1 @@
+<%= javascript_import_module_tag 'application-spree-oxygen-pelatologio' %>

data/config/importmap.rb

@@ -0,0 +1,6 @@
+pin 'application-spree-oxygen-pelatologio', to: 'spree_oxygen_pelatologio/application.js', preload: false
+
+pin_all_from SpreeOxygenPelatologio::Engine.root.join('app/javascript/spree_oxygen_pelatologio/controllers'),
+             under: 'spree_oxygen_pelatologio/controllers',
+             to:    'spree_oxygen_pelatologio/controllers',
+             preload: 'application-spree-oxygen-pelatologio'

data/config/initializers/sidekiq-cron.rb

@@ -0,0 +1,28 @@
+Sidekiq.configure_server do |config|
+  config.on(:startup) do
+    puts "[SpreeOxygenPelatologio] Setting up Sidekiq-Cron jobs..."
+
+    store = Spree::Store.default
+
+    integration = store.store_integration('oxygen_pelatologio')
+
+    job_name = "Oxygen Pelatologio Sync - Hourly"
+
+    if integration
+      Sidekiq::Cron::Job.create(
+        name: job_name,
+        namespace: "SpreeOxygenPelatologio",
+        cron: "0 * * * *",
+        class: "SpreeOxygenPelatologio::PullProductsWorker",
+        queue: SpreeOxygenPelatologio.queue,
+        retry: 2
+      )
+
+      Sidekiq.logger.info("[SpreeOxygenPelatologio] Cron job ensured: #{job_name}")
+    else
+      existing = Sidekiq::Cron::Job.find(job_name)
+      existing&.destroy
+      Sidekiq.logger.info("[SpreeOxygenPelatologio] Cron job removed (integration disabled): #{job_name}")
+    end
+  end
+end

data/config/initializers/spree.rb

@@ -0,0 +1,6 @@
+Rails.application.config.after_initialize do
+  Spree.integrations << Spree::Integrations::OxygenPelatologio
+
+  # Admin partials
+  Spree.admin.partials.head << 'spree_oxygen_pelatologio/head'
+end

data/config/locales/el.yml

@@ -0,0 +1,10 @@
+---
+el:
+  spree:
+    admin:
+      integrations:
+        oxygen_pelatologio:
+          title: Oxygen Pelatologio
+          description: Διασύνδεση με τις υπηρεσίες της Oxygen Pelatologio
+          api_key: API Key
+          environment: Περιβάλλον

data/config/locales/en.yml

@@ -0,0 +1,10 @@
+---
+en:
+  spree:
+    admin:
+      integrations:
+        oxygen_pelatologio:
+          title: Oxygen Pelatologio
+          description: Synchronization with Oxygen Pelatologio services
+          api_key: API Key
+          environment: Environment

data/config/routes.rb

@@ -0,0 +1,5 @@
+require "sidekiq/cron/web" # require the cron extension
+
+Spree::Core::Engine.add_routes do
+  # Add your extension routes here
+end

data/lib/spree_oxygen_pelatologio/configuration.rb

@@ -0,0 +1,13 @@
+module SpreeOxygenPelatologio
+  class Configuration < Spree::Preferences::Configuration
+
+   # Some example preferences are shown below, for more information visit:
+   # https://docs.spreecommerce.org/developer/contributing/creating-an-extension
+
+   # preference :enabled, :boolean, default: true
+   # preference :dark_chocolate, :boolean, default: true
+   # preference :color, :string, default: 'Red'
+   # preference :favorite_number, :integer
+   # preference :supported_locales, :array, default: [:en]
+  end
+end

data/lib/spree_oxygen_pelatologio/engine.rb

@@ -0,0 +1,34 @@
+module SpreeOxygenPelatologio
+  class Engine < Rails::Engine
+    require 'spree/core'
+    isolate_namespace Spree
+    engine_name 'spree_oxygen_pelatologio'
+
+    # use rspec for tests
+    config.generators do |g|
+      g.test_framework :rspec
+    end
+
+    initializer 'spree_oxygen_pelatologio.environment', before: :load_config_initializers do |_app|
+      SpreeOxygenPelatologio::Config = SpreeOxygenPelatologio::Configuration.new
+    end
+
+    initializer 'spree_oxygen_pelatologio.assets' do |app|
+      app.config.assets.paths << root.join('app/javascript')
+      app.config.assets.precompile += %w[spree_oxygen_pelatologio_manifest]
+    end
+
+    initializer 'spree_oxygen_pelatologio.importmap', before: 'importmap' do |app|
+      app.config.importmap.paths << root.join('config/importmap.rb')
+      app.config.importmap.cache_sweepers << root.join('app/javascript')
+    end
+
+    def self.activate
+      Dir.glob(File.join(File.dirname(__FILE__), '../../app/**/*_decorator*.rb')) do |c|
+        Rails.configuration.cache_classes ? require(c) : load(c)
+      end
+    end
+
+    config.to_prepare(&method(:activate).to_proc)
+  end
+end

data/lib/spree_oxygen_pelatologio/factories.rb

@@ -0,0 +1,7 @@
+FactoryBot.define do
+  factory :oxygen_pelatologio_integration, class: Spree::Integrations::EltaCourier do
+    active { true }
+    preferred_api_key { ENV['OXYGEN_PELATOLOGIO_API_KEY'] }
+    store { Spree::Store.default }
+  end
+end

data/lib/spree_oxygen_pelatologio/version.rb

@@ -0,0 +1,7 @@
+module SpreeOxygenPelatologio
+  VERSION = '1.0.0'.freeze
+
+  def gem_version
+    Gem::Version.new(VERSION)
+  end
+end

data/lib/spree_oxygen_pelatologio.rb

@@ -0,0 +1,13 @@
+require 'spree_core'
+require 'spree_extension'
+require 'spree_oxygen_pelatologio/engine'
+require 'spree_oxygen_pelatologio/version'
+require 'spree_oxygen_pelatologio/configuration'
+
+module SpreeOxygenPelatologio
+  mattr_accessor :queue
+
+  def self.queue
+    @@queue ||= Spree.queues.default
+  end
+end

data/lib/tasks/pull_products.rake

@@ -0,0 +1,6 @@
+namespace :spree_oxygen_pelatologio do
+  desc "Pull products from Oxygen and sync into Spree"
+  task pull_products: :environment do
+    SpreeOxygenPelatologio::PullProducts.new.call
+  end
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: spree_oxygen_pelatologio
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- OlympusOne
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: spree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.5
+- !ruby/object:Gem::Dependency
+  name: spree_storefront
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.5
+- !ruby/object:Gem::Dependency
+  name: spree_admin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.5
+- !ruby/object:Gem::Dependency
+  name: spree_extension
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sidekiq-cron
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: spree_dev_tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Adds the ability to sync Oxygen Pelatologio data to Spree stores.
+email: info@olympusone.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- Rakefile
+- app/assets/config/spree_oxygen_pelatologio_manifest.js
+- app/assets/images/integration_icons/oxygen-pelatologio-logo.png
+- app/javascript/spree_oxygen_pelatologio/application.js
+- app/javascript/spree_oxygen_pelatologio/controllers/spree_oxygen_pelatologio_controller.js
+- app/jobs/spree_oxygen_pelatologio/base_job.rb
+- app/lib/spree_oxygen_pelatologio/client.rb
+- app/lib/spree_oxygen_pelatologio/pull_products_worker.rb
+- app/models/spree/integrations/oxygen_pelatologio.rb
+- app/services/spree_oxygen_pelatologio/pull_products.rb
+- app/views/spree/admin/integrations/forms/_oxygen_pelatologio.html.erb
+- app/views/spree_oxygen_pelatologio/_head.html.erb
+- config/importmap.rb
+- config/initializers/sidekiq-cron.rb
+- config/initializers/spree.rb
+- config/locales/el.yml
+- config/locales/en.yml
+- config/routes.rb
+- lib/spree_oxygen_pelatologio.rb
+- lib/spree_oxygen_pelatologio/configuration.rb
+- lib/spree_oxygen_pelatologio/engine.rb
+- lib/spree_oxygen_pelatologio/factories.rb
+- lib/spree_oxygen_pelatologio/version.rb
+- lib/tasks/pull_products.rake
+homepage: https://github.com/olympusone/spree_oxygen_pelatologio
+licenses:
+- AGPL-3.0-or-later
+metadata:
+  bug_tracker_uri: https://github.com/olympusone/spree_oxygen_pelatologio/issues
+  changelog_uri: https://github.com/olympusone/spree_oxygen_pelatologio/releases/tag/v1.0.0
+  documentation_uri: https://github.com/olympusone/spree_oxygen_pelatologio
+  homepage_uri: https://github.com/olympusone/spree_oxygen_pelatologio
+  source_code_uri: https://github.com/olympusone/spree_oxygen_pelatologio/tree/v1.0.0
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- none
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Spree Commerce Oxygen Pelatologio Extension
+test_files: []