airview 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28182d9bbb704849b5ede094038a3d6b031826c119b704f40691578639d592fd
-  data.tar.gz: ae015890868c3cf07e46e46b947baa597998937f7a39f505c17944c7561789c7
+  metadata.gz: 4698348a323226676e3caba98313791047e11f6ca61d5481c4161e93b72df435
+  data.tar.gz: 991db64ebdb3d015d6a57b7f2cc008b9d1bdad64cca67f2b87727f6aa7533be1
 SHA512:
-  metadata.gz: 44327f49faf4823b0439094b990d4ea007b76f39dc7c1d00f05550551cc662f96af4e5ce693e716ca51ade47c4a1058ea6970247153fca22549c92e5f82ebf8c
-  data.tar.gz: 107620ed78ff8f7477d3b435ff98696b40b0925003446834f497866aa6d21753d29fa5077a9734a07e30dc0a19b302b6a8ad0fb096ba7e97a6dfe72fae8181f2
+  metadata.gz: 057bac0d19e8c39a2e1238eab49cf778d84dffb742ea7e67abb1e50622cbdbd8539b55b71b661f117598f60dd3efeec1141838aa9d2aff08801cdd9410d1fe8d
+  data.tar.gz: f276cd3b707856ee4b2b3b0e554d4dda4cead471cb6de46aacc64f0474af45d06cf538f16255ff86abd3a6cf3f62435444937ac9a917d29cf903e96aa3da1b26

data/app/assets/stylesheets/airview/application.css

@@ -474,6 +474,13 @@
   gap: 12px;
 }
 
+.airview-toolbar-actions {
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
 .airview-setup-table .airview-actions,
 .airview-setup-fields .airview-actions {
   white-space: nowrap;

data/app/controllers/airview/resources_controller.rb

@@ -15,6 +15,8 @@ module Airview
 
     def show
       @resources = Airview.resources.values
+      return render(:empty) if @resource.fields.empty?
+
       @views = View.for_resource(@resource.key).ordered
       @active_view = @views.find { |view| view.id.to_s == params[:view_id].to_s }
       @sorted_fields = @resource.fields.values.sort_by { |field| field.label.downcase }

data/app/controllers/airview/setup_controller.rb

@@ -2,7 +2,7 @@
 
 module Airview
   class SetupController < ApplicationController
-    before_action :set_definition, only: %i[edit update destroy]
+    before_action :set_definition, only: %i[edit update sync destroy]
 
     def index
       @models = ModelDiscovery.models
@@ -37,6 +37,12 @@ module Airview
       end
     end
 
+    def sync
+      added_count = ResourceSynchronizer.new(@definition).sync_missing_fields
+      field_label = "field".pluralize(added_count)
+      redirect_to edit_setup_resource_path(@definition), notice: "#{added_count} #{field_label} added"
+    end
+
     def destroy
       @definition.destroy!
       redirect_to setup_path, notice: "Resource removed"

data/app/helpers/airview/application_helper.rb

@@ -3,6 +3,8 @@
 module Airview
   module ApplicationHelper
     def airview_field_value(record, field)
+      return nil unless airview_field_available?(record, field)
+
       value = record.public_send(field.name)
       return value if field.collection_association?
       return Airview.record_label(value, field.label_method) if field.association? && value
@@ -13,6 +15,7 @@ module Airview
 
     def airview_cell_value(record, field)
       value = airview_field_value(record, field)
+      return tag.span("", class: "airview-empty-value") unless airview_field_available?(record, field)
 
       case field.type
       when :boolean
@@ -37,6 +40,7 @@ module Airview
     def airview_input_for(record, field)
       value = airview_field_value(record, field)
       name = "record[#{field.name}]"
+      return text_field_tag(name, nil, disabled: true) unless airview_field_available?(record, field)
 
       case field.type
       when :boolean
@@ -189,6 +193,8 @@ module Airview
     end
 
     def airview_reference_pill(record, field)
+      return tag.span("", class: "airview-empty-value") unless airview_field_available?(record, field)
+
       related = record.public_send(field.name)
       return tag.span("+ Link record", class: "airview-reference-empty") unless related
 
@@ -204,6 +210,8 @@ module Airview
     end
 
     def airview_collection_pills(record, field)
+      return tag.span("0 records", class: "airview-reference-empty") unless airview_field_available?(record, field)
+
       records = record.public_send(field.name).limit(3).to_a
       count = airview_collection_count(record, field)
 
@@ -225,6 +233,8 @@ module Airview
     end
 
     def airview_attachment_cell(record, field)
+      return tag.span("No file", class: "airview-reference-empty") unless airview_field_available?(record, field)
+
       attachment = record.public_send(field.name)
       return tag.span("No file", class: "airview-reference-empty") unless attachment.attached?
 
@@ -241,6 +251,8 @@ module Airview
     end
 
     def airview_reference_input(record, field, name)
+      return text_field_tag(name, nil, disabled: true) unless airview_field_available?(record, field)
+
       related = record.public_send(field.name)
 
       safe_join(
@@ -427,11 +439,33 @@ module Airview
       return "##{record.id}" unless linked_resource
 
       linked_resource.fields.values.reject(&:association?).first(3).filter_map do |field|
+        next unless airview_field_available?(record, field)
+
         value = airview_field_value(record, field)
         "#{field.label}: #{value}" if value.present?
       end.join(" · ")
     end
 
+    def airview_field_available?(record, field)
+      model_class = record.class
+
+      case field.type
+      when :belongs_to
+        association = model_class.reflect_on_association(field.name) if model_class.respond_to?(:reflect_on_association)
+        association&.macro == :belongs_to && model_class.column_names.include?(association.foreign_key.to_s)
+      when :has_many
+        association = model_class.reflect_on_association(field.name) if model_class.respond_to?(:reflect_on_association)
+        association&.macro == :has_many
+      when :attachment
+        model_class.respond_to?(:attachment_reflections) &&
+          model_class.attachment_reflections.key?(field.name.to_s)
+      else
+        model_class.respond_to?(:column_names) && model_class.column_names.include?(field.name.to_s)
+      end
+    rescue ActiveRecord::StatementInvalid, NameError
+      false
+    end
+
     def airview_resource_for_model(model)
       Airview.resources.values.find { |resource| resource.model == model.to_s }
     end

data/app/models/airview/field_definition.rb

@@ -18,5 +18,58 @@ module Airview
     def default_visible?
       metadata.fetch("default_visible", true)
     end
+
+    def stale?
+      !schema_backed?
+    end
+
+    def stale_reason
+      return nil if schema_backed?
+
+      case field_type.to_sym
+      when :belongs_to
+        "Missing belongs_to association or foreign key"
+      when :has_many
+        "Missing has_many association"
+      when :attachment
+        "Missing attachment"
+      else
+        "Missing column"
+      end
+    end
+
+    def schema_backed?
+      model_class = resource_definition.model_class
+
+      case field_type.to_sym
+      when :belongs_to
+        belongs_to_schema_backed?(model_class)
+      when :has_many
+        association = model_class.reflect_on_association(name.to_sym)
+        association&.macro == :has_many
+      when :attachment
+        attachment_names(model_class).include?(name.to_s)
+      else
+        model_class.column_names.include?(name.to_s)
+      end
+    rescue ActiveRecord::StatementInvalid, NameError
+      false
+    end
+
+    private
+
+    def belongs_to_schema_backed?(model_class)
+      association_key = association_name.presence || name
+      association = model_class.reflect_on_association(association_key.to_sym)
+      return false unless association&.macro == :belongs_to
+
+      model_class.column_names.include?(association.foreign_key.to_s)
+    end
+
+    def attachment_names(model_class)
+      return [] unless model_class.respond_to?(:attachment_reflections)
+
+      model_class.attachment_reflections.keys.map(&:to_s)
+    end
   end
 end

data/app/views/airview/resources/empty.html.erb

@@ -1,5 +1,11 @@
 <main class="airview-empty">
-  <h1>Airview</h1>
-  <p>No resources are enabled yet.</p>
+  <h1><%= @resource&.label || "Airview" %></h1>
+  <p>
+    <% if @resource %>
+      No available fields are backed by the current schema.
+    <% else %>
+      No resources are enabled yet.
+    <% end %>
+  </p>
   <%= link_to "Configure resources", setup_path %>
 </main>

data/app/views/airview/setup/_form.html.erb

@@ -37,6 +37,7 @@
           <th>Visible</th>
           <th>Readonly</th>
           <th>Name</th>
+          <th>Status</th>
           <th>Label</th>
           <th>Type</th>
           <th>Order</th>
@@ -46,8 +47,9 @@
       </thead>
       <tbody>
         <%= form.fields_for :field_definitions do |field_form| %>
+          <% stale = field_form.object.stale? %>
           <tr>
-            <td><%= field_form.check_box :visible %></td>
+            <td><%= field_form.check_box :visible, disabled: stale %></td>
             <td><%= field_form.check_box :read_only %></td>
             <td>
               <%= field_form.hidden_field :id if field_form.object.persisted? %>
@@ -55,6 +57,7 @@
               <%= field_form.hidden_field :association_name %>
               <%= field_form.object.name %>
             </td>
+            <td><%= stale ? field_form.object.stale_reason : "Available" %></td>
             <td><%= field_form.text_field :label %></td>
             <td><%= field_form.select :field_type, Airview::Field::TYPES.map { |type| [type.to_s.humanize, type] } %></td>
             <td><%= field_form.number_field :position, min: 0 %></td>

data/app/views/airview/setup/edit.html.erb

@@ -8,7 +8,10 @@
         <p><%= @definition.record_class_name %></p>
       </div>
 
-      <%= button_to "Remove resource", setup_resource_path(@definition), method: :delete, form: { data: { turbo_confirm: "Remove this Airview resource?" } } %>
+      <div class="airview-toolbar-actions">
+        <%= button_to "Sync fields", sync_setup_resource_path(@definition), method: :post %>
+        <%= button_to "Remove resource", setup_resource_path(@definition), method: :delete, form: { data: { turbo_confirm: "Remove this Airview resource?" } } %>
+      </div>
     </header>
 
     <%= render "form", definition: @definition, url: setup_resource_path(@definition), method: :patch %>

data/config/routes.rb

@@ -8,6 +8,7 @@ Airview::Engine.routes.draw do
   post "/setup/resources", to: "setup#create", as: :setup_resources
   get "/setup/resources/:id/edit", to: "setup#edit", as: :edit_setup_resource
   patch "/setup/resources/:id", to: "setup#update", as: :setup_resource
+  post "/setup/resources/:id/sync", to: "setup#sync", as: :sync_setup_resource
   delete "/setup/resources/:id", to: "setup#destroy"
 
   get "/resources", to: "resources#index", as: :resources

data/lib/airview/query.rb

@@ -43,7 +43,9 @@ module Airview
       term = params[:q].to_s.strip
       return scope if term.empty?
 
-      searchable = resource.fields.values.select { |field| %i[string text select].include?(field.type) }
+      searchable = resource.fields.values.select do |field|
+        %i[string text select].include?(field.type) && queryable_field?(scope, field)
+      end
       return scope if searchable.empty?
 
       clauses = searchable.map do |field|
@@ -63,6 +65,7 @@ module Airview
 
         field = resource.fields[name.to_sym]
         next unless field
+        next unless queryable_field?(scope, field)
 
         scope = apply_filter(scope, field, value)
       end
@@ -82,6 +85,7 @@ module Airview
         field = resource.fields[condition["field"].to_s.to_sym]
         next unless field
         next unless field.filterable?
+        next unless queryable_field?(scope, field)
 
         scope = apply_structured_filter(scope, field, condition["operator"], condition["value"])
       end
@@ -183,10 +187,19 @@ module Airview
       field = resource.fields[sort.to_sym]
       return scope unless field
       return scope unless field.sortable?
+      return scope unless queryable_field?(scope, field)
 
       scope.order(field.attribute_name => direction)
     end
 
+    def queryable_field?(scope, field)
+      return false if field.display_only?
+
+      scope.klass.column_names.include?(field.attribute_name.to_s)
+    rescue NameError
+      false
+    end
+
     def sanitize_like(value)
       ActiveRecord::Base.sanitize_sql_like(value.to_s)
     end

data/lib/airview/resource.rb

@@ -11,6 +11,7 @@ module Airview
       @label = key.to_s.humanize
       @label_method = :to_s
       @fields = {}
+      @stale_fields = []
     end
 
     def field(name, type:, label: nil, **options)
@@ -38,6 +39,14 @@ module Airview
       fields.values.select(&:default_visible?)
     end
 
+    def stale_fields
+      @stale_fields.dup
+    end
+
+    def add_stale_field(field, reason:)
+      @stale_fields << { name: field.name.to_sym, label: field.label, reason: }
+    end
+
     def validate!
       raise ConfigurationError, "Airview resource #{key} must define at least one field" if fields.empty?
 

data/lib/airview/resource_builder.rb

@@ -18,7 +18,12 @@ module Airview
           resource.label_method = definition.label_method.presence&.to_sym || :to_s
 
           definition.field_definitions.visible.order(:position, :name).each do |field|
-            add_field(resource, field)
+            if field_schema_backed?(resource.model_class, field)
+              add_field(resource, field)
+            else
+              resource.add_stale_field(field, reason: stale_reason(resource.model_class, field))
+              log_stale_field(resource, field)
+            end
           end
 
           add_missing_virtual_fields(resource, definition)
@@ -57,6 +62,56 @@ module Airview
           )
         end
       end
+
+      def field_schema_backed?(model_class, field)
+        case field.field_type.to_sym
+        when :belongs_to
+          belongs_to_schema_backed?(model_class, field)
+        when :has_many
+          association = model_class.reflect_on_association(field.name.to_sym)
+          association&.macro == :has_many
+        when :attachment
+          attachment_names(model_class).include?(field.name.to_s)
+        else
+          model_class.column_names.include?(field.name.to_s)
+        end
+      rescue NameError
+        false
+      end
+
+      def belongs_to_schema_backed?(model_class, field)
+        association_name = field.association_name.presence || field.name
+        association = model_class.reflect_on_association(association_name.to_sym)
+        return false unless association&.macro == :belongs_to
+
+        model_class.column_names.include?(association.foreign_key.to_s)
+      end
+
+      def attachment_names(model_class)
+        return [] unless model_class.respond_to?(:attachment_reflections)
+
+        model_class.attachment_reflections.keys.map(&:to_s)
+      end
+
+      def stale_reason(model_class, field)
+        case field.field_type.to_sym
+        when :belongs_to
+          "missing belongs_to association or foreign key on #{model_class.name}"
+        when :has_many
+          "missing has_many association on #{model_class.name}"
+        when :attachment
+          "missing attachment on #{model_class.name}"
+        else
+          "missing column on #{model_class.name}"
+        end
+      end
+
+      def log_stale_field(resource, field)
+        return unless defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
+
+        reason = stale_reason(resource.model_class, field)
+        Rails.logger.warn("Airview skipped stale field #{field.name.inspect} for #{resource.model}: #{reason}")
+      end
     end
   end
 end

data/lib/airview/resource_synchronizer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Airview
+  class ResourceSynchronizer
+    attr_reader :definition
+
+    def initialize(definition)
+      @definition = definition
+    end
+
+    def sync_missing_fields
+      existing_names = definition.field_definitions.map { |field| field.name.to_s }
+      position = definition.field_definitions.map(&:position).compact.max.to_i
+      added_count = 0
+
+      SchemaInference.new(definition.model_class).field_attributes.each do |attributes|
+        next if existing_names.include?(attributes[:name].to_s)
+
+        position += 1
+        definition.field_definitions.create!(attributes.merge(position:))
+        added_count += 1
+      end
+
+      added_count
+    end
+  end
+end

data/lib/airview/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Airview
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/airview.rb

@@ -13,6 +13,7 @@ require_relative "airview/resource"
 require_relative "airview/query"
 require_relative "airview/model_discovery"
 require_relative "airview/resource_builder"
+require_relative "airview/resource_synchronizer"
 require_relative "airview/schema_inference"
 require_relative "airview/engine" if defined?(Rails)
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: airview
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - jacksonriso
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-06 00:00:00.000000000 Z
+date: 2026-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -74,6 +74,7 @@ files:
 - lib/airview/query.rb
 - lib/airview/resource.rb
 - lib/airview/resource_builder.rb
+- lib/airview/resource_synchronizer.rb
 - lib/airview/schema_inference.rb
 - lib/airview/version.rb
 - lib/generators/airview/install/install_generator.rb