nquery 0.1.0

data/app/assets/config/nquery_manifest.js

@@ -0,0 +1,2 @@
+//= link nquery/application.css
+//= link nquery/application.js

data/app/components/nquery/_card_component.html.erb

@@ -0,0 +1,6 @@
+<div class="<%= component.css_class %>">
+  <% if component.title.present? %>
+    <h2 class="nq-card-title"><%= component.title %></h2>
+  <% end %>
+  <%= content %>
+</div>

data/app/components/nquery/_card_table_component.html.erb

@@ -0,0 +1,14 @@
+<div class="<%= component.css_class %>">
+  <table class="<%= component.table_class %>">
+    <thead>
+      <tr>
+        <% component.columns.each do |column| %>
+          <th><%= column %></th>
+        <% end %>
+      </tr>
+    </thead>
+    <tbody>
+      <%= content %>
+    </tbody>
+  </table>
+</div>

data/app/components/nquery/_flash_card_component.html.erb

@@ -0,0 +1,32 @@
+<div
+  class="<%= component.css_class %>"
+  role="<%= component.role %>"
+  data-controller="flash-card"
+  data-flash-card-auto-dismiss-value="<%= component.auto_dismiss? %>"
+  data-flash-card-delay-value="<%= component.delay %>"
+  data-flash-card-toast-value="<%= component.toast? %>"
+  <%= "hidden" if component.toast? %>
+>
+  <div class="nq-flash-card-icon" aria-hidden="true">
+    <% case component.type %>
+    <% when :notice %>
+      <svg width="20" height="20" viewBox="0 0 20 20" fill="none"><circle cx="10" cy="10" r="9" stroke="currentColor" stroke-width="1.5"/><path d="M6 10l2.5 2.5L14 7" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>
+    <% when :alert %>
+      <svg width="20" height="20" viewBox="0 0 20 20" fill="none"><path d="M10 6v5M10 14h.01" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/><circle cx="10" cy="10" r="9" stroke="currentColor" stroke-width="1.5"/></svg>
+    <% when :warning %>
+      <svg width="20" height="20" viewBox="0 0 20 20" fill="none"><path d="M10 7v4M10 14h.01" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/><path d="M3.5 16h13L10 4 3.5 16z" stroke="currentColor" stroke-width="1.5" stroke-linejoin="round"/></svg>
+    <% when :info %>
+      <svg width="20" height="20" viewBox="0 0 20 20" fill="none"><circle cx="10" cy="10" r="9" stroke="currentColor" stroke-width="1.5"/><path d="M10 9v5M10 6h.01" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg>
+    <% end %>
+  </div>
+  <div class="nq-flash-card-body">
+    <% component.messages.each do |message| %>
+      <p><%= message %></p>
+    <% end %>
+  </div>
+  <% if component.dismissible? %>
+    <button type="button" class="nq-flash-card-dismiss" aria-label="Dismiss" data-action="flash-card#dismiss">
+      <svg width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M4 4l8 8M12 4l-8 8" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg>
+    </button>
+  <% end %>
+</div>

data/app/components/nquery/_flash_cards_component.html.erb

@@ -0,0 +1,3 @@
+<% component.cards.each do |card| %>
+  <%= render_nquery_component(card) %>
+<% end %>

data/app/components/nquery/_infinite_scroll_component.html.erb

@@ -0,0 +1,11 @@
+<div
+  class="<%= component.css_class %>"
+  data-controller="infinite-scroll"
+  data-infinite-scroll-url-value="<%= component.url %>"
+  data-infinite-scroll-target-value="<%= component.target %>"
+>
+  <div id="<%= component.target %>" class="nq-infinite-scroll-list">
+    <%= content %>
+  </div>
+  <div class="nq-infinite-scroll-sentinel" data-infinite-scroll-target="sentinel" aria-hidden="true"></div>
+</div>

data/app/components/nquery/card_component.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Nquery
+  class CardComponent < Component
+    attr_reader :title, :html_class
+
+    def initialize(title: nil, class: nil)
+      @title = title
+      @html_class = binding.local_variable_get(:class)
+    end
+
+    def css_class
+      classes = ["nq-card"]
+      classes << html_class if html_class.present?
+      classes.join(" ")
+    end
+  end
+end

data/app/components/nquery/card_table_component.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Nquery
+  class CardTableComponent < Component
+    attr_reader :columns, :html_class, :table_class
+
+    def initialize(columns:, class: nil, table_class: "nq-table")
+      @columns = columns
+      @html_class = binding.local_variable_get(:class)
+      @table_class = table_class
+    end
+
+    def css_class
+      classes = ["nq-card", "nq-card-table"]
+      classes << html_class if html_class.present?
+      classes.join(" ")
+    end
+  end
+end

data/app/components/nquery/component.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Nquery
+  class Component
+    def self.render_in(view_context, **options, &block)
+      new(**options).render_in(view_context, &block)
+    end
+
+    def render_in(view_context, &block)
+      locals = template_locals(view_context, &block)
+      view_context.render(partial: partial_name, locals: locals)
+    end
+
+    private
+
+    def partial_name
+      "nquery/#{self.class.name.demodulize.underscore}"
+    end
+
+    def template_locals(view_context, &block)
+      locals = { component: self }
+      locals[:content] = view_context.capture(&block) if block
+      locals
+    end
+  end
+end

data/app/components/nquery/flash_card_component.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Nquery
+  class FlashCardComponent < Component
+    TYPES = %i[notice alert warning info].freeze
+    DEFAULT_DELAY = 5000
+
+    attr_reader :type, :dismissible, :html_class, :auto_dismiss, :toast, :delay
+
+    def initialize(message: nil, messages: nil, type: :notice, dismissible: true, toast: true,
+                   delay: DEFAULT_DELAY, auto_dismiss: nil, class: nil)
+      @messages = Array(messages).presence || Array(message).compact
+      @type = type.to_sym
+      @toast = toast
+      @delay = delay
+      @dismissible = dismissible
+      @auto_dismiss = auto_dismiss.nil? ? toast : auto_dismiss
+      @html_class = binding.local_variable_get(:class)
+
+      raise ArgumentError, "invalid flash type: #{@type}" unless TYPES.include?(@type)
+      raise ArgumentError, "message is required" if @messages.empty?
+    end
+
+    def messages
+      @messages
+    end
+
+    def role
+      type == :alert ? "alert" : "status"
+    end
+
+    def css_class
+      classes = ["nq-flash-card", "nq-flash-card-#{type}"]
+      classes << (toast ? "nq-flash-card-toast" : "nq-flash-card-inline")
+      classes << html_class if html_class.present?
+      classes.join(" ")
+    end
+
+    def dismissible?
+      dismissible
+    end
+
+    def auto_dismiss?
+      auto_dismiss
+    end
+
+    def toast?
+      toast
+    end
+  end
+end

data/app/components/nquery/flash_cards_component.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Nquery
+  class FlashCardsComponent < Component
+    def initialize(flash:)
+      @flash = flash
+    end
+
+    def cards
+      [].tap do |list|
+        list << FlashCardComponent.new(message: @flash[:notice], type: :notice) if @flash[:notice].present?
+        list << FlashCardComponent.new(message: @flash[:alert], type: :alert) if @flash[:alert].present?
+      end
+    end
+
+    def any?
+      cards.any?
+    end
+  end
+end

data/app/components/nquery/infinite_scroll_component.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Nquery
+  class InfiniteScrollComponent < Component
+    attr_reader :url, :target, :html_class
+
+    def initialize(url:, target: "items", class: nil)
+      @url = url
+      @target = target
+      @html_class = binding.local_variable_get(:class)
+    end
+
+    def css_class
+      classes = ["nq-infinite-scroll"]
+      classes << html_class if html_class.present?
+      classes.join(" ")
+    end
+  end
+end

data/app/controllers/concerns/nquery/breadcrumbs.rb

@@ -0,0 +1,238 @@
+# frozen_string_literal: true
+
+module Nquery
+  module Breadcrumbs
+    extend ActiveSupport::Concern
+
+    included do
+      append_before_action :set_breadcrumbs, unless: :skip_breadcrumbs?
+      helper_method :breadcrumbs
+    end
+
+    def set_breadcrumbs
+      @breadcrumbs = build_breadcrumbs
+    end
+
+    def breadcrumbs
+      @breadcrumbs || []
+    end
+
+  private
+
+    def skip_breadcrumbs?
+      auth_exempt? || controller_path == "nquery/home"
+    end
+
+    def build_breadcrumbs
+      crumbs = [{ label: "Home", path: root_path }]
+
+      case controller_path
+      when "nquery/collections"
+        append_section_breadcrumb(crumbs, "Collections", collections_path)
+
+        case action_name
+        when "show"
+          append_resource_breadcrumb(crumbs, breadcrumb_collection)
+        when "edit"
+          append_resource_breadcrumb(crumbs, breadcrumb_collection, path: collection_path(breadcrumb_collection), link: true)
+          append_terminal_breadcrumb(crumbs, "Edit")
+        when "new"
+          if breadcrumb_parent_collection
+            append_resource_breadcrumb(
+              crumbs,
+              breadcrumb_parent_collection,
+              path: collection_path(breadcrumb_parent_collection),
+              link: true
+            )
+          end
+          append_terminal_breadcrumb(crumbs, "New")
+        end
+      when "nquery/dashboards"
+        append_section_breadcrumb(crumbs, "Dashboards", dashboards_path)
+
+        case action_name
+        when "show"
+          append_resource_breadcrumb(crumbs, breadcrumb_dashboard)
+        when "edit"
+          append_resource_breadcrumb(crumbs, breadcrumb_dashboard, path: dashboard_path(breadcrumb_dashboard), link: true)
+          append_terminal_breadcrumb(crumbs, "Edit")
+        end
+      when "nquery/collection/dashboards"
+        append_section_breadcrumb(crumbs, "Collections", collections_path)
+        append_resource_breadcrumb(
+          crumbs,
+          breadcrumb_parent_collection,
+          path: collection_path(breadcrumb_parent_collection),
+          link: true
+        )
+        append_terminal_breadcrumb(crumbs, "New dashboard")
+      when "nquery/dashboard/charts"
+        append_section_breadcrumb(crumbs, "Dashboards", dashboards_path)
+        append_resource_breadcrumb(
+          crumbs,
+          breadcrumb_dashboard,
+          path: dashboard_path(breadcrumb_dashboard),
+          link: true
+        )
+
+        case action_name
+        when "show"
+          append_resource_breadcrumb(crumbs, breadcrumb_chart)
+        when "edit", "embed"
+          append_resource_breadcrumb(crumbs, breadcrumb_chart, path: dashboard_chart_path(breadcrumb_dashboard, breadcrumb_chart), link: true)
+          append_terminal_breadcrumb(crumbs, action_name.titleize)
+        when "new"
+          append_terminal_breadcrumb(crumbs, "New chart")
+        end
+      when "nquery/queries"
+        append_section_breadcrumb(crumbs, "Queries", nil)
+        append_terminal_breadcrumb(crumbs, query_breadcrumb_label)
+      when "nquery/charts"
+        append_section_breadcrumb(crumbs, "Collections", collections_path)
+        if breadcrumb_chart&.collection
+          append_resource_breadcrumb(
+            crumbs,
+            breadcrumb_chart.collection,
+            path: collection_path(breadcrumb_chart.collection),
+            link: true
+          )
+        end
+
+        case action_name
+        when "show"
+          append_resource_breadcrumb(crumbs, breadcrumb_chart)
+        when "edit", "embed"
+          append_resource_breadcrumb(crumbs, breadcrumb_chart, path: chart_path(breadcrumb_chart), link: true)
+          append_terminal_breadcrumb(crumbs, action_name.titleize)
+        when "new"
+          append_terminal_breadcrumb(crumbs, "New chart")
+        end
+      when "nquery/imports"
+        append_terminal_breadcrumb(crumbs, "Import CSV")
+      when "nquery/admin/logs"
+        append_section_breadcrumb(crumbs, "Logs", admin_logs_path)
+      when "nquery/admin/users"
+        append_section_breadcrumb(crumbs, "Users", admin_users_path)
+
+        case action_name
+        when "show"
+          append_resource_breadcrumb(crumbs, breadcrumb_user)
+        when "edit"
+          append_resource_breadcrumb(crumbs, breadcrumb_user, path: admin_user_path(breadcrumb_user), link: true)
+          append_terminal_breadcrumb(crumbs, "Edit user")
+        when "new"
+          append_terminal_breadcrumb(crumbs, "Invite user")
+        end
+      when "nquery/admin/groups"
+        append_section_breadcrumb(crumbs, "Groups", admin_groups_path)
+
+        case action_name
+        when "show"
+          append_resource_breadcrumb(crumbs, breadcrumb_group)
+        when "edit"
+          append_resource_breadcrumb(crumbs, breadcrumb_group, path: admin_group_path(breadcrumb_group), link: true)
+          append_terminal_breadcrumb(crumbs, "Edit group")
+        when "new"
+          append_terminal_breadcrumb(crumbs, "New group")
+        end
+      when "nquery/admin/data_sources"
+        append_section_breadcrumb(crumbs, "Data sources", admin_data_sources_path)
+
+        case action_name
+        when "edit"
+          append_resource_breadcrumb(
+            crumbs,
+            breadcrumb_data_source,
+            path: edit_admin_data_source_path(breadcrumb_data_source),
+            link: true
+          )
+          append_terminal_breadcrumb(crumbs, "Edit data source")
+        when "new"
+          append_terminal_breadcrumb(crumbs, "New data source")
+        end
+      when "nquery/admin/permissions"
+        append_section_breadcrumb(crumbs, "Permissions", by_group_admin_permissions_path)
+      end
+
+      mark_terminal_section!(crumbs)
+      crumbs
+    end
+
+    def breadcrumb_collection
+      @breadcrumb_collection ||= if @collection&.persisted?
+                                   @collection
+                                 elsif params[:id].present?
+                                   Collection.find_by(id: params[:id])
+                                 end
+    end
+
+    def breadcrumb_parent_collection
+      @breadcrumb_parent_collection ||= if @parent_collection
+                                        @parent_collection
+                                      elsif @collection&.persisted?
+                                        @collection
+                                      elsif params[:collection_id].present?
+                                        Collection.find_by(id: params[:collection_id])
+                                      end
+    end
+
+    def breadcrumb_dashboard
+      @breadcrumb_dashboard ||= if @dashboard&.persisted?
+                                  @dashboard
+                                elsif params[:dashboard_id].present?
+                                  Dashboard.find_by(id: params[:dashboard_id])
+                                elsif controller_path == "nquery/dashboards" && params[:id].present?
+                                  Dashboard.find_by(id: params[:id])
+                                end
+    end
+
+    def breadcrumb_chart
+      @breadcrumb_chart ||= if @chart&.persisted?
+                              @chart
+                            elsif params[:id].present?
+                              Chart.find_by(id: params[:id])
+                            end
+    end
+
+    def breadcrumb_user
+      @breadcrumb_user ||= @user || User.find_by(id: params[:id])
+    end
+
+    def breadcrumb_group
+      @breadcrumb_group ||= @group || Group.find_by(id: params[:id])
+    end
+
+    def breadcrumb_data_source
+      @breadcrumb_data_source ||= @data_source || DataSource.find_by(id: params[:id])
+    end
+
+    def query_breadcrumb_label
+      case action_name
+      when "new" then "New SQL query"
+      when "edit" then "Edit query: #{@query&.name.presence || 'Untitled'}"
+      else @query&.name.presence || "Query"
+      end
+    end
+
+    def append_section_breadcrumb(crumbs, label, path)
+      crumbs << { label: label, path: path, section: true }
+    end
+
+    def append_resource_breadcrumb(crumbs, resource, path: nil, link: false)
+      return unless resource&.name.present?
+
+      crumbs << { label: resource.name, path: link ? path : nil }
+    end
+
+    def append_terminal_breadcrumb(crumbs, label)
+      crumbs << { label: label, path: nil }
+    end
+
+    def mark_terminal_section!(crumbs)
+      last_crumb = crumbs.last
+      return unless last_crumb[:section]
+
+      last_crumb[:path] = nil
+    end
+  end
+end

data/app/controllers/concerns/nquery/browsable.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Nquery
+  module Browsable
+    extend ActiveSupport::Concern
+
+    private
+
+    def load_collection_contents(collection)
+      @child_collections = filter_viewable_collections(collection.children.active.order(:name))
+      @charts = filter_viewable_charts(collection.charts.active.includes(:collection).order(:name))
+      @dashboards = filter_viewable_dashboards(
+        collection.dashboards.active.includes(:creator, dashboard_cards: :chart).order(:name)
+      )
+      assigned_chart_ids = @dashboards.flat_map { |dashboard| dashboard.dashboard_cards.map(&:chart_id) }
+      @standalone_charts = @charts.reject { |chart| assigned_chart_ids.include?(chart.id) }
+    end
+
+    def viewable_collections
+      scope = Collection.active.includes(:parent).order(:name)
+      return scope if permission_resolver.admin?
+
+      scope.select { |collection| collection_listable?(collection) }
+    end
+
+    def assignable_collections
+      Collection.shared.active.order(:name).select do |collection|
+        permission_resolver.admin? || permission_resolver.collection_access(collection) == :curate
+      end
+    end
+
+    def filter_viewable_collections(relation)
+      return relation if permission_resolver.admin?
+
+      relation.select { |collection| viewable_collection?(collection) }
+    end
+
+    def filter_viewable_charts(relation)
+      return relation if permission_resolver.admin?
+
+      relation.select { |chart| viewable_collection?(chart.collection) }
+    end
+
+    def filter_viewable_dashboards(relation)
+      return relation if permission_resolver.admin?
+
+      relation.select { |dashboard| viewable_collection?(dashboard.collection) }
+    end
+
+    def collection_listable?(collection)
+      return false if collection.kind == "personal" && collection.owner_id != current_nquery_user&.id
+
+      viewable_collection?(collection)
+    end
+  end
+end

data/app/controllers/concerns/nquery/chart_actions.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Nquery
+  module ChartActions
+    extend ActiveSupport::Concern
+
+    included do
+      include ChartResults
+      before_action :set_chart, only: %i[show edit update embed destroy archive]
+      before_action :authorize_chart_view!, only: %i[show embed]
+      before_action :authorize_chart_curate!, only: %i[edit update destroy archive]
+    end
+
+    def show
+      @result = chart_result(@chart)
+      render "nquery/charts/show"
+    end
+
+    def edit
+      load_chart_builder_assigns
+      render "nquery/charts/edit"
+    end
+
+    def update
+      if @chart.update(chart_params)
+        respond_to do |format|
+          format.html { redirect_to after_chart_save_path, notice: "Chart updated." }
+          format.turbo_stream do
+            flash.now[:notice] = "Chart updated."
+            render template: "nquery/charts/update"
+          end
+        end
+      else
+        load_chart_builder_assigns
+        render "nquery/charts/edit", status: :unprocessable_content
+      end
+    end
+
+    def destroy
+      @chart.destroy
+      redirect_to after_chart_action_path, notice: "Chart removed."
+    end
+
+    def archive
+      @chart.archive!
+      redirect_to after_chart_action_path, notice: "Chart archived."
+    end
+
+    def embed
+      @embed_token = EmbedToken.active.find_by(resource_type: "Nquery::Chart", resource_id: @chart.id)
+      @embed_url = @embed_token ? embed_public_chart_url(token: EmbedTokenService.signed_token_for(@embed_token)) : nil
+      render "nquery/charts/embed"
+    end
+
+    private
+
+    def authorize_chart_view!
+      authorize_collection_access!(@chart.collection, required: :view)
+    end
+
+    def authorize_chart_curate!
+      authorize_collection_access!(@chart.collection, required: :curate)
+    end
+
+    def after_chart_save_path
+      if chart_dashboard
+        edit_dashboard_chart_path(chart_dashboard, @chart)
+      else
+        edit_chart_path(@chart)
+      end
+    end
+
+    def after_chart_action_path
+      if chart_dashboard
+        dashboard_path(chart_dashboard)
+      elsif @chart.collection
+        collection_path(@chart.collection)
+      else
+        root_path
+      end
+    end
+
+    def chart_dashboard
+      @dashboard if defined?(@dashboard) && @dashboard.present?
+    end
+
+    def chart_params
+      params.require(:chart).permit(
+        :name,
+        visualization: {},
+        query_attributes: %i[id name statement data_source_id]
+      )
+    end
+
+    def load_chart_builder_assigns
+      @data_sources = DataSource.active.order(:name)
+      @schema = schema_for(@chart&.query&.data_source)
+    end
+
+    def schema_for(data_source = nil)
+      Nquery::SchemaExplorer.tables_for(data_source || DataSource.first)
+    end
+  end
+end

data/app/controllers/concerns/nquery/chart_results.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Nquery
+  module ChartResults
+    extend ActiveSupport::Concern
+
+    private
+
+    def chart_result(chart)
+      return demo_result unless chart.query&.statement.present?
+
+      QueryRunner.new(
+        data_source: chart.query.data_source || DataSource.first,
+        statement: chart.query.statement,
+        user: current_nquery_user,
+        query: chart.query
+      ).run
+    rescue StandardError
+      demo_result
+    end
+
+    def demo_result
+      {
+        columns: %w[month revenue],
+        rows: [%w[Jan 1200], %w[Feb 1800], %w[Mar 2400], %w[Apr 2100]],
+        row_count: 4
+      }
+    end
+  end
+end

data/app/controllers/nquery/admin/base_controller.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Nquery
+  module Admin
+    class BaseController < ApplicationController
+      before_action :require_admin!
+    end
+  end
+end