cineworld_uk 4.1.0-x86_64-darwin

data/test/lib/cineworld_uk/internal/api_response_test.rb

@@ -0,0 +1,207 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "tmpdir"
+
+# This block groups independent Minitest cases, not application logic.
+describe "Vista retrieval" do # rubocop:disable Metrics/BlockLength
+  before do
+    CineworldUk.token = "test-guest-token"
+    [CineworldUk::Cinema, CineworldUk::Performance].each do |klass|
+      klass.instance_variables.each do |name|
+        klass.remove_instance_variable(name)
+      end
+    end
+    fixture = "../../../fixtures/api/vista-showtimes-brighton.json"
+    @capture = JSON.parse(File.read(File.expand_path(fixture, __dir__)))
+    @base = "https://digital-api.cineworld.co.uk/ocapi/v1/"
+    sites = @capture.fetch("relatedData").fetch("sites")
+    stub_request(:get, @base + "sites").with(
+      headers: {
+        "Authorization" => "Bearer test-guest-token",
+        "Connect-Region-Code" => "GB"
+      }
+    ).to_return(body: JSON.generate("sites" => sites))
+  end
+
+  after do
+    CineworldUk.token = nil
+    [CineworldUk::Cinema, CineworldUk::Performance].each do |klass|
+      klass.instance_variables.each do |name|
+        klass.remove_instance_variable(name)
+      end
+    end
+  end
+
+  def stub_day(day, body)
+    stub_request(:get, @base + "showtimes/by-business-date/#{day}").with(
+      query: { "siteIds" => "014" },
+      headers: { "Authorization" => "Bearer test-guest-token",
+                 "Connect-Region-Code" => "GB" }
+    ).to_return(body: JSON.generate(body))
+  end
+
+  it "retrieves cinemas and advertised session times from Vista" do
+    stub_day("2026-10-14", @capture)
+    cinema = CineworldUk::Cinema.all.first
+    _(cinema.id).must_equal 14
+    _(cinema.name).must_equal "Brighton"
+    _(cinema.postal_code).must_equal "BN2 5UF"
+    _(cinema.street_address).must_equal "Brighton Marina Village"
+    assert_requested :get, @base + "sites", times: 1
+    performances = CineworldUk::Performance.at(
+      14, from: Date.new(2026, 10, 14), to: Date.new(2026, 10, 14)
+    )
+    _(performances.size).must_equal 17
+    first = performances.first
+    _(first.film_name).must_equal "Other Mommy"
+    _(first.starting_at).must_equal Time.utc(2026, 10, 14, 14, 40)
+    _(first.booking_url).must_equal(
+      "https://web.cineworld.co.uk/order/showtimes/014-165507/seats"
+    )
+    _(first.variant).must_include "audio_described"
+    _(first.dimension).must_equal "2d"
+    assert_requested :get, @base + "sites", times: 1
+    assert_requested :get, @base + "showtimes/by-business-date/2026-10-14",
+                     query: { "siteIds" => "014" }, times: 1
+  end
+
+  it "keeps format session-specific and includes the last requested day" do
+    @capture["showtimes"] =
+      [@capture["showtimes"].first,
+       Marshal.load(Marshal.dump(@capture["showtimes"].first))]
+    @capture["showtimes"][1]["id"] = "014-second"
+    @capture["showtimes"][1]["requires3dGlasses"] = true
+    @capture["showtimes"][1]["schedule"]["startsAt"] =
+      "2026-10-25T16:40:00+00:00"
+    stub_day("2026-10-24",
+             "showtimes" => [],
+             "relatedData" => { "films" => [], "attributes" => [],
+                                "sites" => [] })
+    stub_day("2026-10-25", @capture)
+    results = CineworldUk::Performance.at("014", from: Date.new(2026, 10, 24),
+                                                 to: Date.new(2026, 10, 25))
+    _(results.map(&:dimension)).must_equal %w[2d 3d]
+    _(results.last.starting_at).must_equal Time.utc(2026, 10, 25, 16, 40)
+    _(results.first.cinema_name).must_equal "Brighton"
+    assert_not_requested :get, @base + "sites"
+  end
+
+  it "rejects missing and rejected tokens without exposing credentials" do
+    CineworldUk.token = nil
+    assert_raises(CineworldUk::AuthenticationError) { CineworldUk::Cinema.all }
+    CineworldUk.token = "expired-secret"
+    stub_request(:get, @base + "sites").to_return(status: 401,
+                                                  body: "expired-secret")
+    error = assert_raises(CineworldUk::AuthenticationError) do
+      CineworldUk::Cinema.all
+    end
+    refute_includes error.message, "expired-secret"
+    CineworldUk.token = "replacement"
+    stub_request(:get, @base + "sites").with(
+      headers: { "Authorization" => "Bearer replacement" }
+    ).to_return(body: '{"sites":[]}')
+    _(CineworldUk::Cinema.all).must_equal []
+  end
+
+  it "defaults to fourteen days and rejects reversed ranges" do
+    day = Date.new(2026, 10, 14)
+    (day..day + 13).each do |date|
+      stub_day(date.iso8601,
+               "showtimes" => [],
+               "relatedData" => { "films" => [], "attributes" => [],
+                                  "sites" => [] })
+    end
+    _(CineworldUk::Performance.at(14, from: day)).must_equal []
+    assert_requested :get, %r{showtimes/by-business-date/}, times: 14
+    assert_raises(ArgumentError) do
+      CineworldUk::Performance.at(14, from: day, to: day - 1)
+    end
+    assert_not_requested :get, @base + "sites"
+  end
+
+  it "does not follow redirects or hide forbidden responses" do
+    [302, 403].each do |status|
+      stub_request(:get, @base + "sites").to_return(
+        status: status, headers: { "Location" => "https://example.com/" }
+      )
+      error = assert_raises(RuntimeError) { CineworldUk::Cinema.all }
+      assert_includes error.message, status.to_s
+    end
+  end
+end
+
+describe "Guest token acquisition" do
+  before do
+    @directory = Dir.mktmpdir("cineworld token ")
+    @curl = File.join(@directory, "curl-impersonate")
+    CineworldUk.token = "existing-token"
+  end
+
+  after do
+    FileUtils.remove_entry(@directory)
+    CineworldUk.token = nil
+  end
+
+  def serve_token_page(html, status: 200, exit_code: 0)
+    output = "#{html}\n#{status}"
+    File.write(@curl, "#!#{RbConfig.ruby}\nSTDOUT.write(#{output.dump})\nexit #{exit_code}\n")
+    File.chmod(0o700, @curl)
+  end
+
+  def token_page(expires)
+    payload = Base64.urlsafe_encode64(JSON.generate("exp" => expires), padding: false)
+    token = "header.#{payload}.signature"
+    data = { "props" => { "pageProps" => { "environment" => { "gasToken" => token } } } }
+    ["<script type='application/json' id='__NEXT_DATA__'>#{JSON.generate(data)}</script>", token]
+  end
+
+  it "sets and returns the guest JWT from either a 200 or 404 page" do
+    html, token = token_page(Time.now.to_i + 3600)
+    [200, 404].each do |status|
+      serve_token_page(html, status: status)
+      _(CineworldUk.acquire_token!(curl: @curl)).must_equal token
+      _(CineworldUk.token).must_equal token
+    end
+  end
+
+  it "rejects expired tokens including the expiry boundary without replacing the current token" do
+    now = Time.at(1_800_000_000)
+    Time.stub(:now, now) do
+      [-1, 0, 1].each do |offset|
+        html, token = token_page(now.to_i + offset)
+        serve_token_page(html)
+        if offset.positive?
+          _(CineworldUk.acquire_token!(curl: @curl)).must_equal token
+        else
+          assert_raises(CineworldUk::AuthenticationError) { CineworldUk.acquire_token!(curl: @curl) }
+          _(CineworldUk.token).must_equal "existing-token"
+        end
+      end
+    end
+  end
+
+  it "reports blocked, redirected, missing and malformed page data without exposing the response" do
+    html, token = token_page(Time.now.to_i + 3600)
+    invalid_payload = Base64.urlsafe_encode64("broken-secret", padding: false)
+    [[html, 403], [html, 302], ["Cloudflare block", 200],
+     ["<script id='__NEXT_DATA__'>{</script>", 200],
+     ["<script id='__NEXT_DATA__'>{}</script>", 200],
+     [html.sub(token, "broken-secret"), 200],
+     [html.sub(token, "header.#{invalid_payload}.signature"), 200]].each do |body, status|
+      serve_token_page(body, status: status)
+      error = assert_raises(CineworldUk::AuthenticationError) { CineworldUk.acquire_token!(curl: @curl) }
+      refute_includes error.full_message, token
+      refute_includes error.full_message, "broken-secret"
+      _(CineworldUk.token).must_equal "existing-token"
+    end
+  end
+
+  it "reports a missing executable or curl failure as an authentication error" do
+    error = assert_raises(CineworldUk::AuthenticationError) { CineworldUk.acquire_token!(curl: @curl) }
+    assert_includes error.message, "Install curl-impersonate"
+    serve_token_page("", status: 0, exit_code: 28)
+    error = assert_raises(CineworldUk::AuthenticationError) { CineworldUk.acquire_token!(curl: @curl) }
+    assert_includes error.message, "curl exit 28"
+  end
+end

data/test/lib/cineworld_uk/internal/parser/api/cinema_address_test.rb

@@ -0,0 +1,94 @@
+require_relative '../../../../../test_helper'
+require_relative '../../../../../support/fixture_reader'
+
+describe CineworldUk::Internal::Parser::Api::CinemaAddress do
+  include Support::FixtureReader
+
+  let(:described_class) { CineworldUk::Internal::Parser::Api::CinemaAddress }
+  let(:api_response) { Minitest::Mock.new }
+
+  before { WebMock.disable_net_connect! }
+  after { WebMock.allow_net_connect! }
+
+  describe '#to_hash' do
+    subject { described_class.new(id).to_hash }
+
+    before do
+      api_response.expect(:cinema_list, cinema_list_json)
+    end
+
+    describe 'passed simple (Brighton)' do
+      let(:id) { 14 }
+
+      it 'returns address hash' do
+        CineworldUk::Internal::ApiResponse.stub :new, api_response do
+          _(subject).must_equal(street_address:   'Brighton Marina Village',
+                             extended_address: nil,
+                             locality:         'Brighton',
+                             region:           nil,
+                             postal_code:      'BN2 5UF',
+                             country:          'United Kingdom')
+        end
+      end
+    end
+
+    describe 'passed three line (NEC)' do
+      let(:id) { 90 }
+
+      it 'returns address hash' do
+        CineworldUk::Internal::ApiResponse.stub :new, api_response do
+          _(subject).must_equal(street_address:   'Resorts World',
+                             extended_address: 'Pendigo Way',
+                             locality:         'Birmingham',
+                             region:           nil,
+                             postal_code:      'B40 1PU',
+                             country:          'United Kingdom')
+        end
+      end
+    end
+
+    describe 'passed three line (Edinburgh)' do
+      let(:id) { 37 }
+
+      it 'returns address hash' do
+        CineworldUk::Internal::ApiResponse.stub :new, api_response do
+          _(subject).must_equal(street_address:   'Fountain Park',
+                             extended_address: '130/3 Dundee Street',
+                             locality:         'Edinburgh',
+                             region:           nil,
+                             postal_code:      'EH11 1AF',
+                             country:          'United Kingdom')
+        end
+      end
+    end
+
+    describe 'passed two line (Leicester Square)' do
+      let(:id) { 103 }
+
+      it 'returns address hash' do
+        CineworldUk::Internal::ApiResponse.stub :new, api_response do
+          _(subject).must_equal(street_address:   '5-6 Leicester Square',
+                             extended_address: nil,
+                             locality:         'London',
+                             region:           'London',
+                             postal_code:      'WC2H 7NA',
+                             country:          'United Kingdom')
+        end
+      end
+    end
+
+    # describe 'passed non-existant api' do
+    #   let(:id) { 0 }
+    #
+    #   it 'returns hash of nils' do
+    #     _(subject).must_be_instance_of(Hash)
+    #     _(subject).must_equal(street_address:   nil,
+    #                        extended_address: nil,
+    #                        locality:         "not an address",
+    #                        region:           nil,
+    #                        postal_code:      "not an address",
+    #                        country:          "United Kingdom")
+    #   end
+    # end
+  end
+end

data/test/lib/cineworld_uk/internal/parser/api/film_test.rb

@@ -0,0 +1,160 @@
+require_relative '../../../../../test_helper'
+require_relative '../../../../../support/fixture_reader'
+
+describe CineworldUk::Internal::Parser::Api::Film do
+  include Support::FixtureReader
+
+  let(:described_class) { CineworldUk::Internal::Parser::Api::Film }
+  let(:data) { random_film }
+
+  before { WebMock.disable_net_connect! }
+  after { WebMock.allow_net_connect! }
+
+  describe '#id' do
+    subject { described_class.new(data).id }
+
+    it 'is a string' do
+      _(subject).must_be_instance_of(String)
+    end
+
+    it 'is the film id from the data' do
+      _(subject).must_equal(data['id'])
+    end
+  end
+
+  describe '#dimension' do
+    subject { described_class.new(data).dimension }
+
+    it 'is a string' do
+      _(subject).must_be_instance_of(String)
+    end
+
+    it 'is 2d or 3d' do
+      _(subject).must_match(/[23]d/)
+    end
+
+    describe 'attributeIds includes "2d"' do
+      let(:data) { random_film.merge('attributeIds' => ['2d']) }
+
+      it 'is 2d' do
+        _(subject).must_equal('2d')
+      end
+    end
+
+    describe 'attributeIds includes "3d"' do
+      let(:data) { random_film.merge('attributeIds' => ['3d']) }
+
+      it 'is 3d' do
+        _(subject).must_equal('3d')
+      end
+    end
+
+    describe 'attributeIds with imax but not 3d' do
+      let(:data) { random_film.merge('attributeIds' => ['imax', '2d']) }
+
+      it 'is 2d' do
+        _(subject).must_equal('2d')
+      end
+    end
+
+    describe 'attributeIds with imax and 3d' do
+      let(:data) { random_film.merge('attributeIds' => ['imax', '3d']) }
+
+      it 'is 3d' do
+        _(subject).must_equal('3d')
+      end
+    end
+  end
+
+  describe '#name' do
+    subject { described_class.new(data).name }
+
+    it 'is a string' do
+      _(subject).must_be_instance_of(String)
+    end
+
+    describe 'film name' do
+      let(:data) do
+        random_film.merge('name' => 'Test Film Name')
+      end
+
+      it 'is the film name' do
+        _(subject).must_equal('Test Film Name')
+      end
+    end
+
+    describe 'film name is unsanitized' do
+      let(:data) { random_film.merge('name' => 'ROH: Something') }
+
+      it 'is sanitized' do
+        _(subject).must_equal('Royal Opera House: Something')
+      end
+    end
+  end
+
+  describe '#variant' do
+    subject { described_class.new(data).variant }
+
+    it 'is a sorted array of strings' do
+      _(subject).must_be_instance_of(Array)
+      subject.each { |element| _(element).must_be_instance_of(String) }
+      _(subject.sort).must_equal(subject)
+    end
+
+    describe 'attributeIds includes "junior"' do
+      let(:data) do
+        random_film.merge('attributeIds' => ['junior'])
+      end
+
+      it 'includes "kids"' do
+        _(subject).must_include('kids')
+      end
+    end
+
+    describe 'attributeIds includes "imax"' do
+      let(:data) do
+        random_film.merge('attributeIds' => ['imax', '3d'])
+      end
+
+      it 'includes "imax"' do
+        _(subject).must_include('imax')
+      end
+    end
+
+    describe 'attributeIds includes "unlimited-screening"' do
+      let(:data) do
+        random_film.merge('attributeIds' => ['unlimited-screening'])
+      end
+
+      it 'includes "members"' do
+        _(subject).must_include('members')
+      end
+    end
+
+    describe 'attributeIds includes "qa"' do
+      let(:data) do
+        random_film.merge('attributeIds' => ['qa'])
+      end
+
+      it 'includes "q&a"' do
+        _(subject).must_include('q&a')
+      end
+    end
+
+    describe 'combination' do
+      let(:data) do
+        random_film.merge('attributeIds' => ['imax', 'unlimited-screening'])
+      end
+
+      it 'includes "members"' do
+        _(subject).must_include('imax', 'members')
+      end
+    end
+  end
+
+  private
+
+  def random_film
+    JSON.parse(performances_tomorrow_json(14))['body']['films'].sample
+  end
+end

data/test/lib/cineworld_uk/internal/parser/api/performance_test.rb

@@ -0,0 +1,62 @@
+require_relative '../../../../../test_helper'
+require_relative '../../../../../support/fixture_reader'
+
+describe CineworldUk::Internal::Parser::Api::Performance do
+  include Support::FixtureReader
+
+  let(:described_class) { CineworldUk::Internal::Parser::Api::Performance }
+  let(:data) { random_performance }
+
+  before { WebMock.disable_net_connect! }
+  after { WebMock.allow_net_connect! }
+
+  describe '#booking_url' do
+    subject { described_class.new(data).booking_url }
+
+    it 'should be a url on the cineworld website' do
+      _(subject).must_match(%r{cineworld.co.uk})
+    end
+  end
+
+  describe '#film_id' do
+    subject { described_class.new(data).film_id }
+
+    it 'should be a string' do
+      _(subject).must_be_instance_of(String)
+    end
+  end
+
+  describe '#starting_at' do
+    subject { described_class.new(data).starting_at }
+
+    it 'should be a time' do
+      _(subject).must_be_instance_of(Time)
+    end
+  end
+
+  describe '#variant' do
+    subject { described_class.new(data).variant }
+
+    describe 'has "audio-described" in attributeIds' do
+      let(:data) { random_performance.merge('attributeIds' => ['audio-described']) }
+
+      it 'includes "audio_described"' do
+        _(subject).must_include('audio_described')
+      end
+    end
+
+    describe 'has "subbed" in attributeIds' do
+      let(:data) { random_performance.merge('attributeIds' => ['subbed']) }
+
+      it 'includes "subtitled"' do
+        _(subject).must_include('subtitled')
+      end
+    end
+  end
+
+  private
+
+  def random_performance
+    JSON.parse(performances_tomorrow_json(14))['body']['events'].sample
+  end
+end

data/test/lib/cineworld_uk/internal/title_sanitizer_test.rb

@@ -0,0 +1,153 @@
+require_relative '../../../test_helper'
+
+describe CineworldUk::Internal::TitleSanitizer do
+  let(:described_class) { CineworldUk::Internal::TitleSanitizer }
+
+  describe '#sanitized' do
+    subject { described_class.new(title).sanitized }
+
+    describe 'with 2d in title' do
+      let(:title) { 'Iron Man 3 2D' }
+
+      it 'removes dimension' do
+        _(subject).must_equal('Iron Man 3')
+      end
+    end
+
+    describe 'with 3d in title' do
+      let(:title) { 'Iron Man 3 3d' }
+
+      it 'removes dimension' do
+        _(subject).must_equal('Iron Man 3')
+      end
+    end
+
+    describe 'in hindi' do
+      let(:title) { 'Bang Bang! (Hindi)' }
+
+      it 'removes language' do
+        _(subject).must_equal('Bang Bang!')
+      end
+    end
+
+    describe 'Unlimited Screening' do
+      let(:title) { 'Nightcrawler - Unlimited Screening' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Nightcrawler')
+      end
+    end
+
+    describe 'Austism screening' do
+      let(:title) { 'Autism Friendly Screening: Dolphin Tale 2' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Dolphin Tale 2')
+      end
+    end
+
+    describe 'Bolshoi screening' do
+      let(:title) { 'Bolshoi Ballet: The Legend of Love' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Bolshoi Ballet: The Legend of Love')
+      end
+    end
+
+    describe 'English National Opera screening' do
+      let(:title) { 'ENO: La Traviata ' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('English National Opera: La Traviata')
+      end
+    end
+
+    describe 'with IMAX' do
+      let(:title) { '(IMAX) Fury' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Fury')
+      end
+    end
+
+    describe 'Met Opera screening' do
+      let(:title) { 'MET Opera - Le Nozze Di Figaro' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Met Opera: Le Nozze Di Figaro')
+      end
+    end
+
+    describe 'NT Live screening' do
+      let(:title) { 'NT Live Encore: Frankenstein (starring Benedict Cumberbatch)' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('National Theatre: Frankenstein (starring Benedict Cumberbatch)')
+      end
+    end
+
+    describe 'National Theatre screening' do
+      let(:title) { 'NT Live: Treasure Island' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('National Theatre: Treasure Island')
+      end
+    end
+
+    describe 'National Theatre Encore screening' do
+      let(:title) { 'NT Live: A Streetcar Named Desire (Young Vic) - Encore' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('National Theatre: A Streetcar Named Desire (Young Vic)')
+      end
+    end
+
+    describe 'ROH screening' do
+      let(:title) { 'ROH - I Due Foscari' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Royal Opera House: I Due Foscari')
+      end
+    end
+
+    describe 'RSC screening' do
+      let(:title) { "RSC Live: Love's Labour's Lost" }
+
+      it 'removes prefix' do
+        _(subject).must_equal("Royal Shakespeare Company: Love's Labour's Lost")
+      end
+    end
+
+    describe 'SciScreen screening' do
+      let(:title) { 'SciScreen: Dallas Buyers Club' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Dallas Buyers Club')
+      end
+    end
+
+    describe 'special screening' do
+      let(:title) { 'Billy Elliot The Musical Live - Special Performance' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Billy Elliot The Musical Live')
+      end
+    end
+
+    describe 'Take 2 screening' do
+      let(:title) { 'Take 2 - Boyhood' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Boyhood')
+      end
+    end
+
+    describe 'singalong and movies for juniors' do
+      let(:title) { 'Frozen Sing-Along - Movies For Juniors' }
+
+      it 'removes prefix' do
+        _(subject).must_equal('Frozen')
+      end
+    end
+  end
+end