debugbundle 2.1.3 → 2.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ed63517f7a7215979c0fbd337d89a5d0209e20832649181f238146624afdf47c
4
- data.tar.gz: e889040151410ddfbc181e1b04c7b78a604d525d2c11eeb69d85ccbd0f911ab5
3
+ metadata.gz: 595fd6366269058ad31b1116571a35fad4e586064b7f5032babb5fe85de57d95
4
+ data.tar.gz: 5248c51d1105c90d82df8db686895eff22183e0a7ec726640e13fec18def055a
5
5
  SHA512:
6
- metadata.gz: 463f001e83ad2506acb1d011b664408aff5af03d72fe2405458ff9f0b9752383f2328a2824a721e56f2a784798cf07a791f931dee629e539b3c623d85de3d53c
7
- data.tar.gz: f0fcabc9b7c7762a41188c041ea72be0e9d472cf706db486151b5dee743e5b1d2fdc69015f283cd30daa73e2169e94522931297285c83bd20253e75236b0ff0b
6
+ metadata.gz: ca026bbe971a599ebfcabbd12d5793d5e8dc6a6efbc22bac27fe6fc99f393ae967d0b0849801494b90208a4305c2bf7b0e6c76162b05c2c36d8a1fe2d3408794
7
+ data.tar.gz: 56a2441e09a08dd86f4f1ffb6c4720214e7a705edbe676a45d289acf5b28ade393c42580f77b563e006b03c704821b9021fbdb0361cc22374e8e6c27bf9424df
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # debugbundle
2
2
 
3
- Patch 2.1.3 protects invitation and organisation-transfer credentials in captured text while preserving public APIs and event schemas. Upgrade the DebugBundle distribution to adopt the protection.
3
+ Patch 2.1.4 preserves application hook redaction under optional-evidence limits and complete validation. Public capture APIs and event schemas remain compatible.
4
4
 
5
5
  Ruby SDK for DebugBundle.
6
6
 
@@ -543,3 +543,13 @@ evidence disabled and enabled, including a full warning queue. It reports captur
543
543
  time, allocated Ruby objects and retained bytes, and verifies original-error
544
544
  priority and the existing queue/diagnostic ceilings. Setup and cleanup are excluded;
545
545
  the existing `sdk-safety-perf` timing limits remain unchanged.
546
+
547
+ ### Hook size limits (unreleased correction)
548
+
549
+ A hook replacement whose optional exception evidence exceeds the combined 32 KiB
550
+ UTF-8 JSON budget keeps its replacement message and other primary fields. The SDK
551
+ omits the oversized optional evidence and its typed reference, recording
552
+ `context.evidence_limits`. Ordinary custom context remains intact. A size limit
553
+ must not restore text removed by the hook; an otherwise valid replacement that
554
+ cannot fit later ownership or transport limits is withheld. Malformed returns and
555
+ throwing hooks retain the established protected-original fallback.
@@ -51,7 +51,7 @@ module DebugBundle
51
51
  result = hook.call(Marshal.load(Marshal.dump(event)))
52
52
  return nil if result.nil?
53
53
 
54
- checked = normalization_result(result)
54
+ checked = normalization_result(result, reduce_evidence: true)
55
55
  return nil if checked.equal?(EvidenceValue::EXHAUSTED)
56
56
 
57
57
  checked || event
@@ -68,7 +68,7 @@ module DebugBundle
68
68
  EvidenceValue.type?(result, Hash) ? result : nil
69
69
  end
70
70
 
71
- def normalization_result(event)
71
+ def normalization_result(event, reduce_evidence: false)
72
72
  return nil unless EvidenceValue.type?(event, Hash)
73
73
  return nil if Hash.instance_method(:size).bind_call(event) > ROOT_FIELDS.length
74
74
 
@@ -78,6 +78,8 @@ module DebugBundle
78
78
  max_string_bytes: 8 * 1024 * 1024)
79
79
  return owned if owned.equal?(EvidenceValue::EXHAUSTED)
80
80
  return nil unless EvidenceValue.type?(owned, Hash)
81
+
82
+ owned = EvidenceWire.fit_hook_evidence(owned) if reduce_evidence
81
83
  return nil unless CanonicalEventSchema.valid?(owned) && EvidenceWire.valid_optional?(owned)
82
84
  return nil unless required_frontend_context?(owned)
83
85
 
@@ -4,7 +4,7 @@ module DebugBundle
4
4
  module EvidenceGraph
5
5
  module_function
6
6
 
7
- def valid?(value)
7
+ def valid?(value, check_byte_budget: true)
8
8
  wire = EvidenceWire
9
9
  return false unless wire.closed(value, %w[version runtime root_id nodes truncated unavailable_reason])
10
10
  return false unless wire.integer(value['version'], 1, 1) && wire.integer(value['root_id'], 0, 7)
@@ -25,7 +25,7 @@ module DebugBundle
25
25
  end
26
26
  visited = {}
27
27
  visit(value['root_id'], adjacency, [], visited) && visited.length == nodes.length &&
28
- EvidenceJson.bytes(value) <= 32_768
28
+ (!check_byte_budget || EvidenceJson.bytes(value) <= 32_768)
29
29
  end
30
30
 
31
31
  def valid_node?(node)
@@ -111,7 +111,7 @@ module DebugBundle
111
111
  (value['limit_ms'].nil? || number(value['limit_ms']))
112
112
  end
113
113
 
114
- def valid_optional?(event)
114
+ def valid_optional?(event, check_byte_budget: true)
115
115
  return false unless EvidenceValue.type?(event, Hash)
116
116
 
117
117
  payload = Hash.instance_method(:fetch).bind_call(event, 'payload', nil)
@@ -127,7 +127,12 @@ module DebugBundle
127
127
  return false unless allowed_field?(type, field)
128
128
 
129
129
  owned = EvidenceValue.copy(Hash.instance_method(:fetch).bind_call(payload, field))
130
- return false unless field == 'execution' ? execution(owned) : validator.valid?(owned)
130
+ valid = if field == 'exception_evidence'
131
+ EvidenceGraph.valid?(owned, check_byte_budget: check_byte_budget)
132
+ else
133
+ field == 'execution' ? execution(owned) : validator.valid?(owned)
134
+ end
135
+ return false unless valid
131
136
 
132
137
  additions[field] = owned
133
138
  end
@@ -141,7 +146,7 @@ module DebugBundle
141
146
  nil))
142
147
  end
143
148
  additions['evidence_reference'] = selected if selected
144
- EvidenceJson.bytes(additions) <= 32_768
149
+ !check_byte_budget || EvidenceJson.bytes(additions) <= 32_768
145
150
  rescue StandardError
146
151
  false
147
152
  end
@@ -180,6 +185,29 @@ module DebugBundle
180
185
  result
181
186
  end
182
187
 
188
+ # Owned JSON only: optional byte exhaustion cannot restore pre-hook content.
189
+ def fit_hook_evidence(event)
190
+ return event unless %w[backend_exception frontend_exception].include?(event['event_type'])
191
+
192
+ payload = event['payload']
193
+ return event unless payload.is_a?(Hash)
194
+
195
+ additions = payload.slice('exception_evidence', 'execution', 'resource_observations')
196
+ return event if additions.empty?
197
+ return event if event.key?('context') && !event['context'].is_a?(Hash)
198
+
199
+ context = event['context'].is_a?(Hash) ? event['context'].dup : {}
200
+ selected = reference(context['evidence_reference'])
201
+ additions['evidence_reference'] = context['evidence_reference'] if selected
202
+ return event if EvidenceJson.bytes(additions) <= 32_768
203
+ return event unless valid_optional?(event, check_byte_budget: false)
204
+
205
+ context.delete('evidence_reference') if selected
206
+ additions.delete('evidence_reference')
207
+ context['evidence_limits'] = { 'version' => 1 }.merge(additions.transform_values { 'budget_exceeded' })
208
+ without_optional(event).merge('context' => context)
209
+ end
210
+
183
211
  def without_optional(event)
184
212
  return nil unless event.is_a?(Hash) && %w[backend_exception frontend_exception].include?(event['event_type'])
185
213
 
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module DebugBundle
4
- VERSION = '2.1.3'
4
+ VERSION = '2.1.4'
5
5
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: debugbundle
3
3
  version: !ruby/object:Gem::Version
4
- version: 2.1.3
4
+ version: 2.1.4
5
5
  platform: ruby
6
6
  authors:
7
7
  - DebugBundle