portage-ucp-etsy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3e24ea2159a17a36dacb77e235330db44249daa453f86a81ae149604167760cf
+  data.tar.gz: d1a0f696169cfe5e5872732154e2e59faedfcad982c333b9e0cc35cf2c7e5140
+SHA512:
+  metadata.gz: 5133bf3834abd51fd2f2e14780a4d2798712195bc4bb55879e7fa5479770ae794c74d1cee41121d7b8ed34fdcd508674c31a944109f79ff93141e48a35007a9b
+  data.tar.gz: ea611876c6565b1c16ff2a85635f13d42cf37b5292a654ad550c6554142b9bdb0a711e745b4dc011fc89ddcf7cfaae304a41d6a720dfc01cfa802a5475ca0195

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project are documented here. Format loosely follows
+[Keep a Changelog](https://keepachangelog.com/en/1.0.0/); this project is
+pre-1.0, so APIs may still shift between minor versions.
+
+## [0.1.0] - Unreleased
+
+- Initial pre-release. Etsy adapter against Open API v3 — catalog and order
+  real, checkout redirect-link only (no cart/checkout endpoint in Etsy's
+  public API).

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tom Whitbread
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,114 @@
+# portage-ucp-etsy
+
+Etsy adapter for [`portage-ucp`](../portage-ucp). Implements `Portage::Ucp::Adapter` against Etsy's Open API v3. Generic only — no merchant-specific business logic. Plain `Net::HTTP`, no Etsy SDK runtime dependency.
+
+## What it covers — and what it deliberately doesn't
+
+Unlike the other adapters in this project, this is **catalog + redirect-link checkout + order**, not a full transactional adapter. Etsy's public API has no cart, checkout, or add-to-cart endpoint at all — buying only ever happens on etsy.com itself.
+
+| UCP capability | Backing Etsy API | Notes |
+|---|---|---|
+| `dev.ucp.shopping.catalog` | Open API v3 | `search_catalog` (client-side title filter, see below), `get_product` |
+| `dev.ucp.shopping.checkout` | — | `create_checkout`/`get_checkout` only. `update_checkout`/`complete_checkout`/`cancel_checkout` are left unoverridden — calling them raises `Portage::Ucp::NotImplementedError` rather than pretending to do something. `dev.ucp.shopping.checkout` is still advertised (one overridden method is enough), so an agent discovers what's actually backed by trying it. |
+| `dev.ucp.shopping.order` | Open API v3 (shop receipts) | `get_order` |
+| `dev.ucp.shopping.cart` | — | not implemented at all; there's no Etsy cart resource to back it |
+| `dev.ucp.shopping.identity` | — | not implemented; Etsy buyer/seller OAuth identity is a separate concern from the shop-owner token used here |
+
+**`create_checkout`'s `Checkout#links` point at each requested listing's own etsy.com page** — the closest real equivalent to "add to cart and check out" this API allows. These Checkout objects are **not real Etsy resources** — nothing on Etsy's side tracks them. They live only in the `Adapter` instance's memory (`get_checkout` just reads back what `create_checkout` stored), so they don't survive a process restart or a different `Adapter` instance. `get_order`'s `checkout_id` is always blank for the same underlying reason: there's no real checkout for a receipt to link back to.
+
+**`search_catalog` is weaker than every other adapter's.** Etsy's shop-listings endpoint supports no keyword filter (only limit/offset/sort) — this fetches a page of active listings and filters by title client-side. Fine for a small shop, misleading for a large one with more listings than fit in one page.
+
+## Installation
+
+```ruby
+# Gemfile
+gem "portage-ucp-etsy"
+```
+
+```bash
+bundle install
+```
+
+## Setup
+
+You need an OAuth access_token (from the shop owner's one-time consent — Etsy's authorization-code+PKCE flow, outside this gem's scope) and your app's `x-api-key` (the OAuth client's keystring, required on every request in addition to the bearer token).
+
+```ruby
+require "portage/ucp/etsy"
+
+client = Portage::Ucp::Etsy::Client.new(
+  access_token: ENV.fetch("ETSY_ACCESS_TOKEN"),
+  api_key: ENV.fetch("ETSY_API_KEY")
+)
+
+adapter = Portage::Ucp::Etsy::Adapter.new(client: client, shop_id: ENV.fetch("ETSY_SHOP_ID"))
+```
+
+### Refreshing the access token
+
+Etsy access tokens expire quickly and **rotate the refresh_token on every use** — persist the new one each time, the old one stops working immediately.
+
+```ruby
+fetcher = Portage::Ucp::Etsy::AccessTokenFetcher.new(
+  client_id: ENV.fetch("ETSY_CLIENT_ID"),
+  refresh_token: ENV.fetch("ETSY_REFRESH_TOKEN")
+)
+
+result = fetcher.fetch
+result.access_token   # => pass into Client.new
+result.refresh_token  # => save this — the old one is now invalid
+result.expires_in     # => seconds until it needs refreshing again
+```
+
+## Usage
+
+```ruby
+# Catalog — product_id is Etsy's listing_id
+products = adapter.search_catalog(query: "mug", limit: 10)
+product  = adapter.get_product(product_id: products.first.id)
+
+# Checkout — a redirect, not a real transaction
+checkout = adapter.create_checkout(
+  line_items: [{ product_id: product.variants.first[:id], quantity: 1 }],
+  idempotency_key: SecureRandom.uuid
+)
+checkout.links.first.url # => hand this to the shopper/agent to complete the purchase on etsy.com
+
+# Order
+order = adapter.get_order(order_id: some_receipt_id)
+```
+
+## Wiring into portage-ucp
+
+Drop the adapter into a `Dispatcher` (or the MCP server) the same as any other backend:
+
+```ruby
+dispatcher = Portage::Ucp::Dispatcher.new(adapter: adapter)
+
+dispatcher.call(
+  capability: "dev.ucp.shopping.checkout",
+  action: "create_checkout",
+  arguments: { line_items: [{ product_id: listing_id, quantity: 1 }], idempotency_key: SecureRandom.uuid }
+)
+```
+
+## Errors
+
+```ruby
+Portage::Ucp::Etsy::Error    # base class
+Portage::Ucp::Etsy::ApiError # any non-2xx response from Etsy's Open API v3
+```
+
+## Development
+
+```bash
+bundle exec rspec   # tests (WebMock-stubbed, no live Etsy account needed)
+bundle exec rubocop  # lint
+
+# refresh a real access_token for a connected shop
+ETSY_CLIENT_ID=... ETSY_REFRESH_TOKEN=... bundle exec rake etsy_access_token
+```
+
+## License
+
+[MIT](LICENSE) — Copyright (c) 2026 Tom Whitbread.

data/lib/portage/ucp/etsy/access_token_fetcher.rb

@@ -0,0 +1,40 @@
+require "net/http"
+require "json"
+
+module Portage
+  module Ucp
+    module Etsy
+      # Exchanges a refresh_token for a new access_token via Etsy's OAuth2
+      # `/v3/public/oauth/token` endpoint.
+      #
+      # Doesn't handle the *initial* authorization-code exchange (that needs
+      # a PKCE code_verifier from an interactive consent redirect, which is
+      # a one-time setup step outside this gem's scope) — only the refresh
+      # step a long-running server needs repeatedly. Unlike Shopify/Wix/
+      # Magento, Etsy **rotates** the refresh_token on every use: the
+      # response's `refresh_token` is a new value, and the one passed in
+      # becomes invalid immediately, so callers must persist the returned
+      # one before the next refresh, not just the access_token.
+      class AccessTokenFetcher
+        include Portage::Ucp::Support::TokenExchange
+
+        Result = Struct.new(:access_token, :refresh_token, :expires_in, keyword_init: true)
+
+        ENDPOINT = "https://api.etsy.com/v3/public/oauth/token".freeze
+
+        def initialize(client_id:, refresh_token:)
+          @client_id = client_id
+          @refresh_token = refresh_token
+        end
+
+        def fetch
+          body = exchange(ENDPOINT,
+                          { grant_type: "refresh_token", client_id: @client_id, refresh_token: @refresh_token },
+                          error_class: Portage::Ucp::Etsy::Error, description: "token refresh failed")
+          Result.new(access_token: body["access_token"], refresh_token: body["refresh_token"],
+                     expires_in: body["expires_in"])
+        end
+      end
+    end
+  end
+end

data/lib/portage/ucp/etsy/adapter.rb

@@ -0,0 +1,107 @@
+module Portage
+  module Ucp
+    module Etsy
+      # Generic Portage::Ucp::Adapter over Etsy's Open API v3 — no
+      # merchant-specific business logic, same posture as the other
+      # adapters in this project.
+      #
+      # IMPORTANT: unlike Shopify/Wix/WooCommerce/BigCommerce/Magento, this
+      # is deliberately a **catalog + redirect-link checkout + order**
+      # adapter, not a full transactional one — Etsy's public API has no
+      # cart, checkout, or add-to-cart endpoint at all. Buying only ever
+      # happens on etsy.com itself. This adapter therefore:
+      #
+      # - Doesn't override `get_cart`/`create_cart`/`update_cart`/
+      #   `cancel_cart` at all — `dev.ucp.shopping.cart` stays unadvertised.
+      # - Overrides only `create_checkout`/`get_checkout`. `Checkout#links`
+      #   carries one link per requested listing, pointing straight at that
+      #   listing's own etsy.com page — the closest real equivalent to
+      #   "add this to your cart and check out" this API allows. `update_
+      #   checkout`/`complete_checkout`/`cancel_checkout` are left
+      #   unoverridden on purpose: there's nothing to update or complete
+      #   programmatically, and calling them raises
+      #   Portage::Ucp::NotImplementedError rather than silently pretending
+      #   to do something. `dev.ucp.shopping.checkout` still gets advertised
+      #   (Capability#advertised_for? only needs one overridden method), so
+      #   an agent sees the capability and can discover which actions are
+      #   actually backed by trying them.
+      # - The Checkout objects `create_checkout` returns are **not real
+      #   Etsy resources** — nothing on Etsy's side tracks them. They live
+      #   only in this Adapter instance's memory (`get_checkout` reads back
+      #   what `create_checkout` stored), so they don't survive a process
+      #   restart or a different Adapter instance.
+      # - `get_order`'s `checkout_id` is always blank — there's no real
+      #   checkout for a receipt to link back to in the first place (see
+      #   above), a more fundamental gap than WooCommerce/Magento needing
+      #   adapter-side tracking for a *real* checkout.
+      #
+      # Deliberately doesn't override `link_identity` either — Etsy buyer/
+      # seller OAuth identity is a separate concern from the shop-owner
+      # access_token this gem uses for catalog/order reads.
+      class Adapter < Portage::Ucp::Adapter
+        # §9a dedup via Support::Idempotency, so an agent's retry on a
+        # dropped connection doesn't build a second, different in-memory
+        # Checkout for the same intent.
+        include Portage::Ucp::Support::Idempotency
+        # Etsy answers a missing listing or receipt with a 404 rather than
+        # an empty body, which UCP's reads report as nil.
+        include Portage::Ucp::Support::NotFound
+
+        def initialize(client:, shop_id:)
+          super()
+          @client = client
+          @shop_id = shop_id
+          @checkouts = {}
+        end
+
+        # Etsy's shop-listings endpoint supports no keyword filter at all
+        # (only limit/offset/sort) — this fetches a page of active listings
+        # and filters by title client-side, so it's a much weaker "search"
+        # than every other adapter's real server-side query. Fine for a
+        # small shop, misleading for a large one.
+        def search_catalog(query:, limit:)
+          data = @client.get("/shops/#{@shop_id}/listings/active?limit=100")
+          matches = (data["results"] || []).select { |l| l["title"].to_s.downcase.include?(query.downcase) }
+          matches.first(limit).map { |node| Mapper.product(node) }
+        end
+
+        def get_product(product_id:)
+          nil_on_not_found do
+            node = @client.get("/listings/#{product_id}")
+            next nil unless node["listing_id"]
+
+            inventory = @client.get("/listings/#{product_id}/inventory")
+            Mapper.product(node.merge("variants_detail" => inventory))
+          end
+        end
+
+        def create_checkout(line_items:, idempotency_key:)
+          dedup(idempotency_key) do
+            listings = line_items.map { |li| listing_with_quantity(li) }
+            checkout_id = "etsy-checkout-#{idempotency_key}"
+            checkout = Mapper.checkout(listings, id: checkout_id, status: "incomplete")
+            @checkouts[checkout_id] = checkout
+            checkout
+          end
+        end
+
+        def get_checkout(checkout_id:)
+          @checkouts[checkout_id]
+        end
+
+        def get_order(order_id:)
+          nil_on_not_found do
+            node = @client.get("/shops/#{@shop_id}/receipts/#{order_id}")
+            node["receipt_id"] ? Mapper.order(node) : nil
+          end
+        end
+
+        private
+
+        def listing_with_quantity(line_item)
+          @client.get("/listings/#{line_item[:product_id]}").merge("quantity" => line_item[:quantity])
+        end
+      end
+    end
+  end
+end

data/lib/portage/ucp/etsy/client.rb

@@ -0,0 +1,44 @@
+require "net/http"
+require "json"
+
+module Portage
+  module Ucp
+    module Etsy
+      # Minimal REST client over Etsy's Open API v3
+      # (`api.etsy.com/v3/application`).
+      #
+      # Deliberately plain Net::HTTP, not an Etsy SDK (there isn't an
+      # official Ruby one) — trivially stubbable with WebMock.
+      #
+      # Every call needs *two* credentials, not one: a Bearer access_token
+      # from the shop owner's OAuth consent (see
+      # Portage::Ucp::Etsy::AccessTokenFetcher) **and** the app's own
+      # `x-api-key` (the OAuth client's keystring) on every single request —
+      # Etsy checks both independently, unlike Shopify/Wix/WooCommerce/
+      # Magento, where the bearer token alone is sufficient.
+      class Client
+        include Portage::Ucp::Support::HttpClient
+
+        BASE_URL = "https://api.etsy.com/v3/application".freeze
+
+        def initialize(access_token:, api_key:)
+          @access_token = access_token
+          @api_key = api_key
+        end
+
+        def get(path)
+          request(Net::HTTP::Get, path)
+        end
+
+        private
+
+        def request(http_method, path)
+          json_request(http_method, "#{BASE_URL}#{path}",
+                       headers: { "Authorization" => "Bearer #{@access_token}", "x-api-key" => @api_key })
+        end
+
+        def api_error_class = Portage::Ucp::Etsy::ApiError
+      end
+    end
+  end
+end

data/lib/portage/ucp/etsy/errors.rb

@@ -0,0 +1,20 @@
+module Portage
+  module Ucp
+    module Etsy
+      class Error < StandardError; end
+
+      # Raised for any non-2xx response from Etsy's Open API v3
+      # (`api.etsy.com/v3/application`) — a non-2xx status with a JSON
+      # `{error, error_description}` (OAuth) or `{error}` (REST) body.
+      class ApiError < Error
+        include Portage::Ucp::Support::ApiError
+
+        private
+
+        def detail(body)
+          body["error_description"] || body["error"] || body
+        end
+      end
+    end
+  end
+end

data/lib/portage/ucp/etsy/mapper.rb

@@ -0,0 +1,147 @@
+module Portage
+  module Ucp
+    module Etsy
+      # Converts Etsy Open API v3 response bodies into the protocol-layer
+      # value objects from Portage::Ucp::ValueObjects — nothing Etsy-shaped
+      # is allowed to leak past this file.
+      #
+      # Etsy's `Money` type (`{amount, divisor, currency_code}`) is already
+      # an integer, unlike every other adapter in this project — `amount /
+      # divisor` gives the decimal value, but `amount` itself is already in
+      # the currency's minor units when `divisor` is 100 (the only value
+      # Etsy documents ever returning), so no BigDecimal conversion is
+      # needed here at all.
+      module Mapper
+        module_function
+
+        def money(node)
+          Portage::Ucp::Money.new(amount_minor: node["amount"], currency: node["currency_code"])
+        end
+
+        # `node["variants_detail"]` is adapter-populated, not a real Etsy
+        # field: a listing's own resource has no variant/SKU breakdown at
+        # all — that's a second call to the separate Inventory endpoint
+        # (`/listings/{id}/inventory`), made only for #get_product's
+        # single-listing path, same reasoning as every other adapter's N+1
+        # variant fetch.
+        def product(node)
+          Portage::Ucp::Product.new(
+            id: node["listing_id"].to_s,
+            title: node["title"],
+            description: node["description"],
+            price: money(node["price"]),
+            available: node["state"] == "active" && node["quantity"].to_i.positive?,
+            variants: variants(node),
+            url: node["url"]
+          )
+        end
+
+        # A listing with no inventory-level variation is its own single
+        # implicit variant, same as a single-variant Shopify product using
+        # that variant's own id.
+        def variants(node)
+          detail = node["variants_detail"]
+          unless detail
+            return [{ id: node["listing_id"].to_s, title: node["title"],
+                      available: node["state"] == "active" && node["quantity"].to_i.positive?,
+                      price: money(node["price"]) }]
+          end
+
+          (detail["products"] || []).reject { |p| p["is_deleted"] }.map { |p| variant(p) }
+        end
+
+        def variant(node)
+          title = (node["property_values"] || []).flat_map { |p| p["values"] }.join(" / ")
+          offering = (node["offerings"] || []).find { |o| o["is_enabled"] } || {}
+          { id: node["product_id"].to_s, title: title, available: offering["quantity"].to_i.positive?,
+            price: money(offering["price"] || {}) }
+        end
+
+        # `id:` is caller-supplied: there's no real Etsy checkout resource
+        # behind this at all — see Portage::Ucp::Etsy::Adapter's class-level
+        # comment. `links` points at each listing's own public Etsy URL
+        # rather than a cart, since Etsy's public API has no way to deep-
+        # link a multi-item add-to-cart flow.
+        def checkout(listings, id:, status:)
+          line_items = listings.map { |l| checkout_line_item(l) }
+          currency = listings.first&.dig("price", "currency_code")
+          Portage::Ucp::Checkout.new(
+            id: id,
+            status: status,
+            line_items: line_items,
+            currency: currency,
+            totals: totals(listings),
+            links: listings.map { |l| Portage::Ucp::Link.new(type: "checkout", url: l["url"], title: l["title"]) }
+          )
+        end
+
+        def checkout_line_item(node)
+          Portage::Ucp::LineItem.new(
+            id: node["listing_id"].to_s,
+            item: Portage::Ucp::Item.new(id: node["listing_id"].to_s, title: node["title"],
+                                         price: node.dig("price", "amount")),
+            quantity: node["quantity"] || 1,
+            totals: Portage::Ucp::Support::Totals.line(line_total(node))
+          )
+        end
+
+        def line_total(node)
+          node.dig("price", "amount") * (node["quantity"] || 1)
+        end
+
+        def totals(listings)
+          subtotal = listings.sum { |l| line_total(l) }
+          Portage::Ucp::Support::Totals.summary(subtotal: subtotal, total: subtotal)
+        end
+
+        # Etsy core has no per-transaction fulfillment tracking on the
+        # Receipt resource beyond a single receipt-wide `is_shipped` flag —
+        # every line gets the same coarse status, same simplification as
+        # Portage::Ucp::WooCommerce::Mapper/Portage::Ucp::Magento::Mapper.
+        #
+        # `permalink_url` is left blank — Etsy's API doesn't return a
+        # public, shareable receipt URL (buyers see receipts inside their
+        # own account, not via a link). `checkout_id` is always blank too,
+        # for a more fundamental reason than the other adapters: this
+        # gem's Checkout is never a real Etsy resource (see
+        # Portage::Ucp::Etsy::Adapter), so there is no "checkout that led
+        # to this receipt" for the adapter to have recorded in the first
+        # place.
+        def receipt_status(node)
+          return "fulfilled" if node["is_shipped"]
+          return "removed" if node["status"] == "canceled"
+
+          "processing"
+        end
+
+        def order(node)
+          status = receipt_status(node)
+          Portage::Ucp::Order.new(
+            id: node["receipt_id"].to_s,
+            checkout_id: "",
+            permalink_url: "",
+            line_items: (node["transactions"] || []).map { |n| order_line_item(n, status) },
+            fulfillment: Portage::Ucp::Fulfillment.new,
+            currency: node.dig("total_price", "currency_code"),
+            totals: Portage::Ucp::Support::Totals.summary(subtotal: money(node["subtotal"]).amount_minor,
+                                                          total: money(node["total_price"]).amount_minor)
+          )
+        end
+
+        def order_line_item(node, status)
+          quantity = node["quantity"]
+          fulfilled = Portage::Ucp::Support::LineItemStatus.fulfilled_quantity(status, quantity)
+          line_total = node.dig("price", "amount") * quantity
+          Portage::Ucp::OrderLineItem.new(
+            id: node["transaction_id"].to_s,
+            item: Portage::Ucp::Item.new(id: node["listing_id"].to_s, title: node["title"],
+                                         price: node.dig("price", "amount")),
+            quantity: { original: quantity, total: quantity, fulfilled: fulfilled },
+            totals: Portage::Ucp::Support::Totals.line(line_total),
+            status: status
+          )
+        end
+      end
+    end
+  end
+end

data/lib/portage/ucp/etsy/version.rb

@@ -0,0 +1,7 @@
+module Portage
+  module Ucp
+    module Etsy
+      VERSION = "0.1.0".freeze
+    end
+  end
+end

data/lib/portage/ucp/etsy.rb

@@ -0,0 +1,7 @@
+require "portage/ucp"
+require_relative "etsy/version"
+require_relative "etsy/errors"
+require_relative "etsy/client"
+require_relative "etsy/access_token_fetcher"
+require_relative "etsy/mapper"
+require_relative "etsy/adapter"

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: portage-ucp-etsy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tom Whitbread
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: portage-ucp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.24'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.24'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Implements Portage::Ucp::Adapter against Etsy's Open API v3. Catalog
+  and order are real; checkout is redirect-link only (links to etsy.com) since Etsy's
+  public API has no cart/checkout endpoint. Generic only — no merchant-specific business
+  logic. Plain Net::HTTP, no Etsy SDK runtime dependency.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/portage/ucp/etsy.rb
+- lib/portage/ucp/etsy/access_token_fetcher.rb
+- lib/portage/ucp/etsy/adapter.rb
+- lib/portage/ucp/etsy/client.rb
+- lib/portage/ucp/etsy/errors.rb
+- lib/portage/ucp/etsy/mapper.rb
+- lib/portage/ucp/etsy/version.rb
+homepage: https://github.com/tomtom87/Portage/tree/main/portage-ucp-etsy
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/tomtom87/Portage/tree/main/portage-ucp-etsy
+  changelog_uri: https://github.com/tomtom87/Portage/blob/main/portage-ucp-etsy/CHANGELOG.md
+  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: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Etsy adapter for portage-ucp — catalog/order over MCP and UCP, redirect-link
+  checkout
+test_files: []