vortex-ruby-sdk 1.1.3 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2f54f415260bef01b6106dc5d32cf274e4b9c45e00cdd89e18ad6dfbc1df177
-  data.tar.gz: 32e1ab2a8a7bc1ee1a3a683d82832a301f4e3403289a64ff8eea4c77410dc104
+  metadata.gz: ef46095579ff2ce432423b52947fe7b09bcbac70a9aeaaa72c28245f79aee801
+  data.tar.gz: b71a185023f2593be2fd5adfa28771eb281de595b8539b023a60448119b29a7b
 SHA512:
-  metadata.gz: 61262106b17af91ce480f7fac66a79a9d4bf2b7b77c264eba92ea07bf7a82967991e3629b59c84f0edbed77054a4f3f9ac661f9a101a4e28f8dd1efc16deafe9
-  data.tar.gz: efc03cda77c4d08a66ef056da5d6c72930ce0003bd6418e2cb145a6a95930e0895f7057d4e864c6c78ca7c5a69ac05dca35d0d6e17ea1aec01e480d795244a32
+  metadata.gz: f9fee1a62aa03ee7184bf596b13644f48bb3df7a6164eec8bae3be10ebe9f66e21c848410831a09ff99136d01a023aa7bebdbbe9cdf95c7333d7a55a94bd58ed
+  data.tar.gz: 315cdc79b63d0f79563d25e9568df67043245cd8c3d230ef79e322b02c39c7559eb3f5613f0c575b946b01f651397052e1ca8aa76ec51683bec5988a7b2445d2

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to the Vortex Ruby SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-01-23
+
+### Added
+- **Internal Invitations**: New `'internal'` delivery type for customer-managed invitations
+  - Support for `deliveryTypes: ['internal']`
+  - No email/SMS communication triggered by Vortex
+  - Target value can be any customer-defined identifier
+  - Useful for in-app invitation flows managed by customer's application
+
+### Changed
+- Updated `deliveryTypes` field documentation to include `'internal'` as a valid value
+
 ## [1.1.3] - 2025-01-29
 
 ### Added

data/README.md

@@ -12,6 +12,8 @@ A Ruby SDK for the Vortex invitation system, providing seamless integration with
 - **Same Route Structure**: Ensures React provider compatibility
 - **Comprehensive Testing**: Full test coverage with RSpec
 - **Type Safety**: Clear method signatures and documentation
+- **Multiple Delivery Types**: Support for `email`, `phone`, `share`, and `internal` invitation delivery
+  - `internal` invitations allow for customer-managed, in-app invitation flows with no external communication
 
 ## Installation
 

data/lib/vortex/client.rb

@@ -80,6 +80,16 @@ module Vortex
         expires: expires
       }
 
+      # Add name if present (convert snake_case to camelCase for JWT)
+      if user[:name]
+        payload[:name] = user[:name]
+      end
+
+      # Add avatarUrl if present (convert snake_case to camelCase for JWT)
+      if user[:avatar_url]
+        payload[:avatarUrl] = user[:avatar_url]
+      end
+
       # Add adminScopes if present
       if user[:admin_scopes]
         payload[:adminScopes] = user[:admin_scopes]
@@ -204,7 +214,7 @@ module Vortex
         case target_type
         when 'email'
           user[:email] = target_value
-        when 'sms', 'phoneNumber'
+        when 'phone', 'phoneNumber'
           user[:phone] = target_value
         else
           # For other types, try to use as email
@@ -277,6 +287,86 @@ module Vortex
       raise VortexError, "Failed to reinvite: #{e.message}"
     end
 
+    # Create an invitation from your backend
+    #
+    # This method allows you to create invitations programmatically using your API key,
+    # without requiring a user JWT token. Useful for server-side invitation creation,
+    # such as "People You May Know" flows or admin-initiated invitations.
+    #
+    # Target types:
+    # - 'email': Send an email invitation
+    # - 'phone': Create a phone invitation (short link returned for you to send)
+    # - 'internal': Create an internal invitation for PYMK flows (no email sent)
+    #
+    # @param widget_configuration_id [String] The widget configuration ID to use
+    # @param target [Hash] The invitation target: { type: 'email|sms|internal', value: '...' }
+    # @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 template_variables [Hash, nil] Optional template variables for email customization
+    # @param metadata [Hash, nil] Optional metadata passed through to webhooks
+    # @return [Hash] Created invitation with :id, :short_link, :status, :created_at
+    # @raise [VortexError] If the request fails
+    #
+    # @example Create an email invitation
+    #   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' }]
+    #   )
+    #
+    # @example Create an internal invitation (PYMK flow - no email sent)
+    #   result = client.create_invitation(
+    #     'widget-config-123',
+    #     { type: 'internal', value: 'internal-user-abc' },
+    #     { user_id: 'user-456' },
+    #     nil,
+    #     'pymk'
+    #   )
+    def create_invitation(widget_configuration_id, target, inviter, groups = nil, source = nil, template_variables = nil, metadata = 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?
+
+      # Build request body with camelCase keys for the API
+      body = {
+        widgetConfigurationId: widget_configuration_id,
+        target: target,
+        inviter: {
+          userId: inviter[:user_id],
+          userEmail: inviter[:user_email],
+          name: inviter[:name],
+          avatarUrl: inviter[:avatar_url]
+        }.compact
+      }
+
+      if groups && !groups.empty?
+        body[:groups] = groups.map do |g|
+          {
+            type: g[:type],
+            groupId: g[:group_id],
+            name: g[:name]
+          }
+        end
+      end
+
+      body[:source] = source if source
+      body[:templateVariables] = template_variables if template_variables
+      body[:metadata] = metadata if metadata
+
+      response = @connection.post('/api/v1/invitations') 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 create invitation: #{e.message}"
+    end
+
     private
 
     def build_connection

data/lib/vortex/types.rb

@@ -69,7 +69,7 @@ module Vortex
       createdAt: String,
       deactivated: :boolean,
       deliveryCount: Integer,
-      deliveryTypes: Array, # of String
+      deliveryTypes: Array, # of String - valid values: "email", "phone", "share", "internal"
       foreignCreatorId: String,
       invitationType: String,
       modifiedAt: String,

data/lib/vortex/version.rb

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

metadata

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