passageidentity 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b98a47138ae131d490133febfdfb84b901e3c204dab4dc77a89b58e7dddc2cb
-  data.tar.gz: a8727e11cfedcbc82b36bfc4c2983ec48d7f0932edb8235325727482a32f7190
+  metadata.gz: 10dbb3b156d4428c588e7aae5bb1d10f0430c5d7275417ac76b825207a51ea3f
+  data.tar.gz: 9b11bbdc0e13d5369829cf74b51e73e8d220587b19b45e18f454c7e69837cff9
 SHA512:
-  metadata.gz: 23e4ca4713b66cc334b2fe31a24e0d7b010eea080afbfb783ea4aeee5e62e74c309a422fb35ec95ed6f532c93dc596d1472c77cf599f4d26d763df80090ba29d
-  data.tar.gz: bb1e666a5a6baf4ffabfdfd9165e7a679f8174ad312fd6e050b9367b1538ce9b5d4359b56df930ad181865af7198c23d15a6fb76423eade0ec0169d95ce96227
+  metadata.gz: 9a7ef97b70cc9da490c8d8e00c3befb8d222ec101819e9277be0b53da30181904eda00f1e9c73c4368d6cd5447a8c42918c919d9078cfd70a3933cfe7959969d
+  data.tar.gz: b38620497b8b0adbf2c8fc8409cfeab86694721dde532e05b34246d4c1050774d0d038ecd661fd1aacfa65890ad5b3839224be59359b47e627eb1f9c14b507b3

data/lib/passageidentity/auth.rb

@@ -19,8 +19,11 @@ module Passage
         response = @connection.get("/v1/apps/#{@app_id}")
         return response.body["app"]
       rescue Faraday::Error => e
-        raise PassageError,
-              "failed to get Passage App. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+        raise PassageError.new(
+                message: "failed to fetch passage app",
+                status_code: e.response[:status],
+                body: e.response[:body]
+              )
       end
     end
 
@@ -52,14 +55,16 @@ module Passage
       # Get the token based on the strategy
       if @auth_strategy === Passage::COOKIE_STRATEGY
         unless request.cookies["psg_auth_token"].present?
-          raise PassageError,
-                `missing authentication token: expected "psg_auth_token" cookie`
+          raise PassageError.new(
+                  message:
+                    `missing authentication token: expected "psg_auth_token" cookie`
+                )
         end
         @token = request.cookies["psg_auth_token"]
       else
         headers = request.headers
         unless headers["Authorization"].present?
-          raise PassageError, "no authentication token in header"
+          raise PassageError.new(message: "no authentication token in header")
         end
         @token = headers["Authorization"].split(" ").last
       end
@@ -68,7 +73,7 @@ module Passage
       if @token
         return authenticate_token(@token)
       else
-        raise PassageError, "no authentication token"
+        raise PassageError.new(message: "no authentication token")
       end
       nil
     end
@@ -98,15 +103,15 @@ module Passage
           )
         return claims[0]["sub"]
       rescue JWT::InvalidIssuerError => e
-        raise Passage::PassageError, e.message
+        raise PassageError.new(message: e.message)
       rescue JWT::InvalidAudError => e
-        raise Passage::PassageError, e.message
+        raise PassageError.new(e.message)
       rescue JWT::ExpiredSignature => e
-        raise Passage::PassageError, e.message
+        raise PassageError.new(e.message)
       rescue JWT::IncorrectAlgorithm => e
-        raise Passage::PassageError, e.message
+        raise PassageError.new(e.message)
       rescue JWT::DecodeError => e
-        raise Passage::PassageError, e.message
+        raise PassageError.new(e.message)
       end
     end
   end

data/lib/passageidentity/client.rb

@@ -20,6 +20,7 @@ module Passage
                :refresh_inactivity_lifetime,
                :user_metadata_schema,
                :layouts,
+               :default_language,
                keyword_init: true
   User =
     Struct.new :id,
@@ -76,7 +77,7 @@ module Passage
 
       # check for valid auth strategy
       unless [COOKIE_STRATEGY, HEADER_STRATEGY].include? auth_strategy
-        raise PassageError, "invalid auth strategy."
+        raise PassageError.new(message: "invalid auth strategy.")
       end
       @auth_strategy = auth_strategy
 
@@ -137,7 +138,8 @@ module Passage
             refresh_inactivity_lifetime:
               app_info["refresh_inactivity_lifetime"],
             user_metadata_schema: app_info["user_metadata_schema"],
-            layouts: app_info["layouts"]
+            layouts: app_info["layouts"],
+            default_language: app_info["default_language"]
           )
         )
       rescue => e
@@ -153,6 +155,7 @@ module Passage
       send: false,
       magic_link_path: "",
       redirect_url: "",
+      language: "",
       ttl: 60
     )
       magic_link_req = {}
@@ -162,8 +165,10 @@ module Passage
 
       # check to see if the channel specified is valid before sending it off to the server
       unless [PHONE_CHANNEL, EMAIL_CHANNEL].include? channel
-        raise PassageError,
-              "channel: must be either Passage::EMAIL_CHANNEL or Passage::PHONE_CHANNEL"
+        raise PassageError.new(
+                message:
+                  "channel: must be either Passage::EMAIL_CHANNEL or Passage::PHONE_CHANNEL"
+              )
       end
       magic_link_req["channel"] = channel unless channel.empty?
       magic_link_req["send"] = send
@@ -192,8 +197,11 @@ module Passage
           )
         )
       rescue Faraday::Error => e
-        raise PassageError,
-              "failed to create Passage Magic Link. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+        raise PassageError.new(
+                message: "failed to create Passage Magic Link",
+                status_code: e.response[:status],
+                body: e.response[:body]
+              )
       end
     end
   end

data/lib/passageidentity/error.rb

@@ -1,4 +1,24 @@
+require "net/http"
+
 module Passage
   class PassageError < StandardError
+    attr_reader :status_code
+    attr_reader :status_text
+    attr_reader :message
+    attr_reader :error
+
+    def initialize(message:, status_code: nil, body: nil)
+      @message = message
+      @status_code = status_code
+      @status_text =
+        (
+          if status_code.nil?
+            nil
+          else
+            Net::HTTPResponse::CODE_TO_OBJ[status_code.to_s]
+          end
+        )
+      @error = body.nil? ? nil : body["error"]
+    end
   end
 end

data/lib/passageidentity/user_api.rb

@@ -10,7 +10,8 @@ module Passage
     end
 
     def get(user_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
+
       begin
         response = @connection.get("/v1/apps/#{@app_id}/users/#{user_id}")
         user = response.body["user"]
@@ -35,17 +36,24 @@ module Passage
         )
       rescue Faraday::Error => e
         if e.is_a? Faraday::ResourceNotFound
-          raise PassageError,
-                "passage User with ID \"#{user_id}\" does not exist"
+          raise PassageError.new(
+                  message: "Passage User with ID \"#{user_id}\" does not exist",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         else
-          raise PassageError,
-                "failed to get Passage User. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+          raise PassageError.new(
+                  message: "failed to get Passage User.",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         end
       end
     end
 
     def activate(user_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
+
       begin
         response =
           @connection.patch("/v1/apps/#{@app_id}/users/#{user_id}/activate")
@@ -70,17 +78,24 @@ module Passage
         )
       rescue Faraday::Error => e
         if e.is_a? Faraday::ResourceNotFound
-          raise PassageError,
-                "passage User with ID \"#{user_id}\" does not exist"
+          raise PassageError.new(
+                  message: "Passage User with ID \"#{user_id}\" does not exist",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         else
-          raise PassageError,
-                "failed to activate Passage User. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+          raise PassageError.new(
+                  message: "failed to activate Passage User.",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         end
       end
     end
 
     def deactivate(user_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
+
       begin
         response =
           @connection.patch("/v1/apps/#{@app_id}/users/#{user_id}/deactivate")
@@ -105,17 +120,24 @@ module Passage
         )
       rescue Faraday::Error => e
         if e.is_a? Faraday::ResourceNotFound
-          raise PassageError,
-                "passage User with ID \"#{user_id}\" does not exist"
+          raise PassageError.new(
+                  message: "Passage User with ID \"#{user_id}\" does not exist",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         else
-          raise PassageError,
-                "failed to deactivate Passage User. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+          raise PassageError.new(
+                  message: "failed to deactivate Passage User.",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         end
       end
     end
 
     def update(user_id:, email: "", phone: "", user_metadata: {})
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
+
       updates = {}
       updates["email"] = email unless email.empty?
       updates["phone"] = phone unless phone.empty?
@@ -144,11 +166,17 @@ module Passage
         )
       rescue Faraday::Error => e
         if e.is_a? Faraday::ResourceNotFound
-          raise PassageError,
-                "passage User with ID \"#{user_id}\" does not exist"
+          raise PassageError.new(
+                  message: "Passage User with ID \"#{user_id}\" does not exist",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         else
-          raise PassageError,
-                "failed to update Passage User. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+          raise PassageError.new(
+                  "failed to update Passage User",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         end
       end
     end
@@ -180,32 +208,41 @@ module Passage
           )
         )
       rescue Faraday::Error => e
-        raise PassageError,
-              "failed to create Passage User. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+        raise PassageError.new(
+                "failed to create Passage User",
+                status_code: e.response[:status],
+                body: e.response[:body]
+              )
       end
     end
 
     def delete(user_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
+
       begin
         response = @connection.delete("/v1/apps/#{@app_id}/users/#{user_id}")
         return true
       rescue Faraday::Error => e
         if e.is_a? Faraday::ResourceNotFound
-          raise PassageError,
-                "passage User with ID \"#{user_id}\" does not exist"
+          raise PassageError.new(
+                  "passage User with ID \"#{user_id}\" does not exist",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         else
-          raise PassageError,
-                "failed to delete Passage User. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+          raise PassageError.new(
+                  "failed to delete Passage User",
+                  status_code: e.response[:status],
+                  body: e.response[:body]
+                )
         end
       end
     end
 
     def delete_device(user_id:, device_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
-      if device_id.to_s.empty?
-        raise PassageError, "must supply a valid device_id"
-      end
+      user_exists?(user_id)
+      device_exists?(device_id)
+
       begin
         response =
           @connection.delete(
@@ -213,13 +250,17 @@ module Passage
           )
         return true
       rescue Faraday::Error => e
-        raise PassageError,
-              "failed to delete Passage User Device. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+        raise PassageError.new(
+                "failed to delete Passage User Device",
+                status_code: e.response[:status],
+                body: e.response[:body]
+              )
       end
     end
 
     def list_devices(user_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
+
       begin
         response =
           @connection.get("/v1/apps/#{@app_id}/users/#{user_id}/devices")
@@ -240,20 +281,40 @@ module Passage
         end
         return devices
       rescue Faraday::Error => e
-        raise PassageError,
-              "failed to delete Passage User Device. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+        raise PassageError.new(
+                "failed to delete Passage User Device",
+                status_code: e.response[:status],
+                body: e.response[:body]
+              )
       end
     end
 
     def signout(user_id:)
-      raise PassageError, "must supply a valid user_id" if user_id.to_s.empty?
+      user_exists?(user_id)
       begin
         response =
           @connection.delete("/v1/apps/#{@app_id}/users/#{user_id}/tokens/")
         return true
       rescue Faraday::Error => e
-        raise PassageError,
-              "failed to revoke user's refresh tokens. Http Status: #{e.response[:status]}. Response: #{e.response[:body]["error"]}"
+        raise PassageError.new(
+                "failed to revoke user's refresh tokens",
+                status_code: e.response[:status],
+                body: e.response[:body]
+              )
+      end
+    end
+
+    private
+
+    def user_exists?(user_id)
+      if user_id.to_s.empty?
+        raise PassageError.new(message: "must supply a valid user_id")
+      end
+    end
+
+    def device_exists?(device_id)
+      if device_id.to_s.empty?
+        raise PassageError.new(message: "must supply a valid device_id")
       end
     end
   end

data/passageidentity.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = 'passageidentity'
-  s.version = '0.1.1'
+  s.version = '0.2.0'
   s.summary = 'Passage SDK for biometric authentication'
   s.description =
     'Enables verification of server-side authentication and user management for applications using Passage'

data/tests/errors_test.rb

@@ -0,0 +1,30 @@
+require_relative "../lib/passageidentity/error"
+require "test/unit"
+require "net/http"
+
+class ErrorTest < Test::Unit::TestCase
+  def test_initialize
+    body = { "error" => "some error" }
+
+    error =
+      Passage::PassageError.new(
+        message: "some message",
+        status_code: 400,
+        body: body
+      )
+
+    assert_equal error.message, "some message"
+    assert_equal error.error, "some error"
+    assert_equal error.status_code, 400
+    assert_equal error.status_text, Net::HTTPBadRequest
+  end
+
+  def test_initialize_message_only
+    error = Passage::PassageError.new(message: "some message")
+
+    assert_equal error.message, "some message"
+    assert_equal error.error, nil
+    assert_equal error.status_code, nil
+    assert_equal error.status_text, nil
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: passageidentity
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Passage Identity
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-02 00:00:00.000000000 Z
+date: 2022-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -94,6 +94,7 @@ files:
 - tests/all.rb
 - tests/app_test.rb
 - tests/auth_test.rb
+- tests/errors_test.rb
 - tests/magic_link_test.rb
 - tests/user_api_test.rb
 homepage: https://rubygems.org/gems/passageidentity