reputable 0.1.17 → 0.1.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8767ca87c7fdd5abc6584e738599020cbd6977bc6193371caeef1425eedb8dfd
-  data.tar.gz: 5196f00349ec3b380bec72db3b98c5f09d08965d297e7f43a8c639b9d1eed3dd
+  metadata.gz: ffc332f72eed47a768d73dae0cac8a2efbbf73de0b41115fcf064ac046cfcc93
+  data.tar.gz: 42abaea0b5b896a54611ebc43946751fc2a303c62f94d4d199345afe846d88a1
 SHA512:
-  metadata.gz: 36285df97965903af8e913d3f0937969ae4e48399f0468fd2e00b22d3b0e7c6d50d51682d9ec82a31483729ca7f0d69d4d0ec47115b12dce62ff01948d18b3ec
-  data.tar.gz: 6aea15486988795b5ce444581be796e33d15906c871f5cc28208d876b0604053603f455f8d16536b4879773991905f85882f56b4fed47d85b71b1ea9abb34a42
+  metadata.gz: f2fd4c2f08d86b89a19d0676d372f4b63f71ad70fe6c426c313e25cf48786544c6ca58ae729981ed4525d9dd8881c757b8c07810ea7984e405c133e82608ed23
+  data.tar.gz: 8e16c4839f384c4dbd4709996efab5e542a8f792522e283b2f3fcdb2db1eab2f13e149556f2f369ef23dc73d2cef7da83515fb95e69eca8a8e86de041afc4544

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    reputable (0.1.17)
+    reputable (0.1.19)
       connection_pool (~> 2.2)
       redis (>= 4.0, < 6.0)
 

data/README.md

@@ -501,6 +501,33 @@ Reputable.lookup_reputation(:ip, request.ip)
 #      expires_at: 0, metadata: { order_id: "123" } }
 ```
 
+### ASN Reputation
+
+Apply and lookup reputations for entire ASNs (Autonomous System Numbers). Useful for blocking datacenter traffic or known-bad networks.
+
+```ruby
+# Apply reputation to an ASN
+Reputable.block_asn("15169", reason: "datacenter_abuse")
+Reputable.challenge_asn("7922", reason: "suspicious_traffic")
+Reputable.trust_asn("16509", reason: "known_partner")
+Reputable.ignore_asn("32934", reason: "internal_monitoring")
+
+# Quick boolean checks
+Reputable.blocked_asn?("15169")    # => true/false
+Reputable.challenged_asn?("7922")  # => true/false
+Reputable.trusted_asn?("16509")    # => true/false
+
+# Get status string
+Reputable.lookup_asn("15169")
+# => "untrusted_block" or nil
+
+# Full lookup with metadata
+Reputable.lookup_reputation(:asn, "15169")
+# => { status: "untrusted_block", reason: "datacenter_abuse", ... }
+```
+
+**Note:** ASNs are normalized automatically - both `"15169"` and `"AS15169"` work.
+
 ---
 
 ## User Verification & Trust Flow

data/lib/reputable/reputation.rb

@@ -205,8 +205,113 @@ module Reputable
         lookup_ip(ip) == "untrusted_challenge"
       end
 
+      # ========================================================================
+      # ASN LOOKUP METHODS
+      # ========================================================================
+
+      # Quick lookup for ASN reputation status
+      # Returns just the status string (or nil)
+      # ASN is normalized (strips "AS" prefix if present)
+      #
+      # @param asn [String] ASN (e.g., "15169" or "AS15169")
+      # @return [String, nil] Status string or nil
+      #
+      # @example
+      #   status = Reputable::Reputation.lookup_asn("15169")
+      #   # => "untrusted_block" or nil
+      def lookup_asn(asn)
+        result = lookup(:asn, normalize_asn(asn))
+        result&.dig(:status)
+      end
+
+      # Check if an ASN is trusted (any trusted_* status)
+      #
+      # @param asn [String] ASN
+      # @return [Boolean] Returns false if disabled, nil lookup, or not trusted
+      def trusted_asn?(asn)
+        status = lookup_asn(asn)
+        return false if status.nil?
+        
+        status.start_with?("trusted")
+      end
+
+      # Check if an ASN should be blocked
+      #
+      # @param asn [String] ASN
+      # @return [Boolean]
+      def blocked_asn?(asn)
+        lookup_asn(asn) == "untrusted_block"
+      end
+
+      # Check if an ASN should be challenged
+      #
+      # @param asn [String] ASN
+      # @return [Boolean]
+      def challenged_asn?(asn)
+        lookup_asn(asn) == "untrusted_challenge"
+      end
+
+      # ========================================================================
+      # ASN APPLY CONVENIENCE METHODS
+      # ========================================================================
+
+      # Convenience method: Trust an ASN (behavioral by default)
+      def trust_asn(asn, reason: "manual_trust", status: :trusted_behavior, ttl: nil, **metadata)
+        apply(
+          entity_type: :asn,
+          entity_id: normalize_asn(asn),
+          status: status,
+          reason: reason,
+          ttl: ttl,
+          metadata: metadata
+        )
+      end
+
+      # Convenience method: Block an ASN
+      def block_asn(asn, reason: "manual_block", ttl: nil, **metadata)
+        apply(
+          entity_type: :asn,
+          entity_id: normalize_asn(asn),
+          status: :untrusted_block,
+          reason: reason,
+          ttl: ttl,
+          metadata: metadata
+        )
+      end
+
+      # Convenience method: Challenge an ASN (CAPTCHA, etc.)
+      def challenge_asn(asn, reason: "suspicious_traffic", ttl: nil, **metadata)
+        apply(
+          entity_type: :asn,
+          entity_id: normalize_asn(asn),
+          status: :untrusted_challenge,
+          reason: reason,
+          ttl: ttl,
+          metadata: metadata
+        )
+      end
+
+      # Convenience method: Mark ASN to be ignored in analytics
+      def ignore_asn(asn, reason: "datacenter_traffic", ttl: nil, **metadata)
+        apply(
+          entity_type: :asn,
+          entity_id: normalize_asn(asn),
+          status: :untrusted_ignore,
+          reason: reason,
+          ttl: ttl,
+          metadata: metadata
+        )
+      end
+
       private
 
+      # Normalize ASN by stripping "AS" prefix if present
+      # @param asn [String] ASN with or without prefix
+      # @return [String] ASN without prefix
+      def normalize_asn(asn)
+        asn.to_s.sub(/^AS/i, "")
+      end
+
       def valid_entity_type?(entity_type)
         VALID_ENTITY_TYPES.include?(entity_type.to_sym)
       end

data/lib/reputable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Reputable
-  VERSION = "0.1.17"
+  VERSION = "0.1.19"
 end

data/lib/reputable.rb

@@ -126,6 +126,39 @@ module Reputable
       Reputation.challenged_ip?(ip)
     end
 
+    # Delegate ASN reputation methods to Reputation module
+    def lookup_asn(asn)
+      Reputation.lookup_asn(asn)
+    end
+
+    def trusted_asn?(asn)
+      Reputation.trusted_asn?(asn)
+    end
+
+    def blocked_asn?(asn)
+      Reputation.blocked_asn?(asn)
+    end
+
+    def challenged_asn?(asn)
+      Reputation.challenged_asn?(asn)
+    end
+
+    def trust_asn(asn, reason: "manual_trust", status: :trusted_behavior, ttl: nil, **metadata)
+      Reputation.trust_asn(asn, reason: reason, status: status, ttl: ttl, **metadata)
+    end
+
+    def block_asn(asn, reason: "manual_block", ttl: nil, **metadata)
+      Reputation.block_asn(asn, reason: reason, ttl: ttl, **metadata)
+    end
+
+    def challenge_asn(asn, reason: "suspicious_traffic", ttl: nil, **metadata)
+      Reputation.challenge_asn(asn, reason: reason, ttl: ttl, **metadata)
+    end
+
+    def ignore_asn(asn, reason: "datacenter_traffic", ttl: nil, **metadata)
+      Reputation.ignore_asn(asn, reason: reason, ttl: ttl, **metadata)
+    end
+
     # Generate a signed verification URL
     # @param return_url [String] URL to redirect to after successful verification
     # @param failure_url [String, nil] URL to redirect to on failure (optional)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reputable
 version: !ruby/object:Gem::Version
-  version: 0.1.17
+  version: 0.1.19
 platform: ruby
 authors:
 - Reputable
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-29 00:00:00.000000000 Z
+date: 2026-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis