@hebcal/icalendar 5.1.0 → 6.0.1

package/README.md

@@ -1,4 +1,4 @@
-# hebcal-icalendar
+# @hebcal/icalendar
 Jewish holidays and Hebrew calendar as iCalendar RFC 2445
 
 ## Installation
@@ -10,68 +10,25 @@ $ npm install @hebcal/icalendar
 ```javascript
 import {HebrewCalendar, Location} from '@hebcal/core';
 import {eventsToIcalendar} from '@hebcal/icalendar';
+import fs from 'fs';
 
 const options = {
   year: 2020,
   month: 2,
   sedrot: true,
   candlelighting: true,
-  location: Location.lookup('Hawaii'),
+  location: Location.lookup('Tel Aviv'),
 };
 const events = HebrewCalendar.calendar(options);
-console.log(await eventsToIcalendar(ev, options));
-```
-
-## Functions
-
-<dl>
-<dt><a href="#eventToIcal">eventToIcal(e, options)</a> ⇒ <code>string</code></dt>
-<dd><p>Transforms a single Event into a VEVENT string</p>
-</dd>
-<dt><a href="#eventsToIcalendarStream">eventsToIcalendarStream(readable, events, options)</a> ⇒ <code>stream.Readable</code></dt>
-<dd><p>Generates an RFC 2445 iCalendar stream from an array of events</p>
-</dd>
-<dt><a href="#eventsToIcalendar">eventsToIcalendar(events, options)</a> ⇒ <code>string</code></dt>
-<dd><p>Renders an array of events as a full RFC 2445 iCalendar string</p>
-</dd>
-</dl>
-
-<a name="eventToIcal"></a>
-
-## eventToIcal(e, options) ⇒ <code>string</code>
-Transforms a single Event into a VEVENT string
-
-**Kind**: global function  
-**Returns**: <code>string</code> - multi-line result, delimited by \r\n  
-
-| Param | Type |
-| --- | --- |
-| e | <code>Event</code> | 
-| options | <code>HebcalOptions</code> | 
 
-<a name="eventsToIcalendarStream"></a>
+const str = await eventsToIcalendar(events, {
+  locale: 'he',
+  ...options,
+})
 
-## eventsToIcalendarStream(readable, events, options) ⇒ <code>stream.Readable</code>
-Generates an RFC 2445 iCalendar stream from an array of events
-
-**Kind**: global function  
-
-| Param | Type |
-| --- | --- |
-| readable | <code>stream.Readable</code> | 
-| events | <code>Array.&lt;Event&gt;</code> | 
-| options | <code>HebcalOptions</code> | 
-
-<a name="eventsToIcalendar"></a>
-
-## eventsToIcalendar(events, options) ⇒ <code>string</code>
-Renders an array of events as a full RFC 2445 iCalendar string
-
-**Kind**: global function  
-**Returns**: <code>string</code> - multi-line result, delimited by \r\n  
-
-| Param | Type |
-| --- | --- |
-| events | <code>Array.&lt;Event&gt;</code> | 
-| options | <code>HebcalOptions</code> | 
+const icalStream = fs.createWriteStream('feed.ics');
+icalStream.write(str);
+icalStream.close();
+```
 
+## [API Documentation](https://hebcal.github.io/api/icalendar/index.html)

package/dist/icalendar.d.ts

@@ -15,6 +15,7 @@ export type ICalEventOptions = {
     relcalid?: string;
     yahrzeit?: boolean;
     subscribe?: string | boolean;
+    url?: boolean;
 };
 export type ICalOptions = CalOptions & ICalEventOptions;
 /**
@@ -41,51 +42,28 @@ export declare class IcalEvent {
      */
     constructor(ev: Event, options?: ICalOptions);
     getAlarm(): string | null;
-    /**
-     * @return {string}
-     */
     getUid(): string;
-    /**
-     * @return {string[]}
-     */
     getLongLines(): string[];
-    /**
-     * @return {string}
-     */
     toString(): string;
     /**
      * fold lines to 75 characters
-     * @return {string[]}
      */
     getLines(): string[];
     /**
      * fold line to 75 characters
-     * @param {string} line
-     * @return {string}
      */
     static fold(line: string): string;
-    /**
-     * @param {string} str
-     * @return {string}
-     */
     static escape(str: string): string;
-    /**
-     * @param {Date} dt
-     * @return {string}
-     */
     static formatYYYYMMDD(dt: Date): string;
     /**
      * Returns UTC string for iCalendar
-     * @param {Date} dt
-     * @return {string}
      */
     static makeDtstamp(dt: Date): string;
-    /** @return {string} */
     static version(): string;
 }
 /**
  * Transforms a single Event into a VEVENT string
- * @return {string} multi-line result, delimited by \r\n
+ * @returns multi-line result, delimited by \r\n
  */
 export declare function eventToIcal(ev: Event, options: ICalOptions): string;
 /**

package/dist/index.mjs

@@ -1,11 +1,12 @@
-/*! @hebcal/icalendar v5.1.0 */
-import { flags, Locale, greg } from '@hebcal/core';
+/*! @hebcal/icalendar v6.0.1 */
+import { Locale, pad2, greg, pad4 } from '@hebcal/hdate';
+import { flags } from '@hebcal/core';
 import { murmur32HexSync } from 'murmurhash3';
-import { shouldRenderBrief, pad2, getEventCategories, makeAnchor, pad4, getHolidayDescription, getCalendarTitle, appendIsraelAndTracking, makeTorahMemoText } from '@hebcal/rest-api';
+import { shouldRenderBrief, getEventCategories, makeAnchor, getHolidayDescription, getCalendarTitle, appendIsraelAndTracking, makeTorahMemoText } from '@hebcal/rest-api';
 import { promises } from 'fs';
 
 // DO NOT EDIT THIS AUTO-GENERATED FILE!
-const version = '5.1.0';
+const version = '6.0.1';
 
 const vtimezoneCache = new Map();
 const CATEGORY = {
@@ -48,8 +49,11 @@ function appendTrackingToUrl(url, options) {
 }
 const encoder = new TextEncoder();
 const char74re = /(.{1,74})/g;
-const DAILY_LEARNING = flags.DAILY_LEARNING | flags.DAF_YOMI |
-    flags.MISHNA_YOMI | flags.YERUSHALMI_YOMI | flags.NACH_YOMI;
+const DAILY_LEARNING = flags.DAILY_LEARNING |
+    flags.DAF_YOMI |
+    flags.MISHNA_YOMI |
+    flags.YERUSHALMI_YOMI |
+    flags.NACH_YOMI;
 /**
  * Represents an RFC 2445 iCalendar VEVENT
  */
@@ -69,10 +73,12 @@ class IcalEvent {
         else if (typeof opts.sequence === 'number') {
             this.sequence = opts.sequence;
         }
-        const timed = this.timed = Boolean(ev.eventTime);
+        const timed = (this.timed = Boolean(ev.eventTime));
         const locale = opts.locale;
         const location = opts.location;
-        let subj = shouldRenderBrief(ev) ? ev.renderBrief(locale) : ev.render(locale);
+        let subj = shouldRenderBrief(ev)
+            ? ev.renderBrief(locale)
+            : ev.render(locale);
         const mask = ev.getFlags();
         if (ev.locationName) {
             this.locationName = ev.locationName;
@@ -80,7 +86,7 @@ class IcalEvent {
         else if (timed && location) {
             this.locationName = location.getShortName();
         }
-        else if ((mask & DAILY_LEARNING) && ev.category) {
+        else if (mask & DAILY_LEARNING && ev.category) {
             this.locationName = Locale.gettext(ev.category, locale);
         }
         const date = IcalEvent.formatYYYYMMDD(ev.getDate().greg());
@@ -129,7 +135,8 @@ class IcalEvent {
             }
         }
         this.subj = subj;
-        this.category = ev.category || CATEGORY[(_a = getEventCategories(ev)) === null || _a === void 0 ? void 0 : _a[0]];
+        this.category =
+            ev.category || CATEGORY[(_a = getEventCategories(ev)) === null || _a === void 0 ? void 0 : _a[0]];
     }
     getAlarm() {
         const ev = this.ev;
@@ -157,9 +164,6 @@ class IcalEvent {
         }
         return null;
     }
-    /**
-     * @return {string}
-     */
     getUid() {
         if (this.ev.uid) {
             return this.ev.uid;
@@ -178,9 +182,6 @@ class IcalEvent {
         }
         return uid;
     }
-    /**
-     * @return {string[]}
-     */
     getLongLines() {
         if (this.lines)
             return this.lines;
@@ -189,17 +190,16 @@ class IcalEvent {
         if (this.sequence) {
             categoryLine.unshift(`SEQUENCE:${this.sequence}`);
         }
-        const arr = this.lines = [
-            'BEGIN:VEVENT',
-            `DTSTAMP:${this.dtstamp}`,
-        ].concat(categoryLine).concat([
+        const arr = (this.lines = ['BEGIN:VEVENT', `DTSTAMP:${this.dtstamp}`]
+            .concat(categoryLine)
+            .concat([
             `SUMMARY:${this.subj}`,
             `DTSTART${this.dtargs}:${this.startDate}`,
             `DTEND${this.dtargs}:${this.endDate}`,
             `UID:${uid}`,
             `TRANSP:${this.transp}`,
             `X-MICROSOFT-CDO-BUSYSTATUS:${this.busyStatus}`,
-        ]);
+        ]));
         if (!this.timed) {
             arr.push('X-MICROSOFT-CDO-ALLDAYEVENT:TRUE');
         }
@@ -218,6 +218,14 @@ class IcalEvent {
         if (this.timed && loc) {
             arr.push('GEO:' + loc.getLatitude() + ';' + loc.getLongitude());
         }
+        // In addition to the URL being part of the DESCRIPTION field,
+        // should we also generate an RFC 5545 URL property?
+        if (options.url) {
+            const url = ev.url();
+            if (url) {
+                arr.push('URL:' + appendTrackingToUrl(url, options));
+            }
+        }
         const trigger = this.getAlarm();
         if (trigger) {
             arr.push('BEGIN:VALARM', 'ACTION:DISPLAY', 'DESCRIPTION:Event reminder', `${trigger}`, 'END:VALARM');
@@ -225,23 +233,17 @@ class IcalEvent {
         arr.push('END:VEVENT');
         return arr;
     }
-    /**
-     * @return {string}
-     */
     toString() {
         return this.getLines().join('\r\n');
     }
     /**
      * fold lines to 75 characters
-     * @return {string[]}
      */
     getLines() {
         return this.getLongLines().map(IcalEvent.fold);
     }
     /**
      * fold line to 75 characters
-     * @param {string} line
-     * @return {string}
      */
     static fold(line) {
         let isASCII = true;
@@ -284,10 +286,6 @@ class IcalEvent {
         }
         return result + current;
     }
-    /**
-     * @param {string} str
-     * @return {string}
-     */
     static escape(str) {
         if (str.indexOf(',') !== -1) {
             str = str.replace(/,/g, '\\,');
@@ -297,46 +295,45 @@ class IcalEvent {
         }
         return str;
     }
-    /**
-     * @param {Date} dt
-     * @return {string}
-     */
     static formatYYYYMMDD(dt) {
-        return pad4(dt.getFullYear()) +
-            pad2(dt.getMonth() + 1) + pad2(dt.getDate());
+        return (pad4(dt.getFullYear()) + pad2(dt.getMonth() + 1) + pad2(dt.getDate()));
     }
     /**
      * Returns UTC string for iCalendar
-     * @param {Date} dt
-     * @return {string}
      */
     static makeDtstamp(dt) {
         const s = dt.toISOString();
-        return s.slice(0, 4) + s.slice(5, 7) + s.slice(8, 13) +
-            s.slice(14, 16) + s.slice(17, 19) + 'Z';
+        return (s.slice(0, 4) +
+            s.slice(5, 7) +
+            s.slice(8, 13) +
+            s.slice(14, 16) +
+            s.slice(17, 19) +
+            'Z');
     }
-    /** @return {string} */
     static version() {
         return version;
     }
 }
 /**
  * Transforms a single Event into a VEVENT string
- * @return {string} multi-line result, delimited by \r\n
+ * @returns multi-line result, delimited by \r\n
  */
 function eventToIcal(ev, options) {
     const ical = new IcalEvent(ev, options);
     return ical.toString();
 }
 const torahMemoCache = new Map();
-const HOLIDAY_IGNORE_MASK = DAILY_LEARNING | flags.OMER_COUNT |
-    flags.SHABBAT_MEVARCHIM | flags.MOLAD | flags.USER_EVENT |
+const HOLIDAY_IGNORE_MASK = DAILY_LEARNING |
+    flags.OMER_COUNT |
+    flags.SHABBAT_MEVARCHIM |
+    flags.MOLAD |
+    flags.USER_EVENT |
     flags.HEBREW_DATE;
 /**
  * @private
  */
 function makeTorahMemo(ev, il) {
-    if ((ev.getFlags() & HOLIDAY_IGNORE_MASK) || ev.eventTime) {
+    if (ev.getFlags() & HOLIDAY_IGNORE_MASK || ev.eventTime) {
         return '';
     }
     const hd = ev.getDate();
@@ -367,8 +364,16 @@ function createMemo(ev, options) {
     const mask = ev.getFlags();
     if (mask & flags.OMER_COUNT) {
         const omerEv = ev;
-        const sefira = [omerEv.sefira('en'), omerEv.sefira('he'), omerEv.sefira('translit')].join('\\n');
-        return omerEv.getTodayIs('en') + '\\n\\n' + omerEv.getTodayIs('he') + '\\n\\n' + sefira;
+        const sefira = [
+            omerEv.sefira('en'),
+            omerEv.sefira('he'),
+            omerEv.sefira('translit'),
+        ].join('\\n');
+        return (omerEv.getTodayIs('en') +
+            '\\n\\n' +
+            omerEv.getTodayIs('he') +
+            '\\n\\n' +
+            sefira);
     }
     const url = appendTrackingToUrl(ev.url(), options);
     const torahMemo = makeTorahMemo(ev, options.il);
@@ -398,6 +403,8 @@ function createMemo(ev, options) {
  * Generates an RFC 2445 iCalendar string from an array of events
  */
 async function eventsToIcalendar(events, options) {
+    if (!events.length)
+        throw new RangeError('Events can not be empty');
     if (!options)
         throw new TypeError('Invalid options object');
     const opts = Object.assign({}, options);
@@ -405,24 +412,30 @@ async function eventsToIcalendar(events, options) {
     if (!opts.title) {
         opts.title = getCalendarTitle(events, opts);
     }
-    const icals = events.map((ev) => new IcalEvent(ev, opts));
+    const icals = events.map(ev => new IcalEvent(ev, opts));
     return icalEventsToString(icals, opts);
 }
 /**
  * Generates an RFC 2445 iCalendar string from an array of IcalEvents
  */
 async function icalEventsToString(icals, options) {
+    if (!icals.length)
+        throw new RangeError('Events can not be empty');
+    if (!options)
+        throw new TypeError('Invalid options object');
     const stream = [];
     const locale = options.locale || Locale.getLocaleName();
     const uclang = locale.toUpperCase();
     const opts = Object.assign({}, options);
     opts.dtstamp = opts.dtstamp || IcalEvent.makeDtstamp(new Date());
     const title = opts.title ? IcalEvent.escape(opts.title) : 'Untitled';
-    const caldesc = opts.caldesc ? IcalEvent.escape(opts.caldesc) :
-        opts.yahrzeit ?
-            'Yahrzeits + Anniversaries from www.hebcal.com' :
-            'Jewish Holidays from www.hebcal.com';
-    const prodid = opts.prodid || `-//hebcal.com/NONSGML Hebcal Calendar v1${version}//${uclang}`;
+    const caldesc = opts.caldesc
+        ? IcalEvent.escape(opts.caldesc)
+        : opts.yahrzeit
+            ? 'Yahrzeits + Anniversaries from www.hebcal.com'
+            : 'Jewish Holidays from www.hebcal.com';
+    const prodid = opts.prodid ||
+        `-//hebcal.com/NONSGML Hebcal Calendar v1${version}//${uclang}`;
     const preamble = [
         'BEGIN:VCALENDAR',
         'VERSION:2.0',

package/dist/pkgVersion.d.ts

@@ -1 +1 @@
-export declare const version = "5.1.0";
+export declare const version = "6.0.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hebcal/icalendar",
-  "version": "5.1.0",
+  "version": "6.0.1",
   "author": "Michael J. Radwin (https://github.com/mjradwin)",
   "keywords": [
     "ical",
@@ -9,15 +9,16 @@
     "hebcal"
   ],
   "description": "Jewish holidays and Hebrew calendar as iCalendar RFC 2445",
-  "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "type": "module",
   "exports": {
     "import": "./dist/index.mjs",
-    "require": "./dist/index.cjs",
     "types": "./dist/icalendar.d.ts"
   },
   "typings": "dist/icalendar.d.ts",
+  "engines": {
+    "node": ">= 18.0.0"
+  },
   "files": [
     "dist"
   ],
@@ -29,10 +30,11 @@
     "url": "https://github.com/hebcal/hebcal-icalendar/issues"
   },
   "dependencies": {
-    "@hebcal/core": "^5.4.5",
-    "@hebcal/rest-api": "^5.0.5",
+    "@hebcal/core": "^5.8.0",
+    "@hebcal/hdate": "^0.12.0",
+    "@hebcal/rest-api": "^5.2.0",
     "murmurhash3": "^0.5.0",
-    "tslib": "^2.6.3"
+    "tslib": "^2.8.1"
   },
   "scripts": {
     "build:rollup": "rollup -c",
@@ -40,27 +42,28 @@
     "build": "npm run build:version && npm run build:rollup",
     "prepare": "npm run build",
     "pretest": "npm run build",
-    "readme": "npx jsdoc2md dist/index.ts",
+    "docs": "typedoc",
     "coverage": "jest --coverage",
-    "test": "jest"
+    "test": "jest",
+    "lint": "gts lint",
+    "clean": "gts clean",
+    "compile": "tsc",
+    "fix": "gts fix"
   },
   "license": "BSD-2-Clause",
   "devDependencies": {
-    "@babel/preset-env": "^7.24.7",
-    "@babel/preset-typescript": "^7.24.7",
-    "@hebcal/learning": "^5.0.8",
-    "@rollup/plugin-commonjs": "^26.0.1",
+    "@babel/preset-env": "^7.26.0",
+    "@babel/preset-typescript": "^7.26.0",
+    "@hebcal/learning": "^5.1.2",
+    "@rollup/plugin-commonjs": "^28.0.1",
     "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-typescript": "^11.1.6",
-    "@types/jest": "^29.5.12",
-    "eslint": "^8.57.0",
-    "eslint-config-google": "^0.14.0",
+    "@rollup/plugin-typescript": "^12.1.1",
+    "@types/jest": "^29.5.14",
+    "@types/node": "22.9.0",
     "gts": "^5.3.1",
     "jest": "^29.7.0",
-    "jsdoc": "^4.0.3",
-    "jsdoc-to-markdown": "^8.0.1",
-    "rollup": "^4.18.0",
-    "ts-jest": "^29.1.5",
-    "typescript": "^5.5.2"
+    "rollup": "^4.25.0",
+    "typedoc": "^0.26.11",
+    "typescript": "^5.6.3"
   }
 }

package/dist/index.cjs

@@ -1,492 +0,0 @@
-/*! @hebcal/icalendar v5.1.0 */
-'use strict';
-
-var core = require('@hebcal/core');
-var murmurhash3 = require('murmurhash3');
-var restApi = require('@hebcal/rest-api');
-var fs = require('fs');
-
-// DO NOT EDIT THIS AUTO-GENERATED FILE!
-const version = '5.1.0';
-
-const vtimezoneCache = new Map();
-const CATEGORY = {
-    candles: 'Holiday',
-    dafyomi: 'Daf Yomi',
-    mishnayomi: 'Mishna Yomi',
-    nachyomi: 'Nach Yomi',
-    yerushalmi: 'Yerushalmi Yomi',
-    havdalah: 'Holiday',
-    hebdate: null,
-    holiday: 'Holiday',
-    mevarchim: null,
-    molad: null,
-    omer: null,
-    parashat: 'Parsha',
-    roshchodesh: 'Holiday',
-    user: 'Personal',
-    zmanim: null,
-};
-/**
- * @private
- */
-function addOptional(arr, key, val) {
-    if (val) {
-        const str = IcalEvent.escape(val);
-        arr.push(key + ':' + str);
-    }
-}
-/**
- * @private
- */
-function appendTrackingToUrl(url, options) {
-    if (!url) {
-        return null;
-    }
-    const utmSource = options.utmSource || 'js';
-    const utmMedium = options.utmMedium || 'icalendar';
-    const utmCampaign = options.utmCampaign;
-    return restApi.appendIsraelAndTracking(url, options.il, utmSource, utmMedium, utmCampaign);
-}
-const encoder = new TextEncoder();
-const char74re = /(.{1,74})/g;
-const DAILY_LEARNING = core.flags.DAILY_LEARNING | core.flags.DAF_YOMI |
-    core.flags.MISHNA_YOMI | core.flags.YERUSHALMI_YOMI | core.flags.NACH_YOMI;
-/**
- * Represents an RFC 2445 iCalendar VEVENT
- */
-class IcalEvent {
-    /**
-     * Builds an IcalEvent object from a Hebcal Event
-     */
-    constructor(ev, options = {}) {
-        var _a;
-        this.ev = ev;
-        const opts = Object.assign({}, options);
-        this.options = opts;
-        this.dtstamp = opts.dtstamp || IcalEvent.makeDtstamp(new Date());
-        if (typeof ev.sequence === 'number') {
-            this.sequence = ev.sequence;
-        }
-        else if (typeof opts.sequence === 'number') {
-            this.sequence = opts.sequence;
-        }
-        const timed = this.timed = Boolean(ev.eventTime);
-        const locale = opts.locale;
-        const location = opts.location;
-        let subj = restApi.shouldRenderBrief(ev) ? ev.renderBrief(locale) : ev.render(locale);
-        const mask = ev.getFlags();
-        if (ev.locationName) {
-            this.locationName = ev.locationName;
-        }
-        else if (timed && location) {
-            this.locationName = location.getShortName();
-        }
-        else if ((mask & DAILY_LEARNING) && ev.category) {
-            this.locationName = core.Locale.gettext(ev.category, locale);
-        }
-        const date = IcalEvent.formatYYYYMMDD(ev.getDate().greg());
-        this.startDate = this.isoDateOnly = date;
-        this.dtargs = '';
-        this.transp = 'TRANSPARENT';
-        this.busyStatus = 'FREE';
-        if (timed) {
-            let [hour, minute] = ev.eventTimeStr.split(':');
-            hour = +hour;
-            minute = +minute;
-            this.startDate += 'T' + restApi.pad2(hour) + restApi.pad2(minute) + '00';
-            this.endDate = this.startDate;
-            if (location === null || location === void 0 ? void 0 : location.getTzid()) {
-                this.dtargs = `;TZID=${location.getTzid()}`;
-            }
-        }
-        else {
-            this.endDate = IcalEvent.formatYYYYMMDD(ev.getDate().next().greg());
-            // for all-day untimed, use DTEND;VALUE=DATE intsead of DURATION:P1D.
-            // It's more compatible with everthing except ancient versions of
-            // Lotus Notes circa 2004
-            this.dtargs = ';VALUE=DATE';
-            if (mask & core.flags.CHAG) {
-                this.transp = 'OPAQUE';
-                this.busyStatus = 'OOF';
-            }
-        }
-        if (opts.emoji) {
-            const prefix = ev.getEmoji();
-            if (prefix) {
-                if (mask & core.flags.OMER_COUNT) {
-                    subj = subj + ' ' + prefix;
-                }
-                else {
-                    subj = prefix + ' ' + subj;
-                }
-            }
-        }
-        // make subject safe for iCalendar
-        subj = IcalEvent.escape(subj);
-        if (opts.appendHebrewToSubject) {
-            const hebrew = ev.renderBrief('he');
-            if (hebrew) {
-                subj += ` / ${hebrew}`;
-            }
-        }
-        this.subj = subj;
-        this.category = ev.category || CATEGORY[(_a = restApi.getEventCategories(ev)) === null || _a === void 0 ? void 0 : _a[0]];
-    }
-    getAlarm() {
-        const ev = this.ev;
-        const mask = ev.getFlags();
-        const evAlarm = ev.alarm;
-        if (typeof evAlarm === 'string') {
-            return 'TRIGGER:' + evAlarm;
-        }
-        else if (typeof evAlarm === 'boolean' && !evAlarm) {
-            return null;
-        }
-        else if (core.greg.isDate(evAlarm)) {
-            const alarmDt = evAlarm;
-            alarmDt.setSeconds(0);
-            return 'TRIGGER;VALUE=DATE-TIME:' + IcalEvent.makeDtstamp(alarmDt);
-        }
-        else if (mask & core.flags.OMER_COUNT) {
-            return 'TRIGGER:-P0DT3H30M0S'; // 8:30pm Omer alarm evening before
-        }
-        else if (mask & core.flags.USER_EVENT) {
-            return 'TRIGGER:-P0DT12H0M0S'; // noon the day before
-        }
-        else if (this.timed && ev.getDesc().startsWith('Candle lighting')) {
-            return 'TRIGGER:-P0DT0H10M0S';
-        }
-        return null;
-    }
-    /**
-     * @return {string}
-     */
-    getUid() {
-        if (this.ev.uid) {
-            return this.ev.uid;
-        }
-        const options = this.options;
-        const digest = murmurhash3.murmur32HexSync(this.ev.getDesc());
-        let uid = `hebcal-${this.isoDateOnly}-${digest}`;
-        const loc = options.location;
-        if (this.timed && loc) {
-            if (loc.getGeoId()) {
-                uid += `-${loc.getGeoId()}`;
-            }
-            else if (loc.getName()) {
-                uid += '-' + restApi.makeAnchor(loc.getName());
-            }
-        }
-        return uid;
-    }
-    /**
-     * @return {string[]}
-     */
-    getLongLines() {
-        if (this.lines)
-            return this.lines;
-        const categoryLine = this.category ? [`CATEGORIES:${this.category}`] : [];
-        const uid = this.getUid();
-        if (this.sequence) {
-            categoryLine.unshift(`SEQUENCE:${this.sequence}`);
-        }
-        const arr = this.lines = [
-            'BEGIN:VEVENT',
-            `DTSTAMP:${this.dtstamp}`,
-        ].concat(categoryLine).concat([
-            `SUMMARY:${this.subj}`,
-            `DTSTART${this.dtargs}:${this.startDate}`,
-            `DTEND${this.dtargs}:${this.endDate}`,
-            `UID:${uid}`,
-            `TRANSP:${this.transp}`,
-            `X-MICROSOFT-CDO-BUSYSTATUS:${this.busyStatus}`,
-        ]);
-        if (!this.timed) {
-            arr.push('X-MICROSOFT-CDO-ALLDAYEVENT:TRUE');
-        }
-        const ev = this.ev;
-        const mask = ev.getFlags();
-        const isUserEvent = Boolean(mask & core.flags.USER_EVENT);
-        if (!isUserEvent) {
-            arr.push('CLASS:PUBLIC');
-        }
-        const options = this.options;
-        // create memo (holiday descr, Torah, etc)
-        const memo = createMemo(ev, options);
-        addOptional(arr, 'DESCRIPTION', memo);
-        addOptional(arr, 'LOCATION', this.locationName);
-        const loc = options.location;
-        if (this.timed && loc) {
-            arr.push('GEO:' + loc.getLatitude() + ';' + loc.getLongitude());
-        }
-        const trigger = this.getAlarm();
-        if (trigger) {
-            arr.push('BEGIN:VALARM', 'ACTION:DISPLAY', 'DESCRIPTION:Event reminder', `${trigger}`, 'END:VALARM');
-        }
-        arr.push('END:VEVENT');
-        return arr;
-    }
-    /**
-     * @return {string}
-     */
-    toString() {
-        return this.getLines().join('\r\n');
-    }
-    /**
-     * fold lines to 75 characters
-     * @return {string[]}
-     */
-    getLines() {
-        return this.getLongLines().map(IcalEvent.fold);
-    }
-    /**
-     * fold line to 75 characters
-     * @param {string} line
-     * @return {string}
-     */
-    static fold(line) {
-        let isASCII = true;
-        for (let i = 0; i < line.length; i++) {
-            if (line.charCodeAt(i) > 255) {
-                isASCII = false;
-                break;
-            }
-        }
-        if (isASCII) {
-            if (line.length <= 74) {
-                return line;
-            }
-            const matches = line.match(char74re);
-            return matches.join('\r\n ');
-        }
-        if (encoder.encode(line).length <= 74) {
-            return line;
-        }
-        // iterate unicode character by character, making sure
-        // that adding a new character would keep the line <= 75 octets
-        let result = '';
-        let current = '';
-        let len = 0;
-        for (let i = 0; i < line.length; i++) {
-            const char = line[i];
-            const octets = char.charCodeAt(0) < 256 ? 1 : encoder.encode(char).length;
-            const newlen = len + octets;
-            if (newlen < 75) {
-                current += char;
-                len = newlen;
-            }
-            else {
-                result += current + '\r\n ';
-                line = line.substring(i);
-                current = '';
-                len = 0;
-                i = -1;
-            }
-        }
-        return result + current;
-    }
-    /**
-     * @param {string} str
-     * @return {string}
-     */
-    static escape(str) {
-        if (str.indexOf(',') !== -1) {
-            str = str.replace(/,/g, '\\,');
-        }
-        if (str.indexOf(';') !== -1) {
-            str = str.replace(/;/g, '\\;');
-        }
-        return str;
-    }
-    /**
-     * @param {Date} dt
-     * @return {string}
-     */
-    static formatYYYYMMDD(dt) {
-        return restApi.pad4(dt.getFullYear()) +
-            restApi.pad2(dt.getMonth() + 1) + restApi.pad2(dt.getDate());
-    }
-    /**
-     * Returns UTC string for iCalendar
-     * @param {Date} dt
-     * @return {string}
-     */
-    static makeDtstamp(dt) {
-        const s = dt.toISOString();
-        return s.slice(0, 4) + s.slice(5, 7) + s.slice(8, 13) +
-            s.slice(14, 16) + s.slice(17, 19) + 'Z';
-    }
-    /** @return {string} */
-    static version() {
-        return version;
-    }
-}
-/**
- * Transforms a single Event into a VEVENT string
- * @return {string} multi-line result, delimited by \r\n
- */
-function eventToIcal(ev, options) {
-    const ical = new IcalEvent(ev, options);
-    return ical.toString();
-}
-const torahMemoCache = new Map();
-const HOLIDAY_IGNORE_MASK = DAILY_LEARNING | core.flags.OMER_COUNT |
-    core.flags.SHABBAT_MEVARCHIM | core.flags.MOLAD | core.flags.USER_EVENT |
-    core.flags.HEBREW_DATE;
-/**
- * @private
- */
-function makeTorahMemo(ev, il) {
-    if ((ev.getFlags() & HOLIDAY_IGNORE_MASK) || ev.eventTime) {
-        return '';
-    }
-    const hd = ev.getDate();
-    const yy = hd.getFullYear();
-    const mm = hd.getMonth();
-    const dd = hd.getDate();
-    const key = [yy, mm, dd, il ? '1' : '0', ev.getDesc()].join('-');
-    let memo = torahMemoCache.get(key);
-    if (typeof memo === 'string') {
-        return memo;
-    }
-    memo = restApi.makeTorahMemoText(ev, il).replace(/\n/g, '\\n');
-    torahMemoCache.set(key, memo);
-    return memo;
-}
-/**
- * @private
- */
-function createMemo(ev, options) {
-    let memo = ev.memo;
-    if (typeof memo === 'string' && memo.length && memo.indexOf('\n') !== -1) {
-        memo = memo.replace(/\n/g, '\\n');
-    }
-    const desc = ev.getDesc();
-    if (desc === 'Havdalah' || desc === 'Candle lighting') {
-        return memo || '';
-    }
-    const mask = ev.getFlags();
-    if (mask & core.flags.OMER_COUNT) {
-        const omerEv = ev;
-        const sefira = [omerEv.sefira('en'), omerEv.sefira('he'), omerEv.sefira('translit')].join('\\n');
-        return omerEv.getTodayIs('en') + '\\n\\n' + omerEv.getTodayIs('he') + '\\n\\n' + sefira;
-    }
-    const url = appendTrackingToUrl(ev.url(), options);
-    const torahMemo = makeTorahMemo(ev, options.il);
-    if (!memo) {
-        if (typeof ev.linkedEvent !== 'undefined') {
-            memo = ev.linkedEvent.render(options.locale);
-        }
-        else {
-            memo = restApi.getHolidayDescription(ev);
-        }
-    }
-    if (torahMemo) {
-        if (memo.length) {
-            memo += '\\n\\n';
-        }
-        memo += torahMemo;
-    }
-    if (url) {
-        if (memo.length) {
-            memo += '\\n\\n';
-        }
-        memo += url;
-    }
-    return memo;
-}
-/**
- * Generates an RFC 2445 iCalendar string from an array of events
- */
-async function eventsToIcalendar(events, options) {
-    if (!options)
-        throw new TypeError('Invalid options object');
-    const opts = Object.assign({}, options);
-    opts.dtstamp = opts.dtstamp || IcalEvent.makeDtstamp(new Date());
-    if (!opts.title) {
-        opts.title = restApi.getCalendarTitle(events, opts);
-    }
-    const icals = events.map((ev) => new IcalEvent(ev, opts));
-    return icalEventsToString(icals, opts);
-}
-/**
- * Generates an RFC 2445 iCalendar string from an array of IcalEvents
- */
-async function icalEventsToString(icals, options) {
-    const stream = [];
-    const locale = options.locale || core.Locale.getLocaleName();
-    const uclang = locale.toUpperCase();
-    const opts = Object.assign({}, options);
-    opts.dtstamp = opts.dtstamp || IcalEvent.makeDtstamp(new Date());
-    const title = opts.title ? IcalEvent.escape(opts.title) : 'Untitled';
-    const caldesc = opts.caldesc ? IcalEvent.escape(opts.caldesc) :
-        opts.yahrzeit ?
-            'Yahrzeits + Anniversaries from www.hebcal.com' :
-            'Jewish Holidays from www.hebcal.com';
-    const prodid = opts.prodid || `-//hebcal.com/NONSGML Hebcal Calendar v1${version}//${uclang}`;
-    const preamble = [
-        'BEGIN:VCALENDAR',
-        'VERSION:2.0',
-        `PRODID:${prodid}`,
-        'CALSCALE:GREGORIAN',
-        'METHOD:PUBLISH',
-        'X-LOTUS-CHARSET:UTF-8',
-    ];
-    if (opts.publishedTTL !== false) {
-        const publishedTTL = opts.publishedTTL || 'PT7D';
-        preamble.push(`X-PUBLISHED-TTL:${publishedTTL}`);
-    }
-    preamble.push(`X-WR-CALNAME:${title}`);
-    preamble.push(`X-WR-CALDESC:${caldesc}`);
-    for (const line of preamble.map(IcalEvent.fold)) {
-        stream.push(line);
-        stream.push('\r\n');
-    }
-    if (opts.relcalid) {
-        stream.push(IcalEvent.fold(`X-WR-RELCALID:${opts.relcalid}`));
-        stream.push('\r\n');
-    }
-    if (opts.calendarColor) {
-        stream.push(`X-APPLE-CALENDAR-COLOR:${opts.calendarColor}\r\n`);
-    }
-    const location = opts.location;
-    const tzid = location === null || location === void 0 ? void 0 : location.getTzid();
-    if (tzid) {
-        stream.push(`X-WR-TIMEZONE;VALUE=TEXT:${tzid}\r\n`);
-        const vtz = vtimezoneCache.get(tzid);
-        if (typeof vtz === 'string') {
-            stream.push(vtz);
-            stream.push('\r\n');
-        }
-        else {
-            const vtimezoneFilename = `./zoneinfo/${tzid}.ics`;
-            try {
-                const vtimezoneIcs = await fs.promises.readFile(vtimezoneFilename, 'utf-8');
-                const lines = vtimezoneIcs.split('\r\n');
-                // ignore first 3 and last 1 lines
-                const str = lines.slice(3, lines.length - 2).join('\r\n');
-                stream.push(str);
-                stream.push('\r\n');
-                vtimezoneCache.set(tzid, str);
-            }
-            catch (error) {
-                // ignore failure when no timezone definition to read
-            }
-        }
-    }
-    for (const ical of icals) {
-        const lines = ical.getLines();
-        for (const line of lines) {
-            stream.push(line);
-            stream.push('\r\n');
-        }
-    }
-    stream.push('END:VCALENDAR\r\n');
-    return stream.join('');
-}
-
-exports.IcalEvent = IcalEvent;
-exports.eventToIcal = eventToIcal;
-exports.eventsToIcalendar = eventsToIcalendar;
-exports.icalEventsToString = icalEventsToString;