spree_packeta 0.1.0

data/lib/spree_packeta/version.rb

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

data/lib/spree_packeta.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'savon'
+
+require 'spree_packeta/version'
+require 'spree_packeta/configuration'
+
+module SpreePacketa
+  # Custom exceptions
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class ValidationError < Error; end
+  class NotFoundError < Error; end
+  class NetworkError < Error; end
+  class ApiError < Error; end
+end
+
+require 'spree_packeta/engine'

data/lib/tasks/spree_packeta.rake

@@ -0,0 +1,293 @@
+# frozen_string_literal: true
+
+namespace :spree_packeta do
+  desc 'Install Packeta shipping method'
+  task install: :environment do
+    puts 'Installing Packeta shipping method...'
+
+    # Check if Packeta method already exists
+    existing_method = Spree::ShippingMethod.find_by(
+      name: 'Packeta',
+      admin_name: 'Packeta (Zásilkovna)'
+    )
+
+    if existing_method
+      puts '  ⚠️  Packeta shipping method already exists (ID: #{existing_method.id})'
+      puts '  Run rake spree_packeta:uninstall to remove it first'
+      next
+    end
+
+    # Create shipping category if needed
+    shipping_category = Spree::ShippingCategory.find_or_create_by!(name: 'Default') do |sc|
+      puts '  ✓ Created default shipping category'
+    end
+
+    # Find or create zones
+    czech_zone = find_or_create_czech_zone
+    eu_zone = find_or_create_eu_zone
+
+    # Create calculator
+    calculator = SpreePacketa::Models::ShippingCalculator.new
+    calculator.preferences = {
+      amount: 99.0,
+      currency: 'CZK'
+    }
+
+    # Create shipping method
+    shipping_method = Spree::ShippingMethod.new(
+      name: 'Packeta',
+      admin_name: 'Packeta (Zásilkovna)',
+      code: 'packeta',
+      tracking_url: 'https://tracking.packeta.com/:tracking',
+      display_on: 'both',
+      calculator: calculator
+    )
+
+    shipping_method.shipping_categories << shipping_category
+    shipping_method.zones << czech_zone
+    shipping_method.zones << eu_zone if eu_zone
+
+    if shipping_method.save
+      puts "  ✓ Created Packeta shipping method (ID: #{shipping_method.id})"
+      puts "  ✓ Assigned to zones: #{shipping_method.zones.pluck(:name).join(', ')}"
+      puts "  ✓ Base rate: #{calculator.preferences[:amount]} #{calculator.preferences[:currency]}"
+      puts ''
+      puts '✅ Packeta shipping method installed successfully!'
+      puts ''
+      puts 'Next steps:'
+      puts '  1. Configure your API credentials in config/initializers/spree_packeta.rb'
+      puts '  2. Add PACKETA_API_PASSWORD to your environment variables'
+      puts '  3. Adjust shipping rates in Spree admin if needed'
+    else
+      puts "  ❌ Failed to create shipping method: #{shipping_method.errors.full_messages.join(', ')}"
+    end
+  end
+
+  desc 'Uninstall Packeta shipping method'
+  task uninstall: :environment do
+    puts 'Uninstalling Packeta shipping method...'
+
+    methods = Spree::ShippingMethod.where(code: 'packeta')
+    count = methods.count
+
+    if count.zero?
+      puts '  ℹ️  No Packeta shipping methods found'
+    else
+      methods.destroy_all
+      puts "  ✓ Removed #{count} Packeta shipping method(s)"
+      puts '✅ Packeta shipping method uninstalled successfully!'
+    end
+  end
+
+  desc 'Show Packeta shipping method status'
+  task status: :environment do
+    puts 'Packeta Shipping Method Status'
+    puts '=' * 50
+
+    methods = Spree::ShippingMethod.where(code: 'packeta')
+
+    if methods.empty?
+      puts '❌ Not installed'
+      puts ''
+      puts 'Run: rake spree_packeta:install'
+    else
+      methods.each do |method|
+        puts "✅ Installed (ID: #{method.id})"
+        puts ''
+        puts "Name:           #{method.name}"
+        puts "Admin Name:     #{method.admin_name}"
+        puts "Display On:     #{method.display_on}"
+        puts "Available:      #{method.available_to_users? ? 'Yes' : 'No'}"
+        puts "Calculator:     #{method.calculator.class.name}"
+        puts "Zones:          #{method.zones.pluck(:name).join(', ')}"
+        puts "Categories:     #{method.shipping_categories.pluck(:name).join(', ')}"
+
+        if method.calculator.is_a?(SpreePacketa::Models::ShippingCalculator)
+          puts "Base Rate:      #{method.calculator.preferences[:amount]} #{method.calculator.preferences[:currency]}"
+        end
+
+        puts ''
+      end
+    end
+
+    # Show configuration status
+    puts 'Configuration Status'
+    puts '=' * 50
+    config = SpreePacketa.configuration
+
+    check_config('API Password', config.api_password)
+    check_config('SOAP Endpoint', config.soap_endpoint)
+    check_config('WSDL Path', config.wsdl_path)
+    check_config('Eshop ID', config.eshop)
+    check_config('Sender Email', config.sender_email)
+  end
+
+  desc 'Sync tracking status for undelivered Packeta shipments'
+  task sync_tracking: :environment do
+    start_time = Time.current
+
+    # Initialize counters
+    total_count = 0
+    success_count = 0
+    skipped_count = 0
+    error_count = 0
+    errors = []
+
+    # Log start
+    Rails.logger.info('=' * 80)
+    Rails.logger.info("Packeta Tracking Sync Started at #{start_time}")
+    Rails.logger.info("Sync Interval: #{SpreePacketa.configuration.tracking_sync_interval} seconds")
+    Rails.logger.info('=' * 80)
+
+    # Find eligible shipments (has packet, not delivered)
+    eligible_shipments = Spree::Shipment
+                         .where.not(packeta_packet_id: nil)
+                         .where('packeta_status_code < ? OR packeta_status_code IS NULL', 5)
+                         .order(:id)
+
+    # Check if there are any shipments to sync
+    if eligible_shipments.count.zero?
+      Rails.logger.info('No eligible Packeta shipments found for sync')
+      Rails.logger.info('=' * 80)
+      next
+    end
+
+    # Process each shipment
+    eligible_shipments.find_each do |shipment|
+      total_count += 1
+
+      begin
+        tracker = SpreePacketa::Services::Tracker.new(shipment)
+
+        # Check if sync is needed (respects interval)
+        unless tracker.needs_sync?
+          skipped_count += 1
+          next
+        end
+
+        # Perform sync
+        tracker.sync_status!
+        success_count += 1
+
+      rescue SpreePacketa::AuthenticationError => e
+        # Critical error - stop processing
+        Rails.logger.error("CRITICAL: Packeta API authentication failed: #{e.message}")
+        Rails.logger.error('Check PACKETA_API_PASSWORD environment variable')
+        raise
+
+      rescue SpreePacketa::NotFoundError => e
+        # Packet doesn't exist in Packeta system
+        error_count += 1
+        errors << {
+          shipment_id: shipment.id,
+          packet_id: shipment.packeta_packet_id,
+          error: "NotFound: #{e.message}"
+        }
+
+      rescue SpreePacketa::ApiError, SpreePacketa::NetworkError => e
+        # API/network issues
+        error_count += 1
+        errors << {
+          shipment_id: shipment.id,
+          packet_id: shipment.packeta_packet_id,
+          error: "API/Network: #{e.message}"
+        }
+
+      rescue StandardError => e
+        # Unexpected errors
+        error_count += 1
+        errors << {
+          shipment_id: shipment.id,
+          packet_id: shipment.packeta_packet_id,
+          error: "Unexpected: #{e.class} - #{e.message}",
+          backtrace: e.backtrace.first(3)
+        }
+      end
+    end
+
+    # Log error details
+    errors.each do |error_detail|
+      log_message = "Sync failed for shipment #{error_detail[:shipment_id]} " \
+                    "(packet: #{error_detail[:packet_id]}): #{error_detail[:error]}"
+
+      if error_detail[:error].start_with?('NotFound')
+        Rails.logger.warn(log_message)
+      else
+        Rails.logger.error(log_message)
+      end
+
+      if error_detail[:backtrace]
+        Rails.logger.error("  Backtrace: #{error_detail[:backtrace].join("\n  ")}")
+      end
+    end
+
+    # Log summary
+    end_time = Time.current
+    duration = end_time - start_time
+
+    Rails.logger.info('=' * 80)
+    Rails.logger.info("Packeta Tracking Sync Completed at #{end_time}")
+    Rails.logger.info("Total Eligible: #{total_count}")
+    Rails.logger.info("Successfully Synced: #{success_count}")
+    Rails.logger.info("Skipped (no sync needed): #{skipped_count}")
+    Rails.logger.info("Errors: #{error_count}")
+    Rails.logger.info("Duration: #{duration.round(2)} seconds")
+    Rails.logger.info('=' * 80)
+  end
+
+  # Helper methods
+  def find_or_create_czech_zone
+    zone = Spree::Zone.find_by(name: 'Czech Republic')
+
+    unless zone
+      zone = Spree::Zone.create!(
+        name: 'Czech Republic',
+        description: 'Czech Republic',
+        kind: 'country'
+      )
+
+      czech_country = Spree::Country.find_by(iso: 'CZ')
+      if czech_country
+        zone.zone_members.create!(zoneable: czech_country)
+        puts '  ✓ Created Czech Republic zone'
+      else
+        puts '  ⚠️  Czech Republic country not found in database'
+      end
+    end
+
+    zone
+  end
+
+  def find_or_create_eu_zone
+    zone = Spree::Zone.find_by(name: 'EU')
+
+    unless zone
+      eu_countries = %w[AT BE BG HR CY CZ DK EE FI FR DE GR HU IE IT LV LT LU MT NL PL PT RO SK SI ES SE]
+      countries = Spree::Country.where(iso: eu_countries)
+
+      if countries.any?
+        zone = Spree::Zone.create!(
+          name: 'EU',
+          description: 'European Union',
+          kind: 'country'
+        )
+
+        countries.each do |country|
+          zone.zone_members.create!(zoneable: country)
+        end
+
+        puts '  ✓ Created EU zone'
+      else
+        puts '  ⚠️  EU countries not found in database'
+      end
+    end
+
+    zone
+  end
+
+  def check_config(name, value)
+    status = value.present? ? '✅' : '❌'
+    display_value = value.present? ? (value.length > 50 ? "#{value[0..50]}..." : value) : 'Not set'
+    puts "#{status} #{name.ljust(20)}: #{display_value}"
+  end
+end

data/spree_packeta.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative 'lib/spree_packeta/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'spree_packeta'
+  spec.version       = SpreePacketa::VERSION
+  spec.authors       = ['Your Name']
+  spec.email         = ['your.email@example.com']
+
+  spec.summary       = 'Packeta (Zasilkovna) shipping integration for Spree Commerce'
+  spec.description   = 'Integrates Packeta shipping service with Spree Commerce using their SOAP API for packet creation, tracking, and label generation'
+  spec.homepage      = 'https://github.com/yourusername/spree_packeta'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 2.7.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+
+  # Runtime dependencies
+  spec.add_dependency 'spree_core', '~> 5.0'
+  spec.add_dependency 'savon', '~> 2.14'
+  spec.add_dependency 'activesupport', '>= 6.0'
+
+  # Development dependencies
+  spec.add_development_dependency 'rspec-rails', '~> 6.0'
+  spec.add_development_dependency 'vcr', '~> 6.0'
+  spec.add_development_dependency 'webmock', '~> 3.18'
+  spec.add_development_dependency 'factory_bot', '~> 6.2'
+  spec.add_development_dependency 'database_cleaner', '~> 2.0'
+  spec.add_development_dependency 'sqlite3', '~> 1.6'
+  spec.add_development_dependency 'rubocop', '~> 1.50'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.20'
+end

metadata

@@ -0,0 +1,228 @@
+--- !ruby/object:Gem::Specification
+name: spree_packeta
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Your Name
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-12-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: spree_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: factory_bot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  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: sqlite3
+  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: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+description: Integrates Packeta shipping service with Spree Commerce using their SOAP
+  API for packet creation, tracking, and label generation
+email:
+- your.email@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/release.yml"
+- ".github/workflows/test.yml"
+- ".gitignore"
+- CHANGELOG.md
+- COMMANDS.md
+- Gemfile
+- LICENSE
+- README.md
+- app/decorators/spree/order_decorator.rb
+- app/decorators/spree/shipment_decorator.rb
+- db/migrate/20241206000001_add_packeta_tracking_to_shipments.rb
+- docs/RELEASING.md
+- lib/generators/spree_packeta/install_generator.rb
+- lib/generators/spree_packeta/templates/initializer.rb
+- lib/spree_packeta.rb
+- lib/spree_packeta/configuration.rb
+- lib/spree_packeta/engine.rb
+- lib/spree_packeta/models/shipping_calculator.rb
+- lib/spree_packeta/models/shipping_method.rb
+- lib/spree_packeta/services/packet_creator.rb
+- lib/spree_packeta/services/tracker.rb
+- lib/spree_packeta/soap/client.rb
+- lib/spree_packeta/soap/operations.rb
+- lib/spree_packeta/soap/packeta.wsdl
+- lib/spree_packeta/version.rb
+- lib/tasks/spree_packeta.rake
+- spree_packeta.gemspec
+homepage: https://github.com/yourusername/spree_packeta
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/yourusername/spree_packeta
+  source_code_uri: https://github.com/yourusername/spree_packeta
+  changelog_uri: https://github.com/yourusername/spree_packeta/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.27
+signing_key:
+specification_version: 4
+summary: Packeta (Zasilkovna) shipping integration for Spree Commerce
+test_files: []