interceptor-sdk 1.0.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5feddd65301d4e9cb3fc9823a3a503827be4cbd513c2501d8d45a13aa648c10
-  data.tar.gz: 396501b60374066e3fd8c5aaa1192889c4af5b97afcf92abfe4587f6975366c5
+  metadata.gz: d219cae52ce846c3283baf996d66c28d1fad81f0dc12bdd429e374cf2207e684
+  data.tar.gz: 5e14fc3b9061c2f0d07f3496fbe8516062dc91737cb51d4b0b156b8e91c2255f
 SHA512:
-  metadata.gz: 37a9ac5e66ce6e20fe6b57df90626da822a4c75a744727d2188f7dc83e2757ffba8563d6e559b09988ad78360fbcc4ec8648f9fd0efe9894850bf3870bd793d8
-  data.tar.gz: 354c79adc5991f6e010864d605b6ec34646d66193957405341e89be5e56c701a43aeacd5a3443752c6a7557c3ae0bba5fb0e34dc2c7b5c32f80216f7ab12f473
+  metadata.gz: f8c1f1d60c1179509ca5a27dc229f243caaf1dbe0cff2f1627496b9d4fdc16ca33e095388a0723b18ea83bb35951370c9261d9db9d35aab6c43ed640b6cce13f
+  data.tar.gz: 7c1e7d05755d7c7cbb9515bb9ab693eb8697538611fe2206415008948f02fe9060100b5f5b0b6e5771dfb1ec7cf2b774ce55306b22c2c3cba43c638d5c6ee732

data/README.md

@@ -5,10 +5,14 @@
 Requires Ruby 3.1+ on Windows x64. Direct Fiddle bindings to this product's native SDK, with no Python dependency. Supported families: keyboard, mouse, hid, xinput, xinputhid, gip. Driver and original licensing requirements remain unchanged.
 
 ```ruby
-require 'interceptor'
-Interceptor::Interceptor.open do |client|
+require 'interceptor_sdk'
+InterceptorSDK::Interceptor.open do |client|
   p client.info
 end
 ```
 
 The block form closes the native session even on an exception. Importing/constructing the SDK does not install a driver or start capture. See [API documentation](docs/API.md).
+
+## Version 2 namespace
+
+Use `require 'interceptor_sdk'` and `InterceptorSDK::Interceptor`. Version 1 used the generic `interceptor` require/module name, which can conflict with unrelated gems. Version 1 artifacts remain unchanged; version 2 deliberately uses an isolated namespace.

data/docs/API.md

@@ -1,6 +1,6 @@
 # Interceptor Ruby API
 
-`Interceptor::Interceptor.open(library_path: nil) { |client| ... }`; or construct explicitly and call `close`. `initialize_devices`, `info`, `devices`, `receive(timeout: nil)`, `send(batch)`, `discard(batch)`, `cancel`, `descriptor(token, report: false)`, `inject(kind, state = {}, token: nil, report: nil)` expose the native C ABI.
+`InterceptorSDK::Interceptor.open(library_path: nil) { |client| ... }`; or construct explicitly and call `close`. `initialize_devices`, `info`, `devices`, `receive(timeout: nil)`, `send(batch)`, `discard(batch)`, `cancel`, `descriptor(token, report: false)`, `inject(kind, state = {}, token: nil, report: nil)` expose the native C ABI.
 
 Edit input fields through `event.field(name).value` or the unambiguous descriptor metadata in `event.fields`; set `event.blocked = true` to drop an input. Do not resize reports/fields or reuse stale/foreign batches. Partial failures expose `NativeError#code` and `#accepted`; retry sends only the remaining inputs. Sequence/timestamp use Ruby integers preserving unsigned 64-bit values. Cancellation works from another Ruby thread.
 

data/examples/info.rb

@@ -1,2 +1,2 @@
-require 'interceptor'
-Interceptor::Interceptor.open { |client| p client.info }
+require 'interceptor_sdk'
+InterceptorSDK::Interceptor.open { |client| p client.info }

data/lib/{interceptor.rb → interceptor_sdk.rb}

@@ -2,8 +2,8 @@
 require 'fiddle'
 require 'thread'
 
-module Interceptor
-  VERSION = '1.0.0'
+module InterceptorSDK
+  VERSION = '2.0.0'
   KINDS = ['', 'keyboard', 'mouse', 'hid', 'xinput', 'xinputhid', 'gip'].freeze
   class NativeError < StandardError
     attr_reader :code, :accepted
@@ -66,7 +66,7 @@ module Interceptor
   class Interceptor
     def initialize(library_path: nil)
       raise LoadError, 'Interceptor requires Windows x64 Ruby' unless /mswin|mingw/ =~ RUBY_PLATFORM && Fiddle::SIZEOF_VOIDP == 8
-      path = library_path || ENV['INTERCEPTOR_NATIVE_PATH'] || File.expand_path('../native/InterceptorBridge.dll', __dir__)
+      path = library_path || ENV['INTERCEPTOR_SDK_NATIVE_PATH'] || File.expand_path('../native/InterceptorBridge.dll', __dir__)
       @native = Native.load(File.expand_path(path)); @mutex = Mutex.new; @session = 0; @current = nil
       raise LoadError, 'Incompatible native ABI' unless @native.call(:version) == 1 && [120,64,24,40,776,56].each_with_index.all? { |size,index| @native.call(:sizeof,index+1) == size }
       out = Native.buffer(8); checked(:open,out); @session = Native.u64(out,0)

data/test/protocol.rb

@@ -1,6 +1,6 @@
-require 'interceptor'
+require 'interceptor_sdk'
 require 'fiddle'
-sdk=Interceptor
+sdk=InterceptorSDK
 fixture=ARGV.fetch(0)
 mode=Fiddle::Function.new(Fiddle::Handle.new(fixture)['interceptor_test_mode'],[Fiddle::TYPE_INT],Fiddle::TYPE_VOID)
 def check(value);raise 'Product Ruby SDK contract failed' unless value;end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: interceptor-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors:
 - TitanCSA
@@ -39,7 +39,7 @@ files:
 - README.md
 - docs/API.md
 - examples/info.rb
-- lib/interceptor.rb
+- lib/interceptor_sdk.rb
 - native/InterceptorBridge.dll
 - test/protocol.rb
 homepage: https://github.com/TitanCSA/Interceptor