fusionauth_client 1.49.1 → 1.50.0

data/fusionauth-ruby-client.iml

@@ -8,8 +8,5 @@
     </content>
     <orderEntry type="jdk" jdkName="rbenv: 2.5.9" jdkType="RUBY_SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
-    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.2.5, rbenv: 2.5.9) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.8.3, rbenv: 2.5.9) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rake (v12.3.3, rbenv: 2.5.9) [gem]" level="application" />
   </component>
-</module>
+</module>

data/fusionauth_client.gemspec

@@ -1,6 +1,6 @@
 # coding: utf-8
 
-# Copyright (c) 2022, FusionAuth, All Rights Reserved
+# Copyright (c) 2024, FusionAuth, All Rights Reserved
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -19,7 +19,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name = 'fusionauth_client'
-  spec.version = '1.49.1'
+  spec.version = '1.50.0'
   spec.authors = ['Brian Pontarelli', 'Daniel DeGroff']
   spec.email = %w(brian@fusionauth.io daniel@fusionauth.io)
 

data/lib/fusionauth/fusionauth_client.rb

@@ -557,6 +557,24 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Creates a new custom OAuth scope for an application. You must specify the Id of the application you are creating the scope for.
+    # You can optionally specify an Id for the OAuth scope on the URL, if not provided one will be generated.
+    #
+    # @param application_id [string] The Id of the application to create the OAuth scope on.
+    # @param scope_id [string] (Optional) The Id of the OAuth scope. If not provided a secure random UUID will be generated.
+    # @param request [OpenStruct, Hash] The request object that contains all the information used to create the OAuth OAuth scope.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def create_o_auth_scope(application_id, scope_id, request)
+      start.uri('/api/application')
+          .url_segment(application_id)
+          .url_segment("scope")
+          .url_segment(scope_id)
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .post()
+          .go()
+    end
+
     #
     # Creates a tenant. You can optionally specify an Id for the tenant, if not provided one will be generated.
     #
@@ -776,7 +794,7 @@ module FusionAuth
     # Hard deletes an application role. This is a dangerous operation and should not be used in most circumstances. This
     # permanently removes the given role from all users that had it.
     #
-    # @param application_id [string] The Id of the application to deactivate.
+    # @param application_id [string] The Id of the application that the role belongs to.
     # @param role_id [string] The Id of the role to delete.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def delete_application_role(application_id, role_id)
@@ -1001,6 +1019,22 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Hard deletes a custom OAuth scope.
+    # OAuth workflows that are still requesting the deleted OAuth scope may fail depending on the application's unknown scope policy.
+    #
+    # @param application_id [string] The Id of the application that the OAuth scope belongs to.
+    # @param scope_id [string] The Id of the OAuth scope to delete.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def delete_o_auth_scope(application_id, scope_id)
+      start.uri('/api/application')
+          .url_segment(application_id)
+          .url_segment("scope")
+          .url_segment(scope_id)
+          .delete()
+          .go()
+    end
+
     #
     # Deletes the user registration for the given user and application.
     #
@@ -1902,6 +1936,23 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Updates, via PATCH, the custom OAuth scope with the given Id for the application.
+    #
+    # @param application_id [string] The Id of the application that the OAuth scope belongs to.
+    # @param scope_id [string] The Id of the OAuth scope to update.
+    # @param request [OpenStruct, Hash] The request that contains just the new OAuth scope information.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def patch_o_auth_scope(application_id, scope_id, request)
+      start.uri('/api/application')
+          .url_segment(application_id)
+          .url_segment("scope")
+          .url_segment(scope_id)
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .patch()
+          .go()
+    end
+
     #
     # Updates, via PATCH, the registration for the user with the given Id and the application defined in the request.
     #
@@ -2820,6 +2871,21 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Retrieves a custom OAuth scope.
+    #
+    # @param application_id [string] The Id of the application that the OAuth scope belongs to.
+    # @param scope_id [string] The Id of the OAuth scope to retrieve.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def retrieve_o_auth_scope(application_id, scope_id)
+      start.uri('/api/application')
+          .url_segment(application_id)
+          .url_segment("scope")
+          .url_segment(scope_id)
+          .get()
+          .go()
+    end
+
     #
     # Retrieves the Oauth2 configuration for the application for the given Application Id.
     #
@@ -4322,6 +4388,23 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Updates the OAuth scope with the given Id for the application.
+    #
+    # @param application_id [string] The Id of the application that the OAuth scope belongs to.
+    # @param scope_id [string] The Id of the OAuth scope to update.
+    # @param request [OpenStruct, Hash] The request that contains all the new OAuth scope information.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def update_o_auth_scope(application_id, scope_id, request)
+      start.uri('/api/application')
+          .url_segment(application_id)
+          .url_segment("scope")
+          .url_segment(scope_id)
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .put()
+          .go()
+    end
+
     #
     # Updates the registration for the user with the given Id and the application defined in the request.
     #

data/lib/fusionauth/rest_client.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2023, FusionAuth, All Rights Reserved
+# Copyright (c) 2019-2024, FusionAuth, All Rights Reserved
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fusionauth_client
 version: !ruby/object:Gem::Version
-  version: 1.49.1
+  version: 1.50.0
 platform: ruby
 authors:
 - Brian Pontarelli
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-03-07 00:00:00.000000000 Z
+date: 2024-04-25 00:00:00.000000000 Z
 dependencies: []
 description: This library contains the Ruby client library that helps you connect
   your application to FusionAuth.
@@ -20,18 +20,68 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
+- ".github/fusionauth/.env"
+- ".github/fusionauth/docker-compose.yml"
+- ".github/fusionauth/kickstart.json"
+- ".github/workflows/docs.yml"
+- ".github/workflows/test.yml"
 - ".gitignore"
 - ".ruby-version"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.adoc
+- README.md
 - Rakefile
 - build.savant
+- doc/FusionAuth.html
 - doc/FusionAuth.md
+- doc/FusionAuth/FusionAuthClient.html
 - doc/FusionAuth/FusionAuthClient.md
 - doc/created.rid
-- doc/index.db
+- doc/css/fonts.css
+- doc/css/rdoc.css
+- doc/fonts/Lato-Light.ttf
+- doc/fonts/Lato-LightItalic.ttf
+- doc/fonts/Lato-Regular.ttf
+- doc/fonts/Lato-RegularItalic.ttf
+- doc/fonts/SourceCodePro-Bold.ttf
+- doc/fonts/SourceCodePro-Regular.ttf
+- doc/images/add.png
+- doc/images/arrow_up.png
+- doc/images/brick.png
+- doc/images/brick_link.png
+- doc/images/bug.png
+- doc/images/bullet_black.png
+- doc/images/bullet_toggle_minus.png
+- doc/images/bullet_toggle_plus.png
+- doc/images/date.png
+- doc/images/delete.png
+- doc/images/find.png
+- doc/images/loadingAnimation.gif
+- doc/images/macFFBgHack.png
+- doc/images/package.png
+- doc/images/page_green.png
+- doc/images/page_white_text.png
+- doc/images/page_white_width.png
+- doc/images/plugin.png
+- doc/images/ruby.png
+- doc/images/tag_blue.png
+- doc/images/tag_green.png
+- doc/images/transparent.png
+- doc/images/wrench.png
+- doc/images/wrench_orange.png
+- doc/images/zoom.png
+- doc/index.html
+- doc/js/darkfish.js
+- doc/js/navigation.js
+- doc/js/navigation.js.gz
+- doc/js/search.js
+- doc/js/search_index.js
+- doc/js/search_index.js.gz
+- doc/js/searcher.js
+- doc/js/searcher.js.gz
+- doc/table_of_contents.html
 - examples/create_user.rb
 - examples/login.rb
 - fusionauth-ruby-client.iml

data/README.adoc

@@ -1,106 +0,0 @@
-== FusionAuth::FusionAuthClient
-
-This gem is the Ruby client library that helps connect Ruby applications to the FusionAuth (https://fusionauth.io) Identity and User Management platform.
-
-== Getting Started
-
-=== Installation
-
-Add this line to your application’s Gemfile:
-
-[source,ruby]
-----
-gem 'fusionauth_client'
-----
-
-And then execute:
-
-[source,shell]
-----
-bundle
-----
-
-Or install it yourself as:
-
-[source,shell]
-----
-gem install fusionauth_client
-----
-
-=== Usage
-
-Once the gem is installed, you can call FusionAuth APIs.
-
-[source,ruby]
-----
-require 'fusionauth/fusionauth_client'
-require 'securerandom'
-require 'pp'
-
-# Construct the FusionAuth Client
-client = FusionAuth::FusionAuthClient.new(
-    'REPLACE_ME',
-    'http://localhost:9011'
-)
-
-application_id = '85a03867-dccf-4882-adde-1a79aeec50df'
-
-# Create a user + registration
-id = SecureRandom.uuid
-response = client.register(id, {
-    user: {
-        firstName: 'Ruby',
-        lastName: 'User',
-        email: 'ruby_user@example.com',
-        password: 'password'
-    },
-    registration: {
-        applicationId: application_id,
-        data: {
-            foo: 'bar'
-        },
-        preferredLanguages: %w(en fr),
-        roles: %w(dev)
-    }
-})
-
-#pp response
-if response.success_response
-  pp response.success_response
-else
-  if response.exception
-    # if we can't connect
-    print response.exception
-  end
-  print "status: #{response.status}"
-  print response.error_response
-  exit
-end
-----
-
-== Documentation
-
-Documentation can be found at https://github.com/FusionAuth/fusionauth-ruby-client/tree/master/doc[doc].
-
-=== Questions and support
-
-If you have a question or support issue regarding this client library, we’d love to hear from you.
-
-If you have a paid edition with support included, please https://account.fusionauth.io/account/support/[open a ticket in your account portal]. Learn more about https://fusionauth.io/pricing[paid editions here].
-
-Otherwise, please https://fusionauth.io/community/forum/[post your question in the community forum].
-
-=== Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/FusionAuth/fusionauth-ruby-client.
-
-All issues filed in this repository must abide by the [FusionAuth community guidelines](https://fusionauth.io/community/forum/topic/1000/code-of-conduct).
-
-=== License
-
-This code is available as open source under the terms of the https://opensource.org/licenses/Apache-2.0[Apache v2.0 License].
-
-//tag::forDocSite[]
-
-//end::forDocSite[]
-