source_license_sdk 1.0.0

data/lib/source_license_sdk/machine_identifier.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+require 'digest'
+require 'socket'
+
+# Generates unique machine identifiers for license activation
+class SourceLicenseSDK::MachineIdentifier
+  class << self
+    # Generate a unique machine identifier
+    def generate
+      components = []
+
+      # Get hostname
+      components << hostname
+
+      # Get MAC addresses
+      components.concat(mac_addresses)
+
+      # Get CPU info if available
+      components << cpu_info if cpu_info
+
+      # Get motherboard info if available
+      components << motherboard_info if motherboard_info
+
+      # Get disk serial if available
+      components << disk_serial if disk_serial
+
+      # Create hash from all components
+      raw_id = components.compact.join('|')
+      Digest::SHA256.hexdigest(raw_id)[0..31] # First 32 characters
+    end
+
+    # Generate machine fingerprint (more detailed than machine ID)
+    def generate_fingerprint
+      components = []
+
+      # Basic system info
+      components << hostname
+      components << ruby_version
+      components << platform
+
+      # Network info
+      components.concat(mac_addresses)
+      components << local_ip
+
+      # Hardware info
+      components << cpu_info if cpu_info
+      components << memory_info if memory_info
+      components << disk_info if disk_info
+
+      # Environment info
+      components << environment_hash
+
+      raw_fingerprint = components.compact.join('|')
+      Digest::SHA256.hexdigest(raw_fingerprint)
+    end
+
+    private
+
+    def hostname
+      Socket.gethostname
+    rescue StandardError
+      'unknown-host'
+    end
+
+    def mac_addresses
+      addresses = []
+
+      case RUBY_PLATFORM
+      when /darwin/i
+        # macOS
+        output = `ifconfig 2>/dev/null`
+        addresses = output.scan(/ether ([a-f0-9:]{17})/i).flatten
+      when /linux/i
+        # Linux
+        output = `ip link show 2>/dev/null || ifconfig 2>/dev/null`
+        addresses = output.scan(/(?:ether|HWaddr)\s+([a-f0-9:]{17})/i).flatten
+      when /mswin|mingw|cygwin/i
+        # Windows
+        output = `getmac /fo csv /nh 2>nul`
+        addresses = output.scan(/"([A-F0-9-]{17})"/i).flatten.map { |addr| addr.tr('-', ':').downcase }
+      end
+
+      # Filter out virtual/invalid addresses
+      addresses.select { |addr| addr && !addr.start_with?('00:00:00') && addr != '02:00:00:00:00:00' }
+    rescue StandardError
+      []
+    end
+
+    def cpu_info
+      case RUBY_PLATFORM
+      when /darwin/i
+        `sysctl -n machdep.cpu.brand_string 2>/dev/null`.strip
+      when /linux/i
+        info = `cat /proc/cpuinfo 2>/dev/null | grep "model name" | head -1`.strip
+        info.split(':').last&.strip if info.include?(':')
+      when /mswin|mingw|cygwin/i
+        `wmic cpu get name /value 2>nul | findstr "Name="`.strip.split('=').last
+      end
+    rescue StandardError
+      nil
+    end
+
+    def motherboard_info
+      case RUBY_PLATFORM
+      when /darwin/i
+        `system_profiler SPHardwareDataType 2>/dev/null | grep "Serial Number"`.strip
+      when /linux/i
+        `sudo dmidecode -s baseboard-serial-number 2>/dev/null`.strip
+      when /mswin|mingw|cygwin/i
+        `wmic baseboard get serialnumber /value 2>nul | findstr "SerialNumber="`.strip.split('=').last
+      end
+    rescue StandardError
+      nil
+    end
+
+    def disk_serial
+      case RUBY_PLATFORM
+      when /darwin/i
+        `diskutil info / 2>/dev/null | grep "Volume UUID"`.strip.split(':').last&.strip
+      when /linux/i
+        `lsblk -dno SERIAL 2>/dev/null | head -1`.strip
+      when /mswin|mingw|cygwin/i
+        `wmic diskdrive get serialnumber /value 2>nul | findstr "SerialNumber="`.strip.split('=').last
+      end
+    rescue StandardError
+      nil
+    end
+
+    def ruby_version
+      RUBY_VERSION
+    end
+
+    def platform
+      RUBY_PLATFORM
+    end
+
+    def local_ip
+      # Get local IP by connecting to a remote address (doesn't actually send data)
+      Socket.ip_address_list.find(&:ipv4_private?)&.ip_address
+    rescue StandardError
+      '127.0.0.1'
+    end
+
+    def memory_info
+      case RUBY_PLATFORM
+      when /darwin/i
+        `sysctl -n hw.memsize 2>/dev/null`.strip
+      when /linux/i
+        `cat /proc/meminfo 2>/dev/null | grep MemTotal`.strip.split.last
+      when /mswin|mingw|cygwin/i
+        output = `wmic computersystem get TotalPhysicalMemory /value 2>nul | findstr "TotalPhysicalMemory="`
+        output.strip.split('=').last
+      end
+    rescue StandardError
+      nil
+    end
+
+    def disk_info
+      case RUBY_PLATFORM
+      when /darwin/i, /linux/i
+        `df -h / 2>/dev/null | tail -1`.strip.split.first
+      when /mswin|mingw|cygwin/i
+        `wmic logicaldisk get size,caption /value 2>nul | findstr "Size=" | head -1`.strip.split('=').last
+      end
+    rescue StandardError
+      nil
+    end
+
+    def environment_hash
+      # Hash of relevant environment variables (non-sensitive)
+      env_vars = %w[HOME USER USERNAME PATH SHELL]
+      env_data = env_vars.map { |var| "#{var}=#{ENV.fetch(var, nil)}" }.join('|')
+      Digest::SHA256.hexdigest(env_data)[0..15] # First 16 characters
+    rescue StandardError
+      'unknown-env'
+    end
+  end
+end

data/lib/source_license_sdk/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SourceLicenseSDK
+  VERSION = '1.0.0'
+end

data/lib/source_license_sdk.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require_relative 'source_license_sdk/version'
+require_relative 'source_license_sdk/client'
+require_relative 'source_license_sdk/machine_identifier'
+require_relative 'source_license_sdk/license_validator'
+require_relative 'source_license_sdk/exceptions'
+
+module SourceLicenseSDK
+  # Configure the SDK with your Source-License server details
+  def self.configure
+    yield(configuration)
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  # Quick setup method for common use cases
+  def self.setup(server_url:, license_key:, machine_id: nil, auto_generate_machine_id: true)
+    configure do |config|
+      config.server_url = server_url
+      config.license_key = license_key
+      config.machine_id = machine_id
+      config.auto_generate_machine_id = auto_generate_machine_id
+    end
+  end
+
+  # Validate license (method 1)
+  def self.validate_license(license_key = nil, machine_id: nil)
+    license_key ||= configuration.license_key
+    machine_id ||= configuration.machine_id
+
+    raise ConfigurationError, 'License key is required' if license_key.nil? || license_key.empty?
+
+    client = Client.new(configuration)
+    client.validate_license(license_key, machine_id: machine_id)
+  end
+
+  # Activate license (method 2)
+  def self.activate_license(license_key = nil, machine_id: nil)
+    license_key ||= configuration.license_key
+    machine_id ||= configuration.machine_id ||
+                   (configuration.auto_generate_machine_id ? MachineIdentifier.generate : nil)
+
+    raise ConfigurationError, 'License key is required' if license_key.nil? || license_key.empty?
+    raise ConfigurationError, 'Machine ID is required for activation' if machine_id.nil? || machine_id.empty?
+
+    client = Client.new(configuration)
+    client.activate_license(license_key, machine_id: machine_id)
+  end
+
+  # Enforce license check - exits application if license is invalid (method 3)
+  def self.enforce_license!(license_key = nil, machine_id: nil, exit_code: 1, custom_message: nil)
+    license_key ||= configuration.license_key
+    machine_id ||= configuration.machine_id
+
+    begin
+      result = validate_license(license_key, machine_id: machine_id)
+
+      unless result.valid?
+        message = custom_message || "License validation failed: #{result.error_message}"
+        puts "[LICENSE ERROR] #{message}"
+        exit(exit_code)
+      end
+
+      result
+    rescue SourceLicenseSDK::Error => e
+      message = custom_message || "License check failed: #{e.message}"
+      puts "[LICENSE ERROR] #{message}"
+      exit(exit_code)
+    end
+  end
+
+  class Configuration
+    attr_accessor :server_url, :license_key, :machine_id, :auto_generate_machine_id,
+                  :timeout, :user_agent, :verify_ssl
+
+    def initialize
+      @server_url = nil
+      @license_key = nil
+      @machine_id = nil
+      @auto_generate_machine_id = true
+      @timeout = 30
+      @user_agent = "SourceLicenseSDK/#{VERSION}"
+      @verify_ssl = true
+    end
+
+    def valid?
+      !server_url.nil? && !server_url.empty?
+    end
+  end
+end

data/source_license_sdk.gemspec

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative 'lib/source_license_sdk/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'source_license_sdk'
+  spec.version       = SourceLicenseSDK::VERSION
+  spec.authors       = ['PixelRidge Softworks']
+  spec.email         = ['support@pixelridgesoftworks.com']
+
+  spec.summary       = 'Ruby SDK for Source-License platform'
+  spec.description   = 'A Ruby gem for easy integration with Source-License platform for license ' \
+                       'validation and activation'
+  spec.homepage      = 'https://github.com/PixelRidgeSoftworks/Source-License'
+  spec.license       = 'GPL-3.0-or-later'
+  spec.required_ruby_version = '>= 3.4.4'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/PixelRidgeSoftworks/Source-License/tree/main/SL_Ruby_SDK'
+  spec.metadata['changelog_uri'] = 'https://github.com/PixelRidgeSoftworks/Source-License/blob/main/SL_Ruby_SDK/CHANGELOG.md'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  # Specify which files should be added to the gem when it is released.
+  # Use cross-platform compatible file detection
+  spec.files = Dir.glob(%w[
+    lib/**/*.rb
+    README.md
+    CHANGELOG.md
+    LICENSE
+    Gemfile
+    Rakefile
+    source_license_sdk.gemspec
+  ]).select { |f| File.file?(f) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Dependencies
+  spec.add_dependency 'digest', '~> 3.0'
+  spec.add_dependency 'json', '~> 2.0'
+  spec.add_dependency 'net-http', '~> 0.1'
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: source_license_sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- PixelRidge Softworks
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: digest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: A Ruby gem for easy integration with Source-License platform for license
+  validation and activation
+email:
+- support@pixelridgesoftworks.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/source_license_sdk.rb
+- lib/source_license_sdk/client.rb
+- lib/source_license_sdk/exceptions.rb
+- lib/source_license_sdk/license_validator.rb
+- lib/source_license_sdk/machine_identifier.rb
+- lib/source_license_sdk/version.rb
+- source_license_sdk.gemspec
+homepage: https://github.com/PixelRidgeSoftworks/Source-License
+licenses:
+- GPL-3.0-or-later
+metadata:
+  homepage_uri: https://github.com/PixelRidgeSoftworks/Source-License
+  source_code_uri: https://github.com/PixelRidgeSoftworks/Source-License/tree/main/SL_Ruby_SDK
+  changelog_uri: https://github.com/PixelRidgeSoftworks/Source-License/blob/main/SL_Ruby_SDK/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Ruby SDK for Source-License platform
+test_files: []