stytch 2.1.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e297565a826ab7318a1471d3b4286bba6d8a58c1f335bb5fe39b31355dad8bb0
-  data.tar.gz: 6d5873eed220a0d85539b0264408757451ce18e106dd58cf5b747543697808cc
+  metadata.gz: c6f511de04dc81d999863698f74e78e602ef56b0ad69ebeda06fba44d30066be
+  data.tar.gz: 6c167abff08d5fc5c418499443bf030b95bb5d8a8a2185bb29729372abc42011
 SHA512:
-  metadata.gz: bcec30dcf3b4e89293bb41f05202aca38b6b46d2a42531d9cae2471a1b6c8a7052bca1aa962a4017a2486b92a0f1c24b7634c59c3ed8725f3763d17a6162cef7
-  data.tar.gz: 36d398ca7e3a987cb94efa45875d17473dfdd348266474e9c2f29ec6a1491a0bf001a1960f9ed712f946904daf0265f79e851689a7ff9cb9cf6e546d843d64af
+  metadata.gz: 2471cf9eba300cbd8110f23a260b7e926f4fc33ed8b19af55e7c8a9f90457ec24823d95b86b3116912473cef5b45219491e445d3e83c6a1b2809fba6e7a53a6f
+  data.tar.gz: 61e5e6e89811f4bb5ba94c1bf2c004ce411c5de6c6f3025761fb99310ded9810d5acbdbad507f8a42ef1baaafdbffdd1d1c433f3423e6e05c63c556ced63c7f2

data/CODEOWNERS

@@ -0,0 +1,7 @@
+# Stytch code owners file
+
+# These owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence,
+# @stytchauth/client-libraries will be requested for
+# review when someone opens a pull request.
+*       @stytchauth/client-libraries

data/CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at alex@stytch.com. All
+reported by contacting the project team at support@stytch.com. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

data/DEVELOPMENT.md

@@ -0,0 +1,18 @@
+# Development
+
+Thanks for contributing to Stytch's Ruby library! If you run into trouble, find us in [Slack].
+
+## Setup
+
+1. Clone this repo.
+2. To test your changes locally, update your GEMFILE with `gem 'stytch', path: '../stytch'` where `../stytch` is the path to your cloned copy of stytch-ruby.
+
+## Issues and Pull Requests
+
+Please file issues in this repo. We don't have an issue template yet, but for now, say whatever you think is important!
+
+If you have non-trivial changes you'd like us to incorporate, please open an issue first so we can discuss the changes before starting on a pull request. (It's fine to start with the PR for a typo or simple bug.) If we think the changes align with the direction of the project, we'll either ask you to open the PR or assign someone on the Stytch team to make the changes.
+
+When you're ready for someone to look at your issue or PR, assign `@stytchauth/client-libraries` (GitHub should do this automatically). If we don't acknowledge it within one business day, please escalate it by tagging `@stytchauth/engineering` in a comment or letting us know in [Slack].
+
+[Slack]: https://join.slack.com/t/stytch/shared_invite/zt-nil4wo92-jApJ9Cl32cJbEd9esKkvyg

data/README.md

@@ -1,8 +1,10 @@
-# Stytch
+# Stytch Ruby Gem
 
-Welcome to the official Stytch ruby gem! This gem provides easy access to Stytch's API.
+The Stytch Ruby gem makes it easy to use the Stytch user infrastructure API in Ruby applications.
 
-## Installation
+It pairs well with the Stytch [Web SDK](https://www.npmjs.com/package/@stytch/stytch-js) or your own custom authentication flow.
+
+## Install
 
 Add this line to your application's Gemfile:
 
@@ -20,25 +22,61 @@ Or install it yourself as:
 
 ## Usage
 
-To make a request, first create a Stytch Client.
-Set `env` to either `:test` or `:api` depending on which environment you want to use.
-```
+You can find your API credentials in the [Stytch Dashboard](https://stytch.com/dashboard/api-keys).
+
+Create an API client:
+```ruby
 client = Stytch::Client.new(
-    env: :test,
+    env: :test, # available environments are :test and :live
     project_id: "***",
     secret: "***"
 )
 ```
 
-Then make desired API call.
+Send a magic link by email:
+```ruby
+client.magic_links.email.login_or_create(
+    email: "sandbox@stytch.com",
+    login_magic_link_url: "https://example.com/login",
+    signup_magic_link_url: "https://example.com/signup",
+)
 ```
-client.users.get(user_id: user_id)
+
+Authenticate the token from the magic link:
+```ruby
+client.magic_links.authenticate(
+    token: "DOYoip3rvIMMW5lgItikFK-Ak1CfMsgjuiCyI7uuU94=",
+)
 ```
 
+## Handling Errors
+
+When possible the response will contain an `error_type` and an `error_message` that can be used to distinguish errors.
+
+Learn more about errors in the [docs](https://stytch.com/docs/api/errors).
+
+## Documentation
+
+See example requests and responses for all the endpoints in the [Stytch API Reference](https://stytch.com/docs/api).
+
+Follow one of the [integration guides](https://stytch.com/docs/guides) or start with one of our [example apps](https://stytch.com/docs/example-apps).
+
+## Support
+
+If you've found a bug, [open an issue](https://github.com/stytchauth/stytch-ruby/issues/new)!
+
+If you have questions or want help troubleshooting, join us in [Slack](https://join.slack.com/t/stytch/shared_invite/zt-nil4wo92-jApJ9Cl32cJbEd9esKkvyg) or email support@stytch.com.
+
+If you've found a security vulnerability, please follow our [responsible disclosure instructions](https://stytch.com/docs/security).
+
+## Development
+
+See [DEVELOPMENT.md](DEVELOPMENT.md)
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Code of Conduct
 
-Everyone interacting in the Stytch project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/stytchauth/stytch-ruby/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Stytch project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).

data/lib/stytch/client.rb

@@ -3,12 +3,13 @@
 require_relative 'users'
 require_relative 'magic_links'
 require_relative 'otps'
+require_relative 'sessions'
 
 module Stytch
   class Client
     ENVIRONMENTS = %i[live test].freeze
 
-    attr_reader :users, :magic_links, :otps
+    attr_reader :users, :magic_links, :otps, :sessions
 
     def initialize(env:, project_id:, secret:, &block)
       @api_host   = api_host(env)
@@ -20,6 +21,7 @@ module Stytch
       @users = Stytch::Users.new(@connection)
       @magic_links = Stytch::MagicLinks.new(@connection)
       @otps = Stytch::OTPs.new(@connection)
+      @sessions = Stytch::Sessions.new(@connection)
     end
 
     private

data/lib/stytch/magic_links.rb

@@ -16,10 +16,27 @@ module Stytch
       @email = Stytch::MagicLinks::Email.new(@connection)
     end
 
+    def create(
+      user_id:,
+      expiration_minutes: nil,
+      attributes: {}
+    )
+      request = {
+        user_id: user_id
+      }
+
+      request[:expiration_minutes] = expiration_minutes unless expiration_minutes.nil?
+      request[:attributes] = attributes if attributes != {}
+
+      post_request(PATH.to_s, request)
+    end
+
     def authenticate(
       token:,
       attributes: {},
-      options: {}
+      options: {},
+      session_token: nil,
+      session_duration_minutes: nil
     )
       request = {
         token: token
@@ -27,6 +44,8 @@ module Stytch
 
       request[:attributes] = attributes if attributes != {}
       request[:options] = options if options != {}
+      request[:session_token] = session_token unless session_token.nil?
+      request[:session_duration_minutes] = session_duration_minutes unless session_duration_minutes.nil?
 
       post_request("#{PATH}/authenticate", request)
     end

data/lib/stytch/otps.rb

@@ -6,7 +6,7 @@ module Stytch
   class OTPs
     include Stytch::RequestHelper
 
-    attr_reader :sms, :whatsapp
+    attr_reader :sms, :whatsapp, :email
 
     PATH = '/v1/otps'
 
@@ -15,13 +15,16 @@ module Stytch
 
       @sms = Stytch::OTPs::SMS.new(@connection)
       @whatsapp = Stytch::OTPs::WhatsApp.new(@connection)
+      @email = Stytch::OTPs::Email.new(@connection)
     end
 
     def authenticate(
       method_id:,
       code:,
       attributes: {},
-      options: {}
+      options: {},
+      session_token: nil,
+      session_duration_minutes: nil
     )
       request = {
         method_id: method_id,
@@ -30,6 +33,8 @@ module Stytch
 
       request[:attributes] = attributes if attributes != {}
       request[:options] = options if options != {}
+      request[:session_token] = session_token unless session_token.nil?
+      request[:session_duration_minutes] = session_duration_minutes unless session_duration_minutes.nil?
 
       post_request("#{PATH}/authenticate", request)
     end
@@ -117,5 +122,47 @@ module Stytch
         post_request("#{PATH}/login_or_create", request)
       end
     end
+
+    class Email
+      include Stytch::RequestHelper
+
+      PATH = "#{Stytch::OTPs::PATH}/email"
+
+      def initialize(connection)
+        @connection = connection
+      end
+
+      def send(
+        email:,
+        expiration_minutes: nil,
+        attributes: {}
+      )
+        request = {
+          email: email,
+          expiration_minutes: expiration_minutes
+        }
+
+        request[:attributes] = attributes if attributes != {}
+
+        post_request("#{PATH}/send", request)
+      end
+
+      def login_or_create(
+        email:,
+        expiration_minutes: nil,
+        attributes: {},
+        create_user_as_pending: false
+      )
+        request = {
+          email: email,
+          expiration_minutes: expiration_minutes,
+          create_user_as_pending: create_user_as_pending
+        }
+
+        request[:attributes] = attributes if attributes != {}
+
+        post_request("#{PATH}/login_or_create", request)
+      end
+    end
   end
 end

data/lib/stytch/sessions.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative 'request_helper'
+
+module Stytch
+  class Sessions
+    include Stytch::RequestHelper
+
+    PATH = '/v1/sessions'
+
+    def initialize(connection)
+      @connection = connection
+    end
+
+    def get(user_id:)
+      query_params = {
+        user_id: user_id
+      }
+
+      request = request_with_query_params(PATH, query_params)
+
+      get_request(request)
+    end
+
+    def authenticate(
+      session_token:,
+      session_duration_minutes: nil
+    )
+      request = {
+        session_token: session_token
+      }
+
+      request[:session_duration_minutes] = session_duration_minutes unless session_duration_minutes.nil?
+
+      post_request("#{PATH}/authenticate", request)
+    end
+
+    def revoke(
+      session_id: nil,
+      session_token: nil
+    )
+      request = {}
+
+      request[:session_id] = session_id unless session_id.nil?
+      request[:session_token] = session_token unless session_token.nil?
+
+      post_request("#{PATH}/revoke", request)
+    end
+  end
+end

data/lib/stytch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stytch
-  VERSION = '2.1.0'
+  VERSION = '2.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stytch
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.4.0
 platform: ruby
 authors:
 - stytch
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-06-30 00:00:00.000000000 Z
+date: 2021-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -60,7 +60,9 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CODEOWNERS
 - CODE_OF_CONDUCT.md
+- DEVELOPMENT.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -73,6 +75,7 @@ files:
 - lib/stytch/middleware.rb
 - lib/stytch/otps.rb
 - lib/stytch/request_helper.rb
+- lib/stytch/sessions.rb
 - lib/stytch/users.rb
 - lib/stytch/version.rb
 - stytch.gemspec