carddb-rails 0.1.0 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0b3bef990ba77cc06d5bcefe584ce475e8a86a9c760850f85b927477cf2b793
-  data.tar.gz: bf78dc4b0c53c3e800ed79a229fdda92ae5e4fa26225674a13919fed7333f3da
+  metadata.gz: 04d2bbc372771a8a467b0acdd64405796f713dcdd73a80792f460ab10e59df2e
+  data.tar.gz: 50b4dd2f97a624d5760b24db4890b1e692e02b7d13fcc2cca7dfc8063abe2afa
 SHA512:
-  metadata.gz: 42c1c12ae51af8f11c2d0ed65c0f7972b50bd6ae5980aa17dd4aaae28b36f61e250d6ebd3b5156b6785085cc9364b4c0e322f11996b16247c7fb24cf67ad9a06
-  data.tar.gz: 377b72303e57d2621bacfa851977be257e6104a3acb2134109f12de04fb33ba58f184f7a05ec024336534e0e59a9a0cbee8e504836268771d3b6ffac73919082
+  metadata.gz: a7ea932a1d98b3e8dbae0d49eacc610997ddba99ba3cae09adeff065b813f9ea81f5ae21d39bba52815c6379323fcb9f67ff8ab1c023a08bd28e37cbda524008
+  data.tar.gz: fb195d0c67c952ff9730ffe500788fe4befa7a4b431acf8b373fc769e286291d7aa5e1895319d7a5fe92347fb2c4fc91552f408445f1488adad1d0ca7be351a1

data/CHANGELOG.md

@@ -14,7 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `GraphQL::Batch` loaders and `GraphQL::Dataloader` sources for CardDB records, decks, games, datasets, and publishers.
 - GraphQL field macros for CardDB-backed resources and dataset list relationships.
 - Explicit deck sync, import, and export service wrappers plus `ActiveJob` support for deck sync jobs.
-- Token-aware deck controller helpers for preview, embed, access, and access-token exchange flows.
+- Token-aware deck controller helpers for explicit deck reads and unified deck-token exchange flows.
 - CI, publish helper script, and gem release metadata aligned with the `carddb` Ruby client.
 
 ## [0.1.0] - 2026-06-17

data/README.md

@@ -340,22 +340,23 @@ CardDB::Rails::DeckExportService.call(
 
 ## Deck Token Controller Helpers
 
-Controllers automatically get token-aware helpers for deck preview/embed/access flows:
+Controllers get helpers for explicit draft/published deck reads and server-side deck token exchange:
 
 ```ruby
-class DeckPreviewsController < ApplicationController
+class DecksController < ApplicationController
   def show
-    @deck = carddb_preview_deck(params[:token])
+    @deck = carddb_published_deck(params[:id])
   end
 end
 ```
 
 Available helpers:
 
-- `carddb_preview_deck(token)`
-- `carddb_embed_deck(token)`
-- `carddb_access_deck(token)`
-- `carddb_exchange_deck_access_token(input)`
+- `carddb_deck(id, read_state:, version: nil)`
+- `carddb_draft_deck(id)`
+- `carddb_published_deck(id, version: nil)`
+- `carddb_deck_by_external_ref(external_ref, read_state:, version: nil)`
+- `carddb_exchange_deck_token(input)`
 
 ## GraphQL Field Helper
 

data/lib/carddb/rails/deck_controller_helpers.rb

@@ -3,24 +3,24 @@
 module CardDB
   module Rails
     module DeckControllerHelpers
-      def carddb_preview_deck(token, client: carddb_client)
-        client.decks.preview(token: token)
+      def carddb_deck(id, read_state:, version: nil, client: carddb_client)
+        client.decks.get(id, read_state: read_state, version: version)
       end
 
-      def carddb_embed_deck(token, client: carddb_client)
-        client.decks.embed(token: token)
+      def carddb_draft_deck(id, client: carddb_client)
+        client.decks.get_draft(id)
       end
 
-      def carddb_access_deck(token, client: carddb_client)
-        client.decks.access(token: token)
+      def carddb_published_deck(id, version: nil, client: carddb_client)
+        client.decks.get_published(id, version: version)
       end
 
-      def carddb_exchange_deck_access_token(input, client: carddb_client)
-        client.decks.exchange_access_token(input: input)
+      def carddb_deck_by_external_ref(external_ref, read_state:, version: nil, client: carddb_client)
+        client.decks.get_by_external_ref(external_ref: external_ref, read_state: read_state, version: version)
       end
 
-      def carddb_exchange_deck_session_token(input, client: carddb_client)
-        client.decks.exchange_session_token(input: input)
+      def carddb_exchange_deck_token(input, client: carddb_client)
+        client.decks.exchange_token(input: input)
       end
     end
   end

data/lib/carddb/rails/graphql/dataloader/deck_by_external_ref_source.rb

@@ -5,9 +5,10 @@ module CardDB
     module GraphQL
       module Dataloader
         class DeckByExternalRefSource < ::GraphQL::Dataloader::Source
-          def initialize(client: nil)
+          def initialize(client: nil, read_state: 'DRAFT')
             super()
             @client = client
+            @read_state = read_state
           end
 
           def fetch(external_refs)
@@ -15,7 +16,7 @@ module CardDB
 
             client.batch do |batch|
               external_refs.each do |external_ref|
-                batch.decks.get(external_ref: external_ref)
+                batch.decks.get_by_external_ref(external_ref: external_ref, read_state: @read_state)
               end
             end
           end

data/lib/carddb/rails/graphql/dataloader/deck_source.rb

@@ -5,9 +5,10 @@ module CardDB
     module GraphQL
       module Dataloader
         class DeckSource < ::GraphQL::Dataloader::Source
-          def initialize(client: nil)
+          def initialize(client: nil, read_state: 'DRAFT')
             super()
             @client = client
+            @read_state = read_state
           end
 
           def fetch(ids)
@@ -15,7 +16,7 @@ module CardDB
 
             client.batch do |batch|
               ids.each do |id|
-                batch.decks.get(id)
+                batch.decks.get(id, read_state: @read_state)
               end
             end
           end

data/lib/carddb/rails/graphql/deck_loader.rb

@@ -6,9 +6,10 @@ module CardDB
   module Rails
     module GraphQL
       class DeckLoader < ::GraphQL::Batch::Loader
-        def initialize(client: nil)
+        def initialize(client: nil, read_state: 'DRAFT')
           super()
           @client = client
+          @read_state = read_state
         end
 
         def perform(ids)
@@ -16,7 +17,7 @@ module CardDB
 
           results = client.batch do |batch|
             ids.each do |id|
-              batch.decks.get(id)
+              batch.decks.get(id, read_state: @read_state)
             end
           end
 
@@ -27,9 +28,10 @@ module CardDB
       end
 
       class DeckByExternalRefLoader < ::GraphQL::Batch::Loader
-        def initialize(client: nil)
+        def initialize(client: nil, read_state: 'DRAFT')
           super()
           @client = client
+          @read_state = read_state
         end
 
         def perform(external_refs)
@@ -37,7 +39,7 @@ module CardDB
 
           results = client.batch do |batch|
             external_refs.each do |external_ref|
-              batch.decks.get(external_ref: external_ref)
+              batch.decks.get_by_external_ref(external_ref: external_ref, read_state: @read_state)
             end
           end
 

data/lib/carddb/rails/graphql/helpers.rb

@@ -4,7 +4,7 @@ module CardDB
   module Rails
     module GraphQL
       module Helpers
-        def carddb_deck_field(name, type:, id: nil, external_ref: nil, client: nil, null: true, description: nil)
+        def carddb_deck_field(name, type:, id: nil, external_ref: nil, client: nil, null: true, description: nil, read_state: 'DRAFT')
           field name, type, null: null, description: description
 
           define_method(name) do
@@ -13,9 +13,9 @@ module CardDB
             resolved_external_ref = CardDB::Rails::Resolver.resolve_graphql_value(self, external_ref)
 
             if resolved_id && resolved_id != ''
-              CardDB::Rails::GraphQL::DeckLoader.for(client: resolved_client).load(resolved_id)
+              CardDB::Rails::GraphQL::DeckLoader.for(client: resolved_client, read_state: read_state).load(resolved_id)
             elsif resolved_external_ref && resolved_external_ref != ''
-              CardDB::Rails::GraphQL::DeckByExternalRefLoader.for(client: resolved_client).load(resolved_external_ref)
+              CardDB::Rails::GraphQL::DeckByExternalRefLoader.for(client: resolved_client, read_state: read_state).load(resolved_external_ref)
             end
           end
         end
@@ -193,6 +193,7 @@ module CardDB
         end
 
         def carddb_deck_dataloader_field(name, type:, id: nil, external_ref: nil, client: nil, null: true,
+                                         read_state: 'DRAFT',
                                          description: nil)
           field name, type, null: null, description: description
 
@@ -204,12 +205,14 @@ module CardDB
             if resolved_id && resolved_id != ''
               dataloader.with(
                 CardDB::Rails::GraphQL::Dataloader::DeckSource,
-                client: resolved_client
+                client: resolved_client,
+                read_state: read_state
               ).load(resolved_id)
             elsif resolved_external_ref && resolved_external_ref != ''
               dataloader.with(
                 CardDB::Rails::GraphQL::Dataloader::DeckByExternalRefSource,
-                client: resolved_client
+                client: resolved_client,
+                read_state: read_state
               ).load(resolved_external_ref)
             end
           end

data/lib/carddb/rails/has_carddb_deck.rb

@@ -13,13 +13,14 @@ module CardDB
       end
 
       class_methods do
-        def has_carddb_deck(name = :carddb_deck, id: nil, external_ref: nil, client: nil, cache: nil)
+        def has_carddb_deck(name = :carddb_deck, id: nil, external_ref: nil, client: nil, cache: nil, read_state: 'DRAFT')
           name = name.to_sym
           definition = {
             id: id,
             external_ref: external_ref,
             client: client,
-            cache: cache
+            cache: cache,
+            read_state: read_state
           }.freeze
 
           self.carddb_deck_definitions = carddb_deck_definitions.merge(name => definition)
@@ -62,7 +63,7 @@ module CardDB
             if ids.any?
               results = client.batch do |batch|
                 ids.each do |id|
-                  batch.decks.get(id)
+                  batch.decks.get(id, read_state: definition[:read_state])
                 end
               end
               decks_by_id = ids.zip(results).to_h
@@ -74,7 +75,7 @@ module CardDB
             elsif external_refs.any?
               results = client.batch do |batch|
                 external_refs.each do |external_ref|
-                  batch.decks.get(external_ref: external_ref)
+                  batch.decks.get_by_external_ref(external_ref: external_ref, read_state: definition[:read_state])
                 end
               end
               decks_by_external_ref = external_refs.zip(results).to_h
@@ -101,11 +102,16 @@ module CardDB
         return carddb_write_deck(name, nil) if id.blank? && external_ref.blank?
 
         client = carddb_deck_resolve_client(definition[:client])
-        deck = if id.present?
-                 client.decks.get(id, cache: definition[:cache])
-               else
-                 client.decks.get_by_external_ref(external_ref: external_ref, cache: definition[:cache])
-               end
+        deck =
+          if id.present?
+            client.decks.get(id, read_state: definition[:read_state], cache: definition[:cache])
+          else
+            client.decks.get_by_external_ref(
+              external_ref: external_ref,
+              read_state: definition[:read_state],
+              cache: definition[:cache]
+            )
+          end
         carddb_write_deck(name, deck)
       end
 

data/lib/carddb/rails/version.rb

@@ -2,6 +2,6 @@
 
 module CardDB
   module Rails
-    VERSION = '0.1.0'
+    VERSION = '0.4.5'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carddb-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.4.5
 platform: ruby
 authors:
 - CardDB Team
@@ -29,7 +29,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.5
+        version: 0.4.5
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -39,7 +39,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.5
+        version: 0.4.5
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -136,7 +136,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 4.0.14
 specification_version: 4
 summary: Rails integration for the CardDB Ruby client
 test_files: []