hid-access-control 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bb86125b12bef657f9cb57f31392fb8c570e19aa2546e9451b441d5919c1e0bb
+  data.tar.gz: 386b6d65d1dd440f1610d3fb05fffc0b2b22fd5bc1e589abc4d4596cafed5e8b
+SHA512:
+  metadata.gz: 66358f93b414f8aefa9566d97ef58bd8ba6c08581efd9cd36bf26a1f5d3cd4125d6da78678a6afa0ea8a3e7406d7bd12ea20b22f77b94c1a154e34b37d881cc4
+  data.tar.gz: fb241973bb77689aa50e4e48d16421a16b60ef15787b6eb74ebf9d09bdf6d1f0a23bc67b14398e7e9212ebd00fd7366a0801854fa11b35258f2ef24777ab5b35

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 titanfyre
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,12 @@
+# HID-Access-Control Ruby SDK
+
+`gem install hid-access-control`
+
+Windows x64 Ruby3.1+.
+
+```ruby
+require "hid_access_control"
+HIDAccessControlSDK::Client.open { |client| p client.call("status") }
+```
+
+[API and operation schema](docs/API.md). Matching driver installed separately.

data/docs/API.md

@@ -0,0 +1,14 @@
+# HID-Access-Control operation schema
+
+The unchanged product C++ SDK is called directly. Operations: `check`, `probe`, `status`, `devices`, `apply`, `stop`, `read_events`. The dispatch source in `Bridge.cpp` lists exact argument keys and maps every operation to the original public SDK. Protocol structs retain their public-header field names, including case. UInt64 and Int64 fields are decimal strings; fixed arrays accept at most their capacity and omitted fields initialize to zero. Unknown fields and out-of-range values are rejected. SDK validators apply original protocol constraints.
+
+Wire types and fields:
+
+
+Only explicit start/connect/policy calls start the corresponding operation. The C ABI session constructor is inert; one active session per product DLL. Always close. Capture receives are bounded when the native API accepts a timeout. SDK original licensing/trial checks remain unchanged. No driver is installed by packages.
+
+Tests exercise synthetic wire inputs using the real production SDK validation/formatting helpers, rejected arguments, exact unsigned values and inert session lifecycle. No live capture, policy application, storage fault, traffic modification or driver activation is performed by these tests. Operational driver paths require a separate integration environment.
+
+## Language client
+
+The client calls the native SDK directly. Use the call method with an operation name and argument object. Calls are synchronous; only operations exposing a receive timeout are capped at100ms; use an application worker for responsive UI/event loops. Explicitly close the client after use. 64-bit identifiers and counters are decimal strings. Native errors expose their Windows code. Matching driver and licensing are separate requirements.

data/docs/LICENSE.nlohmann-json

@@ -0,0 +1,21 @@
+MIT License 
+
+Copyright (c) 2013-2025 Niels Lohmann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/docs/Native-NOTICE

@@ -0,0 +1,7 @@
+The MIT source license applies to this repository's original user-mode SDK,
+application, examples, protocol and installer source. Evaluation driver source is documented in [driver/README.md](driver/README.md) with its own source-license scope. Prebuilt driver binaries retain their separate evaluation terms.
+
+This independent project addresses the device access-control use case described
+by HidHide (https://github.com/nefarius/HidHide). It is not affiliated with,
+endorsed by or a binary/API-compatible replacement for Nefarius or HidHide.
+No HidHide implementation source is included.

data/lib/hid_access_control.rb

@@ -0,0 +1,46 @@
+require 'json'
+require 'fiddle'
+require 'thread'
+module HIDAccessControlSDK
+  class NativeError < StandardError
+    attr_reader :code
+    def initialize(code,message);@code=code;super(message);end
+  end
+  class Client
+    def self.open(library_path: nil)
+      client=new(library_path: library_path)
+      return client unless block_given?
+      begin;yield client;ensure;client.close;end
+    end
+    def initialize(library_path: nil)
+      raise 'Windows x64 required' unless Fiddle::SIZEOF_VOIDP==8 && RUBY_PLATFORM.match?(/mingw|mswin/)
+      @library=Fiddle::Handle.new(library_path || ENV['HID_ACCESS_CONTROL_SDK_NATIVE_PATH'] || File.expand_path('../native/HIDAccessControlJsonSDK.dll',__dir__))
+      @mutex=Mutex.new
+      @open=Fiddle::Function.new(@library['hid_access_control_json_open'],[Fiddle::TYPE_VOIDP],Fiddle::TYPE_INT)
+      @close=Fiddle::Function.new(@library['hid_access_control_json_close'],[Fiddle::TYPE_LONG_LONG],Fiddle::TYPE_INT)
+      @call=Fiddle::Function.new(@library['hid_access_control_json_call'],[Fiddle::TYPE_LONG_LONG,Fiddle::TYPE_VOIDP,Fiddle::TYPE_INT],Fiddle::TYPE_VOIDP)
+      @free=Fiddle::Function.new(@library['hid_access_control_json_free'],[Fiddle::TYPE_VOIDP],Fiddle::TYPE_VOID)
+      out=Fiddle::Pointer.malloc(8,Fiddle::RUBY_FREE);out[0,8]=[0].pack('Q<');code=@open.call(out);raise NativeError.new(code,'Cannot open SDK') if code!=0
+      @session=out[0,8].unpack1('Q<')
+    end
+    def call(operation,arguments={})
+      payload=JSON.generate({operation:operation,arguments:arguments}).encode('UTF-8')
+      raise ArgumentError,'Request exceeds 32 MiB' if payload.bytesize>32*1024*1024
+      @mutex.synchronize do
+        raise 'SDK is closed' if @session==0
+        pointer=@call.call(@session,payload,payload.bytesize);raise NoMemoryError,'Native response allocation failed' if pointer.null?
+        begin;response=JSON.parse(pointer.to_s);ensure;@free.call(pointer);end
+        raise NativeError.new(response['code'],response['message']) unless response['ok']
+        response['result']
+      end
+    end
+    def close
+      @mutex.synchronize do
+        if @session!=0
+          code=@close.call(@session);raise NativeError.new(code,'Native close failed') if code!=0
+          @session=0
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: hid-access-control
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- TitanCSA
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fiddle
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+description: Product native SDK operations through a UTF-8 JSON C ABI; driver installed
+  separately.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- docs/API.md
+- docs/LICENSE.nlohmann-json
+- docs/Native-NOTICE
+- lib/hid_access_control.rb
+- native/HIDAccessControlJsonSDK.dll
+homepage: https://github.com/titanfyre/HID-Access-Control
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/titanfyre/HID-Access-Control
+  documentation_uri: https://github.com/titanfyre/HID-Access-Control/tree/main/HID-Access-Control-Ruby-rubygems/docs
+  allowed_push_host: https://rubygems.org
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Windows x64 HID-Access-Control direct SDK
+test_files: []