app_bridge 1.0.0-x86_64-linux-musl → 2.0.0-x86_64-linux-musl

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62231c9332eb45fa973d8eef9e1251fadca8b6150f7aa682bf4cd1d8cf9c1e66
-  data.tar.gz: 6aade0b0cc781d72d0a0c0a987c570d8c55f23b85ebf5ced19f0eaebb35686aa
+  metadata.gz: 2dfd7b1a3d7c0eeccfab8c0c66bd11bf2de807ddf24f2366cbc8ff28e5a34876
+  data.tar.gz: fd5d3f61590a6b15c841dc039ddad8f0d157e6b7f2e91d3015f1375981a073e3
 SHA512:
-  metadata.gz: ce586cc728704b8cdde398ef5220cefb25fea7e6a93c62df97858d180da3d43d197961fe3a592c715698d90c947c6dccb1604d9db2ac869d9c8cc0ab1dd0f694
-  data.tar.gz: c0504101f6c2a94bac64dc26e41ed6bf3ef4c421e463cca527327fa6e0e14ada19ff23b4315fe8fed23fe0b2cd0222da612f81bbef79a2dea536f2672d46ccaa
+  metadata.gz: 596181651b83501fb0c2094f534bba2bbe7060c82c5af50db4545b984385ffbfaf2c41528a3458d544e1e81b1a0d7c178958327fc4703bd8f82fee24ec896607
+  data.tar.gz: 6ae909b246ab94b923d58ed94c6fd645be2298be60cdaed9c8a33674ca1f0302237412fba845da56106e2b24c17a3e2cd7def0bf728e2345db28e804e9b39049

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.4.2

data/ext/app_bridge/wit/world.wit

@@ -1,4 +1,4 @@
-package standout:app@0.3.0;
+package standout:app@2.0.0;
 
 interface types {
   // The trigger-store is a string that is used to store data between trigger
@@ -59,24 +59,62 @@ interface types {
     // ensure that the event is only triggered once per order update.
     id: string,
 
-    // The timestamp of the event.
-    // Must be a unix timestamp in milliseconds since epoch (UTC).
-    // In JavaScript `Date.now()` can be used to get the current timestamp in
-    // milliseconds.
-    timestamp: u64,
-
     // Serialized data must be a JSON object serialized into a string
     // Note that it is important that the root is a object, not an array,
     // or another primitive type.
     serialized-data: string,
   }
+
+  /// A structured error that can be returned by for example a call to a trigger or action.
+  /// Contains a machine-readable code and a human-readable message.
+  record app-error {
+    /// The error code identifying the type of failure.
+    code: error-code,
+
+    /// A human-readable message describing the error in more detail.
+    message: string,
+  }
+
+  /// An enumeration of error codes that can be returned by a trigger implementation.
+  /// These codes help the platform and plugin developers distinguish between different types of failures.
+  variant error-code {
+    /// 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.
+    forbidden,
+
+    /// The trigger is misconfigured. For example, a required setting is missing or invalid.
+    misconfigured,
+
+    /// The target system does not support a required feature or endpoint.
+    unsupported,
+
+    /// The target system is rate-limiting requests. Try again later.
+    rate-limit,
+
+    /// The request timed out. The target system did not respond in time.
+    timeout,
+
+    /// The target system is currently unavailable or unreachable.
+    unavailable,
+
+    /// An unexpected internal error occurred in the plugin.
+    internal-error,
+
+    /// The response from the external system could not be parsed or was in an invalid format.
+    malformed-response,
+
+    /// A catch-all for all other types of errors. Should include a descriptive message.
+    other,
+  }
 }
 
 
 interface triggers {
-  use types.{trigger-context, trigger-event, trigger-response};
+  use types.{trigger-context, trigger-event, trigger-response, app-error};
 
-  get-triggers: func() -> list<string>;
+  trigger-ids: func() -> result<list<string>, app-error>;
 
   // Fetch events
   //
@@ -99,7 +137,7 @@ interface triggers {
   // the same events. That will ensure that the user that is building an
   // integration with your trigger will not miss any events if your system is
   // down for a short period of time.
-  fetch-events: func(context: trigger-context) -> trigger-response;
+  fetch-events: func(context: trigger-context) -> result<trigger-response, app-error>;
 }
 
 interface http {

data/lib/app_bridge/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AppBridge
-  VERSION = "1.0.0"
+  VERSION = "2.0.0"
 end

data/tasks/fixtures.rake

@@ -2,36 +2,43 @@
 
 require "English"
 
-namespace :fixtures do
+namespace :fixtures do # rubocop:disable Metrics/BlockLength
   namespace :apps do
     desc "Clean up build artifacts"
     task :clean do
-      # In context of the path spec/fixtures/components/example.
+      # In context of the path spec/fixtures/components/rust_app.
       # Execute cargo clean.
       #
-      pwd = "spec/fixtures/components/example"
+      pwd = "spec/fixtures/components/rust_app"
       pid = Process.spawn("cargo clean", chdir: pwd)
       Process.wait(pid)
       raise "Failed to clean build artifacts" unless $CHILD_STATUS.success?
 
       # Remove the built wasm artifact.
-      pid = Process.spawn("rm example.wasm", chdir: "spec/fixtures/components")
+      pid = Process.spawn("rm rust_app.wasm", chdir: "spec/fixtures/components")
       Process.wait(pid)
     end
 
     desc "Compile the fixture apps"
-    task :compile do
-      pwd = "spec/fixtures/components/example"
+    task :compile_rust do
+      pwd = "spec/fixtures/components/rust_app"
       compile_pid = Process.spawn("cargo clean && cargo build --release --target wasm32-wasip2",
                                   chdir: pwd)
       Process.wait(compile_pid)
       raise "Failed to build artifacts" unless $CHILD_STATUS.success?
 
-      move_pid = Process.spawn("mv #{pwd}/target/wasm32-wasip2/release/example.wasm #{pwd}/../example.wasm")
+      move_pid = Process.spawn("mv #{pwd}/target/wasm32-wasip2/release/rust_app.wasm #{pwd}/../rust_app.wasm")
       Process.wait(move_pid)
     end
+
+    task :compile_js do
+      pwd = "spec/fixtures/components/js_app"
+      pid = Process.spawn("npm run build", chdir: pwd)
+      Process.wait(pid)
+      raise "Failed to build artifacts" unless $CHILD_STATUS.success?
+    end
   end
 end
 
 desc "Build all fixtures"
-task fixtures: %i[fixtures:apps:clean fixtures:apps:compile]
+task fixtures: %i[fixtures:apps:clean fixtures:apps:compile_rust fixtures:apps:compile_js]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: app_bridge
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: x86_64-linux-musl
 authors:
 - Alexander Ross
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-04-03 00:00:00.000000000 Z
+date: 2025-04-14 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
@@ -21,6 +21,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
+- ".tool-versions"
 - CHANGELOG.md
 - README.md
 - Rakefile