shopify_graphql 2.5.1 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 827b03ca608d7ae514f1758fb96ebc253783b778cbe376d8e2a5d3ab772b42da
-  data.tar.gz: b473cac1e4ac0dcf34ea3895dcaa6cadf0bb5dd4d2ea434b1ed4350dcd137839
+  metadata.gz: bcbd21fda0033f2ada1d0f6c86e19d1bc46bb8d5a787cf868c7f19d877842d07
+  data.tar.gz: 932aaf0b971c2b463eff279dbe9c00512e18b8c26863aa21f71eec6b7cb9b68f
 SHA512:
-  metadata.gz: 169c9249f8ac75c8f7c07d087b91cc6ff7a09ea9b8d361e4a2e746106f71fb6dca3f81dce546b6e3dfd0df1fe73bd8657d7adf515656232e38ec6053621fb9fd
-  data.tar.gz: b4633cdc0d303d4e9f4f7fee089c5ff7e67793a4c28ae3779a7f093cfed030405f3a77fd1760490ce6b022a2e179ad689fa7400db1294bf2c291f40999242dd4
+  metadata.gz: 88f2a985ebb14ca11d9f11ad8b9e1a7d212b688d648d47438226578882f2e29c665301633c4f7cf4450f2cefa110ff45845d62584daf6ad8a148bc4bbffda441
+  data.tar.gz: ae06c0ab85d3a1e3cb853c1511fa6e0dc97fc5f946cec41e010a846bd050d66c1a3ef86c717e16632d59807697eb40ff294255a6f4126d151fc9de4032090fd9

data/README.md

@@ -1,6 +1,6 @@
 # Shopify Graphql
 
-Less painful way to work with [Shopify Graphql API](https://shopify.dev/api/admin-graphql) in Ruby. This library is a tiny wrapper on top of [`shopify_api`](https://github.com/Shopify/shopify-api-ruby) gem. It provides a simple API for Graphql calls, better error handling, and Graphql webhooks integration.
+Less painful way to work with [Shopify Graphql API](https://shopify.dev/api/admin-graphql) in Ruby. This library is a tiny wrapper on top of [`shopify_api`](https://github.com/Shopify/shopify-api-ruby) gem. It provides a simple API for Graphql calls, better error handling, and Graphql webhooks integration (deprecated).
 
 ## Features
 
@@ -9,13 +9,13 @@ Less painful way to work with [Shopify Graphql API](https://shopify.dev/api/admi
 - ActiveResource-like error handling
 - Graphql and user error handlers
 - Auto-conversion of responses to OpenStruct
-- Graphql webhooks integration for Rails
+- Graphql webhooks integration for Rails (deprecated, see [Graphql webhooks](#graphql-webhooks-deprecated))
 - Wrappers for Graphql rate limit extensions
 - Built-in calls for common Graphql calls
 
 ## Dependencies
 
-- [`shopify_api`](https://github.com/Shopify/shopify-api-ruby) v10+
+- [`shopify_api`](https://github.com/Shopify/shopify-api-ruby) v13.4+
 - [`shopify_app`](https://github.com/Shopify/shopify_app) v19+
 
 > For `shopify_api` < v10 use [`0-4-stable`](https://github.com/kirillplatonov/shopify_graphql/tree/0-4-stable) branch.
@@ -755,12 +755,21 @@ ShopifyGraphql.handle_user_errors(response)
   puts shop.shop_locales
   ```
 
+  Or with products count (requires `read_products` scope):
+
+  ```rb
+  shop = ShopifyGraphql::CurrentShop.call(with_products_count: true)
+  puts shop.products_count
+  ```
+
+  `plan_name` and `plan_display_name` are deprecated and will be removed in v3.0. They're derived from the deprecated `plan.displayName` field. Use `plan_public_display_name`, `plan_shopify_plus` and `plan_partner_development` instead.
+
 - `ShopifyGraphql::CancelSubscription`
 - `ShopifyGraphql::CreateRecurringSubscription`
 - `ShopifyGraphql::CreateUsageSubscription`
 - `ShopifyGraphql::GetAppSubscription`
-- `ShopifyGraphql::UpsertPrivateMetafield`
-- `ShopifyGraphql::DeletePrivateMetafield`
+- `ShopifyGraphql::UpsertPrivateMetafield` (deprecated, see [Deprecated in 2.6](#deprecated-in-26-removed-in-30))
+- `ShopifyGraphql::DeletePrivateMetafield` (deprecated, see [Deprecated in 2.6](#deprecated-in-26-removed-in-30))
 - `ShopifyGraphql::CreateBulkMutation`
 - `ShopifyGraphql::CreateBulkQuery`
 - `ShopifyGraphql::CreateStagedUploads`
@@ -776,6 +785,7 @@ The gem exposes Graphql rate limit extensions in response object:
 - `points_limit`
 - `points_restore_rate`
 - `query_cost`
+- `requested_query_cost`
 
 And adds a helper to check if available points lower than threshold (useful for implementing API backoff):
 
@@ -792,6 +802,95 @@ response.query_cost # => 1
 response.points_maxed?(threshold: 100) # => false
 ```
 
+## Error handling
+
+Failed calls raise `ShopifyGraphql::ConnectionError` or one of its subclasses. GraphQL errors come back with HTTP 200 and are mapped by the first error's `extensions.code`:
+
+| Class | Raised for |
+| --- | --- |
+| `TooManyRequests` | `THROTTLED`, HTTP 429 and 430 |
+| `ServerError` | `INTERNAL_SERVER_ERROR`, HTTP 5xx, invalid JSON and network errors |
+| `AccessDenied` | `ACCESS_DENIED` (missing access scope) |
+| `MaxCostExceeded` | `MAX_COST_EXCEEDED` (query is over the single query cost limit) |
+| `ShopInactive` | `SHOP_INACTIVE` |
+| `ShopPendingTermination` | `SHOP_PENDING_TERMINATION` |
+| `BadRequest` | HTTP 400 |
+| `UnauthorizedAccess` | HTTP 401 |
+| `PaymentRequired` | HTTP 402 (shop is frozen) |
+| `ForbiddenAccess` | HTTP 403 (shop is marked as fraudulent) |
+| `NonExpiringTokenRejected` | HTTP 403 for a public app's non-expiring offline access token, from January 1, 2027. Subclass of `ForbiddenAccess` |
+| `ResourceNotFound` | HTTP 404 |
+| `MethodNotAllowed`, `ResourceConflict`, `ResourceGone`, `PreconditionFailed` | HTTP 405, 409, 410, 412 |
+| `ShopLocked` | HTTP 423 |
+| `ClientError` | Other HTTP 4xx |
+| `UserError` | `userErrors`, from `handle_user_errors` |
+| `ConnectionError` | Other GraphQL error codes |
+
+Everything except `ServerError`, `UserError` and plain `ConnectionError` is a `ClientError`.
+
+Errors raised from a GraphQL response carry its partial `data`, all of its `errors`, and the same cost readers as the response (`query_cost`, `requested_query_cost`, `points_left`, `points_limit`, `points_restore_rate`). `errors` is always an Array, empty when there are none. `data` and the cost readers return `nil` when the information isn't available, e.g. for HTTP and network errors.
+
+```rb
+retries = 0
+begin
+  response = GetProduct.call(id: "gid://shopify/Product/PRODUCT_GID")
+rescue ShopifyGraphql::TooManyRequests => error
+  retries += 1
+  raise if retries > 3
+
+  # Throttled queries don't run, so there's no query_cost. Wait until the requested
+  # cost is restored, or 1 second if the response has no cost data.
+  wait = 1.0
+  if error.requested_query_cost && error.points_left && error.points_restore_rate
+    wait = (error.requested_query_cost - error.points_left) / error.points_restore_rate.to_f
+  end
+  sleep(wait.clamp(1, 60))
+  retry
+rescue ShopifyGraphql::ConnectionError => error
+  error.data   # => partial data, e.g. when a field returns ACCESS_DENIED
+  error.errors # => all GraphQL errors
+  raise
+end
+```
+
+`UserError` carries the mutation payload as `data`, its `userErrors` as `errors`, and the cost of the mutation:
+
+```rb
+begin
+  UpdateProduct.call(input: { id: "gid://shopify/Product/123", title: "" })
+rescue ShopifyGraphql::UserError => error
+  error.query_cost            # => 10
+  error.errors.map(&:message) # => ["Title can't be blank"]
+end
+```
+
+Wrappers that include `ShopifyGraphql::Query` or `ShopifyGraphql::Mutation` attach the cost automatically. `ShopifyGraphql.execute` and `ShopifyGraphql.handle_user_errors` use a new client on each call, so pass the response explicitly:
+
+```rb
+response = ShopifyGraphql.execute(PRODUCT_UPDATE_MUTATION, input: input)
+ShopifyGraphql.handle_user_errors(response.data.productUpdate, response: response)
+```
+
+### Unavailable shops
+
+`UnauthorizedAccess`, `PaymentRequired`, `ShopLocked`, `ShopPendingTermination` and `ShopInactive` include `ShopifyGraphql::ShopUnavailable`. Rescue it to stop working with a shop that uninstalled the app or was frozen, locked or closed:
+
+```rb
+class SyncProductsJob < ApplicationJob
+  discard_on ShopifyGraphql::ShopUnavailable
+
+  def perform(shop)
+    shop.with_shopify_session do
+      GetProducts.call
+    end
+  end
+end
+```
+
+Shopify also returns 401 for an expired access token. If you use expiring offline access tokens, a 401 can mean the token wasn't refreshed, so refresh it before treating the shop as uninstalled.
+
+`ForbiddenAccess`, `NonExpiringTokenRejected` and `ResourceNotFound` aren't included, so handle them separately. A 403 means the shop was marked as fraudulent or, from January 1, 2027, that the app sent a non-expiring access token, which would affect every shop at once. A 404 is also raised for null nodes.
+
 ## Custom apps
 
 In custom apps, if you're using `shopify_app` gem, then the setup is similar public apps. Except `Shop` model which must include class method to make queries to your store:
@@ -855,10 +954,22 @@ Shop.with_shopify_session do
 end
 ```
 
+## Deprecated in 2.6, removed in 3.0
+
+These APIs warn through `ShopifyGraphql.deprecator`, once per process for each API. On Rails 7.1+ it's registered as `Rails.application.deprecators[:shopify_graphql]`, so your `config.active_support.deprecation` settings apply to it.
+
+| Deprecated | Use instead |
+| --- | --- |
+| `ShopifyGraphql::UpsertPrivateMetafield`, `ShopifyGraphql::DeletePrivateMetafield` | App-owned metafields: `metafieldsSet` and `metafieldsDelete` with an `$app` namespace. Shopify has removed `privateMetafieldUpsert` and `privateMetafieldDelete` from the Admin API. |
+| [Graphql webhooks](#graphql-webhooks-deprecated): `ShopifyGraphql::WebhooksManager`, `ShopifyGraphql::Webhook`, `CreateWebhooksJob`, `DestroyWebhooksJob`, `UpdateWebhooksJob`, `WebhookVerification`, the `graphql_webhooks` route and the `config.webhook*` options | `shopify_app` [webhooks](https://github.com/Shopify/shopify_app/blob/main/docs/shopify_app/webhooks.md) or app-specific subscriptions in `shopify.app.toml` |
+| `ShopifyGraphql::Resource`, `ShopifyGraphql::Shop.current` | `ShopifyGraphql::CurrentShop`, or your own classes that include `ShopifyGraphql::Query` or `ShopifyGraphql::Mutation` |
+| `ShopifyGraphql::PLAN_TO_DISPLAY_NAME`, `ShopifyGraphql::DISPLAY_NAME_TO_PLAN`, `ShopifyGraphql.normalize_plan_display_name` | `plan_public_display_name`, `plan_shopify_plus` and `plan_partner_development` from `ShopifyGraphql::CurrentShop` |
+| `plan_name` and `plan_display_name` from `ShopifyGraphql::CurrentShop` (no runtime warning) | `plan_public_display_name`, `plan_shopify_plus` and `plan_partner_development` |
+
 ## Graphql webhooks (deprecated)
 
 > [!WARNING]
-> ShopifyGraphql webhooks are deprecated and will be removed in v3.0. Please use `shopify_app` gem for handling webhooks. See [`shopify_app` documentation](https://github.com/Shopify/shopify_app/blob/main/docs/shopify_app/webhooks.md) for more details.
+> ShopifyGraphql webhooks are deprecated and will be removed in v3.0. Please use `shopify_app` gem for handling webhooks or declare app-specific subscriptions in `shopify.app.toml`. See [`shopify_app` documentation](https://github.com/Shopify/shopify_app/blob/main/docs/shopify_app/webhooks.md) for more details.
 
 The gem has built-in support for Graphql webhooks (similar to `shopify_app`). To enable it add the following config to `config/initializers/shopify_app.rb`:
 

data/app/graphql/shopify_graphql/create_bulk_query.rb

@@ -18,8 +18,29 @@ module ShopifyGraphql
       }
     GRAPHQL
 
-    def call(query:)
-      response = execute(MUTATION, query: query)
+    # groupObjects is available since API version 2025-07
+    MUTATION_WITH_GROUP_OBJECTS = <<~GRAPHQL
+      mutation($query: String!, $groupObjects: Boolean!) {
+        bulkOperationRunQuery(query: $query, groupObjects: $groupObjects) {
+          bulkOperation {
+            id
+            status
+          }
+          userErrors {
+            code
+            field
+            message
+          }
+        }
+      }
+    GRAPHQL
+
+    def call(query:, group_objects: nil)
+      response = if group_objects.nil?
+        execute(MUTATION, query: query)
+      else
+        execute(MUTATION_WITH_GROUP_OBJECTS, query: query, groupObjects: group_objects)
+      end
       response.data = response.data.bulkOperationRunQuery
       handle_user_errors(response.data)
       response

data/app/graphql/shopify_graphql/current_shop.rb

@@ -13,14 +13,15 @@ module ShopifyGraphql
           primaryDomain {
             host
           }
-          #CREATED_AT#
-          #UPDATED_AT#
-          #SHOP_OWNER_NAME#
+          createdAt
+          updatedAt
+          shopOwnerName
           currencyCode
-          billingAddress {
+          shopAddress {
             country
             countryCodeV2
             province
+            provinceCode
             city
             address1
             address2
@@ -33,6 +34,9 @@ module ShopifyGraphql
           ianaTimezone
           plan {
             displayName
+            publicDisplayName
+            shopifyPlus
+            partnerDevelopment
           }
           currencyFormats {
             moneyFormat
@@ -47,14 +51,22 @@ module ShopifyGraphql
           checkoutApiSupported
           transactionalSmsDisabled
           enabledPresentmentCurrencies
-          #SMS_CONSENT#
+          marketingSmsConsentEnabledAtCheckout
           resourceLimits {
             maxProductOptions
             maxProductVariants
           }
-          #FEATURES#
+        }
+        currentAppInstallation {
+          id
+        }
+        onlineStore {
+          passwordProtection {
+            enabled
+          }
         }
         #LOCALES_SUBQUERY#
+        #PRODUCTS_COUNT_SUBQUERY#
       }
     GRAPHQL
     LOCALES_SUBQUERY = <<~GRAPHQL
@@ -63,48 +75,29 @@ module ShopifyGraphql
         primary
       }
     GRAPHQL
-    FEATURES_SUBQUERY = <<~GRAPHQL
-      features {
-        unifiedMarkets
+    PRODUCTS_COUNT_SUBQUERY = <<~GRAPHQL
+      productsCount(limit: null) {
+        count
       }
     GRAPHQL
 
-    def call(with_locales: false)
-      query = prepare_query(QUERY, with_locales: with_locales)
+    def call(with_locales: false, with_products_count: false)
+      query = prepare_query(QUERY, with_locales: with_locales, with_products_count: with_products_count)
       response = execute(query)
-      parse_data(response, with_locales: with_locales)
+      parse_data(response, with_locales: with_locales, with_products_count: with_products_count)
     end
 
     private
 
-    def prepare_query(query, with_locales:)
+    def prepare_query(query, with_locales:, with_products_count: false)
       query = query.gsub("#LOCALES_SUBQUERY#", with_locales ? LOCALES_SUBQUERY : "")
-      if ShopifyAPI::Context.api_version.in?(%w[2024-01 2024-04 2024-07])
-        query.gsub!("#SHOP_OWNER_NAME#", "")
-      else
-        query.gsub!("#SHOP_OWNER_NAME#", "shopOwnerName")
-      end
-      if ShopifyAPI::Context.api_version.in?(%w[2024-01])
-        query.gsub!("#CREATED_AT#", "")
-        query.gsub!("#UPDATED_AT#", "")
-        query.gsub!("#SMS_CONSENT#", "")
-      else
-        query.gsub!("#CREATED_AT#", "createdAt")
-        query.gsub!("#UPDATED_AT#", "updatedAt")
-        query.gsub!("#SMS_CONSENT#", "marketingSmsConsentEnabledAtCheckout")
-      end
-      if ShopifyAPI::Context.api_version.in?(%w[2024-01 2024-04 2024-07 2024-10 2025-01])
-        query.gsub!("#FEATURES#", "")
-      else
-        query.gsub!("#FEATURES#", FEATURES_SUBQUERY)
-      end
-      query
+      query.gsub("#PRODUCTS_COUNT_SUBQUERY#", with_products_count ? PRODUCTS_COUNT_SUBQUERY : "")
     end
 
-    def parse_data(response, with_locales: false)
+    def parse_data(response, with_locales: false, with_products_count: false)
       data = response.data
-      plan_display_name = ShopifyGraphql.normalize_plan_display_name(data.shop.plan.displayName)
-      plan_name = ShopifyGraphql::DISPLAY_NAME_TO_PLAN[plan_display_name]
+      plan_display_name = PlanNames.normalize_display_name(data.shop.plan.displayName)
+      plan_name = PlanNames::DISPLAY_NAME_TO_PLAN[plan_display_name]
       shop_data = OpenStruct.new(
         id: data.shop.id.split("/").last.to_i,
         name: data.shop.name,
@@ -116,22 +109,25 @@ module ShopifyGraphql
         updated_at: data.shop.updatedAt,
         shop_owner: data.shop.shopOwnerName,
         currency: data.shop.currencyCode,
-        country_name: data.shop.billingAddress.country,
-        country: data.shop.billingAddress.countryCodeV2,
-        country_code: data.shop.billingAddress.countryCodeV2,
-        province: data.shop.billingAddress.province,
-        province_code: data.shop.billingAddress.provinceCode,
-        city: data.shop.billingAddress.city,
-        address1: data.shop.billingAddress.address1,
-        address2: data.shop.billingAddress.address2,
-        zip: data.shop.billingAddress.zip,
-        latitude: data.shop.billingAddress.latitude,
-        longitude: data.shop.billingAddress.longitude,
-        phone: data.shop.billingAddress.phone,
+        country_name: data.shop.shopAddress.country,
+        country: data.shop.shopAddress.countryCodeV2,
+        country_code: data.shop.shopAddress.countryCodeV2,
+        province: data.shop.shopAddress.province,
+        province_code: data.shop.shopAddress.provinceCode,
+        city: data.shop.shopAddress.city,
+        address1: data.shop.shopAddress.address1,
+        address2: data.shop.shopAddress.address2,
+        zip: data.shop.shopAddress.zip,
+        latitude: data.shop.shopAddress.latitude,
+        longitude: data.shop.shopAddress.longitude,
+        phone: data.shop.shopAddress.phone,
         timezone: data.shop.timezoneAbbreviation,
         iana_timezone: data.shop.ianaTimezone,
         plan_name: plan_name,
         plan_display_name: plan_display_name,
+        plan_public_display_name: data.shop.plan.publicDisplayName,
+        plan_shopify_plus: data.shop.plan.shopifyPlus,
+        plan_partner_development: data.shop.plan.partnerDevelopment,
         money_format: data.shop.currencyFormats.moneyFormat,
         money_in_emails_format: data.shop.currencyFormats.moneyInEmailsFormat,
         money_with_currency_format: data.shop.currencyFormats.moneyWithCurrencyFormat,
@@ -146,7 +142,10 @@ module ShopifyGraphql
         marketing_sms_consent_enabled_at_checkout: data.shop.marketingSmsConsentEnabledAtCheckout,
         max_product_options: data.shop.resourceLimits.maxProductOptions,
         max_product_variants: data.shop.resourceLimits.maxProductVariants,
-        unified_markets: !!data.shop&.features&.unifiedMarkets,
+        unified_markets: true,
+        app_installation_id: data.currentAppInstallation&.id,
+        password_enabled: !!data.onlineStore&.passwordProtection&.enabled,
+        products_count: with_products_count ? data.productsCount&.count : nil,
         graphql_points_limit: response.points_limit
       )
       if with_locales

data/app/graphql/shopify_graphql/delete_private_metafield.rb

@@ -15,6 +15,9 @@ module ShopifyGraphql
     GRAPHQL
 
     def call(namespace:, key:, owner: nil)
+      ShopifyGraphql::Deprecation.warn_once("ShopifyGraphql::DeletePrivateMetafield", "ShopifyGraphql::DeletePrivateMetafield is deprecated and will be removed in v3.0. " \
+        "Shopify has removed privateMetafieldDelete from the Admin API. Please use app-owned metafields (metafieldsDelete with an $app namespace) instead.")
+
       input = {namespace: namespace, key: key}
       input[:owner] = owner if owner
 

data/app/graphql/shopify_graphql/get_bulk_operation.rb

@@ -7,14 +7,17 @@ module ShopifyGraphql
         node(id: $id) {
           ... on BulkOperation {
             id
+            type
             status
             errorCode
             createdAt
             completedAt
             fileSize
             url
+            partialDataUrl
             objectCount
             rootObjectCount
+            query
           }
         }
       }
@@ -35,13 +38,17 @@ module ShopifyGraphql
 
       OpenStruct.new(
         id: data.id,
+        type: data.type,
         status: data.status,
         error_code: data.errorCode,
         created_at: Time.find_zone("UTC").parse(data.createdAt),
         completed_at: data.completedAt ? Time.find_zone("UTC").parse(data.completedAt) : nil,
+        file_size: data.fileSize ? data.fileSize.to_i : nil,
         url: data.url,
+        partial_data_url: data.partialDataUrl,
         object_count: data.objectCount.to_i,
         root_object_count: data.rootObjectCount.to_i,
+        query: data.query,
       )
     end
   end

data/app/graphql/shopify_graphql/upsert_private_metafield.rb

@@ -21,6 +21,9 @@ module ShopifyGraphql
     GRAPHQL
 
     def call(namespace:, key:, value:, owner: nil)
+      ShopifyGraphql::Deprecation.warn_once("ShopifyGraphql::UpsertPrivateMetafield", "ShopifyGraphql::UpsertPrivateMetafield is deprecated and will be removed in v3.0. " \
+        "Shopify has removed privateMetafieldUpsert from the Admin API. Please use app-owned metafields (metafieldsSet with an $app namespace) instead.")
+
       input = {namespace: namespace, key: key}
       input[:owner] = owner if owner
 

data/lib/shopify_graphql/client.rb

@@ -1,30 +1,22 @@
 module ShopifyGraphql
-  # Mapping from deprecated plan_name to plan_display_name
-  PLAN_TO_DISPLAY_NAME = {
-    "trial" => "trial",
-    "frozen" => "frozen",
-    "fraudulent" => "cancelled",
-    "shopify_alumni" =>	"shopify_alumni",
-    "affiliate" => "development",
-    "basic" => "basic",
-    "professional" => "shopify",
-    "npo_full" => "npo_full",
-    "shopify_plus" => "shopify_plus",
-    "staff" => "staff",
-    "unlimited" => "advanced",
-    "retail" => "retail",
-    "cancelled" => "cancelled",
-    "dormant" => "pause_and_build",
-    "starter_2022" => "shopify_starter",
-    "plus_partner_sandbox" => "shopify_plus_partner_sandbox",
-    "paid_trial" => "extended_trial",
-    "partner_test" => "developer_preview",
-    "open_learning" => "open_learning",
-    "staff_business" => "staff_business"
-  }
-  DISPLAY_NAME_TO_PLAN = PLAN_TO_DISPLAY_NAME.invert
-
   class Client
+    NETWORK_ERRORS = [
+      Errno::ECONNRESET,
+      Errno::ECONNABORTED,
+      Errno::ECONNREFUSED,
+      Errno::EPIPE,
+      Errno::ENETUNREACH,
+      Errno::EHOSTUNREACH,
+      Errno::ETIMEDOUT,
+      Net::ReadTimeout,
+      Net::OpenTimeout,
+      OpenSSL::SSL::SSLError,
+      EOFError
+    ].freeze
+
+    # Stable part of the 403 errors message for a non-expiring offline access token
+    NON_EXPIRING_TOKEN_MESSAGE = /non-expiring access tokens are no longer accepted/i
+
     def client
       session = ShopifyAPI::Context.active_session
       if @client.nil? || @access_token != session&.access_token || @shop != session&.shop
@@ -36,13 +28,14 @@ module ShopifyGraphql
     end
 
     def execute(query, headers: nil, **variables)
+      @last_response = nil
       response = client.query(query: query, variables: variables, headers: headers)
-      Response.new(handle_response(response))
+      @last_response = Response.new(handle_response(response))
     rescue ShopifyAPI::Errors::HttpResponseError => e
-      Response.new(handle_response(e.response, e))
+      @last_response = Response.new(handle_response(e.response, e))
     rescue JSON::ParserError => e
       raise ServerError.new(response: response), "Invalid JSON response: #{e.message}"
-    rescue Errno::ECONNRESET, Errno::EPIPE, Errno::ECONNREFUSED, Errno::ENETUNREACH, Net::ReadTimeout, Net::OpenTimeout, OpenSSL::SSL::SSLError, EOFError => e
+    rescue *NETWORK_ERRORS => e
       raise ServerError.new(response: response), "Network error: #{e.message}"
     rescue => e
       if (defined?(Socket::ResolutionError) and e.is_a?(Socket::ResolutionError))
@@ -62,7 +55,7 @@ module ShopifyGraphql
 
     def handle_response(response, error = nil)
       case response.code
-      when 200..400
+      when 200...400
         handle_graphql_errors(response)
       when 400
         raise BadRequest.new(response: response), error.message
@@ -71,6 +64,9 @@ module ShopifyGraphql
       when 402
         raise PaymentRequired.new(response: response), error.message
       when 403
+        if non_expiring_token_rejected?(response)
+          raise NonExpiringTokenRejected.new(response: response), error.message
+        end
         raise ForbiddenAccess.new(response: response), error.message
       when 404
         raise ResourceNotFound.new(response: response), error.message
@@ -99,11 +95,24 @@ module ShopifyGraphql
 
     def handle_graphql_errors(response)
       parsed_body = parsed_body(response)
-      if parsed_body.errors.nil? || parsed_body.errors.empty?
-        return parsed_body(response)
+      errors = parsed_body.errors
+      if errors.nil? || errors.empty?
+        return parsed_body
+      end
+
+      unless errors.is_a?(Array) && errors.first.is_a?(OpenStruct)
+        message = if errors.is_a?(OpenStruct)
+          errors.to_h.map { |key, value| "#{key}: #{value}" }.join(", ")
+        else
+          Array(errors).join(", ")
+        end
+        exception = ConnectionError.new(response: response)
+        exception.messages = [ message ]
+        attach_graphql_response(exception, parsed_body, errors: [ OpenStruct.new(message: message) ])
+        raise exception, generate_error_message(message: message)
       end
 
-      error = parsed_body.errors.first
+      error = errors.first
       error_code = error.extensions&.code
       error_message = generate_error_message(
         message: error.message,
@@ -118,31 +127,54 @@ module ShopifyGraphql
           ServerError.new(response: response)
         when "SHOP_PENDING_TERMINATION"
           ShopPendingTermination.new(response: response)
+        when "SHOP_INACTIVE"
+          ShopInactive.new(response: response)
+        when "ACCESS_DENIED"
+          AccessDenied.new(response: response)
+        when "MAX_COST_EXCEEDED"
+          MaxCostExceeded.new(response: response)
         else
           ConnectionError.new(response: response)
         end
       exception.error_code = error_code
       exception.error_codes = [ error_code ]
       exception.messages = [ error.message ]
+      attach_graphql_response(exception, parsed_body)
       raise exception, error_message
     end
 
-    def handle_user_errors(response)
-      return response if response.userErrors.blank?
+    def non_expiring_token_rejected?(response)
+      body = response.body.is_a?(String) ? response.body : response.body.to_json
+      body.match?(NON_EXPIRING_TOKEN_MESSAGE)
+    end
+
+    def attach_graphql_response(exception, parsed_body, errors: parsed_body.errors)
+      exception.data = parsed_body.data
+      exception.errors = errors
+      exception.graphql_response = Response.new(parsed_body)
+    end
 
-      error = response.userErrors.first
-      errors = response.userErrors
+    # Pass the Response from execute as response: to attach its cost to UserError.
+    # Without it, the last Response returned by execute on this client is used.
+    def handle_user_errors(payload, response: nil)
+      return payload if payload.userErrors.blank?
+
+      error = payload.userErrors.first
+      errors = payload.userErrors
       error_message = generate_user_errors_message(
         messages: errors.map(&:message),
         codes: errors.map(&:code),
         fields: errors.map(&:field),
       )
 
-      exception = UserError.new(response: response)
+      exception = UserError.new(response: payload)
       exception.error_code = error.code
       exception.error_codes = errors.map(&:code)
       exception.fields = errors.map(&:field)
       exception.messages = errors.map(&:message)
+      exception.data = payload
+      exception.errors = errors
+      exception.graphql_response = response || @last_response
       raise exception, error_message
     end
 
@@ -186,10 +218,5 @@ module ShopifyGraphql
     def client
       Client.new
     end
-
-    def normalize_plan_display_name(plan_display_name)
-      return if plan_display_name.blank?
-      plan_display_name.parameterize(separator: "_")
-    end
   end
 end

data/lib/shopify_graphql/configuration.rb

@@ -1,9 +1,14 @@
 module ShopifyGraphql
   class Configuration
-    attr_accessor :webhooks
-    attr_accessor :webhook_jobs_namespace
-    attr_accessor :webhook_enabled_environments
-    attr_accessor :webhooks_manager_queue_name
+    # All settings configure the deprecated webhooks
+    %i[webhooks webhook_jobs_namespace webhook_enabled_environments webhooks_manager_queue_name].each do |setting|
+      attr_reader setting
+
+      define_method(:"#{setting}=") do |value|
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::Configuration##{setting}=") if value.present?
+        instance_variable_set(:"@#{setting}", value)
+      end
+    end
 
     def initialize
       @webhooks_manager_queue_name = Rails.application.config.active_job.queue_name

data/lib/shopify_graphql/controller_concerns/webhook_verification.rb

@@ -12,7 +12,10 @@ module ShopifyGraphql
     private
 
     def deprecate_webhooks
-      ShopifyGraphql.deprecator.warn("ShopifyGraphql webhooks are deprecated and will be removed in v3.0. Please use shopify_app gem for handling webhooks.")
+      ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::WebhookVerification")
+    rescue ActiveSupport::DeprecationException => e
+      # Failing the request would make Shopify retry and eventually drop the subscription
+      logger&.warn(e.message)
     end
 
     def verify_request

data/lib/shopify_graphql/deprecation.rb

@@ -0,0 +1,71 @@
+require 'set'
+
+module ShopifyGraphql
+  def self.deprecator
+    @deprecator ||= ActiveSupport::Deprecation.new("3.0", "ShopifyGraphql")
+  end
+
+  # Warnings for APIs removed in v3.0. Webhook jobs and managers run for every
+  # shop, so each API warns once per process instead of on every call.
+  module Deprecation # :nodoc:
+    PLAN_MESSAGE = "Please use plan_public_display_name, plan_shopify_plus and plan_partner_development from ShopifyGraphql::CurrentShop instead."
+    # Skipped in "called from" so the warning points at the app's code
+    GEM_PATHS = [File.expand_path("..", __dir__), File.expand_path("../../app", __dir__)].map { |path| "#{path}/" }.freeze
+
+    @warned = Set.new
+    @mutex = Mutex.new
+
+    class << self
+      def warn_once(key, message)
+        return unless @mutex.synchronize { @warned.add?(key) }
+
+        begin
+          ShopifyGraphql.deprecator.warn(message, app_callstack(caller_locations))
+        rescue Exception
+          # A deprecator configured to raise should raise on every call, not only the first
+          @mutex.synchronize { @warned.delete(key) }
+          raise
+        end
+      end
+
+      def warn_webhooks_once(api)
+        warn_once(api, "#{api} is part of ShopifyGraphql webhooks, which are deprecated and will be removed in v3.0. " \
+          "Please use shopify_app gem for handling webhooks or declare webhook subscriptions in shopify.app.toml.")
+      end
+
+      # Used by tests to see warnings again
+      def reset
+        @mutex.synchronize { @warned.clear }
+      end
+
+      private
+
+      # Rails < 7.1 raises NoMethodError on an empty callstack
+      def app_callstack(callstack)
+        app_frames = callstack.drop_while { |frame| frame.absolute_path.to_s.start_with?(*GEM_PATHS) }
+        app_frames.empty? ? callstack : app_frames
+      end
+    end
+
+    # Deprecated constant that warns once per process. It's a real constant, so
+    # unqualified lookups from code nested in ShopifyGraphql and defined? still work.
+    class ConstantProxy < ActiveSupport::Deprecation::DeprecatedConstantProxy # :nodoc:
+      private
+
+      def const_missing(name)
+        ShopifyGraphql::Deprecation.warn_once(@old_const, @message)
+        target.const_get(name)
+      end
+
+      def method_missing(called, *args, &block)
+        ShopifyGraphql::Deprecation.warn_once(@old_const, @message)
+        target.__send__(called, *args, &block)
+      end
+    end
+  end
+
+  def self.normalize_plan_display_name(plan_display_name)
+    Deprecation.warn_once("ShopifyGraphql.normalize_plan_display_name", "ShopifyGraphql.normalize_plan_display_name is deprecated and will be removed in v3.0. #{Deprecation::PLAN_MESSAGE}")
+    PlanNames.normalize_display_name(plan_display_name)
+  end
+end

data/lib/shopify_graphql/engine.rb

@@ -1,13 +1,9 @@
 module ShopifyGraphql
-  def self.deprecator
-    @deprecator ||= ActiveSupport::Deprecation.new("3.0", "ShopifyGraphql")
-  end
-
   module RedactJobParams
     private
 
     def args_info(job)
-      log_disabled_classes = %[
+      log_disabled_classes = %w[
         ShopifyGraphql::CreateWebhooksJob
         ShopifyGraphql::DestroyWebhooksJob
         ShopifyGraphql::UpdateWebhooksJob
@@ -21,6 +17,10 @@ module ShopifyGraphql
     engine_name 'shopify_graphql'
     isolate_namespace ShopifyGraphql
 
+    initializer "shopify_graphql.deprecator" do |app|
+      app.deprecators[:shopify_graphql] = ShopifyGraphql.deprecator if app.respond_to?(:deprecators)
+    end
+
     initializer "shopify_graphql.redact_job_params" do
       ActiveSupport.on_load(:active_job) do
         if ActiveJob::Base.respond_to?(:log_arguments?)

data/lib/shopify_graphql/exceptions.rb

@@ -1,6 +1,37 @@
 module ShopifyGraphql
   class ConnectionError < ShopifyAPI::Errors::HttpResponseError
     attr_accessor :error_code, :error_codes, :fields, :messages
+    # Partial data from the GraphQL response. For UserError, the mutation payload.
+    attr_accessor :data
+    # GraphQL errors from the response, or an empty Array when there are none.
+    # For UserError, the payload's userErrors.
+    attr_writer :errors
+    # ShopifyGraphql::Response the error came from, used for cost information
+    attr_accessor :graphql_response
+
+    def errors
+      @errors || []
+    end
+
+    def query_cost
+      graphql_response&.query_cost
+    end
+
+    def requested_query_cost
+      graphql_response&.requested_query_cost
+    end
+
+    def points_left
+      graphql_response&.points_left
+    end
+
+    def points_limit
+      graphql_response&.points_limit
+    end
+
+    def points_restore_rate
+      graphql_response&.points_restore_rate
+    end
 
     def initialize(response: nil)
       unless response
@@ -21,6 +52,33 @@ module ShopifyGraphql
     end
   end
 
+  # Marks errors that mean the shop can't be used right now: the app was
+  # uninstalled or the token revoked, or the shop is frozen, locked, inactive or
+  # pending termination. Use it to stop work for the shop:
+  #
+  #   rescue ShopifyGraphql::ShopUnavailable
+  #   discard_on ShopifyGraphql::ShopUnavailable
+  #
+  # Members:
+  # - UnauthorizedAccess (401): app uninstalled or access token revoked. Shopify
+  #   also returns 401 for an expired access token, so with expiring offline
+  #   tokens a 401 can mean the token wasn't refreshed. Refresh it before
+  #   treating the shop as gone.
+  # - PaymentRequired (402): shop is frozen
+  # - ShopLocked (423): shop is locked
+  # - ShopPendingTermination (SHOP_PENDING_TERMINATION): shop is under review
+  # - ShopInactive (SHOP_INACTIVE): shop is not active
+  #
+  # Not included:
+  # - ForbiddenAccess (403) and NonExpiringTokenRejected. On GraphQL, a 403 means
+  #   the shop was marked as fraudulent, and from January 1, 2027 it's also
+  #   returned for a non-expiring offline access token. Treating every 403 as
+  #   "shop gone" could mark every shop uninstalled once those tokens stop working.
+  # - ResourceNotFound (404). It's also raised for null nodes.
+  # - AccessDenied (ACCESS_DENIED). It means a missing access scope.
+  module ShopUnavailable
+  end
+
   # 4xx Client Error
   class ClientError < ConnectionError
   end
@@ -31,16 +89,23 @@ module ShopifyGraphql
 
   # 401 Unauthorized
   class UnauthorizedAccess < ClientError # :nodoc:
+    include ShopUnavailable
   end
 
   # 402 Payment Required
   class PaymentRequired < ClientError # :nodoc:
+    include ShopUnavailable
   end
 
   # 403 Forbidden
   class ForbiddenAccess < ClientError # :nodoc:
   end
 
+  # 403 Forbidden for a public app's non-expiring offline access token, returned
+  # from January 1, 2027. Exchange it for an expiring token.
+  class NonExpiringTokenRejected < ForbiddenAccess # :nodoc:
+  end
+
   # 404 Not Found
   class ResourceNotFound < ClientError # :nodoc:
   end
@@ -61,12 +126,34 @@ module ShopifyGraphql
   class PreconditionFailed < ClientError # :nodoc:
   end
 
+  # 422 Unprocessable Entity
+  class ResourceInvalid < ClientError # :nodoc:
+  end
+
   # 423 Locked
   class ShopLocked < ClientError # :nodoc:
+    include ShopUnavailable
   end
 
   # GraphQL SHOP_PENDING_TERMINATION error code (shop is under review)
   class ShopPendingTermination < ClientError # :nodoc:
+    include ShopUnavailable
+  end
+
+  # GraphQL SHOP_INACTIVE error code (shop is not active, e.g. after repeated
+  # rate limit overages or due to fraud risk)
+  class ShopInactive < ClientError # :nodoc:
+    include ShopUnavailable
+  end
+
+  # GraphQL ACCESS_DENIED error code (missing access scope). Returned with
+  # HTTP 200, not 403.
+  class AccessDenied < ClientError # :nodoc:
+  end
+
+  # GraphQL MAX_COST_EXCEEDED error code (query is over the single query cost
+  # limit). Retrying doesn't help: reduce the query or use a bulk operation.
+  class MaxCostExceeded < ClientError # :nodoc:
   end
 
   # 429 Too Many Requests

data/lib/shopify_graphql/jobs/create_webhooks_job.rb

@@ -5,6 +5,7 @@ module ShopifyGraphql
     end
 
     def perform(shop_domain:, shop_token:)
+      ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::CreateWebhooksJob")
       webhooks = ShopifyGraphql.configuration.webhooks
 
       ShopifyAPI::Auth::Session.temp(shop: shop_domain, access_token: shop_token) do

data/lib/shopify_graphql/jobs/destroy_webhooks_job.rb

@@ -5,6 +5,7 @@ module ShopifyGraphql
     end
 
     def perform(shop_domain:, shop_token:)
+      ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::DestroyWebhooksJob")
       webhooks = ShopifyGraphql.configuration.webhooks
 
       ShopifyAPI::Auth::Session.temp(shop: shop_domain, access_token: shop_token) do

data/lib/shopify_graphql/jobs/update_webhooks_job.rb

@@ -7,6 +7,7 @@ module ShopifyGraphql
     retry_on ShopifyGraphql::TooManyRequests
 
     def perform(shop_domain:, shop_token:)
+      ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::UpdateWebhooksJob")
       webhooks = ShopifyGraphql.configuration.webhooks
 
       ShopifyAPI::Auth::Session.temp(shop: shop_domain, access_token: shop_token) do

data/lib/shopify_graphql/managers/webhooks_manager.rb

@@ -2,6 +2,7 @@ module ShopifyGraphql
   class WebhooksManager
     class << self
       def queue_create(shop_domain, shop_token)
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::WebhooksManager.queue_create")
         ShopifyGraphql::CreateWebhooksJob.perform_later(
           shop_domain: shop_domain,
           shop_token: shop_token,
@@ -9,6 +10,7 @@ module ShopifyGraphql
       end
 
       def queue_destroy(shop_domain, shop_token)
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::WebhooksManager.queue_destroy")
         ShopifyGraphql::DestroyWebhooksJob.perform_later(
           shop_domain: shop_domain,
           shop_token: shop_token,
@@ -16,6 +18,7 @@ module ShopifyGraphql
       end
 
       def queue_update(shop_domain, shop_token)
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::WebhooksManager.queue_update")
         ShopifyGraphql::UpdateWebhooksJob.perform_later(
           shop_domain: shop_domain,
           shop_token: shop_token,
@@ -26,6 +29,7 @@ module ShopifyGraphql
     attr_reader :required_webhooks
 
     def initialize(webhooks)
+      ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::WebhooksManager")
       @required_webhooks = webhooks
     end
 

data/lib/shopify_graphql/plan_names.rb

@@ -0,0 +1,44 @@
+module ShopifyGraphql
+  # Maps plan.displayName to the legacy plan_name for CurrentShop. The public
+  # ShopifyGraphql::PLAN_TO_DISPLAY_NAME and DISPLAY_NAME_TO_PLAN below are deprecated.
+  module PlanNames # :nodoc:
+    # Mapping from deprecated plan_name to plan_display_name
+    PLAN_TO_DISPLAY_NAME = {
+      "trial" => "trial",
+      "frozen" => "frozen",
+      "fraudulent" => "cancelled",
+      "shopify_alumni" =>	"shopify_alumni",
+      "affiliate" => "development",
+      "basic" => "basic",
+      "professional" => "shopify",
+      "npo_full" => "npo_full",
+      "shopify_plus" => "shopify_plus",
+      "staff" => "staff",
+      "unlimited" => "advanced",
+      "retail" => "retail",
+      "cancelled" => "cancelled",
+      "dormant" => "pause_and_build",
+      "starter_2022" => "shopify_starter",
+      "plus_partner_sandbox" => "shopify_plus_partner_sandbox",
+      "paid_trial" => "extended_trial",
+      "partner_test" => "developer_preview",
+      "open_learning" => "open_learning",
+      "staff_business" => "staff_business"
+    }
+    DISPLAY_NAME_TO_PLAN = PLAN_TO_DISPLAY_NAME.invert
+
+    def self.normalize_display_name(plan_display_name)
+      return if plan_display_name.blank?
+      plan_display_name.parameterize(separator: "_")
+    end
+  end
+
+  PLAN_TO_DISPLAY_NAME = Deprecation::ConstantProxy.new(
+    "ShopifyGraphql::PLAN_TO_DISPLAY_NAME", "ShopifyGraphql::PlanNames::PLAN_TO_DISPLAY_NAME", deprecator,
+    message: "ShopifyGraphql::PLAN_TO_DISPLAY_NAME is deprecated and will be removed in v3.0. #{Deprecation::PLAN_MESSAGE}"
+  )
+  DISPLAY_NAME_TO_PLAN = Deprecation::ConstantProxy.new(
+    "ShopifyGraphql::DISPLAY_NAME_TO_PLAN", "ShopifyGraphql::PlanNames::DISPLAY_NAME_TO_PLAN", deprecator,
+    message: "ShopifyGraphql::DISPLAY_NAME_TO_PLAN is deprecated and will be removed in v3.0. #{Deprecation::PLAN_MESSAGE}"
+  )
+end

data/lib/shopify_graphql/resource.rb

@@ -2,6 +2,17 @@ module ShopifyGraphql
   module Resource
     extend ActiveSupport::Concern
 
+    # The gem's own Shop and Webhook warn when they're used instead
+    INTERNAL_RESOURCES = %w[ShopifyGraphql::Shop ShopifyGraphql::Webhook].freeze
+    private_constant :INTERNAL_RESOURCES
+
+    included do
+      unless INTERNAL_RESOURCES.include?(name)
+        ShopifyGraphql::Deprecation.warn_once("ShopifyGraphql::Resource", "ShopifyGraphql::Resource is deprecated and will be removed in v3.0. " \
+          "Please include ShopifyGraphql::Query or ShopifyGraphql::Mutation in your own classes instead.")
+      end
+    end
+
     class_methods do
       extend Forwardable
       def_delegators :client, :execute, :handle_user_errors

data/lib/shopify_graphql/resources/shop.rb

@@ -4,6 +4,8 @@ module ShopifyGraphql
 
     class << self
       def current
+        ShopifyGraphql::Deprecation.warn_once("ShopifyGraphql::Shop.current", "ShopifyGraphql::Shop.current is deprecated and will be removed in v3.0. " \
+          "Please use ShopifyGraphql::CurrentShop or your own ShopifyGraphql::Query class instead.")
         execute <<~GRAPHQL
           query {
             shop {

data/lib/shopify_graphql/resources/webhook.rb

@@ -48,6 +48,7 @@ module ShopifyGraphql
 
     class << self
       def all
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::Webhook")
         response = execute(ALL_WEBHOOKS_QUERY)
         response.data.webhookSubscriptions.edges.map do |edge|
           edge.node
@@ -55,6 +56,7 @@ module ShopifyGraphql
       end
 
       def create(topic:, address:, include_fields:)
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::Webhook")
         response = execute(CREATE_WEBHOOK_MUTATION,
           topic: topic,
           webhookSubscription: {
@@ -68,6 +70,7 @@ module ShopifyGraphql
       end
 
       def delete(id)
+        ShopifyGraphql::Deprecation.warn_webhooks_once("ShopifyGraphql::Webhook")
         response = execute(DELETE_WEBHOOK_MUTATION, id: id)
         response = response.data.webhookSubscriptionDelete
         handle_user_errors(response)

data/lib/shopify_graphql/response.rb

@@ -26,7 +26,13 @@ module ShopifyGraphql
       extensions&.cost&.actualQueryCost
     end
 
+    def requested_query_cost
+      extensions&.cost&.requestedQueryCost
+    end
+
     def points_maxed?(threshold: 0)
+      return false if points_left.nil?
+
       points_left < threshold
     end
   end

data/lib/shopify_graphql/version.rb

@@ -1,3 +1,3 @@
 module ShopifyGraphql
-  VERSION = "2.5.1"
+  VERSION = "2.6.0"
 end

data/lib/shopify_graphql.rb

@@ -1,6 +1,9 @@
+# OpenStruct holds parsed GraphQL responses; shopify_api uses it without requiring it
+require 'ostruct'
 require 'shopify_api'
 require 'active_support'
 
+require 'shopify_graphql/deprecation'
 require 'shopify_graphql/client'
 require 'shopify_graphql/configuration'
 if defined?(Rails)
@@ -8,6 +11,7 @@ if defined?(Rails)
 end
 require 'shopify_graphql/exceptions'
 require 'shopify_graphql/mutation'
+require 'shopify_graphql/plan_names'
 require 'shopify_graphql/query'
 require 'shopify_graphql/resource'
 require 'shopify_graphql/response'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: shopify_graphql
 version: !ruby/object:Gem::Version
-  version: 2.5.1
+  version: 2.6.0
 platform: ruby
 authors:
 - Kirill Platonov
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-07 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -66,7 +65,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '19.0'
-description:
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  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'
 email:
 - mail@kirillplatonov.com
 executables: []
@@ -94,6 +106,7 @@ files:
 - lib/shopify_graphql/configuration.rb
 - lib/shopify_graphql/controller_concerns/payload_verification.rb
 - lib/shopify_graphql/controller_concerns/webhook_verification.rb
+- lib/shopify_graphql/deprecation.rb
 - lib/shopify_graphql/engine.rb
 - lib/shopify_graphql/exceptions.rb
 - lib/shopify_graphql/jobs/create_webhooks_job.rb
@@ -101,6 +114,7 @@ files:
 - lib/shopify_graphql/jobs/update_webhooks_job.rb
 - lib/shopify_graphql/managers/webhooks_manager.rb
 - lib/shopify_graphql/mutation.rb
+- lib/shopify_graphql/plan_names.rb
 - lib/shopify_graphql/query.rb
 - lib/shopify_graphql/resource.rb
 - lib/shopify_graphql/resources/shop.rb
@@ -113,7 +127,6 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -128,8 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Less painful way to work with Shopify Graphql API in Ruby.
 test_files: []