firehose-rb 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3400d6b686eb7ea407bd385951304b1898629e2ed396baec585528728da7b2d
-  data.tar.gz: 7ecaa46e86e08f063219eeed945c7bf2b2c9819e8e27374cb3dfbc85906eb073
+  metadata.gz: 6fa8dc1d77ce7ec26e1db82f13a26094970b1294388bf2e0c0b4c7aa266f9c5d
+  data.tar.gz: b2f8784af1ad95c67cb5467607ba546ad6bd183a243367b124576865705eb398
 SHA512:
-  metadata.gz: 86bd6635074e868f78d67caff1c3f6ef5c175545dfcbfdf6bdc2ef642147631d2bd48bbad401bc4b8a4b3eee96dadcc87737aec3c95b5daaac8711ccbf8b8816
-  data.tar.gz: 8ff3e1afa478900d65569c4260177016df775bb3829a3c3361897c8d4ff97e3b6c0221c2c6dc979cace6964ef0e95976ca823cfe96001302cbe87bfb78fe5770
+  metadata.gz: 58c1f5933095b7f2ab7a82c3559643241398aa3524e477340f0a62199b9a4478229fccdc66d928570c59e4f054082adb25775bbbd313fc0725dccafdc8996304
+  data.tar.gz: 7bf960e0a49fb20b142126bafcbc538565e5e1fa91bc170e38994835bbd0d550c07c35d7b38f8b106452c0b243b31742ac1021aaedabf8941dbba6d78c6cd8c7

data/lib/firehose/client.rb

@@ -10,28 +10,83 @@ module Firehose
       @stream = Stream.new(config: config)
     end
 
-    # Rules CRUD
+    # Tap management (requires management key)
 
-    def create_rule(value:, tag: nil, quality: false, nsfw: false)
-      body = { value: value, tag: tag, quality: quality, nsfw: nsfw }.compact
-      response = management_connection.post("/rules", body.to_json)
+    def list_taps
+      response = management_connection.get("/v1/taps")
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      Array(parsed["data"]).map { |t| Tap.from_hash(t) }
+    end
+
+    def create_tap(name:)
+      response = management_connection.post("/v1/taps", { name: name }.to_json)
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      tap_data = parsed["data"] || parsed
+      tap_data["token"] = parsed["token"] if parsed["token"]
+      Tap.from_hash(tap_data)
+    end
+
+    def get_tap(tap_id)
+      response = management_connection.get("/v1/taps/#{tap_id}")
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      Tap.from_hash(parsed["data"] || parsed)
+    end
+
+    def update_tap(tap_id, name:)
+      response = management_connection.put("/v1/taps/#{tap_id}", { name: name }.to_json)
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      Tap.from_hash(parsed["data"] || parsed)
+    end
+
+    def revoke_tap(tap_id)
+      response = management_connection.delete("/v1/taps/#{tap_id}")
       handle_response(response)
-      Rule.from_hash(JSON.parse(response.body))
+      true
     end
 
+    # Rules CRUD (requires tap token)
+
     def list_rules
-      response = management_connection.get("/rules")
+      response = tap_connection.get("/v1/rules")
       handle_response(response)
-      JSON.parse(response.body).map { |r| Rule.from_hash(r) }
+      parsed = JSON.parse(response.body)
+      Array(parsed["data"] || parsed).map { |r| Rule.from_hash(r) }
+    end
+
+    def create_rule(value:, tag: nil, quality: true, nsfw: false)
+      body = { value: value, tag: tag, quality: quality, nsfw: nsfw }.compact
+      response = tap_connection.post("/v1/rules", body.to_json)
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      Rule.from_hash(parsed["data"] || parsed)
+    end
+
+    def get_rule(rule_id)
+      response = tap_connection.get("/v1/rules/#{rule_id}")
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      Rule.from_hash(parsed["data"] || parsed)
+    end
+
+    def update_rule(rule_id, value: nil, tag: nil, quality: nil, nsfw: nil)
+      body = { value: value, tag: tag, quality: quality, nsfw: nsfw }.compact
+      response = tap_connection.put("/v1/rules/#{rule_id}", body.to_json)
+      handle_response(response)
+      parsed = JSON.parse(response.body)
+      Rule.from_hash(parsed["data"] || parsed)
     end
 
     def delete_rule(rule_id)
-      response = management_connection.delete("/rules/#{rule_id}")
+      response = tap_connection.delete("/v1/rules/#{rule_id}")
       handle_response(response)
       true
     end
 
-    # Streaming
+    # Streaming (requires tap token)
 
     def stream(since: nil, &block)
       raise ArgumentError, "block required" unless block_given?
@@ -57,10 +112,18 @@ module Firehose
       end
     end
 
+    def tap_connection
+      @tap_connection ||= Faraday.new(url: @config.base_url) do |f|
+        f.headers["Authorization"] = "Bearer #{@config.tap_token}"
+        f.headers["Content-Type"] = "application/json"
+        f.adapter Faraday.default_adapter
+      end
+    end
+
     def handle_response(response)
       case response.status
       when 200..299 then nil
-      when 401, 403 then raise AuthenticationError, "Invalid management key"
+      when 401, 403 then raise AuthenticationError, "Invalid API key"
       when 429 then raise RateLimitError, "Rate limited"
       else raise Error, "HTTP #{response.status}: #{response.body}"
       end

data/lib/firehose/stream.rb

@@ -77,7 +77,7 @@ module Firehose
     end
 
     def build_uri(since: nil)
-      uri = URI.join(@config.base_url, "/stream")
+      uri = URI.join(@config.base_url, "/v1/stream")
       params = {}
       params["since"] = since if since
       uri.query = URI.encode_www_form(params) if params.any?

data/lib/firehose/tap.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Firehose
+  Tap = Data.define(:id, :name, :token, :token_prefix, :rules_count, :last_used_at, :created_at) do
+    def initialize(id:, name:, token: nil, token_prefix: nil, rules_count: 0, last_used_at: nil, created_at: nil)
+      super
+    end
+
+    def self.from_hash(hash)
+      new(
+        id: hash["id"] || hash[:id],
+        name: hash["name"] || hash[:name],
+        token: hash["token"] || hash[:token],
+        token_prefix: hash["token_prefix"] || hash[:token_prefix],
+        rules_count: hash["rules_count"] || hash[:rules_count] || 0,
+        last_used_at: hash["last_used_at"] || hash[:last_used_at],
+        created_at: hash["created_at"] || hash[:created_at]
+      )
+    end
+  end
+end

data/lib/firehose.rb

@@ -2,6 +2,7 @@
 
 require_relative "firehose/error"
 require_relative "firehose/rule"
+require_relative "firehose/tap"
 require_relative "firehose/document"
 require_relative "firehose/event"
 require_relative "firehose/stream"
@@ -12,7 +13,7 @@ module Firehose
     attr_accessor :management_key, :tap_token, :base_url, :timeout
 
     def initialize
-      @base_url = "https://api.firehose.dev"
+      @base_url = "https://api.firehose.com"
       @timeout = 300
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: firehose-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Nauman Tariq
@@ -51,8 +51,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.18'
-description: SSE streaming client with rules CRUD, auto-reconnect, and offset tracking
-  for the Firehose API.
+description: Full-featured Ruby client for the Firehose API — tap management, rules
+  CRUD (create, read, update, delete), SSE streaming with auto-reconnect and offset
+  tracking.
 email:
 - nauman@intellecta.co
 executables: []
@@ -67,6 +68,7 @@ files:
 - lib/firehose/event.rb
 - lib/firehose/rule.rb
 - lib/firehose/stream.rb
+- lib/firehose/tap.rb
 homepage: https://github.com/nauman/firehose-rb
 licenses:
 - MIT