cvrvaelger 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4c8df3ad4e794628d2f3e5a0010b9a9aa4e35123a64370926196639cb119eb6
-  data.tar.gz: 7395f85cc2c4bb3cf458b80d61da01602af672b893f2317e900e833257a64601
+  metadata.gz: 452cfeb8f40727f88b1e30b0fb8a7269e17b8866d2778f1b2330f948d8665e1e
+  data.tar.gz: 4e5b72d751fa0553096b8a90187b453141af5730ef1ab7f8b71f5194614fcb14
 SHA512:
-  metadata.gz: 3623ddc0be170cf6cdbed892a4ea9d18dee2958687945e23982b5271a19e45eb5c33e3c095c3e249177ae442d9c31b103e3f6739f4501b15532efd681c379c96
-  data.tar.gz: c622efb3b0d2001065bc756baf0b1bc9be9b746a67875e553b7aa40b4006c682c02f555204095587c241ac7c2f13628ea47442af83f19c4a6150e713db1c85cd
+  metadata.gz: b838022a39993b3ffa491c1eb70ed82ab6cd3a4ca7c7e4e251b80873b4ef0f6fded509c86646a9af690f9e8714b5c06dc86d35bc29479eb9b37ef780648d79e0
+  data.tar.gz: 8f96d799f99c67083ef103df5591e1a12308cafb0d7cfbd698502e9e21bfadfc1e29f6a0dc7a2ccfeac8eb6f9c074792a76b2cc33672e0e6c89edbf18bc90379

data/.env.example

@@ -5,3 +5,5 @@ CVRVAELGER_API_KEY=
 # DATAFORDELER_API_KEY=
 # Optional endpoint override (default https://graphql.datafordeler.dk/CVR/v2):
 # CVRVAELGER_BASE_URL=
+# Optional Fildownload host (default https://api.datafordeler.dk):
+# CVRVAELGER_FILE_DOWNLOAD_BASE_URL=

data/.rubocop.yml

@@ -26,7 +26,7 @@ Metrics/MethodLength:
     - "test/**/*"
 
 Metrics/ClassLength:
-  Max: 200
+  Max: 300
   Exclude:
     - "test/**/*"
 
@@ -52,4 +52,4 @@ Metrics/BlockLength:
     - "Rakefile"
 
 Minitest/MultipleAssertions:
-  Max: 10
+  Max: 12

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## Unreleased
+
+## 0.2.1
+
+- Treat `Errno::ECONNRESET` as `ProviderError` ("unreachable") alongside
+  open/read timeouts and connection refused — Datafordeler TLS resets during
+  GraphQL and file download no longer bubble as raw syscall errors.
+
+## 0.2.0
+
+- Fildownload client: `available_file_downloads`, `download_file`, `download_latest`
+  for CVR totalextract zips.
+- CVR_Events pull/poll: `events` (cursor via `since_event_id` / `after`),
+  `virksomhed_by_row_id` / `navn_by_row_id` / `adressering_by_row_id`, and
+  `register_import_status` for incremental sync after a TotalDownload baseline.
+
 ## 0.1.0
 
 - Initial public release: Datafordeler CVR GraphQL v2 client (`lookup` / `search`).

data/README.md

@@ -1,10 +1,13 @@
 # Cvrvaelger
 
 Ruby client for **Det Centrale Virksomhedsregister (CVR)** via
-[Datafordeler GraphQL](https://datafordeler.dk/dataoversigt/det-centrale-virksomhedsregister-cvr/cvr-graphql/).
+[Datafordeler GraphQL](https://datafordeler.dk/dataoversigt/det-centrale-virksomhedsregister-cvr/cvr-graphql/)
+and [Fildownload](https://datafordeler.dk/dataoversigt/det-centrale-virksomhedsregister-cvr/cvr-fildownload/).
 
 Denmark only — look up an 8-digit CVR or registered company name and return
-picker-shaped fields (name, light address, status).
+picker-shaped fields (name, light address, status). Also supports Datafordeler
+CVR Fildownload (list/download totalextract zips) and `CVR_Events` pull/poll for
+incremental sync.
 
 ## Install
 
@@ -44,8 +47,35 @@ client.search("lego") # => []
 
 # Optional bitemporal cut-off (GraphQL `virkningstid`, default: now)
 client.lookup("47458714", at: Time.utc(2020, 1, 1))
+
+# Fildownload: list metadata and stream a zip to disk
+files = client.available_file_downloads(entity: "Navn", type_of_data: "Current", format: "json")
+client.download_latest(entity: "Virksomhed", type: "current", format: "json", to: "tmp/virksomhed.zip")
+client.download_file(files.first.file_name, to: "tmp/navn.zip")
+
+# Incremental sync after a TotalDownload baseline (persist last event_id yourself).
+# See Datafordeler transitions guide for entitetsbaserede hændelser.
+status = client.register_import_status
+page = client.events(since_event_id: last_id, first: 100)
+page.events.each do |event|
+  # from_failed_import marks duplicate catch-up events — handle in the host app.
+  next if event.event_action == "d" # delete local row for event.object_datafordeler_row_id
+
+  case event.entity_name
+  when "Virksomhed"
+    client.virksomhed_by_row_id(event.object_datafordeler_row_id) # => Hash or nil
+  when "Navn"
+    client.navn_by_row_id(event.object_datafordeler_row_id)
+  when "Adressering"
+    client.adressering_by_row_id(event.object_datafordeler_row_id)
+  # other entities: query GraphQL yourself
+  end
+end
+page = client.events(since_event_id: last_id, first: 100, after: page.end_cursor) if page.has_next_page
 ```
 
+SSE / GraphQL subscriptions are not wrapped here; poll with `events` instead.
+
 Environment variables:
 
 | Variable | Purpose |
@@ -53,6 +83,7 @@ Environment variables:
 | `CVRVAELGER_API_KEY` | Datafordeler API key (preferred) |
 | `DATAFORDELER_API_KEY` | Accepted alias |
 | `CVRVAELGER_BASE_URL` | Override GraphQL endpoint (default `https://graphql.datafordeler.dk/CVR/v2`) |
+| `CVRVAELGER_FILE_DOWNLOAD_BASE_URL` | Override Fildownload host (default `https://api.datafordeler.dk`) |
 
 ## API key
 
@@ -75,6 +106,8 @@ To refresh cassettes locally:
 ```sh
 VCR_RECORD=all bundle exec rake test TEST=test/client_live_test.rb
 VCR_RECORD=all bundle exec rake test TEST=test/graphql_features_test.rb
+VCR_RECORD=all bundle exec rake test TEST=test/file_download_live_test.rb
+VCR_RECORD=all bundle exec rake test TEST=test/client_events_live_test.rb
 ```
 
 Never hand-write cassette response bodies.

data/cvrvaelger.gemspec

@@ -10,9 +10,9 @@ Gem::Specification.new do |spec|
 
   spec.summary = "Ruby client for Danish CVR company lookup via Datafordeler GraphQL."
   spec.description = <<~DESC
-    HTTP client for Det Centrale Virksomhedsregister (CVR) on Datafordeler GraphQL:
-    verify an 8-digit CVR number or exact registered name and return the company
-    name plus light address fields for picker UX. No Rails dependency.
+    HTTP client for Det Centrale Virksomhedsregister (CVR) on Datafordeler:
+    GraphQL lookup/search for picker UX, Fildownload helpers for totalextract
+    zips, and CVR_Events pull/poll for incremental sync. No Rails dependency.
   DESC
   spec.homepage = "https://github.com/bergholdt/cvrvaelger"
   spec.license = "MIT"

data/lib/cvrvaelger/client.rb

@@ -5,15 +5,24 @@ require "json"
 require "uri"
 
 require_relative "company"
+require_relative "file_download"
+require_relative "event"
+require_relative "client_events"
 
 module Cvrvaelger
-  # HTTP client for Det Centrale Virksomhedsregister via Datafordeler GraphQL.
+  # HTTP client for Det Centrale Virksomhedsregister via Datafordeler GraphQL
+  # and Fildownload.
   #
-  # Official endpoint: https://graphql.datafordeler.dk/CVR/v2
+  # GraphQL: https://graphql.datafordeler.dk/CVR/v2
+  # Files:   https://api.datafordeler.dk/FileDownloads/...
   # Auth: free API key from Datafordeler Administration (query param `apiKey`).
   # No demo/default secret — configure CVRVAELGER_API_KEY or pass api_key:.
+  #
   class Client
+    include ClientEvents
+
     DEFAULT_BASE_URL = "https://graphql.datafordeler.dk/CVR/v2"
+    DEFAULT_FILE_DOWNLOAD_BASE_URL = "https://api.datafordeler.dk"
 
     # Datafordeler allows one root field per query. Name match is exact (`eq`);
     # there is no contains/fuzzy operator. `virkningstid` selects the bitemporal row.
@@ -63,12 +72,15 @@ module Cvrvaelger
       }
     GRAPHQL
 
-    attr_reader :base_url, :api_key
+    attr_reader :base_url, :file_download_base_url, :api_key
 
-    def initialize(api_key: nil, base_url: nil, http: nil)
+    def initialize(api_key: nil, base_url: nil, file_download_base_url: nil, http: nil)
       @api_key = present_string(api_key) || present_string(ENV.fetch("CVRVAELGER_API_KEY", nil)) ||
                  present_string(ENV.fetch("DATAFORDELER_API_KEY", nil))
       @base_url = present_string(base_url) || present_string(ENV.fetch("CVRVAELGER_BASE_URL", nil)) || DEFAULT_BASE_URL
+      @file_download_base_url = present_string(file_download_base_url) ||
+                                present_string(ENV.fetch("CVRVAELGER_FILE_DOWNLOAD_BASE_URL", nil)) ||
+                                DEFAULT_FILE_DOWNLOAD_BASE_URL
       @http = http
     end
 
@@ -106,6 +118,51 @@ module Cvrvaelger
       end
     end
 
+    # List available CVR totaldownload zips (metadata only).
+    # Optional filters: entity ("Navn"), type_of_data ("Current"), format ("json").
+    def available_file_downloads(entity: nil, type_of_data: nil, format: nil)
+      ensure_api_key!
+      payload = get_json("/FileDownloads/GetAvailableFileDownloads", Register: "CVR")
+      rows = Array(payload["availableFileDownloads"])
+      rows.filter_map do |row|
+        next unless row.is_a?(Hash)
+
+        file = FileDownload.from_node(row)
+        next if entity && !entity.to_s.casecmp?(file.entity_name.to_s)
+        next if type_of_data && !type_of_data.to_s.casecmp?(file.type_of_data.to_s)
+        next if format && !format.to_s.casecmp?(file.contained_file_format.to_s)
+
+        file
+      end
+    end
+
+    # Download a named zip to `to` (filesystem path). Returns the path.
+    def download_file(file_name, to:)
+      ensure_api_key!
+      raise ArgumentError, "to: path is required" if blank?(to)
+      raise ArgumentError, "file_name is required" if blank?(file_name)
+
+      get_file({ Filename: file_name.to_s }, to: to.to_s)
+    end
+
+    # Download the latest totaldownload for an entity (e.g. Navn / Virksomhed).
+    # `type` is Current/Temporal/Bitemporal; `format` is json/csv.
+    def download_latest(entity:, to:, type: "current", format: "json")
+      ensure_api_key!
+      raise ArgumentError, "entity is required" if blank?(entity)
+      raise ArgumentError, "to: path is required" if blank?(to)
+
+      get_file(
+        {
+          Register: "CVR",
+          LatestTotalForEntity: entity.to_s,
+          type: type.to_s.downcase,
+          format: format.to_s.upcase
+        },
+        to: to.to_s
+      )
+    end
+
     private
 
     attr_reader :http
@@ -180,10 +237,7 @@ module Cvrvaelger
     end
 
     def post_graphql(query, **variables)
-      uri = URI(base_url)
-      query_params = URI.decode_www_form(uri.query.to_s).to_h
-      query_params["apiKey"] = api_key
-      uri.query = URI.encode_www_form(query_params)
+      uri = with_api_key(URI(base_url))
 
       body = JSON.generate(query: query, variables: variables)
       request = Net::HTTP::Post.new(uri)
@@ -209,6 +263,59 @@ module Cvrvaelger
       payload
     end
 
+    def get_json(path, **params)
+      uri = with_api_key(URI.join("#{file_download_base_url}/", path.delete_prefix("/")), **params)
+      request = Net::HTTP::Get.new(uri)
+      request["Accept"] = "application/json"
+      request["User-Agent"] = "Cvrvaelger/#{VERSION}"
+
+      response = perform(uri, request)
+      raise ProviderError, "Datafordeler CVR error (#{response.code})" unless response.is_a?(Net::HTTPSuccess)
+
+      begin
+        JSON.parse(response.body)
+      rescue JSON::ParserError
+        raise ProviderError, "Datafordeler CVR returned invalid JSON"
+      end
+    end
+
+    def get_file(params, to:)
+      uri = with_api_key(URI.join("#{file_download_base_url}/", "FileDownloads/GetFile"), **params)
+      request = Net::HTTP::Get.new(uri)
+      request["Accept"] = "application/zip, application/octet-stream, */*"
+      request["User-Agent"] = "Cvrvaelger/#{VERSION}"
+
+      if http
+        response = http.call(uri, request)
+        raise ProviderError, "Datafordeler CVR error (#{response.code})" unless response.is_a?(Net::HTTPSuccess)
+
+        File.binwrite(to, response.body)
+        return to
+      end
+
+      File.open(to, "wb") do |io|
+        Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https", open_timeout: 10,
+                                            read_timeout: 600) do |client|
+          client.request(request) do |response|
+            raise ProviderError, "Datafordeler CVR error (#{response.code})" unless response.is_a?(Net::HTTPSuccess)
+
+            response.read_body { |chunk| io.write(chunk) }
+          end
+        end
+      end
+      to
+    rescue Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNREFUSED, Errno::ECONNRESET, SocketError => e
+      raise ProviderError, "Datafordeler CVR unreachable (#{e.class})"
+    end
+
+    def with_api_key(uri, **params)
+      query_params = URI.decode_www_form(uri.query.to_s).to_h
+      params.each { |key, value| query_params[key.to_s] = value unless value.nil? }
+      query_params["apiKey"] = api_key
+      uri.query = URI.encode_www_form(query_params)
+      uri
+    end
+
     def perform(uri, request)
       return http.call(uri, request) if http
 
@@ -216,7 +323,7 @@ module Cvrvaelger
                                           read_timeout: 30) do |client|
         client.request(request)
       end
-    rescue Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNREFUSED, SocketError => e
+    rescue Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNREFUSED, Errno::ECONNRESET, SocketError => e
       raise ProviderError, "Datafordeler CVR unreachable (#{e.class})"
     end
 

data/lib/cvrvaelger/client_events.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Cvrvaelger
+  # Pull/poll helpers for CVR_Events and row-id entity fetch (incremental sync).
+  module ClientEvents
+    EVENT_NODE_FIELDS = <<~GRAPHQL
+      eventid
+      entityname
+      eventaction
+      fromfailedimport
+      object_id
+      object_datafordelerRowId
+      datafordelerOpdateringstid
+      datafordelerRegisterImportSequenceNumber
+    GRAPHQL
+
+    EVENTS_QUERY = <<~GRAPHQL.freeze
+      query Events($first: Int!, $after: String) {
+        CVR_Events(first: $first, after: $after) {
+          pageInfo { hasNextPage endCursor }
+          nodes {
+            #{EVENT_NODE_FIELDS}
+          }
+        }
+      }
+    GRAPHQL
+
+    EVENTS_SINCE_QUERY = <<~GRAPHQL.freeze
+      query EventsSince($first: Int!, $after: String, $where: CVR_EventsFilterInput) {
+        CVR_Events(first: $first, after: $after, where: $where) {
+          pageInfo { hasNextPage endCursor }
+          nodes {
+            #{EVENT_NODE_FIELDS}
+          }
+        }
+      }
+    GRAPHQL
+
+    VIRKSOMHED_BY_ROW_ID_QUERY = <<~GRAPHQL
+      query VirksomhedByRowId($rowId: UUID!, $at: DafDateTime!) {
+        CVR_Virksomhed(first: 1, virkningstid: $at, where: { datafordelerRowId: { eq: $rowId } }) {
+          nodes { id CVRNummer status datafordelerRowId }
+        }
+      }
+    GRAPHQL
+
+    NAVN_BY_ROW_ID_QUERY = <<~GRAPHQL
+      query NavnByRowId($rowId: UUID!, $at: DafDateTime!) {
+        CVR_Navn(first: 1, virkningstid: $at, where: { datafordelerRowId: { eq: $rowId } }) {
+          nodes { CVREnhedsId vaerdi datafordelerRowId }
+        }
+      }
+    GRAPHQL
+
+    ADRESSERING_BY_ROW_ID_QUERY = <<~GRAPHQL
+      query AdresseringByRowId($rowId: UUID!, $at: DafDateTime!) {
+        CVR_Adressering(first: 1, virkningstid: $at, where: { datafordelerRowId: { eq: $rowId } }) {
+          nodes {
+            CVREnhedsId
+            AdresseringAnvendelse
+            CVRAdresse_vejnavn
+            CVRAdresse_husnummerFra
+            CVRAdresse_postnummer
+            CVRAdresse_postdistrikt
+            datafordelerRowId
+          }
+        }
+      }
+    GRAPHQL
+
+    REGISTER_IMPORT_STATUS_QUERY = <<~GRAPHQL
+      query RegisterImportStatus {
+        DAF_RegisterImportStatus { lastEventId lastSequenceNumber lastUpdated }
+      }
+    GRAPHQL
+
+    # Page CVR_Events since a durable cursor (`eventid`).
+    # `since_event_id:` uses `gt` (exclusive); `inclusive: true` uses `gte`.
+    def events(since_event_id: nil, first: 100, after: nil, inclusive: false)
+      ensure_api_key!
+      variables = { first: first.to_i, after: after }
+      if since_event_id
+        op = inclusive ? "gte" : "gt"
+        variables[:where] = { "eventid" => { op => since_event_id.to_i } }
+        payload = post_graphql(EVENTS_SINCE_QUERY, **variables)
+      else
+        payload = post_graphql(EVENTS_QUERY, **variables)
+      end
+
+      EventPage.from_connection(payload.dig("data", "CVR_Events"))
+    end
+
+    # Fetch a Virksomhed GraphQL node by datafordelerRowId, or nil.
+    def virksomhed_by_row_id(row_id, at: Time.now)
+      entity_by_row_id(VIRKSOMHED_BY_ROW_ID_QUERY, row_id, at: at)
+    end
+
+    # Fetch a Navn GraphQL node by datafordelerRowId, or nil.
+    def navn_by_row_id(row_id, at: Time.now)
+      entity_by_row_id(NAVN_BY_ROW_ID_QUERY, row_id, at: at)
+    end
+
+    # Fetch an Adressering GraphQL node by datafordelerRowId, or nil.
+    def adressering_by_row_id(row_id, at: Time.now)
+      entity_by_row_id(ADRESSERING_BY_ROW_ID_QUERY, row_id, at: at)
+    end
+
+    # Latest import watermark from Datafordeler (bootstrap / catch-up).
+    def register_import_status
+      ensure_api_key!
+      payload = post_graphql(REGISTER_IMPORT_STATUS_QUERY)
+      status = payload.dig("data", "DAF_RegisterImportStatus")
+      status.is_a?(Hash) ? status : {}
+    end
+
+    private
+
+    def entity_by_row_id(query, row_id, at:)
+      ensure_api_key!
+      raise ArgumentError, "row_id is required" if blank?(row_id)
+
+      payload = post_graphql(query, rowId: row_id.to_s, at: format_time(at))
+      node = first_node(payload)
+      node.is_a?(Hash) ? node : nil
+    end
+  end
+end

data/lib/cvrvaelger/event.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Cvrvaelger
+  # One CVR_Events row from Datafordeler GraphQL (pull/poll sync cursor).
+  Event = Data.define(
+    :event_id,
+    :entity_name,
+    :event_action,
+    :from_failed_import,
+    :object_entity_id,
+    :object_datafordeler_row_id,
+    :datafordeler_opdateringstid,
+    :datafordeler_register_import_sequence_number
+  ) do
+    def self.from_node(node)
+      new(
+        event_id: node["eventid"],
+        entity_name: present_string(node["entityname"]),
+        event_action: present_string(node["eventaction"]),
+        from_failed_import: node["fromfailedimport"],
+        # GraphQL field object_id — not Ruby Object#object_id.
+        object_entity_id: present_string(node["object_id"]),
+        object_datafordeler_row_id: present_string(node["object_datafordelerRowId"]),
+        datafordeler_opdateringstid: present_string(node["datafordelerOpdateringstid"]),
+        datafordeler_register_import_sequence_number: node["datafordelerRegisterImportSequenceNumber"]
+      )
+    end
+
+    def self.present_string(value)
+      return nil if value.nil?
+
+      string = value.to_s.strip
+      string.empty? ? nil : string
+    end
+
+    private_class_method :present_string
+  end
+
+  # One page of CVR_Events plus GraphQL connection cursors.
+  EventPage = Data.define(:events, :has_next_page, :end_cursor) do
+    def self.from_connection(connection)
+      connection = {} unless connection.is_a?(Hash)
+      page_info = connection["pageInfo"]
+      page_info = {} unless page_info.is_a?(Hash)
+
+      new(
+        events: Array(connection["nodes"]).grep(Hash).map { |node| Event.from_node(node) },
+        has_next_page: page_info["hasNextPage"] == true,
+        end_cursor: present_string(page_info["endCursor"])
+      )
+    end
+
+    def self.present_string(value)
+      return nil if value.nil?
+
+      string = value.to_s.strip
+      string.empty? ? nil : string
+    end
+
+    private_class_method :present_string
+  end
+end

data/lib/cvrvaelger/file_download.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Cvrvaelger
+  # Metadata for a Datafordeler CVR totaldownload zip (no local unzipping).
+  FileDownload = Data.define(
+    :file_name,
+    :register,
+    :entity_name,
+    :type_of_download,
+    :type_of_data,
+    :contained_file_format,
+    :output_file_format,
+    :generation_number,
+    :file_size_in_bytes,
+    :md5_hash,
+    :generation_time,
+    :expiration_date
+  ) do
+    def self.from_node(node)
+      new(
+        file_name: present_string(node["fileName"]),
+        register: present_string(node["register"]),
+        entity_name: present_string(node["entityName"]),
+        type_of_download: present_string(node["typeOfDownload"]),
+        type_of_data: present_string(node["typeOfData"]),
+        contained_file_format: present_string(node["containedFileFormat"]),
+        output_file_format: present_string(node["outputFileFormat"]),
+        generation_number: node["generationNumber"],
+        file_size_in_bytes: node["fileSizeInBytes"],
+        md5_hash: present_string(node["md5Hash"]),
+        generation_time: present_string(node["generationTime"]),
+        expiration_date: present_string(node["expirationDate"])
+      )
+    end
+
+    def self.present_string(value)
+      return nil if value.nil?
+
+      string = value.to_s.strip
+      string.empty? ? nil : string
+    end
+
+    private_class_method :present_string
+  end
+end

data/lib/cvrvaelger/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cvrvaelger
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

data/lib/cvrvaelger.rb

@@ -3,9 +3,12 @@
 require_relative "cvrvaelger/version"
 require_relative "cvrvaelger/error"
 require_relative "cvrvaelger/company"
+require_relative "cvrvaelger/file_download"
+require_relative "cvrvaelger/event"
 require_relative "cvrvaelger/client"
 
-# Ruby client for Det Centrale Virksomhedsregister (CVR) via Datafordeler GraphQL.
+# Ruby client for Det Centrale Virksomhedsregister (CVR) via Datafordeler
+# GraphQL and Fildownload.
 #
 # Denmark only. Rails controllers, Stimulus pickers, and persistence belong in the
 # host application (same split as adressevaelger).

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cvrvaelger
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Rasmus Bergholdt
@@ -10,9 +10,9 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: |
-  HTTP client for Det Centrale Virksomhedsregister (CVR) on Datafordeler GraphQL:
-  verify an 8-digit CVR number or exact registered name and return the company
-  name plus light address fields for picker UX. No Rails dependency.
+  HTTP client for Det Centrale Virksomhedsregister (CVR) on Datafordeler:
+  GraphQL lookup/search for picker UX, Fildownload helpers for totalextract
+  zips, and CVR_Events pull/poll for incremental sync. No Rails dependency.
 email:
 - rasmus.bergholdt@gmail.com
 executables: []
@@ -27,16 +27,19 @@ files:
 - cvrvaelger.gemspec
 - lib/cvrvaelger.rb
 - lib/cvrvaelger/client.rb
+- lib/cvrvaelger/client_events.rb
 - lib/cvrvaelger/company.rb
 - lib/cvrvaelger/error.rb
+- lib/cvrvaelger/event.rb
+- lib/cvrvaelger/file_download.rb
 - lib/cvrvaelger/version.rb
 homepage: https://github.com/bergholdt/cvrvaelger
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/bergholdt/cvrvaelger
-  source_code_uri: https://github.com/bergholdt/cvrvaelger/tree/v0.1.0
-  changelog_uri: https://github.com/bergholdt/cvrvaelger/blob/v0.1.0/CHANGELOG.md
+  source_code_uri: https://github.com/bergholdt/cvrvaelger/tree/v0.2.1
+  changelog_uri: https://github.com/bergholdt/cvrvaelger/blob/v0.2.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/bergholdt/cvrvaelger/issues
   rubygems_mfa_required: 'true'
 rdoc_options: []