app_bridge 2.0.1-x86_64-linux-musl → 3.0.0-x86_64-linux-musl

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a361775c8d0d2e50639cec2345c31c975a42cabf457846d93ecde4e07283e12
-  data.tar.gz: a4f314737b37487c79c237a016ec7961ca792931ebfb65593214360f09ace30b
+  metadata.gz: df8a941497724fcf8f2ef45927bb3a30988bd463c9bec5995775046303eef543
+  data.tar.gz: 1ce8dddca0bbf398d5bc5539f92b6edca9f21f9574b24e2f3e1f47ff8eba6f07
 SHA512:
-  metadata.gz: 0cacb64beb43d9a059447cdc2b652dfbb82260c0a609112d782c5e000b9c6c5ca191ff265ee8710aafcc434a75b79f2210a444c980a13545e3fbdc4f89b48459
-  data.tar.gz: 57dafe0731bfcb61a1ee2548cf4223aa5745c8038c7ce9ae3dbbac9d61d383cb68543db0ed8a397222dc47eb6f63b1dbf67f5ec102e1bec304fb168dad007de0
+  metadata.gz: 243a0137a17a4152a514665344f3132a7e3141647bbfd8ac2f57319349bb66aa44b98377547b102ef93d0534b9b5ef1ca58f21f7b53a2269d3d066494fff8a1a
+  data.tar.gz: 0bac68f0c31440845b6f080a4b205baa30774225acdbb07c28904580f1fd1b84142e882a72228f0461028697cf3341cbf80ae769ceb0ae1da18da06868338aff

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@3.0.0;
 
 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.
@@ -107,6 +133,12 @@ interface types {
 
     /// A catch-all for all other types of errors. Should include a descriptive message.
     other,
+
+    /// Complete the current workflow execution.
+    complete-workflow,
+
+    /// Complete the parent step execution.
+    complete-parent,
   }
 }
 
@@ -116,6 +148,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 +184,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 +277,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 = "3.0.0"
 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: 3.0.0
 platform: x86_64-linux-musl
 authors:
 - Alexander Ross
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-04-14 00:00:00.000000000 Z
+date: 2025-10-29 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: