Csv template admin set context (#1119)

* Support context-aware CSV template and validation via admin set context

- Pass admin_set_id to CSV template generation and validation so the downloaded
  template and validation use the admin set's metadata context (HYRAX_FLEXIBLE)
- Use Hyrax.schema_for(klass:, admin_set_id:) so context-gated properties
  (e.g. dimensions for ImageResource in special_context) appear in the template
  and in validation
- Update download template link via JS to include selected admin set
- ValkyrieObjectFactory and SchemaAnalyzer use keyword args for schema_for

Co-authored-by: Cursor <cursoragent@cursor.com>

* Address PR review: spec backward compatibility and link text

- In sample_csv_file spec, expect generate_template to be called with admin_set_id: nil when param is omitted
- Restore "a" in download link text: "Download a CSV template for your tenant"

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: ShanaLMoore

app/assets/javascripts/bulkrax/importers_stepper.js

@@ -134,6 +134,7 @@
 
     bindEvents()
     initAdminSetState()
+    updateDownloadTemplateLink()
     updateStepperUI()
     initVisibilityCards()
     setDefaultImportName()
@@ -335,6 +336,7 @@
       StepperState.adminSetId = $(this).val()
       StepperState.settings.adminSetName = $(this).find('option:selected').text()
       updateStepNavigation()
+      updateDownloadTemplateLink()
       // Update validate button state since admin set is required for validation
       if (StepperState.uploadMode === 'file_path' || StepperState.uploadedFiles.length > 0) {
         updateValidateButtonState()
@@ -1638,6 +1640,19 @@
     }
   }
 
+  function updateDownloadTemplateLink() {
+    var $link = $('#download-csv-template-link')
+    if (!$link.length) return
+    var baseUrl = $link.data('sample-csv-url') || $link.attr('href')
+    var adminSetId = $('#importer-admin-set').val()
+    var href = baseUrl
+    if (adminSetId && adminSetId.trim() !== '') {
+      var sep = baseUrl.indexOf('?') >= 0 ? '&' : '?'
+      href = baseUrl + sep + 'admin_set_id=' + encodeURIComponent(adminSetId.trim())
+    }
+    $link.attr('href', href)
+  }
+
   // Navigate to step
   function goToStep(stepNum) {
     StepperState.currentStep = stepNum

app/controllers/bulkrax/importers_controller.rb

@@ -69,7 +69,8 @@ def new
 
     # GET /importers/sample_csv_file
     def sample_csv_file
-      sample = Bulkrax::CsvValidationService.generate_template(models: 'all', output: 'file')
+      admin_set_id = params[:admin_set_id].presence
+      sample = Bulkrax::CsvValidationService.generate_template(models: 'all', output: 'file', admin_set_id: admin_set_id)
       send_file sample, filename: File.basename(sample), type: 'text/csv', disposition: 'attachment'
     rescue StandardError => e
       flash[:error] = "Unable to generate sample CSV file: #{e.message}"

app/views/bulkrax/importers/new_v2.html.erb

@@ -194,7 +194,7 @@
           <!-- Download Template Link -->
           <div class="download-template-link">
             <span class="fa fa-download text-primary"></span>
-            <a href="<%= sample_csv_file_importers_path %>" class="text-primary" download>Download a CSV template for your tenant</a>
+            <a id="download-csv-template-link" href="<%= sample_csv_file_importers_path %>" class="text-primary" download data-sample-csv-url="<%= sample_csv_file_importers_path %>">Download a CSV template for your tenant</a>
           </div>
 
           <!-- Validate Button -->

spec/controllers/bulkrax/importers_controller_spec.rb

@@ -262,6 +262,17 @@ def current_user
           get :sample_csv_file, session: valid_session
 
           expect(response.headers['Content-Type']).to include('text/csv')
+          expect(Bulkrax::CsvValidationService).to have_received(:generate_template)
+            .with(models: 'all', output: 'file', admin_set_id: nil)
+        end
+
+        it 'passes admin_set_id to the service for context-aware template when provided' do
+          allow(Bulkrax::CsvValidationService).to receive(:generate_template).and_return(sample_csv_path)
+
+          get :sample_csv_file, params: { admin_set_id: 'admin-set-123' }, session: valid_session
+
+          expect(Bulkrax::CsvValidationService).to have_received(:generate_template)
+            .with(models: 'all', output: 'file', admin_set_id: 'admin-set-123')
         end
       end