ams_migration 0.1.3

data/spec/lib/ams_migration/services/learnosity_sink_spec.rb

@@ -0,0 +1,198 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require "webmock/rspec"
+
+describe AmsMigration::Services::LearnositySink do
+  let(:config) do
+    {
+      consumer_key: "test_key",
+      consumer_secret: "test_secret",
+      domain: "test.domain",
+      organization_id: "test_org",
+      replace_images: true,
+      new_image_prefix: "test_prefix"
+    }
+  end
+
+  let(:sink) { described_class.new(config) }
+  let(:client) { instance_double(AmsMigration::Services::LearnosityDataApiClient) }
+
+  before do
+    allow(AmsMigration::Services::LearnosityDataApiClient).to receive(:new).and_return(client)
+  end
+
+  describe "#replace_images?" do
+    context "when replace_images is true in config" do
+      let(:config) { super().merge(replace_images: true) }
+
+      it "returns true" do
+        expect(sink.send(:replace_images?)).to be true
+      end
+    end
+
+    context "when replace_images is false in config" do
+      let(:config) { super().merge(replace_images: false) }
+
+      it "returns false" do
+        expect(sink.send(:replace_images?)).to be false
+      end
+    end
+
+    context "when replace_images is not specified in config" do
+      let(:config) do
+        super().tap { |c| c.delete(:replace_images) }
+      end
+
+      it "defaults to false" do
+        expect(sink.send(:replace_images?)).to be false
+      end
+    end
+  end
+
+  describe "#replace_images_in_questions" do
+    let(:questions) do
+      [
+        {
+          "data" => {
+            "stimulus" => '<p>Here is an image: <img src="http://example.com/image1.jpg"></p>',
+            "options" => [
+              { "label" => '<img src="http://example.com/image2.png">' }
+            ]
+          }
+        }
+      ]
+    end
+
+    let(:image_map) do
+      {
+        "http://example.com/image1.jpg" => "https://assets.learnosity.com/test_prefix/image1.jpg",
+        "http://example.com/image2.png" => "https://assets.learnosity.com/test_prefix/image2.png"
+      }
+    end
+
+    it "replaces image URLs in the collection" do
+      expect(sink).to receive(:upload_images).with(["http://example.com/image1.jpg", "http://example.com/image2.png"]).and_return(image_map)
+
+      result = sink.send(:replace_images_in_questions, questions)
+      question = result.first["data"]
+      expect(question["stimulus"]).to include('src="https://assets.learnosity.com/test_prefix/image1.jpg"')
+      expect(question["options"].first["label"]).to include('src="https://assets.learnosity.com/test_prefix/image2.png"')
+    end
+  end
+
+  describe "#find_images_in_json" do
+    it "finds image sources in nested JSON structures" do
+      json = {
+        "stimulus" => '<p><img src="http://example.com/image1.jpg"></p>',
+        "options" => [
+          { "label" => '<img src="http://example.com/image2.png">' },
+          { "label" => "No image here" }
+        ],
+        "metadata" => {
+          "image" => '<img src="http://example.com/image3.gif">'
+        }
+      }
+
+      result = sink.send(:find_images_in_json, json)
+
+      expect(result).to match_array(%w[http://example.com/image1.jpg http://example.com/image2.png http://example.com/image3.gif])
+    end
+  end
+
+  describe "#find_images_in_question" do
+    context "with a regular question" do
+      let(:question) do
+        {
+          "type" => "mcq",
+          "data" => {
+            "stimulus" => '<p><img src="http://example.com/stimulus.jpg"></p>',
+            "options" => [
+              { "label" => '<img src="http://example.com/option1.png">' }
+            ]
+          }
+        }
+      end
+
+      it "finds images in stimulus and options" do
+        result = sink.send(:find_images_in_question, question)
+        expect(result).to match_array(%w[http://example.com/stimulus.jpg http://example.com/option1.png])
+      end
+    end
+
+    context "with a hotspot question" do
+      let(:question) do
+        {
+          "type" => "hotspot",
+          "data" => {
+            "type" => "hotspot",
+            "stimulus" => '<p><img src="http://example.com/stimulus.jpg"></p>',
+            "image" => {
+              "source" => "http://example.com/hotspot_background.jpg",
+              "width" => 600,
+              "height" => 400
+            },
+            "options" => [
+              { "label" => '<img src="http://example.com/option1.png">' }
+            ]
+          }
+        }
+      end
+
+      it "includes the hotspot background image" do
+        result = sink.send(:find_images_in_question, question)
+        expect(result).to match_array(%w[http://example.com/stimulus.jpg http://example.com/option1.png http://example.com/hotspot_background.jpg])
+      end
+    end
+
+    context "with invalid question data" do
+      it "handles nil question" do
+        expect(sink.send(:find_images_in_question, nil)).to eq([])
+      end
+
+      it "handles question without data" do
+        expect(sink.send(:find_images_in_question, { "type" => "mcq" })).to eq([])
+      end
+    end
+  end
+
+  describe "#replace_images_in_json" do
+    let(:image_map) do
+      {
+        "http://example.com/old1.jpg" => "https://assets.learnosity.com/new1.jpg",
+        "http://example.com/old2.png" => "https://assets.learnosity.com/new2.png"
+      }
+    end
+
+    it "replaces image URLs in nested JSON structures" do
+      json = {
+        "text" => '<p><img src="http://example.com/old1.jpg"></p>',
+        "nested" => {
+          "content" => '<img src="http://example.com/old2.png">'
+        },
+        "array" => [
+          { "image" => '<img src="http://example.com/old1.jpg">' }
+        ]
+      }
+
+      result = sink.send(:replace_images_in_json, json, image_map)
+
+      expect(result["text"]).to include('src="https://assets.learnosity.com/new1.jpg"')
+      expect(result["nested"]["content"]).to include('src="https://assets.learnosity.com/new2.png"')
+      expect(result["array"].first["image"]).to include('src="https://assets.learnosity.com/new1.jpg"')
+    end
+
+    it "handles non-string values" do
+      json = {
+        "number" => 42,
+        "boolean" => true,
+        "null" => nil
+      }
+
+      result = sink.send(:replace_images_in_json, json, image_map)
+      expect(result).to eq(json)
+    end
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/calculated_spec.rb

@@ -0,0 +1,26 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::Calculated do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "calculated.json")) }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to essay item with placeholder text" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq(
+      {
+        stimulus: "The Calculated item was removed from the quiz because there is no equivalent item type in Mastery Connect.  Please check the original quiz for this question.",
+        type: "unsupported_canvas_question_type",
+        validation: { valid_response: { score: 0, value: "" }, scoring_type: "exactMatch" },
+        is_math: true
+      }
+    )
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/essay_spec.rb

@@ -0,0 +1,26 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::Essay do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "essay.json")) }
+
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to essay item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          stimulus: "<p>This is an essay</p> #{image_src}",
+                                          type: "longtextV2",
+                                          metadata: { rubric: "Rubric", rubric_points: 1 },
+                                          is_math: true
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/file_upload_spec.rb

@@ -0,0 +1,23 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::FileUpload do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "file_upload.json")) }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to essay item with placeholder text" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({ stimulus: "The File upload item was removed from the quiz because there is no equivalent item type in Mastery Connect.  Please check the original quiz for this question.",
+                                          type: "unsupported_canvas_question_type",
+                                          validation: { valid_response: { score: 0, value: "" },
+                                                        scoring_type: "exactMatch" },
+                                          is_math: true })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/fill_in_blank_spec.rb

@@ -0,0 +1,30 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::FillInBlank do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "fill_in_blank.json")) }
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to clozetext item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          template: "<p>This is the fill in the blank</p> #{image_src}<br />{{response}}",
+                                          type: "clozetext",
+                                          validation: { valid_response: { score: 1, value: ["answer 1"] },
+                                                        scoring_type: "exactMatch" },
+                                          is_math: true,
+                                          metadata: { distractor_rationale_response_level: ["<p>answer comment 1</p>",
+                                                                                            "<p>answer comment 2</p>",
+                                                                                            "<p>answer comment 3</p>",
+                                                                                            "<p>answer comment 4</p>"] }
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/fill_in_multiple_blanks_spec.rb

@@ -0,0 +1,33 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::FillInMultipleBlanks do
+  let(:question) do
+    File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "fill_in_multiple_blanks.json"))
+  end
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to clozetext item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          template: "<p><span>Roses are {{response}}color1, violets are {{response}}color2</span></p> #{image_src}",
+                                          type: "clozetext",
+                                          validation: { valid_response: { score: 1, value: %w[red green] },
+                                                        scoring_type: "exactMatch",
+                                                        match_all_possible_responses: true,
+                                                        alt_responses: [{ score: 1, value: %w[blue pink] }] },
+                                          is_math: true,
+                                          metadata: { distractor_rationale_response_level: ["<p>red comments</p>",
+                                                                                            "<p>blue comments</p>",
+                                                                                            "<p>green comments</p>",
+                                                                                            "<p>pink comments</p>"] }
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/matching_spec.rb

@@ -0,0 +1,38 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::Matching do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "matching.json")) }
+
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to association item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          stimulus: "<p>Matching question</p> #{image_src}",
+                                          possible_responses: ["",
+                                                               "",
+                                                               "R1",
+                                                               "R2",
+                                                               "R3",
+                                                               "d1",
+                                                               "d2",
+                                                               "d3",
+                                                               "d4",
+                                                               "d5"],
+                                          stimulus_list: ["", "", "L1", "L2", "L3"],
+                                          type: "association",
+                                          validation: { valid_response: { score: 1, value: ["", "", "R1", "R2", "R3"] },
+                                                        scoring_type: "exactMatch" },
+                                          is_math: true
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/multiple_answer_spec.rb

@@ -0,0 +1,33 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::MultipleAnswer do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "multiple_answer.json")) }
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to mcq item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          stimulus: "<p>Multiple answer text</p> #{image_src}",
+                                          options: [{ label: "<p>Answer 1</p>", value: "6739" },
+                                                    { label: "<p>Answer 2</p>", value: "1316" },
+                                                    { label: "Answer 3", value: "6779" }],
+                                          type: "mcq",
+                                          validation: {
+                                            valid_response: { score: 1,
+                                                              value: %w[6739 1316] },
+                                            scoring_type: "exactMatch"
+                                          },
+                                          is_math: true,
+                                          multiple_responses: true
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/multiple_choice_spec.rb

@@ -0,0 +1,31 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::MultipleChoice do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "multiple_choice.json")) }
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to mcq item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          stimulus: "<p>This is an MC Item</p><p><math xmlns=\"http://www.w3.org/1998/Math/MathML\">  <munderover>    <mo>∑<!-- ∑ --></mo>    <mrow class=\"MJX-TeXAtom-ORD\">      <mn>23</mn>    </mrow>    <mrow class=\"MJX-TeXAtom-ORD\">      <mn>23</mn>    </mrow>  </munderover>  <mi>w</mi>  <mi>w</mi>  <mi>w</mi>  <mo>+</mo>  <mi>f</mi>  <mrow>    <mo>(</mo>    <mi>d</mi>    <mo>)</mo>  </mrow></math></p><p> </p> #{image_src}",
+                                          options: [{ label: "<p>Correct answer</p>", value: "2483" },
+                                                    { label: "<p>Answer B<strong>more markup</strong></p>",
+                                                      value: "5396" },
+                                                    { label: "cc", value: "4310" },
+                                                    { label: "dd", value: "7473" }],
+                                          type: "mcq",
+                                          validation: { valid_response: { score: 1, value: ["2483"] },
+                                                        scoring_type: "exactMatch" },
+                                          is_math: true
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/multiple_dropdown_spec.rb

@@ -0,0 +1,39 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::MultipleDropdown do
+  let(:question) do
+    File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "multiple_dropdown.json"))
+  end
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to clozedropdown item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          template: "<p><span>Roses are {{response}}color1, violets are {{response}}color2</span></p><p> </p> #{image_src}",
+                                          type: "clozedropdown",
+                                          possible_responses: [["red", "blue", "green"], ["green", "", "black"]],
+                                          validation: { valid_response: { score: 1, value: %w[red green] },
+                                                        scoring_type: "exactMatch",
+                                                        match_all_possible_responses: true,
+                                                        alt_responses: [{ score: 1, value: ["blue", ""] },
+                                                                        { score: 1, value: %w[green black] }] },
+                                          is_math: true,
+                                          response_container: { pointer: "left" },
+                                          metadata: { distractor_rationale_response_level: ["<p>answer 1 comments</p>",
+                                                                                            "<p>answer 2 comments</p>",
+                                                                                            "<p>answer 3 comments</p>",
+                                                                                            "",
+                                                                                            "",
+                                                                                            ""] }
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/numerical_spec.rb

@@ -0,0 +1,41 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::Numerical do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "numerical.json")) }
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to clozeformula item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          stimulus: "<p>Numerical answer stem</p> #{image_src}",
+                                          template: "{{response}}",
+                                          response_container: {
+                                            template: ""
+                                          },
+                                          type: "clozeformula",
+                                          validation: { scoring_type: "exactMatch",
+                                                        valid_response: { score: 1,
+                                                                          value: [
+                                                                            [{ method: "equivLiteral", value: "20", options: { ignoreOrder: false, inverseResult: false } },
+                                                                             { method: "equivValue",
+                                                                               value: '4\\pm2',
+                                                                               options: { ignoreOrder: false,
+                                                                                          inverseResult: false } },
+                                                                             { method: "equivValue",
+                                                                               value: "21.0001001",
+                                                                               options: { decimalPlaces: 10 } }]
+                                                                          ] } },
+                                          is_math: true,
+                                          response_containers: []
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/text_spec.rb

@@ -0,0 +1,20 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::Text do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "text.json")) }
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to a text return value" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq("<p>Text here</p> #{image_src}")
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/true_false_spec.rb

@@ -0,0 +1,28 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::TrueFalse do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "true_false.json")) }
+  let!(:image_src) { '<img src="https://dummyfileurl.com/file.png" alt="file.png" data-api-endpoint="https://dummyfileurl.com" data-api-returntype="File" />' }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to mcq item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({
+                                          stimulus: "<p>This is true/False</p> #{image_src}",
+                                          options: [{ label: "True", value: "8059" },
+                                                    { label: "False", value: "957" }],
+                                          type: "mcq",
+                                          validation: { valid_response: { score: 1, value: ["957"] },
+                                                        scoring_type: "exactMatch" },
+                                          is_math: true
+                                        })
+  end
+end

data/spec/lib/canvas/converter/classic_quiz/unknown_spec.rb

@@ -0,0 +1,25 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::ClassicQuiz::Unknown do
+  let(:question) do
+    File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "classic_quiz", "unknown.json"))
+  end
+
+  subject { described_class.new(question) }
+
+  it "returns errors with malformed json" do
+    subject = described_class.new('{"this is": "not valid json" xyz }')
+    conversion = subject.convert
+    expect(conversion[:errors].length).to be >= 1
+  end
+
+  it "returns with question type error" do
+    conversion = subject.convert
+    expect(conversion[:errors]).to include("Unknown question type: Unknown")
+  end
+end

data/spec/lib/canvas/converter/common_error.rb

@@ -0,0 +1,16 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+shared_examples "handles common errors" do
+  it "returns with no errors" do
+    conversion = subject.convert
+    expect(conversion[:errors].length).to eq(0), "Errors: #{conversion[:errors].inspect}"
+  end
+
+  it "returns errors with malformed json" do
+    subject = described_class.new('{"this is": "not valid json" xyz }')
+    conversion = subject.convert
+    expect(conversion[:errors].length).to be >= 1
+  end
+end