spree_square 0.1.0

data/db/migrate/20260810180001_create_spree_square_credentials.rb

@@ -0,0 +1,28 @@
+class CreateSpreeSquareCredentials < ActiveRecord::Migration[8.1]
+  def change
+    create_table :spree_square_credentials do |t|
+      t.references :store, null: false, foreign_key: { to_table: :spree_stores }, index: { unique: true }
+
+      # Encrypted at the application layer (ActiveRecord::Encryption, see
+      # SpreeSquare::Credential) — stored as text since encrypted payloads are
+      # longer than the plaintext token.
+      t.text :access_token
+      t.text :refresh_token
+
+      # Square's own merchant identifier — how a webhook payload (which
+      # carries merchant_id, not a store id of ours) gets routed back to the
+      # right store.
+      t.string :square_merchant_id, null: false
+      t.string :square_environment, null: false, default: 'sandbox'
+      t.datetime :expires_at
+      t.datetime :refresh_token_expires_at
+      # `t.json`, not `t.jsonb`/`array: true` — the extension's own dummy
+      # app (spec/dummy) runs on SQLite, which supports neither.
+      t.json :scopes, default: [], null: false
+
+      t.timestamps
+    end
+
+    add_index :spree_square_credentials, :square_merchant_id, unique: true
+  end
+end

data/lib/generators/spree_square/install/install_generator.rb

@@ -0,0 +1,20 @@
+module SpreeSquare
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      class_option :migrate, type: :boolean, default: true
+
+      def add_migrations
+        run 'bundle exec rake railties:install:migrations FROM=spree_square'
+      end
+
+      def run_migrations
+        run_migrations = options[:migrate] || ['', 'y', 'Y'].include?(ask('Would you like to run the migrations now? [Y/n]'))
+        if run_migrations
+          run 'bin/rails db:migrate'
+        else
+          puts 'Skipping rails db:migrate, don\'t forget to run it!'
+        end
+      end
+    end
+  end
+end

data/lib/spree_square/configuration.rb

@@ -0,0 +1,13 @@
+module SpreeSquare
+  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_square/engine.rb

@@ -0,0 +1,65 @@
+module SpreeSquare
+  class Engine < Rails::Engine
+    require 'spree/core'
+    isolate_namespace Spree
+    engine_name 'spree_square'
+
+    config.generators do |g|
+      g.test_framework :rspec
+    end
+
+    initializer 'spree_square.environment', before: :load_config_initializers do |_app|
+      SpreeSquare::Config = SpreeSquare::Configuration.new
+    end
+
+    # Must run before Active Record's own "active_record_encryption.configuration"
+    # initializer reads config.active_record.encryption — a plain
+    # config/initializers/*.rb file is too late (that initializer already
+    # ran by the time :load_config_initializers fires) and fails silently
+    # into "Missing Active Record encryption credential" the first time
+    # SpreeSquare::Credential#access_token is touched. ENV, not
+    # config/credentials.yml.enc, for the same reason as everything else in
+    # this app: spree_host has no credentials.yml.enc, only .env. Living
+    # here (not spree_host) means the dummy test app gets it too, via its
+    # own spec/.env (see spec/spec_helper.rb's `dotenv/load`).
+    initializer 'spree_square.active_record_encryption', before: 'active_record_encryption.configuration' do |app|
+      next if ENV['ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY'].blank?
+
+      app.config.active_record.encryption.primary_key = ENV['ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY']
+      app.config.active_record.encryption.deterministic_key = ENV['ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY']
+      app.config.active_record.encryption.key_derivation_salt = ENV['ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT']
+    end
+
+    initializer 'spree_square.assets' do |app|
+      if app.config.respond_to?(:assets)
+        app.config.assets.paths << root.join('app/javascript')
+        app.config.assets.precompile += %w[spree_square_manifest]
+      end
+    end
+
+    initializer 'spree_square.importmap', before: 'importmap' do |app|
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << root.join('config/importmap.rb')
+        # https://github.com/rails/importmap-rails?tab=readme-ov-file#sweeping-the-cache-in-development-and-test
+        app.config.importmap.cache_sweepers << root.join('app/javascript')
+      end
+    end
+
+    # Decorator files (app/models/spree/*_decorator.rb) intentionally define
+    # a constant Zeitwerk maps to their path (e.g. Spree::LineItemDecorator)
+    # rather than something under the SpreeSquare:: namespace — but with
+    # eager_load off in development, nothing ever references that exact
+    # constant name, so lazy autoloading never triggers it and the
+    # `SomeClass.prepend(...)` line at the bottom of the file never runs.
+    # spree_core's own engine force-loads *its* decorators the same way
+    # (lib/spree/core/engine.rb) — each engine has to do this for its own
+    # app/ tree; there's no shared mechanism that covers extensions too.
+    def self.activate
+      Dir.glob(File.join(File.dirname(__FILE__), '../../app/**/*_decorator*.rb')) do |c|
+        Rails.application.config.cache_classes ? require(c) : load(c)
+      end
+    end
+
+    config.to_prepare(&method(:activate).to_proc)
+  end
+end

data/lib/spree_square/factories.rb

@@ -0,0 +1,16 @@
+FactoryBot.define do
+  # Define your Spree extensions Factories within this file to enable applications, and other extensions to use and override them.
+  #
+  # Example adding this to your spec_helper will load these Factories for use:
+  # require 'spree_square/factories'
+
+  factory :square_credential, class: 'SpreeSquare::Credential' do
+    store
+    sequence(:square_merchant_id) { |i| "MERCHANT#{i}" }
+    access_token { 'test-access-token' }
+    refresh_token { 'test-refresh-token' }
+    square_environment { 'sandbox' }
+    expires_at { 30.days.from_now }
+    refresh_token_expires_at { 90.days.from_now }
+  end
+end

data/lib/spree_square/version.rb

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

data/lib/spree_square.rb

@@ -0,0 +1,12 @@
+require 'spree'
+require 'spree_square/engine'
+require 'spree_square/version'
+require 'spree_square/configuration'
+
+module SpreeSquare
+  mattr_accessor :queue
+
+  def self.queue
+    @@queue ||= Spree.queues.default
+  end
+end

data/lib/tasks/spree_square.rake

@@ -0,0 +1,77 @@
+namespace :spree_square do
+  desc 'M1 verification: list catalog objects from the configured Square sandbox/production account'
+  task list_catalog: :environment do
+    client = SpreeSquare::Client.instance
+
+    puts "Environment: #{ENV.fetch('SQUARE_ENVIRONMENT', 'sandbox')}"
+    puts "Location ID: #{client.location_id}"
+    puts '---'
+
+    count = 0
+    client.catalog.list(types: 'ITEM,CATEGORY,IMAGE,MODIFIER_LIST,MODIFIER').each do |object|
+      count += 1
+      # Fern generates one CatalogObject subclass per `type`, and each only
+      # defines the data accessor for its own type (e.g.
+      # Square::Types::CatalogObjectModifierList has no `item_data` method
+      # at all) — `&.` doesn't help against a NoMethodError, so check
+      # `respond_to?` first.
+      name = %i[item_data category_data modifier_list_data modifier_data image_data]
+             .filter_map { |accessor| object.public_send(accessor)&.name if object.respond_to?(accessor) }
+             .first || '(unnamed)'
+      puts "#{object.type.ljust(14)} #{object.id.ljust(24)} #{name}"
+    end
+
+    puts '---'
+    puts count.zero? ? 'No catalog objects found — this sandbox account has an empty catalog (expected for a fresh account).' : "#{count} object(s) found."
+  end
+
+  desc 'M2: import the full Square catalog (items + categories) into Spree'
+  task import_catalog: :environment do
+    result = SpreeSquare::CatalogImporter.call
+    category_word = result.categories_count == 1 ? 'category' : 'categories'
+    puts "Imported #{result.categories_count} #{category_word} and #{result.items_count} item(s)."
+    puts '---'
+    SpreeSquare::CatalogMapping.where(square_object_type: SpreeSquare::CatalogMapping::ITEM)
+                                .includes(:product).find_each do |mapping|
+      product = mapping.product
+      next unless product
+
+      puts "#{product.slug.ljust(40)} #{product.display_price}"
+    end
+  end
+
+  # Usage: bin/rails "spree_square:setup_webhook[https://<id>.ngrok-free.app/spree_square/webhooks/square]"
+  desc 'M3: create or update the Square webhook subscription for a notification URL'
+  task :setup_webhook, [:url] => :environment do |_, args|
+    url = args[:url]
+    abort 'Usage: bin/rails "spree_square:setup_webhook[https://your-tunnel/spree_square/webhooks/square]"' if url.blank?
+
+    client = SpreeSquare::Client.instance
+    event_types = %w[catalog.version.updated inventory.count.updated order.updated order.fulfillment.updated]
+    existing = client.webhooks.subscriptions.list.find { |s| s.name == 'spree_square' }
+
+    if existing
+      client.webhooks.subscriptions.update(
+        subscription_id: existing.id,
+        subscription: { notification_url: url, event_types: event_types, enabled: true }
+      )
+      # `update` doesn't return the signature key (Square only returns it on
+      # create/rotate) — fetch a fresh one explicitly so we always have a
+      # usable value to put in .env.
+      key_response = client.webhooks.subscriptions.update_signature_key(subscription_id: existing.id)
+      puts "Updated webhook subscription #{existing.id}"
+      puts "Signature key: #{key_response.signature_key}"
+    else
+      response = client.webhooks.subscriptions.create(
+        idempotency_key: SecureRandom.uuid,
+        subscription: { name: 'spree_square', notification_url: url, event_types: event_types }
+      )
+      subscription = response.subscription
+      puts "Created webhook subscription #{subscription.id}"
+      puts "Signature key: #{subscription.signature_key}"
+    end
+
+    puts '---'
+    puts 'Set SQUARE_WEBHOOK_SIGNATURE_KEY in .env to the value above, then recreate the web container.'
+  end
+end

data/lib/tasks/spree_square_demo.rake

@@ -0,0 +1,142 @@
+# Demo/dev convenience, not shipped in the packaged gem (see spree_square.gemspec's
+# `s.files` — this file and demo_menu*/demo_menu_images/ are excluded from `s.files`
+# on purpose: they're restaurant-menu-specific example content, not something every
+# installer of this extension wants bundled in). Kept in the source repo as a
+# reference for how to seed a Square sandbox catalog end to end.
+#
+# square.rb doesn't require this from its main entrypoint (it's an opt-in
+# multipart-upload helper, only needed by tasks that upload files — just this
+# one), so it isn't loaded by `require 'square'` alone.
+require 'square/file_param'
+
+namespace :spree_square do
+  # Demo/dev convenience: populates the configured Square sandbox with a full
+  # restaurant menu (categories, items, prices, photos) so there's something
+  # real to look at besides the starter's single sample item. Square stays
+  # the source of truth even for demo data — this pushes INTO Square, then
+  # runs the normal M2 importer to pull it down into Spree, exactly like a
+  # real menu edit would flow.
+  #
+  # Usage:
+  #   bin/rails spree_square:seed_demo_menu
+  #   CLEAR_CATALOG=true bin/rails spree_square:seed_demo_menu   # wipe the sandbox catalog first
+  #
+  # Re-running without CLEAR_CATALOG=true creates duplicate items — Square's
+  # batch-upsert only updates in place when given a real (non-temporary)
+  # object id, and this task always creates fresh ones. Fine for a sandbox;
+  # clear first if you want a clean slate.
+  desc 'Demo: seed the Square sandbox catalog with a full sample restaurant menu (with photos)'
+  task seed_demo_menu: :environment do
+    client = SpreeSquare::Client.instance
+    menu_path = File.join(__dir__, 'demo_menu.json')
+    images_dir = File.join(__dir__, 'demo_menu_images')
+    menu = JSON.parse(File.read(menu_path))
+
+    if ActiveModel::Type::Boolean.new.cast(ENV['CLEAR_CATALOG'])
+      existing_ids = client.catalog.list(types: 'ITEM,CATEGORY,IMAGE,MODIFIER_LIST,MODIFIER').map(&:id)
+      if existing_ids.any?
+        existing_ids.each_slice(200) { |slice| client.catalog.batch_delete(object_ids: slice) }
+        puts "Cleared #{existing_ids.size} existing catalog object(s)."
+        # BatchDeleteCatalogObjects is immediately consistent for direct
+        # reads, but the SearchCatalogObjects index (what both this task's
+        # own duplicate-check below and CatalogImporter use) lags behind by
+        # a few seconds — without this pause, the import at the end of this
+        # task can still see the just-deleted objects and create duplicate
+        # Spree categories/products before Square's index catches up.
+        sleep 5
+      end
+    end
+
+    objects = []
+    menu.each_key do |category_name|
+      objects << {
+        type: 'CATEGORY',
+        id: "#cat-#{category_name.parameterize}",
+        category_data: { name: category_name }
+      }
+    end
+
+    menu.each do |category_name, items|
+      items.each do |item|
+        item_temp_id = "#item-#{item['image_slug']}"
+        objects << {
+          type: 'ITEM',
+          id: item_temp_id,
+          item_data: {
+            name: item['name'],
+            description: item['description'],
+            # `category_id` (singular) is a legacy field this Square API
+            # version silently drops on write — verified by round-tripping
+            # a test item through upsert and reading it back via search:
+            # category_id came back nil every time, `categories` (array)
+            # is what actually persists. CatalogObjectMapper#assign_taxons!
+            # already reads both, so no mapper change needed.
+            categories: [{ id: "#cat-#{category_name.parameterize}" }],
+            variations: [
+              {
+                type: 'ITEM_VARIATION',
+                id: "#{item_temp_id}-regular",
+                item_variation_data: {
+                  name: 'Regular',
+                  pricing_type: 'FIXED_PRICING',
+                  price_money: { amount: item['price_cents'], currency: 'USD' }
+                }
+              }
+            ]
+          }
+        }
+      end
+    end
+
+    puts "Pushing #{menu.values.sum(&:size)} item(s) across #{menu.size} categories to Square..."
+    response = client.catalog.batch_upsert(
+      idempotency_key: SecureRandom.uuid,
+      batches: [{ objects: objects }]
+    )
+    # `object_id_` (trailing underscore), not `object_id` — the SDK avoids
+    # shadowing Ruby's own Object#object_id; `api_name: "object_id"` is just
+    # the JSON wire name.
+    id_by_temp_id = response.id_mappings.to_h { |m| [m.client_object_id, m.object_id_] }
+
+    puts 'Uploading photos...'
+    uploaded = 0
+    menu.each_value do |items|
+      items.each do |item|
+        item_temp_id = "#item-#{item['image_slug']}"
+        real_item_id = id_by_temp_id[item_temp_id]
+        image_path = File.join(images_dir, "#{item['image_slug']}.jpg")
+        unless real_item_id && File.exist?(image_path)
+          puts "  skipped #{item['name']} (no #{real_item_id ? 'image file' : 'mapped id'})"
+          next
+        end
+
+        # `images.create`'s multipart builder writes `request:` verbatim
+        # (Square::Internal::Multipart::FormData#add has no Hash case, only
+        # String/Integer/Float/Boolean/#read) — an unserialized Hash gets
+        # written as Ruby's `Hash#to_s`, not JSON, so the request must be
+        # JSON-encoded ourselves first.
+        client.catalog.images.create(
+          request: {
+            idempotency_key: SecureRandom.uuid,
+            object_id: real_item_id,
+            image: { type: 'IMAGE', id: "#image-#{item['image_slug']}", image_data: { name: "#{item['name']} photo" } },
+            is_primary: true
+          }.to_json,
+          image_file: Square::FileParam.from_filepath(filepath: image_path, content_type: 'image/jpeg')
+        )
+        uploaded += 1
+      end
+    end
+    puts "Uploaded #{uploaded} photo(s)."
+
+    puts '---'
+    puts 'Importing into Spree...'
+    # Square's SearchCatalogObjects index lagged the writes above by well
+    # over 10s in practice during development of this task — a short pause
+    # isn't enough to trust the search results that CatalogImporter relies on.
+    sleep 20
+    result = SpreeSquare::CatalogImporter.call
+    puts "Imported #{result.categories_count} categories and #{result.items_count} item(s) into Spree."
+    puts 'If any items are missing, they just need the index to catch up — re-run: bin/rails spree_square:import_catalog'
+  end
+end

data/spree_square.gemspec

@@ -0,0 +1,56 @@
+# encoding: UTF-8
+lib = File.expand_path('../lib/', __FILE__)
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
+
+require 'spree_square/version'
+
+Gem::Specification.new do |s|
+  s.platform    = Gem::Platform::RUBY
+  s.name        = 'spree_square'
+  s.version     = SpreeSquare::VERSION
+  s.summary     = 'Spree Commerce Square Extension'
+  s.description = 'Syncs a Square catalog (items, variations, categories, images, modifiers) into ' \
+                   'Spree Commerce, pushes completed Spree orders into Square as paid tickets, and ' \
+                   'keeps fulfillment status in sync in both directions via webhooks. Supports ' \
+                   'self-service OAuth ("Connect to Square" in the admin) as well as a hand-issued ' \
+                   'access token for local development.'
+  s.required_ruby_version = '>= 3.2'
+
+  s.author    = 'Amit Solanki'
+  s.email     = 'amitkssolanki@gmail.com'
+  s.homepage  = 'https://github.com/amitkssolanki/spree_square'
+  s.license   = 'MIT'
+
+  s.metadata = {
+    'homepage_uri' => s.homepage,
+    'source_code_uri' => s.homepage,
+    'changelog_uri' => "#{s.homepage}/blob/main/CHANGELOG.md",
+    'bug_tracker_uri' => "#{s.homepage}/issues"
+  }
+
+  # `git ls-files` (not a manual Dir[] glob) so the package always matches
+  # what's actually tracked in the repo — and so the demo-menu example
+  # content below (restaurant-specific, not something every installer wants
+  # bundled in) can be excluded by path without needing to keep two lists in
+  # sync by hand.
+  s.files = `git ls-files -z`.split("\x0").reject do |f|
+    (f.start_with?('spec/') && !f.start_with?('spec/fixtures')) ||
+      f.start_with?('lib/tasks/demo_menu')
+  end
+  s.require_path = 'lib'
+  s.requirements << 'none'
+
+  spree_version = '>= 5.4.0.beta'
+  s.add_dependency 'spree', spree_version
+  s.add_dependency 'spree_admin', spree_version
+
+  # Square's official Ruby SDK. Current major (Fern-generated) uses
+  # Square::Client.new(token:) / square.orders.create(...) — NOT the legacy
+  # client.orders_api.create_order shape most tutorials show (that's the
+  # square_legacy export within this same gem; we don't use it).
+  s.add_dependency 'square.rb', '~> 46.0'
+
+  s.add_development_dependency 'spree_dev_tools'
+  s.add_development_dependency 'webmock'
+  s.add_development_dependency 'gem-release'
+end

metadata

@@ -0,0 +1,218 @@
+--- !ruby/object:Gem::Specification
+name: spree_square
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Amit Solanki
+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.4.0.beta
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+- !ruby/object:Gem::Dependency
+  name: spree_admin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+- !ruby/object:Gem::Dependency
+  name: square.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '46.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '46.0'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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'
+- !ruby/object:Gem::Dependency
+  name: gem-release
+  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: Syncs a Square catalog (items, variations, categories, images, modifiers)
+  into Spree Commerce, pushes completed Spree orders into Square as paid tickets,
+  and keeps fulfillment status in sync in both directions via webhooks. Supports self-service
+  OAuth ("Connect to Square" in the admin) as well as a hand-issued access token for
+  local development.
+email: amitkssolanki@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env"
+- ".gem_release.yml"
+- ".github/.dependabot.yml"
+- ".github/workflows/tests.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- app/.gitkeep
+- app/assets/config/spree_square_manifest.js
+- app/assets/images/.keep
+- app/controllers/spree/admin/square_oauth_controller.rb
+- app/controllers/spree/admin/square_order_mappings_controller.rb
+- app/controllers/spree/admin/square_webhook_events_controller.rb
+- app/controllers/spree_square/webhooks_controller.rb
+- app/javascript/spree_square/application.js
+- app/javascript/spree_square/controllers/spree_square_controller.js
+- app/jobs/spree_square/base_job.rb
+- app/jobs/spree_square/catalog_webhook_job.rb
+- app/jobs/spree_square/inventory_webhook_job.rb
+- app/jobs/spree_square/order_push_job.rb
+- app/jobs/spree_square/order_webhook_job.rb
+- app/jobs/spree_square/reconciliation_job.rb
+- app/models/spree/line_item_decorator.rb
+- app/models/spree/variant_decorator.rb
+- app/models/spree_square/catalog_mapping.rb
+- app/models/spree_square/credential.rb
+- app/models/spree_square/line_item_modifier.rb
+- app/models/spree_square/location_mapping.rb
+- app/models/spree_square/modifier.rb
+- app/models/spree_square/modifier_list.rb
+- app/models/spree_square/order_mapping.rb
+- app/models/spree_square/product_modifier_list.rb
+- app/models/spree_square/taxon_mapping.rb
+- app/models/spree_square/webhook_event.rb
+- app/serializers/spree_square/line_item_serializer.rb
+- app/serializers/spree_square/product_serializer.rb
+- app/services/spree_square/alerting.rb
+- app/services/spree_square/cart/add_item.rb
+- app/services/spree_square/catalog_importer.rb
+- app/services/spree_square/catalog_object_mapper.rb
+- app/services/spree_square/client.rb
+- app/services/spree_square/find_line_item_by_variant.rb
+- app/services/spree_square/inventory_sync.rb
+- app/services/spree_square/oauth_client.rb
+- app/services/spree_square/order_builder.rb
+- app/services/spree_square/order_pusher.rb
+- app/services/spree_square/order_status_mapper.rb
+- app/services/spree_square/revalidator.rb
+- app/services/spree_square/webhook_verifier.rb
+- app/subscribers/spree_square/order_completed_subscriber.rb
+- app/views/spree/admin/square_oauth/show.html.erb
+- app/views/spree/admin/square_order_mappings/index.html.erb
+- app/views/spree/admin/square_webhook_events/index.html.erb
+- bin/importmap
+- bin/rails
+- config/importmap.rb
+- config/initializers/spree.rb
+- config/initializers/spree_admin_square_navigation.rb
+- config/initializers/spree_admin_square_tables.rb
+- config/locales/en.yml
+- config/routes.rb
+- db/migrate/20260809120001_create_spree_square_location_mappings.rb
+- db/migrate/20260809120002_create_spree_square_taxon_mappings.rb
+- db/migrate/20260809120003_create_spree_square_catalog_mappings.rb
+- db/migrate/20260809140001_create_spree_square_webhook_events.rb
+- db/migrate/20260809160001_create_spree_square_modifier_lists.rb
+- db/migrate/20260809160002_create_spree_square_modifiers.rb
+- db/migrate/20260809160003_create_spree_square_product_modifier_lists.rb
+- db/migrate/20260809160004_create_spree_square_line_item_modifiers.rb
+- db/migrate/20260809170001_create_spree_square_order_mappings.rb
+- db/migrate/20260810180001_create_spree_square_credentials.rb
+- lib/generators/spree_square/install/install_generator.rb
+- lib/spree_square.rb
+- lib/spree_square/configuration.rb
+- lib/spree_square/engine.rb
+- lib/spree_square/factories.rb
+- lib/spree_square/version.rb
+- lib/tasks/spree_square.rake
+- lib/tasks/spree_square_demo.rake
+- spree_square.gemspec
+homepage: https://github.com/amitkssolanki/spree_square
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/amitkssolanki/spree_square
+  source_code_uri: https://github.com/amitkssolanki/spree_square
+  changelog_uri: https://github.com/amitkssolanki/spree_square/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/amitkssolanki/spree_square/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+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 Square Extension
+test_files: []