workos 5.30.1 → 5.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e92012bf9ac81d3796ef280568d50188ec6cb01bd4dfdd9c053b61196a608063
-  data.tar.gz: 379504e11cbbf1e6d64670631b87c58b4a3bfac4b6fb724a68707423015d9641
+  metadata.gz: 72ac2923fd0b63753144e3395e07af49589481edabf18df1c4d959ea92b56400
+  data.tar.gz: f9950ef319ff6001fd2ad1ce7d3f0ab2282e9fc8abc7f0c41fba69bc53bfb175
 SHA512:
-  metadata.gz: 3b62dcaec41f4936b5027394952cd6d8f2050c80cd8676cbe69d1187d54a70d7e7b0f9673f9565a80b1de3662a64478321615521363eb61f7d8f72f8800b56fd
-  data.tar.gz: 594a6d8526ec2719e4c342433a95fe15b775809dc8921ac9c7e6dc25ecf11a2c97a59e095085c082b2ee83ff1490443fb868d80c9d35128849ae09ac6307a77d
+  metadata.gz: b29d2a45d77c3242d2a970c14c30ed9b082cb8a2fb9447c32b8cb02d642deca29e7d044646deeba9a2de25ed971a801418b50e461ab6784fefa89353891eabb8
+  data.tar.gz: ef16608e192c0c8dffa249b8f37a83efa36897dfff75f87779c4cde3117fe2518f6535db63590465f8fcffe41cbf556397cc9b107c6f2cda2715dd324b651b00

data/.github/CODEOWNERS

@@ -2,4 +2,4 @@
 # https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners
 
 # Rubyist Team
-* @workos-inc/ruby
+* @workos/ruby

data/.github/workflows/ci.yml

@@ -20,8 +20,8 @@ jobs:
           - '3.1'
           - '3.2'
     steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@1a615958ad9d422dd932dc1d5823942ee002799f # v1.227.0
+      - uses: actions/checkout@v6
+      - uses: ruby/setup-ruby@675dd7ba1b06c8786a1480d89c384f5620a42647 # v1.281.0
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true

data/.github/workflows/release.yml

@@ -16,7 +16,7 @@ jobs:
     name: Publish to RubyGems
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.2'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    workos (5.30.1)
+    workos (5.31.0)
       encryptor (~> 3.0)
       jwt (~> 2.8)
 
@@ -20,7 +20,7 @@ GEM
     encryptor (3.0.0)
     hashdiff (1.1.0)
     json (2.9.1)
-    jwt (2.10.1)
+    jwt (2.10.2)
       base64
     language_server-protocol (3.17.0.3)
     parallel (1.26.3)
@@ -31,7 +31,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     regexp_parser (2.10.0)
-    rexml (3.4.1)
+    rexml (3.4.2)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)

data/context7.json

@@ -0,0 +1,4 @@
+{
+  "url": "https://context7.com/workos/workos-ruby",
+  "public_key": "pk_q7NnKuFFXMWA7WnmjMHQU"
+}

data/lib/workos/directory_sync.rb

@@ -115,7 +115,7 @@ module WorkOS
       # @param [Hash] options An options hash
       # @option options [String] directory The ID of the directory whose
       #  directory users will be retrieved.
-      # @option options [String] user The ID of the directory group whose
+      # @option options [String] group The ID of the directory group whose
       #  directory users will be retrieved.
       # @option options [String] limit Maximum number of records to return.
       # @option options [String] order The order in which to paginate records

data/lib/workos/user_management/session.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module WorkOS
+  module UserManagement
+    # The Session class provides a lightweight wrapper around
+    # a WorkOS Session resource. This class is not meant to be instantiated
+    # in user space, and is instantiated internally but exposed.
+    class Session
+      include HashProvider
+      attr_accessor :id, :object, :user_id, :organization_id, :status, :auth_method,
+                    :ip_address, :user_agent, :expires_at, :ended_at, :created_at, :updated_at
+
+      # rubocop:disable Metrics/AbcSize
+      def initialize(json)
+        hash = JSON.parse(json, symbolize_names: true)
+
+        @id = hash[:id]
+        @object = hash[:object]
+        @user_id = hash[:user_id]
+        @organization_id = hash[:organization_id]
+        @status = hash[:status]
+        @auth_method = hash[:auth_method]
+        @ip_address = hash[:ip_address]
+        @user_agent = hash[:user_agent]
+        @expires_at = hash[:expires_at]
+        @ended_at = hash[:ended_at]
+        @created_at = hash[:created_at]
+        @updated_at = hash[:updated_at]
+      end
+      # rubocop:enable Metrics/AbcSize
+
+      def to_json(*)
+        {
+          id: id,
+          object: object,
+          user_id: user_id,
+          organization_id: organization_id,
+          status: status,
+          auth_method: auth_method,
+          ip_address: ip_address,
+          user_agent: user_agent,
+          expires_at: expires_at,
+          ended_at: ended_at,
+          created_at: created_at,
+          updated_at: updated_at,
+        }
+      end
+
+      # Revoke this session
+      #
+      # @return [Bool] - returns `true` if successful
+      def revoke
+        WorkOS::UserManagement.revoke_session(session_id: id)
+      end
+    end
+  end
+end

data/lib/workos/user_management.rb

@@ -7,6 +7,8 @@ module WorkOS
   # The UserManagement module provides convenience methods for working with the
   # WorkOS User platform. You'll need a valid API key.
   module UserManagement
+    autoload :Session, 'workos/user_management/session'
+
     module Types
       # The ProviderEnum is a declaration of a
       # fixed set of values for User Management Providers.
@@ -740,6 +742,40 @@ module WorkOS
         )
       end
 
+      # Get all sessions for a user
+      #
+      # @param [String] user_id The id for the user.
+      # @param [Hash] options
+      # @option options [String] limit Maximum number of records to return.
+      # @option options [String] order The order in which to paginate records
+      # @option options [String] before Pagination cursor to receive records
+      #  before a provided Session ID.
+      # @option options [String] after Pagination cursor to receive records
+      #  after a provided Session ID.
+      #
+      # @return [WorkOS::Types::ListStruct<WorkOS::UserManagement::Session>]
+      def list_sessions(user_id:, options: {})
+        options[:order] ||= 'desc'
+        response = execute_request(
+          request: get_request(
+            path: "/user_management/users/#{user_id}/sessions",
+            auth: true,
+            params: options,
+          ),
+        )
+
+        parsed_response = JSON.parse(response.body)
+
+        sessions = parsed_response['data'].map do |session|
+          ::WorkOS::UserManagement::Session.new(session.to_json)
+        end
+
+        WorkOS::Types::ListStruct.new(
+          data: sessions,
+          list_metadata: parsed_response['list_metadata'],
+        )
+      end
+
       # Gets an email verification object
       #
       # @param [String] id The unique ID of the EmailVerification object.

data/lib/workos/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WorkOS
-  VERSION = '5.30.1'
+  VERSION = '5.31.0'
 end

data/spec/lib/workos/user_management_spec.rb

@@ -1797,6 +1797,45 @@ describe WorkOS::UserManagement do
     end
   end
 
+  describe '.list_sessions' do
+    context 'with a valid user_id' do
+      it 'returns a list of sessions' do
+        VCR.use_cassette('user_management/list_sessions/valid') do
+          result = described_class.list_sessions(
+            user_id: 'user_01H7TVSKS45SDHN5V9XPSM6H44',
+          )
+
+          expect(result.data).to be_an(Array)
+          expect(result.data.first).to be_a(WorkOS::UserManagement::Session)
+          expect(result.data.first.id).to eq('session_01H96FETXGTW2S0V5V9XPSM6H44')
+          expect(result.data.first.status).to eq('active')
+          expect(result.data.first.auth_method).to eq('password')
+        end
+      end
+
+      it 'returns sessions that can be revoked' do
+        VCR.use_cassette('user_management/list_sessions/valid') do
+          result = described_class.list_sessions(
+            user_id: 'user_01H7TVSKS45SDHN5V9XPSM6H44',
+          )
+          session = result.data.first
+
+          expect(described_class).to receive(:post_request) do |options|
+            expect(options[:path]).to eq('/user_management/sessions/revoke')
+            expect(options[:body]).to eq({ session_id: 'session_01H96FETXGTW2S0V5V9XPSM6H44' })
+            expect(options[:auth]).to be true
+          end.and_return(double('request'))
+
+          expect(described_class).to receive(:execute_request).and_return(
+            double('response', is_a?: true),
+          )
+
+          expect(session.revoke).to be true
+        end
+      end
+    end
+  end
+
   describe '.get_logout_url' do
     it 'returns a logout url for the given session ID' do
       result = described_class.get_logout_url(

data/spec/support/fixtures/vcr_cassettes/user_management/list_sessions/valid.yml

@@ -0,0 +1,38 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.workos.com/user_management/users/user_01H7TVSKS45SDHN5V9XPSM6H44/sessions?order=desc
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - WorkOS; ruby/3.0.2; arm64-darwin22; v2.16.0
+      Authorization:
+      - Bearer <API_KEY>
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Mon, 05 Jan 2026 12:00:00 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: ASCII-8BIT
+      string: '{"object":"list","data":[{"object":"session","id":"session_01H96FETXGTW2S0V5V9XPSM6H44","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:146.0) Gecko/20100101 Firefox/146.0","ip_address":"192.168.1.1","organization_id":"org_01H96FETXGTW2SXRA136PCMAQJ0","user_id":"user_01H7TVSKS45SDHN5V9XPSM6H44","auth_method":"password","status":"active","expires_at":"2027-01-02T03:47:13.027Z","ended_at":null,"created_at":"2026-01-02T03:47:13.024Z","updated_at":"2026-01-05T02:56:09.379Z"}],"list_metadata":{"before":null,"after":null}}'
+    http_version:
+  recorded_at: Mon, 05 Jan 2026 12:00:00 GMT
+recorded_with: VCR 5.0.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: workos
 version: !ruby/object:Gem::Version
-  version: 5.30.1
+  version: 5.31.0
 platform: ruby
 authors:
 - WorkOS
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-02 00:00:00.000000000 Z
+date: 2026-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: encryptor
@@ -132,6 +132,7 @@ files:
 - bin/build
 - bin/console
 - bin/publish
+- context7.json
 - lib/workos.rb
 - lib/workos/audit_log_export.rb
 - lib/workos/audit_logs.rb
@@ -181,6 +182,7 @@ files:
 - lib/workos/user.rb
 - lib/workos/user_and_token.rb
 - lib/workos/user_management.rb
+- lib/workos/user_management/session.rb
 - lib/workos/user_response.rb
 - lib/workos/verify_challenge.rb
 - lib/workos/version.rb
@@ -360,6 +362,7 @@ files:
 - spec/support/fixtures/vcr_cassettes/user_management/list_organization_memberships/no_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_organization_memberships/with_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_organization_memberships/with_statuses_option.yml
+- spec/support/fixtures/vcr_cassettes/user_management/list_sessions/valid.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_users/no_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_users/with_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/reactivate_organization_membership.yml
@@ -599,6 +602,7 @@ test_files:
 - spec/support/fixtures/vcr_cassettes/user_management/list_organization_memberships/no_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_organization_memberships/with_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_organization_memberships/with_statuses_option.yml
+- spec/support/fixtures/vcr_cassettes/user_management/list_sessions/valid.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_users/no_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/list_users/with_options.yml
 - spec/support/fixtures/vcr_cassettes/user_management/reactivate_organization_membership.yml