cineworld_uk 4.0.0 → 4.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5284f7c7c8b846edbdd724cb3c105b033da4f313eed083d6b691ae6b8714d3b8
-  data.tar.gz: 1568acd04ed0346ba388509903a17487726c088ff2d280329cfb0fe8f6023eed
+  metadata.gz: 97a79daf0c192e1c7a12ab72a96c6fae42433c44761fa7a991cfb0a2d456cf51
+  data.tar.gz: dfa8faf8c393df7b2df082d458af26a63aa8171a9a6f45fb964b040b07864baa
 SHA512:
-  metadata.gz: faff1f58b5e101ce8185a96f791a27088ed31f7c78d3eebf3f9b332b6931848604726b7e5b3d16f3bb51c1878c4693cb993863cf48dcbbe743436208e5c3186b
-  data.tar.gz: 2ab7741bafc40d66d104390340fa2e28a1a5b0a6d166f85b3526f8eb576d664b6860c5f03032fc3d71a2c21bb3ece25804d5258aeba3a7f74601027610c161d8
+  metadata.gz: 67fcdf358e0f0764b5d0b240999fcbfd1bc313a0ce9a97eb75fc5cc5d413ca7a244c74ef9f5993249fa2496bb33a8c03a3968f048c2a6a9e28a6ba444ed14bec
+  data.tar.gz: 19641348e8182a4aefdefc2674b934a08a4a1ac0ffcf109b6c678262400dd78b451845ad807ad7a4ad54a61bce461cfb9fd3e6612a1ac4a8f419427c46925647

data/.github/workflows/test.yml

@@ -15,3 +15,29 @@ jobs:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
       - run: bundle exec rake test
+
+  package:
+    strategy:
+      matrix:
+        include:
+          - runner: ubuntu-latest
+            platform: x86_64-linux-gnu
+          - runner: ubuntu-24.04-arm
+            platform: aarch64-linux-gnu
+          - runner: macos-15
+            platform: arm64-darwin
+          - runner: macos-15-intel
+            platform: x86_64-darwin
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+      - run: bundle exec rake 'package:native[${{ matrix.platform }}]'
+      - run: CINEWORLD_PACKAGE="$(echo pkg/*.gem)" bundle exec ruby test/package_test.rb
+      - uses: actions/upload-artifact@v4
+        with:
+          name: gem-${{ matrix.platform }}
+          path: pkg/*.gem

data/CHANGELOG.md

@@ -2,6 +2,32 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 4.2.0 - 2026-10-22
+
+### Added
+- `Performance#language` from Vista language attributes such as `Tamil`, `Performance#subtitled?`, and `Performance#festival`, a `Cinebase::Festival` with `name` and `year`.
+- Live API shape tests that check real responses without storing them.
+
+### Changed
+- Require cinebase 5.2. The Vista client, guest token retrieval and platform packaging task now come from `cinebase/vista`; behaviour, errors and pinned curl-impersonate digests are unchanged.
+- `CineworldUk::AuthenticationError` is now `Cinebase::Vista::AuthenticationError`, so existing `rescue` clauses keep working.
+- Film titles also use cinebase's common rules: dub and subtitle versions, more language versions, anniversaries, Q&A add-ons and festival prefixes are removed.
+- Tests use plain `Minitest::Test` classes, with hand-written fixtures in place of recorded API responses.
+
+### Fixed
+- `Sing-Along` inside a real title, such as `Bebefinn Sing-Along Movie`, is no longer removed.
+
+### Removed
+- The `fixtures` rake task, which saved API responses into the repository.
+
+## 4.1.0 - 2026-10-15
+
+### Added
+- Explicit guest token acquisition and renewal with `CineworldUk.acquire_token!`, using the standalone `curl-impersonate` CLI without Python or a browser.
+- Platform-specific gems bundle curl-impersonate 2.2.3 for x86-64/ARM64 glibc Linux and macOS, with pinned archive checksums, upstream notices, and native package CI checks. No separate executable installation is needed on these platforms.
+- Optional executable path for token acquisition. Existing caller-supplied tokens continue to work without the CLI.
+- Expiry checks and authentication errors for unavailable commands, blocked pages, and missing or invalid page tokens; failed acquisition preserves the previous token.
+
 ## 4.0.0 - 2026-10-15
 
 ### Changed

data/README.md

@@ -27,22 +27,70 @@ Performance titles are sanitized as much as possible, removing 'screening type'
 
 ### Authentication
 
-Configure a current guest JWT before retrieving data (without the `Bearer ` prefix):
+Acquire a guest JWT explicitly before retrieving data:
 
 ```ruby
 require 'cineworld_uk'
 
+CineworldUk.acquire_token!
+CineworldUk::Cinema.all
+```
+
+This shells out to **`curl-impersonate`**, not ordinary system `curl`, using its
+Chrome 150 TLS/HTTP profile. No Python, Chrome, JavaScript execution or browser
+cookies are needed. Platform-specific gem packages include the pinned
+`curl-impersonate` 2.2.3 executable and its upstream licence notices. RubyGems
+and Bundler automatically select the matching package for:
+
+- glibc Linux: x86-64 and ARM64 (`x86_64-linux-gnu`, `aarch64-linux-gnu`)
+- macOS: Intel and Apple Silicon (`x86_64-darwin`, `arm64-darwin`)
+
+The executable runs directly from the installed gem. There are no separate
+installation commands, PATH changes, or runtime downloads on these platforms.
+
+When installing from Git, forcing the source (`ruby`) gem, or using another
+platform (including Alpine/musl and Windows), install a compatible
+[curl-impersonate release](https://github.com/lexiforest/curl-impersonate/releases/tag/v2.2.3)
+with `--impersonate chrome150` support yourself. For an x86-64 Linux checkout:
+
+```sh
+mkdir -p "$HOME/.local/bin"
+curl -fL https://github.com/lexiforest/curl-impersonate/releases/download/v2.2.3/curl-impersonate-v2.2.3.x86_64-linux-gnu.tar.gz \
+  | tar -xz -C "$HOME/.local/bin" curl-impersonate
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+Other platforms have separate assets on the release page. You can also specify
+the executable path:
+
+```ruby
+CineworldUk.acquire_token!(curl: '/opt/curl-impersonate/curl-impersonate')
+```
+
+The method returns the token and sets `CineworldUk.token` in memory. It reads
+`__NEXT_DATA__.props.pageProps.environment.gasToken` from the ticketing site's
+root page, even when the page displays a 404. It checks the declared expiry,
+but decoding the JWT does not verify its signature. A blocked page, expired or
+missing token, missing executable, or failed command raises
+`CineworldUk::AuthenticationError` and leaves any previous token unchanged.
+Requests time out after 30 seconds. Certificate verification remains enabled;
+redirects are not followed, and subprocess arguments are passed without a shell.
+Cloudflare may still block requests on other networks or after website changes.
+
+Alternatively, supply your own current guest JWT without the `Bearer ` prefix;
+this requires no external executable:
+
+```ruby
 CineworldUk.token = ENV.fetch('CINEWORLD_TOKEN')
 ```
 
 The gem sends `Authorization: Bearer ...` and `Connect-Region-Code: GB` to
-`digital-api.cineworld.co.uk`. It does not acquire or refresh tokens, copy browser
-cookies, or bypass Cloudflare. The ticketing website supplies its guest token in
-`__NEXT_DATA__.props.pageProps.environment.gasToken`; access to that page may
-require an interactive browser.
+`digital-api.cineworld.co.uk`. Normal API calls never acquire or renew a token
+automatically.
 
 Missing tokens and HTTP 401 responses raise `CineworldUk::AuthenticationError`.
-Set `CineworldUk.token` again with a fresh token before retrying. Other HTTP
+Call `CineworldUk.acquire_token!` again, or set `CineworldUk.token` with a fresh
+token, before retrying. Tokens are never persisted by the gem. Other HTTP
 failures raise an error rather than returning an empty schedule. Redirects are
 not followed, so credentials are not forwarded to another host.
 
@@ -129,6 +177,15 @@ performance.dimension
 performance.variant
 #=> ['audio_described']
 
+performance.language
+#=> 'Tamil' # audio language, nil when the cinema does not tag one
+
+performance.subtitled?
+#=> true
+
+performance.festival
+#=> #<data Cinebase::Festival name="Cine-Excess", year=2026> # nil outside festivals
+
 performance.starting_at
 #=> 2026-10-14 14:40:00 UTC
 
@@ -145,6 +202,40 @@ performance.cinema_id
 #=> 14
 ```
 
+## Tests
+
+```sh
+bundle exec rake          # unit tests against fixtures
+bundle exec rake live     # live API, needs curl-impersonate or CINEWORLD_TOKEN
+```
+
+Fixtures in `test/fixtures/api` are hand-written: invented films and
+addresses in the shape of Vista responses, never recorded API output.
+`test/support/api_shapes.rb` describes the fields the gem reads. The unit suite
+checks the fixtures against it and the live suite checks real responses, held
+only in memory. When the API changes, update the shape first, then the fixtures.
+
+## Building release packages
+
+```sh
+bundle exec rake build         # Portable source gem; external curl-impersonate required
+bundle exec rake package:all   # Four platform gems with bundled executables
+```
+
+To build and check just one platform on a matching host:
+
+```sh
+bundle exec rake 'package:native[x86_64-linux-gnu]'
+CINEWORLD_PACKAGE=pkg/cineworld_uk-4.2.0-x86_64-linux-gnu.gem bundle exec ruby test/package_test.rb
+```
+
+Native packaging downloads pinned upstream archives at **build time**, verifies
+their SHA-256 digests, and includes the executable, licence files and source
+provenance. Archives and built gems stay in ignored `pkg/`, not Git. CI builds
+and installation-tests each platform on its corresponding runner and saves the
+gems as workflow artifacts; it does not publish them. Publish the source and
+platform gems together for automatic platform selection to work for users.
+
 ## Contributing
 
 1. Fork it

data/Rakefile

@@ -2,6 +2,9 @@
 require "bundler/gem_tasks"
 
 require 'rake/testtask'
+require 'cinebase/vista/package_task'
+
+Cinebase::Vista::PackageTask.new('cineworld_uk.gemspec', root: __dir__)
 
 Rake::TestTask.new do |t|
   t.libs << 'lib/cineworld_uk'
@@ -32,27 +35,4 @@ task :console do
   IRB.start
 end
 
-desc 'Recreate test fixtures'
-task :fixtures do
-  require 'cineworld_uk'
-  CineworldUk.token = ENV.fetch("CINEWORLD_TOKEN")
-
-  def js_fixture(name)
-    File.expand_path("../test/fixtures/#{name}.json", __FILE__)
-  end
-
-  api = CineworldUk::Internal::ApiResponse.new
-
-  File.open(js_fixture('api/cinema-list'), 'w') do |file|
-    puts '* API Cinema List'
-    file.write api.cinema_list
-  end
-
-  File.open(js_fixture('api/performances-tomorrow-14'), 'w') do |file|
-    puts '* API Performances in Brighton Tomorrow'
-    file.write api.performances(14, Date.today + 1)
-  end
-
-end
-
 task :default => :test

data/cineworld_uk.gemspec

@@ -17,6 +17,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
+  spec.add_development_dependency 'base64'
   spec.add_development_dependency 'bundler', '>= 2.0'
   spec.add_development_dependency 'minitest-mock'
   spec.add_development_dependency 'minitest-reporters'
@@ -24,6 +25,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'simplecov', '< 1'
   spec.add_development_dependency 'webmock'
 
-  spec.add_runtime_dependency 'cinebase', '~> 5.0'
+  spec.add_runtime_dependency 'cinebase', '~> 5.2'
   spec.add_runtime_dependency 'nokogiri', '>= 1.11'
 end

data/lib/cineworld_uk/internal/api_response.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "net/http"
 require "json"
 require "date"
 require "time"
@@ -17,6 +16,7 @@ module CineworldUk
         "Movies for Juniors" => "junior",
         "Unlimited Screening" => "unlimited-screening", "Q&A" => "qa"
       }.freeze
+      LANGUAGES = Cinebase::TitleSanitizer::LANGUAGES
 
       def cinema_list
         cinemas = fetch("sites").fetch("sites").map do |site|
@@ -53,6 +53,9 @@ module CineworldUk
               ATTRIBUTES[attribute.dig("name", "text")]
           end
           attrs << "3d" if showtime["requires3dGlasses"]
+          language = showtime.fetch("attributeIds", []).filter_map do |id|
+            attributes.fetch(id).dig("shortName", "text")
+          end.find { |name| LANGUAGES.include?(name) }
           # Formats belong to a session, not to the film as a whole.
           id = showtime.fetch("id")
           normalized_films << {
@@ -62,7 +65,7 @@ module CineworldUk
           }
           starts_at = showtime.fetch("schedule").fetch("startsAt")
           {
-            "filmId" => id, "attributeIds" => attrs,
+            "filmId" => id, "attributeIds" => attrs, "language" => language,
             "eventDateTime" => Time.iso8601(starts_at).utc.iso8601,
             "bookingLink" =>
               "https://web.cineworld.co.uk/order/showtimes/#{id}/seats"
@@ -82,34 +85,8 @@ module CineworldUk
       private
 
       def fetch(path, query = {})
-        token = CineworldUk.token
-        if !token.is_a?(String) || token.strip.empty?
-          raise AuthenticationError,
-                "Set CineworldUk.token to a current guest JWT " \
-                "before fetching data"
-        end
-        uri = URI(BASE_URL + path)
-        uri.query = URI.encode_www_form(query) unless query.empty?
-        request = Net::HTTP::Get.new(uri)
-        request["Authorization"] = "Bearer #{token}"
-        request["Connect-Region-Code"] = "GB"
-        request["Accept"] = "application/json"
-        response = Net::HTTP.start(
-          uri.host, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30
-        ) do |http|
-          http.request(request)
-        end
-        case response
-        when Net::HTTPSuccess
-          JSON.parse(response.body)
-        when Net::HTTPUnauthorized
-          raise AuthenticationError,
-                "Vista rejected the guest token; " \
-                "supply a fresh token with CineworldUk.token="
-        else
-          # Omit response bodies and never redirect credentials to another host.
-          raise "Vista HTTP error #{response.code}"
-        end
+        Cinebase::Vista::Client.new(base_url: BASE_URL, region_code: "GB",
+                                    token: CineworldUk.token).get(path, query)
       end
     end
   end

data/lib/cineworld_uk/internal/guest_token.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "json"
+require "nokogiri"
+
+module CineworldUk
+  module Internal
+    # Reads the public guest token from the ticketing site's page data
+    class GuestToken < Cinebase::Vista::GuestToken
+      PAGE_URL = "https://web.cineworld.co.uk/"
+
+      private
+
+      # The root page carries the token even when it displays a 404.
+      def accepted_statuses
+        %w[200 404]
+      end
+
+      def bundled_curl
+        File.expand_path("../../../vendor/curl-impersonate/bin/curl-impersonate", __dir__)
+      end
+
+      def extract_token(html)
+        script = Nokogiri::HTML(html).at_css("script#__NEXT_DATA__")
+        data = JSON.parse(script ? script.content : "")
+        data.dig("props", "pageProps", "environment", "gasToken")
+      end
+    end
+  end
+end

data/lib/cineworld_uk/internal/parser/api/film.rb

@@ -21,6 +21,12 @@ module CineworldUk
             @data['attributeIds']&.include?('3d') ? '3d' : '2d'
           end
 
+          # @param [Integer] year edition when the title gives none
+          # @return [Cinebase::Festival, nil]
+          def festival(year)
+            Cinebase::Festival.from_title(@data['name'] || '', year: year)
+          end
+
           # Sanitized film name
           # @return [String]
           def name

data/lib/cineworld_uk/internal/parser/api/performance.rb

@@ -21,6 +21,11 @@ module CineworldUk
             @data['filmId']
           end
 
+          # @return [String, nil] audio language, e.g. 'Tamil'
+          def language
+            @data['language']
+          end
+
           # @return [DateTime] in local time
           def starting_at
             Time.parse(@data['eventDateTime'])

data/lib/cineworld_uk/internal/title_sanitizer.rb

@@ -18,13 +18,6 @@ module CineworldUk
       # Strings and regex to be removed
       def remove
         [
-          /\s+[23]d/i,                          # dimension
-          /\(Hindi\)/i,                         # Indian Language
-          /\(Malayalam\)/i,                     # Indian Language
-          /\(Punjabi\)/i,                       # Indian Language
-          /\(Tamil\)/i,                         # Indian Language
-          /\(Cantonese\)/i,                     # Chinese
-          /\(Turkish\)/i,                       # Foreign Language
           %r(-? \d{1,2}/\d{1,2}/\d{2,4}),       # date
           /\n/,                                 # newlines
           /\- Encore/,                          # encore
@@ -38,9 +31,8 @@ module CineworldUk
           'SciScreen: ',                        # SciScreen
           /\s(-\s)*(With)*\sLive Q And A/i,     # Live Q&A
           /(\s+\-\s+)?MOVIES FOR JUNIORS/i,     # movies for juniors
-          /\bsing\-?a\-?long\b/i,               # singalong
           %r{\s20\d{2}[\/-]20\d{2} Season\b}
-        ]
+        ] + COMMON_REMOVE
       end
 
       # Regexes and their replacements
@@ -61,7 +53,7 @@ module CineworldUk
           /ROH The Royal Ballet\s*[:-] (.*)/ => 'The Royal Ballet: ',
           /Royal Ballet Live\s*[:-] (.*)/    => 'The Royal Ballet: ',
           /San Francisco Ballets (.*)/       => 'San Francisco Ballet: '
-        }
+        }.merge(COMMON_REPLACE)
       end
     end
   end

data/lib/cineworld_uk/performance.rb

@@ -71,14 +71,17 @@ module CineworldUk
       events.map do |event_data|
         performance = Internal::Parser::Api::Performance.new(event_data)
         film = films_hash[performance.film_id]
+        starting_at = utc(performance.starting_at)
 
         {
           cinema_name: response["body"]["cinemaName"] ||
             CineworldUk::Cinema.new(cinema_id).name,
           booking_url: performance.booking_url,
           dimension: film.dimension,
+          festival: film.festival(starting_at.year),
           film_name: film.name,
-          starting_at: utc(performance.starting_at),
+          language: performance.language,
+          starting_at: starting_at,
           variant: (performance.variant + film.variant).sort
         }
       end

data/lib/cineworld_uk/version.rb

@@ -1,6 +1,6 @@
 # Ruby interface for http://www.cineworld.co.uk
-# @version 4.0.0
+# @version 4.2.0
 module CineworldUk
   # Gem version
-  VERSION = "4.0.0".freeze
+  VERSION = "4.2.0".freeze
 end

data/lib/cineworld_uk.rb

@@ -1,10 +1,12 @@
 require 'json'
 
 require 'cinebase'
+require 'cinebase/vista'
 
 require_relative './cineworld_uk/version'
 
 require_relative './cineworld_uk/internal/api_response'
+require_relative './cineworld_uk/internal/guest_token'
 require_relative './cineworld_uk/internal/parser/api/cinema_address'
 require_relative './cineworld_uk/internal/parser/api/film'
 require_relative './cineworld_uk/internal/parser/api/performance'
@@ -16,10 +18,15 @@ require_relative './cineworld_uk/performance'
 
 # cineworld_uk gem
 module CineworldUk
-  class AuthenticationError < StandardError; end
+  AuthenticationError = Cinebase::Vista::AuthenticationError
 
   # A raw guest JWT, without the "Bearer " prefix. Never persisted by the gem.
   class << self
     attr_accessor :token
+
+    # Explicit acquisition/renewal; ordinary API calls never launch a subprocess.
+    def acquire_token!(curl: nil)
+      self.token = Internal::GuestToken.new(curl: curl).fetch
+    end
   end
 end

data/test/fixtures/api/showtimes-014.json

@@ -0,0 +1,67 @@
+{
+  "businessDate": "2026-10-24",
+  "showtimes": [
+    {
+      "id": "014-1001",
+      "filmId": "FILM-1",
+      "schedule": { "startsAt": "2026-10-24T09:00:00+01:00" },
+      "attributeIds": ["A-2D", "A-AD"],
+      "requires3dGlasses": false
+    },
+    {
+      "id": "014-1002",
+      "filmId": "FILM-1",
+      "schedule": { "startsAt": "2026-10-24T14:30:00+01:00" },
+      "attributeIds": ["A-IMAX"],
+      "requires3dGlasses": true
+    },
+    {
+      "id": "014-1003",
+      "filmId": "FILM-2",
+      "schedule": { "startsAt": "2026-10-24T18:00:00+01:00" },
+      "attributeIds": ["A-TAMIL", "A-ST"],
+      "requires3dGlasses": false
+    },
+    {
+      "id": "014-1004",
+      "filmId": "FILM-3",
+      "schedule": { "startsAt": "2026-10-24T10:00:00+01:00" },
+      "attributeIds": ["A-M4J"],
+      "requires3dGlasses": false
+    },
+    {
+      "id": "014-1005",
+      "filmId": "FILM-4",
+      "schedule": { "startsAt": "2026-10-24T20:15:00+01:00" },
+      "attributeIds": ["A-AC"],
+      "requires3dGlasses": false
+    },
+    {
+      "id": "014-1006",
+      "filmId": "FILM-1",
+      "schedule": { "startsAt": "2026-10-25T00:15:00+01:00" },
+      "attributeIds": [],
+      "requires3dGlasses": false
+    }
+  ],
+  "relatedData": {
+    "films": [
+      { "id": "FILM-1", "title": { "text": "The Example Film" } },
+      { "id": "FILM-2", "title": { "text": "Imaginary Picture (Tamil)" } },
+      { "id": "FILM-3", "title": { "text": "Pretend Pups - Movies For Juniors" } },
+      { "id": "FILM-4", "title": { "text": "Cine-Excess 2026: Scum Of The Earth" } }
+    ],
+    "attributes": [
+      { "id": "A-2D", "shortName": { "text": "2D" }, "name": { "text": "2D Film" } },
+      { "id": "A-AD", "shortName": { "text": "AD" }, "name": { "text": "Audio Described" } },
+      { "id": "A-IMAX", "shortName": { "text": "IMAX" }, "name": { "text": "IMAX Film" } },
+      { "id": "A-TAMIL", "shortName": { "text": "Tamil" }, "name": { "text": "Tamil" } },
+      { "id": "A-ST", "shortName": { "text": "ST" }, "name": { "text": "Subtitled" } },
+      { "id": "A-M4J", "shortName": { "text": "M4J" }, "name": { "text": "Movies for Juniors" } },
+      { "id": "A-AC", "shortName": { "text": "AC" }, "name": { "text": "Event Cinema" } }
+    ],
+    "sites": [
+      { "id": "014", "name": { "text": "Brighton" } }
+    ]
+  }
+}

data/test/fixtures/api/sites.json

@@ -0,0 +1,52 @@
+{
+  "sites": [
+    {
+      "id": "014",
+      "name": { "text": "Brighton" },
+      "contactDetails": {
+        "addressV2": {
+          "line1": { "text": "1 Example Marina" },
+          "line2": { "text": "Brighton" },
+          "line3": { "text": "East Sussex" },
+          "line4": { "text": "BN2 0ZZ" }
+        }
+      }
+    },
+    {
+      "id": "088",
+      "name": { "text": "Glasgow Silverburn" },
+      "contactDetails": {
+        "addressV2": {
+          "line1": { "text": "2 Example Centre" },
+          "line2": { "text": "Glasgow" },
+          "line3": { "text": "Lanarkshire" },
+          "line4": { "text": "G53 0ZZ" }
+        }
+      }
+    },
+    {
+      "id": "103",
+      "name": { "text": "Leicester Square" },
+      "contactDetails": {
+        "addressV2": {
+          "line1": { "text": "3 Example Square" },
+          "line2": { "text": "London" },
+          "line3": null,
+          "line4": { "text": "WC2H 0ZZ" }
+        }
+      }
+    },
+    {
+      "id": "999",
+      "name": { "text": "Example - Riverside" },
+      "contactDetails": {
+        "addressV2": {
+          "line1": { "text": "4 Example Quay" },
+          "line2": { "text": "Exampleton" },
+          "line3": null,
+          "line4": { "text": "EX1 0ZZ" }
+        }
+      }
+    }
+  ]
+}