fragment-dev 1.1.4 → 1.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca9648402c5c64f1f05ad890a4bb80df6f5b320197707d43ed372d7da569c406
-  data.tar.gz: ab4e1040e6fb8c9696fa8832c531d8e1546097b44125d15cb3bc15decfdd18aa
+  metadata.gz: 14ed3fb9c939a656c86ce4ce587c6e778302ba33e112e6d8363fc2ed8a791ee0
+  data.tar.gz: 61f1af6ee1cff1309ad207ff9bcfe0ae07a4903e17fd8cf025a111dda7bdc0f5
 SHA512:
-  metadata.gz: d15487fd0b5b31e7cd25120f1eb247790fc8160c7ba13a5bc9f44c7e4aa69c9156e6ae5bdfc41c59912eae87120efe34546cc62939e2a279336809d06e6d7bf2
-  data.tar.gz: 415d1304fb197e2172a0a10349edfdf0f3dcfdb45219a633cb2f0d7eb5da2316f9dce5ac6aecf5ff1fd6f9158386b30c0c1ee6523185c8a2a0f74afa8ccba9e3
+  metadata.gz: 1f9acc9a93ef576b8358fa082df9f2a38afd716b0b0ad1cb429469761e3ef7090f57c5fe0ae8db8535f6c8abe147fc442e82db99058ff989cb4a3041f497a308
+  data.tar.gz: 400e3b64573ac550667baf79edec6e53452c05cc489fc7d3613063ccbf69bd6ab08b9005d4b069d5b8f09d0b3185085d05b013b78a222cc5a2f8fd42a66924e3

data/lib/fragment.schema.json

@@ -184,20 +184,20 @@
         {
           "kind": "ENUM",
           "name": "BalanceUpdateConsistencyMode",
-          "description": "Used to configure the write-consistency of a Ledger Account's balance.\nSee [Configure consistency](https://fragment.dev/docs#configure-consistency).",
+          "description": "Used to configure the write-consistency of a Ledger Account's balance. See [Configure consistency](https://fragment.dev/docs#configure-consistency).",
           "fields": null,
           "inputFields": null,
           "interfaces": null,
           "enumValues": [
             {
               "name": "eventual",
-              "description": "Eventually consistent balance updates.",
+              "description": null,
               "isDeprecated": false,
               "deprecationReason": null
             },
             {
               "name": "strong",
-              "description": "Strongly consistent balance updates.",
+              "description": null,
               "isDeprecated": false,
               "deprecationReason": null
             }
@@ -460,8 +460,8 @@
                 "kind": "NON_NULL",
                 "name": null,
                 "ofType": {
-                  "kind": "INTERFACE",
-                  "name": "Link",
+                  "kind": "OBJECT",
+                  "name": "CustomLink",
                   "ofType": null
                 }
               },
@@ -2727,6 +2727,120 @@
           "enumValues": null,
           "possibleTypes": null
         },
+        {
+          "kind": "UNION",
+          "name": "DeleteLedgerResponse",
+          "description": null,
+          "fields": null,
+          "inputFields": null,
+          "interfaces": null,
+          "enumValues": null,
+          "possibleTypes": [
+            {
+              "kind": "OBJECT",
+              "name": "BadRequestError",
+              "ofType": null
+            },
+            {
+              "kind": "OBJECT",
+              "name": "DeleteLedgerResult",
+              "ofType": null
+            },
+            {
+              "kind": "OBJECT",
+              "name": "InternalError",
+              "ofType": null
+            }
+          ]
+        },
+        {
+          "kind": "OBJECT",
+          "name": "DeleteLedgerResult",
+          "description": null,
+          "fields": [
+            {
+              "name": "success",
+              "description": null,
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Boolean",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [
+
+          ],
+          "enumValues": null,
+          "possibleTypes": null
+        },
+        {
+          "kind": "UNION",
+          "name": "DeleteSchemaResponse",
+          "description": null,
+          "fields": null,
+          "inputFields": null,
+          "interfaces": null,
+          "enumValues": null,
+          "possibleTypes": [
+            {
+              "kind": "OBJECT",
+              "name": "BadRequestError",
+              "ofType": null
+            },
+            {
+              "kind": "OBJECT",
+              "name": "DeleteSchemaResult",
+              "ofType": null
+            },
+            {
+              "kind": "OBJECT",
+              "name": "InternalError",
+              "ofType": null
+            }
+          ]
+        },
+        {
+          "kind": "OBJECT",
+          "name": "DeleteSchemaResult",
+          "description": null,
+          "fields": [
+            {
+              "name": "success",
+              "description": null,
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Boolean",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [
+
+          ],
+          "enumValues": null,
+          "possibleTypes": null
+        },
         {
           "kind": "INPUT_OBJECT",
           "name": "EntryGroupMatchInput",
@@ -3140,7 +3254,7 @@
         {
           "kind": "INPUT_OBJECT",
           "name": "ExternalAccountMatchInput",
-          "description": "Specify an External Account by using `id`, or  `linkId` and `externalId`.",
+          "description": "Specify an External Account by using `id`, or `linkId` and `externalId`.",
           "fields": null,
           "inputFields": [
             {
@@ -5333,7 +5447,7 @@
           "inputFields": [
             {
               "name": "id",
-              "description": "The FRAGMENT ID of the ledger account",
+              "description": "The FRAGMENT ID of the Ledger Account",
               "type": {
                 "kind": "SCALAR",
                 "name": "ID",
@@ -5353,7 +5467,7 @@
             },
             {
               "name": "path",
-              "description": "The unique path of the ledger account.\n\nThis is a slash-delimited string containing the keys of an account and all its direct ancestors.",
+              "description": "The unique path of the Ledger Account.\nThis is a slash-delimited string containing the keys of an account and all its direct ancestors.",
               "type": {
                 "kind": "SCALAR",
                 "name": "String",
@@ -5911,6 +6025,20 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "parameters",
+              "description": "The parameters used to post this Ledger Entry.",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Parameters",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "posted",
               "description": "ISO-8601 timestamp this LedgerEntry posted to its Ledger.",
@@ -6252,6 +6380,24 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "dashboardUrl",
+              "description": "URL to the Fragment Dashboard for this Ledger Entry Group.",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "String",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "key",
               "description": "The key of this Ledger Entry Group.",
@@ -6270,6 +6416,24 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "ledger",
+              "description": "The Ledger that this Ledger Entry Group is within.",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "OBJECT",
+                  "name": "Ledger",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "ledgerEntries",
               "description": null,
@@ -6337,6 +6501,24 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "ledgerId",
+              "description": "The ID of the Ledger this Ledger Entry Group is within.",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "ID",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "value",
               "description": "The value associated with Ledger Entry Group.",
@@ -6694,7 +6876,7 @@
           "inputFields": [
             {
               "name": "created",
-              "description": "Use to filter ledger groups by their created timestamp",
+              "description": "Use to filter Ledger Entry Groups by their created timestamp",
               "type": {
                 "kind": "INPUT_OBJECT",
                 "name": "DateTimeFilter",
@@ -6704,7 +6886,17 @@
             },
             {
               "name": "key",
-              "description": "Use to filter ledger groups by their type",
+              "description": "Use to filter Ledger Entry Groups by their key",
+              "type": {
+                "kind": "INPUT_OBJECT",
+                "name": "StringFilter",
+                "ofType": null
+              },
+              "defaultValue": null
+            },
+            {
+              "name": "value",
+              "description": "Use to filter Ledger Entry Groups by their value",
               "type": {
                 "kind": "INPUT_OBJECT",
                 "name": "StringFilter",
@@ -6844,6 +7036,16 @@
                 "ofType": null
               },
               "defaultValue": null
+            },
+            {
+              "name": "version",
+              "description": "Experimental: This field is reserved for an upcoming feature and is not yet supported.",
+              "type": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              },
+              "defaultValue": null
             }
           ],
           "interfaces": null,
@@ -6868,7 +7070,7 @@
             },
             {
               "name": "ik",
-              "description": "The IK provided to the `addLedgerEntry` mutation or the `ik` field\nreturned from a `reconcileTx` mutation. This is required if you have not\nprovided `id`.",
+              "description": "The IK provided to the `addLedgerEntry` mutation or the `ik` field returned from a `reconcileTx` mutation. This is required if you have not provided `id`.",
               "type": {
                 "kind": "SCALAR",
                 "name": "SafeString",
@@ -6878,7 +7080,7 @@
             },
             {
               "name": "ledger",
-              "description": "The FRAGMENT ID of the Ledger to which this Ledger Entry belongs. This\nis required if you have not provided `id`.",
+              "description": "The FRAGMENT ID of the Ledger to which this Ledger Entry belongs. This is required if you have not provided `id`.",
               "type": {
                 "kind": "INPUT_OBJECT",
                 "name": "LedgerMatchInput",
@@ -7569,9 +7771,19 @@
           "description": null,
           "fields": null,
           "inputFields": [
+            {
+              "name": "created",
+              "description": "Filter by the created timestamp of the Ledger Line. This is the wall-clock time when the Ledger Line was created.",
+              "type": {
+                "kind": "INPUT_OBJECT",
+                "name": "DateTimeFilter",
+                "ofType": null
+              },
+              "defaultValue": null
+            },
             {
               "name": "date",
-              "description": null,
+              "description": "Filter by the posted date of the Ledger Line. This is identical to using `posted`, but only supports day-level granularity.",
               "type": {
                 "kind": "INPUT_OBJECT",
                 "name": "DateFilter",
@@ -7591,7 +7803,7 @@
             },
             {
               "name": "posted",
-              "description": null,
+              "description": "Filter by the posted timestamp of the Ledger Line.",
               "type": {
                 "kind": "INPUT_OBJECT",
                 "name": "DateTimeFilter",
@@ -7622,7 +7834,7 @@
           "inputFields": [
             {
               "name": "id",
-              "description": "The FRAGMENT ID of the ledger",
+              "description": "The FRAGMENT ID of the Ledger",
               "type": {
                 "kind": "SCALAR",
                 "name": "ID",
@@ -7632,7 +7844,7 @@
             },
             {
               "name": "ik",
-              "description": "The IK passed into the [createLedger](/api-reference#mutations-createledger) mutation. This is treated as a second unique identifier for this ledger.",
+              "description": "The IK passed into the [createLedger](/api-reference#mutations-createledger) mutation. This is treated as a second unique identifier for this Ledger.",
               "type": {
                 "kind": "SCALAR",
                 "name": "SafeString",
@@ -8467,6 +8679,68 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "deleteLedger",
+              "description": "Delete a Ledger",
+              "args": [
+                {
+                  "name": "ledger",
+                  "description": null,
+                  "type": {
+                    "kind": "NON_NULL",
+                    "name": null,
+                    "ofType": {
+                      "kind": "INPUT_OBJECT",
+                      "name": "LedgerMatchInput",
+                      "ofType": null
+                    }
+                  },
+                  "defaultValue": null
+                }
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "UNION",
+                  "name": "DeleteLedgerResponse",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "deleteSchema",
+              "description": "Delete a Schema",
+              "args": [
+                {
+                  "name": "schema",
+                  "description": null,
+                  "type": {
+                    "kind": "NON_NULL",
+                    "name": null,
+                    "ofType": {
+                      "kind": "INPUT_OBJECT",
+                      "name": "SchemaMatchInput",
+                      "ofType": null
+                    }
+                  },
+                  "defaultValue": null
+                }
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "UNION",
+                  "name": "DeleteSchemaResponse",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "reconcileTx",
               "description": "This mutation is used to [reconcile](https://fragment.dev/docs#reconcile-transactions) transactions from an external system into a Ledger Entry. This mutation does not require an idempotency key since a transaction can only be reconciled once per Linked Ledger Account.  If you are reconciling a transfer between two Link Accounts which are both linked to the same Ledger, use a transit account in between to split the transfer into two `reconcileTx` calls.",
@@ -8936,6 +9210,16 @@
           "enumValues": null,
           "possibleTypes": null
         },
+        {
+          "kind": "SCALAR",
+          "name": "Parameters",
+          "description": "A mapping of parameter keys to values.",
+          "fields": null,
+          "inputFields": null,
+          "interfaces": null,
+          "enumValues": null,
+          "possibleTypes": null
+        },
         {
           "kind": "SCALAR",
           "name": "Period",
@@ -9436,14 +9720,14 @@
         {
           "kind": "ENUM",
           "name": "ReadBalanceConsistencyMode",
-          "description": "The consistency configuration of a Ledger Account's balance queries.\nIf not provided as an argument to a balance query, the default behavior is to read eventually consistent balances.\nSee [Configure consistency](https://fragment.dev/docs#configure-consistency).",
+          "description": "The consistency configuration of a Ledger Account's balance queries. If not provided as an argument to a balance query, the default behavior is to read eventually consistent balances. See [Configure consistency](https://fragment.dev/docs#configure-consistency).",
           "fields": null,
           "inputFields": null,
           "interfaces": null,
           "enumValues": [
             {
               "name": "eventual",
-              "description": "Balance queries will read eventually consistent balances. This is the default behavior if `ReadBalanceConsistencyMode` is not provided as an argument to the balance field.\nBoth Ledger Accounts configured with strongly and eventually consistent balance updates support this enum.",
+              "description": "Balance queries will read eventually consistent balances. This is the default behavior if `ReadBalanceConsistencyMode` is not provided as an argument to the balance field. Both Ledger Accounts configured with strongly and eventually consistent balance updates support this enum.",
               "isDeprecated": false,
               "deprecationReason": null
             },
@@ -10603,6 +10887,16 @@
                 }
               },
               "defaultValue": null
+            },
+            {
+              "name": "version",
+              "description": "Experimental: This field is not yet supported.",
+              "type": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              },
+              "defaultValue": null
             }
           ],
           "interfaces": null,
@@ -10749,7 +11043,7 @@
             },
             {
               "name": "version",
-              "description": "Optional parameter to specify version of requested Schema. If not provided, it defaults to 0,\nrepresenting the latest available version for the provided Schema key.",
+              "description": "Optional parameter to specify version of requested Schema. If not provided, it defaults to 0, representing the latest available version for the provided Schema key.",
               "type": {
                 "kind": "SCALAR",
                 "name": "Int",
@@ -11047,6 +11341,16 @@
           "description": null,
           "fields": null,
           "inputFields": [
+            {
+              "name": "contains",
+              "description": "Must contain the provided pattern somewhere within the string. For example, 'contains: hat' will match 'hat', 'chat', and 'hate'.",
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "defaultValue": null
+            },
             {
               "name": "equalTo",
               "description": "Must exactly equal the provided value",

data/lib/fragment_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FragmentSDK
-  VERSION = '1.1.4'
+  VERSION = '1.1.5'
 end

data/lib/fragment_client.rb

@@ -9,33 +9,23 @@ require 'uri'
 require 'net/http'
 require 'fragment_client/version'
 
-module GraphQL
-  module StaticValidation
-    class LiteralValidator
-      alias recursive_validate_old recursively_validate
-      def recursively_validate(ast_value, type)
-        res = catch(:invalid) do
-          recursive_validate_old(ast_value, type)
-        end
-        if !res.valid? && type.kind.scalar? && ast_value.is_a?(GraphQL::Language::Nodes::InputObject)
-          maybe_raise_if_invalid(ast_value) do
-            ['JSON', 'JSONObject', 'Any'].include?(type.graphql_name) ? @valid_response : @invalid_response
-          end
-        else
-          res 
-        end
-      end
-    end
-  end
-
-  class Client
-    # A monkey patch to change the definition name
-    class Definition
-      alias old_definition_name definition_name
-      def definition_name
-        old_definition_name.gsub(/#<Module.*>/, 'FragmentGraphQl__Dynamic')
-      end
-    end
+module GraphQL	
+  module StaticValidation	
+    class LiteralValidator	
+      alias recursive_validate_old recursively_validate	
+      def recursively_validate(ast_value, type)	
+        res = catch(:invalid) do	
+          recursive_validate_old(ast_value, type)	
+        end	
+        if !res.valid? && type.kind.scalar? && ast_value.is_a?(GraphQL::Language::Nodes::InputObject)	
+          maybe_raise_if_invalid(ast_value) do	
+            ['JSON', 'JSONObject', 'Any'].include?(type.graphql_name) ? @valid_response : @invalid_response	
+          end	
+        else	
+          res 	
+        end	
+      end	
+    end	
   end
 end
 
@@ -57,7 +47,22 @@ module FragmentGraphQl
 
   FragmentSchema = T.let(GraphQL::Client.load_schema("#{__dir__}/fragment.schema.json"), T.untyped)
 
-  Client = T.let(GraphQL::Client.new(schema: FragmentSchema, execute: HTTP), GraphQL::Client)
+  # Create a custom client class for Fragment-specific behavior
+  class CustomClient < GraphQL::Client
+    class Definition < GraphQL::Client::Definition
+      def definition_name
+        super.gsub(/#<Module.*>/, 'FragmentGraphQl__Dynamic')
+      end
+    end
+
+    # Add this method to allow creating new instances
+    def self.new(schema:, execute:)
+      super(schema: schema, execute: execute)
+    end
+  end
+
+  # Use our custom client instead of the base GraphQL::Client
+  Client = T.let(CustomClient.new(schema: FragmentSchema, execute: HTTP), CustomClient)
 
   FragmentQueries = T.let(Client.parse(
                             File.read("#{__dir__}/queries.graphql")
@@ -89,7 +94,13 @@ class FragmentClient
     execute = api_url ? FragmentGraphQl::CustomHTTP.new(URI.parse(api_url).to_s) : FragmentGraphQl::HTTP
     @execute = T.let(execute, GraphQL::Client::HTTP)
 
-    @client = T.let(GraphQL::Client.new(schema: FragmentGraphQl::FragmentSchema, execute: @execute), GraphQL::Client)
+    @client = T.let(
+      FragmentGraphQl::CustomClient.new(
+        schema: FragmentGraphQl::FragmentSchema, 
+        execute: @execute
+      ), 
+      FragmentGraphQl::CustomClient
+    )
     @token = T.let(create_token, Token)
 
     define_method_from_queries(FragmentGraphQl::FragmentQueries)
@@ -103,10 +114,15 @@ class FragmentClient
     end
   end
 
+  # Move these error class definitions up, before the query method
+  class ResponseError < GraphQL::Client::Error; end
+  class NetworkError < GraphQL::Client::Error; end
+  class AuthenticationError < StandardError; end
+  class TokenExpiredError < StandardError; end
+
   sig { params(query: T.untyped, variables: T.untyped).returns(T.untyped) }
   def query(query, variables)
-    expiry_time_skew = 120
-    @token = create_token if Time.now > @token.expires_at - expiry_time_skew
+    refresh_token_if_needed
     @client.query(query, variables: variables, context: { access_token: @token.token })
   end
 
@@ -138,17 +154,65 @@ class FragmentClient
 
       case response
       when Net::HTTPSuccess
-        # Parse the response body
         body = JSON.parse(response.body)
         Token.new(
           token: T.let(body['access_token'], String),
           expires_at: Time.now + T.let(body['expires_in'], Integer)
         )
+      when Net::HTTPUnauthorized
+        raise AuthenticationError, "Invalid credentials: #{response.body}"
       else
-        raise StandardError, format("oauth Authentication failed: '%s'", response.body)
+        raise AuthenticationError, "Authentication failed (#{response.code}): #{response.body}"
       end
+    rescue JSON::ParserError => e
+      raise AuthenticationError, "Invalid response format: #{e.message}"
     rescue StandardError => e
-      raise StandardError, format("oauth Authentication failed: '%s'", e.to_s)
+      raise AuthenticationError, "Authentication failed: #{e.message}"
+    end
+  end
+
+  class Configuration
+    extend T::Sig
+
+    sig { returns(Integer) }
+    attr_accessor :token_expiry_buffer
+    sig { returns(Logger) }
+    attr_accessor :logger
+
+    sig { void }
+    def initialize
+      @token_expiry_buffer = T.let(120, Integer)
+      @logger = T.let(Logger.new($stdout), Logger)
+    end
+  end
+
+  class << self
+    extend T::Sig
+
+    sig { returns(Configuration) }
+    def configuration
+      @configuration ||= Configuration.new
     end
+
+    sig { params(blk: T.proc.params(config: Configuration).void).void }
+    def configure(&blk)
+      yield(configuration)
+    end
+  end
+
+  sig { returns(Logger) }
+  def logger
+    self.class.configuration.logger
+  end
+
+  sig { void }
+  def refresh_token_if_needed
+    return unless token_expired?
+    @token = create_token
+  end
+
+  sig { returns(T::Boolean) }
+  def token_expired?
+    Time.now > @token.expires_at - self.class.configuration.token_expiry_buffer
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fragment-dev
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.1.5
 platform: ruby
 authors:
 - fragment
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-09 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql
@@ -88,7 +88,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.9
 signing_key:
 specification_version: 4
 summary: the ruby fragment client sdk