libddwaf 1.24.1.0.3-arm64-darwin → 1.24.1.1.1-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0bc11c35b50729be4bd03891db6918b7fc2b7e9605827efb31fd26a114391dd
-  data.tar.gz: 81a7376b1ee87e8dbbdf25dfb1d92ea410cbee74678b8c0e0fe95fa55a1de58c
+  metadata.gz: 4c219656c1bbb1cc7a6ed85552d51a17110777630f87b3dadce0409849f069dd
+  data.tar.gz: 7b49bca01a5e4324be4ac56a1e49ac3ee8ecd2e606e69e2a2ec5937c88c55e0e
 SHA512:
-  metadata.gz: dfaca7d65ef4adc342b29ade5af8d7daf3e76eb105e5e04e6ada9c5225aea75cb232c713d3fd5199eb7a55445cb2ce8b31737addc488820181f3367595a4beaf
-  data.tar.gz: efbc59d4d4e6993b73a333d40d63348f201ce8bf2404fc713768ea3b870f22a17e65e268258dc7bfead75f135c394aa197df527c6e78a9ff7ce155e7e9c67d39
+  metadata.gz: e70cce5baf7d3e6a093645020172b4b16d6af05f06d84366f011cdf9aafdcbf773790f3be0734248f6094a0a77cc0afb12aa08bbe0d220a443615f9a22ede189
+  data.tar.gz: 075b323d94a8060c88b0b4a24b8518be183ef3311cbb010ce9165edb0373d6b231111730af9f3733f330a0f3a0df3235fd5284348c8678b21f2abfedc20b8951

data/CHANGELOG.md

@@ -1,4 +1,20 @@
-# Unreleased v1.23.0.0.0
+# Unreleased
+
+## Added
+
+- Add `WAF::Result#input_truncated?` method that indicates that result is based on truncated input objects (see `LibDDWAF::Object#input_truncated?`)
+
+# 2025-08-15 v1.24.1.1.0
+
+## Added
+
+- Add `LibDDWAF::Object#input_truncated?` method that returns true if the input object was truncated during conversion to libddwaf object
+
+## Changed
+
+- Change `Handle#known_addresses` to cache the result
+
+# 2025-05-20 v1.24.1.0.0
 
 ## Added
 

data/lib/datadog/appsec/waf/context.rb

@@ -74,7 +74,7 @@ module Datadog
 
           code = LibDDWAF.ddwaf_run(@context_ptr, persistent_data_obj, ephemeral_data_obj, result_obj, timeout)
 
-          Result.new(
+          result = Result.new(
             RESULT_CODE[code],
             Converter.object_to_ruby(result_obj[:events]),
             result_obj[:total_runtime],
@@ -82,6 +82,12 @@ module Datadog
             Converter.object_to_ruby(result_obj[:actions]),
             Converter.object_to_ruby(result_obj[:derivatives])
           )
+
+          if persistent_data_obj.truncated? || ephemeral_data_obj.truncated?
+            result.mark_input_truncated!
+          end
+
+          result
         ensure
           LibDDWAF.ddwaf_result_free(result_obj) if result_obj
           LibDDWAF.ddwaf_object_free(ephemeral_data_obj) if ephemeral_data_obj

data/lib/datadog/appsec/waf/converter.rb

@@ -8,27 +8,32 @@ module Datadog
         module_function
 
         # standard:disable Metrics/MethodLength,Metrics/CyclomaticComplexity
-        def ruby_to_object(val, max_container_size: nil, max_container_depth: nil, max_string_length: nil, coerce: true)
+        def ruby_to_object(val, max_container_size: nil, max_container_depth: nil, max_string_length: nil, top_obj: nil, coerce: true)
           case val
           when Array
             obj = LibDDWAF::Object.new
             res = LibDDWAF.ddwaf_object_array(obj)
             raise ConversionError, "Could not convert into object: #{val}" if res.null?
 
-            max_index = max_container_size - 1 if max_container_size
-            unless max_container_depth == 0
+            if max_container_depth == 0
+              top_obj&.mark_truncated!
+            else
               val.each.with_index do |e, i|
+                if max_container_size && i >= max_container_size
+                  (top_obj || obj).mark_truncated!
+                  break val
+                end
+
                 member = Converter.ruby_to_object(
                   e,
                   max_container_size: max_container_size,
                   max_container_depth: (max_container_depth - 1 if max_container_depth),
                   max_string_length: max_string_length,
+                  top_obj: top_obj || obj,
                   coerce: coerce
                 )
                 e_res = LibDDWAF.ddwaf_object_array_add(obj, member)
                 raise ConversionError, "Could not add to array object: #{e.inspect}" unless e_res
-
-                break val if max_index && i >= max_index
               end
             end
 
@@ -38,25 +43,33 @@ module Datadog
             res = LibDDWAF.ddwaf_object_map(obj)
             raise ConversionError, "Could not convert into object: #{val}" if res.null?
 
-            max_index = max_container_size - 1 if max_container_size
-            unless max_container_depth == 0
+            if max_container_depth == 0
+              top_obj&.mark_truncated!
+            else
               val.each.with_index do |e, i|
+                if max_container_size && i >= max_container_size
+                  (top_obj || obj).mark_truncated!
+                  break val
+                end
+
                 # for Steep, which doesn't handle |(k, v), i|
-                k = e[0]
+                k = e[0].to_s
                 v = e[1]
 
-                k = k.to_s[0, max_string_length] if max_string_length
+                if max_string_length && k.length > max_string_length
+                  k = k[0, max_string_length]
+                  (top_obj || obj).mark_truncated!
+                end
                 member = Converter.ruby_to_object(
                   v,
                   max_container_size: max_container_size,
                   max_container_depth: (max_container_depth - 1 if max_container_depth),
                   max_string_length: max_string_length,
+                  top_obj: top_obj || obj,
                   coerce: coerce
                 )
-                kv_res = LibDDWAF.ddwaf_object_map_addl(obj, k.to_s, k.to_s.bytesize, member)
-                raise ConversionError, "Could not add to map object: #{k.inspect} => #{v.inspect}" unless kv_res
-
-                break val if max_index && i >= max_index
+                kv_res = LibDDWAF.ddwaf_object_map_addl(obj, k, k.bytesize, member)
+                raise ConversionError, "Could not add to map object: #{e[0].inspect} => #{v.inspect}" unless kv_res
               end
             end
 
@@ -64,16 +77,21 @@ module Datadog
           when String
             obj = LibDDWAF::Object.new
             encoded_val = val.to_s.encode(Encoding::UTF_8, invalid: :replace, undef: :replace)
-            val = encoded_val[0, max_string_length] if max_string_length
-            str = val.to_s
-            res = LibDDWAF.ddwaf_object_stringl(obj, str, str.bytesize)
+            if max_string_length && encoded_val.length > max_string_length
+              encoded_val = encoded_val[0, max_string_length] #: String
+              (top_obj || obj).mark_truncated!
+            end
+            res = LibDDWAF.ddwaf_object_stringl(obj, encoded_val, encoded_val.bytesize)
             raise ConversionError, "Could not convert into object: #{val.inspect}" if res.null?
 
             obj
           when Symbol
             obj = LibDDWAF::Object.new
-            val = val.to_s[0, max_string_length] if max_string_length
             str = val.to_s
+            if max_string_length && str.length > max_string_length
+              str = str[0, max_string_length] #: String
+              (top_obj || obj).mark_truncated!
+            end
             res = LibDDWAF.ddwaf_object_stringl(obj, str, str.bytesize)
             raise ConversionError, "Could not convert into object: #{val.inspect}" if res.null?
 

data/lib/datadog/appsec/waf/handle.rb

@@ -37,6 +37,8 @@ module Datadog
         #
         # @return [Array<String>] the list of known addresses
         def known_addresses
+          return @known_addresses if defined?(@known_addresses)
+
           ensure_pointer_presence!
 
           count = LibDDWAF::UInt32Ptr.new
@@ -44,7 +46,7 @@ module Datadog
 
           return [] if count == 0 # list is null
 
-          list.get_array_of_string(0, count[:value])
+          @known_addresses = list.get_array_of_string(0, count[:value]).compact
         end
 
         private

data/lib/datadog/appsec/waf/lib_ddwaf.rb

@@ -136,6 +136,14 @@ module Datadog
             :valueUnion, ObjectValueUnion,
             :nbEntries, :uint64,
             :type, :ddwaf_obj_type
+
+          def truncated?
+            @truncated == true
+          end
+
+          def mark_truncated!
+            @truncated = true
+          end
         end
 
         typedef Object.by_ref, :ddwaf_object

data/lib/datadog/appsec/waf/result.rb

@@ -15,6 +15,15 @@ module Datadog
           @timeout = timeout
           @actions = actions
           @derivatives = derivatives
+          @input_truncated = false
+        end
+
+        def mark_input_truncated!
+          @input_truncated = true
+        end
+
+        def input_truncated?
+          @input_truncated
         end
 
         def to_h

data/lib/datadog/appsec/waf/version.rb

@@ -5,7 +5,7 @@ module Datadog
         BASE_STRING = "1.24.1"
         # NOTE: Every change to the `BASE_STRING` should be accompanied
         #       by a reset of the patch version in the `STRING` below.
-        STRING = "#{BASE_STRING}.0.3"
+        STRING = "#{BASE_STRING}.1.1"
         MINIMUM_RUBY_VERSION = "2.5"
       end
     end

data/lib/libddwaf.rb

@@ -1 +1,3 @@
+# frozen_string_literal: true
+
 require "datadog/appsec/waf"

data/libddwaf.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.email = ["dev@datadoghq.com"]
 
   spec.summary = "Datadog WAF"
-  spec.description = <<-EOS.gsub(/^[\s]+/, "")
+  spec.description = <<-EOS.gsub(/^\s+/, "")
     libddwaf packages a WAF implementation in C++, exposed to Ruby
   EOS
 

data/sig/datadog/appsec/waf/converter.rbs

@@ -2,7 +2,7 @@ module Datadog
   module AppSec
     module WAF
       module Converter
-        def self.ruby_to_object: (top val, ?max_container_size: ::Integer?, ?max_container_depth: ::Integer?, ?max_string_length: ::Integer?, ?coerce: bool?) -> LibDDWAF::Object
+        def self.ruby_to_object: (top val, ?max_container_size: ::Integer?, ?max_container_depth: ::Integer?, ?max_string_length: ::Integer?, ?top_obj: LibDDWAF::Object?, ?coerce: bool?) -> LibDDWAF::Object
 
         def self.object_to_ruby: (LibDDWAF::Object obj) -> WAF::data
       end

data/sig/datadog/appsec/waf/handle.rbs

@@ -10,7 +10,7 @@ module Datadog
 
         def build_context: () -> Context
 
-        def known_addresses: () -> ::Array[::String?]
+        def known_addresses: () -> known_addresses
 
         private
 

data/sig/datadog/appsec/waf/lib_ddwaf.rbs

@@ -58,6 +58,9 @@ module Datadog
         end
 
         class Object < ::FFI::Struct[::FFI::AbstractMemory, untyped]
+          def truncated?: () -> bool
+
+          def mark_truncated!: () -> bool
         end
 
         # setters

data/sig/datadog/appsec/waf/result.rbs

@@ -14,6 +14,8 @@ module Datadog
 
         @derivatives: WAF::data
 
+        @input_truncated: bool
+
         attr_reader status: ::Symbol
 
         attr_reader events: WAF::data
@@ -27,6 +29,10 @@ module Datadog
         attr_reader derivatives: WAF::data
 
         def initialize: (::Symbol status, WAF::data events, ::Float total_runtime, bool timeout, WAF::data actions, WAF::data derivatives) -> void
+
+        def mark_input_truncated!: () -> bool
+
+        def input_truncated?: () -> bool
       end
     end
   end

data/sig/datadog/appsec/waf.rbs

@@ -2,6 +2,8 @@ module Datadog
   module AppSec
     module WAF
       type data = String | Symbol | Integer | Float | TrueClass | FalseClass | Array[data] | Hash[(String | Symbol | nil), data] | nil
+      type known_addresses = ::Array[::String]
+      type diagnostics = ::Hash[::String, untyped]
 
       def self.version: () -> ::String
 

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: libddwaf
 version: !ruby/object:Gem::Version
-  version: 1.24.1.0.3
+  version: 1.24.1.1.1
 platform: arm64-darwin
 authors:
 - Datadog, Inc.
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-23 00:00:00.000000000 Z
+date: 2025-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -69,7 +68,6 @@ licenses:
 - BSD-3-Clause
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -84,8 +82,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 2.0.0
 requirements: []
-rubygems_version: 3.5.21
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Datadog WAF
 test_files: []