triangulum 0.4.0-aarch64-linux-musl

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 43d3a36ab400863d91447c38ee8dd81a8ca79b9906e53a8929d0dc73a8a31f55
+  data.tar.gz: 38779bb73c68517a5a5657fb0d90239f6638a0a588018cacf2c9362160117eb5
+SHA512:
+  metadata.gz: 720d4f789d1d96a01fb28b2d215460352baed907a24b87aba09ef027caa6512e045da3962232f256343b4121df4690016fe396259e6dbd507f07ec97ddf410f6
+  data.tar.gz: dc4b36aeebae8fa8687aba08c68506dd880621d0ea3a03238afefaf3fc26d88e3394af226d80fbd999ad2244c1b6f7dbba4fbd72976788ed5e6072d7985d4389

data/README.md

@@ -0,0 +1,77 @@
+# Triangulum Ruby Gem
+
+Ruby bindings for the [Triangulum](https://github.com/code0-tech/triangulum) validation layer. This gem wraps the TypeScript library and a bundled [Bun](https://bun.sh) runtime to validate flows using the TypeScript compiler.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'triangulum'
+```
+
+Platform-specific gems are published for:
+
+- `arm64-darwin` (macOS Apple Silicon)
+- `x86_64-darwin` (macOS Intel)
+- `x86_64-linux-gnu` (Linux x64)
+- `x86_64-linux-musl` (Linux x64 musl)
+- `aarch64-linux-gnu` (Linux ARM64)
+- `aarch64-linux-musl` (Linux ARM64 musl)
+
+If Bundler doesn't automatically select the correct platform gem, add your platform:
+
+```bash
+bundle lock --add-platform x86_64-linux-gnu
+```
+
+## Usage
+
+```ruby
+result = Triangulum::Validation.new(flow, runtime_function_definitions, data_types).validate
+
+result.valid?       # => true / false
+result.return_type  # => "void"
+result.diagnostics  # => [Triangulum::Validation::Diagnostic, ...]
+```
+
+The arguments are [Tucana](https://github.com/code0-tech/tucana) protobuf objects:
+
+- `flow` — `Tucana::Shared::ValidationFlow`
+- `runtime_function_definitions` — `Array<Tucana::Shared::RuntimeFunctionDefinition>`
+- `data_types` — `Array<Tucana::Shared::DefinitionDataType>`
+
+### Diagnostics
+
+Each diagnostic contains:
+
+| Field | Description |
+|---|---|
+| `message` | Human-readable error description |
+| `code` | TypeScript diagnostic code |
+| `severity` | `"error"` or `"warning"` |
+| `node_id` | ID of the node that caused the error |
+| `parameter_index` | Index of the parameter that caused the error |
+
+## Development
+
+Prerequisites: [Bun](https://bun.sh) installed locally for building the entrypoint.
+
+```bash
+cd gem
+bundle install
+bundle exec rake prepare_build  # downloads bun binaries + builds JS entrypoint
+bundle exec rake                # run tests and rubocop
+```
+
+### Building platform gems
+
+```bash
+bundle exec rake package
+```
+
+This will download bun binaries (with SHA256 checksum verification) for all supported platforms and build a `.gem` file for each.
+
+## License
+
+See [LICENSE](../LICENSE).

data/lib/triangulum/validation.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Triangulum
+  # == Triangulum::Validation
+  # This class implements the validation using the typescript package
+  class Validation
+    class TriangulumFailed < Triangulum::Error
+    end
+
+    class BunNotFound < Triangulum::Error
+    end
+
+    Result = Struct.new(:valid?, :return_type, :diagnostics, keyword_init: true)
+    Diagnostic = Struct.new(:message, :code, :severity, :node_id, :parameter_index, keyword_init: true)
+
+    ENTRYPOINT = File.expand_path('js/single-validation.js', __dir__)
+    BUN_EXE = Dir.glob(File.expand_path('../../exe/*/bun', __dir__)).find do |path|
+      platform = Gem::Platform.new(File.basename(File.dirname(path)))
+      Gem::Platform.match_gem?(platform, Gem::Platform.local.to_s)
+    end
+
+    attr_reader :flow, :runtime_function_definitions, :data_types
+
+    def initialize(flow, runtime_function_definitions, data_types)
+      @flow = flow
+      @runtime_function_definitions = runtime_function_definitions
+      @data_types = data_types
+    end
+
+    def validate
+      input = serialize_input
+
+      output = run_ts_triangulum(input)
+
+      parse_output(output)
+    end
+
+    private
+
+    def run_ts_triangulum(input)
+      raise BunNotFound, "No bundled bun binary found for #{Gem::Platform.local}" if BUN_EXE.nil?
+
+      stdout_s, stderr_s, status = Open3.capture3(
+        BUN_EXE, 'run', ENTRYPOINT,
+        stdin_data: input
+      )
+
+      raise TriangulumFailed, "OUT:\n#{stdout_s}\n\nERR:\n#{stderr_s}" unless status.success?
+
+      stdout_s
+    end
+
+    def serialize_input
+      input = []
+
+      input << Base64.strict_encode64(flow.to_proto)
+      input << ''
+
+      runtime_function_definitions.each do |rfd|
+        input << Base64.strict_encode64(rfd.to_proto)
+      end
+
+      input << ''
+
+      data_types.each do |dt|
+        input << Base64.strict_encode64(dt.to_proto)
+      end
+
+      input << ''
+
+      input.join("\n")
+    end
+
+    def parse_output(output)
+      json = JSON.parse(output, symbolize_names: true)
+
+      Result.new(
+        valid?: json[:isValid],
+        return_type: json[:returnType],
+        diagnostics: json[:diagnostics].map do |diagnostic|
+          Diagnostic.new(
+            message: diagnostic[:message],
+            code: diagnostic[:code],
+            severity: diagnostic[:severity],
+            node_id: diagnostic[:nodeId],
+            parameter_index: diagnostic[:parameterIndex]
+          )
+        end
+      )
+    end
+  end
+end

data/lib/triangulum/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Triangulum
+  VERSION = '0.4.0'
+end

data/lib/triangulum.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require 'open3'
+
+module Triangulum
+  class Error < StandardError; end
+end
+
+require_relative 'triangulum/version'
+require_relative 'triangulum/validation'

metadata

@@ -0,0 +1,207 @@
+--- !ruby/object:Gem::Specification
+name: triangulum
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+platform: aarch64-linux-musl
+authors:
+- Niklas van Schrick
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+- !ruby/object:Gem::Dependency
+  name: open3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: tucana
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.62
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.62
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+email:
+- mc.taucher2003@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- exe/aarch64-linux-musl/bun
+- lib/triangulum.rb
+- lib/triangulum/validation.rb
+- lib/triangulum/version.rb
+homepage: https://github.com/code0-tech/triangulum
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/code0-tech/triangulum
+  changelog_uri: https://github.com/code0-tech/triangulum/releases
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Triangulum is the CodeZero validation layer
+test_files: []