mamatech_external_sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c7d3d1744027cd9f7cfaf6778d027ceaa89a5aef3476417b98d0935f3b52b666
+  data.tar.gz: 90e2ec1a39df046d8e10b3c2b8a235a61750a75acd41759ec192db0ed21484b2
+SHA512:
+  metadata.gz: 67640a4c505246e863f3edcd60693f9b771d1707df044e7da837c962f7488376fc5bf67c326ff41a97eb3290bad320589c6c739ebf787cfe7c6101f3e5c5a141
+  data.tar.gz: 1393772e7d01340541830233dc3bd39a8217e0b6c3486c8db7a57ff8945906435d97914441cf86e649221d5e3930c8ed2d802cbb30837223c725e865a835ff3a

data/lib/mamatech_external_sdk/client.rb

@@ -0,0 +1,101 @@
+require "json"
+require "net/http"
+require "uri"
+
+module Mamatech
+  module ExternalSdk
+  class Client
+    DEFAULT_BASE_URL = "https://api.fin.io".freeze
+
+    def initialize(base_url: nil, app_code: nil, secret_key: nil)
+      @base_url = base_url || ENV.fetch("FIN_BASE_URL", DEFAULT_BASE_URL)
+      @app_code = app_code || ENV.fetch("FIN_APP_CODE", "")
+      @secret_key = secret_key || ENV.fetch("FIN_SECRET_KEY", "")
+      raise ArgumentError, "FIN_APP_CODE and FIN_SECRET_KEY are required" if @app_code.empty? || @secret_key.empty?
+    end
+
+    def create_external_user(first_name:, last_name:, third_party_id:, language: nil)
+      payload = {
+        firstName: first_name,
+        lastName: last_name,
+        thirdPartyId: third_party_id,
+        code: @app_code,
+        secretKey: @secret_key
+      }
+      payload[:language] = language unless language.nil?
+      request_json("/auth/v1/external/user", "POST", payload)
+    end
+
+    def login_external_user(third_party_id:)
+      request_json("/auth/v1/external/login", "POST", {
+        thirdPartyId: third_party_id,
+        code: @app_code,
+        secretKey: @secret_key
+      })
+    end
+
+    def renew_token(token:)
+      request_json("/api/v1/external/renew", "POST", nil, token: token)
+    end
+
+    def get_context(token:)
+      request_json("/api/v1/external/context", "GET", nil, token: token)
+    end
+
+    def list_people(token:)
+      request_json("/api/v1/person/all", "GET", nil, token: token)
+    end
+
+    def get_messages(token:, limit: 20, offset: 0)
+      request_json("/api/v1/conversations/external/messages?limit=#{limit}&offset=#{offset}", "GET", nil, token: token)
+    end
+
+    def send_message(token:, text:, security_header: nil)
+      request_stream("/api/v1/conversations/external/message", { text: text }, token: token, security_header: security_header)
+    end
+
+    def submit_secure_input(token:, field:, value:, security_header: nil)
+      request_stream("/api/v1/conversations/external/secure-input", { field: field, value: value }, token: token, security_header: security_header)
+    end
+
+    private
+
+    def request_json(path, method, payload, token: nil, security_header: nil)
+      body = send_request(path, method, payload, token: token, security_header: security_header)
+      body.nil? || body.empty? ? {} : JSON.parse(body)
+    end
+
+    def request_stream(path, payload, token:, security_header: nil)
+      body = send_request(path, "POST", payload, token: token, security_header: security_header)
+      body.lines.map(&:strip).reject(&:empty?)
+    end
+
+    def send_request(path, method, payload, token: nil, security_header: nil)
+      uri = URI.join(@base_url, path)
+      request = build_request(uri, method, payload)
+      request["Authorization"] = "Bearer #{token}" unless token.nil? || token.empty?
+      request["life-graph"] = security_header unless security_header.nil? || security_header.empty?
+      request["Content-Type"] = "application/json"
+
+      response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+        http.request(request)
+      end
+
+      return response.body if response.code.to_i.between?(200, 299)
+
+      raise Error.new("FIN request failed for #{path}", response.code.to_i, response.body.to_s)
+    end
+
+    def build_request(uri, method, payload)
+      request_class = case method
+                      when "GET" then Net::HTTP::Get
+                      when "POST" then Net::HTTP::Post
+                      else raise ArgumentError, "unsupported method #{method}"
+                      end
+      request = request_class.new(uri)
+      request.body = JSON.generate(payload) unless payload.nil?
+      request
+    end
+  end
+end
+end

data/lib/mamatech_external_sdk/error.rb

@@ -0,0 +1,13 @@
+module Mamatech
+  module ExternalSdk
+  class Error < StandardError
+    attr_reader :status, :body
+
+    def initialize(message, status, body)
+      super(message)
+      @status = status
+      @body = body
+    end
+  end
+end
+end

data/lib/mamatech_external_sdk.rb

@@ -0,0 +1,2 @@
+require_relative "mamatech_external_sdk/client"
+require_relative "mamatech_external_sdk/error"

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: mamatech_external_sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- FIN Connect
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-01 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mamatech_external_sdk.rb
+- lib/mamatech_external_sdk/client.rb
+- lib/mamatech_external_sdk/error.rb
+homepage:
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Server-side SDK for FIN external APIs
+test_files: []