ltfi-wsap 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 536cc508c0e7e2a1484888424a584e6f5a931e03e9574946db818d9e198b985a
+  data.tar.gz: 7cc640ef494612844d4a8a65e755c67709a8209a8b7cfcd571e133898f2f0e60
+SHA512:
+  metadata.gz: 3a13497eeff01e27c55bdb022c482551a634c7fbb437b7f8f7ad7768dc314090a5acdad05cc11af32cf0652a2e4b29e72d96c2669ab161bf1ec8f55afeff8687
+  data.tar.gz: 8e37dc7fa548ff3a4d93998ed821c43f58876af4ea6375d5117a9cc9a50bb99e4caa866d5c0a83e3b9b768fdb89ad5ae68cd2c7540e66f7221cc4f9ae12413d4

data/LICENSE

@@ -0,0 +1,37 @@
+MIT License
+
+Copyright (c) 2025 Kief Studio, MA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+LTFI-WSAP SERVICE USAGE NOTICE:
+
+This SDK is open source and free to use. However, usage of the LTFI-WSAP 
+service itself is subject to the LTFI-WSAP Terms of Service:
+
+- FREE for most users and use cases
+- FREE for personal use, open source projects, and small businesses
+- Paid plans required for:
+  - Enterprises with annual revenue exceeding $1M USD
+  - Organizations managing more than 100 domains
+  - High-volume API usage (see pricing at https://wsap.ltfi.ai/pricing)
+
+For details, visit https://wsap.ltfi.ai/terms

data/README.md

@@ -0,0 +1,76 @@
+<div align="center">
+  <img src="https://github.com/KiefStudioMA/LTFI-WSAP/raw/main/assets/KS-FullLogo-DarkGrey-300dpi.png#gh-light-mode-only" alt="Kief Studio" height="80">
+  <img src="https://github.com/KiefStudioMA/LTFI-WSAP/raw/main/assets/KS-FullLogo-LightSilver-300dpi.png#gh-dark-mode-only" alt="Kief Studio" height="80">
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="https://github.com/KiefStudioMA/LTFI-WSAP/raw/main/assets/LTFI-Logo.png#gh-light-mode-only" alt="LTFI" height="80">
+  <img src="https://github.com/KiefStudioMA/LTFI-WSAP/raw/main/assets/LTFI-Logo-White.png#gh-dark-mode-only" alt="LTFI" height="80">
+</div>
+
+# LTFI-WSAP Ruby SDK
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/KiefStudioMA/ltfi-wsap-ruby/blob/main/LICENSE)
+[![LTFI-WSAP](https://img.shields.io/badge/LTFI--WSAP-v2.0.0-blue.svg)](https://wsap.ltfi.ai)
+[![Kief Studio](https://img.shields.io/badge/By-Kief%20Studio-green.svg)](https://kief.studio)
+
+Official Ruby SDK for **LTFI-WSAP** (Layered Transformer Framework Intelligence - Web System Alignment Protocol) by **Kief Studio**.
+
+Part of the [LTFI Ecosystem](https://ltfi.ai) • [WSAP Protocol](https://wsap.ltfi.ai)
+
+## 📦 Installation
+
+See the [main repository](https://github.com/KiefStudioMA/LTFI-WSAP) for installation instructions.
+
+## 📚 Documentation
+
+- **Main Documentation**: [docs.ltfi.ai](https://docs.ltfi.ai)
+- **API Reference**: [api.ltfi.ai/docs](https://api.ltfi.ai/docs)
+- **Examples**: [github.com/KiefStudioMA/LTFI-WSAP-Examples](https://github.com/KiefStudioMA/LTFI-WSAP-Examples)
+
+## 🔑 Quick Start
+
+```bash
+# Get your API key from https://wsap.ltfi.ai
+export LTFI_WSAP_API_KEY="your-api-key"
+```
+
+## 📄 License
+
+**MIT License** - This SDK is open source and free to use.
+
+See [LICENSE](LICENSE) for full terms.
+
+### LTFI-WSAP Service Usage
+
+While this SDK is open source, the LTFI-WSAP service has the following usage terms:
+
+- ✅ **FREE** for personal use, open source projects, and small businesses
+- ✅ **FREE** for most users and use cases
+- 💳 **Paid plans** required for:
+  - Enterprises with annual revenue exceeding $1M USD
+  - Organizations managing more than 100 domains
+  - High-volume API usage
+
+For pricing details: [wsap.ltfi.ai/pricing](https://wsap.ltfi.ai/pricing)
+
+- **Technical Support**: developers@kief.studio
+- **Business Inquiries**: business@kief.studio
+- **Discord**: [discord.gg/JfjyUdjJgP](https://discord.gg/JfjyUdjJgP)
+- **X (Twitter)**: [x.com/kief_ma](https://x.com/kief_ma)
+- **LinkedIn**: [linkedin.com/company/kief-studio](https://www.linkedin.com/company/kief-studio/)
+
+---
+
+<div align="center">
+  <br>
+  <img src="https://github.com/KiefStudioMA/LTFI-WSAP/raw/main/assets/KS-icon-black-1024.png#gh-light-mode-only" alt="Kief Studio" width="64">
+  <img src="https://github.com/KiefStudioMA/LTFI-WSAP/raw/main/assets/KS-icon-white-1024.png#gh-dark-mode-only" alt="Kief Studio" width="64">
+  <br><br>
+  
+  **Built with ❤️ by [Kief Studio](https://kief.studio)**
+  
+  Part of the [LTFI Ecosystem](https://ltfi.ai) • [WSAP Protocol](https://wsap.ltfi.ai)
+  
+  © 2025 Kief Studio, MA. All rights reserved.
+  
+  **Open Source SDK - Service usage subject to terms**
+</div>

data/lib/ltfi_wsap/client.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module LTFI
+  module WSAP
+    class Client
+      attr_reader :api_key, :base_url, :timeout
+
+      def initialize(api_key: nil, base_url: nil, timeout: nil)
+        @api_key = api_key || ENV["LTFI_WSAP_API_KEY"] || LTFI::WSAP.configuration&.api_key
+        @base_url = base_url || LTFI::WSAP.configuration&.base_url || "https://api.ltfi.ai"
+        @timeout = timeout || LTFI::WSAP.configuration&.timeout || 30
+
+        raise AuthenticationError, "API key required: set LTFI_WSAP_API_KEY or provide in config" if @api_key.nil? || @api_key.empty?
+      end
+
+      # List entities with optional filters
+      def list_entities(params = {})
+        response = connection.get("/api/entities/", params)
+        handle_response(response)
+      end
+
+      # Get a specific entity
+      def get_entity(id)
+        response = connection.get("/api/entities/#{id}/")
+        handle_response(response)
+      end
+
+      # Create a new entity
+      def create_entity(data)
+        response = connection.post("/api/entities/") do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.body = data.to_json
+        end
+        handle_response(response)
+      end
+
+      # Update an entity
+      def update_entity(id, data)
+        response = connection.put("/api/entities/#{id}/") do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.body = data.to_json
+        end
+        handle_response(response)
+      end
+
+      # Delete an entity
+      def delete_entity(id)
+        response = connection.delete("/api/entities/#{id}/")
+        handle_response(response)
+      end
+
+      # Initiate domain verification
+      def initiate_verification(domain, method = "dns_txt")
+        response = connection.post("/api/verification/initiate/") do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.body = { domain: domain, method: method }.to_json
+        end
+        handle_response(response)
+      end
+
+      # Check domain verification status
+      def verify_domain(domain)
+        response = connection.post("/api/verification/verify/") do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.body = { domain: domain }.to_json
+        end
+        
+        if response.success?
+          data = JSON.parse(response.body)
+          data["verified"]
+        else
+          false
+        end
+      end
+
+      # Generate WSAP data
+      def generate_wsap(entity_id, disclosure_level = "STANDARD")
+        response = connection.post("/api/wsap/generate/") do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.body = {
+            entity_id: entity_id,
+            disclosure_level: disclosure_level.upcase
+          }.to_json
+        end
+        handle_response(response)
+      end
+
+      # Fetch public WSAP data
+      def fetch_wsap(domain)
+        response = connection.get("/api/wsap/public/#{domain}/")
+        handle_response(response)
+      end
+
+      # Get current user
+      def get_current_user
+        response = connection.get("/api/auth/me/")
+        handle_response(response)
+      end
+
+      # Health check
+      def health_check
+        response = connection.get("/api/health/")
+        handle_response(response)
+      end
+
+      private
+
+      def connection
+        @connection ||= Faraday.new(url: base_url) do |faraday|
+          faraday.request :authorization, "Bearer", api_key
+          faraday.request :retry, max: 3, interval: 0.5
+          faraday.adapter Faraday.default_adapter
+          faraday.headers["User-Agent"] = "LTFI-WSAP-Ruby/2.0.0"
+          faraday.options.timeout = timeout
+        end
+      end
+
+      def handle_response(response)
+        case response.status
+        when 200..299
+          JSON.parse(response.body) if response.body && !response.body.empty?
+        when 401
+          raise AuthenticationError, "Authentication failed: #{response.body}"
+        when 404
+          raise NotFoundError, "Resource not found: #{response.body}"
+        when 400..499
+          raise ClientError, "Client error (#{response.status}): #{response.body}"
+        when 500..599
+          raise ServerError, "Server error (#{response.status}): #{response.body}"
+        else
+          raise APIError, "Unexpected error (#{response.status}): #{response.body}"
+        end
+      end
+    end
+  end
+end

data/lib/ltfi_wsap.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/retry"
+require "json"
+
+require_relative "ltfi_wsap/version"
+require_relative "ltfi_wsap/configuration"
+require_relative "ltfi_wsap/client"
+require_relative "ltfi_wsap/errors"
+require_relative "ltfi_wsap/models/entity"
+require_relative "ltfi_wsap/models/verification"
+require_relative "ltfi_wsap/models/wsap_data"
+require_relative "ltfi_wsap/models/user"
+
+module LTFI
+  module WSAP
+    class << self
+      attr_accessor :configuration
+
+      def configure
+        self.configuration ||= Configuration.new
+        yield(configuration) if block_given?
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: ltfi-wsap
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Kief Studio
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-09-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.56'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.56'
+description: Official Ruby SDK for LTFI-WSAP (Layered Transformer Framework Intelligence
+  - Web System Alignment Protocol) API
+email:
+- developers@kief.studio
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/ltfi_wsap.rb
+- lib/ltfi_wsap/client.rb
+homepage: https://github.com/KiefStudioMA/LTFI-WSAP-Ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/KiefStudioMA/LTFI-WSAP-Ruby
+  source_code_uri: https://github.com/KiefStudioMA/LTFI-WSAP-Ruby
+  changelog_uri: https://github.com/KiefStudioMA/LTFI-WSAP-Ruby/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.15
+signing_key:
+specification_version: 4
+summary: LTFI-WSAP Ruby SDK
+test_files: []