indie_flags 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 48ad1b3474f96cb021eade2c8f175d23c5c5a103bd016d94e5a499357df74252
+  data.tar.gz: 55b3114150143bac53540dd64033e105c45bdda897374cf27cd4b42614246044
+SHA512:
+  metadata.gz: c6de3713329dfa1a23f9e74513731f497f674b06cd85519204ccb25924e9bd91ab6786796d8d0ae3d62ab6e4aee8a7dcb53fa8aeeb4d6b35b4ca793efc711dc2
+  data.tar.gz: 0c3bb58577fd781214bc44f82d0d9cb9b85438f570ad1d50e85b07cd40524838a6227f4fc1f0628ca38d326850f1f944378aeb7d07fd7f608620260a562f4012

data/lib/indie_flags.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module IndieFlags
+  DEFAULT_BASE_URL = "https://api.indieflags.dev"
+  DEFAULT_CACHE_TTL_SEC = 60
+
+  class Client
+    def initialize(api_key:, base_url: nil, env: "production", email: nil, cache_ttl_sec: DEFAULT_CACHE_TTL_SEC)
+      @api_key = api_key.to_s.strip
+      raise ArgumentError, "IndieFlags: api_key is required" if @api_key.empty?
+
+      @base_url = (base_url || DEFAULT_BASE_URL).to_s.chomp("/")
+      @env = (env || "production").to_s.strip.downcase
+      @env = "production" if @env.empty?
+      @email = email.to_s.strip.empty? ? nil : email.to_s.strip
+      @cache_ttl_sec = cache_ttl_sec
+      @cache = nil
+      @cache_fetched_at = 0
+      @mutex = Mutex.new
+    end
+
+    # Fetch all flags and cache. Call once at startup.
+    def init
+      flags = fetch_all_flags
+      if @cache_ttl_sec > 0
+        @mutex.synchronize do
+          @cache = flags
+          @cache_fetched_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        end
+      end
+      flags
+    end
+
+    def enabled?(flag_key)
+      get_value(flag_key) == true
+    end
+
+    def get_value(flag_key)
+      key = normalize_key(flag_key)
+      cached = get_from_cache
+      return cached[key] if cached && cached.key?(key)
+
+      single = fetch_single_flag(key)
+      return single unless single.nil?
+
+      false
+    end
+
+    def invalidate_cache
+      @mutex.synchronize { @cache = nil }
+    end
+
+    private
+
+    def normalize_key(raw)
+      raw.to_s.strip.downcase.tr(" ", "").tr("_", "-")
+    end
+
+    def get_from_cache
+      return nil if @cache_ttl_sec <= 0
+
+      @mutex.synchronize do
+        return nil if @cache.nil?
+        return nil if (Process.clock_gettime(Process::CLOCK_MONOTONIC) - @cache_fetched_at) > @cache_ttl_sec
+
+        @cache
+      end
+    end
+
+    def request(path, query = {})
+      uri = URI("#{@base_url}#{path}")
+      uri.query = URI.encode_www_form(query) unless query.empty?
+      req = Net::HTTP::Get.new(uri)
+      req["X-Api-Key"] = @api_key
+      req["X-Environment"] = @env
+      req["X-Flag-Email"] = @email if @email
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
+      return nil if res.code == "404"
+
+      raise "IndieFlags: #{res.code} #{res.body}" unless res.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(res.body)
+    end
+
+    def fetch_all_flags
+      q = { "apiKey" => @api_key, "env" => @env }
+      q["email"] = @email if @email
+      data = request("/eval/flags", q)
+      return {} unless data
+      return {} unless data["flags"].is_a?(Hash)
+
+      data["flags"].transform_values do |v|
+        v.is_a?(String) ? v : !!v
+      end
+    end
+
+    def fetch_single_flag(flag_key)
+      q = { "apiKey" => @api_key, "flag" => flag_key, "env" => @env }
+      q["email"] = @email if @email
+      data = request("/eval", q)
+      return false unless data
+      return data["value"] if data.key?("value")
+
+      data["enabled"] == true
+    end
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: indie_flags
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Minimalab
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-02-26 00:00:00.000000000 Z
+dependencies: []
+description: is_enabled, get_value, optional 60s cache. Indie Flags API.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/indie_flags.rb
+homepage: https://indieflags.minimalab.ai
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/byminimalab/indieflags-api
+  documentation_uri: https://indieflags.minimalab.ai/docs
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Feature flags client for Indie Flags
+test_files: []