janet_sandbox 0.1.0

data/lib/janet_sandbox.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "json"
+require "wasmtime"
+
+require_relative "janet_sandbox/version"
+require_relative "janet_sandbox/errors"
+require_relative "janet_sandbox/configuration"
+require_relative "janet_sandbox/result"
+require_relative "janet_sandbox/engine"
+require_relative "janet_sandbox/sandbox"
+require_relative "janet_sandbox/builtin_dsls"
+
+module JanetSandbox
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Configure the gem:
+    #
+    #   JanetSandbox.configure do |config|
+    #     config.fuel_limit = 200_000
+    #
+    #     # Register custom DSLs
+    #     config.register_dsl(:form_helpers, <<~'JANET')
+    #       (defn get-field [name] (get-in ctx [:values (keyword name)]))
+    #     JANET
+    #
+    #     # Enable DSLs by default
+    #     config.enable_dsl(:form_helpers)
+    #   end
+    #
+    # @yield [Configuration]
+    # @return [Configuration]
+    def configure
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    # Reset configuration to defaults (useful for testing).
+    #
+    # @return [Configuration]
+    def reset_configuration!
+      @configuration = Configuration.new
+      @engine = nil
+      @configuration
+    end
+
+    # Global engine instance (lazy, thread-safe).
+    #
+    # @return [Engine]
+    def engine
+      @engine || @mu.synchronize { @engine ||= Engine.new }
+    end
+
+    # Quick evaluation using the global engine.
+    #
+    # @param source [String] Janet source code
+    # @param context [Hash] Context passed to the script as `ctx`
+    # @param dsls [Array<Symbol>, nil] DSLs to inject (nil uses defaults)
+    # @param opts [Hash] Additional options passed to sandbox
+    # @return [Result]
+    #
+    # @example
+    #   result = JanetSandbox.evaluate(
+    #     source: '(+ 1 2)',
+    #     context: { values: { x: 10 } }
+    #   )
+    #   result.raw  #=> 3
+    #
+    # @example With DSLs
+    #   result = JanetSandbox.evaluate(
+    #     source: '(get-field "name")',
+    #     context: { values: { name: "Alice" } },
+    #     dsls: [:form_helpers]
+    #   )
+    def evaluate(source:, context: {}, dsls: nil, **opts)
+      engine.evaluate(source: source, context: context, dsls: dsls, **opts)
+    end
+
+    # Register a DSL module (convenience method).
+    #
+    # @param name [Symbol, String] DSL name
+    # @param janet_source [String] Janet source code
+    # @param description [String] Optional description
+    # @return [Configuration]
+    def register_dsl(name, janet_source, description: nil)
+      configuration.register_dsl(name, janet_source, description: description)
+    end
+
+    # Check if a DSL is registered.
+    #
+    # @param name [Symbol, String] DSL name
+    # @return [Boolean]
+    def dsl_registered?(name)
+      configuration.dsl_registered?(name)
+    end
+
+    # List all registered DSL names.
+    #
+    # @return [Array<Symbol>]
+    def dsl_names
+      configuration.dsl_names
+    end
+  end
+
+  @mu = Mutex.new
+end
+
+# Load Rails integration if Rails is present
+if defined?(Rails::Railtie)
+  require_relative "janet_sandbox/rails/railtie"
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: janet_sandbox
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael Harris
+bindir: bin
+cert_chain: []
+date: 1980-01-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: wasmtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '28.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '43.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '28.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '43.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !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: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+description: |
+  Embed the Janet programming language in Ruby apps via WebAssembly.
+  Safely execute user-authored scripts with configurable
+  resource limits, and pluggable DSL modules. Ideal for business logic,
+  dynamic rules, and user-extensible workflows.
+email:
+- osiris2918@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- examples/dsls/form_helpers.janet
+- examples/dsls/math_helpers.janet
+- examples/dsls/validation_helpers.janet
+- examples/initializers/janet_sandbox.rb
+- lib/janet_sandbox.rb
+- lib/janet_sandbox/builtin_dsls.rb
+- lib/janet_sandbox/configuration.rb
+- lib/janet_sandbox/engine.rb
+- lib/janet_sandbox/errors.rb
+- lib/janet_sandbox/rails/railtie.rb
+- lib/janet_sandbox/rails/script_concern.rb
+- lib/janet_sandbox/result.rb
+- lib/janet_sandbox/sandbox.rb
+- lib/janet_sandbox/version.rb
+- wasm/janet.wasm
+homepage: https://github.com/mlh758/janet_sandbox
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/mlh758/janet_sandbox
+  source_code_uri: https://github.com/mlh758/janet_sandbox
+  changelog_uri: https://github.com/mlh758/janet_sandbox/blob/main/CHANGELOG.md
+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.7.2
+specification_version: 4
+summary: Sandboxed Janet scripting for Ruby applications
+test_files: []