has_helpers 5.0.2

data/app/constants/color.rb

@@ -0,0 +1,9 @@
+# typed: strict
+# frozen_string_literal: true
+
+class Color < Option
+  self.simple = true
+  include HasHelpers::Constant
+
+  define_constants "Blue", "Brown", "Green", "Orange", "Pink", "Purple", "Red", "Neutral", "Yellow", "Grey"
+end

data/app/constants/file_format.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+class FileFormat < Option
+  self.simple = true
+
+  define_constant("CSV").meta.icon = :file_pdf_o
+  define_constant("PDF").meta.icon = :file_text_o
+  define_constant("XLSX").meta.icon = :file_excel_o
+  define_constant("ACH").meta.icon = :file_text_o
+  define_constant("JSON").meta.icon = :file_json_o
+end

data/app/constants/has_helpers/cards/card_custom_field.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module Cards
+    class CardCustomField < ::Option
+      include HasHelpers::Constant
+      self.simple = true
+    end
+
+    deprecate_constant :CardCustomField
+  end
+end

data/app/constants/has_helpers/cards/card_data_type.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module Cards
+    class CardDataType < ::Option
+      include HasHelpers::Constant
+      self.simple = true
+      define_constants("Numeric", "Date", "String", "Link", "Address", "Email", "Phone", "Boolean", "Badge", "BadgeList", "Title", "HoverCard")
+    end
+  end
+end

data/app/constants/has_helpers/cards/card_identifier.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module Cards
+    class CardIdentifier < ::Option
+      include HasHelpers::Constant
+      self.simple = true
+    end
+  end
+end

data/app/constants/has_helpers/cards/card_layout_type.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module Cards
+    class CardLayoutType < ::Option
+      include HasHelpers::Constant
+      self.simple = true
+      define_constants("Summary", "CompositeList", "List", "Badge", "Text", "Scratchpad", "Compact")
+    end
+  end
+end

data/app/constants/has_helpers/cards/card_variant_type.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module Cards
+    class CardVariantType < ::Option
+      include HasHelpers::Constant
+      self.simple = true
+
+      define_constants("Emails", "Websites", "Phones")
+    end
+  end
+end

data/app/constants/has_helpers/link_type.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  class LinkType < Option
+    include ::HasHelpers::Constant
+    self.simple = true
+
+    define_constants("SideNav", "ResourceTab")
+  end
+end

data/app/constants/has_helpers/notification_alert_status.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  class NotificationAlertStatus < Option
+    include HasHelpers::Constant
+    self.simple = true
+
+    define_constants(
+      "Unread",
+      "Read",
+      "Dismissed"
+    )
+  end
+end

data/app/constants/has_helpers/notification_alert_type.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  class NotificationAlertType < Option
+    include HasHelpers::Constant
+    self.simple = true
+
+    define_constants("AlertNav", "SystemWarning", "CalendarEvent", "DataImport")
+  end
+end

data/app/constants/has_helpers/operation.rb

@@ -0,0 +1,11 @@
+# typed: strict
+# frozen_string_literal: true
+
+module HasHelpers
+  class Operation < Option
+    include ::HasHelpers::Constant
+    self.simple = true
+
+    define_constants "Create", "Update", "Delete", "View", "Import", "Export", "Merge", "Copy", "Convert"
+  end
+end

data/app/constants/has_helpers/resource_type.rb

@@ -0,0 +1,25 @@
+# typed: strict
+# frozen_string_literal: true
+
+# Base is for Advisors
+# Split is for Designation ("LinkedUser", "MarketingSystem", "Photo", "Commissions" for Advisor) parent relation saved in nested_resources table
+# Sub is for Supplies/Attachments (they have no sense to live on their own, they are always attached to something)
+# Type is for STI, Ticket they are type of base resources. e.g. ticket is a type of Policy, NMO is a type of Firm
+# Field is for code_name (it's a field that's not required of the base resource) parent saved in nested_resources table
+# RequiredField is for advisor_status (it's a field that is required) parent saved in nested_resources table
+# Action is for delete/edit/etc
+# Card is for Premium, Demographics card, etc
+# FieldOption is for the options of a field that has types e.g. advisor_status values
+# RequiredFieldOption is for the options of a required
+# Nested is for nested attribute e.g. demographic
+# FieldGroup is for Form sections. Inside Advisor, Hobbies is a form section
+# Text is for side navigation bar elements e.g., side navigation calendar element
+
+module HasHelpers
+  class ResourceType < Option
+    include ::HasHelpers::Constant
+    self.simple = true
+
+    define_constants "Base", "Nested", "Field", "FieldOption", "RequiredField", "Action", "Card", "Sub", "Split", "Type", "FieldGroup", "Text", "AccessorField"
+  end
+end

data/app/constants/icon.rb

@@ -0,0 +1,22 @@
+# typed: strict
+# frozen_string_literal: true
+
+class Icon < ::Option
+  self.simple = true
+
+  define_constant("Angle Down").meta.icon = :"angle-down"
+  define_constant("Angle Left").meta.icon = :"angle-left"
+  define_constant("Angle Right").meta.icon = :"angle-right"
+  define_constant("Angle Up").meta.icon = :"angle-up"
+  define_constant("Arrow Down").meta.icon = :"arrow-alt-down"
+  define_constant("Arrow Left").meta.icon = :"arrow-alt-left"
+  define_constant("Arrow Right").meta.icon = :"arrow-alt-right"
+  define_constant("Arrow Up").meta.icon = :"arrow-alt-up"
+  define_constant("Asterisk").meta.icon = :asterisk
+  define_constant("Bolt").meta.icon = :bolt
+  define_constant("Check").meta.icon = :check
+  define_constant("Circle").meta.icon = :circle
+  define_constant("Comment").meta.icon = :comment
+  define_constant("Dollar").meta.icon = :"dollar-sign"
+  define_constant("Star").meta.icon = :star
+end

data/app/constants/logical_operator.rb

@@ -0,0 +1,7 @@
+# typed: strict
+# frozen_string_literal: true
+
+class LogicalOperator
+  AND = "and"
+  OR = "or"
+end

data/app/constants/option.rb

@@ -0,0 +1,10 @@
+# typed: strong
+# frozen_string_literal: true
+
+class Option < ::ActiveRecord::Base
+  include ::HasHelpers::Constant
+  self.abstract_constant_class = true
+
+  default_scope { where("option_type = ?", self.name) if self.name != "Option" && self.has_attribute?(:option_type) }
+  default_scope { where("group_id IS NOT NULL") if self.grouped }
+end

data/app/constants/time_zone.rb

@@ -0,0 +1,12 @@
+# typed: strict
+# frozen_string_literal: true
+
+class TimeZone < ::ActiveRecord::Base
+  include ::HasHelpers::Constant
+
+  time_zones = ActiveSupport::TimeZone.us_zones.filter { |el| el.tzinfo.canonical_zone.name != el.name }.map do |tz|
+    tz.name.to_constant(key: tz.name.sub(/(?<!\s)\s*\([^)]*\)/, "").constant_case, pg_timezone_name: tz.tzinfo.name) # Regex removes parenthesized portions of time zone names, e.g. "Central Time (US & Canada)" => "Central Time"
+  end
+
+  define_constants(*time_zones)
+end

data/app/constructors/has_helpers/base_constructor.rb

@@ -0,0 +1,62 @@
+# typed: false
+# frozen_string_literal: true
+
+module HasHelpers
+  class BaseConstructor < SimpleDelegator
+    alias object __getobj__
+
+    class << self
+      attr_reader :has_many_ids_associations
+
+      # Sets up the constructor to handle `[association_ids]` attributes, without
+      # immediately executing the database statements, which is the Rails default.
+      #
+      # == Example
+      # Class Report::Constructor < :HasHelpersBaseConstructor
+      #    # class Report has an association: `has_many :users, through: :shares`
+      #    has_many_ids :users
+      # end
+      #
+      # The example above will allow `report[user_ids]` attribute to be set
+      # and build the associated objects in memory. In this case, if
+      # `report[user_ids] = [1]`, it will execute `report.shares.build(user_id: 1)`
+      # Any existing objects with the ids not included in this parameter will
+      # be marked for destruction.
+      def has_many_ids(*associations)
+        @has_many_ids_associations ||= []
+        @has_many_ids_associations.concat associations
+      end
+    end
+
+    def assign_attributes(object_attrs)
+      attrs = object_attrs.dup
+
+      # Build/destroy has_many objects from "object_ids" params
+      self.class.has_many_ids_associations.each do |association_name|
+        association = object.class.reflect_on_association(association_name)
+        association_key = association.foreign_key.to_s.pluralize
+        association_to_build = association.through_reflection
+
+        if attrs[association_key]
+          association_primary_key = association.association_primary_key.to_s
+          type_caster = association.klass.type_caster
+
+          # Get ids from parameters, casting them to their correct type for the database.
+          object_ids = attrs.delete(association_key).select(&:present?).map { |val| type_caster.type_cast_for_database(association_primary_key, val) }
+          persisted_object_ids = object.send(association.name).map(&:id)
+
+          # Mark for destruction any object that's not included in the attributes.
+          object.send(association_to_build.name).reject do |assc_object|
+            # skip any object that doesn't have this foreign key set.
+            assc_object.send(association.foreign_key).blank? || object_ids.include?(assc_object.send(association.foreign_key))
+          end.each(&:mark_for_destruction)
+          (object_ids - persisted_object_ids).each do |new_object_id|
+            object.send(association_to_build.name).build(association.foreign_key => new_object_id)
+          end
+        end
+      end
+
+      object.assign_attributes(attrs)
+    end
+  end
+end

data/app/controllers/concerns/has_helpers/service_trust/authenticated_as_service.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module ServiceTrust
+    module AuthenticatedAsService
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :_service_trust_audience
+        class_attribute :_service_trust_capability
+        before_action :require_service_trust!
+        rescue_from HasHelpers::ServiceTrust::Error, with: :render_service_trust_error
+      end
+
+      class_methods do
+        def service_trust_audience(name)
+          self._service_trust_audience = name.to_s
+        end
+
+        def service_trust_capability(name)
+          self._service_trust_capability = name
+        end
+      end
+
+      private
+
+      def require_service_trust!
+        token = HasHelpers::ServiceTrust::BearerToken.extract!(request.authorization)
+        result = HasHelpers::ServiceTrust::Verifier.verify!(
+          token,
+          expected_audience: self.class._service_trust_audience || HasHelpers::ServiceTrust.config.issuer,
+          request: request
+        )
+        request.env["service_trust.token"] = result.claims
+        request.env["service_trust.capabilities"] = result.capabilities
+        request.env["service_trust.result"] = result
+        return if self.class._service_trust_capability.nil?
+
+        HasHelpers::ServiceTrust::Authorization.require!(
+          { capabilities: result.capabilities },
+          capability: self.class._service_trust_capability
+        )
+      end
+
+      def render_service_trust_error(error)
+        status = HasHelpers::ServiceTrust::VerifyMiddleware::STATUS_FOR_ERROR.fetch(error.class, 401)
+        render json: { error: error.class.name.demodulize }, status: status
+      end
+    end
+  end
+end

data/app/controllers/concerns/has_helpers/service_trust/graphql_authentication.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module HasHelpers
+  module ServiceTrust
+    module GraphQLAuthentication
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :_service_trust_audience
+        before_action :require_service_trust_for_graphql!
+        rescue_from HasHelpers::ServiceTrust::Error, with: :render_service_trust_error
+      end
+
+      class_methods do
+        def service_trust_audience(name)
+          self._service_trust_audience = name.to_s
+        end
+      end
+
+      def service_trust_context
+        {
+          service_trust: {
+            issuer: @_service_trust_result.claims["iss"],
+            subject: @_service_trust_result.claims["sub"],
+            jti: @_service_trust_result.claims["jti"],
+            capabilities: @_service_trust_result.capabilities
+          },
+          authorize: service_trust_graphql_authorizer
+        }
+      end
+
+      private
+
+      def require_service_trust_for_graphql!
+        token = HasHelpers::ServiceTrust::BearerToken.extract!(request.authorization)
+        @_service_trust_result = HasHelpers::ServiceTrust::Verifier.verify!(
+          token,
+          expected_audience: self.class._service_trust_audience || HasHelpers::ServiceTrust.config.issuer,
+          request: request
+        )
+      end
+
+      def render_service_trust_error(error)
+        status = HasHelpers::ServiceTrust::VerifyMiddleware::STATUS_FOR_ERROR.fetch(error.class, 401)
+        render json: { error: error.class.name.demodulize }, status: status
+      end
+
+      def service_trust_graphql_authorizer
+        @service_trust_graphql_authorizer ||= lambda do |_action, *_args|
+          true
+        end
+      end
+    end
+
+    GraphqlAuthentication = GraphQLAuthentication unless const_defined?(:GraphqlAuthentication, false)
+  end
+end

data/app/controllers/has_helpers/controller.rb

@@ -0,0 +1,63 @@
+# typed: false
+# frozen_string_literal: true
+
+require "csv"
+
+module HasHelpers
+  module Controller
+    include ::HasHelpers::XlsxExport
+
+    def base_path
+      @base_path ||= request.path_info.split("/")[1].to_s
+    end
+
+    private
+
+    def document_formats
+      request.format = :csv if params[:csv]
+      request.format = :pdf if params[:pdf]
+      request.format = :xlsx if params[:xlsx]
+      request.format = :ach if params[:ach]
+      request.format = :json if params[:json]
+    end
+
+    def send_csv(csv, filename)
+      headers["Content-Disposition"] = %Q(attachment; filename="#{filename}")
+      headers["Content-Type"] = "text/csv"
+      send_data(csv, filename: filename, type: ::Mime[:csv].to_s)
+    end
+
+    def send_json(json_data, filename)
+      headers["Content-Disposition"] = %Q(attachment; filename="#{filename}")
+      headers["Content-Type"] = "application/json"
+      send_data(json_data, filename: filename, type: ::Mime[:json].to_s)
+    end
+
+    # Removed #render_csv because it appears to be dead code
+
+    def render_pdf(filename, template, orientation = "Landscape", **options)
+      headers["Content-Type"] = "application/octet-stream"
+      headers["Content-Disposition"] = "attachment; filename=\"#{filename}.pdf\""
+      render options.reverse_merge(pdf: filename, template: "#{template}", disposition: "attachment", formats: [:html], orientation: orientation)
+    end
+
+    # Should these "list" methods be move into has_lists?
+    #=== Options
+    # +:attrs+ Display columns for only this given list of attributes. Defaults to all selected or default attributes for the given list.
+    def render_list_csv(list, results, attrs: list.selected_or_default_attributes, header: nil)
+      csv = ::CSV.generate_line(header.presence || attrs)
+      results.each { |e| csv << ::CSV.generate_line(attrs.map { |a| e[a] }) } if results.loaded? ? results.any? : results.exists?
+      send_csv(csv, "#{list.name.presence || list.model_class_name.pluralize}.csv")
+    end
+
+    def render_list_pdf(list, list_presenter = @list_presenter)
+      @list_presenter = list_presenter  # Instance variable needed in table template
+      base_resource = instance_variable_get("@#{ base_path.singularize }")
+      @details = base_resource.try(:details)
+      @organization = current_user.organization
+      @photo_uri = @organization&.inline_logo_uri
+
+      render_pdf((list.name.presence || list.model_class_name.pluralize), "/has_lists/lists/_table")
+    end
+  end
+end