carddb 0.2.0

data/lib/carddb/client.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module CardDB
+  # Main client class for interacting with the CardDB API.
+  #
+  # @example Basic usage
+  #   client = CardDB::Client.new(api_key: "carddb_xxx")
+  #   games = client.games.search(publisher_slug: "pokemon-company")
+  #
+  # @example With defaults
+  #   client = CardDB::Client.new(
+  #     api_key: "carddb_xxx",
+  #     default_publisher: "pokemon-company",
+  #     default_game: "pokemon-tcg"
+  #   )
+  #   records = client.records.search(dataset_key: "cards")
+  class Client
+    # @return [Configuration] The client configuration
+    attr_reader :config
+
+    # @return [Connection] The HTTP connection
+    attr_reader :connection
+
+    # Create a new CardDB client.
+    #
+    # @param api_key [String, nil] API key for authentication
+    # @param endpoint [String, nil] API endpoint URL
+    # @param timeout [Integer, nil] Request timeout in seconds
+    # @param open_timeout [Integer, nil] Connection timeout in seconds
+    # @param default_publisher [String, nil] Default publisher slug
+    # @param default_game [String, nil] Default game key
+    # @param allowed_publishers [Array<String>, nil] Allowed publisher slugs
+    # @param allowed_games [Hash<String, Array<String>>, nil] Allowed games per publisher
+    # @param config [Configuration, nil] Configuration object (overrides other params)
+    def initialize(
+      api_key: nil,
+      endpoint: nil,
+      timeout: nil,
+      open_timeout: nil,
+      default_publisher: nil,
+      default_game: nil,
+      allowed_publishers: nil,
+      allowed_games: nil,
+      config: nil
+    )
+      @config = build_config(
+        config: config,
+        api_key: api_key,
+        endpoint: endpoint,
+        timeout: timeout,
+        open_timeout: open_timeout,
+        default_publisher: default_publisher,
+        default_game: default_game,
+        allowed_publishers: allowed_publishers,
+        allowed_games: allowed_games
+      )
+      @connection = Connection.new(@config)
+    end
+
+    # Access the Publishers resource
+    #
+    # @return [Resources::Publishers]
+    def publishers
+      @publishers ||= Resources::Publishers.new(self, connection, config)
+    end
+
+    # Access the Games resource
+    #
+    # @return [Resources::Games]
+    def games
+      @games ||= Resources::Games.new(self, connection, config)
+    end
+
+    # Access the Datasets resource
+    #
+    # @return [Resources::Datasets]
+    def datasets
+      @datasets ||= Resources::Datasets.new(self, connection, config)
+    end
+
+    # Access the Records resource
+    #
+    # @return [Resources::Records]
+    def records
+      @records ||= Resources::Records.new(self, connection, config)
+    end
+
+    # Access the Decks resource
+    #
+    # @return [Resources::Decks]
+    def decks
+      @decks ||= Resources::Decks.new(self, connection, config)
+    end
+
+    # Access the Rules resource
+    #
+    # @return [Resources::Rules]
+    def rules
+      @rules ||= Resources::Rules.new(self, connection, config)
+    end
+
+    # Get information about the current API key
+    #
+    # @return [Hash, nil] API key info or nil if no API key
+    def me
+      return nil unless config.api_key
+
+      query = QueryBuilder.fetch_me
+      data = connection.execute(query, {})
+      data['fetchMe']
+    end
+
+    # Execute multiple queries in a single batch request.
+    #
+    # @yield [Batch] The batch builder
+    # @return [Array] Results in the same order as operations were added
+    #
+    # @example
+    #   results = client.batch do |b|
+    #     b.games.fetch("uuid-1")
+    #     b.publishers.fetch(slug: "pokemon-company")
+    #   end
+    def batch
+      batch = Batch.new(self)
+      yield batch
+      batch.execute
+    end
+
+    private
+
+    def build_config(config:, **options)
+      # Use provided config or global config as base
+      base_config = config || CardDB.configuration
+
+      # Merge in any provided options
+      base_config.merge(options.compact)
+    end
+  end
+end