reactor_sdk 0.1.0

data/lib/reactor_sdk/endpoints/notes.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Endpoints
+    class Notes < BaseEndpoint
+      def find(note_id)
+        fetch_resource("/notes/#{note_id}", Resources::Note)
+      end
+    end
+  end
+end

data/lib/reactor_sdk/endpoints/profiles.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Endpoints
+    class Profiles < BaseEndpoint
+      def current
+        response = @connection.get('/profile')
+        data = response.fetch('data').dup
+        data['meta'] = response.fetch('meta', {}).merge(data.fetch('meta', {}))
+        @parser.parse(data, Resources::Profile, response: response)
+      end
+    end
+  end
+end

data/lib/reactor_sdk/endpoints/properties.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+##
+# @file endpoints/properties.rb
+# @description Endpoint group for Adobe Launch Property resources.
+#
+#   Properties are the primary container in Adobe Launch. All rules,
+#   data elements, extensions, environments, and libraries belong to
+#   a property. A company can have many properties.
+#
+# @domain Endpoints
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/properties/
+#
+
+module ReactorSDK
+  module Endpoints
+    class Properties < BaseEndpoint
+      ##
+      # Lists all properties for a given company.
+      # Follows pagination automatically — returns all properties.
+      #
+      # @param company_id [String] Adobe company ID (format: "CO" + hex string)
+      # @return [Array<ReactorSDK::Resources::Property>]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the company does not exist
+      # @raise [ReactorSDK::AuthorizationError] if the token cannot access this company
+      #
+      def list_for_company(company_id)
+        list_resources("/companies/#{company_id}/properties", Resources::Property)
+      end
+
+      ##
+      # Retrieves a single property by its Adobe ID.
+      #
+      # @param property_id [String] Adobe property ID (format: "PR" + hex string)
+      # @return [ReactorSDK::Resources::Property]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the property does not exist
+      #
+      def find(property_id)
+        fetch_resource("/properties/#{property_id}", Resources::Property)
+      end
+
+      ##
+      # Retrieves the company that owns a property.
+      #
+      # @param property_id [String] Adobe property ID
+      # @return [ReactorSDK::Resources::Company]
+      #
+      def company(property_id)
+        fetch_resource("/properties/#{property_id}/company", Resources::Company)
+      end
+
+      ##
+      # Creates a new property within a company.
+      #
+      # @param company_id [String]        Adobe company ID
+      # @param name       [String]        Display name for the property
+      # @param platform   [String]        One of: "web", "mobile", "edge"
+      # @param domains    [Array<String>] Domains — required for web properties
+      # @return [ReactorSDK::Resources::Property] The newly created property
+      # @raise [ReactorSDK::UnprocessableEntityError] if attributes are invalid
+      #
+      def create(company_id:, name:, platform:, domains: [])
+        create_resource(
+          "/companies/#{company_id}/properties",
+          'properties',
+          Resources::Property,
+          attributes: { name: name, platform: platform, domains: domains }
+        )
+      end
+
+      ##
+      # Updates an existing property.
+      #
+      # @param property_id [String] Adobe property ID
+      # @param attributes  [Hash]   Fields to update (e.g. { name: "New Name" })
+      # @return [ReactorSDK::Resources::Property] The updated property
+      # @raise [ReactorSDK::ResourceNotFoundError] if the property does not exist
+      #
+      def update(property_id, attributes)
+        update_resource(
+          "/properties/#{property_id}",
+          property_id,
+          'properties',
+          Resources::Property,
+          attributes: attributes
+        )
+      end
+
+      ##
+      # Deletes a property permanently. This action cannot be undone.
+      # All child resources (rules, data elements, environments) are also deleted.
+      #
+      # @param property_id [String] Adobe property ID
+      # @return [nil]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the property does not exist
+      #
+      def delete(property_id)
+        delete_resource("/properties/#{property_id}")
+      end
+
+      ##
+      # Creates a note on a property.
+      #
+      # @param property_id [String] Adobe property ID
+      # @param text        [String] Note body text
+      # @return [ReactorSDK::Resources::Note]
+      #
+      def create_note(property_id, text)
+        create_note_for_path("/properties/#{property_id}/notes", text)
+      end
+
+      ##
+      # Lists notes attached to a property.
+      #
+      # @param property_id [String]
+      # @return [Array<ReactorSDK::Resources::Note>]
+      #
+      def list_notes(property_id)
+        list_notes_for_path("/properties/#{property_id}/notes")
+      end
+    end
+  end
+end

data/lib/reactor_sdk/endpoints/revisions.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+##
+# @file endpoints/revisions.rb
+# @description Endpoint group for Adobe Launch Revision resources.
+#
+#   The Reactor API exposes revision history in two different shapes:
+#
+#     1. Resource-scoped revision lists
+#        GET /rules/:id/revisions
+#        GET /data_elements/:id/revisions
+#        GET /extensions/:id/revisions
+#        These return versioned resources of the same type as the parent
+#        endpoint (Rule, DataElement, Extension), newest first.
+#
+#     2. Generic revision lookups
+#        GET /revisions/:id
+#        These are used when another endpoint exposes a dedicated
+#        `revisions` resource ID, such as a `latest_revision` relationship.
+#
+#   In practice this means the list methods below return typed versioned
+#   resources, while `find` still resolves an explicit `revisions` ID into
+#   a Resources::Revision snapshot wrapper.
+#
+# @domain Endpoints
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/revisions/
+#
+
+module ReactorSDK
+  module Endpoints
+    class Revisions < BaseEndpoint
+      ##
+      # Retrieves a single generic revision by its Adobe ID.
+      #
+      # Returns the full revision including the entity snapshot — the complete
+      # attributes of the revisioned resource at this point in time. This is
+      # the primary method for fetching data needed to build a diff.
+      #
+      # Calls GET /revisions/:id which returns the revision data alongside
+      # the full resource in the included array.
+      #
+      # Note: this method expects a `revisions` resource ID (for example, an
+      # ID surfaced by a `latest_revision` relationship). It does not accept
+      # rule, data element, or extension IDs from the resource-scoped
+      # `/revisions` list endpoints.
+      #
+      # @param revision_id [String] Adobe revision ID (format: "RE" + hex string)
+      # @return [ReactorSDK::Resources::Revision] Revision with entity_snapshot populated
+      # @raise [ReactorSDK::ResourceNotFoundError] if the revision does not exist
+      #
+      def find(revision_id)
+        response = @connection.get("/revisions/#{revision_id}")
+        @parser.parse(response['data'], Resources::Revision, response: response)
+      end
+
+      ##
+      # Lists all revisions for a given rule, newest first.
+      #
+      # Returns versioned rule resources, newest first.
+      # Follows pagination automatically — returns all revisions.
+      #
+      # @param rule_id [String] Adobe rule ID (format: "RL" + hex string)
+      # @return [Array<ReactorSDK::Resources::Rule>] Versioned rules, newest first
+      # @raise [ReactorSDK::ResourceNotFoundError] if the rule does not exist
+      #
+      def list_for_rule(rule_id)
+        records = @paginator.all("/rules/#{rule_id}/revisions")
+        @parser.parse_many(records, Resources::Rule)
+      end
+
+      ##
+      # Lists all revisions for a given data element, newest first.
+      #
+      # Returns versioned data element resources, newest first.
+      # Follows pagination automatically — returns all revisions.
+      #
+      # @param data_element_id [String] Adobe data element ID (format: "DE" + hex string)
+      # @return [Array<ReactorSDK::Resources::DataElement>] Versioned data elements, newest first
+      # @raise [ReactorSDK::ResourceNotFoundError] if the data element does not exist
+      #
+      def list_for_data_element(data_element_id)
+        records = @paginator.all("/data_elements/#{data_element_id}/revisions")
+        @parser.parse_many(records, Resources::DataElement)
+      end
+
+      ##
+      # Lists all revisions for a given extension, newest first.
+      #
+      # Returns versioned extension resources, newest first.
+      # Follows pagination automatically — returns all revisions.
+      #
+      # @param extension_id [String] Adobe extension ID (format: "EX" + hex string)
+      # @return [Array<ReactorSDK::Resources::Extension>] Versioned extensions, newest first
+      # @raise [ReactorSDK::ResourceNotFoundError] if the extension does not exist
+      #
+      def list_for_extension(extension_id)
+        records = @paginator.all("/extensions/#{extension_id}/revisions")
+        @parser.parse_many(records, Resources::Extension)
+      end
+    end
+  end
+end

data/lib/reactor_sdk/endpoints/rule_components.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+##
+# @file endpoints/rule_components.rb
+# @description Endpoint group for Adobe Launch Rule Component resources.
+#
+#   Rule components are the individual conditions and actions that make
+#   up a rule. Each component references an extension delegate via
+#   delegate_descriptor_id and carries a settings hash specific to
+#   that delegate.
+#
+#   Creating a rule component:
+#     - Endpoint: POST /properties/:property_id/rule_components
+#     - The rule relationship is passed in the payload, not the URL
+#     - Requires extension relationship in the payload
+#     - settings must be a JSON-encoded string
+#
+# @domain Endpoints
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/rule-components/
+#
+
+module ReactorSDK
+  module Endpoints
+    class RuleComponents < BaseEndpoint
+      ##
+      # Lists all components for a given rule.
+      # Follows pagination automatically — returns all components.
+      #
+      # @param rule_id [String] Adobe rule ID
+      # @return [Array<ReactorSDK::Resources::RuleComponent>]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the rule does not exist
+      #
+      def list_for_rule(rule_id)
+        records = @paginator.all("/rules/#{rule_id}/rule_components")
+        records.map { |r| @parser.parse(r, Resources::RuleComponent) }
+      end
+
+      ##
+      # Retrieves a single rule component by its Adobe ID.
+      #
+      # @param rule_component_id [String] Adobe rule component ID (format: "RC" + hex)
+      # @return [ReactorSDK::Resources::RuleComponent]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the component does not exist
+      #
+      def find(rule_component_id)
+        response = @connection.get("/rule_components/#{rule_component_id}")
+        @parser.parse(response['data'], Resources::RuleComponent)
+      end
+
+      ##
+      # Creates a new rule component on a property.
+      #
+      # The component is associated with a rule via the relationships.rules
+      # payload — NOT via the URL. The endpoint is always
+      # POST /properties/:property_id/rule_components.
+      #
+      # The delegate_descriptor_id identifies which extension capability
+      # powers this component. Examples:
+      #   "core::actions::custom-code"         — Core custom code action
+      #   "core::conditions::value-comparison"  — Core value comparison condition
+      #   "core::events::click"                 — Core click event
+      #
+      # The settings field must be a JSON-encoded string matching the schema
+      # expected by the delegate. For Core custom code:
+      #   settings: JSON.generate({ source: "console.log('hi');", language: "javascript" })
+      #
+      # @param property_id            [String]  Adobe property ID
+      # @param rule_id                [String]  Adobe rule ID to attach the component to
+      # @param name                   [String]  Display name
+      # @param delegate_descriptor_id [String]  Extension delegate identifier
+      # @param settings               [String]  JSON-encoded settings string
+      # @param extension_id           [String]  Adobe extension ID providing the delegate
+      # @param rule_order             [Float]   Execution order within the rule (default: 50.0)
+      # @param order                  [Integer] Order within same-type components (default: 0)
+      # @return [ReactorSDK::Resources::RuleComponent]
+      # @raise [ReactorSDK::UnprocessableEntityError] if attributes are invalid
+      #
+      def create(
+        property_id:,
+        rule_id:,
+        name:,
+        delegate_descriptor_id:,
+        settings:,
+        extension_id:,
+        rule_order: 50.0,
+        order:      0
+      )
+        payload = build_rule_component_payload(
+          name, delegate_descriptor_id, settings,
+          extension_id, rule_id, rule_order, order
+        )
+        response = @connection.post(
+          "/properties/#{property_id}/rule_components",
+          payload
+        )
+        @parser.parse(response['data'], Resources::RuleComponent)
+      end
+
+      ##
+      # Updates an existing rule component.
+      #
+      # @param rule_component_id [String] Adobe rule component ID
+      # @param attributes        [Hash]   Fields to update
+      # @return [ReactorSDK::Resources::RuleComponent]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the component does not exist
+      #
+      def update(rule_component_id, attributes)
+        payload  = build_payload('rule_components', attributes, id: rule_component_id)
+        response = @connection.patch("/rule_components/#{rule_component_id}", payload)
+        @parser.parse(response['data'], Resources::RuleComponent)
+      end
+
+      ##
+      # Deletes a rule component permanently.
+      #
+      # @param rule_component_id [String] Adobe rule component ID
+      # @return [nil]
+      # @raise [ReactorSDK::ResourceNotFoundError] if the component does not exist
+      #
+      def delete(rule_component_id)
+        @connection.delete("/rule_components/#{rule_component_id}")
+        nil
+      end
+
+      ##
+      # Retrieves the extension that owns the rule component delegate.
+      #
+      # @param rule_component_id [String]
+      # @return [ReactorSDK::Resources::Extension]
+      #
+      def extension(rule_component_id)
+        fetch_resource("/rule_components/#{rule_component_id}/extension", Resources::Extension)
+      end
+
+      ##
+      # Retrieves the origin revision head for a rule component.
+      #
+      # @param rule_component_id [String]
+      # @return [ReactorSDK::Resources::RuleComponent]
+      #
+      def origin(rule_component_id)
+        fetch_resource("/rule_components/#{rule_component_id}/origin", Resources::RuleComponent)
+      end
+
+      ##
+      # Lists rules that currently utilize a rule component.
+      #
+      # @param rule_component_id [String]
+      # @return [Array<ReactorSDK::Resources::Rule>]
+      #
+      def rules(rule_component_id)
+        list_resources("/rule_components/#{rule_component_id}/rules", Resources::Rule)
+      end
+
+      ##
+      # Lists notes attached to a rule component.
+      #
+      # @param rule_component_id [String]
+      # @return [Array<ReactorSDK::Resources::Note>]
+      #
+      def list_notes(rule_component_id)
+        list_notes_for_path("/rule_components/#{rule_component_id}/notes")
+      end
+
+      ##
+      # Creates a note on a rule component.
+      #
+      # @param rule_component_id [String]
+      # @param text [String]
+      # @return [ReactorSDK::Resources::Note]
+      #
+      def create_note(rule_component_id, text)
+        create_note_for_path("/rule_components/#{rule_component_id}/notes", text)
+      end
+
+      private
+
+      ##
+      # Builds the JSON:API payload for rule component creation.
+      # Includes both extension and rules relationships.
+      #
+      # @param name                   [String]  Display name
+      # @param delegate_descriptor_id [String]  Delegate identifier
+      # @param settings               [String]  JSON-encoded settings
+      # @param extension_id           [String]  Extension providing the delegate
+      # @param rule_id                [String]  Rule to attach this component to
+      # @param rule_order             [Float]   Rule execution order
+      # @param order                  [Integer] Component order within type
+      # @return [Hash] JSON:API compliant payload
+      #
+      def build_rule_component_payload(
+        name, delegate_descriptor_id, settings,
+        extension_id, rule_id, rule_order, order
+      )
+        {
+          data: {
+            type: 'rule_components',
+            attributes: {
+              name: name,
+              delegate_descriptor_id: delegate_descriptor_id,
+              settings: settings,
+              rule_order: rule_order,
+              order: order
+            },
+            relationships: {
+              extension: {
+                data: { id: extension_id, type: 'extensions' }
+              },
+              rules: {
+                data: [{ id: rule_id, type: 'rules' }]
+              }
+            }
+          }
+        }
+      end
+    end
+  end
+end