clowk 0.1.0

data/lib/clowk/sdk/session.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Clowk
+  module SDK
+    class Session < Resource
+      def self.resource_path
+        'sessions'
+      end
+    end
+  end
+end

data/lib/clowk/sdk/subdomain.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Clowk
+  module SDK
+    class Subdomain < Resource
+      def self.resource_path
+        'instances'
+      end
+
+      def find_by_pk(key = nil)
+        return if key.blank?
+
+        search(publishable_key: key)
+      end
+    end
+  end
+end

data/lib/clowk/sdk/token.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Clowk
+  module SDK
+    class Token < Resource
+      def self.resource_path
+        'tokens'
+      end
+
+      def verify(token:)
+        client.post("#{self.class.resource_path}/verify", { token: token })
+      end
+    end
+  end
+end

data/lib/clowk/sdk/user.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Clowk
+  module SDK
+    class User < Resource
+      def self.resource_path
+        'users'
+      end
+    end
+  end
+end

data/lib/clowk/subdomain.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Clowk
+  class Subdomain
+    CACHE_TTL = 60
+    DEFAULT_SUBDOMAIN_BASE = 'clowk.dev'
+
+    class << self
+      def resolve_url!(...)
+        new(...).resolve_url!
+      end
+
+      def clear_cache!
+        @cache = {}
+      end
+
+      def read_cache(key)
+        entry = cache[key]
+
+        return unless entry
+        return entry[:value] if entry[:expires_at] > Time.now
+
+        cache.delete(key)
+        nil
+      end
+
+      def write_cache(key, value, ttl:)
+        cache[key] = {
+          value: value,
+          expires_at: Time.now + ttl
+        }
+      end
+
+      private
+
+      def cache
+        @cache ||= {}
+      end
+    end
+
+    def initialize(options = {})
+      @publishable_key = options.fetch(:publishable_key, Clowk.config.publishable_key)
+      @api_base_url = options.fetch(:api_base_url, Clowk.config.api_base_url)
+      @subdomain_url = options.fetch(:subdomain_url, Clowk.config.subdomain_url)
+    end
+
+    def resolve_url!
+      return resolve_from_key if publishable_key.present?
+      return normalize_url(subdomain_url) if subdomain_url.present?
+
+      raise ConfigurationError, 'set publishable_key or subdomain_url to build Clowk URLs'
+    end
+
+    private
+
+    attr_reader :api_base_url, :publishable_key, :subdomain_url
+
+    def resolve_from_key
+      cached = self.class.read_cache(cache_key)
+      return cached if cached
+
+      response = client.subdomains.find_by_pk(publishable_key)
+      resolved = extract_url_from_instance(response.body_parsed)
+
+      raise ConfigurationError, 'could not resolve subdomain_url from publishable_key' if resolved.blank?
+
+      self.class.write_cache(cache_key, resolved, ttl: CACHE_TTL)
+      resolved
+    end
+
+    def cache_key
+      "instance-url:#{publishable_key}"
+    end
+
+    def extract_url_from_instance(payload)
+      return if payload.blank?
+
+      instance = payload.is_a?(Hash) ? payload : {}
+      instance_data = instance['instance'].is_a?(Hash) ? instance['instance'] : instance
+
+      explicit_url = instance_data['url'] || instance_data['subdomain_url'] || instance_data['instance_url']
+      return normalize_url(explicit_url) if explicit_url.present?
+
+      host = instance_data['host'] || instance_data['domain'] || instance_data['hostname']
+      return normalize_url(host_to_url(host)) if host.present?
+
+      subdomain = instance_data['subdomain']
+      normalize_url("https://#{subdomain}.#{default_subdomain_base}") if subdomain.present?
+    end
+
+    def host_to_url(host)
+      value = host.to_s
+      return value if value.start_with?('http://', 'https://')
+
+      "https://#{value}"
+    end
+
+    def default_subdomain_base
+      configured = subdomain_url.to_s.strip
+      return DEFAULT_SUBDOMAIN_BASE if configured.empty?
+
+      uri = URI.parse(configured)
+      return DEFAULT_SUBDOMAIN_BASE if uri.host.blank?
+
+      uri.host.split('.').drop(1).join('.')
+    rescue URI::InvalidURIError
+      DEFAULT_SUBDOMAIN_BASE
+    end
+
+    def normalize_url(value)
+      value.to_s.sub(%r{/$}, '')
+    end
+
+    def client
+      @client ||= Clowk::SDK::Client.new
+    end
+  end
+end

data/lib/clowk/version.rb

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

data/lib/clowk.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'rails'
+require 'rails/engine'
+require 'action_controller/railtie'
+require 'active_support'
+require 'active_support/core_ext/hash'
+require 'active_support/core_ext/object/blank'
+require 'rack'
+
+require_relative 'clowk/version'
+require_relative 'clowk/configuration'
+
+module Clowk
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class InvalidStateError < Error; end
+  class InvalidTokenError < Error; end
+
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def configure
+      yield(config)
+    end
+
+    def reset!
+      Subdomain.clear_cache! if defined?(Subdomain)
+      @config = Configuration.new
+    end
+  end
+end
+
+require_relative 'clowk/current'
+require_relative 'clowk/http/response'
+require_relative 'clowk/http/logger_middleware'
+require_relative 'clowk/http/retry_middleware'
+require_relative 'clowk/http/timeout_middleware'
+require_relative 'clowk/http/client'
+require_relative 'clowk/sdk/resource'
+require_relative 'clowk/sdk/user'
+require_relative 'clowk/sdk/session'
+require_relative 'clowk/sdk/subdomain'
+require_relative 'clowk/sdk/token'
+require_relative 'clowk/sdk/client'
+require_relative 'clowk/subdomain'
+require_relative 'clowk/jwt_verifier'
+require_relative 'clowk/helpers/url_helpers'
+require_relative 'clowk/middleware/token_extractor'
+require_relative 'clowk/authenticable'
+require_relative 'clowk/controllers/base_controller'
+require_relative 'clowk/controllers/callbacks_controller'
+require_relative 'clowk/controllers/sessions_controller'
+require_relative 'clowk/engine'

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: clowk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Clowk
+bindir: bin
+cert_chain: []
+date: 2026-03-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.13'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.13'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Clowk Authentication, JWT verification, and future API access
+email:
+- support@clowk.in
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- clowk.gemspec
+- config/routes.rb
+- lib/clowk.rb
+- lib/clowk/authenticable.rb
+- lib/clowk/configuration.rb
+- lib/clowk/controllers/base_controller.rb
+- lib/clowk/controllers/callbacks_controller.rb
+- lib/clowk/controllers/sessions_controller.rb
+- lib/clowk/current.rb
+- lib/clowk/engine.rb
+- lib/clowk/helpers/url_helpers.rb
+- lib/clowk/http/client.rb
+- lib/clowk/http/logger_middleware.rb
+- lib/clowk/http/response.rb
+- lib/clowk/http/retry_middleware.rb
+- lib/clowk/http/timeout_middleware.rb
+- lib/clowk/jwt_verifier.rb
+- lib/clowk/middleware/token_extractor.rb
+- lib/clowk/sdk/client.rb
+- lib/clowk/sdk/resource.rb
+- lib/clowk/sdk/session.rb
+- lib/clowk/sdk/subdomain.rb
+- lib/clowk/sdk/token.rb
+- lib/clowk/sdk/user.rb
+- lib/clowk/subdomain.rb
+- lib/clowk/version.rb
+homepage: https://clowk.in
+licenses:
+- AGPL-3.0
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Rails SDK for Clowk authentication
+test_files: []