workos 0.9.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fd3e38d33d428497a46f40df28c4d142bc9adaf90c166b61c05914030c50b25
-  data.tar.gz: c445aa218658fe1fb57add7cc9081b1e63223641d29cac1e276429d3fb1244fd
+  metadata.gz: f8a9f985318b4480c50a4d0528cf5036018235833585746e3ed632020fca3d00
+  data.tar.gz: bc75b64c4a4ffa8b32ee2b841af1c6bdb39df729bda95cc59d9ad36206cab387
 SHA512:
-  metadata.gz: b94cf0c103286a457c3a73ab4ead5196ad2a8111f486ff22adbf4ecbdd5a21685dcb9483325b15813dcd5a25ea2383aec7d64fbc7545d4c80267731e97ed4a48
-  data.tar.gz: 30d4256a4b9218890dd880a5513dd90a09052f746085dffc282532bbf9ed5683b04d690181cfe1b209f02edc1fd1e37e04149819c8731afb81f5aba5561a2c18
+  metadata.gz: 56d3896fd8bb4194cbb50464759c9babfe2421e56148827fe282af956fa4fb9f38eb308363e30427bed0ef3596e5c1ba99150f108208835ecdb40921e99bf67e
+  data.tar.gz: e5f09155ab5a7e92dc0ccd6a10af885d5802925a7db1fdaf21cbeb9902b231642284ed06aa1ce0806271fceab5f42209d1c3c1c5442c6ea42a780a6264670ce4

data/.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# See GitHub's docs for more details:
+# https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners
+
+# Rubyist Team
+* @workos-inc/ruby

data/.rubocop.yml

@@ -10,8 +10,12 @@ Layout/LineLength:
     - '(\A|\s)/.*?/'
 Metrics/BlockLength:
   ExcludedMethods: ['describe', 'context']
+Metrics/MethodLength:
+  Max: 15
 Metrics/ModuleLength:
-  Max: 150
+  Max: 200
+Metrics/ParameterLists:
+  Max: 6
 Style/TrailingCommaInArguments:
   EnforcedStyleForMultiline: 'consistent_comma'
 Style/TrailingCommaInHashLiteral:

data/.ruby-version

@@ -1 +1 @@
-2.7.1
+3.0.1

data/.semaphore/semaphore.yml

@@ -60,10 +60,16 @@ blocks:
             - sem-version ruby 2.6.5
             - bundle install
             - bundle exec rspec
-        - name: Ruby 2.7.1
+        - name: Ruby 2.7.3
           commands:
             - checkout
-            - sem-version ruby 2.7.1
+            - sem-version ruby 2.7.3
+            - bundle install
+            - bundle exec rspec
+        - name: Ruby 3.0.1
+          commands:
+            - checkout
+            - sem-version ruby 3.0.1
             - bundle install
             - bundle exec rspec
 promotions:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    workos (0.9.0)
+    workos (1.0.0)
       sorbet-runtime (~> 0.5)
 
 GEM
@@ -9,60 +9,73 @@ GEM
   specs:
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
-    ast (2.4.0)
-    codecov (0.2.8)
+    ast (2.4.2)
+    codecov (0.2.12)
       json
       simplecov
-    crack (0.4.3)
-      safe_yaml (~> 1.0.0)
-    diff-lcs (1.3)
-    docile (1.3.2)
-    hashdiff (1.0.0)
-    jaro_winkler (1.5.4)
-    json (2.3.1)
-    parallel (1.19.1)
-    parser (2.7.0.0)
-      ast (~> 2.4.0)
-    public_suffix (4.0.2)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.4.4)
+    docile (1.3.5)
+    hashdiff (1.0.1)
+    json (2.5.1)
+    parallel (1.20.1)
+    parser (3.0.1.0)
+      ast (~> 2.4.1)
+    public_suffix (4.0.6)
     rainbow (3.0.0)
-    rake (13.0.1)
+    rake (13.0.3)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
       rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.0)
-      rspec-support (~> 3.9.0)
-    rspec-expectations (3.9.0)
+    rspec-core (3.9.3)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.4)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.0)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-support (3.9.0)
-    rubocop (0.78.0)
-      jaro_winkler (~> 1.5.1)
+    rspec-support (3.9.4)
+    rubocop (0.93.1)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8)
+      rexml
+      rubocop-ast (>= 0.6.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    ruby-progressbar (1.10.1)
-    safe_yaml (1.0.5)
-    simplecov (0.19.0)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.4.1)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.11.0)
+    simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
-    simplecov-html (0.12.2)
-    sorbet (0.5.5560)
-      sorbet-static (= 0.5.5560)
-    sorbet-runtime (0.5.5943)
-    sorbet-static (0.5.5560-universal-darwin-14)
-    unicode-display_width (1.6.0)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.2)
+    sorbet (0.5.6388)
+      sorbet-static (= 0.5.6388)
+    sorbet-runtime (0.5.6403)
+    sorbet-static (0.5.6388-universal-darwin-14)
+    sorbet-static (0.5.6388-universal-darwin-15)
+    sorbet-static (0.5.6388-universal-darwin-16)
+    sorbet-static (0.5.6388-universal-darwin-17)
+    sorbet-static (0.5.6388-universal-darwin-18)
+    sorbet-static (0.5.6388-universal-darwin-19)
+    sorbet-static (0.5.6388-universal-darwin-20)
+    sorbet-static (0.5.6388-x86_64-linux)
+    unicode-display_width (1.7.0)
     vcr (5.0.0)
-    webmock (3.7.6)
+    webmock (3.12.2)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.22)
+    yard (0.9.26)
 
 PLATFORMS
   ruby
@@ -80,4 +93,4 @@ DEPENDENCIES
   yard
 
 BUNDLED WITH
-   2.1.4
+   2.2.16

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 WorkOS
+Copyright (c) 2021 WorkOS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,22 +1,22 @@
-# workos-ruby [![codecov](https://codecov.io/gh/workos-inc/workos-ruby/branch/master/graph/badge.svg)](https://codecov.io/gh/workos-inc/workos-ruby)
+# WorkOS Ruby Library
 
-WorkOS official Ruby gem for interacting with WorkOS APIs
+The WorkOS library for Ruby provides convenient access to the WorkOS API from applications written in Ruby.
 
 ## Documentation
 
-Complete documentation for the latest version of WorkOS Ruby Gem can be found [here](https://workos-inc.github.io/workos-ruby/).
+See the [API Reference](https://workos.com/docs/reference/client-libraries) for Ruby usage examples.
 
 ## Installation
 
-To get started, you can install the WorkOS gem via RubyGems with:
+Install the package with:
 
-```ruby
+```
 gem install workos
 ```
 
 If you're using Bundler to manage your application's gems, add the WorkOS gem to your Gemfile:
 
-```ruby
+```
 source 'https://rubygems.org'
 
 gem 'workos'
@@ -24,17 +24,13 @@ gem 'workos'
 
 ## Configuration
 
-To use the SDK you must first provide your API key from the [WorkOS Developer Dashboard](https://dashboard.workos.com/api-keys).
-
-You can do this through the `WORKOS_API_KEY` environment variable or by calling `WorkOS.key = [your API key]`.
-
-The WorkOS Gem will read the environment variable `WORKOS_API_KEY`:
+To use the library you must provide an API key, located in the WorkOS dashboard, as an environment variable `WORKOS_API_KEY`:
 
 ```sh
 $ WORKOS_API_KEY=[your api key] ruby app.rb
 ```
 
-Alternatively, you may set the key yourself, such as in an initializer in your application load path:
+Or, you may set the key yourself, such as in an initializer in your application load path:
 
 ```ruby
 # /config/initializers/workos.rb
@@ -42,159 +38,9 @@ Alternatively, you may set the key yourself, such as in an initializer in your a
 WorkOS.key = '[your api key]'
 ```
 
-## The Audit Trail Module
-
-The Audit Trail Module provides methods for creating Audit Trail events on
-WorkOS.
-
-See our [Audit Trail
-Overview](https://docs.workos.com/audit-trail/overview) for
-more information.
-
-```ruby
-payload = {
-  group: 'Foo Corp',
-  location: '127.0.0.1',
-  action: 'user.created',
-  action_type: 'C',
-  actor_name: 'Foo',
-  actor_id: 'user_12345',
-  target_name: 'Bar',
-  target_id: 'user_67890',
-  occurred_at: '2020-01-10T15:30:00-05:00',
-  metadata: {
-    source: 'Email',
-  }
-}
-
-WorkOS::AuditTrail.create_event(event: payload)
-```
-
-### Idempotency
-
-To perform an idempotent request, provide an additional idempotency_key
-parameter to the `create_event` options.
-
-```ruby
-WorkOS::AuditTrail.create_event(event: payload, idempotency_key: 'key123456')
-```
-
-See our [API
-Reference](https://docs.workos.com/audit-trail/api-reference#idempotency)
-for more information on idempotency keys.
-
-## The SSO Module
-
-The SSO Module provides convenience methods for authenticating a Single Sign On (SSO) user via WorkOS. WorkOS SSO follows the Oauth 2.0 specification.
-
-First, you'll direct your SSO users to an `authorization_url`. They will sign in to their SSO account with their Identity Provider, and be redirected to a
-callback URL that you set in your WorkOS Dashboard. The user will be redirected with a `code` URL parameter, which you can then exchange for a WorkOS::Profile
-using the `WorkOS::SSO.get_profile` method.
-
-See our Ruby SSO example app for a [complete example](https://github.com/workos-inc/ruby-sso-example).
-
-```ruby
-WorkOS::SSO.authorization_url(domain:, project_id:, redirect_uri:, state: {})
-```
-
-> Generate an authorization URL to intitiate the WorkOS OAuth2 workflow.
-
-`WorkOS::SSO.authorization_url` accepts four arguments:
-
-- `domain` (string) — the authenticating user's company domain, without protocol (ex. `example.com`)
-- `project_id` (string) — your application's WorkOS [Project ID](https://dashboard.workos.com/sso/configuration) (ex. `project_01JG3BCPTRTSTTWQR4VSHXGWCQ`)
-- `state` (optional, hash) — an optional hash used to manage state across authorization transactions (ex. `{ next_page: '/docs'}`)
-- `redirect_uri` (string) — a callback URL where your application redirects the user-agent after an authorization code is granted (ex. `workos.dev/callback`). This must match one of your configured callback URLs for the associated project on your WorkOS dashboard.
-
-This method will return an OAuth2 query string of the form:
-
-`https://${domain}/sso/authorize?response_type=code&client_id=${projectID}&redirect_uri=${redirectURI}&state=${state}`
-
-For example, when used in a [Sinatra app](http://sinatrarb.com/):
-
-```ruby
-DOMAIN = 'example.com'
-PROJECT_ID = '{projectId}'
-REDIRECT_URI = 'http://localhost:4567/callback'
-
-get '/auth' do
-  authorization_url = WorkOS::SSO.authorization_url(
-    domain: DOMAIN,
-    project_id: PROJECT_ID,
-    redirect_uri: REDIRECT_URI,
-  )
-
-  redirect authorization_url
-end
-```
-
-The user would be redirected to:
-
-`https://api.workos.com/sso/authorize?response_type=code&client_id={projectID}&redirect_uri=http://localhost:4567/callback`
-
-WorkOS takes over from here, sending the user to authenticate with their IDP, and on successful login, returns
-the user to your callback URL with a `code` parameter. You'll use `WorkOS::SSO.profile` to exchange the
-code for a `WorkOS::Profile`.
-
-```ruby
-WorkOS::SSO.profile(code:, project_id:)</h4>
-```
-
-> Fetch a WorkOS::Profile for an authorized user.
-
-`WorkOS::SSO.profile` accepts two arguments:
-
-- `code` (string) — an opaque string provided by the authorization server; will be exchanged for an Access Token when the user's profile is sent
-- `project_id` (string) — your application's WorkOS [Project ID](https://dashboard.workos.com/sso/configuration) (ex. `project_01JG3BCPTRTSTTWQR4VSHXGWCQ`)
-
-This method will return an instance of a `WorkOS::Profile` with the following attributes:
-
-```ruby
-<WorkOS::Profile:0x00007fb6e4193d20
-  @id="prof_01DRA1XNSJDZ19A31F183ECQW5",
-  @email="demo@workos-okta.com",
-  @first_name="WorkOS",
-  @connection_id="conn_01EMH8WAK20T42N2NBMNBCYHAG",
-  @connection_type="OktaSAML",
-  @last_name="Demo",
-  @idp_id="00u1klkowm8EGah2H357",
-  @raw_attributes={
-    :id=>"prof_01DRA1XNSJDZ19A31F183ECQW5",
-    :email=>"demo@workos-okta.com",
-    :first_name=>"WorkOS",
-    :last_name=>"Demo",
-    :idp_id=>"00u1klkowm8EGah2H357"
-  },
->
-```
-
-Our Sintatra app can be extended to use this method:
-
-```ruby
-DOMAIN = 'example.com'
-PROJECT_ID = '{projectId}'
-REDIRECT_URI = 'http://localhost:4567/callback'
-
-get '/auth' do
-  authorization_url = WorkOS::SSO.authorization_url(
-    domain: DOMAIN,
-    project_id: PROJECT_ID,
-    redirect_uri: REDIRECT_URI,
-  )
-
-  redirect authorization_url
-end
-
-get '/callback' do
-  profile = WorkOS::SSO.profile(
-    code: params['code'],
-    project_id: PROJECT_ID,
-  )
-
-  session[:user] = profile.to_json
-
-  redirect '/'
-end
-```
+## More Information
 
-Given the `WorkOS::Profile`, you can now sign the user in according to your own authentication setup.
+* [Single Sign-On Guide](https://workos.com/docs/sso/guide)
+* [Directory Sync Guide](https://workos.com/docs/directory-sync/guide)
+* [Admin Portal Guide](https://workos.com/docs/admin-portal/guide)
+* [Magic Link Guide](https://workos.com/docs/magic-link/guide)