identisure-client 0.1.0

data/lib/identisure/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Identisure
+  VERSION = '0.1.0'
+end

data/lib/identisure/vipps.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+module Identisure
+  module Vipps
+    class AuthRequest
+      attr_reader :redirect_url, :request_ssn, :request_phone, :request_email,
+                  :request_address, :ref_id, :app_callback_uri
+
+      def initialize(redirect_url: nil, request_ssn: nil, request_phone: nil,
+                     request_email: nil, request_address: nil, ref_id: nil,
+                     app_callback_uri: nil)
+        @redirect_url = redirect_url; @request_ssn = request_ssn
+        @request_phone = request_phone; @request_email = request_email
+        @request_address = request_address; @ref_id = ref_id
+        @app_callback_uri = app_callback_uri
+      end
+
+      def to_h
+        {
+          redirectUrl: @redirect_url, requestSsn: @request_ssn,
+          requestPhone: @request_phone, requestEmail: @request_email,
+          requestAddress: @request_address, refId: @ref_id,
+          appCallbackUri: @app_callback_uri
+        }.compact
+      end
+    end
+
+    class BackchannelAuthRequest
+      attr_reader :phone, :request_ssn, :request_email, :request_address,
+                  :callback_url, :ref_id
+
+      def initialize(phone:, request_ssn: nil, request_email: nil,
+                     request_address: nil, callback_url: nil, ref_id: nil)
+        @phone = phone; @request_ssn = request_ssn
+        @request_email = request_email; @request_address = request_address
+        @callback_url = callback_url; @ref_id = ref_id
+      end
+
+      def to_h
+        {
+          phone: @phone, requestSsn: @request_ssn,
+          requestEmail: @request_email, requestAddress: @request_address,
+          callbackUrl: @callback_url, refId: @ref_id
+        }.compact
+      end
+    end
+
+    class Pending
+      attr_reader :id, :ref_id, :url
+
+      def initialize(id:, ref_id: nil, url: nil)
+        @id = id; @ref_id = ref_id; @url = url
+      end
+
+      def deconstruct_keys(_) = { id: @id, ref_id: @ref_id, url: @url }
+
+      def self.from_json(d) = new(id: d['id'], ref_id: d['refId'], url: d['url'])
+    end
+
+    class Completed
+      attr_reader :id, :ref_id, :ssn, :name, :given_name, :surname,
+                  :phone, :email, :address, :birth_date, :pid, :bank_id,
+                  :authenticated_at
+
+      def initialize(id:, ssn:, name:, given_name:, surname:, ref_id: nil,
+                     phone: nil, email: nil, address: nil, birth_date: nil,
+                     pid: nil, bank_id: nil, authenticated_at: nil)
+        @id = id; @ref_id = ref_id; @ssn = ssn; @name = name
+        @given_name = given_name; @surname = surname; @phone = phone
+        @email = email; @address = address; @birth_date = birth_date
+        @pid = pid; @bank_id = bank_id; @authenticated_at = authenticated_at
+      end
+
+      def deconstruct_keys(_)
+        { id: @id, ref_id: @ref_id, ssn: @ssn, name: @name,
+          given_name: @given_name, surname: @surname, phone: @phone,
+          email: @email, address: @address, birth_date: @birth_date,
+          pid: @pid, bank_id: @bank_id, authenticated_at: @authenticated_at }
+      end
+
+      def self.from_json(d)
+        new(
+          id: d['id'], ref_id: d['refId'], ssn: d['ssn'], name: d['name'],
+          given_name: d['givenName'], surname: d['surname'], phone: d['phone'],
+          email: d['email'], address: d['address'], birth_date: d['birthDate'],
+          pid: d['pid'], bank_id: d['bankId'],
+          authenticated_at: d['authenticatedAt']
+        )
+      end
+    end
+
+    class Failed
+      attr_reader :id, :ref_id, :error
+
+      def initialize(id:, error:, ref_id: nil)
+        @id = id; @ref_id = ref_id; @error = error
+      end
+
+      def deconstruct_keys(_) = { id: @id, ref_id: @ref_id, error: @error }
+
+      def self.from_json(d) = new(id: d['id'], ref_id: d['refId'], error: d['error'])
+    end
+
+    class Unknown
+      attr_reader :status
+
+      def initialize(status:)
+        @status = status
+      end
+
+      def deconstruct_keys(_) = { status: @status }
+    end
+
+    module Status
+      def self.from_json(d)
+        case d['status']
+        when 'PENDING'   then Pending.from_json(d)
+        when 'COMPLETED' then Completed.from_json(d)
+        when 'FAILED'    then Failed.from_json(d)
+        when String      then Unknown.new(status: d['status'])
+        else raise IdentisureError.new(0, "Invalid vipps status: #{d['status'].inspect}")
+        end
+      end
+    end
+
+    class Endpoint
+      # @api private
+      def initialize(transport)
+        @transport = transport
+      end
+
+      def auth(req)             = Status.from_json(@transport.post('/v3/vipps/auth', req.to_h))
+      def backchannel_auth(req) = Status.from_json(@transport.post('/v3/vipps/backchannel/auth', req.to_h))
+      def auth_status(id)       = Status.from_json(@transport.get("/v3/vipps/auth/#{id}"))
+      def cancel_auth(id)       = @transport.delete("/v3/vipps/auth/#{id}")
+
+      def wait_for_auth(id, opts: PollOptions.new) = poll(opts) { auth_status(id) }
+
+      private
+
+      def poll(opts)
+        deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + opts.timeout
+        loop do
+          status = yield
+          return status unless status.is_a?(Pending)
+          raise WaitError.new(timeout: true) if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
+
+          sleep opts.interval
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: identisure-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Identisure
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-10-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+description: Synchronous Ruby client for Identisure, supporting BankID SE/NO, Freja,
+  MitID, FTN, Vipps and document upload.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/identisure/age_verification.rb
+- lib/identisure/bank_id_no.rb
+- lib/identisure/bank_id_se.rb
+- lib/identisure/callback.rb
+- lib/identisure/client.rb
+- lib/identisure/document.rb
+- lib/identisure/environment.rb
+- lib/identisure/error.rb
+- lib/identisure/freja.rb
+- lib/identisure/ftn.rb
+- lib/identisure/mit_id.rb
+- lib/identisure/poll_options.rb
+- lib/identisure/transport.rb
+- lib/identisure/version.rb
+- lib/identisure/vipps.rb
+homepage: https://github.com/identisure/api-client-ruby
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby client for the Identisure REST API
+test_files: []