hr_lite 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a85f50e1151c664825892bd973f34842d1330e4878e39bb4984233880258c446
-  data.tar.gz: 95012fa0d0b7332e35e1fdef90ace239a95b415cbdc9d3101cb86fac18de9f7c
+  metadata.gz: 5b975162e55e723ed0bd24a9e032eba889d18e89c106ce55fc051a8566ce41e0
+  data.tar.gz: 2a0bd3e239011f037e300f26f3e8d18e3fb9a4fe7ca17b1317e70d3318a93844
 SHA512:
-  metadata.gz: 6b532c9f0fe3b5408eea1e847c40329ab28da2a4c996d7cb229d1d745187fe33b5ace2fb17b8d1ea1ec1fc2e326cfc91dfd8881d296197a9d80bb40ded90a6f2
-  data.tar.gz: 64dfd72f81d71bd48ce01a4815c95360994dfb6b06235933ba893bb8245bdf4bd79ab384d7f7ca441fcec3ab158861c73d9bf8485b2478811e7df90d67443bb9
+  metadata.gz: 2405b7818d6a8028375fb614ec0d187faf01088996e8d0754b3e7882ebc4adb2846cd4bf026de0aba86504c63264a8cdbbaaad740b610ce12661718581b45e04
+  data.tar.gz: 632fc1794614fa739375e0fe1a4c8b55195f9a51e7b4d5d74f65eadafc157f14b8e391eb7846c84a299634f1fd1e6f5abe64e5b18c253fa0ad276ce495da2c43

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-07-19
+
+### Added
+
+- Email-invite onboarding: leave the starting password blank and the
+  welcome email carries a set-your-password link from the host's
+  `invite_url_for` hook; `Notifications.publish`/`EventMailer.event`
+  accept an absolute `link_url` for tokenized URLs. (Intended for 0.2.0;
+  missed the merge window.)
+
 ## [0.2.0] - 2026-07-19
 
 ### Added

data/app/controllers/hr_lite/admin/employees_controller.rb

@@ -36,11 +36,14 @@ module HrLite
 
         if @profile.save
           if new_login
+            invite_url = HrLite.config.invite_url_for&.call(@profile.user)
             Notifications.publish(
               "employee.onboarded",
               title: "Welcome aboard — your HR account is ready",
-              body: "Sign in with your email; your manager has your starting password.",
+              body: invite_url ? "Set your password with the button below, then sign in with your email."
+                               : "Sign in with your email; your manager has your starting password.",
               path: "/",
+              link_url: invite_url,
               bell_to: [ @profile.user ],
               email_to: [ @profile.user ]
             )

data/app/mailers/hr_lite/event_mailer.rb

@@ -3,11 +3,11 @@ module HrLite
   # body, detail lines, diff table) is assembled by the Notifications bus so
   # adding an event never means adding a template.
   class EventMailer < ApplicationMailer
-    def event(to:, subject:, heading:, body: nil, lines: [], path: nil)
+    def event(to:, subject:, heading:, body: nil, lines: [], path: nil, link_url: nil)
       @heading = heading
       @body = body
       @lines = Array(lines)
-      @cta_url = HrLite::EventMailer.link_for(path)
+      @cta_url = link_url.presence || HrLite::EventMailer.link_for(path)
       mail(to: to, from: HrLite.config.mailer_from, subject: subject)
     end
 

data/app/views/hr_lite/admin/employees/_form.html.erb

@@ -21,8 +21,10 @@
           <%= f.email_field :new_user_email %>
         </div>
         <div class="hrl-field">
-          <%= f.label :new_user_password, "Starting password (share it with them; they can change it later)" %>
+          <%= f.label :new_user_password, "Starting password (optional)" %>
           <%= f.text_field :new_user_password %>
+          <p class="hrl-hint">Leave blank (recommended): they get an email invite and set their own
+            password. Fill it only if you want to hand a password over yourself.</p>
         </div>
       </fieldset>
     <% end %>

data/lib/hr_lite/configuration.rb

@@ -9,7 +9,7 @@ module HrLite
                   :time_zone, :currency_symbol, :on_designation_change,
                   :leadership_emails, :leadership_check, :extra_stylesheets,
                   :mailer_from, :public_url_base, :notification_matrix, :back_link,
-                  :onboard_user, :offboard_user
+                  :onboard_user, :offboard_user, :invite_url_for
 
     # 0.1.0 pre-release name for public_url_base; kept as an alias so early
     # adopters' initializers don't break.
@@ -58,6 +58,10 @@ module HrLite
         klass.create!(attributes)
       }
       @offboard_user = ->(user) { }
+      # Optional: return an absolute set-your-password URL for a freshly
+      # onboarded user (e.g. a Devise reset link). When present, the welcome
+      # email carries it and leadership never needs to hand over a password.
+      @invite_url_for = nil
     end
   end
 

data/lib/hr_lite/notifications.rb

@@ -37,7 +37,7 @@ module HrLite
         HrLite.config.notification_matrix || DEFAULT_MATRIX
       end
 
-      def publish(event, title:, body: nil, path: nil, bell_to: [], email_to: [], lines: [], diff: nil)
+      def publish(event, title:, body: nil, path: nil, bell_to: [], email_to: [], lines: [], diff: nil, link_url: nil)
         row = matrix[event.to_s]
         unless row
           Rails.logger.warn("[hr_lite] unknown notification event #{event}")
@@ -45,7 +45,7 @@ module HrLite
         end
 
         deliver_bells(event, row, bell_to, title, body, path)
-        deliver_emails(row, email_to, title, body, path, lines)
+        deliver_emails(row, email_to, title, body, path, lines, link_url)
         deliver_leadership_email(event, row, title, body, path, lines, diff)
         deliver_leadership_bells(event, row, bell_to, title, body, path)
         nil
@@ -61,14 +61,15 @@ module HrLite
         end
       end
 
-      def deliver_emails(row, email_to, title, body, path, lines)
+      def deliver_emails(row, email_to, title, body, path, lines, link_url = nil)
         return unless row[:email]
 
         Array(email_to).compact.uniq.each do |user|
           next if user.email.blank?
 
           EventMailer.event(to: user.email, subject: title, heading: title,
-                            body: body, lines: lines, path: path).deliver_later
+                            body: body, lines: lines, path: path,
+                            link_url: link_url).deliver_later
         end
       rescue => e
         Rails.logger.error("[hr_lite] event email failed: #{e.class}: #{e.message}")

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - kshitiz sinha