app_bridge 2.0.1-arm64-darwin → 2.1.2-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bea0c5ce12f2288203b770eb1dc1996b43f8605663efd38a4f53a93cd4f1e7ed
-  data.tar.gz: 2c626c5432a1675734548207288d67cdf46083f14b0f9a44f7c9f209fb32015a
+  metadata.gz: d82944a9658e0f94dd9c86e08ee0ca69ed7a42128be8db622d37a5f2f0ba4aea
+  data.tar.gz: b8c0d3b15d36bd9139e0fecdbf51b4b1672391cbbb72247568c8e2ca7b3cb179
 SHA512:
-  metadata.gz: 4cedf12fe1d776e96f3f9a78b7eca315695bd522669216b2c76c2fb0e282a6436cf5dd9e8eb79b91439621c9bb32438431d17a25922e8e0cc307eb5aa6991e8e
-  data.tar.gz: 4b42828e3d79d4b49e664d7187a4a15b5bc0789c886f43a35b5b371e6a63037cf1da44ce7c09bde0f56b25ae37b5da49bd08220c8c6c76863142f43e7d8d383f
+  metadata.gz: 489cd15a9a204bd33174bd81e47bf4c0e58cf80853bbcec96961dde30c3cdac062584fb19c6afebea4ecf90aec8436751f36475bd01ebd6d1d1c2de50c2156bf
+  data.tar.gz: b6f29fdc21671bfb09b0cd3e03ed38c5c8643f257ee4e011ce2d3f9a8ca806ea7a2ddde2812a2fd0f0af7717e3f708e6d415dd78594dac4288de5000b64cad7c

data/.editorconfig

@@ -0,0 +1,18 @@
+# EditorConfig helps developers define and maintain consistent
+# coding styles between different editors and IDEs
+# http://editorconfig.org/
+
+root = true
+
+[*]
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 2
+curly_bracket_next_line = false
+indent_brace_style = K&R
+
+[*.md]
+trim_trailing_whitespace = false

data/Rakefile

@@ -3,8 +3,6 @@
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
-RSpec::Core::RakeTask.new(:spec)
-
 require "rubocop/rake_task"
 
 RuboCop::RakeTask.new
@@ -22,4 +20,9 @@ end
 # Load all project specific rake tasks
 Dir.glob(File.expand_path("tasks/**/*.rake", __dir__)).each { |file| load file }
 
-task default: %i[fixtures compile spec rubocop]
+# Set test mode environment variable for specs
+RSpec::Core::RakeTask.new(:spec) do |_t|
+  ENV["APP_BRIDGE_TEST_MODE"] = "1"
+end
+
+task default: %i[fixtures compile rust:test spec rubocop]

data/ext/app_bridge/wit/world.wit

@@ -1,4 +1,4 @@
-package standout:app@2.0.1;
+package standout:app@2.1.2;
 
 interface types {
   // The trigger-store is a string that is used to store data between trigger
@@ -10,10 +10,10 @@ interface types {
   // need to add more data to the store.
   type trigger-store = string;
 
-  record account {
+  record connection {
     id: string,
     name: string,
-    // The account data is a JSON object serialized into a string. The JSON root
+    // The connection data is a JSON object serialized into a string. The JSON root
     // will always be an object.
     serialized-data: string,
   }
@@ -23,12 +23,31 @@ interface types {
     // invoked.
     trigger-id: string,
 
-    // The account that the trigger is invoked for.
-    account: account,
+    // The connection that the trigger is invoked for.
+    // Connection is required for all trigger operations.
+    connection: connection,
 
     // The store will contain the data that was stored in the trigger store the
     // last time the trigger was invoked.
     store: trigger-store,
+
+    // The input data for the trigger, serialized as a JSON object string.
+    // This contains the input data from the trigger configuration form.
+    serialized-input: string,
+  }
+
+  record action-context {
+    // Action ID is a unique identifier for the action that is requested to be
+    // invoked.
+    action-id: string,
+
+    // The connection that the action is invoked for.
+    // Connection is required for all action operations.
+    connection: connection,
+
+    // The input data for the action, serialized as a JSON object string.
+    // This contains the data passed from the previous step in the workflow.
+    serialized-input: string,
   }
 
   record trigger-response {
@@ -41,10 +60,17 @@ interface types {
     store: trigger-store,
   }
 
+  record action-response {
+    // The output data from the action, serialized as a JSON object string.
+    // This contains the data that will be passed to the next step in the workflow.
+    // The data must be a valid JSON object (not an array or primitive).
+    serialized-output: string
+  }
+
   record trigger-event {
     // The ID of the trigger event
     //
-    // If the account used for the given instance of the trigger is the same,
+    // If the connection used for the given instance of the trigger is the same,
     // as seen before. Then the event will be ignored.
     //
     // A scheduler could therefore use an timestamp as the ID, to ensure that
@@ -81,7 +107,7 @@ interface types {
     /// Authentication failed. Typically due to an invalid or expired API key or token.
     unauthenticated,
 
-    /// Authorization failed. The account is valid but does not have the necessary permissions.
+    /// Authorization failed. The connection is valid but does not have the necessary permissions.
     forbidden,
 
     /// The trigger is misconfigured. For example, a required setting is missing or invalid.
@@ -116,6 +142,18 @@ interface triggers {
 
   trigger-ids: func() -> result<list<string>, app-error>;
 
+  // Get the input schema for a specific trigger
+  // Returns a JSON Schema Draft 2020-12 schema as a string
+  // The schema may vary based on the connection in the context
+  // The trigger-id is extracted from the context
+  input-schema: func(context: trigger-context) -> result<string, app-error>;
+
+  // Get the output schema for a specific trigger
+  // Returns a JSON Schema Draft 2020-12 schema as a string
+  // The schema may vary based on the connection in the context
+  // The trigger-id is extracted from the context
+  output-schema: func(context: trigger-context) -> result<string, app-error>;
+
   // Fetch events
   //
   // There are some limitations to the function:
@@ -140,6 +178,47 @@ interface triggers {
   fetch-events: func(context: trigger-context) -> result<trigger-response, app-error>;
 }
 
+interface actions {
+  use types.{action-context, action-response, app-error};
+
+  action-ids: func() -> result<list<string>, app-error>;
+
+  // Get the input schema for a specific action
+  // Returns a JSON Schema Draft 2020-12 schema as a string
+  // The schema may vary based on the connection in the context
+  // The action-id is extracted from the context
+  input-schema: func(context: action-context) -> result<string, app-error>;
+
+  // Get the output schema for a specific action
+  // Returns a JSON Schema Draft 2020-12 schema as a string
+  // The schema may vary based on the connection in the context
+  // The action-id is extracted from the context
+  output-schema: func(context: action-context) -> result<string, app-error>;
+
+  // Execute an action
+  //
+  // There are some limitations to the function:
+  // - It must return an `action-response` within 30 seconds
+  // - The serialized-output must be a valid JSON object serialized as a string
+  //
+  // Actions can perform various operations such as:
+  // - Making HTTP requests to external APIs
+  // - Processing and transforming data
+  // - Storing data for future use
+  // - Triggering other systems or workflows
+  //
+  // The action receives input data from the previous step and can return
+  // serialized output data to be passed to the next step in the workflow.
+  execute: func(context: action-context) -> result<action-response, app-error>;
+}
+
+interface environment {
+  // Get all environment variables
+  env-vars: func() -> list<tuple<string, string>>;
+  // Get a specific environment variable by name
+  env-var: func(name: string) -> option<string>;
+}
+
 interface http {
   record response {
     status: u16,
@@ -192,5 +271,7 @@ interface http {
 
 world bridge {
   import http;
+  import environment;
   export triggers;
+  export actions;
 }

data/lib/app_bridge/app.rb

@@ -3,8 +3,16 @@
 require "timeout"
 
 module AppBridge
-  # An app that can be used to fetch events.
+  # An app that can be used to fetch events and execute actions.
   class App
+    def initialize(component_path, environment_variables: {})
+      @component_path = component_path
+      @environment_variables = environment_variables
+      _rust_initialize(component_path, environment_variables)
+    rescue StandardError
+      raise InternalError, "Incompatible WASM file version"
+    end
+
     def fetch_events(context)
       response = request_events_with_timeout(context)
 
@@ -14,7 +22,15 @@ module AppBridge
       response
     end
 
-    def polling_timeout
+    def execute_action(context)
+      response = request_action_with_timeout(context)
+
+      validate_action_response_size!(response.serialized_output)
+
+      response
+    end
+
+    def timeout_seconds
       30 # seconds
     end
 
@@ -32,8 +48,20 @@ module AppBridge
       raise StoreTooLargeError, "Store size exceeds 64 kB limit"
     end
 
+    def validate_action_response_size!(serialized_output)
+      return if serialized_output.size <= 64 * 1024
+
+      raise ActionResponseTooLargeError, "Action response size exceeds 64 kB limit"
+    end
+
+    def request_action_with_timeout(context)
+      Timeout.timeout(timeout_seconds, TimeoutError, "Action exceeded #{timeout_seconds} seconds") do
+        _rust_execute_action(context)
+      end
+    end
+
     def request_events_with_timeout(context)
-      Timeout.timeout(polling_timeout, TimeoutError, "Polling exceeded #{polling_timeout} seconds") do
+      Timeout.timeout(timeout_seconds, TimeoutError, "Polling exceeded #{timeout_seconds} seconds") do
         _rust_fetch_events(context)
       end
     end

data/lib/app_bridge/version.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# When updating the version, please also update the version in the
+# ext/app_bridge/Cargo.toml file to keep them in sync.
+
 module AppBridge
-  VERSION = "2.0.1"
+  VERSION = "2.1.2"
 end

data/lib/app_bridge.rb

@@ -3,17 +3,12 @@
 require_relative "app_bridge/version"
 require_relative "app_bridge/app"
 
-begin
-  require "app_bridge/#{RUBY_VERSION.split(".").first(2).join(".")}/app_bridge"
-rescue LoadError
-  require "app_bridge/app_bridge"
-end
-
 module AppBridge
   class Error < StandardError; end
   class TimeoutError < Error; end
   class TooManyEventsError < Error; end
   class StoreTooLargeError < Error; end
+  class ActionResponseTooLargeError < Error; end
 
   # Represents a trigger event that is recieved from the app.
   class TriggerEvent
@@ -23,3 +18,10 @@ module AppBridge
     end
   end
 end
+
+# Load using the Ruby version as the directory name
+begin
+  require "app_bridge/#{RUBY_VERSION.split(".").first(2).join(".")}/app_bridge"
+rescue LoadError
+  require "app_bridge/app_bridge"
+end

data/sig/app_bridge.rbs

@@ -7,11 +7,15 @@ module AppBridge
 
     def triggers: () -> Array[String]
 
+    def actions: () -> Array[String]
+
     def fetch_events: (TriggerContext) -> TriggerResponse
+
+    def execute_action: (ActionContext) -> ActionResponse
   end
 
-  class Account
-    def self.new: (String, String, String) -> Account
+  class Connection
+    def self.new: (String, String, String) -> Connection
 
     def id: () -> String
 
@@ -39,12 +43,30 @@ module AppBridge
   end
 
   class TriggerContext
-    def self.new: (String, Account, String) -> TriggerContext
+    def self.new: (String, Connection, String, String) -> TriggerContext
 
     def trigger_id: () -> String
 
-    def account: () -> Account
+    def connection: () -> Connection
 
     def store: () -> String
+
+    def serialized_input: () -> String
+  end
+
+  class ActionContext
+    def self.new: (String, Connection, String) -> ActionContext
+
+    def action_id: () -> String
+
+    def connection: () -> Connection
+
+    def serialized_input: () -> String
+  end
+
+  class ActionResponse
+    def self.new: (String) -> ActionResponse
+
+    def serialized_output: () -> String
   end
 end

data/tasks/rust_test.rake

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Rake task to run Rust tests
+namespace :rust do
+  desc "Run Rust tests"
+  task :test do
+    puts "Running Rust tests..."
+    system("cargo test")
+    puts "Rust tests completed."
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: app_bridge
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.2
 platform: arm64-darwin
 authors:
 - Alexander Ross
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-04-14 00:00:00.000000000 Z
+date: 2025-10-03 00:00:00.000000000 Z
 dependencies: []
 description: The app_bridge gem is designed to enable seamless interaction with WebAssembly
   components that adhere to the WIT specification `standout:app`. It is developed
@@ -19,6 +19,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".editorconfig"
 - ".rspec"
 - ".rubocop.yml"
 - ".tool-versions"
@@ -33,6 +34,7 @@ files:
 - lib/app_bridge/version.rb
 - sig/app_bridge.rbs
 - tasks/fixtures.rake
+- tasks/rust_test.rake
 homepage: https://github.com/standout/app_bridge
 licenses: []
 metadata: