tudla_hubstaff 0.1.0

data/config/importmap.rb

@@ -0,0 +1,7 @@
+pin "@hotwired/stimulus", to: "stimulus.min.js"
+pin "tudla_hubstaff/application", to: "tudla_hubstaff/application.js"
+pin "tudla_hubstaff/controllers/index", to: "tudla_hubstaff/controllers/index.js"
+pin "tudla_hubstaff/controllers/user_mapping_modal_controller", to: "tudla_hubstaff/controllers/user_mapping_modal_controller.js"
+pin "tudla_hubstaff/controllers/task_mapping_modal_controller", to: "tudla_hubstaff/controllers/task_mapping_modal_controller.js"
+pin "tudla_hubstaff/controllers/project_mapping_modal_controller", to: "tudla_hubstaff/controllers/project_mapping_modal_controller.js"
+pin "tudla_hubstaff/controllers/activity_task_mapping_modal_controller", to: "tudla_hubstaff/controllers/activity_task_mapping_modal_controller.js"

data/config/routes.rb

@@ -0,0 +1,41 @@
+TudlaHubstaff::Engine.routes.draw do
+  resources :users, only: [] do
+    collection do
+      get :unmapped
+      get :available_tudla_users
+    end
+    member do
+      patch :map_tudla_user
+    end
+  end
+
+  resources :tasks, only: [] do
+    collection do
+      get :unmapped
+      get :available_tudla_tasks
+    end
+    member do
+      patch :map_tudla_task
+    end
+  end
+
+  resources :projects, only: [] do
+    collection do
+      get :unmapped
+      get :available_tudla_projects
+    end
+    member do
+      patch :map_tudla_project
+    end
+  end
+
+  resources :activities, only: [] do
+    collection do
+      get :user_activities
+      get :available_tudla_tasks
+    end
+    member do
+      patch :map_activity_task
+    end
+  end
+end

data/db/migrate/20251230220607_create_tudla_hubstaff_users.rb

@@ -0,0 +1,16 @@
+class CreateTudlaHubstaffUsers < ActiveRecord::Migration[8.1]
+  def change
+    create_table :tudla_hubstaff_users do |t|
+      t.string :name, null: false
+      t.string :first_name, null: false
+      t.string :last_name, null: false
+      t.string :email
+      t.string :time_zone, null: false, default: "UTC"
+      t.string :ip_address
+      t.string :status, null: false, default: "active"
+
+      t.timestamps
+    end
+    add_index :tudla_hubstaff_users, :email, unique: true
+  end
+end

data/db/migrate/20251230222524_create_tudla_hubstaff_tasks.rb

@@ -0,0 +1,21 @@
+class CreateTudlaHubstaffTasks < ActiveRecord::Migration[8.1]
+  def change
+    create_table :tudla_hubstaff_tasks do |t|
+      t.integer :integration_id
+      t.string :status
+      t.integer :project_id, null: false
+      t.string :project_type, null: false
+      t.string :summary, null: false
+      t.text :details
+      t.string :remote_id
+      t.string :remote_alternate_id
+      t.integer :lock_version
+      t.json :metadata, null: false, default: {}
+      t.datetime :completed_at
+      t.datetime :due_at
+
+      t.timestamps
+    end
+    add_index :tudla_hubstaff_tasks, :remote_id
+  end
+end

data/db/migrate/20251230223731_create_tudla_hubstaff_projects.rb

@@ -0,0 +1,15 @@
+class CreateTudlaHubstaffProjects < ActiveRecord::Migration[8.1]
+  def change
+    create_table :tudla_hubstaff_projects do |t|
+      t.string :name, null: false
+      t.text :description
+      t.string :status
+      t.string :project_type, null: false
+      t.integer :client_id
+      t.json :metadata, null: false, default: {}
+
+      t.timestamps
+    end
+    add_index :tudla_hubstaff_projects, :client_id
+  end
+end

data/db/migrate/20251230225408_add_hubstaff_ids_to_models.rb

@@ -0,0 +1,14 @@
+class AddHubstaffIdsToModels < ActiveRecord::Migration[8.1]
+  disable_ddl_transaction!
+
+  def change
+    add_column :tudla_hubstaff_users, :user_id, :bigint
+    add_index :tudla_hubstaff_users, :user_id, algorithm: :concurrently
+
+    add_column :tudla_hubstaff_projects, :project_id, :bigint
+    add_index :tudla_hubstaff_projects, :project_id, algorithm: :concurrently
+
+    add_column :tudla_hubstaff_tasks, :task_id, :bigint
+    add_index :tudla_hubstaff_tasks, :task_id, algorithm: :concurrently
+  end
+end

data/db/migrate/20251231041753_add_last_updated_at_to_models.rb

@@ -0,0 +1,7 @@
+class AddLastUpdatedAtToModels < ActiveRecord::Migration[8.1]
+  def change
+    add_column :tudla_hubstaff_users, :last_updated_at, :datetime
+    add_column :tudla_hubstaff_projects, :last_updated_at, :datetime
+    add_column :tudla_hubstaff_tasks, :last_updated_at, :datetime
+  end
+end

data/db/migrate/20251231043338_add_tudla_ids_to_models.rb

@@ -0,0 +1,14 @@
+class AddTudlaIdsToModels < ActiveRecord::Migration[8.1]
+  disable_ddl_transaction!
+
+  def change
+    add_column :tudla_hubstaff_users, :tudla_user_id, :bigint
+    add_index :tudla_hubstaff_users, :tudla_user_id, algorithm: :concurrently
+
+    add_column :tudla_hubstaff_projects, :tudla_project_id, :bigint
+    add_index :tudla_hubstaff_projects, :tudla_project_id, algorithm: :concurrently
+
+    add_column :tudla_hubstaff_tasks, :tudla_task_id, :bigint
+    add_index :tudla_hubstaff_tasks, :tudla_task_id, algorithm: :concurrently
+  end
+end

data/db/migrate/20251231045209_create_tudla_hubstaff_activities.rb

@@ -0,0 +1,30 @@
+class CreateTudlaHubstaffActivities < ActiveRecord::Migration[8.1]
+  def change
+    create_table :tudla_hubstaff_activities do |t|
+      t.bigint :activity_id, null: false
+      t.string :date, null: false
+      t.bigint :user_id, null: false
+      t.bigint :project_id
+      t.bigint :task_id
+      t.integer :keyboard, default: 0
+      t.integer :mouse, default: 0
+      t.integer :overall, default: 0
+      t.integer :tracked, default: 0
+      t.integer :input_tracked, default: 0
+      t.integer :manual, default: 0
+      t.integer :idle, default: 0
+      t.integer :resumed, default: 0
+      t.integer :billable, default: 0
+      t.integer :work_break, default: 0
+      t.datetime :last_updated_at
+
+      t.timestamps
+    end
+
+    add_index :tudla_hubstaff_activities, :activity_id, unique: true
+    add_index :tudla_hubstaff_activities, :date
+    add_index :tudla_hubstaff_activities, :user_id
+    add_index :tudla_hubstaff_activities, :project_id
+    add_index :tudla_hubstaff_activities, :task_id
+  end
+end

data/db/migrate/20251231074018_create_tudla_hubstaff_configs.rb

@@ -0,0 +1,15 @@
+class CreateTudlaHubstaffConfigs < ActiveRecord::Migration[8.1]
+  def change
+    create_table :tudla_hubstaff_configs do |t|
+      t.string :tudla_organization_type
+      t.bigint :tudla_organization_id
+      t.string :personal_access_token
+      t.bigint :organization_id
+
+      t.timestamps
+    end
+
+    add_index :tudla_hubstaff_configs, [ :tudla_organization_type, :tudla_organization_id ], name: "index_configs_on_tudla_organization"
+    add_index :tudla_hubstaff_configs, :organization_id
+  end
+end

data/db/migrate/20251231074556_create_tudla_hubstaff_organization_updates.rb

@@ -0,0 +1,12 @@
+class CreateTudlaHubstaffOrganizationUpdates < ActiveRecord::Migration[8.1]
+  def change
+    create_table :tudla_hubstaff_organization_updates do |t|
+      t.bigint :organization_id, null: false
+      t.datetime :last_updated_at
+
+      t.timestamps
+    end
+
+    add_index :tudla_hubstaff_organization_updates, :organization_id
+  end
+end

data/lib/generators/tudla_hubstaff/components_generator.rb

@@ -0,0 +1,68 @@
+require "rails/generators/base"
+
+module TudlaHubstaff
+  module Generators
+    class ComponentsGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../app/components", __dir__)
+
+      desc "Copies TudlaHubstaff ViewComponents to the host application for customization."
+
+      argument :scope, required: false, default: nil,
+               desc: "The scope to copy (e.g., ui, or a specific component like ui/modal)"
+
+      class_option :force, type: :boolean, default: false,
+                   desc: "Overwrite existing files"
+
+      class_option :templates_only, type: :boolean, default: false,
+                   desc: "Copy only the template files (.html.erb), not the Ruby classes"
+
+      def copy_components
+        if scope.present?
+          copy_scoped_components
+        else
+          copy_all_components
+        end
+      end
+
+      private
+
+      def copy_scoped_components
+        source_path = "tudla_hubstaff/#{scope}"
+        target_path = "app/components/tudla_hubstaff/#{scope}"
+
+        if options[:templates_only]
+          copy_templates_only(source_path, target_path)
+        else
+          if File.directory?(File.join(self.class.source_root, source_path))
+            directory source_path, target_path
+            say_status :success, "Copied #{scope} components to #{target_path}", :green
+          else
+            say_status :error, "No components found for scope '#{scope}'", :red
+          end
+        end
+      end
+
+      def copy_all_components
+        if options[:templates_only]
+          copy_templates_only("tudla_hubstaff", "app/components/tudla_hubstaff")
+        else
+          directory "tudla_hubstaff", "app/components/tudla_hubstaff"
+          say_status :success, "Copied all TudlaHubstaff components to app/components/tudla_hubstaff", :green
+        end
+      end
+
+      def copy_templates_only(source_path, target_path)
+        full_source = File.join(self.class.source_root, source_path)
+
+        Dir.glob(File.join(full_source, "**/*.html.erb")).each do |template_file|
+          relative_path = template_file.sub("#{self.class.source_root}/", "")
+          destination = relative_path.sub("tudla_hubstaff/", "app/components/tudla_hubstaff/")
+
+          copy_file relative_path, destination
+        end
+
+        say_status :success, "Copied component templates to #{target_path}", :green
+      end
+    end
+  end
+end

data/lib/generators/tudla_hubstaff/views_generator.rb

@@ -0,0 +1,54 @@
+require "rails/generators/base"
+
+module TudlaHubstaff
+  module Generators
+    class ViewsGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../app/views", __dir__)
+
+      desc "Copies TudlaHubstaff views to the host application for customization."
+
+      argument :scope, required: false, default: nil,
+               desc: "The scope to copy (e.g., users, tasks, projects, layouts)"
+
+      class_option :force, type: :boolean, default: false,
+                   desc: "Overwrite existing files"
+
+      AVAILABLE_SCOPES = %w[users tasks projects layouts shared].freeze
+
+      def copy_views
+        if scope.present?
+          validate_scope!
+          copy_scoped_views
+        else
+          copy_all_views
+        end
+      end
+
+      private
+
+      def validate_scope!
+        return if AVAILABLE_SCOPES.include?(scope)
+
+        say_status :error, "Invalid scope '#{scope}'. Available scopes: #{AVAILABLE_SCOPES.join(', ')}", :red
+        raise Thor::Error, "Invalid scope"
+      end
+
+      def copy_scoped_views
+        source_path = "tudla_hubstaff/#{scope}"
+        target_path = "app/views/tudla_hubstaff/#{scope}"
+
+        if File.directory?(File.join(self.class.source_root, source_path))
+          directory source_path, target_path
+          say_status :success, "Copied #{scope} views to #{target_path}", :green
+        else
+          say_status :error, "No views found for scope '#{scope}'", :red
+        end
+      end
+
+      def copy_all_views
+        directory "tudla_hubstaff", "app/views/tudla_hubstaff"
+        say_status :success, "Copied all TudlaHubstaff views to app/views/tudla_hubstaff", :green
+      end
+    end
+  end
+end

data/lib/tasks/tudla_hubstaff_tasks.rake

@@ -0,0 +1,18 @@
+# desc "Explaining what the task does"
+# task :tudla_hubstaff do
+#   # Task goes here
+# end
+namespace :app do
+  namespace :tailwindcss do
+    desc "Watch and build Tailwind CSS for the engine"
+    task :watch do
+      require "tailwindcss-rails"
+      # Construct the command to watch engine files and output to builds/
+      cmd = "#{Tailwindcss::Commands.executable} " \
+            "-i #{TudlaHubstaff::Engine.root.join("app/assets/stylesheets/tudla_hubstaff/application.css")} " \
+            "-o #{TudlaHubstaff::Engine.root.join("app/assets/builds/tudla_hubstaff.css")} " \
+            "--watch"
+      system cmd
+    end
+  end
+end

data/lib/tudla_hubstaff/engine.rb

@@ -0,0 +1,88 @@
+module TudlaHubstaff
+  class Engine < ::Rails::Engine
+    isolate_namespace TudlaHubstaff
+
+    # Configure Zeitwerk to use UI instead of Ui for the ui directory
+    initializer "tudla_hubstaff.zeitwerk_inflections", before: :set_autoload_paths do
+      Rails.autoloaders.each do |autoloader|
+        autoloader.inflector.inflect("ui" => "UI")
+      end
+    end
+
+    config.generators do |g|
+      g.test_framework :rspec
+      g.fixture_replacement :factory_bot
+      g.factory_bot dir: "spec/factories"
+    end
+
+    # Advanced FactoryBot Configuration
+    # We hook into the initializer to append the path relative to the Engine's root.
+    initializer "tudla_hubstaff.factories", after: "factory_bot.set_factory_paths" do
+      if defined?(FactoryBot)
+        FactoryBot.definition_file_paths << File.expand_path("../../../spec/factories", __FILE__)
+      end
+    end
+
+    # Define an initializer that runs when the app boots
+    initializer "tudla_hubstaff.register_integration",
+      after:  "app.load_config_initializers" do
+        config.to_prepare do
+          # Register this gem's classes
+          Rails.logger.info "Registering Hubstaff integration"
+          TudlaContracts::Integrations::Registry.register(
+            "hubstaff",
+            type: "time_sheet",
+            provider_class: "TudlaHubstaff::Provider",
+            config_class: "TudlaHubstaff::Config"
+          )
+          TudlaContracts::Integrations::Registry.register_view_for_slot(
+            "task_show_tab",
+            TudlaContracts::Integrations::ViewDefinitions::ShowTabDefinition.new(
+              id: :tudla_hubstaff_task_show_tab,
+              label: "Hubstaff Activities",
+              component_class: TudlaHubstaff::TaskActivitiesComponent,
+              priority: 10,
+              if: ->(task) { true }
+            )
+          )
+          TudlaContracts::Integrations::Registry.register_view_for_slot(
+            "dashboard_section",
+            TudlaContracts::Integrations::ViewDefinitions::DashboardSectionDefinition.new(
+              id: :tudla_hubstaff_dashboard_section,
+              label: "Hubstaff Activities",
+              component_class: TudlaHubstaff::UserActivitiesListComponent,
+              priority: 10,
+              if: ->(user) { true }
+            )
+          )
+        end
+      end
+
+    initializer "tudla_hubstaff.importmap", before: "importmap" do |app|
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << Engine.root.join("config/importmap.rb")
+        app.config.importmap.cache_sweepers << Engine.root.join("app/javascript")
+      end
+    end
+
+    initializer "tudla_hubstaff.assets" do |app|
+      if app.config.respond_to?(:assets)
+        app.config.assets.paths << Engine.root.join("app/javascript")
+      end
+    end
+
+    # Ensure the engine's assets are visible to the host's pipeline
+    initializer "tudla_hubstaff.assets.precompile" do |app|
+      app.config.assets.paths << root.join("app/assets/tailwind")
+    end
+
+    initializer "tudla_hubstaff.view_component" do |app|
+      # ViewComponent automatically picks up components from app/components
+      # No additional configuration needed when using autoload_paths
+    end
+
+    # Configurable layout - allows host app to specify which layout to use
+    config.tudla_hubstaff = ActiveSupport::OrderedOptions.new
+    config.tudla_hubstaff.layout = "tudla_hubstaff/application"
+  end
+end

data/lib/tudla_hubstaff/provider.rb

@@ -0,0 +1,12 @@
+module TudlaHubstaff
+  class Provider < TudlaContracts::TimeSheet::Base
+    def initialize(config)
+      @config = config
+    end
+
+    def daily_activities
+      # Implement the logic to fetch the time sheet from the provider
+      [] # NOOP for now
+    end
+  end
+end

data/lib/tudla_hubstaff/version.rb

@@ -0,0 +1,3 @@
+module TudlaHubstaff
+  VERSION = "0.1.0"
+end

data/lib/tudla_hubstaff.rb

@@ -0,0 +1,49 @@
+# Requires are necessary for the Engine to load these gems' tasks and classes
+require "solid_queue"
+require "solid_cache"
+require "solid_cable"
+require "tailwindcss-rails"
+require "importmap-rails"
+require "faraday"
+require "httpx/adapters/faraday"
+require "openid_connect"
+require "tudla_contracts"
+require "turbo-rails"
+require "view_component"
+require "pagy"
+
+require "tudla_hubstaff/version"
+require "tudla_hubstaff/provider"
+require "tudla_hubstaff/engine"
+
+
+module TudlaHubstaff
+  class << self
+    # Configuration for the host interface class
+    # Host apps should set this to their own class that inherits from
+    # TudlaContracts::Integration::HostInterface
+    attr_writer :host_interface_class
+
+    def host_interface_class
+      @host_interface_class || raise(<<~ERROR)
+        TudlaHubstaff.host_interface_class is not configured.
+
+        Please configure it in an initializer:
+
+          # config/initializers/tudla_hubstaff.rb
+          TudlaHubstaff.host_interface_class = "::HostInterface"
+
+        Your class should inherit from TudlaContracts::Integration::HostInterface
+        and implement the required methods like `available_users_for_user`.
+      ERROR
+    end
+
+    def host_interface
+      @host_interface ||= host_interface_class.constantize.new
+    end
+
+    def reset_host_interface!
+      @host_interface = nil
+    end
+  end
+end