ical-generator 8.1.2-develop.9 → 9.0.0-develop.2

package/src/calendar.ts

@@ -1,77 +1,81 @@
 'use strict';
 
+import ICalEvent, {
+    type ICalEventData,
+    type ICalEventJSONData,
+} from './event.ts';
 import {
     addOrGetCustomAttributes,
     checkEnum,
     foldLines,
     generateCustomAttributes,
     isMomentDuration,
-    toDurationString
+    toDurationString,
 } from './tools.ts';
-import ICalEvent, { type ICalEventData, type ICalEventJSONData } from './event.ts';
 import { type ICalMomentDurationStub, type ICalTimezone } from './types.ts';
 
+export enum ICalCalendarMethod {
+    ADD = 'ADD',
+    CANCEL = 'CANCEL',
+    COUNTER = 'COUNTER',
+    DECLINECOUNTER = 'DECLINECOUNTER',
+    PUBLISH = 'PUBLISH',
+    REFRESH = 'REFRESH',
+    REPLY = 'REPLY',
+    REQUEST = 'REQUEST',
+}
 
 export interface ICalCalendarData {
-    prodId?: ICalCalendarProdIdData | string;
-    method?: ICalCalendarMethod | null;
-    name?: string | null;
-    description?: string | null;
-    timezone?: ICalTimezone | string | null;
-    source?: string | null;
-    url?: string | null;
-    scale?: string | null;
-    ttl?: number | ICalMomentDurationStub | null;
+    description?: null | string;
     events?: (ICalEvent | ICalEventData)[];
-    x?: {key: string, value: string}[] | [string, string][] | Record<string, string>;
-}
-
-interface ICalCalendarInternalData {
-    prodId: string;
-    method: ICalCalendarMethod | null;
-    name: string | null;
-    description: string | null;
-    timezone: ICalTimezone | null;
-    source: string | null;
-    url: string | null;
-    scale: string | null;
-    ttl: number | null;
-    events: ICalEvent[];
-    x: [string, string][];
+    method?: ICalCalendarMethod | null;
+    name?: null | string;
+    prodId?: ICalCalendarProdIdData | string;
+    scale?: null | string;
+    source?: null | string;
+    timezone?: ICalTimezone | null | string;
+    ttl?: ICalMomentDurationStub | null | number;
+    url?: null | string;
+    x?:
+        | [string, string][]
+        | Record<string, string>
+        | { key: string; value: string }[];
 }
 
 export interface ICalCalendarJSONData {
-    prodId: string;
-    method: ICalCalendarMethod | null;
-    name: string | null;
-    description: string | null;
-    timezone: string | null;
-    source: string | null;
-    url: string | null;
-    scale: string | null;
-    ttl: number | null;
+    description: null | string;
     events: ICalEventJSONData[];
-    x: {key: string, value: string}[];
+    method: ICalCalendarMethod | null;
+    name: null | string;
+    prodId: string;
+    scale: null | string;
+    source: null | string;
+    timezone: null | string;
+    ttl: null | number;
+    url: null | string;
+    x: { key: string; value: string }[];
 }
 
 export interface ICalCalendarProdIdData {
     company: string;
-    product: string;
     language?: string;
+    product: string;
 }
 
-export enum ICalCalendarMethod {
-    PUBLISH = 'PUBLISH',
-    REQUEST = 'REQUEST',
-    REPLY = 'REPLY',
-    ADD = 'ADD',
-    CANCEL = 'CANCEL',
-    REFRESH = 'REFRESH',
-    COUNTER = 'COUNTER',
-    DECLINECOUNTER = 'DECLINECOUNTER'
+interface ICalCalendarInternalData {
+    description: null | string;
+    events: ICalEvent[];
+    method: ICalCalendarMethod | null;
+    name: null | string;
+    prodId: string;
+    scale: null | string;
+    source: null | string;
+    timezone: ICalTimezone | null;
+    ttl: null | number;
+    url: null | string;
+    x: [string, string][];
 }
 
-
 /**
  * Usually you get an {@link ICalCalendar} object like this:
  * ```javascript
@@ -124,17 +128,17 @@ export default class ICalCalendar {
      */
     constructor(data: ICalCalendarData = {}) {
         this.data = {
-            prodId: '//sebbo.net//ical-generator//EN',
+            description: null,
+            events: [],
             method: null,
             name: null,
-            description: null,
-            timezone: null,
-            source: null,
-            url: null,
+            prodId: '//sebbo.net//ical-generator//EN',
             scale: null,
+            source: null,
+            timezone: null,
             ttl: null,
-            events: [],
-            x: []
+            url: null,
+            x: [],
         };
 
         if (data.prodId !== undefined) this.prodId(data.prodId);
@@ -150,61 +154,118 @@ export default class ICalCalendar {
         if (data.x !== undefined) this.x(data.x);
     }
 
+    /**
+     * Remove all events from the calendar without
+     * touching any other data like name or prodId.
+     *
+     * @since 2.0.0-develop.1
+     */
+    clear(): this {
+        this.data.events = [];
+        return this;
+    }
 
     /**
-     * Get your feed's prodid. Will always return a string.
+     * Creates a new {@link ICalEvent} and returns it. Use options to prefill the event's attributes.
+     * Calling this method without options will create an empty event.
+     *
+     * ```javascript
+     * import ical from 'ical-generator';
+     *
+     * // or use require:
+     * // const { default: ical } = require('ical-generator');
+     *
+     * const cal = ical();
+     * const event = cal.createEvent({summary: 'My Event'});
+     *
+     * // overwrite event summary
+     * event.summary('Your Event');
+     * ```
+     *
      * @since 0.2.0
      */
-    prodId(): string;
+    createEvent(data: ICalEvent | ICalEventData): ICalEvent {
+        const event =
+            data instanceof ICalEvent ? data : new ICalEvent(data, this);
+        this.data.events.push(event);
+        return event;
+    }
+    /**
+     * Get your feed's description
+     * @since 0.2.7
+     */
+    description(): null | string;
+    /**
+     * Set your feed's description
+     * @since 0.2.7
+     */
+    description(description: null | string): this;
+    description(description?: null | string): null | string | this {
+        if (description === undefined) {
+            return this.data.description;
+        }
 
+        this.data.description = description ? String(description) : null;
+        return this;
+    }
     /**
-     * Set your feed's prodid. `prodid` can be either a
-     * string like `//sebbo.net//ical-generator//EN` or a
-     * valid {@link ICalCalendarProdIdData} object. `language`
-     * is optional and defaults to `EN`.
+     * Returns all events of this calendar.
      *
      * ```javascript
-     * cal.prodId({
-     *     company: 'My Company',
-     *     product: 'My Product',
-     *     language: 'EN' // optional, defaults to EN
-     * });
+     * const cal = ical();
+     *
+     * cal.events([
+     *     {
+     *        start: new Date(),
+     *        end: new Date(new Date().getTime() + 3600000),
+     *        summary: 'Example Event',
+     *        description: 'It works ;)',
+     *        url: 'http://sebbo.net/'
+     *     }
+     * ]);
+     *
+     * cal.events(); // --> [ICalEvent]
      * ```
      *
-     * `cal.toString()` would then produce the following string:
-     * ```text
-     * PRODID:-//My Company//My Product//EN
+     * @since 0.2.0
+     */
+    events(): ICalEvent[];
+    /**
+     * Add multiple events to your calendar.
+     *
+     * ```javascript
+     * const cal = ical();
+     *
+     * cal.events([
+     *     {
+     *        start: new Date(),
+     *        end: new Date(new Date().getTime() + 3600000),
+     *        summary: 'Example Event',
+     *        description: 'It works ;)',
+     *        url: 'http://sebbo.net/'
+     *     }
+     * ]);
+     *
+     * cal.events(); // --> [ICalEvent]
      * ```
      *
      * @since 0.2.0
      */
-    prodId(prodId: ICalCalendarProdIdData | string): this;
-    prodId(prodId?: ICalCalendarProdIdData | string): this | string {
-        if (!prodId) {
-            return this.data.prodId;
-        }
-
-        if (typeof prodId === 'string') {
-            this.data.prodId = prodId;
-            return this;
-        }
-
-        if (typeof prodId !== 'object') {
-            throw new Error('`prodid` needs to be a string or an object!');
-        }
-
-        if (!prodId.company) {
-            throw new Error('`prodid.company` is a mandatory item!');
-        }
-        if (!prodId.product) {
-            throw new Error('`prodid.product` is a mandatory item!');
+    events(events: (ICalEvent | ICalEventData)[]): this;
+    events(events?: (ICalEvent | ICalEventData)[]): ICalEvent[] | this {
+        if (!events) {
+            return this.data.events;
         }
 
-        const language = (prodId.language || 'EN').toUpperCase();
-        this.data.prodId = '//' + prodId.company + '//' + prodId.product + '//' + language;
+        events.forEach((e: ICalEvent | ICalEventData) => this.createEvent(e));
         return this;
     }
-
+    /**
+     * Get the number of events added to your calendar
+     */
+    length(): number {
+        return this.data.events.length;
+    }
 
     /**
      * Get the feed method attribute.
@@ -213,7 +274,6 @@ export default class ICalCalendar {
      * @since 0.2.8
      */
     method(): ICalCalendarMethod | null;
-
     /**
      * Set the feed method attribute.
      * See {@link ICalCalendarMethod} for available options.
@@ -229,7 +289,9 @@ export default class ICalCalendar {
      * @since 0.2.8
      */
     method(method: ICalCalendarMethod | null): this;
-    method(method?: ICalCalendarMethod | null): this | ICalCalendarMethod | null {
+    method(
+        method?: ICalCalendarMethod | null,
+    ): ICalCalendarMethod | null | this {
         if (method === undefined) {
             return this.data.method;
         }
@@ -238,17 +300,18 @@ export default class ICalCalendar {
             return this;
         }
 
-        this.data.method = checkEnum(ICalCalendarMethod, method) as ICalCalendarMethod;
+        this.data.method = checkEnum(
+            ICalCalendarMethod,
+            method,
+        ) as ICalCalendarMethod;
         return this;
     }
 
-
     /**
      * Get your feed's name
      * @since 0.2.0
      */
-    name(): string | null;
-
+    name(): null | string;
     /**
      * Set your feed's name. Is used to fill `NAME`
      * and `X-WR-CALNAME` in your iCal file.
@@ -273,8 +336,8 @@ export default class ICalCalendar {
      *
      * @since 0.2.0
      */
-    name(name: string | null): this;
-    name(name?: string | null): this | string | null {
+    name(name: null | string): this;
+    name(name?: null | string): null | string | this {
         if (name === undefined) {
             return this.data.name;
         }
@@ -282,51 +345,141 @@ export default class ICalCalendar {
         this.data.name = name ? String(name) : null;
         return this;
     }
-
-
     /**
-     * Get your feed's description
-     * @since 0.2.7
+     * Get your feed's prodid. Will always return a string.
+     * @since 0.2.0
      */
-    description(): string | null;
-
+    prodId(): string;
     /**
-     * Set your feed's description
-     * @since 0.2.7
+     * Set your feed's prodid. `prodid` can be either a
+     * string like `//sebbo.net//ical-generator//EN` or a
+     * valid {@link ICalCalendarProdIdData} object. `language`
+     * is optional and defaults to `EN`.
+     *
+     * ```javascript
+     * cal.prodId({
+     *     company: 'My Company',
+     *     product: 'My Product',
+     *     language: 'EN' // optional, defaults to EN
+     * });
+     * ```
+     *
+     * `cal.toString()` would then produce the following string:
+     * ```text
+     * PRODID:-//My Company//My Product//EN
+     * ```
+     *
+     * @since 0.2.0
      */
-    description(description: string | null): this;
-    description(description?: string | null): this | string | null {
-        if (description === undefined) {
-            return this.data.description;
+    prodId(prodId: ICalCalendarProdIdData | string): this;
+    prodId(prodId?: ICalCalendarProdIdData | string): string | this {
+        if (!prodId) {
+            return this.data.prodId;
         }
 
-        this.data.description = description ? String(description) : null;
-        return this;
-    }
+        if (typeof prodId === 'string') {
+            this.data.prodId = prodId;
+            return this;
+        }
+
+        if (typeof prodId !== 'object') {
+            throw new Error('`prodid` needs to be a string or an object!');
+        }
 
+        if (!prodId.company) {
+            throw new Error('`prodid.company` is a mandatory item!');
+        }
+        if (!prodId.product) {
+            throw new Error('`prodid.product` is a mandatory item!');
+        }
 
+        const language = (prodId.language || 'EN').toUpperCase();
+        this.data.prodId =
+            '//' + prodId.company + '//' + prodId.product + '//' + language;
+        return this;
+    }
     /**
-     * Get the current calendar timezone
-     * @since 0.2.0
+     * Get current value of the `CALSCALE` attribute. It will
+     * return `null` if no value was set. The iCal standard
+     * specifies this as `GREGORIAN` if no value is present.
+     *
+     * @since 1.8.0
      */
-    timezone(): string | null;
-
+    scale(): null | string;
     /**
-     * Use this method to set your feed's timezone. Is used
-     * to fill `TIMEZONE-ID` and `X-WR-TIMEZONE` in your iCal export.
-     * Please not that all date values are treaded differently, if
-     * a timezone was set. See {@link formatDate} for details. If no
-     * time zone is specified, all information is output as UTC.
+     * Use this method to set your feed's `CALSCALE` attribute. There is no
+     * default value for this property and it will not appear in your iCal
+     * file unless set. The iCal standard specifies this as `GREGORIAN` if
+     * no value is present.
      *
      * ```javascript
-     * cal.timezone('America/New_York');
+     * cal.scale('gregorian');
      * ```
      *
-     * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
-     * @since 0.2.0
+     * @since 1.8.0
      */
-    timezone(timezone: string | null): this;
+    scale(scale: null | string): this;
+    scale(scale?: null | string): null | string | this {
+        if (scale === undefined) {
+            return this.data.scale;
+        }
+
+        if (scale === null) {
+            this.data.scale = null;
+        } else {
+            this.data.scale = scale.toUpperCase();
+        }
+
+        return this;
+    }
+    /**
+     * Get current value of the `SOURCE` attribute.
+     * @since 2.2.0-develop.1
+     */
+    source(): null | string;
+    /**
+     * Use this method to set your feed's `SOURCE` attribute.
+     * This tells the client where to refresh your feed.
+     *
+     * ```javascript
+     * cal.source('http://example.com/my/original_source.ical');
+     * ```
+     *
+     * ```text
+     * SOURCE;VALUE=URI:http://example.com/my/original_source.ical
+     * ```
+     *
+     * @since 2.2.0-develop.1
+     */
+    source(source: null | string): this;
+    source(source?: null | string): null | string | this {
+        if (source === undefined) {
+            return this.data.source;
+        }
 
+        this.data.source = source || null;
+        return this;
+    }
+    /**
+     * Get the current calendar timezone
+     * @since 0.2.0
+     */
+    timezone(): null | string;
+    /**
+     * Use this method to set your feed's timezone. Is used
+     * to fill `TIMEZONE-ID` and `X-WR-TIMEZONE` in your iCal export.
+     * Please not that all date values are treaded differently, if
+     * a timezone was set. See {@link formatDate} for details. If no
+     * time zone is specified, all information is output as UTC.
+     *
+     * ```javascript
+     * cal.timezone('America/New_York');
+     * ```
+     *
+     * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
+     * @since 0.2.0
+     */
+    timezone(timezone: null | string): this;
     /**
      * Sets the time zone to be used in this calendar file for all times of all
      * events. Please note that if the time zone is set, ical-generator assumes
@@ -361,130 +514,150 @@ export default class ICalCalendar {
      * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
      * @since 2.0.0
      */
-    timezone(timezone: ICalTimezone | string | null): this;
-    timezone(timezone?: ICalTimezone | string | null): this | string | null {
+    timezone(timezone: ICalTimezone | null | string): this;
+    timezone(timezone?: ICalTimezone | null | string): null | string | this {
         if (timezone === undefined) {
             return this.data.timezone?.name || null;
         }
 
-        if(timezone === 'UTC') {
+        if (timezone === 'UTC') {
             this.data.timezone = null;
-        }
-        else if(typeof timezone === 'string') {
-            this.data.timezone = {name: timezone};
-        }
-        else if(timezone === null) {
+        } else if (typeof timezone === 'string') {
+            this.data.timezone = { name: timezone };
+        } else if (timezone === null) {
             this.data.timezone = null;
-        }
-        else {
+        } else {
             this.data.timezone = timezone;
         }
 
         return this;
     }
 
-
     /**
-     * Get current value of the `SOURCE` attribute.
-     * @since 2.2.0-develop.1
-     */
-    source(): string | null;
-
-    /**
-     * Use this method to set your feed's `SOURCE` attribute.
-     * This tells the client where to refresh your feed.
+     * Return a shallow copy of the calendar's options for JSON stringification.
+     * Third party objects like moment.js values or RRule objects are stringified
+     * as well. Can be used for persistence.
      *
      * ```javascript
-     * cal.source('http://example.com/my/original_source.ical');
-     * ```
+     * const cal = ical();
+     * const json = JSON.stringify(cal);
      *
-     * ```text
-     * SOURCE;VALUE=URI:http://example.com/my/original_source.ical
+     * // later: restore calendar data
+     * cal = ical(JSON.parse(json));
      * ```
      *
-     * @since 2.2.0-develop.1
+     * @since 0.2.4
      */
-    source(source: string | null): this;
-    source(source?: string | null): this | string | null {
-        if (source === undefined) {
-            return this.data.source;
-        }
-
-        this.data.source = source || null;
-        return this;
+    toJSON(): ICalCalendarJSONData {
+        return Object.assign({}, this.data, {
+            events: this.data.events.map((event) => event.toJSON()),
+            timezone: this.timezone(),
+            x: this.x(),
+        });
     }
 
-
-    /**
-     * Get your feed's URL
-     * @since 0.2.5
-     */
-    url(): string | null;
-
     /**
-     * Set your feed's URL
+     * Return generated calendar as a string.
      *
      * ```javascript
-     * calendar.url('http://example.com/my/feed.ical');
+     * const cal = ical();
+     * console.log(cal.toString()); // → BEGIN:VCALENDAR…
      * ```
-     *
-     * @since 0.2.5
      */
-    url(url: string | null): this;
-    url(url?: string | null): this | string | null {
-        if (url === undefined) {
-            return this.data.url;
+    toString(): string {
+        let g = '';
+
+        // VCALENDAR and VERSION
+        g = 'BEGIN:VCALENDAR\r\nVERSION:2.0\r\n';
+
+        // PRODID
+        g += 'PRODID:-' + this.data.prodId + '\r\n';
+
+        // URL
+        if (this.data.url) {
+            g += 'URL:' + this.data.url + '\r\n';
         }
 
-        this.data.url = url || null;
-        return this;
-    }
+        // SOURCE
+        if (this.data.source) {
+            g += 'SOURCE;VALUE=URI:' + this.data.source + '\r\n';
+        }
 
+        // CALSCALE
+        if (this.data.scale) {
+            g += 'CALSCALE:' + this.data.scale + '\r\n';
+        }
 
-    /**
-     * Get current value of the `CALSCALE` attribute. It will
-     * return `null` if no value was set. The iCal standard
-     * specifies this as `GREGORIAN` if no value is present.
-     *
-     * @since 1.8.0
-     */
-    scale(): string | null;
+        // METHOD
+        if (this.data.method) {
+            g += 'METHOD:' + this.data.method + '\r\n';
+        }
 
-    /**
-     * Use this method to set your feed's `CALSCALE` attribute. There is no
-     * default value for this property and it will not appear in your iCal
-     * file unless set. The iCal standard specifies this as `GREGORIAN` if
-     * no value is present.
-     *
-     * ```javascript
-     * cal.scale('gregorian');
-     * ```
-     *
-     * @since 1.8.0
-     */
-    scale(scale: string | null): this;
-    scale(scale?: string | null): this | string | null {
-        if (scale === undefined) {
-            return this.data.scale;
+        // NAME
+        if (this.data.name) {
+            g += 'NAME:' + this.data.name + '\r\n';
+            g += 'X-WR-CALNAME:' + this.data.name + '\r\n';
         }
 
-        if (scale === null) {
-            this.data.scale = null;
+        // Description
+        if (this.data.description) {
+            g += 'X-WR-CALDESC:' + this.data.description + '\r\n';
         }
-        else {
-            this.data.scale = scale.toUpperCase();
+
+        // Timezone
+        if (this.data.timezone?.generator) {
+            const timezones = [
+                ...new Set([
+                    this.timezone(),
+                    ...this.data.events.map((event) => event.timezone()),
+                ]),
+            ].filter((tz) => tz !== null && !tz.startsWith('/')) as string[];
+
+            timezones.forEach((tz) => {
+                if (!this.data.timezone?.generator) {
+                    return;
+                }
+
+                const s = this.data.timezone.generator(tz);
+                if (!s) {
+                    return;
+                }
+
+                g +=
+                    s.replace(/\r\n/g, '\n').replace(/\n/g, '\r\n').trim() +
+                    '\r\n';
+            });
+        }
+        if (this.data.timezone?.name) {
+            g += 'TIMEZONE-ID:' + this.data.timezone.name + '\r\n';
+            g += 'X-WR-TIMEZONE:' + this.data.timezone.name + '\r\n';
         }
 
-        return this;
-    }
+        // TTL
+        if (this.data.ttl) {
+            g +=
+                'REFRESH-INTERVAL;VALUE=DURATION:' +
+                toDurationString(this.data.ttl) +
+                '\r\n';
+            g += 'X-PUBLISHED-TTL:' + toDurationString(this.data.ttl) + '\r\n';
+        }
+
+        // Events
+        this.data.events.forEach((event) => (g += event.toString()));
+
+        // CUSTOM X ATTRIBUTES
+        g += generateCustomAttributes(this.data);
+
+        g += 'END:VCALENDAR';
 
+        return foldLines(g);
+    }
 
     /**
      * Get the current ttl duration in seconds
      * @since 0.2.5
      */
-    ttl(): number | null;
-
+    ttl(): null | number;
     /**
      * Use this method to set your feed's time to live
      * (in seconds). Is used to fill `REFRESH-INTERVAL` and
@@ -499,119 +672,46 @@ export default class ICalCalendar {
      *
      * @since 0.2.5
      */
-    ttl(ttl: number | ICalMomentDurationStub | null): this;
-    ttl(ttl?: number | ICalMomentDurationStub | null): this | number | null {
+    ttl(ttl: ICalMomentDurationStub | null | number): this;
+    ttl(ttl?: ICalMomentDurationStub | null | number): null | number | this {
         if (ttl === undefined) {
             return this.data.ttl;
         }
 
         if (isMomentDuration(ttl)) {
             this.data.ttl = ttl.asSeconds();
-        }
-        else if (ttl && ttl > 0) {
+        } else if (ttl && ttl > 0) {
             this.data.ttl = ttl;
-        }
-        else {
+        } else {
             this.data.ttl = null;
         }
 
         return this;
     }
 
-
     /**
-     * Creates a new {@link ICalEvent} and returns it. Use options to prefill the event's attributes.
-     * Calling this method without options will create an empty event.
-     *
-     * ```javascript
-     * import ical from 'ical-generator';
-     *
-     * // or use require:
-     * // const { default: ical } = require('ical-generator');
-     *
-     * const cal = ical();
-     * const event = cal.createEvent({summary: 'My Event'});
-     *
-     * // overwrite event summary
-     * event.summary('Your Event');
-     * ```
-     *
-     * @since 0.2.0
-     */
-    createEvent(data: ICalEvent | ICalEventData): ICalEvent {
-        const event = data instanceof ICalEvent ? data : new ICalEvent(data, this);
-        this.data.events.push(event);
-        return event;
-    }
-
-
-    /**
-     * Returns all events of this calendar.
-     *
-     * ```javascript
-     * const cal = ical();
-     *
-     * cal.events([
-     *     {
-     *        start: new Date(),
-     *        end: new Date(new Date().getTime() + 3600000),
-     *        summary: 'Example Event',
-     *        description: 'It works ;)',
-     *        url: 'http://sebbo.net/'
-     *     }
-     * ]);
-     *
-     * cal.events(); // --> [ICalEvent]
-     * ```
-     *
-     * @since 0.2.0
+     * Get your feed's URL
+     * @since 0.2.5
      */
-    events(): ICalEvent[];
-
+    url(): null | string;
     /**
-     * Add multiple events to your calendar.
+     * Set your feed's URL
      *
      * ```javascript
-     * const cal = ical();
-     *
-     * cal.events([
-     *     {
-     *        start: new Date(),
-     *        end: new Date(new Date().getTime() + 3600000),
-     *        summary: 'Example Event',
-     *        description: 'It works ;)',
-     *        url: 'http://sebbo.net/'
-     *     }
-     * ]);
-     *
-     * cal.events(); // --> [ICalEvent]
+     * calendar.url('http://example.com/my/feed.ical');
      * ```
      *
-     * @since 0.2.0
+     * @since 0.2.5
      */
-    events(events: (ICalEvent | ICalEventData)[]): this;
-    events(events?: (ICalEvent | ICalEventData)[]): this | ICalEvent[] {
-        if (!events) {
-            return this.data.events;
+    url(url: null | string): this;
+    url(url?: null | string): null | string | this {
+        if (url === undefined) {
+            return this.data.url;
         }
 
-        events.forEach((e: ICalEvent | ICalEventData) => this.createEvent(e));
-        return this;
-    }
-
-
-    /**
-     * Remove all events from the calendar without
-     * touching any other data like name or prodId.
-     *
-     * @since 2.0.0-develop.1
-     */
-    clear(): this {
-        this.data.events = [];
+        this.data.url = url || null;
         return this;
     }
-
-
     /**
      * Set X-* attributes. Woun't filter double attributes,
      * which are also added by another method (e.g. busystatus),
@@ -644,8 +744,12 @@ export default class ICalCalendar {
      *
      * @since 1.9.0
      */
-    x (keyOrArray: {key: string, value: string}[] | [string, string][] | Record<string, string>): this;
-
+    x(
+        keyOrArray:
+            | [string, string][]
+            | Record<string, string>
+            | { key: string; value: string }[],
+    ): this;
     /**
      * Set a X-* attribute. Woun't filter double attributes,
      * which are also added by another method (e.g. busystatus),
@@ -665,153 +769,32 @@ export default class ICalCalendar {
      *
      * @since 1.9.0
      */
-    x (keyOrArray: string, value: string): this;
-
+    x(keyOrArray: string, value: string): this;
     /**
      * Get all custom X-* attributes.
      * @since 1.9.0
      */
-    x (): {key: string, value: string}[];
-    x (keyOrArray?: {key: string, value: string}[] | [string, string][] | Record<string, string> | string, value?: string): this | void | ({key: string, value: string})[] {
-        if(keyOrArray === undefined) {
-            return addOrGetCustomAttributes (this.data);
-        }
-
-        if(typeof keyOrArray === 'string' && typeof value === 'string') {
-            addOrGetCustomAttributes (this.data, keyOrArray, value);
-        }
-        else if(typeof keyOrArray === 'object') {
-            addOrGetCustomAttributes (this.data, keyOrArray);
-        }
-        else {
+    x(): { key: string; value: string }[];
+    x(
+        keyOrArray?:
+            | [string, string][]
+            | Record<string, string>
+            | string
+            | { key: string; value: string }[],
+        value?: string,
+    ): this | void | { key: string; value: string }[] {
+        if (keyOrArray === undefined) {
+            return addOrGetCustomAttributes(this.data);
+        }
+
+        if (typeof keyOrArray === 'string' && typeof value === 'string') {
+            addOrGetCustomAttributes(this.data, keyOrArray, value);
+        } else if (typeof keyOrArray === 'object') {
+            addOrGetCustomAttributes(this.data, keyOrArray);
+        } else {
             throw new Error('Either key or value is not a string!');
         }
 
         return this;
     }
-
-
-    /**
-     * Return a shallow copy of the calendar's options for JSON stringification.
-     * Third party objects like moment.js values or RRule objects are stringified
-     * as well. Can be used for persistence.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const json = JSON.stringify(cal);
-     *
-     * // later: restore calendar data
-     * cal = ical(JSON.parse(json));
-     * ```
-     *
-     * @since 0.2.4
-     */
-    toJSON(): ICalCalendarJSONData {
-        return Object.assign({}, this.data, {
-            timezone: this.timezone(),
-            events: this.data.events.map(event => event.toJSON()),
-            x: this.x()
-        });
-    }
-
-
-    /**
-     * Get the number of events added to your calendar
-     */
-    length(): number {
-        return this.data.events.length;
-    }
-
-
-    /**
-     * Return generated calendar as a string.
-     *
-     * ```javascript
-     * const cal = ical();
-     * console.log(cal.toString()); // → BEGIN:VCALENDAR…
-     * ```
-     */
-    toString(): string {
-        let g = '';
-
-        // VCALENDAR and VERSION
-        g = 'BEGIN:VCALENDAR\r\nVERSION:2.0\r\n';
-
-        // PRODID
-        g += 'PRODID:-' + this.data.prodId + '\r\n';
-
-        // URL
-        if (this.data.url) {
-            g += 'URL:' + this.data.url + '\r\n';
-        }
-
-        // SOURCE
-        if (this.data.source) {
-            g += 'SOURCE;VALUE=URI:' + this.data.source + '\r\n';
-        }
-
-        // CALSCALE
-        if (this.data.scale) {
-            g += 'CALSCALE:' + this.data.scale + '\r\n';
-        }
-
-        // METHOD
-        if (this.data.method) {
-            g += 'METHOD:' + this.data.method + '\r\n';
-        }
-
-        // NAME
-        if (this.data.name) {
-            g += 'NAME:' + this.data.name + '\r\n';
-            g += 'X-WR-CALNAME:' + this.data.name + '\r\n';
-        }
-
-        // Description
-        if (this.data.description) {
-            g += 'X-WR-CALDESC:' + this.data.description + '\r\n';
-        }
-
-        // Timezone
-        if(this.data.timezone?.generator) {
-            const timezones = [...new Set([
-                this.timezone(),
-                ...this.data.events.map(event => event.timezone())
-            ])].filter(tz => tz !== null && !tz.startsWith('/')) as string[];
-
-            timezones.forEach(tz => {
-                if(!this.data.timezone?.generator) {
-                    return;
-                }
-
-                const s = this.data.timezone.generator(tz);
-                if(!s) {
-                    return;
-                }
-
-                g += s.replace(/\r\n/g, '\n')
-                    .replace(/\n/g, '\r\n')
-                    .trim() + '\r\n';
-            });
-        }
-        if (this.data.timezone?.name) {
-            g += 'TIMEZONE-ID:' + this.data.timezone.name + '\r\n';
-            g += 'X-WR-TIMEZONE:' + this.data.timezone.name + '\r\n';
-        }
-
-        // TTL
-        if (this.data.ttl) {
-            g += 'REFRESH-INTERVAL;VALUE=DURATION:' + toDurationString(this.data.ttl) + '\r\n';
-            g += 'X-PUBLISHED-TTL:' + toDurationString(this.data.ttl) + '\r\n';
-        }
-
-        // Events
-        this.data.events.forEach(event => g += event.toString());
-
-        // CUSTOM X ATTRIBUTES
-        g += generateCustomAttributes(this.data);
-
-        g += 'END:VCALENDAR';
-
-        return foldLines(g);
-    }
 }