caixanegra 0.1.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df3d38ccee4981c27d6acb8e72bc4c40c00537c6c370cdc17581de1dc179ac3f
-  data.tar.gz: 4bad76dfbfb9834d19389a28f92a7b3a7a1208c9cdf230a43fc4f9faf6322fb4
+  metadata.gz: ece5f658699dfddfd51744c4f78b12b207e9e7108359e9d6d4f39366a494987e
+  data.tar.gz: 0e0fca0b8abdcc03cfd9851563105300d4a6033206917df7fe7d3d49a3cd00d7
 SHA512:
-  metadata.gz: 464c5ebbc06fa24c1f6f9261dd9e4241dff7bbfc8ccca0f067de5f289e5bda3a4e658475c8b15fa72971574748927016e5e23eed6020a0eda94580e7e85128ed
-  data.tar.gz: 55fcf0df7d3aac4d6e4458728cab6f3cfe874014903d47b5e4de1976290d8728cccdd28a687a748e43b5338bb6090b94596bb56fb43437ebbf203934c525717a
+  metadata.gz: 4db14867bd4861f76e4ffe49be5f8c35094b6f16e045bb6b2023b72067780e06faac4ea6f0afdd483b4f1dec847d6888c28060abc4dbf443aab10505782b64dd
+  data.tar.gz: df495aa1270c312c87f52b194a93a4c3022db83203b71a24256321e3af5f33489cd02b9b01f6c645402299195f4890623253b78fc6f081bee5f157d17aaf22b4

data/README.md

@@ -16,8 +16,8 @@ or
 bundler add caixanegra
 ```
 # Getting Started
-**caixanegra** implements a self-contained designer, which only requires Redis to be able to receive and report back flow descriptors.  
-To get started, the only thing you need is to point to your Redis instance and point which classes on your codebase should represent units.
+**caixanegra** implements a self-contained flow designer and executor.  
+To get started, the only thing you need is to point to your [transient store](https://github.com/sergiorribeiro/caixanegra/wiki/The-Transient-Store) implementation and point out which classes on your codebase should represent units.
 
 First, mount the engine. Add the line below to `routes.rb` file:
 
@@ -29,19 +29,17 @@ Then, let's create a `caixanegra.rb` initializer (or any name you prefer)
 
 ```ruby
 Caixanegra.setup do |config|
-  config.units = {
-    awesome_unit: Caixanegra::Units::AU,
-    another_awesome_unit: Some::Other::Namespace::AAU,
-    you_can_also: {
-      scope_units: Caixanegra::Units::ScopedUnit,
-    },
-  }
-  config.redis = Redis.new
+  config.units = [
+    Caixanegra::Units::AwesomeUnit,
+    Some::Other::Namespace::AnotherAwesomeUnit,
+    Caixanegra::Units::SuperUnit,
+  ]
+  config.transient_store = GreatTransientStore.new
 end
 ```
 
 With the designer configured, you can use `Caixanegra::Manager` to handle the previously stored definition (or an empty one).  
-This will give you the UID that **caixanegra** designer will understand.  
+This will give you the UID that **caixanegra** designer will understand, using transient store.  
 
 ```ruby
 my_flow = somewhere.get_flow # get from your own persistence or transport solution
@@ -54,15 +52,13 @@ You can then safely navigate to the designer.
 link_to "Some flow", "/caixanegra/design/#{@uid}?unit_scope=optional_scope,another_optional_scope", target: :_blank
 ```
 
-Saved changes will update the flow definition on Redis, and you must then persist them. You can get the flow definition for any specified **caixanegra** handled UID:
+Saved changes will update the flow definition through the transient store, and you must then persist them. You can get the flow definition for any specified **caixanegra** handled UID, given that the transient store is able to correctly sort them out:
 
 ```ruby
 updated_flow = Caixanegra::Manager.get(my_uid)
 persist_flow(updated_flow) # your own persistence or transport solution. It's a JSON
 ```
 
-**NOTE:** There's currently no managed way to set callbacks on save actions from the designer. Working on it
-
 Please, refer to [the wiki](https://github.com/sergiorribeiro/caixanegra/wiki) to get to know more about [units](https://github.com/sergiorribeiro/caixanegra/wiki/Anatomy-of-a-unit).
 
 # License

data/app/assets/javascripts/caixanegra/designer.js

@@ -3,6 +3,7 @@ window.Caixanegra.Designer = {
     #drawValues;
     title;
     class;
+    color;
     type;
     exits;
     mappings;
@@ -20,6 +21,7 @@ window.Caixanegra.Designer = {
       this.class = params.class || "unspecified";
       this.exits = params.exits || [];
       this.mappings = params.mappings || {};
+      this.color = params.color;
       this.#drawValues = {};
       this.MARGIN = 10;
       this.SNAP = 10;
@@ -36,7 +38,9 @@ window.Caixanegra.Designer = {
 
       this.size.x = this.UNIT_WIDTH;
       let hCursor = this.#drawValues.position.y;
-      this.#drawValues.unitBgColor = Caixanegra.Designer.typeColor(this.type);
+      const typeColor = Caixanegra.Designer.typeColor(this);
+      this.#drawValues.unitBgColor = typeColor.background;
+      this.#drawValues.unitFgColor = typeColor.foreground;
       this.#drawValues.text = {};
       this.#drawValues.exitRectangles = [];
 
@@ -83,25 +87,25 @@ window.Caixanegra.Designer = {
     }
 
     update(context) {
-      if (context.mouse.down && 
+      if (context.mouse.down &&
           context.mouse.down.button === 1 &&
-          context.mouse.down.cursorAt && 
+          context.mouse.down.cursorAt &&
           context.mouse.down.cursorAt.object.oid === this.oid) {
             this.#beingDragged = true;
       } else {
         this.#beingDragged = false;
       }
 
-      if (context.mouse.move && 
+      if (context.mouse.move &&
           context.mouse.move.button === 1 &&
-          context.mouse.down && 
-          context.mouse.down.cursorAt && 
+          context.mouse.down &&
+          context.mouse.down.cursorAt &&
           context.mouse.down.cursorAt.object.oid === this.oid) {
             const intersection = new Sabertooth.Vector2(
               context.mouse.down.cursorAt.intersection.x,
               context.mouse.down.cursorAt.intersection.y
             );
-            
+
             if (this.connectingExit === null) {
               for (let eidx = 0; eidx < this.#drawValues.exits.length; eidx++) {
                 if (this.#drawValues.exits[eidx].rectangle.intersectionPoint(intersection)) {
@@ -180,7 +184,7 @@ window.Caixanegra.Designer = {
         case "extra":
           ctx.beginPath();
           ctx.roundRect(this.#drawValues.position.x, this.#drawValues.position.y, this.size.x, this.size.y, 5);
-          ctx.fillStyle = this.#drawValues.unitBgColor;
+          ctx.fillStyle = `rgb(${this.#drawValues.unitBgColor.r}, ${this.#drawValues.unitBgColor.g}, ${this.#drawValues.unitBgColor.b})`;
           ctx.fill();
 
           ctx.beginPath();
@@ -202,18 +206,20 @@ window.Caixanegra.Designer = {
           );
           ctx.globalCompositeOperation = gco;
 
+          const rgbString = `${this.#drawValues.unitFgColor.r}, ${this.#drawValues.unitFgColor.g}, ${this.#drawValues.unitFgColor.b}`;
+
           ctx.textBaseline = "top";
           ctx.textAlign = "center";
-          ctx.fillStyle = "#000";
+          ctx.fillStyle = `rgb(${rgbString})`;
           ctx.font = "25px Helvetica";
           ctx.fillText(this.title, this.#drawValues.center.x, this.#drawValues.text.title.y, this.UNIT_WIDTH - this.MARGIN * 2);
 
-          ctx.fillStyle = "rgba(0,0,0,0.5)";
+          ctx.fillStyle = `rgba(${rgbString},0.5)`;
           ctx.font = "18px Helvetica";
           ctx.fillText(this.class, this.#drawValues.center.x, this.#drawValues.text.class.y, this.UNIT_WIDTH - this.MARGIN * 2);
 
           ctx.strokeStyle = "#FFF";
-          ctx.fillStyle = "rgba(0,0,0,0.8)";
+          ctx.fillStyle = `rgba(${rgbString},0.8)`;
           ctx.font = "bold 14px monospace";
           ctx.textAlign = "right";
           ctx.lineWidth = 2;
@@ -269,7 +275,7 @@ window.Caixanegra.Designer = {
     selectedUnit;
     flowId;
     unitScope;
-  
+
     constructor(drawingSurface) {
       this.flowId = this.#extractFlowId();
       this.unitScope = this.#extractUnitScope();
@@ -522,33 +528,64 @@ window.Caixanegra.Designer = {
         this.#catalog = response;
         const unitMenu = document.querySelector("#unitMenu");
         unitMenu.innerHTML = "";
-        this.#catalog.forEach((unitData) => {
-          const item = document.createElement("div");
-          const content = document.createElement("div");
-          const colorCode = document.createElement("div");
-          const header = document.createElement("div");
-          const name = document.createElement("span");
-          const type = document.createElement("span");
-          const description = document.createElement("div");
-          description.classList.add("description");
-          item.classList.add("unit");
-          header.classList.add("header");
-          content.classList.add("content");
-          colorCode.classList.add("color-code");
-          name.classList.add("name");
-          type.classList.add("type");
-
-          name.innerHTML = unitData.title;
-          type.innerHTML = unitData.type;
-          description.innerHTML = unitData.description;
-          colorCode.style.backgroundColor = Caixanegra.Designer.typeColor(unitData.type);
-
-          header.append(name, type);
-          content.append(header, description);
-          item.append(colorCode, content);
-          item.addEventListener("click", this.createUnit.bind(this, unitData));
-          unitMenu.appendChild(item);
+
+        const scopes = [];
+
+        this.#catalog.forEach(unit => {
+          if (unit.hasOwnProperty("scope") && Array.isArray(unit.scope)) {
+            scopes.push(...unit.scope);
+          } else {
+            scopes.push("_unscoped");
+          }
         });
+
+        [...new Set(scopes)].sort().forEach(scope => {
+          const scopeWrapper = document.createElement("div");
+          const scopeTitle = document.createElement("div");
+          const scopeUnits = document.createElement("div");
+
+          scopeWrapper.classList.add("unit-wrapper");
+          scopeTitle.classList.add("title");
+
+          scopeTitle.innerHTML = scope === "_unscoped" ? "unscoped" : scope.replace(/_/g, " ");
+          scopeWrapper.appendChild(scopeTitle);
+          scopeWrapper.appendChild(scopeUnits);
+
+          const filteredUnits = this.#catalog.filter(unit => {
+            return (unit.scope === null && scope === "_unscoped") || (unit.scope || []).includes(scope)
+          });
+
+          filteredUnits.forEach((unitData) => {
+            const item = document.createElement("div");
+            const content = document.createElement("div");
+            const colorCode = document.createElement("div");
+            const header = document.createElement("div");
+            const name = document.createElement("span");
+            const type = document.createElement("span");
+            const description = document.createElement("div");
+            description.classList.add("description");
+            item.classList.add("unit");
+            header.classList.add("header");
+            content.classList.add("content");
+            colorCode.classList.add("color-code");
+            name.classList.add("name");
+            type.classList.add("type");
+
+            name.innerHTML = unitData.title;
+            type.innerHTML = unitData.type;
+            description.innerHTML = unitData.description;
+            const typeColor = Caixanegra.Designer.typeColor(unitData).background;
+            colorCode.style.backgroundColor = `rgb(${typeColor.r}, ${typeColor.g}, ${typeColor.b})`;
+
+            header.append(name, type);
+            content.append(header, description);
+            item.append(colorCode, content);
+            item.addEventListener("click", this.createUnit.bind(this, unitData));
+            scopeUnits.appendChild(item);
+          });
+          unitMenu.appendChild(scopeWrapper);
+        });
+
         this.#loadedComponents.catalog = true;
         this.#reveal();
       });
@@ -611,7 +648,7 @@ window.Caixanegra.Designer = {
 
       this.messenger.querySelector(".message").innerHTML = message;
     }
-  
+
     createUnit(params) {
       this.#sequence++;
       const newUnit = new Caixanegra.Designer.Unit({
@@ -619,13 +656,14 @@ window.Caixanegra.Designer = {
         type: params.type,
         title: params.title,
         class: params.class,
+        color: params.color,
         zIndex: this.#sequence
       });
 
       if (params.oid) {
         newUnit.oid = params.oid;
         newUnit.position = new Sabertooth.Vector2(params.position.x, params.position.y);
-        newUnit.title = params.title;  
+        newUnit.title = params.title;
       }
 
       if (params.exits && params.exits.length > 0) {
@@ -657,7 +695,7 @@ window.Caixanegra.Designer = {
       this.#units.push(newUnit);
       this.gre.addObject(newUnit);
     }
-  
+
     removeUnit(oid) {
       const killIndex = this.#units.findIndex((unit) => {return unit.oid === oid});
       this.#units.splice(killIndex, 1);
@@ -766,7 +804,7 @@ window.Caixanegra.Designer = {
       const endObject = moments.end.cursorAt?.object;
 
       if (startObject && endObject &&
-          startObject?.connectingExit && 
+          startObject?.connectingExit &&
           startObject.oid !== endObject.oid) {
             startObject.connectingExit.reference.target = moments.end.cursorAt.object;
             startObject.connectingExit = null;
@@ -872,7 +910,7 @@ window.Caixanegra.Designer = {
         header.classList.add("hit-header");
         header.innerHTML = `hit #${idx + 1}`;
         hitWrapper.append(header);
-        
+
         let section = this.#buildStepHitFold("in", hit.in);
         if (section !== null) { hitWrapper.append(section); }
 
@@ -892,7 +930,8 @@ window.Caixanegra.Designer = {
       const pane = this.unitDetailPane;
       const debugPane = this.unitDebugHitsPane;
       const dynamicContent = pane.querySelector("#dynamicContent");
-      pane.querySelector(".color-code").style.backgroundColor = Caixanegra.Designer.typeColor(object.type);
+      const typeColor = Caixanegra.Designer.typeColor(object).background;
+      pane.querySelector(".color-code").style.backgroundColor = `rgb(${typeColor.r}, ${typeColor.g}, ${typeColor.b})`;
       pane.classList.add("-open");
 
       if (object.debugHits.length > 0) {
@@ -902,7 +941,7 @@ window.Caixanegra.Designer = {
         debugPane.querySelector("#debugData").innerHTML = "";
         debugPane.classList.remove("-open");
       }
-      
+
       pane.querySelector("#unitDetailTitle").value = object.title;
       pane.querySelector("#unitDetailClass .name").innerHTML = matrix.class;
       pane.querySelector("#unitDetailDescription").innerHTML = matrix.description;
@@ -1082,7 +1121,7 @@ window.Caixanegra.Designer = {
         });
         typeSelector.addEventListener("change", this.#unitInputTypeChanged.bind(this));
         typeSelectorHeader.append(name, typeSelector);
-        
+
         wrapper.appendChild(typeSelectorHeader);
         wrapper.appendChild(fieldDescription);
 
@@ -1114,12 +1153,48 @@ window.Caixanegra.Designer = {
               valueInput.addEventListener("change", this.#unitInputValueChanged.bind(this));
             }
             break;
+          case "boolean":
+            {
+              const trueInput = document.createElement("input");
+              const falseInput = document.createElement("input");
+              const trueInputLabel = document.createElement("label");
+              const falseInputLabel = document.createElement("label");
+              const trueRadioGroup = document.createElement("div");
+              const falseRadioGroup = document.createElement("div");
+              trueRadioGroup.classList.add("radio-group");
+              falseRadioGroup.classList.add("radio-group");
+              trueInput.setAttribute("type", "radio");
+              falseInput.setAttribute("type", "radio");
+              trueInput.setAttribute("value", 1);
+              trueInputLabel.innerHTML = "True";
+              falseInput.setAttribute("value", 0);
+              falseInputLabel.innerHTML = "False";
+              trueInput.setAttribute("name", `b${input}`);
+              falseInput.setAttribute("name", `b${input}`);
+              const value = unit.mappings[input]?.value || matrix.default || "0"
+              if (value === "1") { trueInput.setAttribute("checked", true); }
+              if (value === "0") { falseInput.setAttribute("checked", true); }
+              trueInput.addEventListener("change", this.#unitInputValueChanged.bind(this));
+              falseInput.addEventListener("change", this.#unitInputValueChanged.bind(this));
+
+              trueRadioGroup.appendChild(trueInput);
+              trueRadioGroup.appendChild(trueInputLabel);
+              falseRadioGroup.appendChild(falseInput);
+              falseRadioGroup.appendChild(falseInputLabel);
+
+              valueWrapper.appendChild(trueRadioGroup);
+              valueWrapper.appendChild(falseRadioGroup);
+            }
+            break;
         }
 
         if (unit.mappings[input]?.type !== "user") {
           valueWrapper.classList.add("-disabled");
         }
-        valueWrapper.appendChild(valueInput);
+
+        if(valueInput !== null) {
+          valueWrapper.appendChild(valueInput);
+        }
 
         wrapper.append(valueWrapper);
       } else {
@@ -1182,12 +1257,12 @@ window.Caixanegra.Designer = {
       const exitMappings = {};
 
       Array.from(exits).forEach((exit) => {
-        exitMappings[exit.dataset.exit] = 
+        exitMappings[exit.dataset.exit] =
           Array.from(exit.querySelectorAll(".exit-mapping")).map((mapping) => {
             const useValue = mapping.querySelector("input.use").value;
             const asValue = mapping.querySelector("input.as").value;
             return { use: useValue, as: asValue };
-          });        
+          });
       });
 
       for(let idx = 0; idx < unit.exits.length; idx++) {
@@ -1232,9 +1307,9 @@ window.Caixanegra.Designer = {
     #engineUpdate(ev) {
       const context = ev.detail;
 
-      if (context.mouse.move && 
+      if (context.mouse.move &&
           [1, 2].includes(context.mouse.move.button) &&
-          context.mouse.down && 
+          context.mouse.down &&
           context.mouse.down.cursorAt === null) {
         const offset = {
           x: context.mouse.move.internal_x - context.mouse.down.internal_x,
@@ -1243,7 +1318,7 @@ window.Caixanegra.Designer = {
 
         this.gre.worldCenter.x = context.mouse.down.referential.x + offset.x;
         this.gre.worldCenter.y = context.mouse.down.referential.y + offset.y;
-        
+
         for (let oidx = 0; oidx < context.objects.length; oidx++) {
           context.objects[oidx].initialize(this.gre.engineContext());
         }
@@ -1258,23 +1333,51 @@ window.Caixanegra.Designer = {
     }
   },
 
-  typeColor: (type) => {
-    switch (type) {
-      case "starter":
-        return "#65CCA9";
-      case "terminator":
-        return "#E44";
-      case "blackbox":
-        return "#EEE";
-      case "passthrough":
-        return "#c4c66a";
-      case "fork":
-        return "#ffcc5c"
-      case "feeder":
-        return "#5a92d8";
-      default:
-        return "#FFF";
+  typeColor: (unit) => {
+    let baseColor = unit.color || undefined;
+
+    if (baseColor === undefined) {
+      switch (unit.type) {
+        case "starter":
+          baseColor = "#65CCA9";
+          break;
+        case "terminator":
+          baseColor = "#E44";
+          break;
+        case "blackbox":
+          baseColor = "#EEE";
+          break;
+        case "passthrough":
+          baseColor = "#C4C66A";
+          break;
+        case "fork":
+          baseColor = "#FFCC5C"
+          break;
+        case "feeder":
+          baseColor = "#5A92D8";
+          break;
+        default:
+          baseColor = "#F00";
+          break;
+      }
+    }
+
+    hex = baseColor.replace("#", "");
+
+    if (hex.length === 3) {
+        hex = hex[0] + hex[0] + hex[1] + hex[1] + hex[2] + hex[2];
     }
+
+    const r = parseInt(hex.substring(0, 2), 16);
+    const g = parseInt(hex.substring(2, 4), 16);
+    const b = parseInt(hex.substring(4, 6), 16);
+
+    const luminance = (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255;
+
+    return {
+      background: { r, g, b },
+      foreground: luminance > 0.5 ? { r: 0, g: 0, b: 0 } : { r: 255, g: 255, b: 255 }
+    };
   }
 }
 

data/app/assets/stylesheets/caixanegra/designer.scss

@@ -119,6 +119,15 @@ $accent-contrast-color: darken($accent-color, 20%);
     transform: translateY(0%);
   }
 
+  .unit-wrapper {
+    .title {
+      font-family: Verdana, Geneva, Tahoma, sans-serif;
+      font-size: 0.7em;
+      color: rgba(0,0,0,.7);
+      margin-bottom: 5px;
+    }
+  }
+
   .unit {
     display: flex;
     flex-direction: row;
@@ -588,6 +597,9 @@ $accent-contrast-color: darken($accent-color, 20%);
 
   .unit-input {
     .unit-input-value {
+      display: flex;
+      justify-content: center;
+
       &.-disabled {
         display: none;
 
@@ -595,6 +607,18 @@ $accent-contrast-color: darken($accent-color, 20%);
           pointer-events: none;
         }
       }
+
+      .radio-group {
+        display: flex;
+
+        &:first-child {
+          margin-right: 20px;
+        }
+
+        input, label {
+          display: inline;
+        }
+      }
     }
   }
 

data/app/controllers/caixanegra/api/designer/units_controller.rb

@@ -17,13 +17,15 @@ module Caixanegra
         def units
           @units ||= ::Caixanegra::UnitHelper.scoped_units(unit_scope).map do |k, v|
             base = {
-              title: v.name,
+              scope: v.scope,
+              title: v.unit_name,
               type: v.type,
               description: v.description,
               class: k,
               exits: v.exits&.map { |e| { name: e } },
               inputs: v.inputs,
-              assignments: v.assignments
+              assignments: v.assignments,
+              color: v.color
             }
 
             base[:set] = v.set if base[:set]

data/app/models/caixanegra/unit.rb

@@ -73,11 +73,15 @@ module Caixanegra
 
       input_value.presence || @inputs[id][:default]
     rescue StandardError
-      raise(UnitIOException.new, "Unable to fetch input '#{id}'")
+      raise(UnitIOException.new(self), "Unable to fetch input '#{id}'")
     end
 
-    def name
-      self.class.name
+    def scope
+      self.class.scope
+    end
+
+    def unit_name
+      self.class.unit_name
     end
 
     def description
@@ -96,6 +100,10 @@ module Caixanegra
       self.class.set || []
     end
 
+    def color
+      self.class.color
+    end
+
     private
 
     def set_mapping_defaults
@@ -108,12 +116,25 @@ module Caixanegra
     end
 
     class << self
-      attr_reader :name, :description, :inputs, :exits, :assignments, :type
+      attr_reader(
+        :unit_name,
+        :description,
+        :inputs,
+        :exits,
+        :assignments,
+        :type,
+        :scope,
+        :color
+      )
 
       @type = :passthrough
 
+      def configure_scope(value)
+        @scope = value
+      end
+
       def configure_name(value)
-        @name = value
+        @unit_name = value
       end
 
       def configure_description(value)
@@ -135,6 +156,10 @@ module Caixanegra
       def configure_assignments(assignments)
         @assignments = assignments
       end
+
+      def configure_color(color)
+        @color = color
+      end
     end
   end
 end

data/lib/caixanegra/engine.rb

@@ -2,7 +2,7 @@
 
 module Caixanegra
   self.mattr_accessor :units
-  self.mattr_accessor :redis
+  self.mattr_accessor :transient_store
   self.units = []
 
   def self.setup(&block)

data/lib/caixanegra/exceptions.rb

@@ -1,7 +1,23 @@
 # frozen_string_literal: true
 
 module Caixanegra
-  class UnitScopedException < StandardError; end
-  class UnitIOException < StandardError; end
+  class UnitScopedException < StandardError
+    attr_reader :unit
+
+    def initialize(exception, unit)
+      @unit = unit
+      super(exception.message)
+    end
+  end
+
+  class UnitIOException < StandardError
+    attr_reader :unit
+
+    def initialize(unit)
+      @unit = unit
+      super
+    end
+  end
+
   class ContinuityException < StandardError; end
 end

data/lib/caixanegra/executor.rb

@@ -29,9 +29,9 @@ module Caixanegra
       log_console_entry 'Started'
       set_start_unit
       format_result(flow_through)
-    rescue Caixanegra::UnitScopedException => e
+    rescue Caixanegra::UnitScopedException, Caixanegra::UnitIOException => e
       log_step_exception(e)
-      log_console_entry("Unit error: #{e.message}")
+      log_console_entry("Unit '#{e.unit.oid}' error: #{e.message}")
       format_result(e.message)
     rescue => e
       log_console_entry("Error: #{e.message}")
@@ -107,7 +107,7 @@ module Caixanegra
           @storage.merge! @step_unit.current_storage
           result
         rescue => e
-          exception = Caixanegra::UnitScopedException.new(e)
+          exception = Caixanegra::UnitScopedException.new(e, @step_unit)
           exception.set_backtrace(e.backtrace)
           raise exception
         end
@@ -148,9 +148,11 @@ module Caixanegra
 
       exit_name = result[:exit_through]
       metadata = unit_metadata(@step_unit.oid)
-      log_console_entry "Next unit found through '#{exit_name}': '#{@step_unit.oid}'"
       exit_metadata = metadata[:exits].find { |ex| ex[:name] == exit_name.to_s }
-      unit(exit_metadata[:target], map_carry_over(result))
+      next_unit = unit(exit_metadata[:target], map_carry_over(result))
+      log_console_entry "Next unit found through '#{exit_name}': '#{next_unit.oid}'"
+
+      next_unit
     end
 
     def process_feeders

data/lib/caixanegra/manager.rb

@@ -4,28 +4,20 @@ module Caixanegra
   class Manager
     class << self
       def handler(flow_definition = {})
-        uid = SecureRandom.uuid.gsub('-', '')
+        transient_store = Caixanegra.transient_store
+        uid = transient_store.new_uid
 
-        Caixanegra.redis.multi do |pipeline|
-          pipeline.hset(:caixanegra, uid, JSON.dump(flow_definition))
-          pipeline.expire(:caixanegra, 1.hour)
-        end
+        transient_store.hold(uid, flow_definition)
 
         uid
       end
 
-      def destroy
-        Caixanegra.redis.hdel(:caixanegra, key)
-      end
-
       def get(uid)
-        value = Caixanegra.redis.hget(:caixanegra, uid)
-
-        JSON.parse(value) if value.present?
+        Caixanegra.transient_store.get(uid)
       end
 
       def set(uid, flow_definition)
-        Caixanegra.redis.hset(:caixanegra, uid, JSON.dump(flow_definition))
+        Caixanegra.transient_store.hold(uid, definition: flow_definition)
       end
     end
   end

data/lib/caixanegra/transient_store.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Caixanegra
+  class TransientStore
+    def get(uid)
+      raise NotImplementedError, "Transient Store needs to implement 'get(uid)'"
+    end
+
+    def hold(uid, definition: {})
+      raise NotImplementedError, "Transient Store needs to implement 'hold(uid, definition: {})'"
+    end
+
+    def new_uid
+      raise NotImplementedError, "Transient Store needs to implement 'new_uid'"
+    end
+  end
+end

data/lib/caixanegra/unit_helper.rb

@@ -2,30 +2,26 @@ module Caixanegra
   class UnitHelper
     class << self
       def scoped_units(scope)
-        all_units = {}
-        all_units = all_units.merge(Caixanegra.units.reject { |_, v| v.is_a? Hash })
+        units = {}
 
-        (scope || "").split(",").each do |current_scope|
-          all_units = all_units.merge(Caixanegra.units[current_scope.to_sym])
+        scopes = (scope || "").split(",").map(&:to_sym)
+        Caixanegra.units.each do |unit|
+          if unit.scope.nil? || unit.scope.any? { |checking_scope| scopes.include?(checking_scope) }
+            units[unit.name.demodulize.underscore.to_sym] = unit
+          end
         end
 
-        all_units
+        units
       end
 
       def all_units
-        all_units = {}
+        units = {}
 
-        Caixanegra.units.each do |k, v|
-          if v.is_a? Hash
-            v.each do |ik, iv|
-              all_units[ik] = iv
-            end
-          else
-            all_units[k] = v
-          end
+        Caixanegra.units.each do |unit|
+          units[unit.name.demodulize.underscore.to_sym] = unit
         end
 
-        all_units
+        units
       end
     end
   end

data/lib/caixanegra/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Caixanegra
-  VERSION = '0.1.2'
+  VERSION = '0.3.0'
 end

data/lib/caixanegra.rb

@@ -6,5 +6,6 @@ require 'caixanegra/engine'
 require 'caixanegra/version'
 require 'caixanegra/executor'
 require 'caixanegra/manager'
+require 'caixanegra/transient_store'
 
 module Caixanegra ; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: caixanegra
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.3.0
 platform: ruby
 authors:
 - sergiorribeiro
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-14 00:00:00.000000000 Z
+date: 2023-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -61,7 +61,6 @@ files:
 - app/controllers/caixanegra/api_controller.rb
 - app/controllers/caixanegra/application_controller.rb
 - app/controllers/caixanegra/designer_controller.rb
-- app/helpers/caixanegra/application_helper.rb
 - app/models/caixanegra/unit.rb
 - app/views/caixanegra/designer/index.html.erb
 - app/views/layouts/caixanegra/application.html.erb
@@ -72,6 +71,7 @@ files:
 - lib/caixanegra/exceptions.rb
 - lib/caixanegra/executor.rb
 - lib/caixanegra/manager.rb
+- lib/caixanegra/transient_store.rb
 - lib/caixanegra/unit_helper.rb
 - lib/caixanegra/version.rb
 - lib/tasks/caixanegra_tasks.rake

data/app/helpers/caixanegra/application_helper.rb

@@ -1,4 +0,0 @@
-module Caixanegra
-  module ApplicationHelper
-  end
-end