go_puff-prodcat_api 0.9.3.pre.beta.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cafafb2612024979cba9817f96491e4e22b73130dcefb6c8350115b94ede645e
+  data.tar.gz: 0732ad8826d7700e2ae9fc2deb55253898fbbd75779d829ab6c15a0830b95322
+SHA512:
+  metadata.gz: 20383f6ef52524106ddd987952c4ca6e621f56fb789e73ad7f28668b37c5258c8a99b61a705e0fa2803614feb9d984becf3b019aca4745f2f3527df51ef19dcb
+  data.tar.gz: 0af72f4671b63f556c4f691db1bb454940f96d08454d1667fdb728a7d9cc66c2076df46626e46a3689cb13b96ce92299a05a0900002782d7dd54f1b4d8c6b275

data/.bundle/config.example

@@ -0,0 +1,3 @@
+---
+BUNDLE_HTTPS://RUBYGEMS__PKG__GITHUB__COM/GOPUFF/: "GITHUB_USERNAME:PERSONAL_ACCESS_TOKEN"
+

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,64 @@
+require:
+  - rubocop-thread_safety
+  - rubocop-rspec
+  - rubocop-performance
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 2.6.6
+  SuggestExtensions: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Layout/LineLength:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/NamedSubject:
+  Enabled: false
+
+RSpec/VerifiedDoubles:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Max: 11
+
+ThreadSafety/InstanceVariableInClassMethod:
+  Exclude:
+    - lib/go_puff/prodcat_api.rb
+ThreadSafety/ClassAndModuleAttributes:
+  Exclude:
+    - lib/go_puff/prodcat_api.rb
+RSpec/AnyInstance:
+  Exclude:
+    - spec/spec_helper.rb
+    - spec/go_puff/prodcat_api/configuration_spec.rb
+
+RSpec/MultipleMemoizedHelpers:
+  Exclude:
+    - spec/go_puff/prodcat_api/memo_spec.rb
+    - spec/go_puff/prodcat_api/fetch_products_spec.rb
+
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - lib/go_puff/prodcat_api/fetch_products.rb
+
+RSpec/NestedGroups:
+  Exclude:
+    - spec/go_puff/prodcat_api/structs_spec.rb
+    - spec/go_puff/prodcat_api/type_utility_spec.rb

data/Dockerfile

@@ -0,0 +1,22 @@
+FROM ruby:2.7-slim
+
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+    bash less git \
+    build-essential ruby-dev \
+ && apt-get clean
+
+ENV APP_HOME /app
+
+ENV BUNDLE_GEMFILE=$APP_HOME/Gemfile \
+    BUNDLE_JOBS=8 \
+    BUNDLE_PATH=/gems
+
+RUN mkdir $APP_HOME
+
+WORKDIR $APP_HOME
+
+ADD Gemfile $APP_HOME/Gemfile
+ADD Gemfile.lock $APP_HOME/Gemfile.lock
+
+RUN gem install bundler --no-document

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+source 'https://rubygems.pkg.github.com/gopuff'
+# Specify your gem's dependencies in go_puff-prodcat_api.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,112 @@
+PATH
+  remote: .
+  specs:
+    go_puff-prodcat_api (0.9.3.pre.beta.1)
+      go_puff-http-client (~> 0.5)
+      retryable
+
+GEM
+  remote: https://rubygems.org/
+  remote: https://rubygems.pkg.github.com/gopuff/
+  specs:
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.2)
+    coderay (1.1.3)
+    connection_pool (2.3.0)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    faraday (2.7.4)
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-net_http (3.0.2)
+    faraday-net_http_persistent (2.1.0)
+      faraday (~> 2.5)
+      net-http-persistent (~> 4.0)
+    go_puff-http-client (0.5.1)
+      faraday (~> 2.5)
+      faraday-net_http_persistent (~> 2.1)
+    hashdiff (1.0.1)
+    method_source (1.0.0)
+    net-http-persistent (4.0.1)
+      connection_pool (~> 2.2)
+    parallel (1.22.1)
+    parser (3.1.2.0)
+      ast (~> 2.4.1)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (4.0.7)
+    rainbow (3.1.1)
+    regexp_parser (2.4.0)
+    retryable (3.0.5)
+    rexml (3.2.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    rubocop (1.29.1)
+      parallel (~> 1.10)
+      parser (>= 3.1.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.17.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.17.0)
+      parser (>= 3.1.1.0)
+    rubocop-performance (1.13.3)
+      rubocop (>= 1.7.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rspec (2.10.0)
+      rubocop (~> 1.19)
+    rubocop-thread_safety (0.4.4)
+      rubocop (>= 0.53.0)
+    ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov-lcov (0.8.0)
+    simplecov_json_formatter (0.1.4)
+    unicode-display_width (2.1.0)
+    webmock (3.14.0)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  aarch64-linux
+  x86_64-darwin-18
+  x86_64-darwin-22
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  go_puff-prodcat_api!
+  pry (~> 0.14)
+  rspec (~> 3.0)
+  rubocop (~> 1.25)
+  rubocop-performance
+  rubocop-rspec
+  rubocop-thread_safety (~> 0.4)
+  simplecov (~> 0.21)
+  simplecov-lcov (~> 0.8.0)
+  webmock (~> 3.5)
+
+BUNDLED WITH
+   2.3.22

data/README.md

@@ -0,0 +1,62 @@
+# GoPuff::ProdcatApi
+[![Coverage Status](https://coveralls.io/repos/github/gopuff/go_puff-prodcat_api/badge.svg?branch=main&t=K8IagK)](https://coveralls.io/github/gopuff/go_puff-prodcat_api?branch=main)
+
+This Rails library is designed to work with product-catalog/pds api
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+source 'https://rubygems.pkg.github.com/gopuff' do
+  gem 'go_puff-prodcat_api'
+end
+```
+
+And then execute:
+
+    $ bundle install
+
+## Set up
+```ruby
+# config/initializers/prodcat_api.rb
+
+GoPuff::ProdcatApi.configure do |c|
+  c.logger = GoPuff::Logger
+  c.url = ENV.fetch('PDS_API_URL')
+  c.authorization_client_id = ENV.fetch('PRODCAT_API_AUTHORIZATION_CLIENT_ID')
+  c.user_agent_header = GoPuff::Http.config.user_agent_header
+
+  # config.requests.max_retries = 3 # default
+  # config.requests.retry_wait_time = 0.5 # default
+  # config.requests.retryable_exceptions = [EOFError, Errno::ECONNRESET, Timeout::Error, GoPuff::ProdcatApi::ServerError, GoPuff::ProdcatApi::ClientError, GoPuff::ProdcatApi::TimeoutError] # default
+end
+```
+
+## Local development with docker
+Authorize personal access token for Github by following the steps at https://docs.github.com/en/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on
+
+
+```bash
+cp .bundle/config.example .bundle/config
+```
+Add Github username and personal access token in `./bundle/config` and start project using:
+
+```bash
+docker-compose run --rm go_puff-prodcat_api bash
+```
+or with [dip](https://github.com/bibendi/dip#installation)
+
+```bash
+dip bash
+```
+
+## Contributing
+
+Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.
+
+1. Clone the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'go_puff/prodcat_api'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/rspec

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle', __dir__)
+
+if File.file?(bundle_binstub)
+  if /This file was generated by Bundler/.match?(File.read(bundle_binstub, 300))
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/bin/rubocop

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle', __dir__)
+
+if File.file?(bundle_binstub)
+  if /This file was generated by Bundler/.match?(File.read(bundle_binstub, 300))
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rubocop', 'rubocop')

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/dip.yml

@@ -0,0 +1,23 @@
+version: '2'
+
+environment:
+  RAILS_ENV: development
+
+compose:
+  files:
+    - docker-compose.yml
+
+interaction:
+  bash:
+    service: go_puff-prodcat_api
+    command: /bin/bash
+    compose_run_options: [no-deps]
+  bundle:
+    service: go_puff-prodcat_api
+    command: bundle
+  rake:
+    service: go_puff-prodcat_api
+    command: bundle exec rake
+  rspec:
+    service: go_puff-prodcat_api
+    command: bundle exec rspec

data/docker-compose.yml

@@ -0,0 +1,12 @@
+version: '3.4'
+
+services:
+  go_puff-prodcat_api:
+    build:
+      context: .
+    volumes:
+      - .:/app
+      - go_puff-prodcat_api-gems:/gems
+      - ./.bundle/config:/root/.bundle/config
+volumes:
+  go_puff-prodcat_api-gems:

data/lefthook.yml

@@ -0,0 +1,6 @@
+pre-commit:
+  commands:
+    rubocop:
+      files: git diff --name-only --staged
+      glob: "*.rb"
+      run: rubocop --force-exclusion {files}

data/lib/go_puff/prodcat_api/configuration.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    class Configuration
+      attr_accessor :url, :authorization_client_id, :requests, :logger, :user_agent_header
+
+      def initialize
+        @requests = Struct.new(:max_retries, :retry_wait_time, :retryable_exceptions) do
+          def to_h
+            {
+              on: retryable_exceptions,
+              tries: max_retries,
+              sleep: retry_wait_time
+            }
+          end
+        end.new(3, 0.5, [GoPuff::ProdcatApi::InvalidJsonResponseError, GoPuff::ProdcatApi::HttpError])
+      end
+
+      def validate!
+        raise ConfigError, 'Undefined url configuration in config/initializers/prodcat_api.rb' if url.nil?
+        raise ConfigError, 'Undefined authorization_client_id configuration in config/initializers/prodcat_api.rb' if authorization_client_id.nil?
+        raise ConfigError, 'Undefined logger configuration in config/initializers/prodcat_api.rb' if logger.nil?
+        raise ConfigError, 'Undefined user_agent_header configuration in config/initializers/go_puff-http-client.rb' if user_agent_header.nil?
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/errors.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    class Error < StandardError
+    end
+
+    class HttpError < Error
+      attr_reader :original
+
+      def initialize(msg, original = $ERROR_INFO)
+        super(msg)
+        @original = original
+      end
+    end
+
+    class ConfigError < Error; end
+
+    class InvalidJsonResponseError < Error
+      def initialize(msg, code, body = nil)
+        msg += " | code: #{code}"
+        msg += " | body: #{body}" if body
+        super(msg)
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/fetch_product.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    class FetchProduct < FetchProducts
+      def initialize(product_id:, location_id:, point_of_sale: 'US', headers: {}, thread: nil)
+        super(
+          product_ids: [product_id],
+          location_id: location_id,
+          point_of_sale: point_of_sale,
+          headers: headers,
+          thread: thread,
+        )
+      end
+
+      def call
+        super&.first
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/fetch_products.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require_relative './errors'
+require_relative './memo'
+require_relative './structs'
+
+module GoPuff
+  module ProdcatApi
+    class FetchProducts
+      include Structs
+
+      attr_reader :time, :memo, :thread
+
+      TIMEOUT = 5
+
+      def initialize(product_ids:, location_id:, point_of_sale: 'US', headers: {}, thread: nil)
+        @location_id = location_id
+        @product_ids = product_ids.compact
+        @point_of_sale = point_of_sale
+        @headers = headers
+        @thread = thread
+
+        @memo = Memo.new(product_ids, location_id, point_of_sale, thread) if thread && web?
+      end
+
+      def self.call(*args, **kwargs, &block)
+        new(*args, **kwargs, &block).call
+      end
+
+      def call
+        return [] if @product_ids.empty? || @location_id.nil?
+
+        return memo.products if web? && memo&.exist?
+
+        Retryable.retryable(GoPuff::ProdcatApi.config.requests.to_h) do
+          make_request
+        end
+
+        products = parse_response
+
+        memo&.add(products) if web?
+
+        products
+      end
+
+      private
+
+      def make_request
+        @response = GoPuff::Http::Client.new(uri.to_s, adapter: :net_http_persistent, timeout: TIMEOUT).get(headers: headers, json: false)
+        raise(HttpError, "#{@response.error_message} | #{@response.status}") unless @response.success?
+
+        @response_json = JSON.parse(@response.body)
+      rescue JSON::ParserError => _e
+        raise InvalidJsonResponseError.new(uri.to_s, parse_code_from_body, @response.body)
+      rescue StandardError => e
+        raise HttpError, e
+      end
+
+      def web?
+        return false unless defined?(Sidekiq)
+
+        !Sidekiq.server?.nil?
+      end
+
+      def uri
+        @uri ||= begin
+          uri = URI("#{url}/api/products")
+          uri.query = "product_ids=#{@product_ids.join(',')}&location_id=#{@location_id}&page_size=#{@product_ids.size}"
+          uri.query += '&datasource=eventing' if Flipper.enabled?(:puff_77780_change_split_for_bundles)
+          uri
+        end
+      end
+
+      def url
+        GoPuff::ProdcatApi.config.url
+      end
+
+      def parse_code_from_body
+        code = @response.body[/\d+/].to_i
+        return 500 if code.zero?
+
+        code
+      end
+
+      def parse_response
+        @prodcat_products = @response_json['products'].map do |product|
+          ProductStruct.new.tap do |struct|
+            struct.product_id = product['product_id']
+            struct.price = product['price']
+            struct.offer = product['offer']
+            struct.cost = product['cost']
+            struct.kind = kind(product)
+            struct.is_rx = product['is_rx']
+            struct.is_sip = product['is_sip']
+            struct.is_digital = product['is_digital']
+            struct.currency = product['currency']
+            struct.subcategory_id = product['subcategory_id']
+            struct.primary_subcategory_id = product['primary_subcategory_id']
+            struct.quantity = product['quantity']
+            struct.available_for_bonus = product['available_for_bonus']
+            struct.bundle = product['bundle']
+            struct.is_sample = TypeUtility.to_boolean(product['is_sample'])
+            struct.classifications = product['classifications'] || []
+
+            struct.bundle_products = product['bundleProducts']&.map do |bundle_product|
+              BundleProductStruct.new.tap do |bp_struct|
+                bp_struct.product_id = bundle_product['product_id'].to_i
+                bp_struct.quantity = bundle_product['quantity']
+                bp_struct.cost = bundle_product['cost']
+              end
+            end
+            struct.images = product['images']&.map do |product_image|
+              ImageStruct.new.tap do |img_struct|
+                img_struct.small = product_image['small']
+                img_struct.thumb = product_image['thumb']
+                img_struct.medium = product_image['medium']
+                img_struct.xlarge = product_image['xlarge']
+                img_struct.tile_image_alt_text = product_image['tile_image_alt_text']
+              end
+            end
+            struct.avatar = AvatarStruct.new.tap do |avatar_struct|
+              avatar_struct.small = product.dig('avatar', 'small')
+              avatar_struct.thumb = product.dig('avatar', 'thumb')
+              avatar_struct.medium = product.dig('avatar', 'medium')
+              avatar_struct.xlarge = product.dig('avatar', 'xlarge')
+              avatar_struct.tile_image_alt_text = product.dig('avatar', 'tile_image_alt_text')
+            end
+            struct.upc_barcodes = product['upc']
+            GoPuff::ProdcatApi.config.logger.info('Prodcat api product item',
+                                                  log_parent_key: :prodcat_api_product_item,
+                                                  params: { **struct.to_h, point_of_sale: @point_of_sale })
+          end
+        end
+      end
+
+      def headers
+        {
+          'Content-Type' => 'application/json',
+          'Authorization-Client-ID' => GoPuff::ProdcatApi.config.authorization_client_id,
+          'X-GP-Point-Of-Sale' => @point_of_sale,
+          'X-AMZN-TRACE-ID' => @headers['X-AMZN-TRACEID'],
+          'X-APPGW-TRACE-ID' => @headers['X-APPGW_TRACE-ID'],
+          'X-MS-REQUEST-ID' => @headers['X-MS-REQUEST-ID'],
+          'X-MS-REQUEST-ROOT-ID' => @headers['X-MS-REQUEST-ROOT-ID'],
+          'REQUEST-ID' => @headers['REQUEST-ID'],
+          'TRACEPARENT' => @headers['TRACEPARENT']
+        }.compact
+      end
+
+      def kind(product)
+        return product['kind'] if product['bundle_info'].nil? || product['bundle_info'].empty?
+        return 'alcohol' if product['bundle_info']['products'].map { |item| item['kind'] }.include? 'alcohol'
+
+        product['bundle_info']['products'][0]['kind']
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/memo.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    class Memo
+      CACHE_NAMESPACE = :pds_api_product_cache
+
+      attr_reader :product_ids, :location_id, :point_of_sale, :thread
+
+      def initialize(product_ids, location_id, point_of_sale, thread)
+        @product_ids = product_ids
+        @location_id = location_id
+        @point_of_sale = point_of_sale
+        @thread = thread
+      end
+
+      def products
+        cache = thread[CACHE_NAMESPACE]
+
+        return if cache.nil?
+
+        product_ids.lazy.uniq.map { |id| product_key(id) }.map { |key| cache[key] }.to_a
+      end
+
+      def exist?
+        cache = thread[CACHE_NAMESPACE]
+
+        return false if cache.nil?
+
+        product_ids.lazy.map { |id| product_key(id) }.all? { |key| cache[key] }
+      end
+
+      def add(products)
+        thread[CACHE_NAMESPACE] ||= {}
+        cache = thread[CACHE_NAMESPACE]
+
+        products.each do |product|
+          key = product_key(product.product_id)
+
+          cache[key] = product
+        end
+      end
+
+      private
+
+      def product_key(product_id)
+        "#{point_of_sale}_#{location_id}_#{product_id}"
+      end
+
+      class << self
+        def delete
+          Thread.current[CACHE_NAMESPACE] = nil
+        end
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/product_hydration/look_up_by_barcode.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    module ProductHydration
+      class LookUpByBarcode
+        include Structs
+
+        TIMEOUT = 5
+
+        def initialize(barcode, point_of_sale: 'US')
+          @barcode = barcode
+          @point_of_sale = point_of_sale
+        end
+
+        def self.call(*args, **kwargs, &block)
+          new(*args, **kwargs, &block).call
+        end
+
+        def call
+          return [] if @barcode.nil?
+
+          Retryable.retryable(GoPuff::ProdcatApi.config.requests.to_h) do
+            make_request
+          end
+
+          parse_response
+        end
+
+        private
+
+        def make_request
+          @response = GoPuff::Http::Client.new(uri.to_s, adapter: :net_http_persistent, timeout: TIMEOUT).get(headers: headers, json: false)
+
+          raise(HttpError, "#{@response.error_message} | #{@response.status}") unless @response.success?
+
+          @response_json = JSON.parse(@response.body)
+        rescue JSON::ParserError => _e
+          raise InvalidJsonResponseError.new(uri.to_s, parse_code_from_body, @response.body)
+        rescue StandardError => e
+          raise HttpError, e
+        end
+
+        def uri
+          @uri ||= begin
+            url_safe_barcode = ERB::Util.url_encode(@barcode.strip)
+            uri = URI("#{url}/product-hydration/upc/#{url_safe_barcode}")
+            uri.query = 'datasource=cosmos'
+
+            uri
+          end
+        end
+
+        def url
+          GoPuff::ProdcatApi.config.url
+        end
+
+        def parse_code_from_body
+          code = @response.body[/\d+/].to_i
+          return 500 if code.zero?
+
+          code
+        end
+
+        def parse_response
+          @prodcat_products = @response_json['products'].map do |product|
+            product_mapper(product)
+          end
+        end
+
+        def headers
+          {
+            'Content-Type' => 'application/json',
+            'Authorization-Client-ID' => GoPuff::ProdcatApi.config.authorization_client_id,
+            'X-GP-Point-Of-Sale' => @point_of_sale
+          }.compact
+        end
+
+        def product_mapper(product)
+          ProductStruct.new.tap do |struct|
+            struct.product_id = product['id']
+            struct.price = product['price']
+            struct.offer = product['offer']
+            struct.cost = product['cost']
+            struct.kind = product['kind']
+            struct.currency = product['currency']
+            struct.subcategory_id = product['subcategoryId']
+            struct.quantity = product['quantity']
+            struct.available_for_bonus = product['availableForBonus']
+            struct.bundle = product['bundle']
+            struct.upc_barcodes = product['upcs']
+
+            # structure mappers
+            struct.bundle_products = product.dig('bundleInfo', 'products')&.map(&method(:bundle_mapper))
+            struct.images = product['imagesOld']&.map(&method(:image_mapper))
+            struct.avatar = avatar_mapper(product['avatarOld'].to_h)
+          end
+        end
+
+        def bundle_mapper(bundle_product)
+          BundleProductStruct.new.tap do |bundle_struct|
+            bundle_struct.product_id = bundle_product['id'].to_i
+            bundle_struct.quantity = bundle_product['quantity']
+            bundle_struct.cost = bundle_product['price']
+          end
+        end
+
+        def image_mapper(product_image)
+          ImageStruct.new.tap do |image_struct|
+            image_struct.small = product_image['small']
+            image_struct.thumb = product_image['thumb']
+            image_struct.medium = product_image['medium']
+            image_struct.large = product_image['large']
+            image_struct.xlarge = product_image['xlarge']
+            image_struct.tile_image_alt_text = product_image['tile_image_alt_text']
+          end
+        end
+
+        def avatar_mapper(product_avatar)
+          ImageStruct.new.tap do |image_struct|
+            image_struct.small = product_avatar['small']
+            image_struct.thumb = product_avatar['thumb']
+            image_struct.medium = product_avatar['medium']
+            image_struct.large = product_avatar['large']
+            image_struct.xlarge = product_avatar['xlarge']
+            image_struct.tile_image_alt_text = product_avatar['tile_image_alt_text']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/structs.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    module Structs
+      PRODUCT_STRUCT_PARAMS = %i[
+        product_id
+        price
+        quantity
+        currency
+        offer
+        bundle
+        cost
+        available_for_bonus
+        bundle_products
+        kind
+        primary_subcategory_id
+        subcategory_id
+        is_sample
+        is_rx
+        is_sip
+        is_digital
+        classifications
+        images
+        avatar
+        upc_barcodes
+      ].freeze
+
+      ProductStruct = Struct.new(*PRODUCT_STRUCT_PARAMS) do
+        def to_h
+          super.tap do |ps|
+            ps[:bundle_products] = ps[:bundle_products]&.map(&:to_h)
+          end
+        end
+
+        def rx?
+          TypeUtility.to_boolean(is_rx)
+        end
+
+        def sip?
+          TypeUtility.to_boolean(is_sip)
+        end
+
+        def digital?
+          TypeUtility.to_boolean(is_digital)
+        end
+
+        def sample?
+          TypeUtility.to_boolean(is_sample)
+        end
+      end
+
+      BundleProductStruct = Struct.new(:product_id, :quantity, :cost)
+      ImageStruct = Struct.new(:small, :thumb, :medium, :large, :xlarge, :tile_image_alt_text)
+      AvatarStruct = Struct.new(:small, :thumb, :medium, :large, :xlarge, :tile_image_alt_text)
+    end
+  end
+end

data/lib/go_puff/prodcat_api/type_utility.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    module TypeUtility
+      def self.to_boolean(value)
+        %w[1 true yes t y].include?(value&.to_s&.downcase)
+      end
+    end
+  end
+end

data/lib/go_puff/prodcat_api/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module GoPuff
+  module ProdcatApi
+    VERSION = '0.9.3.pre.beta.1'
+  end
+end

data/lib/go_puff/prodcat_api.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'retryable'
+require 'benchmark'
+require 'go_puff/http/client'
+require_relative 'prodcat_api/version'
+require_relative 'prodcat_api/errors'
+require_relative 'prodcat_api/configuration'
+require_relative 'prodcat_api/fetch_products'
+require_relative 'prodcat_api/fetch_product'
+require_relative 'prodcat_api/structs'
+require_relative 'prodcat_api/type_utility'
+require_relative 'prodcat_api/product_hydration/look_up_by_barcode'
+
+module GoPuff
+  module ProdcatApi
+    class << self
+      attr_accessor :config
+
+      def configure
+        @config ||= Configuration.new
+
+        yield config if block_given?
+        config.validate!
+        GoPuff::Http.config.logger = config.logger
+        GoPuff::Http.config.user_agent_header = config.user_agent_header
+        config
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,236 @@
+--- !ruby/object:Gem::Specification
+name: go_puff-prodcat_api
+version: !ruby/object:Gem::Version
+  version: 0.9.3.pre.beta.1
+platform: ruby
+authors:
+- Ruslan Tolstov
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: go_puff-http-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: retryable
+  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: 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: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.25'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  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: rubocop-rspec
+  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: rubocop-thread_safety
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".bundle/config.example"
+- ".rspec"
+- ".rubocop.yml"
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/rspec
+- bin/rubocop
+- bin/setup
+- dip.yml
+- docker-compose.yml
+- lefthook.yml
+- lib/go_puff/prodcat_api.rb
+- lib/go_puff/prodcat_api/configuration.rb
+- lib/go_puff/prodcat_api/errors.rb
+- lib/go_puff/prodcat_api/fetch_product.rb
+- lib/go_puff/prodcat_api/fetch_products.rb
+- lib/go_puff/prodcat_api/memo.rb
+- lib/go_puff/prodcat_api/product_hydration/look_up_by_barcode.rb
+- lib/go_puff/prodcat_api/structs.rb
+- lib/go_puff/prodcat_api/type_utility.rb
+- lib/go_puff/prodcat_api/version.rb
+homepage: https://github.com/gopuff/go_puff-prodcat_api
+licenses:
+- ISC
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: This Rails library is designed to work with product-catalog/pds api
+test_files: []