vortex-ruby-sdk 1.3.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef46095579ff2ce432423b52947fe7b09bcbac70a9aeaaa72c28245f79aee801
-  data.tar.gz: b71a185023f2593be2fd5adfa28771eb281de595b8539b023a60448119b29a7b
+  metadata.gz: c4007275edb1f0eeffa2386fa04e11236f7a12402ad3169c729f4d5bd73faa6b
+  data.tar.gz: 0ce765593b51887883c4de24671481fcca207285e4314625914b485f199d65b5
 SHA512:
-  metadata.gz: f9fee1a62aa03ee7184bf596b13644f48bb3df7a6164eec8bae3be10ebe9f66e21c848410831a09ff99136d01a023aa7bebdbbe9cdf95c7333d7a55a94bd58ed
-  data.tar.gz: 315cdc79b63d0f79563d25e9568df67043245cd8c3d230ef79e322b02c39c7559eb3f5613f0c575b946b01f651397052e1ca8aa76ec51683bec5988a7b2445d2
+  metadata.gz: c537cdd1f516a455cd01e648d5f6e62fc7ece380d604480d4b618b0168186fbd01f441b4bf6072c48bf8ad367a5a45bdf287b81d6f337c2e0cbeddcf7fb2667c
+  data.tar.gz: fa0e660c5faf465511c1fa5fb43fdd6ee8648d35ed95e96c48e2efb79d79586186be4dc39c90a8c9397dcfbd86581565cca8cfccc794cf3ed52e490793f30ac4

data/README.md

@@ -47,7 +47,9 @@ client = Vortex::Client.new(ENV['VORTEX_API_KEY'])
 user = {
   id: 'user-123',
   email: 'user@example.com',
-  admin_scopes: ['autojoin']  # Optional - included as adminScopes array in JWT
+  user_name: 'Jane Doe',                                    # Optional: user's display name
+  user_avatar_url: 'https://example.com/avatars/jane.jpg',  # Optional: user's avatar URL
+  admin_scopes: ['autojoin']                                # Optional: grants autojoin admin privileges
 }
 
 # Generate JWT
@@ -63,22 +65,6 @@ client.accept_invitations(['inv1', 'inv2'], { type: 'email', value: 'user@exampl
 group_invitations = client.get_invitations_by_group('team', 'team1')
 ```
 
-### Generate JWT with Additional Properties
-
-```ruby
-user = {
-  id: 'user-123',
-  email: 'user@example.com'
-}
-
-extra = {
-  role: 'admin',
-  department: 'Engineering'
-}
-
-jwt = client.generate_jwt(user: user, extra: extra)
-```
-
 ## Rails Integration
 
 Create a controller with Vortex routes:

data/lib/vortex/client.rb

@@ -81,13 +81,13 @@ module Vortex
       }
 
       # Add name if present (convert snake_case to camelCase for JWT)
-      if user[:name]
-        payload[:name] = user[:name]
+      if user[:user_name]
+        payload[:userName] = user[:user_name]
       end
 
-      # Add avatarUrl if present (convert snake_case to camelCase for JWT)
-      if user[:avatar_url]
-        payload[:avatarUrl] = user[:avatar_url]
+      # Add userAvatarUrl if present (convert snake_case to camelCase for JWT)
+      if user[:user_avatar_url]
+        payload[:userAvatarUrl] = user[:user_avatar_url]
       end
 
       # Add adminScopes if present
@@ -303,17 +303,23 @@ module Vortex
     # @param inviter [Hash] The inviter info: { user_id: '...', user_email: '...', name: '...' }
     # @param groups [Array<Hash>, nil] Optional groups: [{ type: '...', group_id: '...', name: '...' }]
     # @param source [String, nil] Optional source for analytics (defaults to 'api')
+    # @param subtype [String, nil] Optional subtype for analytics segmentation (e.g., 'pymk', 'find-friends')
     # @param template_variables [Hash, nil] Optional template variables for email customization
     # @param metadata [Hash, nil] Optional metadata passed through to webhooks
+    # @param unfurl_config [Hash, nil] Optional link unfurl (Open Graph) config: { title: '...', description: '...', image: '...', type: '...', site_name: '...' }
     # @return [Hash] Created invitation with :id, :short_link, :status, :created_at
     # @raise [VortexError] If the request fails
     #
-    # @example Create an email invitation
+    # @example Create an email invitation with custom link preview
     #   result = client.create_invitation(
     #     'widget-config-123',
     #     { type: 'email', value: 'invitee@example.com' },
     #     { user_id: 'user-456', user_email: 'inviter@example.com', name: 'John Doe' },
-    #     [{ type: 'team', group_id: 'team-789', name: 'Engineering' }]
+    #     [{ type: 'team', group_id: 'team-789', name: 'Engineering' }],
+    #     nil,
+    #     nil,
+    #     nil,
+    #     { title: 'Join the team!', description: 'You have been invited', image: 'https://example.com/og.png' }
     #   )
     #
     # @example Create an internal invitation (PYMK flow - no email sent)
@@ -324,7 +330,7 @@ module Vortex
     #     nil,
     #     'pymk'
     #   )
-    def create_invitation(widget_configuration_id, target, inviter, groups = nil, source = nil, template_variables = nil, metadata = nil)
+    def create_invitation(widget_configuration_id, target, inviter, groups = nil, source = nil, subtype = nil, template_variables = nil, metadata = nil, unfurl_config = nil)
       raise VortexError, 'widget_configuration_id is required' if widget_configuration_id.nil? || widget_configuration_id.empty?
       raise VortexError, 'target must have type and value' if target[:type].nil? || target[:value].nil?
       raise VortexError, 'inviter must have user_id' if inviter[:user_id].nil?
@@ -336,8 +342,8 @@ module Vortex
         inviter: {
           userId: inviter[:user_id],
           userEmail: inviter[:user_email],
-          name: inviter[:name],
-          avatarUrl: inviter[:avatar_url]
+          userName: inviter[:user_name],
+          userAvatarUrl: inviter[:user_avatar_url]
         }.compact
       }
 
@@ -352,8 +358,18 @@ module Vortex
       end
 
       body[:source] = source if source
+      body[:subtype] = subtype if subtype
       body[:templateVariables] = template_variables if template_variables
       body[:metadata] = metadata if metadata
+      if unfurl_config
+        body[:unfurlConfig] = {
+          title: unfurl_config[:title],
+          description: unfurl_config[:description],
+          image: unfurl_config[:image],
+          type: unfurl_config[:type],
+          siteName: unfurl_config[:site_name]
+        }.compact
+      end
 
       response = @connection.post('/api/v1/invitations') do |req|
         req.headers['Content-Type'] = 'application/json'
@@ -367,6 +383,81 @@ module Vortex
       raise VortexError, "Failed to create invitation: #{e.message}"
     end
 
+    # Get autojoin domains configured for a specific scope
+    #
+    # @param scope_type [String] The type of scope (e.g., "organization", "team", "project")
+    # @param scope [String] The scope identifier (customer's group ID)
+    # @return [Hash] Response with :autojoin_domains array and :invitation
+    # @raise [VortexError] If the request fails
+    #
+    # @example
+    #   result = client.get_autojoin_domains('organization', 'acme-org')
+    #   result['autojoinDomains'].each do |domain|
+    #     puts "Domain: #{domain['domain']}"
+    #   end
+    def get_autojoin_domains(scope_type, scope)
+      encoded_scope_type = URI.encode_www_form_component(scope_type)
+      encoded_scope = URI.encode_www_form_component(scope)
+
+      response = @connection.get("/api/v1/invitations/by-scope/#{encoded_scope_type}/#{encoded_scope}/autojoin")
+      handle_response(response)
+    rescue VortexError
+      raise
+    rescue => e
+      raise VortexError, "Failed to get autojoin domains: #{e.message}"
+    end
+
+    # Configure autojoin domains for a specific scope
+    #
+    # This endpoint syncs autojoin domains - it will add new domains, remove domains
+    # not in the provided list, and deactivate the autojoin invitation if all domains
+    # are removed (empty array).
+    #
+    # @param scope [String] The scope identifier (customer's group ID)
+    # @param scope_type [String] The type of scope (e.g., "organization", "team")
+    # @param domains [Array<String>] Array of domains to configure for autojoin
+    # @param widget_id [String] The widget configuration ID
+    # @param scope_name [String, nil] Optional display name for the scope
+    # @param metadata [Hash, nil] Optional metadata to attach to the invitation
+    # @return [Hash] Response with :autojoin_domains array and :invitation
+    # @raise [VortexError] If the request fails
+    #
+    # @example
+    #   result = client.configure_autojoin(
+    #     'acme-org',
+    #     'organization',
+    #     ['acme.com', 'acme.org'],
+    #     'widget-123',
+    #     'Acme Corporation'
+    #   )
+    def configure_autojoin(scope, scope_type, domains, widget_id, scope_name = nil, metadata = nil)
+      raise VortexError, 'scope is required' if scope.nil? || scope.empty?
+      raise VortexError, 'scope_type is required' if scope_type.nil? || scope_type.empty?
+      raise VortexError, 'widget_id is required' if widget_id.nil? || widget_id.empty?
+      raise VortexError, 'domains must be an array' unless domains.is_a?(Array)
+
+      body = {
+        scope: scope,
+        scopeType: scope_type,
+        domains: domains,
+        widgetId: widget_id
+      }
+
+      body[:scopeName] = scope_name if scope_name
+      body[:metadata] = metadata if metadata
+
+      response = @connection.post('/api/v1/invitations/autojoin') do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = JSON.generate(body)
+      end
+
+      handle_response(response)
+    rescue VortexError
+      raise
+    rescue => e
+      raise VortexError, "Failed to configure autojoin: #{e.message}"
+    end
+
     private
 
     def build_connection

data/lib/vortex/types.rb

@@ -60,6 +60,21 @@ module Vortex
     #     groups: [INVITATION_GROUP, ...],
     #     # ... other fields
     #   }
+    # InvitationTarget represents the target of an invitation
+    # @example
+    #   {
+    #     type: 'email',         # 'email', 'phone', 'share', or 'internal'
+    #     value: 'user@example.com',
+    #     name: 'Jane Smith',    # Optional: Display name of the person being invited
+    #     avatarUrl: 'https://...' # Optional: Avatar URL for display in invitation lists
+    #   }
+    INVITATION_TARGET = {
+      type: String,       # Required: 'email', 'phone', 'share', or 'internal'
+      value: String,      # Required: Email, phone, or internal ID
+      name: String,       # Optional: Display name of the person being invited
+      avatarUrl: String   # Optional: Avatar URL for the person being invited
+    }.freeze
+
     INVITATION = {
       id: String,
       accountId: String,
@@ -74,7 +89,7 @@ module Vortex
       invitationType: String,
       modifiedAt: String,
       status: String,
-      target: Array, # of { type: String, value: String }
+      target: Array, # of INVITATION_TARGET structures
       views: Integer,
       widgetConfigurationId: String,
       projectId: String,
@@ -83,5 +98,61 @@ module Vortex
       expired: :boolean,
       expires: String # ISO 8601 timestamp (optional)
     }.freeze
+
+    # CreateInvitationTarget for creating invitations
+    # @example
+    #   {
+    #     type: 'email',
+    #     value: 'invitee@example.com',
+    #     name: 'Jane Smith',       # Optional
+    #     avatarUrl: 'https://...'  # Optional
+    #   }
+    CREATE_INVITATION_TARGET = {
+      type: String,       # Required: 'email', 'phone', or 'internal'
+      value: String,      # Required: Email, phone, or internal ID
+      name: String,       # Optional: Display name of the person being invited
+      avatarUrl: String   # Optional: Avatar URL for the person being invited
+    }.freeze
+
+    # AutojoinDomain structure for autojoin domain configuration
+    # @example
+    #   {
+    #     id: '550e8400-e29b-41d4-a716-446655440000',
+    #     domain: 'acme.com'
+    #   }
+    AUTOJOIN_DOMAIN = {
+      id: String,     # Vortex internal UUID
+      domain: String  # The domain configured for autojoin
+    }.freeze
+
+    # AutojoinDomainsResponse from autojoin API endpoints
+    # @example
+    #   {
+    #     autojoinDomains: [AUTOJOIN_DOMAIN, ...],
+    #     invitation: INVITATION  # or nil
+    #   }
+    AUTOJOIN_DOMAINS_RESPONSE = {
+      autojoinDomains: Array,  # Array of AUTOJOIN_DOMAIN structures
+      invitation: Hash         # INVITATION structure or nil
+    }.freeze
+
+    # ConfigureAutojoinRequest for configuring autojoin domains
+    # @example
+    #   {
+    #     scope: 'acme-org',
+    #     scopeType: 'organization',
+    #     scopeName: 'Acme Corporation',  # Optional
+    #     domains: ['acme.com', 'acme.org'],
+    #     widgetId: 'widget-123',
+    #     metadata: { ... }  # Optional
+    #   }
+    CONFIGURE_AUTOJOIN_REQUEST = {
+      scope: String,       # Required: Customer's group ID
+      scopeType: String,   # Required: Type of scope (e.g., "organization", "team")
+      scopeName: String,   # Optional: Display name for the scope
+      domains: Array,      # Required: Array of domain strings
+      widgetId: String,    # Required: Widget configuration ID
+      metadata: Hash       # Optional: Metadata to attach to the invitation
+    }.freeze
   end
 end

data/lib/vortex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vortex
-  VERSION = '1.3.0'
+  VERSION = '1.6.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vortex-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Vortex Software
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-28 00:00:00.000000000 Z
+date: 2026-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday