reactor_sdk 0.1.0

data/lib/reactor_sdk/resources/comprehensive_extension.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class ComprehensiveExtension < ComprehensiveResource
+      attr_reader :data_elements, :rule_components, :rules
+
+      def initialize(resource:, data_elements:, rule_components:, rules:)
+        super(resource: resource)
+        @data_elements = Array(data_elements)
+        @rule_components = Array(rule_components)
+        @rules = Array(rules)
+      end
+
+      def associated_records
+        (@data_elements + @rule_components + @rules).uniq
+      end
+
+      def normalized_payload
+        payload = normalized_resource_payload
+        payload['associations'] = {
+          'data_elements' => summaries_for(@data_elements),
+          'rule_components' => summaries_for(@rule_components),
+          'rules' => summaries_for(@rules)
+        }
+        payload
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/comprehensive_resource.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class ComprehensiveResource
+      attr_reader :resource
+
+      def initialize(resource:)
+        @resource = resource
+      end
+
+      def associated_records
+        []
+      end
+
+      def normalized_json
+        ReactorSDK::ResourceNormalizer.to_json(normalized_payload)
+      end
+
+      protected
+
+      def normalized_resource_payload
+        ReactorSDK::ResourceNormalizer.normalize_resource(resource)
+      end
+
+      def summaries_for(resources)
+        Array(resources).map { |item| ReactorSDK::ResourceNormalizer.summary(item) }
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/comprehensive_rule.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class ComprehensiveRule < ComprehensiveResource
+      attr_reader :rule_components
+
+      def initialize(resource:, rule_components:)
+        super(resource: resource)
+        @rule_components = Array(rule_components)
+      end
+
+      def associated_records
+        @rule_components
+      end
+
+      def normalized_payload
+        payload = normalized_resource_payload
+        payload['associations'] = {
+          'rule_components' => @rule_components.map { |component| ReactorSDK::ResourceNormalizer.normalize_resource(component) }
+        }
+        payload
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/comprehensive_upstream_chain.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class ComprehensiveUpstreamChain
+      include Enumerable
+
+      attr_reader :resource_id,
+                  :resource_type,
+                  :property_id,
+                  :target_library_id,
+                  :target_resource,
+                  :target_revision_id,
+                  :target_comprehensive_resource,
+                  :entries
+
+      def initialize(
+        resource_id:,
+        resource_type:,
+        property_id:,
+        target_library_id:,
+        target_resource:,
+        target_revision_id:,
+        target_comprehensive_resource:,
+        entries:
+      )
+        @resource_id = resource_id
+        @resource_type = resource_type
+        @property_id = property_id
+        @target_library_id = target_library_id
+        @target_resource = target_resource
+        @target_revision_id = target_revision_id
+        @target_comprehensive_resource = target_comprehensive_resource
+        @entries = Array(entries)
+      end
+
+      def each(&)
+        @entries.each(&)
+      end
+
+      def nearest_match
+        @entries.find(&:present?)
+      end
+
+      def found?
+        !nearest_match.nil?
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/comprehensive_upstream_chain_entry.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class ComprehensiveUpstreamChainEntry
+      attr_reader :library, :stage, :resource, :revision_id, :revision, :comprehensive_resource
+
+      def initialize(library:, stage:, resource:, revision_id:, revision:, comprehensive_resource:)
+        @library = library
+        @stage = stage
+        @resource = resource
+        @revision_id = revision_id
+        @revision = revision
+        @comprehensive_resource = comprehensive_resource
+      end
+
+      def present?
+        !@resource.nil?
+      end
+
+      def entity_snapshot
+        @revision&.entity_snapshot
+      end
+
+      def normalized_payload
+        @comprehensive_resource&.normalized_payload
+      end
+
+      def normalized_json
+        @comprehensive_resource&.normalized_json
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/data_element.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+##
+# @file resources/data_element.rb
+# @description Represents an Adobe Launch Data Element resource.
+#
+#   Data elements are the building blocks of Adobe Launch's data layer.
+#   They define reusable values that can be referenced in rules and other
+#   data elements. Each data element is powered by an extension delegate.
+#
+#   The settings field varies across extension types:
+#     - Core custom code data elements store JavaScript in settings["source"]
+#     - Other extensions define their own settings structure
+#
+#   Use parsed_settings to access the full settings object as a Ruby Hash.
+#   This is the primary accessor for data element configuration — it covers
+#   all extension types uniformly, exactly as Adobe Launch displays settings
+#   in its own version comparison UI.
+#
+# @domain Resources
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/data-elements/
+#
+
+module ReactorSDK
+  module Resources
+    class DataElement < BaseResource
+      # @return [String] Display name of the data element
+      attribute :name
+
+      # @return [Boolean] Whether the data element is enabled
+      attribute :enabled, as: :boolean
+
+      # @return [Boolean] Whether to clean text values
+      attribute :clean_text, as: :boolean
+
+      # @return [Boolean] Whether to force lowercase
+      attribute :force_lower_case, as: :boolean
+
+      # @return [String, nil] Default value when the element returns nil
+      attribute :default_value
+
+      # @return [String, nil] How long to cache the value
+      #   One of: "none", "pageview", "session", "visitor", or seconds as string
+      attribute :storage_duration
+
+      # @return [String] Identifies the extension delegate powering this element
+      #   Format: "extension-package-name::data-element::element-name"
+      #   Example: "core::dataElements::custom-code"
+      attribute :delegate_descriptor_id
+
+      # @return [String] Raw settings value exactly as returned by Adobe.
+      #   May be a JSON-encoded string or a plain Hash depending on the extension.
+      #   Use parsed_settings for reliable Hash access.
+      attribute :settings
+
+      # @return [String] ISO8601 timestamp when the element was created
+      attribute :created_at
+
+      # @return [String] ISO8601 timestamp when the element was last updated
+      attribute :updated_at
+
+      # @return [String, nil] ISO8601 timestamp when the element was last published
+      attribute :published_at
+
+      ##
+      # Returns the settings field parsed into a Ruby Hash.
+      #
+      # This is the primary accessor for data element configuration. It handles
+      # all extension types uniformly:
+      #   - Core custom code elements storing JavaScript as JSON-encoded string
+      #   - Any third-party extension settings structure
+      #
+      # The app can render this as formatted JSON for display and diffing —
+      # exactly as Adobe Launch does in its own version comparison UI.
+      #
+      # Behaviour by input type:
+      #   - JSON-encoded string → parsed into Hash
+      #   - Already a Hash     → returned as-is
+      #   - nil or blank       → returns empty Hash
+      #   - Unparseable string → returns empty Hash, raw value still on settings
+      #
+      # The raw settings value is always preserved on the settings attribute
+      # unchanged — this method never modifies the underlying data.
+      #
+      # @return [Hash] Parsed settings or empty hash if nil, blank, or unparseable
+      #
+      def parsed_settings
+        raw = @attributes['settings']
+        return {} if raw.nil? || raw == ''
+        return raw if raw.is_a?(Hash)
+
+        JSON.parse(raw)
+      rescue JSON::ParserError
+        {}
+      end
+
+      ##
+      # @return [String] Human-readable representation
+      #
+      def inspect
+        '#<ReactorSDK::Resources::DataElement ' \
+          "id=#{id.inspect} " \
+          "name=#{name.inspect} " \
+          "delegate=#{delegate_descriptor_id.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/environment.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+##
+# @file resources/environment.rb
+# @description Represents an Adobe Launch Environment resource.
+#
+#   Environments map to deployment targets within a property.
+#   Each property has three built-in environments: development,
+#   staging, and production. Additional environments can be created
+#   for personal developer sandboxes.
+#
+# @domain Resources
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/environments/
+#
+
+module ReactorSDK
+  module Resources
+    class Environment < BaseResource
+      # @return [String] Display name of the environment
+      attribute :name
+
+      # @return [String] Stage — one of: "development", "staging", "production"
+      attribute :stage
+
+      # @return [Boolean] Whether the environment is archived
+      attribute :archived, as: :boolean
+
+      # @return [String, nil] Embed code for this environment
+      attribute :token
+
+      # @return [String] ISO8601 timestamp when the environment was created
+      attribute :created_at
+
+      # @return [String] ISO8601 timestamp when the environment was last updated
+      attribute :updated_at
+
+      ##
+      # @return [String] Human-readable representation
+      #
+      def inspect
+        "#<ReactorSDK::Resources::Environment id=#{id.inspect} name=#{name.inspect} stage=#{stage.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/extension.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+##
+# @file resources/extension.rb
+# @description Represents an Adobe Launch Extension resource.
+#
+#   Extensions provide the delegates (conditions, actions, data element
+#   types) available within a property. The Core extension is always
+#   present. Third-party extensions such as Adobe Analytics are installed
+#   separately. Extension versions are tracked via delegate_descriptor_id.
+#
+# @domain Resources
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/extensions/
+#
+
+module ReactorSDK
+  module Resources
+    class Extension < BaseResource
+      # @return [String] Identifies the extension package and version
+      attribute :delegate_descriptor_id
+
+      # @return [String] Display name of the extension
+      attribute :name
+
+      # @return [String] Raw settings value exactly as returned by Adobe
+      attribute :settings
+
+      # @return [String] ISO8601 timestamp when the extension was installed
+      attribute :created_at
+
+      # @return [String] ISO8601 timestamp when the extension was last updated
+      attribute :updated_at
+
+      # @return [String, nil] ISO8601 timestamp when the extension was published
+      attribute :published_at
+
+      ##
+      # Returns the settings field parsed into a Ruby Hash.
+      #
+      # Extension-level settings vary by extension type. Use this for
+      # display and diffing — exactly as Adobe Launch does in its own
+      # version comparison UI.
+      #
+      # @return [Hash] Parsed settings or empty hash if nil, blank, or unparseable
+      #
+      def parsed_settings
+        raw = @attributes['settings']
+        return {} if raw.nil? || raw == ''
+        return raw if raw.is_a?(Hash)
+
+        JSON.parse(raw)
+      rescue JSON::ParserError
+        {}
+      end
+
+      ##
+      # @return [String] Human-readable representation
+      #
+      def inspect
+        '#<ReactorSDK::Resources::Extension ' \
+          "id=#{id.inspect} " \
+          "delegate=#{delegate_descriptor_id.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/extension_package.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+##
+# @file resources/extension_package.rb
+# @description Represents an Adobe Launch Extension Package resource.
+#
+#   Extension packages are the installable packages behind property extensions.
+#   They are returned when traversing extension relationships or audit events
+#   that reference package changes.
+#
+# @domain Resources
+#
+
+module ReactorSDK
+  module Resources
+    class ExtensionPackage < BaseResource
+      # @return [String] Package name
+      attribute :name
+
+      # @return [String, nil] Human-readable display name
+      attribute :display_name
+
+      # @return [String, nil] Supported platform, such as "web" or "edge"
+      attribute :platform
+
+      # @return [String, nil] Package availability
+      attribute :availability
+
+      # @return [String, nil] Package version
+      attribute :version
+
+      # @return [String] ISO8601 timestamp when the package was created
+      attribute :created_at
+
+      # @return [String] ISO8601 timestamp when the package was last updated
+      attribute :updated_at
+
+      ##
+      # @return [String] Human-readable representation
+      #
+      def inspect
+        '#<ReactorSDK::Resources::ExtensionPackage ' \
+          "id=#{id.inspect} " \
+          "name=#{name.inspect} " \
+          "version=#{version.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/extension_package_usage_authorization.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class ExtensionPackageUsageAuthorization < BaseResource
+      attribute :name
+      attribute :platform
+      attribute :owner_org_id
+      attribute :owner_org_name
+      attribute :authorized_org_id
+      attribute :authorized_org_name
+      attribute :state
+      attribute :created_by_email
+      attribute :created_by_display_name
+      attribute :updated_by_email
+      attribute :updated_by_display_name
+      attribute :created_at
+      attribute :updated_at
+
+      def inspect
+        '#<ReactorSDK::Resources::ExtensionPackageUsageAuthorization ' \
+          "id=#{id.inspect} authorized_org_id=#{authorized_org_id.inspect} state=#{state.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/host.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+##
+# @file resources/host.rb
+# @description Represents an Adobe Launch Host resource.
+#
+#   Hosts define where Adobe Launch builds are deployed. Every environment
+#   requires a host assignment before it can be created. Adobe manages
+#   the default Akamai host automatically — most properties have exactly
+#   one host of type "akamai".
+#
+#   Hosts must be fetched before creating an environment so the correct
+#   host ID can be included in the environment creation payload.
+#
+# @domain Resources
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/hosts/
+#
+
+module ReactorSDK
+  module Resources
+    class Host < BaseResource
+      # @return [String] Display name of the host
+      attribute :name
+
+      # @return [String] Host type — typically "akamai" for Adobe-managed hosts
+      attribute :type_of
+
+      # @return [String] Host status — "succeeded", "failed", "pending"
+      attribute :status
+
+      # @return [String] ISO8601 timestamp when the host was created
+      attribute :created_at
+
+      # @return [String] ISO8601 timestamp when the host was last updated
+      attribute :updated_at
+
+      ##
+      # Returns true if the host is an Adobe-managed Akamai host.
+      # Most properties have exactly one Akamai host by default.
+      #
+      # @return [Boolean]
+      #
+      def akamai?
+        type_of == 'akamai'
+      end
+
+      ##
+      # Returns true if the host is ready for use.
+      #
+      # @return [Boolean]
+      #
+      def ready?
+        status == 'succeeded'
+      end
+
+      ##
+      # @return [String] Human-readable representation
+      #
+      def inspect
+        '#<ReactorSDK::Resources::Host ' \
+          "id=#{id.inspect} " \
+          "name=#{name.inspect} " \
+          "type_of=#{type_of.inspect} " \
+          "status=#{status.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/library.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+##
+# @file resources/library.rb
+# @description Represents an Adobe Launch Library resource.
+#
+#   A library is a collection of rules, data elements, and extensions
+#   that gets built into a deployable JavaScript bundle. Libraries move
+#   through a state machine: development -> submitted -> approved ->
+#   rejected -> published. Each library is assigned to one environment.
+#
+# @domain Resources
+# @see https://developer.adobe.com/experience-platform/documentation/tags/api/endpoints/libraries/
+#
+
+module ReactorSDK
+  module Resources
+    class Library < BaseResource
+      # @return [String] Display name of the library
+      attribute :name
+
+      # @return [String] Current state of the library in its workflow
+      #   One of: "development", "submitted", "approved", "rejected", "published"
+      attribute :state
+
+      # @return [Boolean] Whether the library has been published
+      attribute :published, as: :boolean
+
+      # @return [String] ISO8601 timestamp when the library was created
+      attribute :created_at
+
+      # @return [String] ISO8601 timestamp when the library was last updated
+      attribute :updated_at
+
+      # @return [String, nil] ISO8601 timestamp when the library was published
+      attribute :published_at
+
+      # @return [String, nil] ISO8601 timestamp when the library build completed
+      attribute :build_required_detail
+
+      ##
+      # Returns true if the library is in a state where it can be built.
+      #
+      # @return [Boolean]
+      #
+      def buildable?
+        state == 'development'
+      end
+
+      ##
+      # Returns true if the library has been successfully published.
+      #
+      # @return [Boolean]
+      #
+      def published?
+        state == 'published'
+      end
+
+      ##
+      # @return [String] Human-readable representation
+      #
+      def inspect
+        "#<ReactorSDK::Resources::Library id=#{id.inspect} name=#{name.inspect} state=#{state.inspect}>"
+      end
+    end
+  end
+end

data/lib/reactor_sdk/resources/library_comparison.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module ReactorSDK
+  module Resources
+    class LibraryComparison
+      include Enumerable
+
+      attr_reader :current_library_id,
+                  :baseline_library_id,
+                  :property_id,
+                  :current_snapshot,
+                  :baseline_snapshot,
+                  :entries
+
+      def initialize(
+        current_library_id:,
+        baseline_library_id:,
+        property_id:,
+        current_snapshot:,
+        baseline_snapshot:,
+        entries:
+      )
+        @current_library_id = current_library_id
+        @baseline_library_id = baseline_library_id
+        @property_id = property_id
+        @current_snapshot = current_snapshot
+        @baseline_snapshot = baseline_snapshot
+        @entries = Array(entries)
+      end
+
+      def current_library
+        @current_snapshot.library
+      end
+
+      def baseline_library
+        @baseline_snapshot.library
+      end
+
+      def each(&)
+        @entries.each(&)
+      end
+
+      def added_entries
+        @entries.select(&:added?)
+      end
+
+      def removed_entries
+        @entries.select(&:removed?)
+      end
+
+      def modified_entries
+        @entries.select(&:modified?)
+      end
+
+      def unchanged_entries
+        @entries.select(&:unchanged?)
+      end
+
+      def changed_entries
+        @entries.reject(&:unchanged?)
+      end
+
+      def changeset_documents(include_unchanged: false)
+        selected_entries = include_unchanged ? @entries : changed_entries
+
+        selected_entries.each_with_index.map do |entry, index|
+          entry.changeset_document(position: index)
+        end
+      end
+    end
+  end
+end