cal-invite 0.1.5 → 0.2.1

data/lib/cal_invite/providers/ics.rb

@@ -46,9 +46,15 @@ module CalInvite
           "VERSION:2.0",
           "PRODID:-//CalInvite//EN",
           "CALSCALE:GREGORIAN",
-          "METHOD:PUBLISH"
+          "METHOD:#{method_value}"
         ]
 
+        calendar_lines << "X-WR-CALNAME:#{escape_text(event.calendar_name)}" if event.calendar_name
+
+        unless event.all_day
+          calendar_lines.concat(vtimezone_lines || [])
+        end
+
         if event.all_day
           calendar_lines.concat(generate_all_day_event)
         elsif event.multi_day_sessions.any?
@@ -71,7 +77,7 @@ module CalInvite
       def generate_all_day_event
         vevent = [
           "BEGIN:VEVENT",
-          "UID:#{generate_uid}",
+          "UID:#{event.uid}",
           "DTSTAMP:#{format_timestamp(Time.now.utc)}",
           "DTSTART;VALUE=DATE:#{format_date(event.start_time)}",
           "DTEND;VALUE=DATE:#{format_date(event.end_time)}",
@@ -90,7 +96,7 @@ module CalInvite
       def generate_vevent(start_time, end_time)
         vevent = [
           "BEGIN:VEVENT",
-          "UID:#{generate_uid}",
+          "UID:#{event.uid}",
           "DTSTAMP:#{format_timestamp(Time.now.utc)}",
           "DTSTART;TZID=#{event.timezone}:#{format_local_timestamp(start_time)}",
           "DTEND;TZID=#{event.timezone}:#{format_local_timestamp(end_time)}",
@@ -102,7 +108,8 @@ module CalInvite
       end
 
       # Adds optional fields to the event component if they exist.
-      # Handles description, location, URL, and attendees.
+      # Handles description, location, URL, geo, organizer, attendees, recurrence,
+      # visibility/busy status, and reminders.
       #
       # @param vevent [Array<String>] The current event lines array
       # @return [void]
@@ -121,11 +128,23 @@ module CalInvite
           vevent << "URL:#{escape_text(url)}"
         end
 
-        if attendees_list.any?
-          attendees_list.each do |attendee|
-            vevent << "ATTENDEE;RSVP=TRUE:mailto:#{attendee}"
-          end
+        vevent << geo_line if geo_line
+
+        if organizer = organizer_line
+          vevent << organizer
         end
+
+        attendees_list.each { |attendee| vevent << attendee_line(attendee) }
+
+        vevent << rrule_line if rrule_line
+        vevent << "SEQUENCE:#{event.sequence}"
+        vevent << status_line
+        vevent << transp_line
+        vevent << busystatus_line
+        vevent << class_line
+        vevent.concat(importance_lines)
+        vevent << disallow_counter_line if disallow_counter_line
+        vevent.concat(valarm_lines)
       end
 
       # Formats a time object as an UTC timestamp in iCalendar format.
@@ -145,20 +164,13 @@ module CalInvite
       end
 
       # Formats a time object as a local timestamp in iCalendar format.
-      # Note: Times are expected to be in UTC already.
+      # Converts from UTC to the event's timezone; times are expected to be in
+      # UTC already.
       #
       # @param time [Time] The time to format
       # @return [String] The formatted local time (YYYYMMDDTHHmmSS)
       def format_local_timestamp(time)
-        time.strftime("%Y%m%dT%H%M%S")
-      end
-
-      # Generates a unique identifier for the calendar event.
-      # Format: timestamp-randomhex@cal-invite
-      #
-      # @return [String] The generated UID
-      def generate_uid
-        "#{Time.now.to_i}-#{SecureRandom.hex(8)}@cal-invite"
+        local_wall_time(time).strftime("%Y%m%dT%H%M%S")
       end
 
       # Escapes special characters in text according to iCalendar spec.

data/lib/cal_invite/providers/ics_content.rb

@@ -36,9 +36,11 @@ module CalInvite
           "VERSION:2.0",
           "PRODID:-//CalInvite//EN",
           "CALSCALE:GREGORIAN",
-          "METHOD:PUBLISH"
+          "METHOD:#{method_value}"
         ]
 
+        calendar_lines << "X-WR-CALNAME:#{escape_text(event.calendar_name)}" if event.calendar_name
+
         if event.multi_day_sessions.any?
           event.multi_day_sessions.each do |session|
             calendar_lines.concat(generate_vevent(session[:start_time], session[:end_time]))
@@ -61,7 +63,7 @@ module CalInvite
       def generate_vevent(start_time, end_time)
         [
           "BEGIN:VEVENT",
-          "UID:#{generate_uid}",
+          "UID:#{event.uid}",
           "DTSTAMP:#{format_timestamp(Time.now.utc)}",
           "DTSTART:#{format_timestamp(start_time)}",
           "DTEND:#{format_timestamp(end_time)}",
@@ -69,7 +71,18 @@ module CalInvite
           description_line,
           location_line,
           url_line,
+          geo_line,
+          organizer_line,
           attendee_lines,
+          rrule_line,
+          "SEQUENCE:#{event.sequence}",
+          status_line,
+          transp_line,
+          busystatus_line,
+          class_line,
+          importance_lines,
+          disallow_counter_line,
+          valarm_lines,
           "END:VEVENT"
         ].compact
       end
@@ -82,14 +95,6 @@ module CalInvite
         time.utc.strftime("%Y%m%dT%H%M%SZ")
       end
 
-      # Generates a unique identifier for the calendar event.
-      # Format: timestamp-randomhex@cal-invite
-      #
-      # @return [String] The generated UID
-      def generate_uid
-        "#{Time.now.to_i}-#{SecureRandom.hex(8)}@cal-invite"
-      end
-
       # Escapes special characters in text according to iCalendar spec.
       #
       # @param text [String, nil] The text to escape
@@ -131,8 +136,8 @@ module CalInvite
       #
       # @return [Array<String>, nil] Array of ATTENDEE lines, or nil if no attendees or not showing
       def attendee_lines
-        return nil unless event.show_attendees && event.attendees&.any?
-        event.attendees.map { |attendee| "ATTENDEE;RSVP=TRUE:mailto:#{attendee}" }
+        return nil if attendees_list.empty?
+        attendees_list.map { |attendee| attendee_line(attendee) }
       end
     end
 
@@ -142,10 +147,19 @@ module CalInvite
       # Generates appropriate HTTP headers for ICS file download.
       #
       # @param filename [String] The desired filename for the download
+      # @param method [Symbol, nil] The iCalendar METHOD used to generate the content
+      #   (:publish or :request). When given, it's added as a `method` parameter on
+      #   the Content-Type header — this is what lets mail clients (Gmail, Outlook,
+      #   Apple Mail) recognize the attachment as a meeting invite and render RSVP
+      #   actions instead of a plain file attachment. Must match the METHOD in the
+      #   .ics content itself.
       # @return [Hash] HTTP headers for the ICS file download
-      def self.headers(filename)
+      def self.headers(filename, method: nil)
+        content_type = 'text/calendar; charset=UTF-8'
+        content_type += "; method=#{method == :decline_counter ? 'DECLINECOUNTER' : method.to_s.upcase}" if method
+
         {
-          'Content-Type' => 'text/calendar; charset=UTF-8',
+          'Content-Type' => content_type,
           'Content-Disposition' => "attachment; filename=#{sanitize_filename(filename)}"
         }
       end
@@ -162,23 +176,20 @@ module CalInvite
       #
       # @param content [String] The ICS calendar content
       # @param title [String] The event title to use in the filename
+      # @param method [Symbol, nil] The iCalendar METHOD used to generate `content`
+      #   (:publish or :request); forwarded to {headers}. Must match the METHOD
+      #   used when generating `content` itself.
       # @return [Hash] Hash containing content and headers for download
       # @example
       #   result = IcsDownload.wrap_for_download(ics_content, "team-meeting")
       #   # => { content: "BEGIN:VCALENDAR...", headers: { 'Content-Type' => '...' } }
-      def self.wrap_for_download(content, title)
+      def self.wrap_for_download(content, title, method: nil)
         filename = sanitize_filename("#{title.downcase}_#{Time.now.strftime('%Y%m%d')}.ics")
         {
           content: content,
-          headers: headers(filename)
+          headers: headers(filename, method: method)
         }
       end
     end
-
-    # Compatibility class aliases
-    # @api private
-    class Ics < IcsContent; end
-    # @api private
-    class Ical < IcsContent; end
   end
 end

data/lib/cal_invite/providers/office365.rb

@@ -52,6 +52,7 @@ module CalInvite
         params = {
           subject: url_encode(event.title),
           path: '/calendar/action/compose',
+          rru: 'addevent',
           allday: 'true'
         }
 
@@ -73,7 +74,8 @@ module CalInvite
       def generate_single_event
         params = {
           subject: url_encode(event.title),
-          path: '/calendar/action/compose'
+          path: '/calendar/action/compose',
+          rru: 'addevent'
         }
 
         raise ArgumentError, "Start time is required" unless event.start_time
@@ -115,10 +117,12 @@ module CalInvite
         params[:body] = url_encode(description_parts.join("\n\n")) if description_parts.any?
         params[:location] = url_encode(format_location) if format_location
 
-        if attendees = attendees_list
-          params[:to] = url_encode(attendees.join(';'))
+        if attendees_list.any?
+          params[:to] = url_encode(attendee_emails.join(';'))
         end
 
+        params[:freebusy] = event.busy ? 'busy' : 'free' unless event.busy.nil?
+
         params
       end
 
@@ -128,7 +132,7 @@ module CalInvite
       # @return [String] The complete Office 365 calendar URL
       def build_url(params)
         query = params.map { |k, v| "#{k}=#{v}" }.join('&')
-        "https://outlook.office.com/owa/?#{query}"
+        "https://outlook.office.com/calendar/deeplink/compose?#{query}"
       end
     end
   end

data/lib/cal_invite/providers/outlook.rb

@@ -55,7 +55,8 @@ module CalInvite
       # @return [String] The Outlook.com calendar URL for an all-day event
       def generate_all_day_event
         params = {
-          path: '/calendar/0/action/compose',
+          path: '/calendar/action/compose',
+          rru: 'addevent',
           subject: url_encode(event.title),
           allday: 'true'
         }
@@ -77,7 +78,8 @@ module CalInvite
       # @raise [ArgumentError] If start_time or end_time is missing
       def generate_single_event
         params = {
-          path: '/calendar/0/action/compose',
+          path: '/calendar/action/compose',
+          rru: 'addevent',
           subject: url_encode(event.title)
         }
 
@@ -120,10 +122,12 @@ module CalInvite
         params[:body] = url_encode(description_parts.join("\n\n")) if description_parts.any?
         params[:location] = url_encode(format_location) if format_location
 
-        if attendees = attendees_list
-          params[:to] = url_encode(attendees.join(';'))
+        if attendees_list.any?
+          params[:to] = url_encode(attendee_emails.join(';'))
         end
 
+        params[:freebusy] = event.busy ? 'busy' : 'free' unless event.busy.nil?
+
         params
       end
 
@@ -133,7 +137,7 @@ module CalInvite
       # @return [String] The complete Outlook.com calendar URL
       def build_url(params)
         query = params.map { |k, v| "#{k}=#{v}" }.join('&')
-        "https://outlook.live.com/calendar/0/action/compose?#{query}"
+        "https://outlook.live.com/calendar/deeplink/compose?#{query}"
       end
     end
   end

data/lib/cal_invite/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CalInvite
-  VERSION = "0.1.5"
+  VERSION = "0.2.1"
 end

data/lib/cal_invite.rb

@@ -1,4 +1,7 @@
 # lib/cal_invite.rb
+require 'logger'
+require 'mutex_m'
+require 'bigdecimal'
 require 'active_support'
 require 'active_support/core_ext'
 require 'securerandom'
@@ -8,6 +11,7 @@ require 'uri'
 require 'cal_invite/version'
 require 'cal_invite/configuration'
 require 'cal_invite/caching'
+require 'cal_invite/ical_timezone'
 require 'cal_invite/event'
 require 'cal_invite/providers'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cal-invite
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.1
 platform: ruby
 authors:
 - Stephane Paquet
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-19 00:00:00.000000000 Z
+date: 2026-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,20 +24,76 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mutex_m
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.5'
+        version: '8.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.5'
+        version: '8.0'
 description: CalInvite provides a simple way to generate calendar invite URLs for
   various providers (Google, Outlook, Yahoo) and ICS files
 email:
@@ -49,12 +105,16 @@ files:
 - ".DS_Store"
 - ".rdoc_options"
 - ".rubocop.yml"
+- AGENTS.md
 - CACHING.md
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
+- CONFIGURATION.md
 - LICENSE.txt
 - README.md
 - Rakefile
+- SECURITY.md
 - gemfiles/Gemfile.rails6
 - gemfiles/Gemfile.rails7
 - gemfiles/Gemfile.rails8
@@ -64,6 +124,7 @@ files:
 - lib/cal_invite/caching.rb
 - lib/cal_invite/configuration.rb
 - lib/cal_invite/event.rb
+- lib/cal_invite/ical_timezone.rb
 - lib/cal_invite/providers.rb
 - lib/cal_invite/providers/base_provider.rb
 - lib/cal_invite/providers/google.rb
@@ -76,13 +137,13 @@ files:
 - lib/cal_invite/version.rb
 - lib/tasks/rdoc.rake
 - sig/cal/invite.rbs
-homepage: https://github.com/the-pew-inc/cal-invite
+homepage: https://github.com/DashAPI-ai/cal-invite
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/the-pew-inc/cal-invite
-  source_code_uri: https://github.com/the-pew-inc/cal-invite
-  changelog_uri: https://github.com/the-pew-inc/cal-invite/blob/master/CHANGELOG.md
+  homepage_uri: https://github.com/DashAPI-ai/cal-invite
+  source_code_uri: https://github.com/DashAPI-ai/cal-invite
+  changelog_uri: https://github.com/DashAPI-ai/cal-invite/blob/master/CHANGELOG.md
 post_install_message:
 rdoc_options:
 - "--title"