carddb 0.3.0 → 0.3.10

data/examples/publisher_content_pipeline.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'carddb'
+
+client = CardDB::Client.new(secret_key: ENV.fetch('CARDDB_SECRET_KEY'))
+publisher_id = ENV.fetch('CARDDB_PUBLISHER_ID')
+game_key = ENV.fetch('CARDDB_GAME_KEY', 'example-tcg')
+
+game = client.games.get_by_key(publisher_id: publisher_id, game_key: game_key, cache: false) ||
+       client.games.create(
+         input: {
+           publisherId: publisher_id,
+           key: game_key,
+           name: 'Example TCG',
+           visibility: 'PRIVATE'
+         }
+       )
+
+client.import_formats.create(
+  input: {
+    gameId: game.id,
+    key: 'ci-json',
+    name: 'CI JSON',
+    config: { schemaVersion: 1 }
+  }
+)
+
+advanced_payload = {
+  datasets: [
+    {
+      name: 'cards',
+      schema: {
+        identifier: { type: 'STRING', isIdentifier: true },
+        name: { type: 'STRING', required: true }
+      },
+      records: [{ identifier: 'CARD-001', name: 'Example Card' }]
+    }
+  ]
+}
+
+preview = client.imports.preview_game(input: { gameId: game.id, data: advanced_payload })
+raise "Import preview blocked: #{preview.warnings.map(&:message).join(', ')}" unless preview.can_proceed?
+
+import_job = client.imports.run_game(
+  input: {
+    gameId: game.id,
+    data: advanced_payload,
+    options: { mode: 'CREATE', onConflict: 'UPDATE' }
+  }
+)
+completed_import = client.imports.wait_for_game_job(import_job.id)
+raise completed_import.error_message unless completed_import.completed?
+
+dataset = client.datasets.get_by_key(game_id: game.id, dataset_key: 'cards')
+raise 'cards dataset was not created' unless dataset
+
+upsert = client.records.upsert_batch(
+  input: {
+    datasetId: dataset.id,
+    records: [{ identifier: 'CARD-002', name: 'Second Example Card' }],
+    options: { mode: 'STRICT', onConflict: 'UPDATE', dryRun: true }
+  }
+)
+
+raise "Upsert validation failed: #{upsert.dry_run_result.errors.map(&:index).join(', ')}" if upsert.dry_run_result&.errors&.any?
+
+delete_preview = client.records.delete_batch(
+  input: {
+    datasetId: dataset.id,
+    reconcileIdentifiers: %w[CARD-001 CARD-002],
+    dryRun: true
+  }
+)
+puts "Would delete #{delete_preview.matched_count} records"
+
+export_job = client.exports.run(input: { datasetId: dataset.id, format: 'JSON' })
+export_result = client.exports.wait_for_job(export_job.id)
+export_with_fresh_url = client.exports.refresh_url(id: export_result.id)
+puts export_with_fresh_url.download_url

data/lib/carddb/batch.rb

@@ -52,6 +52,13 @@ module CardDB
       BatchProxy.new(self, :records)
     end
 
+    # Access the Decks resource for batching
+    #
+    # @return [BatchProxy]
+    def decks
+      BatchProxy.new(self, :decks)
+    end
+
     # Add an operation to the batch
     #
     # @param resource [Symbol] The resource type
@@ -120,6 +127,8 @@ module CardDB
         build_dataset_query(op, index)
       when :records
         build_record_query(op, index)
+      when :decks
+        build_deck_query(op, index)
       else
         raise ArgumentError, "Unknown resource: #{op[:resource]}"
       end
@@ -201,6 +210,27 @@ module CardDB
       end
     end
 
+    def build_deck_query(op, index)
+      case op[:method]
+      when :fetch
+        var_name = "deckId#{index}"
+        query = "#{op[:alias]}: fetchDeck(id: $#{var_name}) { #{deck_fields} }"
+        [query, { var_name => op[:args][0] }, { var_name => 'UUID' }]
+      when :get
+        if op[:kwargs][:external_ref]
+          var_name = "deckExternalRef#{index}"
+          query = "#{op[:alias]}: deckByExternalRef(externalRef: $#{var_name}) { #{deck_fields} }"
+          [query, { var_name => op[:kwargs][:external_ref] }, { var_name => 'String' }]
+        else
+          var_name = "deckId#{index}"
+          query = "#{op[:alias]}: deck(id: $#{var_name}) { #{deck_fields} }"
+          [query, { var_name => op[:args][0] }, { var_name => 'UUID' }]
+        end
+      else
+        raise ArgumentError, "Unsupported batch method for decks: #{op[:method]}"
+      end
+    end
+
     def build_variable_definitions(variables)
       return '' if variables.empty?
 
@@ -231,6 +261,8 @@ module CardDB
         Dataset.new(result, client: @client)
       when :records
         Record.new(result, client: @client)
+      when :decks
+        Deck.new(result, client: @client)
       else
         result
       end
@@ -263,6 +295,23 @@ module CardDB
     def record_fields
       'id datasetId data createdAt updatedAt dataset { id key name gameId publisherId }'
     end
+
+    def deck_fields
+      [
+        'id ownerType ownerAccountId ownerApiApplicationId environment',
+        'createdByAccountId createdByApiApplicationId accountId apiApplicationId',
+        'gameId game { id key name publisher { id name slug } }',
+        'slug identifier title description formatKey visibility accessMode',
+        'discoverability state archivedAt deletedAt unpublishedAt',
+        'externalRefApiApplicationId externalRef externalSubjectRef',
+        'rulesetId sourceUrl metadata',
+        'entries { id datasetId recordId identifier quantity section sortOrder annotations display }',
+        'sectionDefinitions { key label description order default aliases minCards maxCards excludedFromDeckSize legalCardTypes metadata }',
+        'latestPublishedVersion { id deckId versionNumber slug identifier title description formatKey visibility state publishedAt }',
+        'publishedAt draftRevision draftUpdatedAt draftUpdatedByAccountId draftUpdatedByApiApplicationId',
+        'hasUnpublishedChanges createdAt updatedAt'
+      ].join(' ')
+    end
   end
 
   # Proxy class for batching operations on a specific resource
@@ -279,8 +328,8 @@ module CardDB
     end
 
     # Proxy get calls to the batch
-    def get(**kwargs)
-      @batch.add_operation(resource: @resource, method: :get, kwargs: kwargs)
+    def get(*args, **kwargs)
+      @batch.add_operation(resource: @resource, method: :get, args: args, kwargs: kwargs)
       nil # Return nil since we're batching
     end
   end

data/lib/carddb/client.rb

@@ -98,6 +98,34 @@ module CardDB
       @records ||= Resources::Records.new(self, connection, config)
     end
 
+    # Access the Import Formats resource
+    #
+    # @return [Resources::ImportFormats]
+    def import_formats
+      @import_formats ||= Resources::ImportFormats.new(self, connection, config)
+    end
+
+    # Access the Imports resource
+    #
+    # @return [Resources::Imports]
+    def imports
+      @imports ||= Resources::Imports.new(self, connection, config)
+    end
+
+    # Access the Exports resource
+    #
+    # @return [Resources::Exports]
+    def exports
+      @exports ||= Resources::Exports.new(self, connection, config)
+    end
+
+    # Access the Files resource
+    #
+    # @return [Resources::Files]
+    def files
+      @files ||= Resources::Files.new(self, connection, config)
+    end
+
     # Access the Decks resource
     #
     # @return [Resources::Decks]